@agent-loom/loom 1.0.2 → 1.0.3

package/dist/apply.js

@@ -1,59 +1,85 @@
 /**
- * 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 { join } from 'node:path';
-import { parseManifest, resolveManifest, parseAgentManifest, discoverNestedAgents, mergeTeamAndAgentManifests } from './manifest.js';
 import { renderCopilot } from './renderers/copilot.js';
 import { renderClaude } from './renderers/claude.js';
 import { resolveRegistrySkills } from './skill-fetcher.js';
-import { cloneManifestRepos } from './repo-clone.js';
+import { cloneManifestRepos, deriveRepoDir } from './repo-clone.js';
+import { parseManifest, resolveManifest } from './manifest.js';
+import { buildRepoNameMap, expandWorkspaceFolder } from './util/workspace-folder.js';
 /**
  * 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 async function applyTemplate(options) {
     const { templateDir, registryRoot, outputDir, target, skillFetcher, cloneRepos, cloneMode, execFn, promptFn, linkFn, agents: selectedAgents, onProgress } = options;
     const log = onProgress ?? (() => { });
+    // 1. Parse + 2. Resolve. parseManifest natively probes for
+    // manifest.yaml or dobby.yaml and normalizes flat-layout aliases.
     log('Parsing manifest...');
-    const manifestPath = join(templateDir, 'manifest.yaml');
-    const teamManifest = await parseManifest(manifestPath);
-    // Detect nested agents
-    const nestedAgentIds = await discoverNestedAgents(templateDir);
-    let manifest = teamManifest;
-    if (nestedAgentIds.length > 0) {
-        // Nested template — determine which agents to include
-        const agentIds = selectedAgents && selectedAgents.length > 0
-            ? selectedAgents.filter((id) => nestedAgentIds.includes(id))
-            : nestedAgentIds; // All agents if none specified
-        log(`Resolving ${agentIds.length} agent(s): ${agentIds.join(', ')}...`);
-        // Parse agent manifests
-        const agentManifests = [];
-        for (const agentId of agentIds) {
-            const agentManifestPath = join(templateDir, 'agents', agentId, 'manifest.yaml');
-            const am = await parseAgentManifest(agentManifestPath);
-            agentManifests.push(am);
-        }
-        // Merge team + agent manifests
-        manifest = mergeTeamAndAgentManifests(teamManifest, agentManifests, agentIds);
-    }
+    const manifest = await parseManifest(templateDir);
     log('Resolving references...');
-    const resolved = await resolveManifest(manifest, templateDir, registryRoot);
-    // Resolve registry skills to local if fetcher is provided
+    let resolved = await resolveManifest(manifest, templateDir, registryRoot, { agents: selectedAgents });
+    // 3. --agent filtering: when callers ask for a subset, drop the rest
+    // from the resolved list. resolveManifest already populates each
+    // ResolvedAgent.mcp from the agent file's frontmatter `mcp-servers:`
+    // block (loom#127 / U4.5), so no further per-agent MCP plumbing is
+    // needed here.
+    if (selectedAgents?.length) {
+        const wanted = new Set(selectedAgents);
+        resolved = {
+            ...resolved,
+            agents: resolved.agents.filter((a) => wanted.has(a.agentId)),
+        };
+    }
+    // 4. Fetch registry skills (when a fetcher is provided)
     if (skillFetcher && resolved.skills.length > 0) {
         log(`Fetching ${resolved.skills.length} skill(s)...`);
+        const skills = await resolveRegistrySkills(resolved.skills, skillFetcher);
+        resolved = { ...resolved, skills };
     }
-    const resolvedSkills = await resolveRegistrySkills(resolved.skills, skillFetcher);
-    const manifestWithLocalSkills = {
+    // 5. Expand ${workspaceFolder:X} in MCP args/cwd. Without this, repo-
+    // backed MCP servers (e.g. dotnet projects, scripts referenced from
+    // a checked-out path) would emit literal placeholder strings into
+    // .mcp.json / .vscode/mcp.json, which the MCP runtime cannot
+    // interpret. dirNameFor mirrors what cloneManifestRepos does:
+    // deriveRepoDir returns id when set, else the URL basename. Repos
+    // are cloned (or junctioned) into <workspace>/<dirName>, so the
+    // placeholder resolves to the same path regardless of how the repo
+    // was materialized.
+    const workDir = outputDir;
+    const repoNameMap = buildRepoNameMap(resolved.repos, (r) => deriveRepoDir(r.url ?? '', r.id));
+    const expandVar = (s) => expandWorkspaceFolder(s, repoNameMap, workDir);
+    const expandMcp = (m) => ({
+        ...m,
+        args: m.args?.map(expandVar),
+        cwd: m.cwd ? expandVar(m.cwd) : undefined,
+    });
+    // Expand placeholders in BOTH team-level (resolved.mcp) and
+    // per-agent (agent.mcp) MCPs -- the placeholder semantics are
+    // the same for either scope (loom#127).
+    resolved = {
         ...resolved,
-        skills: resolvedSkills,
+        mcp: resolved.mcp.map(expandMcp),
+        agents: resolved.agents.map((a) => a.mcp ? { ...a, mcp: a.mcp.map(expandMcp) } : a),
     };
-    // Render
+    const manifestWithLocalSkills = resolved;
+    // 6. Render
     log(`Rendering ${target} workspace files...`);
     switch (target) {
         case 'copilot':
@@ -63,7 +89,7 @@ export async function applyTemplate(options) {
             await renderClaude(manifestWithLocalSkills, outputDir);
             break;
         case 'cursor':
-            // Cursor renderer not yet implemented — fall back to copilot
+            // Cursor renderer not yet implemented -- fall back to copilot
             await renderCopilot(manifestWithLocalSkills, outputDir);
             break;
         default:
@@ -71,12 +97,12 @@ export async function applyTemplate(options) {
     }
     // Clone manifest repos if requested
     let repoCloneResult;
-    if (cloneRepos && resolved.repos.length > 0) {
-        log(`Cloning ${resolved.repos.length} repo(s)...`);
+    if (cloneRepos && manifestWithLocalSkills.repos.length > 0) {
+        log(`Cloning ${manifestWithLocalSkills.repos.length} repo(s)...`);
         // Apply --clone-mode partial: override repos without explicit cloneStrategy
         const repos = cloneMode === 'partial'
-            ? resolved.repos.map((r) => (!r.cloneStrategy && !r.sparse) ? { ...r, cloneStrategy: 'partial' } : r)
-            : resolved.repos;
+            ? manifestWithLocalSkills.repos.map((r) => (!r.cloneStrategy && !r.sparse) ? { ...r, cloneStrategy: 'partial' } : r)
+            : manifestWithLocalSkills.repos;
         repoCloneResult = await cloneManifestRepos({
             repos,
             workspaceDir: outputDir === '.' ? process.cwd() : outputDir,
@@ -86,17 +112,20 @@ export async function applyTemplate(options) {
             linkFn,
         });
     }
-    // Collect registry skills that were NOT fetched (still type='registry')
-    const registrySkills = resolvedSkills
-        .filter((s) => s.type === 'registry' && s.registry && s.ref)
+    // Skills with registry coordinates fall into two buckets:
+    //   - registrySkills: registry-rooted, content NOT fetched (caller must install)
+    //   - localizedSkills: registry-rooted, content fetched (rendered locally)
+    // A skill gets `content` only when a SkillFetcher resolved it, so
+    // presence of `content` is the discriminator.
+    const registrySkills = manifestWithLocalSkills.skills
+        .filter((s) => s.registry && s.ref && s.content === undefined)
         .map((s) => ({ registry: s.registry, ref: s.ref }));
-    // Collect skills that were fetched and localized
-    const localizedSkills = resolvedSkills
-        .filter((s) => s.type === 'local' && s.originalRegistry && s.originalRef)
-        .map((s) => ({ name: s.name, registry: s.originalRegistry, ref: s.originalRef }));
+    const localizedSkills = manifestWithLocalSkills.skills
+        .filter((s) => s.registry && s.ref && s.content !== undefined)
+        .map((s) => ({ name: s.name ?? s.ref, registry: s.registry, ref: s.ref }));
     return {
         target,
-        template: resolved.template.id,
+        template: manifestWithLocalSkills.template.id,
         filesGenerated: true,
         registrySkills,
         localizedSkills,

package/dist/apply.js.map

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

package/dist/chat/chat.d.ts

@@ -0,0 +1,108 @@
+/**
+ * `chat()` -- single-agent interactive session (powers verb-less `loom <agent>`).
+ *
+ * Composition note: shares the MCP-discovery + bin-resolution + spawn
+ * substrate with `src/run/run.ts` via the shared helpers in `src/copilot/`.
+ * The key difference from `run` is stdio: `chat` inherits the parent tty so
+ * the user talks to Copilot directly; `run` pipes stdio to capture output.
+ */
+import type { ResolvedAgentRef } from './resolve-agent.js';
+import type { AgentMetadata } from './frontmatter.js';
+import { type Session } from '../sessions/index.js';
+export type LaunchRuntimeKind = 'copilot' | 'claude';
+export interface ChatOptions {
+    /** Agent id to resolve. */
+    agentId: string;
+    /** Working directory (where to resolve the agent from and launch in). */
+    cwd: string;
+    /** One-shot prompt. If set with interactive=false, runs non-interactively. */
+    prompt?: string;
+    /**
+     * When true, runs non-interactively (suitable for `--prompt` one-shot or scripting).
+     * When false (default), starts interactive mode with stdio inherited.
+     */
+    interactive?: boolean;
+    /** Runtime to launch. Default 'copilot'. */
+    runtime?: LaunchRuntimeKind;
+    /** Extra args appended to the runtime command line. */
+    extraArgs?: string[];
+    /**
+     * Pre-resolved agent. If provided, skips resolution. Used for tests and
+     * for callers that want to resolve via a different strategy.
+     */
+    resolved?: ResolvedAgentRef;
+    /**
+     * Optional callback invoked once we have the agent + its metadata, but
+     * before spawning the runtime. Defaults to printing a banner to stderr.
+     * Pass `() => {}` to suppress.
+     */
+    onPreLaunch?: (info: PreLaunchInfo) => void;
+    /**
+     * When false, skip session-dir creation. Default true.
+     * Useful for tests and for scripted one-shots that don't want to litter
+     * `~/.loom/sessions/` with short-lived records.
+     */
+    recordSession?: boolean;
+    /** Optional friendly label written to session meta.yaml. */
+    sessionName?: string;
+    /** Origin hint written to the session meta. Default 'workspace'. */
+    sessionOrigin?: 'workspace' | 'staged';
+    /**
+     * Pre-existing session to use instead of creating one. When set, the
+     * session is still finalized on exit. Implies `recordSession` was handled
+     * by the caller (e.g., registry staging).
+     */
+    session?: Session;
+}
+export interface PreLaunchInfo {
+    agent: ResolvedAgentRef;
+    metadata: AgentMetadata;
+    runtime: LaunchRuntimeKind;
+    interactive: boolean;
+    cwd: string;
+    /** Session handle if a session was created; null when recordSession=false. */
+    session: Session | null;
+}
+export interface ChatResult {
+    /** Resolved agent reference used for this launch. */
+    agent: ResolvedAgentRef;
+    /** Exit code from the runtime process. */
+    exitCode: number | null;
+    /** Total duration in milliseconds. */
+    durationMs: number;
+    /** Session record, if one was created. */
+    session: Session | null;
+}
+/**
+ * Build the command line for a given runtime. Exported for testability.
+ */
+export declare function buildChatCommand(params: {
+    runtime: LaunchRuntimeKind;
+    prompt?: string;
+    interactive: boolean;
+    agent: ResolvedAgentRef;
+    /**
+     * The value to pass to copilot's `--agent` flag. Copilot identifies
+     * agents by their frontmatter `name:` (e.g. "Live Site"), not by the
+     * filename slug (e.g. "live-site"). Callers should pass
+     * `metadata.name ?? agent.agentId` so the spawn finds the agent.
+     */
+    agentDisplayName?: string;
+    mcpConfigPath?: string | null;
+    extraArgs?: string[];
+}): {
+    bin: string;
+    args: string[];
+};
+/**
+ * Default banner printer. Emits a 3-line summary to stderr before the
+ * runtime takes over the terminal. Kept minimal so it doesn't compete with
+ * Copilot CLI's own startup output.
+ */
+export declare function defaultPreChatBanner(info: PreLaunchInfo): void;
+/**
+ * Launch an agent interactively. Binds stdio to the parent tty so the
+ * user talks to Copilot directly. Returns when the runtime process exits.
+ */
+export declare function chat(options: ChatOptions): Promise<ChatResult>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/chat/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,aAAa,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,KAAK,EAAE,gBAAgB,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAwClC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CA6B9D;AAgCD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqGpE"}

