patchwork-os 0.2.0-alpha.0

package/dist/tools/bridgeStatus.js

@@ -0,0 +1,250 @@
+import { ClaudeOrchestrator } from "../claudeOrchestrator.js";
+import { successStructured } from "./utils.js";
+const startTime = Date.now();
+/**
+ * Table of known tools with their availability requirements. Populated manually
+ * from src/tools/index.ts registration — a drift-guard test that walks the
+ * registry is a follow-up. Tools NOT in this table are assumed always available
+ * (pure-bridge tools like gitCommit that don't depend on probes or the extension).
+ *
+ * Used by the toolAvailability field in getBridgeStatus to answer
+ * "why can't Claude call X?" in a single call.
+ *
+ * Spec flags:
+ * - `extensionRequired: true` — tool has no fallback. Unavailable when the
+ *   extension is disconnected or the circuit breaker is open.
+ * - `probe: <name>` — tool requires this CLI probe.
+ * - `extensionFallback: true` — tool prefers the extension path but can fall
+ *   back to the CLI probe. Available when EITHER the extension is connected
+ *   OR the probe is present. `formatDocument` is the canonical example: the
+ *   VS Code extension formats via its built-in TypeScript formatter; the CLI
+ *   path requires prettier/biome/etc.
+ */
+const TOOL_AVAILABILITY_TABLE = {
+    // Extension-required tools (schema.extensionRequired: true)
+    findImplementations: { extensionRequired: true },
+    getHoverAtCursor: { extensionRequired: true },
+    getTypeHierarchy: { extensionRequired: true },
+    getWorkspaceSettings: { extensionRequired: true },
+    setWorkspaceSetting: { extensionRequired: true },
+    setEditorDecorations: { extensionRequired: true },
+    clearEditorDecorations: { extensionRequired: true },
+    getSemanticTokens: { extensionRequired: true },
+    getCodeLens: { extensionRequired: true },
+    // Tools that prefer the extension path but can fall back to a CLI probe.
+    formatDocument: { probe: "prettier", extensionFallback: true },
+    searchWorkspaceSymbols: { probe: "universalCtags", extensionFallback: true },
+    navigateToSymbolByName: { probe: "rg", extensionFallback: true },
+    goToDefinition: {
+        probe: "typescriptLanguageServer",
+        extensionFallback: true,
+    },
+    findReferences: {
+        probe: "typescriptLanguageServer",
+        extensionFallback: true,
+    },
+    getTypeSignature: {
+        probe: "typescriptLanguageServer",
+        extensionFallback: true,
+    },
+    // Pure-probe tools (no extension path)
+    runTests: { probe: "vitest" },
+    getGitStatus: { probe: "git" },
+    getGitDiff: { probe: "git" },
+    getGitLog: { probe: "git" },
+    githubListPRs: { probe: "gh" },
+    githubCreatePR: { probe: "gh" },
+    githubViewPR: { probe: "gh" },
+};
+export function createBridgeStatusTool(extensionClient, probes, sessions, orchestrator, automationHooks, getDisconnectInfo, automationPolicyPath) {
+    return {
+        schema: {
+            name: "getBridgeStatus",
+            description: "IDE bridge status: ext connection, circuit breaker, uptime, tool availability.",
+            annotations: { readOnlyHint: true },
+            cache_control: { type: "ephemeral" },
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    extensionConnected: { type: "boolean" },
+                    activeSessions: { type: "integer" },
+                    circuitBreaker: {
+                        type: "object",
+                        properties: {
+                            suspended: { type: "boolean" },
+                            consecutiveFailures: { type: "integer" },
+                            resumesInMs: { type: "integer" },
+                            openCount: { type: "integer" },
+                            lastOpenedAt: { type: ["string", "null"] },
+                        },
+                        required: ["suspended", "consecutiveFailures", "openCount"],
+                    },
+                    uptimeSeconds: { type: "integer" },
+                    latencyMs: { type: ["integer", "null"] },
+                    connectionQuality: {
+                        type: "string",
+                        enum: ["healthy", "degraded", "poor"],
+                    },
+                    tier: { type: "string", enum: ["full", "basic"] },
+                    tierDescription: { type: "string" },
+                    hint: { type: "string" },
+                    suggestedActions: { type: "array", items: { type: "string" } },
+                    lastDisconnect: {
+                        type: "object",
+                        properties: {
+                            at: { type: ["string", "null"] },
+                            code: { type: ["integer", "null"] },
+                            reason: { type: ["string", "null"] },
+                        },
+                        required: ["at", "code", "reason"],
+                    },
+                    toolAvailability: {
+                        type: "object",
+                        additionalProperties: {
+                            type: "object",
+                            properties: {
+                                available: { type: "boolean" },
+                                reason: { type: "string" },
+                            },
+                            required: ["available"],
+                        },
+                    },
+                },
+                required: [
+                    "extensionConnected",
+                    "activeSessions",
+                    "circuitBreaker",
+                    "uptimeSeconds",
+                    "tier",
+                ],
+            },
+        },
+        handler: async () => {
+            const extensionConnected = extensionClient.isConnected();
+            const circuitBreaker = extensionClient.getCircuitBreakerState();
+            const uptimeMs = Date.now() - startTime;
+            const latencyMs = extensionConnected ? extensionClient.lastRttMs : null;
+            const connectionQuality = latencyMs === null
+                ? undefined
+                : latencyMs < 100
+                    ? "healthy"
+                    : latencyMs < 500
+                        ? "degraded"
+                        : "poor";
+            const automationStatus = automationHooks?.getStatus() ?? null;
+            const unwired = automationStatus?.unwiredEnabledHooks ?? [];
+            const baseSuggestedActions = extensionConnected
+                ? [
+                    "Use explainSymbol to understand any function in one call",
+                    "Use refactorPreview to see what a refactoring would change before applying",
+                    "Use setEditorDecorations to highlight code review findings inline",
+                ]
+                : [
+                    "Connect the VS Code extension for LSP, debugger, and terminal tools",
+                    "File operations, Git, GitHub, and CLI tools are available without the extension",
+                ];
+            if (unwired.length > 0) {
+                baseSuggestedActions.push(`Automation hooks enabled but not wired in settings.json: ${unwired.join(", ")}. ` +
+                    `Add CC hook entries calling the bridge notify tools (see CLAUDE.md Automation Policy section).`);
+            }
+            // Compute tool availability: answers "why can't Claude call X?" without
+            // requiring the caller to try the tool first and parse the error.
+            const toolAvailability = {};
+            for (const [name, spec] of Object.entries(TOOL_AVAILABILITY_TABLE)) {
+                if (spec.extensionRequired && !extensionConnected) {
+                    toolAvailability[name] = {
+                        available: false,
+                        reason: "extension_disconnected",
+                    };
+                }
+                else if (spec.extensionRequired && circuitBreaker.suspended) {
+                    toolAvailability[name] = {
+                        available: false,
+                        reason: "circuit_breaker_open",
+                    };
+                }
+                else if (spec.extensionFallback) {
+                    // Available if extension is connected (extension path) OR probe is present (CLI fallback).
+                    if (extensionConnected && !circuitBreaker.suspended) {
+                        // available — omit
+                    }
+                    else if (spec.probe && probes[spec.probe]) {
+                        // available via probe fallback — omit
+                    }
+                    else {
+                        toolAvailability[name] = {
+                            available: false,
+                            reason: spec.probe
+                                ? `extension_disconnected_and_missing_probe:${spec.probe}`
+                                : "extension_disconnected",
+                        };
+                    }
+                }
+                else if (spec.probe && !probes[spec.probe]) {
+                    toolAvailability[name] = {
+                        available: false,
+                        reason: `missing_probe:${spec.probe}`,
+                    };
+                }
+                // else: available — omit from output
+            }
+            return successStructured({
+                extensionConnected,
+                activeSessions: sessions?.size ?? 1,
+                circuitBreaker: {
+                    suspended: circuitBreaker.suspended,
+                    consecutiveFailures: circuitBreaker.failures,
+                    openCount: circuitBreaker.openCount,
+                    lastOpenedAt: circuitBreaker.lastOpenedAt,
+                    ...(circuitBreaker.suspended && {
+                        resumesInMs: Math.max(0, circuitBreaker.suspendedUntil - Date.now()),
+                    }),
+                },
+                uptimeSeconds: Math.round(uptimeMs / 1000),
+                latencyMs: latencyMs ?? null,
+                ...(extensionClient.extensionPackageVersion !== null && {
+                    extensionPackageVersion: extensionClient.extensionPackageVersion,
+                }),
+                ...(connectionQuality !== undefined && { connectionQuality }),
+                ...(orchestrator !== null &&
+                    orchestrator !== undefined && {
+                    tokenBudget: {
+                        activeTokens: orchestrator.activeTokens,
+                        maxTokenBudget: ClaudeOrchestrator.MAX_TOKEN_BUDGET,
+                    },
+                }),
+                ...(automationStatus !== null && {
+                    automation: {
+                        ...automationStatus,
+                        ...(automationPolicyPath !== undefined && {
+                            policyPath: automationPolicyPath,
+                        }),
+                        ...(automationHooks && {
+                            ...automationHooks.getStats(),
+                        }),
+                    },
+                }),
+                tier: extensionConnected ? "full" : "basic",
+                tierDescription: extensionConnected
+                    ? "All tools available including LSP, debugger, and terminal integration"
+                    : "File operations, Git, GitHub, and CLI tools available. Connect the VS Code extension for LSP, debugger, and terminal tools.",
+                suggestedActions: baseSuggestedActions,
+                hint: extensionConnected
+                    ? "All tools available."
+                    : "Extension disconnected — extension-dependent tools (LSP, terminal, debugging, etc.) are temporarily unavailable. " +
+                        "Native tools (file search, git, GitHub) still work. " +
+                        "The extension will auto-reconnect, or the user can run the 'Claude IDE Bridge: Reconnect' command.",
+                ...(getDisconnectInfo && {
+                    lastDisconnect: getDisconnectInfo(),
+                }),
+                toolAvailability,
+            });
+        },
+    };
+}
+//# sourceMappingURL=bridgeStatus.js.map

