@agent-loom/loom 1.0.2 → 1.0.3

package/dist/run/run.js

@@ -0,0 +1,406 @@
+/**
+ * `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, execSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { mkdir, writeFile, readFile, readdir, rm } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { platform } from 'node:os';
+import { applyTemplate } from '../apply.js';
+import { resolveTemplateSource } from '../resolve-template.js';
+import { resolveCopilotBin, resolveAgentDisplayNameFromPath } from '../copilot/resolve.js';
+import { buildCopilotMcpConfigJson, writeMcpConfig } from '../copilot/mcp.js';
+import { spawnCaptured } from '../copilot/spawn.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 const DEFAULT_RUN_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * Filename of the cooperative lock dropped into `workDir` for the duration
+ * of a `run()` invocation. Contains the holder's PID + start time so callers
+ * can diagnose conflicts. Removed on success AND on failure.
+ */
+const RUN_LOCK_FILENAME = '.loom-run.lock';
+/**
+ * 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 async function run(options) {
+    const startTime = Date.now();
+    const workDir = resolve(options.workDir);
+    const stdoutCap = options.stdoutTailBytes ?? 16 * 1024;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_RUN_TIMEOUT_MS;
+    const warnings = [];
+    // 1. Workspace setup
+    await mkdir(workDir, { recursive: true });
+    // 1a. Acquire the per-workDir lock BEFORE we touch anything else, so two
+    // concurrent runs don't cross-contaminate `prompt.txt` / `mcp-config.json`
+    // / `SESSION-*.md`. Wrap the rest of the function in try/finally so the
+    // lock always releases.
+    acquireRunLock(workDir, warnings, options.writeFn);
+    try {
+        // `git init` is opt-in: forced via `initGit`, or auto-enabled when shared
+        // repos are present (some agents walk parent dirs for git context).
+        // Skipping by default keeps `run()` from hard-failing on machines without
+        // a `git` binary on PATH, and from leaving an empty .git/ behind.
+        const wantsGit = options.initGit === true ||
+            (options.initGit !== false && Object.keys(options.sharedRepos ?? {}).length > 0);
+        if (wantsGit && !existsSync(join(workDir, '.git'))) {
+            execSync('git init', { cwd: workDir, stdio: 'pipe' });
+        }
+        // 2. Shared repos (junctioned in before apply, so --clone-repos auto skips them)
+        for (const [name, target] of Object.entries(options.sharedRepos ?? {})) {
+            await junctionShared(target, join(workDir, name));
+        }
+        // 3. Apply template (resolves registry if `template` is a name)
+        const resolveFn = options.resolveFn ?? resolveTemplateSource;
+        const applyFn = options.applyFn ?? applyTemplate;
+        const resolved = await resolveFn(options.template, workDir, undefined);
+        await applyFn({
+            templateDir: resolved.templateDir,
+            registryRoot: resolved.registryRoot,
+            outputDir: workDir,
+            target: 'copilot',
+            cloneRepos: 'auto',
+            agents: [options.agent],
+            linkFn: junctionShared,
+        });
+        // 3a. Resolve copilot's --agent value from the rendered agent file's
+        // frontmatter `name:`. Copilot CLI identifies agents by their declared
+        // display name, NOT by the manifest agent id we passed to applyTemplate.
+        // Without this lookup copilot fails with "No such agent: <id>".
+        const agentDisplayName = await resolveAgentDisplayName(workDir, options.agent);
+        // 4. MCP config: render base + merge extras + remove
+        const mcpConfigPath = await composeMcpConfig(workDir, options.mcpExtras, options.mcpRemove);
+        // 5. Task data file
+        if (options.taskId && options.taskData) {
+            await writeFile(join(workDir, `task-${options.taskId}.json`), options.taskData, 'utf-8');
+        }
+        // 6. Prompt: write to a file so we can pass `-p @<path>` (avoids quoting hell).
+        const promptPath = join(workDir, 'prompt.txt');
+        const promptText = options.prompt.startsWith('@')
+            ? await readFile(options.prompt.slice(1), 'utf-8')
+            : options.prompt;
+        await writeFile(promptPath, promptText, 'utf-8');
+        // 7. Spawn copilot with captured stdio + hard timeout
+        const sessionPath = options.taskId
+            ? join(workDir, `SESSION-${options.taskId}.md`)
+            : join(workDir, 'SESSION.md');
+        const args = [
+            '-p', `@${promptPath}`,
+            // --allow-all is the umbrella flag: --allow-all-tools + --allow-all-paths
+            // + --allow-all-urls. Without --allow-all-paths, copilot denies file reads
+            // in subdirectories (e.g. shared-repo junctions) and, with --no-ask-user,
+            // cannot prompt — so the agent silently fails. This is the standard
+            // setting for headless orchestrated runs.
+            '--allow-all',
+            '--no-ask-user',
+            '--add-dir', workDir,
+            '--agent', agentDisplayName,
+            '--share', sessionPath,
+        ];
+        if (mcpConfigPath)
+            args.push('--additional-mcp-config', `@${mcpConfigPath}`);
+        if (options.model)
+            args.push('--model', options.model);
+        const spawnImpl = options.spawnFn ?? spawn;
+        const bin = resolveCopilotBin();
+        const { exitCode, stdout, timedOut, stdoutTail, stderrTail } = await spawnCaptured({ bin, args, cwd: workDir }, {
+            timeoutMs: timeoutMs > 0 ? timeoutMs : undefined,
+            bufferCapBytes: options.captureBytesCap,
+            tailBytes: stdoutCap,
+            spawnFn: spawnImpl,
+        });
+        // 8. Artifact collection
+        const artifacts = await collectArtifacts(workDir, options.taskId, sessionPath, stdout, options.reportSearchDirs);
+        const result = {
+            exitCode,
+            durationMs: Date.now() - startTime,
+            workspacePath: workDir,
+            timedOut,
+            session: artifacts.session,
+            report: artifacts.report,
+            progress: artifacts.progress,
+            artifactPaths: {
+                session: existsSync(sessionPath) ? sessionPath : undefined,
+                report: artifacts.reportPath,
+                progress: artifacts.progressPath,
+                mcpConfig: mcpConfigPath ?? undefined,
+                prompt: promptPath,
+            },
+            stdoutTail,
+            stderrTail,
+            warnings,
+        };
+        // 9. Cleanup (only on success — failures are kept for inspection)
+        if (options.cleanup && exitCode === 0 && !timedOut) {
+            // Release the lock BEFORE rm()ing the workdir so we don't wipe a file
+            // we still hold. (rm-recursive would delete it anyway, but explicit
+            // release keeps the contract clean.)
+            releaseRunLock(workDir);
+            await rm(workDir, { recursive: true, force: true });
+            return result;
+        }
+        return result;
+    }
+    finally {
+        // Idempotent — safe to call even if cleanup already removed the lock.
+        releaseRunLock(workDir);
+    }
+}
+/**
+ * Maximum age of a lock file (in ms) before we consider it stale even if
+ * the holder PID still appears alive. Defends against PID reuse on
+ * long-uptime hosts (N2): a fresh, unrelated process happening to land on
+ * the same pid would otherwise block us indefinitely.
+ *
+ * Tuned generously — 24h is well above the longest plausible legitimate
+ * `run()` (the in-product `timeoutMs` defaults to 5 minutes; even the most
+ * patient orchestrator caps out long before a day).
+ */
+const LOCK_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+/**
+ * Read and parse the lock holder JSON. Returns `raw: ''` when the file is
+ * missing (ENOENT); returns a partially-populated holder when the file is
+ * corrupt (callers treat missing `pid` as "stale" and reclaim). Other I/O
+ * errors (EACCES, EBUSY, etc.) are rethrown so callers fail loudly rather
+ * than mistakenly treating an unreadable lock as absent.
+ */
+function readHolder(lockPath) {
+    let raw = '';
+    try {
+        raw = readFileSync(lockPath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { raw: '' };
+        }
+        throw err;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return {
+            raw,
+            pid: typeof parsed.pid === 'number' ? parsed.pid : undefined,
+            startedAt: typeof parsed.startedAt === 'string' ? parsed.startedAt : undefined,
+        };
+    }
+    catch {
+        return { raw };
+    }
+}
+/**
+ * Acquire the per-workDir cooperative lock. Throws a descriptive error
+ * (including the holder's PID) if another live `run()` already holds it.
+ * Detects and reclaims stale locks left by crashed processes; also
+ * reclaims locks older than `LOCK_MAX_AGE_MS` even when the PID looks
+ * alive (PID-reuse defense, N2).
+ *
+ * Non-fatal advisories (e.g. "reclaimed stale lock") are pushed to the
+ * shared `warnings` array. SDK consumers see them via `RunResult.warnings`;
+ * if `LOOM_RUN_DEBUG` is truthy they're also mirrored to stderr.
+ *
+ * `writeFn` is an optional injection point for tests to drive the EEXIST
+ * retry branch deterministically.
+ */
+function acquireRunLock(workDir, warnings, writeFn = writeFileSync) {
+    const lockPath = join(workDir, RUN_LOCK_FILENAME);
+    // Use writeFileSync with `wx` to atomically create-and-fail-if-exists.
+    const tryWrite = () => {
+        try {
+            writeFn(lockPath, JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() }), { flag: 'wx', encoding: 'utf-8' });
+            return true;
+        }
+        catch (err) {
+            if (err.code === 'EEXIST')
+                return false;
+            throw err;
+        }
+    };
+    if (tryWrite())
+        return;
+    // EEXIST on first attempt. Reconcile the observed holder once, then retry
+    // atomically. If the file vanished before we could read it, do not remove
+    // anything; just retry and let `wx` decide whether the lock is still free.
+    const holder = readHolder(lockPath);
+    if (holder.raw === '') {
+        if (tryWrite())
+            return;
+        throwConcurrentLockError(workDir, lockPath);
+    }
+    const pidAlive = holder.pid !== undefined && isProcessAlive(holder.pid);
+    const lockAgeMs = holder.startedAt ? Date.now() - Date.parse(holder.startedAt) : Infinity;
+    const lockAgedOut = !Number.isFinite(lockAgeMs) || lockAgeMs > LOCK_MAX_AGE_MS;
+    if (pidAlive && !lockAgedOut) {
+        throw new Error(`loom run: another run is already in progress for ${workDir} ` +
+            `(holder PID ${holder.pid}). Wait for it to finish or remove ` +
+            `${RUN_LOCK_FILENAME} manually if you're certain it's stale.`);
+    }
+    try {
+        rmSync(lockPath, { force: true });
+    }
+    catch { /* ignore */ }
+    const reason = pidAlive
+        ? `lock older than ${Math.round(LOCK_MAX_AGE_MS / 3_600_000)}h, treating PID as reused`
+        : 'holder PID no longer alive';
+    emitWarning(warnings, `loom run: reclaiming stale lock at ${lockPath} (${reason}; previous holder: ${holder.raw.trim()})`);
+    if (tryWrite())
+        return;
+    throwConcurrentLockError(workDir, lockPath);
+}
+function throwConcurrentLockError(workDir, lockPath) {
+    const holder = readHolder(lockPath);
+    const holderDetails = holder.pid !== undefined ? ` (holder PID ${holder.pid})` : '';
+    throw new Error(`loom run: another run grabbed the lock for ${workDir} concurrently${holderDetails}. ` +
+        `Retry once it finishes.`);
+}
+/**
+ * Push an advisory onto the warnings buffer. Mirror to stderr only when
+ * `LOOM_RUN_DEBUG` is set so SDK consumers don't get unsolicited stderr
+ * from the library.
+ */
+function emitWarning(warnings, message) {
+    warnings.push(message);
+    if (process.env.LOOM_RUN_DEBUG) {
+        console.error(message);
+    }
+}
+/** Idempotent — best-effort removal of the per-workDir lock. */
+function releaseRunLock(workDir) {
+    const lockPath = join(workDir, RUN_LOCK_FILENAME);
+    try {
+        rmSync(lockPath, { force: true });
+    }
+    catch { /* ignore */ }
+}
+/**
+ * `process.kill(pid, 0)` is the canonical liveness probe — it sends no
+ * signal but throws ESRCH when the process is gone. We additionally treat
+ * EPERM as "alive" (we can see it but lack permission to signal it).
+ */
+function isProcessAlive(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+async function junctionShared(target, linkPath) {
+    if (existsSync(linkPath))
+        return;
+    if (!existsSync(target))
+        return;
+    if (platform() === 'win32') {
+        execSync(`cmd /c mklink /J "${linkPath}" "${target}"`, { stdio: 'pipe' });
+    }
+    else {
+        const { symlink } = await import('node:fs/promises');
+        await symlink(target, linkPath, 'junction');
+    }
+}
+/**
+ * Resolve the value to pass to copilot's `--agent` flag.
+ *
+ * Copilot CLI identifies agents by the frontmatter `name:` field, not by
+ * the manifest agent id we passed to applyTemplate. After applyTemplate
+ * runs, exactly one .agent.md file should exist under .github/agents/
+ * (because we filter via `agents: [options.agent]`). Read its frontmatter
+ * `name:` and return that.
+ *
+ * Fall back to the manifest id if anything goes wrong -- the spawn will
+ * fail with copilot's own "No such agent" error, now visible via the
+ * stderr capture added in this PR.
+ */
+async function resolveAgentDisplayName(workDir, agentId) {
+    const agentsDir = join(workDir, '.github', 'agents');
+    if (!existsSync(agentsDir))
+        return agentId;
+    const entries = await readdir(agentsDir);
+    const agentFiles = entries.filter((e) => e.endsWith('.agent.md'));
+    if (agentFiles.length === 0)
+        return agentId;
+    // Prefer a file whose slug matches the agent id; otherwise take the first.
+    const slug = agentId.toLowerCase();
+    const preferred = agentFiles.find((f) => f.toLowerCase().startsWith(`${slug}.`)) ??
+        agentFiles.find((f) => f.toLowerCase().includes(slug)) ??
+        agentFiles[0];
+    // Reuse the shared copilot/resolve helper to read frontmatter and pick a
+    // display name. (Keeping the file-discovery logic local since it depends
+    // on workDir layout produced by applyTemplate.)
+    return resolveAgentDisplayNameFromPath(join(agentsDir, preferred));
+}
+async function composeMcpConfig(workDir, extras, remove) {
+    const baseJson = buildCopilotMcpConfigJson(workDir);
+    const path = join(workDir, 'mcp-config.json');
+    const wrote = await writeMcpConfig(path, {
+        baseConfig: baseJson,
+        extras,
+        removeServers: remove,
+    });
+    return wrote ? path : null;
+}
+async function collectArtifacts(workDir, taskId, sessionSharePath, stdoutFallback, extraReportDirs) {
+    const result = {};
+    // Session: prefer --share file, fall back to stdout.
+    try {
+        result.session = await readFile(sessionSharePath, 'utf-8');
+    }
+    catch {
+        result.session = stdoutFallback || undefined;
+    }
+    if (!taskId)
+        return result;
+    // Report: default location is `workDir/REPORT-<taskId>.md`. Callers may
+    // pass extra search dirs (`reportSearchDirs`) to honor their own naming
+    // conventions; the first match wins.
+    const reportCandidates = [
+        join(workDir, `REPORT-${taskId}.md`),
+        ...(extraReportDirs ?? []).map((dir) => join(resolve(workDir, dir), `REPORT-${taskId}.md`)),
+    ];
+    for (const candidate of reportCandidates) {
+        try {
+            result.report = await readFile(candidate, 'utf-8');
+            result.reportPath = candidate;
+            break;
+        }
+        catch {
+            // try next
+        }
+    }
+    // Progress
+    const progressPath = join(workDir, `PROGRESS-${taskId}.md`);
+    try {
+        result.progress = await readFile(progressPath, 'utf-8');
+        result.progressPath = progressPath;
+    }
+    catch {
+        // not produced
+    }
+    return result;
+}
+//# sourceMappingURL=run.js.map

package/dist/run/run.js.map

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

package/dist/search-registry.d.ts

@@ -3,10 +3,11 @@
  *
  * Workflow:
  * 1. Read ~/.loom/config.yaml for registered registries
- * 2. Check .loom/registries/<name>/index.yaml for cached clones
+ * 2. Refresh safe cached clones under .loom/registries/<name>/
  * 3. If not cached, auto-clone (shallow) and cache
  * 4. Return paths for search
  */
+import { type CloneOptions, type GitExecFn, type LegacyExecFn } from './clone.js';
 export interface RegistryResolutionOptions {
     /** Search a specific registry by name (from config.yaml). If omitted, resolves all registries. */
     registryName?: string;
@@ -14,8 +15,14 @@ export interface RegistryResolutionOptions {
     workspaceDir?: string;
     /** Override config directory (for testing — defaults to ~/.loom) */
     configDir?: string;
-    /** Inject exec function for testing (used for auto-clone) */
-    execFn?: (cmd: string) => void;
+    /** Inject git function for testing (used for auto-clone/refresh) */
+    gitFn?: GitExecFn;
+    /** @deprecated Use gitFn for argument-array based injection. */
+    execFn?: LegacyExecFn;
+    /** Inject function to list available gh accounts (for testing clone retry behavior) */
+    listGhAccountsFn?: CloneOptions['listGhAccountsFn'];
+    /** Inject function to switch gh account (for testing clone retry behavior) */
+    switchGhAccountFn?: CloneOptions['switchGhAccountFn'];
     /** Also check workspace root for index.yaml (workspace is itself a registry) */
     includeWorkspaceRoot?: boolean;
 }

package/dist/search-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-registry.d.ts","sourceRoot":"","sources":["../src/search-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAMD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAiChD"}
+{"version":3,"file":"search-registry.d.ts","sourceRoot":"","sources":["../src/search-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAOjG,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACpD,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACtD,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAMD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA2ChD"}

package/dist/search-registry.js

@@ -3,15 +3,15 @@
  *
  * Workflow:
  * 1. Read ~/.loom/config.yaml for registered registries
- * 2. Check .loom/registries/<name>/index.yaml for cached clones
+ * 2. Refresh safe cached clones under .loom/registries/<name>/
  * 3. If not cached, auto-clone (shallow) and cache
  * 4. Return paths for search
  */
-import { readFile, stat, mkdir } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
-import { execSync } from 'node:child_process';
 import yaml from 'js-yaml';
+import { cloneRegistry } from './clone.js';
 // =============================================================================
 // Public API
 // =============================================================================
@@ -21,7 +21,7 @@ import yaml from 'js-yaml';
  * Returns an array of { name, path } suitable for passing to searchTemplates().
  */
 export async function resolveRegistryIndexPaths(options) {
-    const { registryName, workspaceDir = process.cwd(), configDir = join(homedir(), '.loom'), execFn, includeWorkspaceRoot, } = options;
+    const { registryName, workspaceDir = process.cwd(), configDir = join(homedir(), '.loom'), gitFn, execFn, listGhAccountsFn, switchGhAccountFn, includeWorkspaceRoot, } = options;
     const results = [];
     // Load config
     const config = await loadConfigFrom(configDir);
@@ -29,7 +29,7 @@ export async function resolveRegistryIndexPaths(options) {
         ? config.registries.filter((r) => r.name === registryName)
         : config.registries;
     for (const reg of registries) {
-        const indexPath = await resolveOneRegistry(reg, workspaceDir, execFn);
+        const indexPath = await resolveOneRegistry(reg, workspaceDir, gitFn, execFn, listGhAccountsFn, switchGhAccountFn);
         if (indexPath) {
             results.push({ name: reg.name, path: indexPath });
         }
@@ -50,19 +50,19 @@ export async function resolveRegistryIndexPaths(options) {
  * Try to resolve a single registry to a local index.yaml path.
  * Returns the path if found/cloned, or undefined if unavailable.
  */
-async function resolveOneRegistry(reg, workspaceDir, execFn) {
-    // Check cached clone in .loom/registries/<name>/
-    const cachedDir = join(workspaceDir, '.loom', 'registries', reg.name);
-    const cachedIndex = join(cachedDir, 'index.yaml');
-    if (await fileExists(cachedIndex)) {
-        return cachedIndex;
-    }
-    // Not cached — try to auto-clone
-    const exec = execFn ?? ((cmd) => { execSync(cmd, { stdio: 'pipe' }); });
+async function resolveOneRegistry(reg, workspaceDir, gitFn, execFn, listGhAccountsFn, switchGhAccountFn) {
     if (reg.url) {
         try {
-            await mkdir(join(workspaceDir, '.loom', 'registries'), { recursive: true });
-            exec(`git clone --depth 1 "${reg.url}" "${cachedDir}"`);
+            const cloneResult = await cloneRegistry({
+                workspaceDir,
+                url: reg.url,
+                name: reg.name,
+                gitFn,
+                execFn,
+                listGhAccountsFn,
+                switchGhAccountFn,
+            });
+            const cachedIndex = join(cloneResult.registryDir, 'index.yaml');
             if (await fileExists(cachedIndex)) {
                 return cachedIndex;
             }

package/dist/search-registry.js.map

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

package/dist/sessions/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Session module — named session directories.
+ *
+ * Layout:
+ *   $LOOM_HOME/sessions/<id>/
+ *     meta.yaml         -- typed session metadata (see SessionMeta)
+ *     transcript.jsonl  -- (reserved) append-only turn log; not yet populated
+ *     workspace/        -- (optional) staged workspace, when launched from a
+ *                          registry-resolved agent rather than an in-tree one
+ *
+ * `$LOOM_HOME` defaults to `~/.loom` but can be overridden with the
+ * `LOOM_HOME` env var (useful for tests + power users).
+ */
+export type { SessionMeta, SessionStatus, SessionRuntime, CreateSessionInput, FinalizeSessionInput, Session, } from './types.js';
+export { sessionsRoot, loomHome, generateSessionId, createSession, finalizeSession, listSessions, readSession, updateSessionMeta, sessionWorkspaceDir, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/sessions/index.js

@@ -0,0 +1,15 @@
+/**
+ * Session module — named session directories.
+ *
+ * Layout:
+ *   $LOOM_HOME/sessions/<id>/
+ *     meta.yaml         -- typed session metadata (see SessionMeta)
+ *     transcript.jsonl  -- (reserved) append-only turn log; not yet populated
+ *     workspace/        -- (optional) staged workspace, when launched from a
+ *                          registry-resolved agent rather than an in-tree one
+ *
+ * `$LOOM_HOME` defaults to `~/.loom` but can be overridden with the
+ * `LOOM_HOME` env var (useful for tests + power users).
+ */
+export { sessionsRoot, loomHome, generateSessionId, createSession, finalizeSession, listSessions, readSession, updateSessionMeta, sessionWorkspaceDir, } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/sessions/store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Session store — filesystem CRUD for session directories.
+ */
+import type { CreateSessionInput, FinalizeSessionInput, Session, SessionMeta } from './types.js';
+/**
+ * Resolve `$LOOM_HOME`. Honors `LOOM_HOME`, else `~/.loom`.
+ */
+export declare function loomHome(): string;
+/**
+ * Directory containing all sessions. Created lazily by callers.
+ */
+export declare function sessionsRoot(): string;
+/**
+ * Session workspace dir — for staged sessions this is populated by the
+ * staging code before `chat()` runs.
+ */
+export declare function sessionWorkspaceDir(sessionDir: string): string;
+/**
+ * Generate an id of the form `YYYYMMDD-HHMMSS-<agentId>[-<slug>]-<rand4>`.
+ * Uses UTC to keep comparisons deterministic across TZ changes.
+ *
+ * The trailing 4-char random suffix prevents collisions when two sessions
+ * are created within the same second (the timestamp resolution). Without
+ * it, parallel `loom <agent>` invocations could overwrite each other's
+ * `meta.yaml`. Callers that supply their own `id` (tests, replays) bypass
+ * this entirely.
+ */
+export declare function generateSessionId(agentId: string, options?: {
+    slug?: string;
+    now?: Date;
+    rand?: () => string;
+}): string;
+/**
+ * Create a new session on disk. Returns the handle.
+ */
+export declare function createSession(input: CreateSessionInput): Session;
+/**
+ * Stamp a session as finished. Idempotent — calling twice overwrites with
+ * the latest values.
+ */
+export declare function finalizeSession(session: Session, input: FinalizeSessionInput): Session;
+/**
+ * Update a subset of a session's mutable meta fields.
+ * Returns null if the session doesn't exist / is unreadable.
+ */
+export declare function updateSessionMeta(id: string, patch: Partial<Pick<SessionMeta, 'name' | 'note' | 'tags' | 'status'>>): Session | null;
+/**
+ * Read a single session by id. Returns null if the dir or meta is missing.
+ */
+export declare function readSession(id: string): Session | null;
+/**
+ * List all sessions, sorted by startedAt descending (newest first).
+ * Silently skips malformed session dirs.
+ */
+export declare function listSessions(): Session[];
+//# sourceMappingURL=store.d.ts.map

package/dist/sessions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACZ,MAAM,YAAY,CAAC;AAKpB;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAIjC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAC/D,MAAM,CAmBR;AAgDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAwChE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAUT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,GACrE,OAAO,GAAG,IAAI,CAMhB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAOtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,EAAE,CA0BxC"}