@agent-loom/loom 1.0.1 → 1.0.3

package/dist/acp/client.js

@@ -0,0 +1,432 @@
+import { spawn } from 'node:child_process';
+import { Writable, Readable } from 'node:stream';
+import { readFile, writeFile } from 'node:fs/promises';
+import { ClientSideConnection, ndJsonStream, } from '@agentclientprotocol/sdk';
+/** Thrown when the child CLI exits or errors while a protocol call is in flight. */
+export class AcpConnectionClosedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AcpConnectionClosedError';
+    }
+}
+/** Thrown when a protocol call exceeds its `timeoutMs` budget. */
+export class AcpTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AcpTimeoutError';
+    }
+}
+// ============================================================================
+// ACP Client -- manages a single `<cli> --acp` child process over stdio
+// ============================================================================
+/**
+ * Drives an Agent Client Protocol (ACP) compatible CLI (e.g. `copilot --acp`)
+ * over stdio. Owns the child process, the JSON-RPC connection, and per-session
+ * state. One `AcpClient` instance = one child process; create multiple clients
+ * to run multiple CLIs in parallel.
+ *
+ * **Security posture (interim):** the client currently advertises
+ * `fs.readTextFile` / `fs.writeTextFile` capabilities unconditionally and
+ * auto-allows every `requestPermission`. This is safe for the trusted
+ * consumers shipping today (in-tree CLIs and the smoke script) but will not
+ * generalise. A pluggable `AcpClientOptions.policy` surface is being designed
+ * in serverless-paas-balam/loom#64 and will replace these defaults once the
+ * first external consumer lands.
+ *
+ * Typical flow:
+ *   const client = new AcpClient('copilot', { agentId: 'my-agent' });
+ *   await client.connect();
+ *   const session = await client.newSession('my-agent', cwd, mcpServers);
+ *   const unsubscribe = client.onSessionUpdate(session.sessionId, (u) => {
+ *       if (u.type === 'message') process.stdout.write(u.text);
+ *   });
+ *   await client.prompt(session.sessionId, 'Investigate X');
+ *   unsubscribe();
+ *   client.dispose();
+ */
+export class AcpClient {
+    process = null;
+    connection = null;
+    sessions = new Map();
+    /** Per-session subscribers for full session update events. */
+    updateSubscribers = new Map();
+    /**
+     * Tracks in-flight protocol calls (`connect`, `newSession`, `loadSession`,
+     * `prompt`) so we can reject them if the child process exits or errors
+     * before they complete. Without this, any caller awaiting the promise
+     * hangs forever on crash.
+     */
+    inFlight = new Set();
+    _isClosed = false;
+    cliBin;
+    opts;
+    /**
+     * @param cliBin Path or command name of the ACP-capable CLI (e.g. `copilot`).
+     * @param opts Constructor options. For back-compat a bare string in the
+     *   second position is treated as `additionalMcpConfigPath`.
+     */
+    constructor(cliBin, opts) {
+        this.cliBin = cliBin;
+        this.opts = typeof opts === 'string' ? { additionalMcpConfigPath: opts } : (opts ?? {});
+    }
+    get isClosed() {
+        return this._isClosed;
+    }
+    /**
+     * Spawn the CLI with `--acp`, wire up the ACP JSON-RPC stream, and complete
+     * protocol initialization. Must be called before any session operation.
+     * Throws if the client has already connected or been disposed -- one
+     * `AcpClient` instance owns exactly one child process for its lifetime.
+     */
+    async connect() {
+        if (this._isClosed) {
+            throw new AcpConnectionClosedError('AcpClient has been disposed; create a new instance');
+        }
+        if (this.process || this.connection) {
+            throw new Error('AcpClient.connect() already called; create a separate AcpClient instance per child process');
+        }
+        const args = ['--acp'];
+        if (this.opts.additionalMcpConfigPath) {
+            args.push('--additional-mcp-config', '@' + this.opts.additionalMcpConfigPath);
+        }
+        if (this.opts.agentId) {
+            args.push('--agent', this.opts.agentId);
+        }
+        this.process = spawn(this.cliBin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: process.env,
+        });
+        this.process.stderr?.on('data', (d) => {
+            if (process.env.LOOM_ACP_DEBUG) {
+                process.stderr.write('[acp] ' + d.toString());
+            }
+        });
+        this.process.on('exit', (code, signal) => {
+            this.handleProcessEnd('CLI exited before protocol call completed (code=' + code + ', signal=' + signal + ')');
+        });
+        this.process.on('error', (err) => {
+            this.handleProcessEnd('CLI process error: ' + err.message);
+        });
+        const output = Writable.toWeb(this.process.stdin);
+        const input = Readable.toWeb(this.process.stdout);
+        const stream = ndJsonStream(output, input);
+        this.connection = new ClientSideConnection((_agent) => this.createClient(), stream);
+        // Attach both fulfillment and rejection handlers synchronously in a
+        // single `.then(onF, onR)` call so Node doesn't emit
+        // PromiseRejectionHandledWarning when `closed` rejects before we've
+        // awaited anything (e.g. when the CLI binary is missing).
+        this.connection.closed.then(() => this.handleProcessEnd('ACP connection closed'), (err) => this.handleProcessEnd('ACP connection closed: ' + (err instanceof Error ? err.message : String(err))));
+        await this.withInFlight(this.connection.initialize({
+            protocolVersion: 1,
+            clientCapabilities: {
+                fs: {
+                    readTextFile: true,
+                    writeTextFile: true,
+                },
+            },
+        }), 'initialize');
+    }
+    /** Create a new session rooted at `cwd` with the given MCP servers. */
+    async newSession(agentId, cwd, mcpServers) {
+        if (!this.connection || this._isClosed)
+            throw new AcpConnectionClosedError('ACP connection not available');
+        const result = await this.withInFlight(this.connection.newSession({
+            cwd,
+            mcpServers: mcpServers.map(mapMcpServer),
+        }), 'newSession');
+        const session = {
+            sessionId: result.sessionId,
+            agentId,
+            response: '',
+            activity: 'Session created',
+            plan: [],
+            toolCalls: new Map(),
+            done: false,
+            stopReason: null,
+            startTime: Date.now(),
+        };
+        this.sessions.set(result.sessionId, session);
+        return session;
+    }
+    /**
+     * Resume an existing CLI session by ID. Requires `loadSession` capability.
+     * Throws on failure -- callers should fall back to `newSession()`.
+     */
+    async loadSession(sessionId, agentId, cwd, mcpServers) {
+        if (!this.connection || this._isClosed)
+            throw new AcpConnectionClosedError('ACP connection not available');
+        await this.withInFlight(this.connection.loadSession({
+            sessionId,
+            cwd,
+            mcpServers: mcpServers.map(mapMcpServer),
+        }), 'loadSession');
+        const session = {
+            sessionId,
+            agentId,
+            response: '',
+            activity: 'Session resumed',
+            plan: [],
+            toolCalls: new Map(),
+            done: false,
+            stopReason: null,
+            startTime: Date.now(),
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    /**
+     * Send a prompt to an existing session and block until the turn completes.
+     * Live deltas arrive via `onSessionUpdate` subscribers during the await.
+     * Rejects with `AcpConnectionClosedError` if the child exits mid-turn.
+     */
+    async prompt(sessionId, text) {
+        if (!this.connection || this._isClosed)
+            throw new AcpConnectionClosedError('ACP connection not available');
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error('Unknown session: ' + sessionId);
+        session.response = '';
+        session.activity = 'Thinking...';
+        session.done = false;
+        session.stopReason = null;
+        session.startTime = Date.now();
+        const result = await this.withInFlight(this.connection.prompt({
+            sessionId,
+            prompt: [{ type: 'text', text }],
+        }), 'prompt');
+        session.done = true;
+        session.stopReason = result.stopReason;
+        return session;
+    }
+    /** Cancel an in-flight prompt on the given session. Safe if already closed. */
+    async cancelSession(sessionId) {
+        if (!this.connection || this._isClosed)
+            return;
+        await this.connection.cancel({ sessionId });
+    }
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Subscribe to all session updates (message/thought chunks, tool calls,
+     * plans) for one session. Consumers filter by `event.type`.
+     */
+    onSessionUpdate(sessionId, cb) {
+        let subs = this.updateSubscribers.get(sessionId);
+        if (!subs) {
+            subs = new Set();
+            this.updateSubscribers.set(sessionId, subs);
+        }
+        subs.add(cb);
+        return () => {
+            const s = this.updateSubscribers.get(sessionId);
+            if (!s)
+                return;
+            s.delete(cb);
+            if (s.size === 0)
+                this.updateSubscribers.delete(sessionId);
+        };
+    }
+    /** Kill the child process and release all state. Idempotent. */
+    dispose() {
+        const proc = this.process;
+        this.process = null;
+        if (proc && proc.exitCode === null && proc.signalCode === null && !proc.killed) {
+            proc.kill();
+        }
+        this.handleProcessEnd('AcpClient disposed');
+        this.sessions.clear();
+        this.updateSubscribers.clear();
+    }
+    // ========================================================================
+    // Internals
+    // ========================================================================
+    /**
+     * Wrap a protocol promise so that if the child process ends before it
+     * settles, the returned promise rejects instead of hanging. When
+     * `opts.timeoutMs` is set, also rejects with `AcpTimeoutError` after the
+     * configured budget.
+     */
+    withInFlight(p, label) {
+        return new Promise((resolve, reject) => {
+            let timer;
+            let settled = false;
+            const cleanup = () => {
+                if (timer) {
+                    clearTimeout(timer);
+                    timer = undefined;
+                }
+                this.inFlight.delete(rejectOnEnd);
+            };
+            const settle = (fn, value) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                fn(value);
+            };
+            const settleErr = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(err);
+            };
+            const rejectOnEnd = (err) => settleErr(err);
+            this.inFlight.add(rejectOnEnd);
+            const timeoutMs = this.opts.timeoutMs;
+            if (timeoutMs && timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    settleErr(new AcpTimeoutError('ACP ' + (label ?? 'protocol call') + ' exceeded ' + timeoutMs + 'ms budget'));
+                }, timeoutMs);
+            }
+            p.then((v) => settle(resolve, v), (err) => settleErr(err));
+        });
+    }
+    /** Invoked on child exit, process error, or ACP stream close. Idempotent. */
+    handleProcessEnd(reason) {
+        this._isClosed = true;
+        this.connection = null;
+        // Null out process reference so a later dispose() doesn't kill an
+        // already-exited child (no-op, but keeps state honest).
+        this.process = null;
+        if (this.inFlight.size === 0)
+            return;
+        const err = new AcpConnectionClosedError(reason);
+        const pending = Array.from(this.inFlight);
+        this.inFlight.clear();
+        for (const reject of pending) {
+            try {
+                reject(err);
+            }
+            catch { /* swallow */ }
+        }
+    }
+    emit(sessionId, event) {
+        const subs = this.updateSubscribers.get(sessionId);
+        if (!subs)
+            return;
+        for (const cb of subs) {
+            try {
+                cb(event);
+            }
+            catch { /* subscriber errors must not break ACP loop */ }
+        }
+    }
+    // ========================================================================
+    // Client-side handler -- callbacks the agent invokes on us
+    // ========================================================================
+    createClient() {
+        const client = {
+            requestPermission: async (params) => {
+                // The schema types `options` as a broad union; narrow to the
+                // two fields we care about for selection logic.
+                const options = params.options;
+                if (options.length === 0) {
+                    // Protocol allows zero options; cancelling is the only valid
+                    // response since we have nothing to select.
+                    return { outcome: { outcome: 'cancelled' } };
+                }
+                const allowOption = options.find(o => o.kind === 'allow_once')
+                    || options[0];
+                return {
+                    outcome: {
+                        outcome: 'selected',
+                        optionId: allowOption.optionId,
+                    },
+                };
+            },
+            sessionUpdate: async (params) => {
+                const session = this.sessions.get(params.sessionId);
+                if (!session)
+                    return;
+                // Narrow the open-ended schema type to the variants we care
+                // about. Unknown variants are silently ignored (matches prior
+                // behaviour before the `satisfies Client` refactor).
+                const update = params.update;
+                switch (update.sessionUpdate) {
+                    case 'agent_message_chunk':
+                        if (update.content.type === 'text' && typeof update.content.text === 'string') {
+                            const text = update.content.text;
+                            session.response += text;
+                            if (text)
+                                this.emit(params.sessionId, { type: 'message', text });
+                        }
+                        break;
+                    case 'agent_thought_chunk':
+                        if (update.content.type === 'text' && typeof update.content.text === 'string') {
+                            const text = update.content.text;
+                            if (text.length > 5)
+                                session.activity = text.slice(0, 80);
+                            this.emit(params.sessionId, { type: 'thought', text });
+                        }
+                        break;
+                    case 'tool_call':
+                        session.activity = 'Calling ' + (update.title || 'tool') + '...';
+                        session.toolCalls.set(update.toolCallId, {
+                            title: update.title,
+                            status: update.status || 'pending',
+                        });
+                        this.emit(params.sessionId, {
+                            type: 'tool_call',
+                            toolCallId: update.toolCallId,
+                            title: update.title,
+                            status: update.status || 'pending',
+                        });
+                        break;
+                    case 'tool_call_update': {
+                        const tc = session.toolCalls.get(update.toolCallId);
+                        if (tc) {
+                            tc.status = update.status || tc.status;
+                            if (update.status === 'completed')
+                                session.activity = tc.title + ' done';
+                            else if (update.status === 'in_progress')
+                                session.activity = tc.title + '...';
+                        }
+                        this.emit(params.sessionId, {
+                            type: 'tool_update',
+                            toolCallId: update.toolCallId,
+                            status: update.status || tc?.status || 'unknown',
+                            title: tc?.title,
+                        });
+                        break;
+                    }
+                    case 'plan':
+                        session.plan = update.entries;
+                        const current = update.entries.find(e => e.status === 'in_progress');
+                        if (current)
+                            session.activity = current.content.slice(0, 80);
+                        this.emit(params.sessionId, { type: 'plan', entries: update.entries });
+                        break;
+                }
+            },
+            readTextFile: async (params) => {
+                const content = await readFile(params.path, 'utf-8');
+                return { content };
+            },
+            writeTextFile: async (params) => {
+                await writeFile(params.path, params.content, 'utf-8');
+                return {};
+            },
+        };
+        return client;
+    }
+}
+function mapMcpServer(s) {
+    if (s.type === 'http') {
+        if (!s.url || s.url.length === 0) {
+            throw new Error(`Invalid MCP server config "${s.name}": http servers require a non-empty url`);
+        }
+        return { type: 'http', name: s.name, url: s.url, headers: [] };
+    }
+    if (!s.command || s.command.length === 0) {
+        throw new Error(`Invalid MCP server config "${s.name}": stdio servers require a non-empty command`);
+    }
+    return {
+        name: s.name,
+        command: s.command,
+        args: s.args || [],
+        env: s.env || [],
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/acp/client.js.map

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

package/dist/acp/index.d.ts

@@ -0,0 +1,5 @@
+export { AcpClient, AcpConnectionClosedError, AcpTimeoutError } from './client.js';
+export type { SpecialistSession, AcpMcpServerConfig, SessionUpdateEvent, AcpClientOptions } from './client.js';
+export { runAgent } from './run.js';
+export type { RunAgentOptions, RunAgentResult } from './run.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/acp/index.js

@@ -0,0 +1,3 @@
+export { AcpClient, AcpConnectionClosedError, AcpTimeoutError } from './client.js';
+export { runAgent } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/acp/run.d.ts

@@ -0,0 +1,41 @@
+import { AcpMcpServerConfig, SessionUpdateEvent } from './client.js';
+export interface RunAgentOptions {
+    /** ACP-capable CLI binary (e.g. `'copilot'`). */
+    cliBin: string;
+    /** Agent id passed to the CLI via `--agent <id>` and tracked on the session. */
+    agentId: string;
+    /** Prompt text to send for the single turn. */
+    prompt: string;
+    /** Working directory for the session. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** MCP servers to expose to the session. Defaults to `[]`. */
+    mcpServers?: AcpMcpServerConfig[];
+    /** Optional MCP config file path passed via `--additional-mcp-config @<path>`. */
+    additionalMcpConfigPath?: string;
+    /**
+     * Optional subscriber for live session updates during the turn. Receives
+     * every event type; consumers filter by `event.type`.
+     */
+    onUpdate?: (event: SessionUpdateEvent) => void;
+    /**
+     * Per-protocol-call timeout in milliseconds. Forwarded to the underlying
+     * `AcpClient`. When any of `connect`, `newSession`, or `prompt` exceeds
+     * the budget the returned promise rejects with `AcpTimeoutError` and the
+     * child process is disposed. `undefined` or `0` disables the timeout.
+     */
+    timeoutMs?: number;
+}
+export interface RunAgentResult {
+    sessionId: string;
+    response: string;
+    stopReason: string | null;
+}
+/**
+ * One-shot helper: spawn the CLI, create a fresh session, send one prompt,
+ * collect the full response, and dispose. Always disposes the client --
+ * including on failure -- so the child process never leaks.
+ *
+ * For long-lived or multi-turn interactions use `AcpClient` directly.
+ */
+export declare function runAgent(options: RunAgentOptions): Promise<RunAgentResult>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/acp/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,kFAAkF;IAClF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyBhF"}

package/dist/acp/run.js

@@ -0,0 +1,32 @@
+import { AcpClient } from './client.js';
+/**
+ * One-shot helper: spawn the CLI, create a fresh session, send one prompt,
+ * collect the full response, and dispose. Always disposes the client --
+ * including on failure -- so the child process never leaks.
+ *
+ * For long-lived or multi-turn interactions use `AcpClient` directly.
+ */
+export async function runAgent(options) {
+    const client = new AcpClient(options.cliBin, {
+        agentId: options.agentId,
+        additionalMcpConfigPath: options.additionalMcpConfigPath,
+        timeoutMs: options.timeoutMs,
+    });
+    try {
+        await client.connect();
+        const session = await client.newSession(options.agentId, options.cwd ?? process.cwd(), options.mcpServers ?? []);
+        if (options.onUpdate) {
+            client.onSessionUpdate(session.sessionId, options.onUpdate);
+        }
+        const result = await client.prompt(session.sessionId, options.prompt);
+        return {
+            sessionId: result.sessionId,
+            response: result.response,
+            stopReason: result.stopReason,
+        };
+    }
+    finally {
+        client.dispose();
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/acp/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/acp/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0C,MAAM,aAAa,CAAC;AAmChF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACnD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CACnC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAC5B,OAAO,CAAC,UAAU,IAAI,EAAE,CAC3B,CAAC;QACF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtE,OAAO;YACH,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAChC,CAAC;IACN,CAAC;YAAS,CAAC;QACP,MAAM,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACL,CAAC"}

package/dist/apply.d.ts

@@ -1,5 +1,12 @@
 /**
- * Apply — resolves a template from a registry and renders it to a target workspace.
+ * Apply -- resolves a template from a registry and renders it to a target workspace.
+ *
+ * Per U6 the manifest pipeline is monolithic: parseManifest +
+ * resolveManifest + skillFetcher + workspace-folder expansion run
+ * inline here. The legacy ManifestAdapter dispatcher and dobby/loom
+ * adapters are gone -- parseManifest natively probes for both
+ * manifest.yaml and dobby.yaml and normalizes flat-layout dobby-style
+ * input into the canonical contents:-wrapped shape.
  */
 import { type SkillFetcher } from './skill-fetcher.js';
 import { type CloneRepoResult } from './repo-clone.js';
@@ -23,6 +30,8 @@ export interface ApplyOptions {
     linkFn?: (target: string, linkPath: string) => Promise<void>;
     /** Select specific agents (comma-separated IDs). If undefined, all agents used. */
     agents?: string[];
+    /** Progress callback for user-facing status messages */
+    onProgress?: (message: string) => void;
 }
 export interface ApplyResult {
     target: TargetType;
@@ -46,11 +55,13 @@ export interface ApplyResult {
  * Apply a template to a workspace directory.
  *
  * Steps:
- * 1. Parse manifest.yaml from templateDir
- * 2. Resolve all $ref / file references
- * 3. Fetch registry skills if a skillFetcher is provided
- * 4. Render output files using the appropriate renderer
- * 5. Return list of registry skills that need external install (if not fetched)
+ * 1. Parse the manifest from templateDir (probes manifest.yaml then dobby.yaml).
+ * 2. Resolve all $ref / file / discover references.
+ * 3. Filter agents (when --agent was passed).
+ * 4. Fetch registry skills if a skillFetcher is provided.
+ * 5. Expand ${workspaceFolder:X} placeholders in MCP args/cwd.
+ * 6. Render output files using the appropriate renderer.
+ * 7. Return list of registry skills that need external install (if not fetched).
  */
 export declare function applyTemplate(options: ApplyOptions): Promise<ApplyResult>;
 //# sourceMappingURL=apply.d.ts.map

package/dist/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAmC,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,4GAA4G;IAC5G,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sDAAsD;IACtD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,cAAc,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,kDAAkD;IAClD,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,+DAA+D;IAC/D,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2F/E"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAsB,KAAK,eAAe,EAAiB,MAAM,iBAAiB,CAAC;AAG1F,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,4GAA4G;IAC5G,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sDAAsD;IACtD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,cAAc,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,kDAAkD;IAClD,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,+DAA+D;IAC/D,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2H/E"}