package/dist/tools/bridgeStatus.js.map

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

package/dist/tools/cancelClaudeTask.d.ts

@@ -0,0 +1,48 @@
+import type { ClaudeOrchestrator } from "../claudeOrchestrator.js";
+export declare function createCancelClaudeTaskTool(orchestrator: ClaudeOrchestrator, sessionId: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            type: string;
+            properties: {
+                taskId: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                cancelled: {
+                    type: string;
+                };
+                taskId: {
+                    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/cancelClaudeTask.js

@@ -0,0 +1,56 @@
+import { ToolErrorCodes } from "../errors.js";
+import { error, successStructured } from "./utils.js";
+export function createCancelClaudeTaskTool(orchestrator, sessionId) {
+    return {
+        schema: {
+            name: "cancelClaudeTask",
+            description: "Cancel a pending or running Claude task.",
+            annotations: {
+                title: "Cancel Claude Task",
+                readOnlyHint: false,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    taskId: {
+                        type: "string",
+                        description: "Task ID to cancel",
+                    },
+                },
+                required: ["taskId"],
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    cancelled: { type: "boolean" },
+                    taskId: { type: "string" },
+                },
+                required: ["cancelled", "taskId"],
+            },
+        },
+        handler: async (args) => {
+            const taskId = args.taskId;
+            if (typeof taskId !== "string" || taskId.trim() === "") {
+                return error("taskId must be a non-empty string", ToolErrorCodes.INVALID_ARGS);
+            }
+            // Cancel auth is strict: only own session's tasks are visible.
+            const resolved = orchestrator.findTaskByPrefix(taskId, (t) => t.sessionId === sessionId);
+            if (resolved.ambiguous) {
+                return error(`Task ID prefix "${taskId}" is ambiguous — matches ${resolved.candidates?.length ?? 0} tasks: ${(resolved.candidates ?? []).map((c) => c.slice(0, 8)).join(", ")}. Provide a longer prefix.`, ToolErrorCodes.AMBIGUOUS_TASK_ID);
+            }
+            const task = resolved.task;
+            if (!task) {
+                return error(`Task "${taskId}" not found`, ToolErrorCodes.TASK_NOT_FOUND);
+            }
+            // Authorization: sessions may only cancel their own tasks
+            if (task.sessionId !== sessionId) {
+                return error(`Task "${taskId}" not found`, ToolErrorCodes.TASK_NOT_FOUND);
+            }
+            const cancelled = orchestrator.cancel(task.id);
+            return successStructured({ cancelled, taskId: task.id });
+        },
+    };
+}
+//# sourceMappingURL=cancelClaudeTask.js.map

package/dist/tools/cancelClaudeTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelClaudeTask.js","sourceRoot":"","sources":["../../src/tools/cancelClaudeTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,0BAA0B,CACxC,YAAgC,EAChC,SAAiB;IAEjB,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,0CAA0C;YACvD,WAAW,EAAE;gBACX,KAAK,EAAE,oBAAoB;gBAC3B,YAAY,EAAE,KAAK;gBACnB,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,KAAK;aACrB;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mBAAmB;qBACjC;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACrB;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;gBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;aAClC;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,OAAO,KAAK,CACV,mCAAmC,EACnC,cAAc,CAAC,YAAY,CAC5B,CAAC;YACJ,CAAC;YAED,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,CAC5C,MAAM,EACN,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CACjC,CAAC;YACF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,OAAO,KAAK,CACV,mBAAmB,MAAM,4BAA4B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAC5L,cAAc,CAAC,iBAAiB,CACjC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,KAAK,CACV,SAAS,MAAM,aAAa,EAC5B,cAAc,CAAC,cAAc,CAC9B,CAAC;YACJ,CAAC;YAED,0DAA0D;YAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,KAAK,CACV,SAAS,MAAM,aAAa,EAC5B,cAAc,CAAC,cAAc,CAC9B,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/C,OAAO,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/checkDocumentDirty.d.ts

@@ -0,0 +1,56 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createCheckDocumentDirtyTool(workspace: string, extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                success: {
+                    type: string;
+                };
+                filePath: {
+                    type: string;
+                };
+                isDirty: {
+                    type: string;
+                };
+                isUntitled: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                unknown: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/checkDocumentDirty.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import { requireString, resolveFilePath, successStructured } from "./utils.js";
+export function createCheckDocumentDirtyTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "checkDocumentDirty",
+            description: "Check if file has unsaved changes. Uses VS Code buffer when ext connected; heuristic otherwise.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                required: ["filePath"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Path to the file to check",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    success: { type: "boolean" },
+                    filePath: { type: "string" },
+                    isDirty: { type: "boolean" },
+                    isUntitled: { type: "boolean" },
+                    source: { type: "string" },
+                    unknown: { type: "boolean" },
+                    message: { type: "string" },
+                },
+                required: ["success", "filePath"],
+            },
+        },
+        async handler(args) {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Use extension for real buffer state when available
+            if (extensionClient?.isConnected()) {
+                const isDirty = await extensionClient.isDirty(filePath);
+                if (isDirty !== null) {
+                    return successStructured({
+                        success: true,
+                        filePath,
+                        isDirty,
+                        isUntitled: false,
+                        source: "vscode-buffer",
+                    });
+                }
+                // Fall through if extension returned null (file not open in editor)
+            }
+            // Fallback: check file exists on disk; buffer state is unknown
+            try {
+                fs.statSync(filePath);
+                return successStructured({
+                    success: true,
+                    filePath,
+                    isDirty: false,
+                    isUntitled: false,
+                    unknown: true,
+                    message: "VS Code extension not connected — isDirty may be inaccurate for files with unsaved editor changes",
+                });
+            }
+            catch {
+                return successStructured({
+                    success: false,
+                    filePath,
+                    message: "File not found",
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=checkDocumentDirty.js.map

package/dist/tools/checkDocumentDirty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkDocumentDirty.js","sourceRoot":"","sources":["../../src/tools/checkDocumentDirty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,UAAU,4BAA4B,CAC1C,SAAiB,EACjB,eAAiC;IAEjC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,iGAAiG;YACnG,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2BAA2B;qBACzC;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;aAClC;SACF;QAED,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAErD,qDAAqD;YACrD,IAAI,eAAe,EAAE,WAAW,EAAE,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACxD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,OAAO,iBAAiB,CAAC;wBACvB,OAAO,EAAE,IAAI;wBACb,QAAQ;wBACR,OAAO;wBACP,UAAU,EAAE,KAAK;wBACjB,MAAM,EAAE,eAAe;qBACxB,CAAC,CAAC;gBACL,CAAC;gBACD,oEAAoE;YACtE,CAAC;YAED,+DAA+D;YAC/D,IAAI,CAAC;gBACH,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACtB,OAAO,iBAAiB,CAAC;oBACvB,OAAO,EAAE,IAAI;oBACb,QAAQ;oBACR,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,KAAK;oBACjB,OAAO,EAAE,IAAI;oBACb,OAAO,EACL,mGAAmG;iBACtG,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,iBAAiB,CAAC;oBACvB,OAAO,EAAE,KAAK;oBACd,QAAQ;oBACR,OAAO,EAAE,gBAAgB;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/clipboard.d.ts

@@ -0,0 +1,80 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createReadClipboardTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                text: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createWriteClipboardTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                text: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                success: {
+                    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;
+    }>;
+};