@agent-loom/loom 1.0.2 → 1.0.3

package/dist/copilot/mcp.js

@@ -0,0 +1,146 @@
+/**
+ * MCP config discovery, composition, and materialization helpers.
+ * Shared across chat/ and run/ without duplicating logic.
+ */
+import { existsSync, readFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { env } from 'node:process';
+/**
+ * Discover an MCP configuration in the given workspace and translate it
+ * into the Copilot-CLI `mcpServers`-shaped JSON string (suitable for
+ * `--additional-mcp-config @<file>`). Returns null if no servers are
+ * usable. Also handles auth-bridge wiring for MCP servers that need a
+ * browser-acquired token in the spawn env.
+ */
+export function buildCopilotMcpConfigJson(cwd) {
+    return discoverMcpConfig(cwd);
+}
+function discoverMcpConfig(cwd) {
+    const candidates = [
+        join(cwd, '.mcp.json'),
+        join(cwd, '.vscode', 'mcp.json'),
+        join(cwd, 'mcp.json'),
+    ];
+    for (const candidate of candidates) {
+        if (!existsSync(candidate))
+            continue;
+        try {
+            const raw = readFileSync(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const servers = parsed.servers ?? parsed.mcpServers ?? {};
+            if (Object.keys(servers).length === 0)
+                continue;
+            const cliConfig = { mcpServers: {} };
+            for (const [name, config] of Object.entries(servers)) {
+                const entry = config;
+                const cliEntry = {};
+                // For MCP servers with browser auth, switch to token-from-cache mode
+                // so headless specialists can use them without launching browsers.
+                const entryEnv = entry.env ?? {};
+                if (entryEnv.HOWLER_AUTH_MODE === 'browser') {
+                    const cachePath = join(env.HOME ?? env.USERPROFILE ?? '', '.icm_mcp_cache', 'icm_token_cache.json');
+                    if (existsSync(cachePath)) {
+                        try {
+                            const cache = JSON.parse(readFileSync(cachePath, 'utf-8'));
+                            const token = cache?.public?.icm_token;
+                            if (token) {
+                                cliEntry.env = { ...entryEnv, HOWLER_AUTH_MODE: 'token', HOWLER_ICM_TOKEN: token };
+                            }
+                            else {
+                                continue;
+                            }
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                    else {
+                        continue;
+                    }
+                }
+                if (entry.type === 'stdio') {
+                    cliEntry.type = 'stdio';
+                    if (entry.command)
+                        cliEntry.command = entry.command;
+                    if (entry.args)
+                        cliEntry.args = entry.args;
+                    if (entry.env && !cliEntry.env)
+                        cliEntry.env = entry.env;
+                }
+                else if (entry.type === 'http' || entry.type === 'sse') {
+                    cliEntry.type = entry.type;
+                    if (entry.url)
+                        cliEntry.url = entry.url;
+                }
+                cliConfig.mcpServers[name] = cliEntry;
+            }
+            return JSON.stringify(cliConfig);
+        }
+        catch {
+            // skip
+        }
+    }
+    return null;
+}
+/**
+ * Compose a merged MCP config from base + extras - removes, then write it to targetPath.
+ * Returns true if anything was written (non-zero servers), false otherwise.
+ */
+export async function writeMcpConfig(targetPath, opts) {
+    const base = opts.baseConfig
+        ? JSON.parse(opts.baseConfig)
+        : { mcpServers: {} };
+    const merged = { ...base.mcpServers };
+    for (const name of opts.removeServers ?? []) {
+        delete merged[name];
+    }
+    for (const [name, cfg] of Object.entries(opts.extras ?? {})) {
+        merged[name] = cfg;
+    }
+    if (Object.keys(merged).length === 0)
+        return false;
+    await writeFile(targetPath, JSON.stringify({ mcpServers: merged }, null, 2), 'utf-8');
+    return true;
+}
+/**
+ * Create a temporary directory, write the merged MCP config to it, and return
+ * the path + a cleanup function. Returns null when the merged config has zero servers.
+ *
+ * On any failure during the write step (e.g. malformed `baseConfig` JSON),
+ * the temp directory is removed before re-throwing — otherwise we'd leak
+ * an empty `loom-XXXX/` under tmp every failed run.
+ */
+export async function materializeTempMcpConfig(opts) {
+    const dir = mkdtempSync(join(tmpdir(), opts.dirPrefix ?? 'loom-'));
+    const configPath = join(dir, 'mcp-cli.json');
+    let wrote;
+    try {
+        wrote = await writeMcpConfig(configPath, opts);
+    }
+    catch (err) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+    if (!wrote) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+    return {
+        path: configPath,
+        cleanup: () => {
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/copilot/mcp.js.map

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

package/dist/copilot/resolve.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copilot binary and agent resolution helpers.
+ * Shared across chat/ and run/ without duplicating logic.
+ */
+/**
+ * Resolve the path to the Copilot CLI binary.
+ *
+ * Lookup order:
+ *   1. ``COPILOT_CLI_PATH`` env var (escape hatch for any setup).
+ *   2. WinGet install location (Windows only, where most users land).
+ *   3. PATH lookup (``where.exe`` on Windows, ``command -v`` on POSIX).
+ *      On Windows, when ``where.exe`` returns an npm shim (``.cmd`` /
+ *      ``.ps1`` / extensionless), the function probes for the
+ *      platform-packaged ``copilot.exe`` next to the shim dir before
+ *      surrendering to a bare-name return. This matters because
+ *      ``spawnCaptured`` needs ``shell: true`` for non-``.exe`` bins,
+ *      and ``cmd.exe`` mangles quoted-arg values containing spaces
+ *      (e.g. ``--agent "Loom Dogfood"`` becomes ``--agent Loom Dogfood``,
+ *      yielding ``error: too many arguments``). Returning the absolute
+ *      ``.exe`` directly skips the shell entirely.
+ *   4. Bare ``'copilot'`` literal.
+ *
+ * The POSIX PATH branch (N3 from PR #67) matters because ``spawnCaptured``
+ * uses ``shell: false`` on POSIX -- without an absolute path, a missing
+ * ``copilot`` produces a bare ``ENOENT`` rather than a useful diagnostic.
+ */
+export declare function resolveCopilotBin(): string;
+/**
+ * Given a path to an .agent.md file, parse its frontmatter and return the
+ * agent's display name. Falls back to the filename slug if no `name:` is set.
+ */
+export declare function resolveAgentDisplayNameFromPath(agentFilePath: string): Promise<string>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/copilot/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/copilot/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6D1C;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5F"}

package/dist/copilot/resolve.js

@@ -0,0 +1,96 @@
+/**
+ * Copilot binary and agent resolution helpers.
+ * Shared across chat/ and run/ without duplicating logic.
+ */
+import { existsSync } from 'node:fs';
+import { join, basename, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { env } from 'node:process';
+import { platform } from 'node:os';
+import { parseAgentFrontmatter } from '../util/frontmatter.js';
+/**
+ * Resolve the path to the Copilot CLI binary.
+ *
+ * Lookup order:
+ *   1. ``COPILOT_CLI_PATH`` env var (escape hatch for any setup).
+ *   2. WinGet install location (Windows only, where most users land).
+ *   3. PATH lookup (``where.exe`` on Windows, ``command -v`` on POSIX).
+ *      On Windows, when ``where.exe`` returns an npm shim (``.cmd`` /
+ *      ``.ps1`` / extensionless), the function probes for the
+ *      platform-packaged ``copilot.exe`` next to the shim dir before
+ *      surrendering to a bare-name return. This matters because
+ *      ``spawnCaptured`` needs ``shell: true`` for non-``.exe`` bins,
+ *      and ``cmd.exe`` mangles quoted-arg values containing spaces
+ *      (e.g. ``--agent "Loom Dogfood"`` becomes ``--agent Loom Dogfood``,
+ *      yielding ``error: too many arguments``). Returning the absolute
+ *      ``.exe`` directly skips the shell entirely.
+ *   4. Bare ``'copilot'`` literal.
+ *
+ * The POSIX PATH branch (N3 from PR #67) matters because ``spawnCaptured``
+ * uses ``shell: false`` on POSIX -- without an absolute path, a missing
+ * ``copilot`` produces a bare ``ENOENT`` rather than a useful diagnostic.
+ */
+export function resolveCopilotBin() {
+    if (env.COPILOT_CLI_PATH)
+        return env.COPILOT_CLI_PATH;
+    const isWindows = platform() === 'win32';
+    if (isWindows) {
+        const wingetPath = join(env.LOCALAPPDATA ?? '', 'Microsoft', 'WinGet', 'Links', 'copilot.exe');
+        if (existsSync(wingetPath))
+            return wingetPath;
+    }
+    try {
+        if (isWindows) {
+            const candidates = execSync('where.exe copilot 2>nul', { encoding: 'utf-8' })
+                .split('\n')
+                .map((l) => l.trim())
+                .filter((l) => l.length > 0 && !l.includes('globalStorage'));
+            // Prefer an absolute .exe directly on PATH (e.g. WinGet link
+            // promoted earlier in the user's %PATH%).
+            const directExe = candidates.find((l) => l.toLowerCase().endsWith('.exe'));
+            if (directExe)
+                return directExe;
+            // npm-installed copilot lays out as:
+            //   <npm-prefix>\copilot         (extensionless POSIX-style shim)
+            //   <npm-prefix>\copilot.cmd     (Windows shim)
+            //   <npm-prefix>\copilot.ps1     (PowerShell shim)
+            //   <npm-prefix>\node_modules\@github\copilot\node_modules\@github\copilot-win32-x64\copilot.exe
+            // Probe for the platform package next to the shim dir. Returning
+            // the .exe means spawnCaptured can use shell: false, side-stepping
+            // cmd.exe arg mangling.
+            const exeUnderShim = (shim) => join(dirname(shim), 'node_modules', '@github', 'copilot', 'node_modules', '@github', 'copilot-win32-x64', 'copilot.exe');
+            for (const shim of candidates) {
+                const probed = exeUnderShim(shim);
+                if (existsSync(probed))
+                    return probed;
+            }
+            // Last resort on Windows: if `where.exe` returned at least one
+            // shim path, prefer its absolute form (still a shim, but at least
+            // not a bare name -- caller can handle it).
+            if (candidates.length > 0)
+                return candidates[0];
+        }
+        else {
+            // ``command -v`` is the POSIX-portable equivalent of ``which``;
+            // built into every shell, no external binary needed. ``execSync``
+            // already wraps the command string in ``/bin/sh -c``, so we can
+            // call the shell builtin directly.
+            const posixPath = execSync('command -v copilot 2>/dev/null', { encoding: 'utf-8' })
+                .trim();
+            if (posixPath)
+                return posixPath;
+        }
+    }
+    catch { /* not found */ }
+    return 'copilot';
+}
+/**
+ * Given a path to an .agent.md file, parse its frontmatter and return the
+ * agent's display name. Falls back to the filename slug if no `name:` is set.
+ */
+export async function resolveAgentDisplayNameFromPath(agentFilePath) {
+    const meta = parseAgentFrontmatter(agentFilePath);
+    const fallback = basename(agentFilePath).replace(/\.agent\.md$/i, '');
+    return meta.name ?? fallback;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/copilot/resolve.js.map

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

package/dist/copilot/spawn.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Spawn helpers for Copilot CLI processes.
+ * Two variants:
+ *   - spawnInteractive: stdio inherited (TTY pass-through), for interactive chat
+ *   - spawnCaptured: piped stdio with bounded buffer + timeout, for headless run
+ */
+import { spawn as nodeSpawn } from 'node:child_process';
+export interface SpawnInteractiveSpec {
+    bin: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface SpawnInteractiveResult {
+    exitCode: number;
+    durationMs: number;
+}
+/**
+ * Spawn a process with stdio: 'inherit' (TTY pass-through). Returns when the
+ * process exits. This function is intentionally dumb -- no banner, no session
+ * logic, no MCP wiring. All of that lives in the caller (chat.ts).
+ */
+export declare function spawnInteractive(spec: SpawnInteractiveSpec): Promise<SpawnInteractiveResult>;
+export interface SpawnCapturedSpec {
+    bin: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface SpawnCapturedOpts {
+    timeoutMs?: number;
+    /** Hard cap on bytes retained in memory per stream. Default 1MB. */
+    bufferCapBytes?: number;
+    /** Bytes of the captured buffer to include in stdoutTail/stderrTail. Defaults to bufferCapBytes. */
+    tailBytes?: number;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+    /** Inject spawn function (for tests). Defaults to node:child_process spawn. */
+    spawnFn?: typeof nodeSpawn;
+}
+export interface SpawnCapturedResult {
+    exitCode: number;
+    durationMs: number;
+    timedOut: boolean;
+    stdout: string;
+    stderr: string;
+    stdoutTail: string;
+    stderrTail: string;
+}
+export declare function spawnCaptured(spec: SpawnCapturedSpec, opts?: SpawnCapturedOpts): Promise<SpawnCapturedResult>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/copilot/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/copilot/spawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AA6BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAalG;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CA6E9B"}

package/dist/copilot/spawn.js

@@ -0,0 +1,132 @@
+/**
+ * Spawn helpers for Copilot CLI processes.
+ * Two variants:
+ *   - spawnInteractive: stdio inherited (TTY pass-through), for interactive chat
+ *   - spawnCaptured: piped stdio with bounded buffer + timeout, for headless run
+ */
+import { spawn as nodeSpawn } from 'node:child_process';
+import { platform } from 'node:os';
+/**
+ * Heuristic: do we need `shell: true` to spawn this binary on Windows?
+ *
+ * Node's `child_process.spawn` on Windows can resolve `.exe` files directly
+ * via CreateProcess, but `.cmd` / `.bat` shims (used by every npm-global
+ * package — `copilot.cmd`, `claude.cmd`, etc.) require a shell context.
+ * Enabling `shell: true` unconditionally works but it (a) drags `cmd.exe`
+ * into the call chain, which mangles arg quoting (breaks our tests that
+ * pass paths with spaces), and (b) changes exit-code propagation for
+ * children that exit non-zero.
+ *
+ * Compromise: turn `shell` on only when the bin is a bare name OR ends in
+ * `.cmd`/`.bat`. Absolute paths to `.exe` files (e.g. `process.execPath`)
+ * skip the shell entirely.
+ *
+ * POSIX always returns false — `.cmd` shims don't exist there.
+ */
+function needsShellOnWindows(bin) {
+    if (platform() !== 'win32')
+        return false;
+    const lower = bin.toLowerCase();
+    if (lower.endsWith('.exe'))
+        return false;
+    // Bare names ('copilot', 'claude') OR explicit shim extensions.
+    return !bin.includes('\\') && !bin.includes('/')
+        || lower.endsWith('.cmd')
+        || lower.endsWith('.bat');
+}
+/**
+ * Spawn a process with stdio: 'inherit' (TTY pass-through). Returns when the
+ * process exits. This function is intentionally dumb -- no banner, no session
+ * logic, no MCP wiring. All of that lives in the caller (chat.ts).
+ */
+export async function spawnInteractive(spec) {
+    const startTime = Date.now();
+    const child = nodeSpawn(spec.bin, spec.args, {
+        cwd: spec.cwd,
+        stdio: 'inherit',
+        shell: needsShellOnWindows(spec.bin),
+        ...(spec.env ? { env: { ...process.env, ...spec.env } } : {}),
+    });
+    const exitCode = await new Promise((resolveP, rejectP) => {
+        child.on('exit', (code) => resolveP(code));
+        child.on('error', (err) => rejectP(err));
+    });
+    return { exitCode: exitCode ?? 1, durationMs: Date.now() - startTime };
+}
+export function spawnCaptured(spec, opts = {}) {
+    return new Promise((resolveP) => {
+        const startTime = Date.now();
+        const cap = opts.bufferCapBytes ?? 1024 * 1024;
+        const spawnFn = opts.spawnFn ?? nodeSpawn;
+        // Bounded FIFO buffer: peak memory is at most ~2*cap (during a single
+        // chunk merge) before the slice trims back to `cap`. Prevents unbounded
+        // growth on agents that produce gigabytes of stdout.
+        const append = (current, chunk) => {
+            if (chunk.length >= cap)
+                return chunk.slice(-cap);
+            const overflow = current.length + chunk.length - cap;
+            if (overflow <= 0)
+                return current + chunk;
+            return current.slice(overflow) + chunk;
+        };
+        const child = spawnFn(spec.bin, spec.args, {
+            cwd: spec.cwd,
+            // shell:true is only needed on Windows to resolve `.cmd` shims
+            // (e.g. copilot.cmd on PATH). On posix it adds an extra `/bin/sh`
+            // layer that changes argv semantics and broadens the injection
+            // surface for caller-controlled values like options.model.
+            shell: platform() === 'win32',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            ...(spec.env ? { env: { ...process.env, ...spec.env } } : {}),
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let escalationTimer;
+        child.stdout?.on('data', (data) => {
+            const chunk = data.toString();
+            stdout = append(stdout, chunk);
+            opts.onStdout?.(chunk);
+        });
+        child.stderr?.on('data', (data) => {
+            const chunk = data.toString();
+            stderr = append(stderr, chunk);
+            opts.onStderr?.(chunk);
+        });
+        const timer = opts.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                // Belt and suspenders: if SIGTERM doesn't take, escalate after 5s.
+                escalationTimer = setTimeout(() => {
+                    if (child.exitCode === null)
+                        child.kill('SIGKILL');
+                }, 5000);
+                escalationTimer.unref();
+            }, opts.timeoutMs)
+            : undefined;
+        const finish = (code) => {
+            if (timer)
+                clearTimeout(timer);
+            if (escalationTimer)
+                clearTimeout(escalationTimer);
+            const durationMs = Date.now() - startTime;
+            const tail = opts.tailBytes ?? cap;
+            resolveP({
+                exitCode: code ?? 1,
+                durationMs,
+                timedOut,
+                stdout,
+                stderr,
+                stdoutTail: stdout.length > tail ? stdout.slice(-tail) : stdout,
+                stderrTail: stderr.length > tail ? stderr.slice(-tail) : stderr,
+            });
+        };
+        child.on('exit', (code) => finish(code));
+        child.on('error', (err) => {
+            stderr += `\n[loom-run] spawn error: ${err.message}`;
+            finish(1);
+        });
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/copilot/spawn.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Main library entry point for @agent-loom/loom.
+ *
+ * This is the public SDK surface. CLI entry is `src/cli.ts`.
+ *
+ * Subpath exports (see `package.json` exports map):
+ *   - `@agent-loom/loom`          (this file — chat + run + staging + types)
+ *   - `@agent-loom/loom/run`      (headless `run()` only)
+ *   - `@agent-loom/loom/launch`   (`stageRegistryAgent` for orchestrators)
+ *   - `@agent-loom/loom/acp`      (`AcpClient` for the planned peers MCP)
+ */
+export { chat, buildChatCommand, defaultPreChatBanner } from './chat/index.js';
+export type { ChatOptions, ChatResult, LaunchRuntimeKind, PreLaunchInfo, } from './chat/index.js';
+export { run, DEFAULT_RUN_TIMEOUT_MS } from './run/index.js';
+export type { RunOptions, RunResult } from './run/index.js';
+export { stageRegistryAgent } from './launch/index.js';
+export type { StagedLaunch, StageOptions } from './launch/index.js';
+export type { McpServerConfig } from './copilot/mcp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIpE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Main library entry point for @agent-loom/loom.
+ *
+ * This is the public SDK surface. CLI entry is `src/cli.ts`.
+ *
+ * Subpath exports (see `package.json` exports map):
+ *   - `@agent-loom/loom`          (this file — chat + run + staging + types)
+ *   - `@agent-loom/loom/run`      (headless `run()` only)
+ *   - `@agent-loom/loom/launch`   (`stageRegistryAgent` for orchestrators)
+ *   - `@agent-loom/loom/acp`      (`AcpClient` for the planned peers MCP)
+ */
+export { chat, buildChatCommand, defaultPreChatBanner } from './chat/index.js';
+export { run, DEFAULT_RUN_TIMEOUT_MS } from './run/index.js';
+export { stageRegistryAgent } from './launch/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAQ/E,OAAO,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/launch/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public exports for the launch module.
+ *
+ * `launch` is the layer between registry resolution and runtime spawn:
+ * it materializes a registry-resolved agent into a session workspace
+ * ready for `chat()`, `run()`, or a future `startSpecialist()`.
+ */
+export { stageRegistryAgent } from './stage.js';
+export type { StagedLaunch, StageOptions } from './stage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/launch/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/launch/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public exports for the launch module.
+ *
+ * `launch` is the layer between registry resolution and runtime spawn:
+ * it materializes a registry-resolved agent into a session workspace
+ * ready for `chat()`, `run()`, or a future `startSpecialist()`.
+ */
+export { stageRegistryAgent } from './stage.js';
+//# sourceMappingURL=index.js.map

package/dist/launch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/launch/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/launch/stage.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Staging — materialize a registry-resolved agent into a session workspace.
+ *
+ * The staging flow:
+ *   1. Generate a session id + compute the staged workspace path
+ *   2. Create the session record pointing at that workspace
+ *   3. Apply the registry template into `<session.dir>/workspace/`
+ *   4. Return a `ResolvedAgentRef` pointing at the staged agent file so the
+ *      launch machinery can spawn against it unchanged.
+ *
+ * Manifest repos are cloned in `'auto'` mode by default — real-work agents
+ * (CRI triage, pool investigations, ...) reference these repos at runtime
+ * and a session without them stalls immediately. Lightweight callers can
+ * pass `cloneRepos: 'none'` to skip.
+ *
+ * Located under `src/launch/` (not `src/chat/`) so library consumers like
+ * `loom run`, the planned `startSpecialist` (#76), and `loom-peers-mcp`
+ * (#77) can stage without pulling in chat-only modules.
+ */
+import { type Session, type SessionRuntime } from '../sessions/index.js';
+import type { ResolvedAgentRef } from '../chat/resolve-agent.js';
+import type { RegistryAgentHit } from '../chat/registry.js';
+export interface StagedLaunch {
+    /** The session record that owns the staged workspace. */
+    session: Session;
+    /** The staged agent ref — points inside `<session.dir>/workspace/`. */
+    agent: ResolvedAgentRef;
+}
+export interface StageOptions {
+    hit: RegistryAgentHit;
+    /** Friendly session label. */
+    sessionName?: string;
+    /**
+     * Runtime the staged session will be launched against. Controls both the
+     * `runtime:` field on the session record AND the renderer (`target`) used
+     * by `applyTemplate`. Defaults to `'copilot'` for back-compat with the
+     * pre-multi-runtime callers, but new callers should pass this through
+     * from the user's `--runtime` choice.
+     */
+    runtime?: SessionRuntime;
+    /** Progress callback forwarded to applyTemplate. */
+    onProgress?: (msg: string) => void;
+    /**
+     * Manifest repo clone behavior. Defaults to `'auto'` for staged launches
+     * because real-work agents reference repos at runtime
+     * and a workspace without them is dead-on-arrival. Pass `'none'` for
+     * lightweight / smoke-test agents.
+     */
+    cloneRepos?: 'auto' | 'all' | 'none';
+    /** Clone strategy override forwarded to applyTemplate. */
+    cloneMode?: 'full' | 'partial';
+    /** Interactive prompt for large/ADO repos (forwarded to applyTemplate). */
+    promptFn?: (message: string, choices: string[]) => Promise<string>;
+    /** Junction/symlink creator (forwarded to applyTemplate). */
+    linkFn?: (target: string, linkPath: string) => Promise<void>;
+}
+/**
+ * Stage a registry-resolved agent into a new session workspace, ready to launch.
+ * Throws if `applyTemplate` fails to produce the expected agent file.
+ */
+export declare function stageRegistryAgent(options: StageOptions): Promise<StagedLaunch>;
+//# sourceMappingURL=stage.d.ts.map

package/dist/launch/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/launch/stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,gBAAgB,CAAC;IACtB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,oDAAoD;IACpD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA4FrF"}