@clawmasons/mason 0.1.1 → 0.1.2

package/dist/acp/bridge.d.ts

@@ -0,0 +1,92 @@
+/**
+ * ACP SDK Bridge — Dual-Connection ACP Protocol Mediator
+ *
+ * The bridge presents an AgentSideConnection to the editor (via ndjson
+ * on provided streams) and a ClientSideConnection to the container agent
+ * (via docker compose run piped stdio). It handles deferred startup:
+ * `initialize` responds immediately with local capabilities, `session/new`
+ * starts the container, and subsequent messages are forwarded bidirectionally.
+ *
+ * PRD refs: REQ-SDK-002, REQ-SDK-003, REQ-SDK-004, REQ-SDK-009,
+ *           REQ-SDK-010, REQ-SDK-013
+ */
+import type { ChildProcess } from "node:child_process";
+import type { AcpLogger } from "./logger.js";
+export interface AcpSdkBridgeConfig {
+    /**
+     * Callback invoked when `session/new` arrives with a `cwd` field.
+     * Must start the container process and return a ChildProcess with
+     * piped stdin/stdout for ACP ndjson communication.
+     */
+    onSessionNew: (cwd: string) => ChildProcess | Promise<ChildProcess>;
+    /** Optional logger for diagnostics. */
+    logger?: AcpLogger;
+}
+export declare class AcpSdkBridge {
+    private readonly config;
+    private readonly logger?;
+    private editorConnection;
+    private containerConnection;
+    private childProcess;
+    private initializeParams;
+    private sessionActive;
+    constructor(config: AcpSdkBridgeConfig);
+    /**
+     * Start the bridge with the given editor-facing streams.
+     * Creates an AgentSideConnection that handles the ACP protocol
+     * with the editor.
+     */
+    start(editorInput: ReadableStream<Uint8Array>, editorOutput: WritableStream<Uint8Array>): void;
+    /**
+     * Promise that resolves when the editor connection closes.
+     */
+    get closed(): Promise<void>;
+    /**
+     * Stop the bridge: clean up container and editor connections.
+     */
+    stop(): Promise<void>;
+    private createEditorAgent;
+    /**
+     * Handle `initialize` from the editor.
+     * Returns capabilities locally without starting a container. (REQ-SDK-004)
+     */
+    private handleInitialize;
+    /**
+     * Handle `session/new` from the editor.
+     * Starts the container, creates ClientSideConnection, forwards
+     * initialize + session/new, returns the container's response. (REQ-SDK-004)
+     */
+    private handleNewSession;
+    /**
+     * Handle `prompt` from the editor.
+     * Forwards to the container and returns its response.
+     */
+    private handlePrompt;
+    /**
+     * Handle `cancel` from the editor.
+     * Forwards cancel notification to the container. (REQ-SDK-010)
+     */
+    private handleCancel;
+    /**
+     * Handle `authenticate` from the editor.
+     * Forwards to the container if connected, otherwise returns empty.
+     */
+    private handleAuthenticate;
+    /**
+     * Create a Client implementation for the ClientSideConnection.
+     * Forwards notifications from the container back to the editor. (REQ-SDK-010)
+     */
+    private createContainerClient;
+    private forwardSessionUpdate;
+    private forwardRequestPermission;
+    private forwardReadTextFile;
+    private forwardWriteTextFile;
+    private forwardCreateTerminal;
+    private forwardTerminalOutput;
+    private forwardReleaseTerminal;
+    private forwardWaitForTerminalExit;
+    private forwardKillTerminal;
+    private handleContainerDisconnect;
+    private cleanupContainer;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/acp/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/acp/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoCvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,uCAAuC;IACvC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY;IAEpC,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,kBAAkB;IAKtC;;;;OAIG;IACH,KAAK,CACH,WAAW,EAAE,cAAc,CAAC,UAAU,CAAC,EACvC,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,GACvC,IAAI;IAmBP;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1B;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;YACW,gBAAgB;IAY9B;;;;OAIG;YACW,gBAAgB;IAmE9B;;;OAGG;YACW,YAAY;IAY1B;;;OAGG;YACW,YAAY;IAU1B;;;OAGG;YACW,kBAAkB;IAShC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;YAcf,oBAAoB;YAMpB,wBAAwB;YAQxB,mBAAmB;YAOnB,oBAAoB;YAOpB,qBAAqB;YASrB,qBAAqB;YAOrB,sBAAsB;YAKtB,0BAA0B;YAO1B,mBAAmB;IAOjC,OAAO,CAAC,yBAAyB;YAQnB,gBAAgB;CAW/B"}

package/dist/acp/bridge.js

@@ -0,0 +1,266 @@
+/**
+ * ACP SDK Bridge — Dual-Connection ACP Protocol Mediator
+ *
+ * The bridge presents an AgentSideConnection to the editor (via ndjson
+ * on provided streams) and a ClientSideConnection to the container agent
+ * (via docker compose run piped stdio). It handles deferred startup:
+ * `initialize` responds immediately with local capabilities, `session/new`
+ * starts the container, and subsequent messages are forwarded bidirectionally.
+ *
+ * PRD refs: REQ-SDK-002, REQ-SDK-003, REQ-SDK-004, REQ-SDK-009,
+ *           REQ-SDK-010, REQ-SDK-013
+ */
+import { Readable, Writable } from "node:stream";
+import { AgentSideConnection, ClientSideConnection, ndJsonStream, PROTOCOL_VERSION, RequestError, } from "@agentclientprotocol/sdk";
+// ── AcpSdkBridge ─────────────────────────────────────────────────────
+export class AcpSdkBridge {
+    config;
+    logger;
+    editorConnection = null;
+    containerConnection = null;
+    childProcess = null;
+    initializeParams = null;
+    sessionActive = false;
+    constructor(config) {
+        this.config = config;
+        this.logger = config.logger;
+    }
+    /**
+     * Start the bridge with the given editor-facing streams.
+     * Creates an AgentSideConnection that handles the ACP protocol
+     * with the editor.
+     */
+    start(editorInput, editorOutput) {
+        if (this.editorConnection)
+            return;
+        const stream = ndJsonStream(editorOutput, editorInput);
+        this.editorConnection = new AgentSideConnection((conn) => this.createEditorAgent(conn), stream);
+        this.logger?.log("[bridge] AgentSideConnection started for editor");
+        // Monitor editor connection lifecycle (REQ-SDK-009)
+        void this.editorConnection.closed.then(() => {
+            this.logger?.log("[bridge] Editor connection closed");
+            void this.cleanupContainer();
+        });
+    }
+    /**
+     * Promise that resolves when the editor connection closes.
+     */
+    get closed() {
+        if (!this.editorConnection) {
+            return Promise.resolve();
+        }
+        return this.editorConnection.closed;
+    }
+    /**
+     * Stop the bridge: clean up container and editor connections.
+     */
+    async stop() {
+        await this.cleanupContainer();
+        this.editorConnection = null;
+        this.logger?.log("[bridge] Bridge stopped");
+    }
+    // ── Editor-Facing Agent Implementation ──────────────────────────────
+    createEditorAgent(_conn) {
+        return {
+            initialize: (params) => this.handleInitialize(params),
+            newSession: (params) => this.handleNewSession(params),
+            prompt: (params) => this.handlePrompt(params),
+            cancel: (params) => this.handleCancel(params),
+            authenticate: (params) => this.handleAuthenticate(params),
+        };
+    }
+    /**
+     * Handle `initialize` from the editor.
+     * Returns capabilities locally without starting a container. (REQ-SDK-004)
+     */
+    async handleInitialize(params) {
+        this.logger?.log("[bridge] initialize from editor");
+        // Store for forwarding to container later
+        this.initializeParams = params;
+        return {
+            protocolVersion: params.protocolVersion ?? PROTOCOL_VERSION,
+            agentCapabilities: {},
+            agentInfo: { name: "mason", version: "1.0.0" },
+        };
+    }
+    /**
+     * Handle `session/new` from the editor.
+     * Starts the container, creates ClientSideConnection, forwards
+     * initialize + session/new, returns the container's response. (REQ-SDK-004)
+     */
+    async handleNewSession(params) {
+        const cwd = params.cwd ?? process.cwd();
+        this.logger?.log(`[bridge] session/new from editor — cwd: "${cwd}"`);
+        if (this.sessionActive) {
+            this.logger?.log("[bridge] Cleaning up previous session");
+            await this.cleanupContainer();
+        }
+        // Start the container process
+        const child = await Promise.resolve(this.config.onSessionNew(cwd));
+        this.childProcess = child;
+        if (!child.stdin || !child.stdout) {
+            throw RequestError.internalError(undefined, "Container process missing stdin/stdout");
+        }
+        // Create ClientSideConnection to the container (REQ-SDK-003)
+        const containerOutput = Writable.toWeb(child.stdin);
+        const containerInput = Readable.toWeb(child.stdout);
+        const containerStream = ndJsonStream(containerOutput, containerInput);
+        this.containerConnection = new ClientSideConnection((agent) => this.createContainerClient(agent), containerStream);
+        this.sessionActive = true;
+        // Monitor container connection lifecycle (REQ-SDK-013)
+        void this.containerConnection.closed.then(() => {
+            this.logger?.log("[bridge] Container connection closed");
+            this.handleContainerDisconnect();
+        });
+        // Monitor child process exit (REQ-SDK-013)
+        child.on("exit", (code, signal) => {
+            this.logger?.log(`[bridge] Container process exited (code=${code}, signal=${signal})`);
+            this.handleContainerDisconnect();
+        });
+        child.on("error", (err) => {
+            this.logger?.error(`[bridge] Container process error: ${err.message}`);
+            this.handleContainerDisconnect();
+        });
+        // Pipe container stderr to logger
+        if (child.stderr) {
+            child.stderr.on("data", (chunk) => {
+                this.logger?.log(`[container] ${chunk.toString().trimEnd()}`);
+            });
+        }
+        // Forward initialize to the container
+        const initParams = this.initializeParams ?? {
+            protocolVersion: PROTOCOL_VERSION,
+        };
+        this.logger?.log("[bridge] Forwarding initialize to container");
+        await this.containerConnection.initialize(initParams);
+        // Forward session/new to the container
+        this.logger?.log("[bridge] Forwarding session/new to container");
+        const response = await this.containerConnection.newSession(params);
+        return response;
+    }
+    /**
+     * Handle `prompt` from the editor.
+     * Forwards to the container and returns its response.
+     */
+    async handlePrompt(params) {
+        if (!this.containerConnection) {
+            throw RequestError.internalError(undefined, "No active session — send session/new first");
+        }
+        this.logger?.log("[bridge] Forwarding prompt to container");
+        return this.containerConnection.prompt(params);
+    }
+    /**
+     * Handle `cancel` from the editor.
+     * Forwards cancel notification to the container. (REQ-SDK-010)
+     */
+    async handleCancel(params) {
+        if (!this.containerConnection) {
+            this.logger?.log("[bridge] cancel received but no container connection");
+            return;
+        }
+        this.logger?.log("[bridge] Forwarding cancel to container");
+        await this.containerConnection.cancel(params);
+    }
+    /**
+     * Handle `authenticate` from the editor.
+     * Forwards to the container if connected, otherwise returns empty.
+     */
+    async handleAuthenticate(params) {
+        if (!this.containerConnection) {
+            return {};
+        }
+        return this.containerConnection.authenticate(params);
+    }
+    // ── Container-Facing Client Implementation ──────────────────────────
+    /**
+     * Create a Client implementation for the ClientSideConnection.
+     * Forwards notifications from the container back to the editor. (REQ-SDK-010)
+     */
+    createContainerClient(_agent) {
+        return {
+            requestPermission: (params) => this.forwardRequestPermission(params),
+            sessionUpdate: (params) => this.forwardSessionUpdate(params),
+            readTextFile: (params) => this.forwardReadTextFile(params),
+            writeTextFile: (params) => this.forwardWriteTextFile(params),
+            createTerminal: (params) => this.forwardCreateTerminal(params),
+            terminalOutput: (params) => this.forwardTerminalOutput(params),
+            releaseTerminal: (params) => this.forwardReleaseTerminal(params),
+            waitForTerminalExit: (params) => this.forwardWaitForTerminalExit(params),
+            killTerminal: (params) => this.forwardKillTerminal(params),
+        };
+    }
+    async forwardSessionUpdate(params) {
+        if (!this.editorConnection)
+            return;
+        this.logger?.log("[bridge] Forwarding sessionUpdate to editor");
+        await this.editorConnection.sessionUpdate(params);
+    }
+    async forwardRequestPermission(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        this.logger?.log("[bridge] Forwarding requestPermission to editor");
+        return this.editorConnection.requestPermission(params);
+    }
+    async forwardReadTextFile(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        return this.editorConnection.readTextFile(params);
+    }
+    async forwardWriteTextFile(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        return this.editorConnection.writeTextFile(params);
+    }
+    async forwardCreateTerminal(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        // createTerminal returns a TerminalHandle; extract the terminalId for the raw response
+        const handle = await this.editorConnection.createTerminal(params);
+        return { terminalId: handle.id };
+    }
+    async forwardTerminalOutput(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        return this.editorConnection.extMethod("terminal/output", params);
+    }
+    async forwardReleaseTerminal(params) {
+        if (!this.editorConnection)
+            return;
+        return this.editorConnection.extMethod("terminal/release", params);
+    }
+    async forwardWaitForTerminalExit(params) {
+        if (!this.editorConnection) {
+            throw RequestError.internalError(undefined, "Editor connection not available");
+        }
+        return this.editorConnection.extMethod("terminal/waitForExit", params);
+    }
+    async forwardKillTerminal(params) {
+        if (!this.editorConnection)
+            return;
+        return this.editorConnection.extMethod("terminal/kill", params);
+    }
+    // ── Container Lifecycle ─────────────────────────────────────────────
+    handleContainerDisconnect() {
+        if (!this.sessionActive)
+            return;
+        this.logger?.log("[bridge] Container disconnected — cleaning up for next session");
+        this.containerConnection = null;
+        this.childProcess = null;
+        this.sessionActive = false;
+    }
+    async cleanupContainer() {
+        this.sessionActive = false;
+        if (this.childProcess) {
+            this.logger?.log("[bridge] Killing container child process");
+            this.childProcess.kill();
+            this.childProcess = null;
+        }
+        this.containerConnection = null;
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/acp/bridge.js.map

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

package/dist/acp/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * File-based logger for ACP runtime.
+ *
+ * Writes timestamped log lines to `{logDir}/acp.log`.
+ * Used in both stdio and HTTP transport modes so that diagnostic
+ * output never pollutes stdout (which stdio transport needs for JSON-RPC).
+ */
+export interface AcpLogger {
+    log(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    close(): void;
+}
+/**
+ * Create a file-appending logger that writes to `{logDir}/acp.log`.
+ * Creates the directory if it doesn't exist.
+ */
+export declare function createFileLogger(logDir: string): AcpLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/acp/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/acp/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAuB1D"}

package/dist/acp/logger.js

@@ -0,0 +1,35 @@
+/**
+ * File-based logger for ACP runtime.
+ *
+ * Writes timestamped log lines to `{logDir}/acp.log`.
+ * Used in both stdio and HTTP transport modes so that diagnostic
+ * output never pollutes stdout (which stdio transport needs for JSON-RPC).
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Create a file-appending logger that writes to `{logDir}/acp.log`.
+ * Creates the directory if it doesn't exist.
+ */
+export function createFileLogger(logDir) {
+    fs.mkdirSync(logDir, { recursive: true });
+    const logPath = path.join(logDir, "acp.log");
+    const stream = fs.createWriteStream(logPath, { flags: "a" });
+    function write(level, args) {
+        const ts = new Date().toISOString();
+        const msg = args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ");
+        stream.write(`${ts} [${level}] ${msg}\n`);
+    }
+    return {
+        log(...args) {
+            write("INFO", args);
+        },
+        error(...args) {
+            write("ERROR", args);
+        },
+        close() {
+            stream.end();
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/acp/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/acp/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAE7D,SAAS,KAAK,CAAC,KAAa,EAAE,IAAe;QAC3C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,KAAK,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,GAAG,CAAC,GAAG,IAAe;YACpB,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,GAAG,IAAe;YACtB,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK;YACH,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/acp/matcher.d.ts

@@ -0,0 +1,60 @@
+import type { ResolvedApp } from "@clawmasons/shared";
+/**
+ * An MCP server configuration from an ACP client's mcpServers map.
+ */
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+/**
+ * A matched MCP server linked to its chapter App.
+ */
+export interface MatchedServer {
+    /** The mcpServers key (e.g., "github") */
+    name: string;
+    /** The original MCP server config from the ACP client */
+    config: McpServerConfig;
+    /** The chapter App that matched */
+    app: ResolvedApp;
+    /** The app's short name (e.g., "github") */
+    appShortName: string;
+}
+/**
+ * An unmatched MCP server with a reason for not matching.
+ */
+export interface UnmatchedServer {
+    /** The mcpServers key */
+    name: string;
+    /** The original MCP server config from the ACP client */
+    config: McpServerConfig;
+    /** Human-readable explanation of why no match was found */
+    reason: string;
+}
+/**
+ * The result of matching ACP client mcpServers against chapter Apps.
+ */
+export interface MatchResult {
+    matched: MatchedServer[];
+    unmatched: UnmatchedServer[];
+}
+/**
+ * Build a case-insensitive index from app short names to their ResolvedApp objects.
+ * Multiple apps can share the same short name (handled by disambiguation).
+ */
+export declare function buildAppShortNameIndex(apps: ResolvedApp[]): Map<string, ResolvedApp[]>;
+/**
+ * Match ACP client mcpServers entries against chapter's resolved Apps.
+ *
+ * Matching uses `getAppShortName()` as the primary key (case-insensitive).
+ * When multiple apps share the same short name, command+args or URL
+ * are used as secondary disambiguation signals.
+ *
+ * @param mcpServers - The ACP client's mcpServers configuration map
+ * @param apps - The resolved Apps from the agent dependency graph
+ * @returns A MatchResult with matched and unmatched server lists
+ */
+export declare function matchServers(mcpServers: Record<string, McpServerConfig>, apps: ResolvedApp[]): MatchResult;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/acp/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/acp/matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,EAAE,eAAe,CAAC;IACxB,mCAAmC;IACnC,GAAG,EAAE,WAAW,CAAC;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,EAAE,eAAe,CAAC;IACxB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAY5B;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC3C,IAAI,EAAE,WAAW,EAAE,GAClB,WAAW,CAgCb"}

package/dist/acp/matcher.js

@@ -0,0 +1,101 @@
+import { getAppShortName } from "@clawmasons/shared";
+/**
+ * Build a case-insensitive index from app short names to their ResolvedApp objects.
+ * Multiple apps can share the same short name (handled by disambiguation).
+ */
+export function buildAppShortNameIndex(apps) {
+    const index = new Map();
+    for (const app of apps) {
+        const shortName = getAppShortName(app.name).toLowerCase();
+        let list = index.get(shortName);
+        if (!list) {
+            list = [];
+            index.set(shortName, list);
+        }
+        list.push(app);
+    }
+    return index;
+}
+/**
+ * Check if command+args match between an mcpServers entry and an app.
+ */
+function commandMatches(config, app) {
+    if (!config.command || !app.command)
+        return false;
+    if (config.command !== app.command)
+        return false;
+    const configArgs = config.args ?? [];
+    const appArgs = app.args ?? [];
+    if (configArgs.length !== appArgs.length)
+        return false;
+    return configArgs.every((arg, i) => arg === appArgs[i]);
+}
+/**
+ * Check if URL matches between an mcpServers entry and an app.
+ */
+function urlMatches(config, app) {
+    if (!config.url || !app.url)
+        return false;
+    return config.url === app.url;
+}
+/**
+ * Disambiguate among multiple apps that share the same short name,
+ * using command+args or URL as secondary signals.
+ */
+function disambiguate(config, candidates) {
+    // Try command+args match
+    for (const app of candidates) {
+        if (commandMatches(config, app))
+            return app;
+    }
+    // Try URL match
+    for (const app of candidates) {
+        if (urlMatches(config, app))
+            return app;
+    }
+    // No disambiguation possible — return first candidate
+    // candidates is guaranteed non-empty by the caller
+    const fallback = candidates[0];
+    if (!fallback)
+        throw new Error("Unexpected empty candidates array");
+    return fallback;
+}
+/**
+ * Match ACP client mcpServers entries against chapter's resolved Apps.
+ *
+ * Matching uses `getAppShortName()` as the primary key (case-insensitive).
+ * When multiple apps share the same short name, command+args or URL
+ * are used as secondary disambiguation signals.
+ *
+ * @param mcpServers - The ACP client's mcpServers configuration map
+ * @param apps - The resolved Apps from the agent dependency graph
+ * @returns A MatchResult with matched and unmatched server lists
+ */
+export function matchServers(mcpServers, apps) {
+    const index = buildAppShortNameIndex(apps);
+    const matched = [];
+    const unmatched = [];
+    for (const [name, config] of Object.entries(mcpServers)) {
+        const key = name.toLowerCase();
+        const candidates = index.get(key);
+        if (!candidates || candidates.length === 0) {
+            unmatched.push({
+                name,
+                config,
+                reason: `No matching chapter App found for server "${name}"`,
+            });
+            continue;
+        }
+        const app = candidates.length === 1
+            ? (candidates[0] ?? disambiguate(config, candidates))
+            : disambiguate(config, candidates);
+        matched.push({
+            name,
+            config,
+            app,
+            appShortName: getAppShortName(app.name),
+        });
+    }
+    return { matched, unmatched };
+}
+//# sourceMappingURL=matcher.js.map

package/dist/acp/matcher.js.map

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

package/dist/acp/rewriter.d.ts

@@ -0,0 +1,35 @@
+import type { MatchResult, MatchedServer, McpServerConfig } from "./matcher.js";
+/**
+ * The result of rewriting ACP client mcpServers for the agent container.
+ */
+export interface RewriteResult {
+    /** The rewritten mcpServers config with a single `chapter` proxy entry */
+    mcpServers: Record<string, McpServerConfig>;
+    /** Credentials extracted from matched servers' env fields (for credential-service session overrides) */
+    extractedCredentials: Record<string, string>;
+}
+/**
+ * Extract all credential key-value pairs from matched servers' env fields.
+ *
+ * Merges all env records into a single flat record. If two servers provide
+ * the same key, the later one wins (iteration order of matched array).
+ *
+ * @param matched - The matched servers from the matcher
+ * @returns A flat record of all credential key-value pairs
+ */
+export declare function extractCredentials(matched: MatchedServer[]): Record<string, string>;
+/**
+ * Rewrite the ACP client's mcpServers config for the agent container.
+ *
+ * Replaces all matched MCP server entries with a single `chapter` entry
+ * pointing to the chapter proxy's streamable-http endpoint. Extracts
+ * credentials from matched servers' env fields for injection into the
+ * credential-service as session overrides.
+ *
+ * @param matchResult - The result from matchServers()
+ * @param proxyUrl - The chapter proxy URL inside the Docker network (e.g., "http://proxy:3000/mcp")
+ * @param sessionToken - The session authentication token
+ * @returns The rewritten mcpServers config and extracted credentials
+ */
+export declare function rewriteMcpConfig(matchResult: MatchResult, proxyUrl: string, sessionToken: string): RewriteResult;
+//# sourceMappingURL=rewriter.d.ts.map

package/dist/acp/rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.d.ts","sourceRoot":"","sources":["../../src/acp/rewriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,wGAAwG;IACxG,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,aAAa,CAaf"}