@agent-loom/loom 1.0.1 → 1.0.3

package/dist/repo-clone.js

@@ -13,7 +13,7 @@
  * Directory junctions are only created when a user provides an external path
  * for a large/ADO repo — not for repos cloned directly into the workspace.
  */
-import { stat, mkdir } from 'node:fs/promises';
+import { stat, lstat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { exec as execCb } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -123,7 +123,7 @@ export async function cloneManifestRepos(options) {
             // User provided an external path → validate and create junction
             if (await dirExists(answer)) {
                 const linkPath = await createRepoLink(answer, dirName, workspaceDir, linkFn);
-                result.cloned.push({ repo, path: answer, linkPath });
+                result.cloned.push({ repo, path: linkPath ?? answer, linkPath });
             }
             else {
                 result.deferred.push({ repo, reason: `User-provided path not found: ${answer}` });
@@ -199,19 +199,25 @@ async function dirExists(path) {
     }
 }
 /**
- * Create a directory junction/symlink at `repos/<dirName>` pointing to the target.
- * Returns the link path if created, or undefined if linkFn is not provided or link already exists.
+ * Create a directory junction/symlink at `<workspace>/<dirName>` pointing to the target.
+ * This matches the direct-clone path and `${workspaceFolder:<repo>}` expansion.
+ * Returns the link path if created, or undefined if linkFn is not provided.
  */
 async function createRepoLink(target, dirName, workspaceDir, linkFn) {
     if (!linkFn)
         return undefined;
-    const reposDir = join(workspaceDir, 'repos');
-    const linkPath = join(reposDir, dirName);
-    // Skip if link already exists
-    if (await dirExists(linkPath))
-        return linkPath;
-    // Ensure repos/ directory exists
-    await mkdir(reposDir, { recursive: true });
+    const linkPath = join(workspaceDir, dirName);
+    try {
+        const existing = await lstat(linkPath);
+        if (existing.isSymbolicLink())
+            return linkPath;
+        throw new Error(`Cannot link repo "${dirName}" to ${target}: ${linkPath} already exists. ` +
+            `Remove it or choose a workspace without that directory.`);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
     await linkFn(target, linkPath);
     return linkPath;
 }

package/dist/repo-clone.js.map

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

package/dist/resolve-template.d.ts

@@ -1,11 +1,17 @@
 /**
- * Resolve Template Source — auto-resolves a template argument to a local path.
+ * Resolve Template Source - auto-resolves a template argument to a local path.
  *
  * When `loom apply <template>` is called without --registry:
- * 1. Check if <template> is a local path containing manifest.yaml → use directly
+ * 1. Check if <template> is a local path containing manifest.yaml or
+ *    dobby.yaml -> use directly
  * 2. If not, search ~/.loom/config.yaml registries for a matching template
  * 3. Clone the matching registry and resolve the template path
+ *
+ * Per U6 the manifest probe is unified: any directory that contains
+ * either `manifest.yaml` (canonical) or `dobby.yaml` (legacy alias)
+ * is treated as a template.
  */
+import type { GitExecFn, LegacyExecFn } from './clone.js';
 import type { RegistryConfig } from './types.js';
 export interface ResolveResult {
     templateDir: string;
@@ -20,8 +26,10 @@ export interface ResolveOptions {
     loadConfigFn?: () => Promise<{
         registries: RegistryConfig[];
     }>;
-    /** Exec override for git clone (for testing) */
-    execFn?: (cmd: string) => void;
+    /** Git override for registry clone/refresh (for testing) */
+    gitFn?: GitExecFn;
+    /** @deprecated Use gitFn for argument-array based injection. */
+    execFn?: LegacyExecFn;
 }
 /**
  * Resolve a template argument to a local directory path.

package/dist/resolve-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-template.d.ts","sourceRoot":"","sources":["../src/resolve-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,UAAU,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/D,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAuDxB"}
+{"version":3,"file":"resolve-template.d.ts","sourceRoot":"","sources":["../src/resolve-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,UAAU,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/D,4DAA4D;IAC5D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAwExB"}

package/dist/resolve-template.js

@@ -1,10 +1,15 @@
 /**
- * Resolve Template Source — auto-resolves a template argument to a local path.
+ * Resolve Template Source - auto-resolves a template argument to a local path.
  *
  * When `loom apply <template>` is called without --registry:
- * 1. Check if <template> is a local path containing manifest.yaml → use directly
+ * 1. Check if <template> is a local path containing manifest.yaml or
+ *    dobby.yaml -> use directly
  * 2. If not, search ~/.loom/config.yaml registries for a matching template
  * 3. Clone the matching registry and resolve the template path
+ *
+ * Per U6 the manifest probe is unified: any directory that contains
+ * either `manifest.yaml` (canonical) or `dobby.yaml` (legacy alias)
+ * is treated as a template.
  */
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
@@ -16,21 +21,36 @@ import { cloneRegistry, resolveTemplatePath } from './clone.js';
  * Falls back to configured registries when the template is not a local path.
  */
 export async function resolveTemplateSource(template, workspaceDir, registryRootOverride, options) {
-    // 1. Check if template is a local path with manifest.yaml
-    if (await fileExists(join(template, 'manifest.yaml'))) {
+    // 1. Check if template is a local path with a recognized manifest
+    if (await hasManifest(template)) {
         return {
             templateDir: template,
             registryRoot: registryRootOverride ?? template.replace(/[/\\]templates[/\\].*$/, ''),
             fromRegistry: false,
         };
     }
-    // 2. Search configured registries
+    // 2. If --registry-root was supplied and template is a bare id,
+    // try resolving against that local registry tree before falling back
+    // to ~/.loom/config.yaml registries. Lets test harnesses point at a
+    // pre-cloned registry root without needing the full templates/<id>
+    // path on every invocation.
+    if (registryRootOverride) {
+        const candidate = resolveTemplatePath(registryRootOverride, template);
+        if (await hasManifest(candidate)) {
+            return {
+                templateDir: candidate,
+                registryRoot: registryRootOverride,
+                fromRegistry: false,
+            };
+        }
+    }
+    // 3. Search configured registries
     const config = options?.loadConfigFn
         ? await options.loadConfigFn()
         : await loadConfig();
     if (config.registries.length === 0) {
         throw new Error(`Template "${template}" is not a local path and no registries are configured.\n` +
-            `  Add a registry: loom registry add <name> <url>\n` +
+            `  Add a registry: loom config registry add <name> <url>\n` +
             `  Or provide a URL: loom apply ${template} --registry <url>`);
     }
     // Try to find and clone a registry that contains this template
@@ -40,10 +60,11 @@ export async function resolveTemplateSource(template, workspaceDir, registryRoot
                 workspaceDir,
                 url: reg.url,
                 name: reg.name,
+                gitFn: options?.gitFn,
                 execFn: options?.execFn,
             });
             const candidatePath = resolveTemplatePath(cloneResult.registryDir, template);
-            if (await fileExists(join(candidatePath, 'manifest.yaml'))) {
+            if (await hasManifest(candidatePath)) {
                 return {
                     templateDir: candidatePath,
                     registryRoot: cloneResult.registryDir,
@@ -53,7 +74,7 @@ export async function resolveTemplateSource(template, workspaceDir, registryRoot
             }
         }
         catch {
-            // Clone failed for this registry — try next
+            // Clone failed for this registry - try next
             continue;
         }
     }
@@ -63,6 +84,16 @@ export async function resolveTemplateSource(template, workspaceDir, registryRoot
         `  Check available templates: loom search ${template}\n` +
         `  Or provide a registry URL: loom apply ${template} --registry <url>`);
 }
+/**
+ * Probe whether a directory contains a recognized manifest filename.
+ * Returns true for either canonical (manifest.yaml) or legacy alias
+ * (dobby.yaml) -- the actual filename pick happens later in
+ * resolveManifestPath.
+ */
+async function hasManifest(dir) {
+    return ((await fileExists(join(dir, 'manifest.yaml'))) ||
+        (await fileExists(join(dir, 'dobby.yaml'))));
+}
 async function fileExists(path) {
     try {
         const s = await stat(path);

package/dist/resolve-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-template.js","sourceRoot":"","sources":["../src/resolve-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAmBhE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,YAAoB,EACpB,oBAA6B,EAC7B,OAAwB;IAExB,0DAA0D;IAC1D,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,WAAW,EAAE,QAAQ;YACrB,YAAY,EAAE,oBAAoB,IAAI,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;YACpF,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,MAAM,GAAG,OAAO,EAAE,YAAY;QAClC,CAAC,CAAC,MAAM,OAAO,CAAC,YAAY,EAAE;QAC9B,CAAC,CAAC,MAAM,UAAU,EAAE,CAAC;IAEvB,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,aAAa,QAAQ,2DAA2D;YAChF,oDAAoD;YACpD,kCAAkC,QAAQ,mBAAmB,CAC9D,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC;gBACtC,YAAY;gBACZ,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB,CAAC,CAAC;YAEH,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC7E,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO;oBACL,WAAW,EAAE,aAAa;oBAC1B,YAAY,EAAE,WAAW,CAAC,WAAW;oBACrC,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,WAAW,CAAC,aAAa;iBACzC,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,SAAS;QACX,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,KAAK,CACb,aAAa,QAAQ,sDAAsD,QAAQ,MAAM;QACzF,4CAA4C,QAAQ,IAAI;QACxD,2CAA2C,QAAQ,mBAAmB,CACvE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"resolve-template.js","sourceRoot":"","sources":["../src/resolve-template.ts"],"names":[],"mappings":"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"}

package/dist/run/index.d.ts

@@ -0,0 +1,4 @@
+export { run, DEFAULT_RUN_TIMEOUT_MS } from './run.js';
+export type { RunOptions, RunResult } from './run.js';
+export type { McpServerConfig } from '../copilot/mcp.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGtD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/run/index.js

@@ -0,0 +1,2 @@
+export { run, DEFAULT_RUN_TIMEOUT_MS } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC"}

package/dist/run/run.d.ts

@@ -0,0 +1,143 @@
+/**
+ * `loom run` — headless single-agent execution.
+ *
+ * Designed for orchestrators (scripts, CI, supervisor processes) that need to:
+ *   1. Apply a template + agent into a workspace
+ *   2. Run the agent non-interactively against a prompt
+ *   3. Collect artifacts (report / session / progress) and an exit code
+ *
+ * This is the headless counterpart to `loom <agent>` (interactive chat).
+ * Where chat inherits the parent tty and lets a human talk to Copilot,
+ * `run` captures stdout, honors a hard timeout, and returns structured results.
+ */
+import { spawn } from 'node:child_process';
+import { applyTemplate } from '../apply.js';
+import { resolveTemplateSource } from '../resolve-template.js';
+import { type McpServerConfig } from '../copilot/mcp.js';
+/**
+ * Default timeout for `run()` when callers don't supply one (5 minutes).
+ * Exported so `loom run` and SDK consumers stay in sync — programmatic
+ * callers can omit `timeoutMs` and still get a sane bound.
+ */
+export declare const DEFAULT_RUN_TIMEOUT_MS: number;
+export type RunLockWriteFn = (path: string, data: string, options: {
+    flag: 'wx';
+    encoding: 'utf-8';
+}) => void;
+export interface RunOptions {
+    /** Template ref (registry-resolved) or absolute path to a template directory. */
+    template: string;
+    /** Agent id within the template. */
+    agent: string;
+    /** Working directory. Created if missing. Becomes Copilot's cwd. */
+    workDir: string;
+    /** Prompt text (string) OR a leading-`@` followed by a file path. */
+    prompt: string;
+    /** Used for artifact filename conventions and `task-<taskId>.json` write. */
+    taskId?: string;
+    /** Verbatim contents written to `task-<taskId>.json` if both `taskId` and this are set. */
+    taskData?: string;
+    /** Map of `<dirname-in-workspace>` to absolute local repo path. Junctioned in. */
+    sharedRepos?: Record<string, string>;
+    /** MCP servers to merge in addition to whatever the template emits. */
+    mcpExtras?: Record<string, McpServerConfig>;
+    /** MCP server names to drop from the rendered config. */
+    mcpRemove?: string[];
+    /**
+     * Hard timeout in ms for the spawned agent process. When omitted, defaults
+     * to `DEFAULT_RUN_TIMEOUT_MS` (5 minutes). Pass `0` to disable (not
+     * recommended; orchestrators that want unlimited runtime should supervise
+     * the process themselves).
+     */
+    timeoutMs?: number;
+    /** Optional model override (forwarded to copilot --model). */
+    model?: string;
+    /** When true, rm the workspace on success. Default false (caller owns cleanup). */
+    cleanup?: boolean;
+    /** Inject spawn for tests. Default uses node:child_process spawn. */
+    spawnFn?: typeof spawn;
+    /** Inject applyTemplate for tests. */
+    applyFn?: typeof applyTemplate;
+    /** Inject template resolver for tests. */
+    resolveFn?: typeof resolveTemplateSource;
+    /**
+     * Inject the lock-file writer for tests. Lets a test force `EEXIST` on
+     * the first `wx` attempt and assert the one-shot EEXIST retry branch in
+     * `acquireRunLock` behaves correctly (reclaim-if-dead, fail-if-alive).
+     * Default uses `node:fs` `writeFileSync`.
+     */
+    writeFn?: RunLockWriteFn;
+    /** Cap on captured stdout returned in stdoutTail (default 16KB). */
+    stdoutTailBytes?: number;
+    /**
+     * Hard cap on bytes retained in memory per stream (stdout, stderr) during
+     * the spawn. Older bytes are discarded (FIFO). Default 1MB. The returned
+     * `stdoutTail` / `stderrTail` are then sliced from this. Prevents OOM when
+     * an agent prints gigabytes of stdout (a real failure mode for e.g. a
+     * runaway loop).
+     */
+    captureBytesCap?: number;
+    /**
+     * Initialize an empty `git` repo in `workDir` if one is not already present.
+     * Some agents assume their cwd is a git repo (for diffs, blame, hooks).
+     * Off by default to avoid a hard dep on the `git` binary and to keep
+     * `run()` side-effect-free when callers don't need it. Auto-enabled when
+     * `sharedRepos` are junctioned in.
+     */
+    initGit?: boolean;
+    /**
+     * Extra directories (relative to `workDir` or absolute) to search for a
+     * `REPORT-<taskId>.md` artifact, in addition to the default `workDir/REPORT-<taskId>.md`.
+     * First match wins.
+     */
+    reportSearchDirs?: string[];
+}
+export interface RunResult {
+    exitCode: number;
+    durationMs: number;
+    workspacePath: string;
+    /** True when the run hit timeoutMs. */
+    timedOut: boolean;
+    /** Contents of the agent's session share, if produced. */
+    session?: string;
+    /** Contents of `REPORT-<taskId>.md`, if found. */
+    report?: string;
+    /** Contents of `PROGRESS-<taskId>.md`, if found. */
+    progress?: string;
+    /** Where artifacts live on disk. */
+    artifactPaths: {
+        session?: string;
+        report?: string;
+        progress?: string;
+        mcpConfig?: string;
+        prompt?: string;
+    };
+    /** Last N bytes of captured stdout. Default 16KB. */
+    stdoutTail?: string;
+    /** Last N bytes of captured stderr. Default 16KB. */
+    stderrTail?: string;
+    /**
+     * Non-fatal advisory messages produced during the run (e.g. reclaimed
+     * stale lock). `run()` itself always populates this (possibly empty), but
+     * it remains optional so existing SDK consumers that construct `RunResult`
+     * test doubles do not need a breaking type update.
+     * Set `LOOM_RUN_DEBUG=1` to also mirror these to stderr at runtime.
+     */
+    warnings?: string[];
+}
+/**
+ * Run a single agent headlessly and return structured results.
+ *
+ * Steps: workspace prep -> shared-repo junctions -> applyTemplate ->
+ * mcp config merge -> task data + prompt -> spawn copilot (captured stdio)
+ * -> artifact collection -> optional cleanup.
+ *
+ * Per-`workDir` exclusivity is enforced by a cooperative lock file
+ * (`.loom-run.lock`). Concurrent invocations against the same `workDir`
+ * fail fast instead of racing on `prompt.txt` / `mcp-config.json` /
+ * `SESSION-*.md` writes. The lock is released in a `finally` so a crashed
+ * process doesn't strand the workspace; stale locks (PID no longer alive)
+ * are detected and reclaimed automatically.
+ */
+export declare function run(options: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

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

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