Workspace Action Bridge

Workspace Action Bridge is a defensive VS Code extension for applying validated editor action plans through a fixed, typed command surface.

It is intentionally not a generic script runner or unrestricted command bridge. Incoming requests are validated before dispatch, unsupported actions are rejected, and the extension does not execute arbitrary shell text or arbitrary VS Code command identifiers.

Highlights

• Validates incoming action plans against a bundled schema before execution.
• Supports a fixed allowlist of editor actions instead of dynamic command routing.
• Uses standard VS Code surfaces such as editors, diffs, prompts, browser tabs, and folder updates.
• Exposes bounded runtime diagnostics such as UI state, terminal state, active extensions, and health.

Key Capabilities

• Open URLs, pull requests, builds, and browser pages through validated targets.
• Reveal files, open files, and show diffs with validated paths.
• Add folders to the current window.
• Show notifications, fixed-choice prompts, quick picks, and input prompts.
• Return structured runtime information for editor state, terminal state, and active extensions.
• Provide bounded diagnostics and freeze-triage snapshots for troubleshooting.

Security Model

• Accept only the supported action envelope shape.
• Validate payloads before dispatch.
• Reject malformed or unsupported actions explicitly.
• Do not execute arbitrary shell text.
• Do not expose a general-purpose command execution surface.

Included Commands

• workspaceBridge.applyActionPlan
• workspaceBridge.getRuntimeInfo
• workspaceBridge.health
• workspaceBridge.ping
• workspaceBridge.reportUiState
• workspaceBridge.reportTerminalState
• workspaceBridge.reportFreezeTriage
• workspaceBridge.showRunningExtensions

Local Development

npm install
npm run compile
npm test

To create a local package:

npm run package:vsix