patchwork-os 0.2.0-alpha.0

package/dist/tools/watchDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchDiagnostics.js","sourceRoot":"","sources":["../../src/tools/watchDiagnostics.ts"],"names":[],"mappings":"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"}

package/dist/tools/workspaceSettings.d.ts

@@ -0,0 +1,57 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createSetWorkspaceSettingTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        extensionRequired: boolean;
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                key: {
+                    type: "string";
+                    description: string;
+                };
+                value: {
+                    description: string;
+                };
+                target: {
+                    type: "string";
+                    enum: string[];
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                key: {
+                    type: string;
+                };
+                value: {};
+                target: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/workspaceSettings.js

@@ -0,0 +1,80 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, requireString, successStructured, } from "./utils.js";
+// Bridge-side mirror of the extension's BLOCKED_KEY_PREFIXES — defense in depth
+// so the check is enforced even if the extension is unavailable or has a bug.
+const BLOCKED_SETTING_KEY_PREFIXES = new Set([
+    "security",
+    "extensions.autoUpdate",
+    "extensions.autoInstallDependencies",
+    "terminal.integrated.shell",
+    "terminal.integrated.shellArgs",
+    "terminal.integrated.env",
+    "terminal.integrated.profiles",
+    "terminal.integrated.defaultProfile",
+]);
+function isBlockedSettingKey(key) {
+    return [...BLOCKED_SETTING_KEY_PREFIXES].some((prefix) => key === prefix || key.startsWith(`${prefix}.`));
+}
+export function createSetWorkspaceSettingTool(extensionClient) {
+    return {
+        schema: {
+            name: "setWorkspaceSetting",
+            description: "Write VS Code workspace setting (dot notation e.g. editor.tabSize). security.* writes blocked.",
+            annotations: { destructiveHint: true },
+            extensionRequired: true,
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["key", "value"],
+                properties: {
+                    key: {
+                        type: "string",
+                        description: "Setting key in dot notation (e.g. 'editor.tabSize')",
+                    },
+                    value: {
+                        description: "New value for the setting",
+                    },
+                    target: {
+                        type: "string",
+                        enum: ["workspace", "global"],
+                        description: "Which scope to write to (default: workspace)",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    key: { type: "string" },
+                    value: {},
+                    target: { type: "string" },
+                },
+                required: ["key"],
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("setWorkspaceSetting");
+            }
+            const key = requireString(args, "key", 256);
+            if (isBlockedSettingKey(key)) {
+                return error(`Writing to "${key}" is blocked — modifying this setting is not permitted`);
+            }
+            const value = args.value;
+            const target = typeof args.target === "string" ? args.target : undefined;
+            try {
+                const result = await extensionClient.setWorkspaceSetting(key, value, target);
+                if (result === null)
+                    return error("Failed to write setting — ensure a workspace folder is open");
+                return successStructured(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out writing setting");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=workspaceSettings.js.map

package/dist/tools/workspaceSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceSettings.js","sourceRoot":"","sources":["../../src/tools/workspaceSettings.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,207 @@
+import { WebSocket } from "ws";
+import type { ActivityLog } from "./activityLog.js";
+import type { Logger } from "./logger.js";
+interface ToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    /** JSON Schema describing the structured output (MCP 2025-06-18). When present, the tool also returns `structuredContent`. */
+    outputSchema?: Record<string, unknown>;
+    annotations?: ToolAnnotations;
+    /** If true, this tool requires the VS Code extension. When disconnected, calling it returns an error. */
+    extensionRequired?: boolean;
+    /** Override the global 60s tool timeout for this specific tool (milliseconds). */
+    timeoutMs?: number;
+    /** Prompt caching hint passed through to wire schema. */
+    cache_control?: {
+        type: "ephemeral";
+    };
+    /** Internal: tool categories for searchTools discovery. Stripped from wire like extensionRequired. */
+    categories?: string[];
+}
+export type ProgressFn = (progress: number, total?: number, message?: string) => void;
+export type ToolHandler = (args: Record<string, unknown>, signal?: AbortSignal, progress?: ProgressFn) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    /** Typed structured output (MCP 2025-06-18). Present when the tool declares `outputSchema`. */
+    structuredContent?: unknown;
+}>;
+export declare class McpTransport {
+    private logger;
+    private tools;
+    /** Optional fallback for tool names not found in the static registry. Used by the orchestrator. */
+    private dynamicToolDispatch;
+    /** Optional instructions string injected into the MCP initialize response. */
+    private instructions;
+    setDynamicToolDispatch(fn: ToolHandler): void;
+    setInstructions(text: string): void;
+    private readonly serverInfo;
+    private activeWs;
+    workspace: string;
+    private activeListener;
+    private inFlightControllers;
+    private inFlightToolNames;
+    /** Pending elicitation/create requests waiting for a client response. */
+    private pendingElicitations;
+    private initialized;
+    /** Called once after the MCP handshake completes (notifications/initialized received). */
+    onInitialized?: () => void;
+    private activeToolCalls;
+    private callCount;
+    private errorCount;
+    private generation;
+    private readonly sessionStartedAt;
+    private readonly resultSizeTracker;
+    private rateLimitBuf;
+    private rateLimitHead;
+    private notifCount;
+    private notifWindowStart;
+    sessionId: string | null;
+    /** X-Claude-Code-Session-Id from the HTTP initialize request, for proxy-level correlation. */
+    claudeCodeSessionId: string | null;
+    /** OAuth scope for this session. null = full access (static bridge token). "mcp:read" = read-only. */
+    private sessionScope;
+    /** Per-session tool deny list. Tools in this set return isError:true at dispatch. */
+    private denyTools;
+    /** Called on each progress notification — HTTP sessions use this to refresh lastActivity. */
+    onActivity: (() => void) | undefined;
+    private activityLog;
+    private isExtensionConnectedFn;
+    private readonly ajv;
+    private readonly schemaValidators;
+    private readonly outputValidators;
+    /** Cached wire-schema array for tools/list. Invalidated on any tool registration change. */
+    private wireSchemaCache;
+    /** Per-session tool-call rate limit (calls/minute). 0 = disabled. */
+    private toolRateLimit;
+    /**
+     * Token bucket for tool-call rate limiting. Stored as a mutable object so it
+     * can be shared across multiple transport instances (e.g. HTTP session cycling
+     * bypass prevention — see StreamableHttpHandler.sharedHttpRateLimitBucket).
+     */
+    private toolBucket;
+    /**
+     * Optional approval gate invoked before executing a tool. Returns the
+     * decision or null to bypass gating for this call. Wired in by bridge.ts
+     * when the dashboard approval flow is enabled.
+     */
+    private approvalGate;
+    setApprovalGate(fn: (req: {
+        toolName: string;
+        params: Record<string, unknown>;
+        sessionId: string | null;
+    }) => Promise<"approved" | "rejected" | "expired" | "bypass">): void;
+    constructor(logger: Logger);
+    /**
+     * Set the OAuth scope for this session.
+     * - null / "mcp"  → full access (all tools allowed)
+     * - "mcp:read"    → read-only access (only readOnlyHint:true tools allowed)
+     */
+    setSessionScope(scope: string | null): void;
+    /**
+     * Set a per-session tool deny list. Tools whose name is in this set will
+     * return isError:true at dispatch time (they still appear in tools/list).
+     * Called at HTTP session initialize time from X-Bridge-Deny-Tools header.
+     */
+    setDenyTools(tools: Set<string>): void;
+    /** Configure per-session tool call rate limiting (calls/minute, 0 = disabled). */
+    setToolRateLimit(limit: number): void;
+    /**
+     * Replace the token bucket with a shared object.
+     * All transports using the same bucket share one rate-limit pool — prevents
+     * bypassing the limit by cycling HTTP sessions (each new session would otherwise
+     * start with a full bucket).
+     */
+    setSharedToolRateLimitBucket(bucket: {
+        tokens: number;
+        lastRefill: number;
+    }): void;
+    /** Refill the token bucket and return whether at least one token is available (does NOT consume). */
+    private peekToolRateLimit;
+    /** Consume one token. Call only after peekToolRateLimit() returned true. */
+    private consumeToolRateLimitToken;
+    private getValidator;
+    /** Returns true once the MCP handshake is complete (notifications/initialized received). */
+    get isReady(): boolean;
+    /**
+     * Invoke a registered tool by name, bypassing the JSON-RPC dispatch path.
+     * Used by HTTP endpoints (e.g. /launch-quick-task) that need to call tools
+     * in-process without a full MCP session. No AJV validation — callers must
+     * pre-validate args. Returns null if the tool is not registered.
+     */
+    invokeToolDirect(toolName: string, args: Record<string, unknown>): Promise<unknown> | null;
+    /**
+     * Mark the transport as initialized without requiring the MCP handshake.
+     * Use this when the caller has already authenticated the client at a higher
+     * level (e.g. the orchestrator validates auth at WebSocket upgrade time).
+     */
+    markInitialized(): void;
+    /** Number of tools currently registered (useful for /ready endpoint). */
+    get toolCount(): number;
+    /**
+     * Return a static snapshot of all registered tool schemas.
+     * Used by scripts/audit-schema-changes.mjs to diff against a committed baseline.
+     */
+    getSchemaSnapshot(): Array<{
+        name: string;
+        inputSchema: unknown;
+        outputSchema?: unknown;
+    }>;
+    setExtensionConnectedFn(fn: () => boolean): void;
+    setActivityLog(log: ActivityLog): void;
+    /**
+     * Send an `elicitation/create` request to the MCP client (Claude Code 2.1.76+) and
+     * wait for the user's response. Resolves with the client's result object, or rejects
+     * if the client declines, disconnects, or does not support elicitation.
+     *
+     * @param message Human-readable question shown to the user.
+     * @param requestedSchema JSON Schema describing the shape of the expected response.
+     * @param timeoutMs Maximum time to wait for a response (default: 5 minutes).
+     */
+    elicit(message: string, requestedSchema: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    registerTool(schema: ToolSchema, handler: ToolHandler, timeoutMs?: number): void;
+    /** Upsert a tool by name — replaces if already registered, inserts if new. */
+    replaceTool(schema: ToolSchema, handler: ToolHandler, timeoutMs?: number): void;
+    /** Remove all tools whose name starts with `prefix`. Returns count removed. */
+    deregisterTool(name: string): boolean;
+    deregisterToolsByPrefix(prefix: string): number;
+    detach(): void;
+    getStats(): {
+        callCount: number;
+        errorCount: number;
+        activeToolCalls: number;
+        inFlightTools: string[];
+        startedAt: number;
+    };
+    /** Returns the byte length of the wire-schema cache, or null if not yet built. */
+    getWireSchemaCacheSize(): number | null;
+    /** Bulk-apply category tags to registered tools. Called after registerAllTools(). */
+    applyToolCategories(map: Record<string, string[]>): void;
+    /** Returns all registered tool schemas — used by searchTools for keyword/category discovery. */
+    getToolSchemas(): Array<{
+        name: string;
+        description: string;
+        categories?: string[];
+    }>;
+    /** Top-N tools by largest result seen this session (descending by sizeChars). */
+    getTopResultSizes(n?: number): Array<{
+        tool: string;
+        sizeChars: number;
+    }>;
+    attach(ws: WebSocket): void;
+    /** Send progress notification for a long-running tool */
+    private sendProgress;
+    /** Send a server-initiated notification */
+    static sendNotification(ws: WebSocket, method: string, params?: unknown, logger?: {
+        warn: (msg: string) => void;
+    }): void;
+}
+export {};