package/dist/chat/chat.js

@@ -0,0 +1,221 @@
+/**
+ * `chat()` -- single-agent interactive session (powers verb-less `loom <agent>`).
+ *
+ * Composition note: shares the MCP-discovery + bin-resolution + spawn
+ * substrate with `src/run/run.ts` via the shared helpers in `src/copilot/`.
+ * The key difference from `run` is stdio: `chat` inherits the parent tty so
+ * the user talks to Copilot directly; `run` pipes stdio to capture output.
+ */
+import { homedir } from 'node:os';
+import chalk from 'chalk';
+import { resolveAgentInWorkspace } from './resolve-agent.js';
+import { parseAgentFrontmatter } from './frontmatter.js';
+import { resolveCopilotBin } from '../copilot/resolve.js';
+import { buildCopilotMcpConfigJson, materializeTempMcpConfig } from '../copilot/mcp.js';
+import { spawnInteractive } from '../copilot/spawn.js';
+import { createSession, finalizeSession, } from '../sessions/index.js';
+/**
+ * Build the command line for a given runtime. Exported for testability.
+ */
+export function buildChatCommand(params) {
+    const { runtime, prompt, interactive, agent, agentDisplayName, mcpConfigPath, extraArgs = [] } = params;
+    switch (runtime) {
+        case 'copilot': {
+            const bin = resolveCopilotBin();
+            const args = [];
+            if (prompt) {
+                // -p runs non-interactive and exits; -i <prompt> runs the kickoff
+                // then keeps the interactive session open. Interactive with no
+                // prompt: don't emit -i (it takes a required value and would
+                // swallow the next flag as the prompt).
+                args.push(interactive ? '-i' : '-p', prompt);
+            }
+            args.push('--allow-all-tools');
+            args.push('--add-dir', agent.workspaceDir);
+            // Activate the agent persona (otherwise Copilot just loads the file
+            // as a tool but talks back as plain Copilot, with no visible identity).
+            // --agent wants the frontmatter name (e.g. "Live Site"), not the
+            // filename slug (e.g. "live-site"); fall back to slug if metadata
+            // wasn't passed (the spawn will then surface copilot's own
+            // "No such agent" error).
+            args.push('--agent', agentDisplayName ?? agent.agentId);
+            if (mcpConfigPath) {
+                // Copilot expects JSON or a file path prefixed with '@'.
+                args.push('--additional-mcp-config', `@${mcpConfigPath}`);
+            }
+            args.push(...extraArgs);
+            return { bin, args };
+        }
+        case 'claude': {
+            const bin = 'claude';
+            const args = ['--dangerously-skip-permissions'];
+            if (prompt)
+                args.push('--prompt', prompt);
+            args.push(...extraArgs);
+            return { bin, args };
+        }
+        default:
+            throw new Error(`Unknown runtime: ${String(runtime)}`);
+    }
+}
+/**
+ * Default banner printer. Emits a 3-line summary to stderr before the
+ * runtime takes over the terminal. Kept minimal so it doesn't compete with
+ * Copilot CLI's own startup output.
+ */
+export function defaultPreChatBanner(info) {
+    const out = process.stderr;
+    const agentId = info.agent.agentId;
+    const displayName = info.metadata.name ?? agentId;
+    const mode = info.interactive ? 'interactive' : 'one-shot';
+    const runtimeLabel = `${info.runtime} \u00b7 ${mode}`;
+    // Top rule + agent badge
+    out.write('\n');
+    out.write(`  ${chalk.cyan.bold(agentId)}   ${chalk.dim(runtimeLabel)}\n`);
+    if (displayName !== agentId) {
+        out.write(`  ${chalk.dim(displayName)}\n`);
+    }
+    // Description (wrapped to ~80 cols)
+    if (info.metadata.description) {
+        out.write('\n');
+        for (const line of wrapText(info.metadata.description, 76)) {
+            out.write(`  ${line}\n`);
+        }
+    }
+    // Footer facts
+    out.write('\n');
+    out.write(`  ${chalk.dim('workspace')}  ${tildify(info.agent.workspaceDir)}\n`);
+    if (info.session) {
+        out.write(`  ${chalk.dim('session')}    ${info.session.meta.id}\n`);
+    }
+    out.write('\n');
+}
+function tildify(p) {
+    const home = homedir();
+    if (p === home)
+        return '~';
+    if (p.toLowerCase().startsWith(home.toLowerCase() + '\\')) {
+        return '~\\' + p.slice(home.length + 1);
+    }
+    if (p.toLowerCase().startsWith(home.toLowerCase() + '/')) {
+        return '~/' + p.slice(home.length + 1);
+    }
+    return p;
+}
+function wrapText(text, width) {
+    const words = text.replace(/\s+/g, ' ').trim().split(' ');
+    const lines = [];
+    let current = '';
+    for (const word of words) {
+        if (!current) {
+            current = word;
+        }
+        else if (current.length + 1 + word.length <= width) {
+            current += ' ' + word;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines;
+}
+/**
+ * Launch an agent interactively. Binds stdio to the parent tty so the
+ * user talks to Copilot directly. Returns when the runtime process exits.
+ */
+export async function chat(options) {
+    const startTime = Date.now();
+    const runtime = options.runtime ?? 'copilot';
+    const interactive = options.interactive ?? true;
+    const agent = options.resolved ?? resolveAgentInWorkspace({
+        agentId: options.agentId,
+        cwd: options.cwd,
+    });
+    if (!agent) {
+        throw new Error(`Agent "${options.agentId}" not found in workspace.\n` +
+            `  Looked for: ${options.cwd}/.github/agents/${options.agentId}.agent.md\n` +
+            `  (Installed-shortname and registry resolution layers are not yet implemented.)`);
+    }
+    const metadata = parseAgentFrontmatter(agent.agentFilePath);
+    // Record the session (unless opted out or supplied by caller) before we
+    // hand off to the runtime. We want this row to exist even if the spawn
+    // itself explodes, so `loom sessions list` can see failed launches too.
+    let session = options.session ?? null;
+    if (!session && options.recordSession !== false) {
+        session = createSession({
+            agentId: agent.agentId,
+            agentName: metadata.name,
+            runtime,
+            workspaceDir: agent.workspaceDir,
+            origin: options.sessionOrigin ?? 'workspace',
+            name: options.sessionName,
+        });
+    }
+    const preLaunch = options.onPreLaunch ?? defaultPreChatBanner;
+    preLaunch({ agent, metadata, runtime, interactive, cwd: options.cwd, session });
+    // Persist MCP config to a temp file so --additional-mcp-config can reference it.
+    // Returns null when the discovered config has zero usable servers; the temp
+    // dir is cleaned up in the finally block.
+    let tempMcp = null;
+    if (runtime === 'copilot') {
+        tempMcp = await materializeTempMcpConfig({
+            baseConfig: buildCopilotMcpConfigJson(agent.workspaceDir),
+            dirPrefix: 'loom-chat-',
+        });
+    }
+    try {
+        const { bin, args } = buildChatCommand({
+            runtime,
+            prompt: options.prompt,
+            interactive,
+            agent,
+            agentDisplayName: metadata.name ?? agent.agentId,
+            mcpConfigPath: tempMcp?.path ?? null,
+            extraArgs: options.extraArgs,
+        });
+        // Set the terminal tab title so the user can always see which agent
+        // they are in, even after Copilot's alt-screen TUI clears our banner.
+        // OSC 0 is supported by Windows Terminal, iTerm2, GNOME Terminal, etc.
+        // We can't read the previous title back, so on exit we restore to a
+        // neutral "loom" so it's obvious the agent has ended.
+        const titleTag = `loom: ${agent.agentId}`;
+        const setTitle = (s) => {
+            if (process.stderr.isTTY)
+                process.stderr.write(`\x1b]0;${s}\x07`);
+        };
+        setTitle(titleTag);
+        const restoreTitle = () => setTitle('loom');
+        let exitCode = null;
+        let errored = false;
+        try {
+            const result = await spawnInteractive({ bin, args, cwd: agent.workspaceDir });
+            exitCode = result.exitCode;
+        }
+        catch (err) {
+            errored = true;
+            restoreTitle();
+            if (session) {
+                finalizeSession(session, {
+                    exitCode: null,
+                    durationMs: Date.now() - startTime,
+                    status: 'errored',
+                });
+            }
+            throw err;
+        }
+        restoreTitle();
+        const durationMs = Date.now() - startTime;
+        if (session && !errored) {
+            session = finalizeSession(session, { exitCode, durationMs });
+        }
+        return { agent, exitCode, durationMs, session };
+    }
+    finally {
+        // Best-effort cleanup of the per-launch MCP-config temp dir.
+        tempMcp?.cleanup();
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat/chat.js.map

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

package/dist/chat/discovery.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Workspace + agent discovery for `loom <agent>` and `loom agents`.
+ *
+ * - `findWorkspaceRoot(cwd)`: walk up the directory tree looking for a
+ *   `.github/agents/` directory. Matches git's "find-root" ergonomics so
+ *   users don't have to be at the exact workspace root.
+ * - `listWorkspaceAgents(workspaceDir)`: enumerate `.agent.md` files under
+ *   `.github/agents/` with their parsed frontmatter metadata.
+ */
+import type { AgentMetadata } from './frontmatter.js';
+export interface WorkspaceAgentInfo {
+    /** Agent id (filename stem before `.agent.md`) */
+    agentId: string;
+    /** Absolute path to the agent file */
+    agentFilePath: string;
+    /** Frontmatter metadata */
+    metadata: AgentMetadata;
+}
+/**
+ * Walk up from `cwd` looking for a directory that contains `.github/agents/`.
+ * Returns the absolute path of that directory, or null if no such ancestor
+ * exists (including the filesystem root).
+ */
+export declare function findWorkspaceRoot(cwd: string): string | null;
+/**
+ * List all agents in a workspace's `.github/agents/` directory.
+ * Returns an empty array if the directory doesn't exist.
+ */
+export declare function listWorkspaceAgents(workspaceDir: string): WorkspaceAgentInfo[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/chat/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/chat/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAyB9E"}