patchwork-os 0.2.0-alpha.0

package/dist/orchestrator/orchestratorTools.js

@@ -0,0 +1,272 @@
+export function createOrchestratorTools(deps) {
+    return [
+        createGetOrchestratorStatusTool(deps),
+        createListBridgesTool(deps),
+        createSwitchWorkspaceTool(deps),
+        createListWorkspacesTool(deps),
+    ];
+}
+function createGetOrchestratorStatusTool(deps) {
+    return {
+        schema: {
+            name: "getOrchestratorStatus",
+            description: "Show the orchestrator bridge status: which IDE instances are connected, their workspaces, health, and how many Claude sessions are active.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            annotations: { readOnlyHint: true },
+        },
+        handler: async () => {
+            const uptimeSeconds = Math.floor((Date.now() - deps.startedAt) / 1000);
+            const all = deps.registry.getAll();
+            const healthy = deps.registry.getHealthy();
+            const warming = deps.registry.getWarmingUp();
+            const lines = [
+                `orchestrator port=${deps.config.port} uptime=${uptimeSeconds}s sessions=${deps.getActiveSessions()}`,
+                `bridges: ${all.length} total, ${healthy.length} healthy, ${warming.length} warming`,
+            ];
+            for (const b of all) {
+                const state = b.warmingUp
+                    ? "warming"
+                    : b.healthy
+                        ? "healthy"
+                        : "unhealthy";
+                const failures = b.consecutiveFailures > 0 ? ` failures=${b.consecutiveFailures}` : "";
+                lines.push(`  [${state}] ${b.ideName} port=${b.port} tools=${b.tools.length} workspace=${b.workspace}${failures}`);
+            }
+            const skipped = deps.registry.getRejected().length;
+            if (skipped > 0)
+                lines.push(`skipped lock files: ${skipped}`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        },
+    };
+}
+function createListBridgesTool(deps) {
+    return {
+        schema: {
+            name: "listBridges",
+            description: "List all known IDE bridge instances (healthy and unhealthy) with their ports, workspace paths, and connection details.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            annotations: { readOnlyHint: true },
+        },
+        handler: async () => {
+            const bridges = deps.registry.getAll().map((b) => ({
+                port: b.port,
+                ideName: b.ideName,
+                workspace: b.workspace,
+                workspaceFolders: b.workspaceFolders,
+                healthy: b.healthy,
+                warmingUp: b.warmingUp,
+                pid: b.pid,
+                startedAt: new Date(b.startedAt).toISOString(),
+                discoveredAt: new Date(b.discoveredAt).toISOString(),
+                lastCheckedAt: b.lastCheckedAt
+                    ? new Date(b.lastCheckedAt).toISOString()
+                    : null,
+                consecutiveFailures: b.consecutiveFailures,
+                availableTools: b.tools.map((t) => t.name),
+            }));
+            const rejected = deps.registry.getRejected();
+            const parts = [];
+            if (bridges.length === 0 && rejected.length === 0) {
+                parts.push("No child bridges found. Make sure at least one IDE is running with the claude-ide-bridge extension installed.");
+            }
+            else {
+                if (bridges.length > 0) {
+                    parts.push(JSON.stringify(bridges, null, 2));
+                }
+                if (rejected.length > 0) {
+                    parts.push("\n[INFO] Skipped lock files (non-bridge or invalid processes):");
+                    for (const r of rejected) {
+                        parts.push(`  port ${r.port}: ${r.reason}`);
+                    }
+                }
+            }
+            return { content: [{ type: "text", text: parts.join("\n") }] };
+        },
+    };
+}
+function createSwitchWorkspaceTool(deps) {
+    return {
+        schema: {
+            name: "switchWorkspace",
+            description: "Switch the active workspace for this session. Tool descriptions prefixed [ws1]/[ws2] show which workspace each tool belongs to; after switching, the tool list refreshes to show the new workspace's tools. Use listWorkspaces to see available options.",
+            inputSchema: {
+                type: "object",
+                required: ["workspace"],
+                additionalProperties: false,
+                properties: {
+                    workspace: {
+                        type: "string",
+                        description: "Absolute path to the workspace to switch to",
+                    },
+                    port: {
+                        type: "number",
+                        description: "Port number of a specific bridge — required when the same workspace is open in multiple IDEs simultaneously",
+                    },
+                },
+            },
+            annotations: { readOnlyHint: false },
+        },
+        handler: async (args) => {
+            const workspace = args.workspace;
+            const port = args.port;
+            const healthy = deps.registry.getHealthy();
+            const wsAlias = (b) => {
+                const idx = healthy.findIndex((h) => h.port === b.port);
+                return idx >= 0 ? `ws${idx + 1}` : `port ${b.port}`;
+            };
+            // If a specific port was provided, bypass workspace routing entirely
+            if (port !== undefined) {
+                const bridge = deps.registry.get(port);
+                if (!bridge) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `No bridge found on port ${port}. Call listWorkspaces to see available workspaces.`,
+                            },
+                        ],
+                    };
+                }
+                if (!bridge.healthy) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Bridge on port ${port} (${bridge.ideName}) is not healthy (${bridge.consecutiveFailures} failures). Try a different bridge.`,
+                            },
+                        ],
+                    };
+                }
+                deps.setStickyBridge(bridge.port);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Active workspace: ${wsAlias(bridge)} — ${bridge.workspace} (${bridge.ideName})\nTool list updated (${bridge.tools.length} tools).`,
+                        },
+                    ],
+                };
+            }
+            // Check for duplicate workspaces before picking
+            const dupes = deps.registry.getDuplicateWorkspaces();
+            const ambiguous = dupes.get(workspace);
+            if (ambiguous && ambiguous.length > 1) {
+                const options = ambiguous
+                    .map((b) => `  port ${b.port}: ${b.ideName} (${wsAlias(b)})`)
+                    .join("\n");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `"${workspace}" is open in ${ambiguous.length} IDEs — specify port:`,
+                                options,
+                            ].join("\n"),
+                        },
+                    ],
+                };
+            }
+            const bridge = deps.registry.pickForWorkspace(workspace);
+            if (!bridge) {
+                const warming = deps.registry.getWarmingUp();
+                let hint;
+                if (warming.length > 0) {
+                    hint = `Bridges starting up: ${warming.map((b) => `${b.ideName} port ${b.port}`).join(", ")}. Retry in a moment.`;
+                }
+                else if (healthy.length > 0) {
+                    hint = `Available: ${healthy.map((b, i) => `ws${i + 1} ${b.workspace}`).join(", ")}`;
+                }
+                else {
+                    hint = "No healthy bridges connected.";
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Workspace not found: ${workspace}\n${hint}`,
+                        },
+                    ],
+                };
+            }
+            deps.setStickyBridge(bridge.port);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Active workspace: ${wsAlias(bridge)} — ${bridge.workspace} (${bridge.ideName})\nTool list updated (${bridge.tools.length} tools).`,
+                    },
+                ],
+            };
+        },
+    };
+}
+function createListWorkspacesTool(deps) {
+    return {
+        schema: {
+            name: "listWorkspaces",
+            description: "List all currently available IDE workspaces. Call this to discover which workspaces you can work in before using workspace-specific tools.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            annotations: { readOnlyHint: true },
+        },
+        handler: async () => {
+            const healthy = deps.registry.getHealthy();
+            const warming = deps.registry.getWarmingUp();
+            const dupes = deps.registry.getDuplicateWorkspaces();
+            if (healthy.length === 0 && warming.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No IDE workspaces are currently available. Make sure at least one IDE is running with the extension connected.",
+                        },
+                    ],
+                };
+            }
+            const lines = [];
+            if (healthy.length > 0) {
+                lines.push("Available workspaces:");
+                healthy.forEach((b, i) => {
+                    const isDupe = dupes.has(b.workspace);
+                    const dupeWarning = isDupe
+                        ? (() => {
+                            const others = dupes
+                                .get(b.workspace)
+                                ?.filter((o) => o.port !== b.port)
+                                .map((o) => `${o.ideName} (port ${o.port})`)
+                                .join(", ");
+                            return `\n  [WARNING: same workspace also open in ${others}]`;
+                        })()
+                        : "";
+                    lines.push(`ws${i + 1}: ${b.workspace}\n  IDE: ${b.ideName} (port ${b.port})\n  Folders: ${b.workspaceFolders.join(", ")}${dupeWarning}`);
+                });
+            }
+            if (warming.length > 0) {
+                lines.push("\nStarting up (not yet ready):");
+                for (const b of warming) {
+                    const elapsed = Math.round((Date.now() - b.discoveredAt) / 1000);
+                    lines.push(`  ${b.workspace} — ${b.ideName} port ${b.port} (${elapsed}s elapsed)`);
+                }
+            }
+            lines.push("\nUse switchWorkspace to target a specific one.");
+            if (dupes.size > 0) {
+                lines.push("Use switchWorkspace with the port argument to disambiguate when multiple IDEs share a workspace.");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=orchestratorTools.js.map

package/dist/orchestrator/orchestratorTools.js.map

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

package/dist/patchworkCli.d.ts

@@ -0,0 +1,15 @@
+import type { ModelAdapter } from "./adapters/index.js";
+import type { PatchworkConfig } from "./patchworkConfig.js";
+import { loadConfig } from "./patchworkConfig.js";
+/**
+ * resolveModel — parses `--model <name>` from argv and merges with the
+ * on-disk PatchworkConfig. CLI wins over file. Returns the resolved config
+ * + constructed adapter, or null if the user didn't pass --model and has
+ * no config file (meaning: run bridge in default Claude-CLI mode).
+ */
+export declare function resolveModel(argv: string[], deps?: {
+    loadConfig?: typeof loadConfig;
+}): {
+    config: PatchworkConfig;
+    adapter: ModelAdapter;
+} | null;

package/dist/patchworkCli.js

@@ -0,0 +1,41 @@
+import { createAdapter } from "./adapters/index.js";
+import { loadConfig, validateModelChoice } from "./patchworkConfig.js";
+/**
+ * resolveModel — parses `--model <name>` from argv and merges with the
+ * on-disk PatchworkConfig. CLI wins over file. Returns the resolved config
+ * + constructed adapter, or null if the user didn't pass --model and has
+ * no config file (meaning: run bridge in default Claude-CLI mode).
+ */
+export function resolveModel(argv, deps = {}) {
+    const cliModel = findFlag(argv, "--model");
+    const configPath = findFlag(argv, "--patchwork-config");
+    const load = deps.loadConfig ?? loadConfig;
+    let config;
+    try {
+        config = configPath ? load(configPath) : load();
+    }
+    catch (err) {
+        throw new Error(`Could not load Patchwork config: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (cliModel) {
+        if (!validateModelChoice(cliModel)) {
+            throw new Error(`--model must be one of: claude, openai, gemini, grok, local (got: ${cliModel})`);
+        }
+        config = { ...config, model: cliModel };
+    }
+    // No --model flag AND no saved config → caller should skip adapter init.
+    if (!cliModel && !configPath) {
+        return null;
+    }
+    return { config, adapter: createAdapter(config) };
+}
+function findFlag(argv, name) {
+    const idx = argv.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    const value = argv[idx + 1];
+    if (!value || value.startsWith("--"))
+        return undefined;
+    return value;
+}
+//# sourceMappingURL=patchworkCli.js.map

package/dist/patchworkCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchworkCli.js","sourceRoot":"","sources":["../src/patchworkCli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAc,EACd,OAA2C,EAAE;IAE7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAExD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC;IAC3C,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,qEAAqE,QAAQ,GAAG,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAc,EAAE,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/patchworkConfig.d.ts

@@ -0,0 +1,28 @@
+import type { ModelChoice } from "./adapters/index.js";
+export interface PatchworkConfig {
+    model: ModelChoice;
+    defaultModel?: string;
+    apiKeys?: {
+        anthropic?: string;
+        openai?: string;
+        google?: string;
+        xai?: string;
+    };
+    localEndpoint?: string;
+    localModel?: string;
+    dashboard?: {
+        port: number;
+        requireApproval: Array<"low" | "medium" | "high">;
+        pushNotifications: boolean;
+        webhookUrl?: string;
+    };
+    recipesDir?: string;
+    /** Approval gate level — mirrors CLI --approval-gate. Persisted so dashboard changes survive restart. */
+    approvalGate?: "off" | "high" | "all";
+    /** Absolute path to a managed settings file (admin-controlled, highest rule precedence). */
+    managedSettingsPath?: string;
+}
+export declare function defaultConfigPath(): string;
+export declare function loadConfig(path?: string): PatchworkConfig;
+export declare function saveConfig(config: PatchworkConfig, path?: string): void;
+export declare function validateModelChoice(value: string): value is ModelChoice;

package/dist/patchworkConfig.js

@@ -0,0 +1,30 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULTS = {
+    model: "claude",
+    dashboard: {
+        port: 3000,
+        requireApproval: ["high"],
+        pushNotifications: false,
+    },
+    recipesDir: join(homedir(), ".patchwork", "recipes"),
+};
+export function defaultConfigPath() {
+    return join(homedir(), ".patchwork", "config.json");
+}
+export function loadConfig(path = defaultConfigPath()) {
+    if (!existsSync(path))
+        return { ...DEFAULTS };
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    return { ...DEFAULTS, ...parsed };
+}
+export function saveConfig(config, path = defaultConfigPath()) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+export function validateModelChoice(value) {
+    return ["claude", "openai", "gemini", "grok", "local"].includes(value);
+}
+//# sourceMappingURL=patchworkConfig.js.map

package/dist/patchworkConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchworkConfig.js","sourceRoot":"","sources":["../src/patchworkConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA2B1C,MAAM,QAAQ,GAAoB;IAChC,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,eAAe,EAAE,CAAC,MAAM,CAAC;QACzB,iBAAiB,EAAE,KAAK;KACzB;IACD,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC;CACrD,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,iBAAiB,EAAE;IACnD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6B,CAAC;IAC3D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAuB,EACvB,IAAI,GAAG,iBAAiB,EAAE;IAE1B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Public type contract for Claude IDE Bridge plugin authors.
+ *
+ * A plugin is an npm package or local directory that:
+ *  1. Contains a `claude-ide-bridge-plugin.json` manifest at its root.
+ *  2. Exports a `register` function from the declared entrypoint.
+ *
+ * @example
+ * ```typescript
+ * // my-plugin/src/index.ts
+ * import type { PluginRegisterFn } from "claude-ide-bridge/plugin";
+ *
+ * const register: PluginRegisterFn = (ctx) => ({
+ *   tools: [
+ *     {
+ *       schema: {
+ *         name: "myOrgFetchTicket",
+ *         description: "Fetch a Jira ticket by ID",
+ *         inputSchema: { type: "object", required: ["id"], properties: { id: { type: "string" } } },
+ *       },
+ *       handler: async (args) => ({
+ *         content: [{ type: "text", text: JSON.stringify({ id: args.id }) }],
+ *       }),
+ *     },
+ *   ],
+ * });
+ * export default register;
+ * ```
+ */
+export interface PluginToolSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    /** When true, the tool is hidden from tools/list when the VS Code extension is disconnected. */
+    extensionRequired?: boolean;
+    annotations?: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+}
+export type PluginToolHandler = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/** Safe subset of Config exposed to plugins — never includes auth tokens or security-sensitive fields. */
+export interface PluginSafeConfig {
+    workspace: string;
+    workspaceFolders: string[];
+    commandTimeout: number;
+    maxResultSize: number;
+}
+export interface PluginLogger {
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+    debug(msg: string, data?: Record<string, unknown>): void;
+}
+export interface PluginContext {
+    workspace: string;
+    workspaceFolders: string[];
+    config: Readonly<PluginSafeConfig>;
+    logger: PluginLogger;
+}
+export interface PluginToolRegistration {
+    schema: PluginToolSchema;
+    handler: PluginToolHandler;
+    /** Override the default 60s tool timeout. */
+    timeoutMs?: number;
+}
+export interface PluginRegistration {
+    tools: PluginToolRegistration[];
+}
+/** The function a plugin's entrypoint module must export as `register` (or default). */
+export type PluginRegisterFn = (context: PluginContext) => Promise<PluginRegistration> | PluginRegistration;
+export interface PluginManifest {
+    /** Must be 1 for this version of the bridge. */
+    schemaVersion: number;
+    /** Identifying name, e.g. "my-org/my-plugin". Used in log output only. */
+    name: string;
+    /** Plugin semver version string. Used in log output. */
+    version?: string;
+    /** Human-readable description shown at bridge startup. */
+    description?: string;
+    /** Relative path from the package root to the entrypoint module. */
+    entrypoint: string;
+    /**
+     * Required prefix for all tool names registered by this plugin.
+     * Must match /^[a-zA-Z][a-zA-Z0-9_]{1,19}$/.
+     * All tool names must start with this exact prefix.
+     * Enforced at load time to prevent collisions with built-in tools.
+     */
+    toolNamePrefix: string;
+    /** Minimum bridge version required (semver string). Warning if running version is older. */
+    minBridgeVersion?: string;
+    /** Declared capabilities — informational only in v1, logged at startup. */
+    permissions?: string[];
+}

package/dist/plugin.js

@@ -0,0 +1,31 @@
+/**
+ * Public type contract for Claude IDE Bridge plugin authors.
+ *
+ * A plugin is an npm package or local directory that:
+ *  1. Contains a `claude-ide-bridge-plugin.json` manifest at its root.
+ *  2. Exports a `register` function from the declared entrypoint.
+ *
+ * @example
+ * ```typescript
+ * // my-plugin/src/index.ts
+ * import type { PluginRegisterFn } from "claude-ide-bridge/plugin";
+ *
+ * const register: PluginRegisterFn = (ctx) => ({
+ *   tools: [
+ *     {
+ *       schema: {
+ *         name: "myOrgFetchTicket",
+ *         description: "Fetch a Jira ticket by ID",
+ *         inputSchema: { type: "object", required: ["id"], properties: { id: { type: "string" } } },
+ *       },
+ *       handler: async (args) => ({
+ *         content: [{ type: "text", text: JSON.stringify({ id: args.id }) }],
+ *       }),
+ *     },
+ *   ],
+ * });
+ * export default register;
+ * ```
+ */
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/pluginLoader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Plugin loader for Claude IDE Bridge.
+ *
+ * Discovers, validates, and dynamically imports plugin packages declared via
+ * --plugin CLI flags or the `plugins` config file key.
+ *
+ * Security model:
+ *  - Plugins are never auto-discovered. They must be explicitly declared.
+ *  - Plugins run in-process with full Node.js access (no sandbox).
+ *  - The `toolNamePrefix` field is enforced to prevent collision with built-in tools.
+ *  - Sensitive config fields (authToken, etc.) are not exposed to plugins.
+ *  - Each plugin load failure is isolated — a bad plugin is skipped, not fatal.
+ */
+import type { Config } from "./config.js";
+import type { Logger } from "./logger.js";
+import type { PluginManifest } from "./plugin.js";
+import type { ToolHandler, ToolSchema } from "./transport.js";
+export interface LoadedPluginTool {
+    schema: ToolSchema;
+    handler: ToolHandler;
+    timeoutMs?: number;
+}
+export interface LoadedPlugin {
+    spec: string;
+    pluginDir: string;
+    manifest: PluginManifest;
+    tools: LoadedPluginTool[];
+}
+/**
+ * Load all plugins declared in config.plugins and return full LoadedPlugin objects.
+ *
+ * Collision-detection across plugins still applies.
+ */
+export declare function loadPluginsFull(pluginSpecs: string[], config: Config, logger: Logger): Promise<LoadedPlugin[]>;
+/**
+ * Load all plugins declared in config.plugins.
+ *
+ * Each plugin is loaded in isolation — a failure in one plugin is logged and
+ * skipped; the bridge continues with all successfully loaded plugins.
+ *
+ * Returns a flat list of tool registrations ready for registerAllTools().
+ */
+export declare function loadPlugins(pluginSpecs: string[], config: Config, logger: Logger): Promise<LoadedPluginTool[]>;
+export declare function loadOnePluginFull(spec: string, config: Config, logger: Logger, existingNames?: Set<string>, isHotReload?: boolean): Promise<LoadedPlugin | null>;