@agent-loom/loom 1.0.0

package/dist/repo-clone.js

@@ -0,0 +1,197 @@
+/**
+ * Repo Clone — Clones manifest repos into the workspace directory.
+ *
+ * Handles different repo types with appropriate strategies:
+ * - Normal GitHub repos → `gh repo clone` (parallel, up to concurrency limit)
+ * - ADO repos → `git clone` (interactive prompt, sequential)
+ * - Large repos → prompt user (clone / provide existing path / defer to agent)
+ * - Sparse repos → `git clone --filter=blob:none --sparse` + sparse-checkout
+ * - Skip strategy → skip with message
+ *
+ * Normal repos are cloned in parallel (default 4 concurrent).
+ * Large/ADO repos that require user interaction are processed sequentially.
+ * 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 { join } from 'node:path';
+import { exec as execCb } from 'node:child_process';
+import { promisify } from 'node:util';
+const execPromised = promisify(execCb);
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Derive a directory name from a repo URL (or override with id/name).
+ */
+export function deriveRepoDir(url, id) {
+    if (id)
+        return id;
+    const match = url.match(/\/([^/]+?)(?:\.git)?$/);
+    return match ? match[1] : 'repo';
+}
+/**
+ * Detect whether a repo is a GitHub repo based on URL or repoType.
+ */
+function isGitHub(repo) {
+    if (repo.repoType === 'github')
+        return true;
+    if (repo.repoType === 'ado')
+        return false;
+    return repo.url.includes('github.com');
+}
+/**
+ * Check whether a repo should be treated as large / needs prompting.
+ */
+function needsPrompt(repo) {
+    if (repo.cloneStrategy === 'partial')
+        return false;
+    if (repo.sparse && repo.paths && repo.paths.length > 0)
+        return false;
+    return !!(repo.large || repo.repoType === 'ado');
+}
+/**
+ * Clone all manifest repos into the workspace directory.
+ *
+ * Phase 1: Categorize repos (skip, auto-clone, interactive).
+ * Phase 2: Clone auto-clone repos in parallel (batched by concurrency limit).
+ * Phase 3: Process interactive repos sequentially (user prompts).
+ */
+export async function cloneManifestRepos(options) {
+    const { repos, workspaceDir, mode, concurrency = 4, execFn = defaultExec, promptFn, linkFn, } = options;
+    const result = {
+        cloned: [],
+        skipped: [],
+        deferred: [],
+    };
+    // --- Phase 1: Categorize repos ---
+    const autoClone = [];
+    const interactive = [];
+    for (const repo of repos) {
+        if (repo.cloneStrategy === 'skip') {
+            result.skipped.push({ repo, reason: 'cloneStrategy is "skip"' });
+            continue;
+        }
+        if (mode === 'none') {
+            result.skipped.push({ repo, reason: 'mode is "none" — skipping all repos' });
+            continue;
+        }
+        const dirName = deriveRepoDir(repo.url, repo.id);
+        const targetDir = join(workspaceDir, dirName);
+        if (await dirExists(targetDir)) {
+            result.skipped.push({ repo, reason: `Directory "${dirName}" already exists` });
+            continue;
+        }
+        if (mode === 'auto' && needsPrompt(repo)) {
+            interactive.push({ repo, dirName, targetDir });
+        }
+        else {
+            autoClone.push({ repo, dirName, targetDir });
+        }
+    }
+    // --- Phase 2: Clone auto-clone repos in parallel ---
+    for (let i = 0; i < autoClone.length; i += concurrency) {
+        const batch = autoClone.slice(i, i + concurrency);
+        await Promise.all(batch.map(async ({ repo, targetDir }) => {
+            await executeClone(repo, targetDir, execFn);
+            result.cloned.push({ repo, path: targetDir });
+        }));
+    }
+    // --- Phase 3: Process interactive repos sequentially ---
+    for (const { repo, dirName, targetDir } of interactive) {
+        if (!promptFn) {
+            result.deferred.push({
+                repo,
+                reason: `Large/ADO repo — deferred to agent (no interactive prompt available)`,
+            });
+            continue;
+        }
+        const repoLabel = repo.name ?? repo.id ?? dirName;
+        const message = repo.large
+            ? `${repoLabel} is a large repository. Clone, provide existing path, or defer to agent?`
+            : `${repoLabel} is an ADO repository. Clone, provide existing path, or defer to agent?`;
+        const answer = await promptFn(message, ['clone', 'skip']);
+        if (answer === 'clone') {
+            await executeClone(repo, targetDir, execFn);
+            result.cloned.push({ repo, path: targetDir });
+        }
+        else if (answer === 'skip') {
+            result.deferred.push({ repo, reason: `User chose to defer to agent` });
+        }
+        else {
+            // 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 });
+            }
+            else {
+                result.deferred.push({ repo, reason: `User-provided path not found: ${answer}` });
+            }
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Internal helpers
+// =============================================================================
+/**
+ * Execute the appropriate clone command for a repo.
+ */
+async function executeClone(repo, targetDir, execFn) {
+    if (repo.sparse && repo.paths && repo.paths.length > 0) {
+        // Sparse checkout
+        await execFn(`git clone --filter=blob:none --sparse "${repo.url}" "${targetDir}"`);
+        for (const p of repo.paths) {
+            await execFn(`git -C "${targetDir}" sparse-checkout add "${p}"`);
+        }
+    }
+    else if (repo.cloneStrategy === 'partial') {
+        // Blobless clone (all paths, blobs fetched on demand)
+        await execFn(`git clone --filter=blob:none "${repo.url}" "${targetDir}"`);
+    }
+    else if (isGitHub(repo)) {
+        // GitHub → use gh repo clone (handles auth)
+        await execFn(`gh repo clone "${extractGitHubSlug(repo.url)}" "${targetDir}"`);
+    }
+    else {
+        // ADO or other → use git clone
+        await execFn(`git clone "${repo.url}" "${targetDir}"`);
+    }
+}
+/**
+ * Extract "org/repo" slug from a GitHub URL.
+ */
+function extractGitHubSlug(url) {
+    const match = url.match(/github\.com\/(.+?)(?:\.git)?$/);
+    return match ? match[1] : url;
+}
+async function dirExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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.
+ */
+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 });
+    await linkFn(target, linkPath);
+    return linkPath;
+}
+async function defaultExec(cmd) {
+    await execPromised(cmd, { timeout: 300_000 });
+}
+//# sourceMappingURL=repo-clone.js.map

package/dist/repo-clone.js.map

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

package/dist/resolve-template.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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
+ * 2. If not, search ~/.loom/config.yaml registries for a matching template
+ * 3. Clone the matching registry and resolve the template path
+ */
+import type { RegistryConfig } from './types.js';
+export interface ResolveResult {
+    templateDir: string;
+    registryRoot: string;
+    /** Whether the template was resolved from a configured registry (vs local path) */
+    fromRegistry: boolean;
+    /** Whether the registry was already cached locally */
+    alreadyCloned?: boolean;
+}
+export interface ResolveOptions {
+    /** Load config override (for testing) */
+    loadConfigFn?: () => Promise<{
+        registries: RegistryConfig[];
+    }>;
+    /** Exec override for git clone (for testing) */
+    execFn?: (cmd: string) => void;
+}
+/**
+ * Resolve a template argument to a local directory path.
+ *
+ * Falls back to configured registries when the template is not a local path.
+ */
+export declare function resolveTemplateSource(template: string, workspaceDir: string, registryRootOverride?: string, options?: ResolveOptions): Promise<ResolveResult>;
+//# sourceMappingURL=resolve-template.d.ts.map

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

@@ -0,0 +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"}

package/dist/resolve-template.js

@@ -0,0 +1,75 @@
+/**
+ * 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
+ * 2. If not, search ~/.loom/config.yaml registries for a matching template
+ * 3. Clone the matching registry and resolve the template path
+ */
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { loadConfig } from './config.js';
+import { cloneRegistry, resolveTemplatePath } from './clone.js';
+/**
+ * Resolve a template argument to a local directory path.
+ *
+ * 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'))) {
+        return {
+            templateDir: template,
+            registryRoot: registryRootOverride ?? template.replace(/[/\\]templates[/\\].*$/, ''),
+            fromRegistry: false,
+        };
+    }
+    // 2. 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` +
+            `  Or provide a URL: loom apply ${template} --registry <url>`);
+    }
+    // Try to find and clone a registry that contains this template
+    for (const reg of config.registries) {
+        try {
+            const cloneResult = await cloneRegistry({
+                workspaceDir,
+                url: reg.url,
+                name: reg.name,
+                execFn: options?.execFn,
+            });
+            const candidatePath = resolveTemplatePath(cloneResult.registryDir, template);
+            if (await fileExists(join(candidatePath, 'manifest.yaml'))) {
+                return {
+                    templateDir: candidatePath,
+                    registryRoot: cloneResult.registryDir,
+                    fromRegistry: true,
+                    alreadyCloned: cloneResult.alreadyExists,
+                };
+            }
+        }
+        catch {
+            // Clone failed for this registry — try next
+            continue;
+        }
+    }
+    // 3. No registry has this template
+    const regNames = config.registries.map((r) => r.name).join(', ');
+    throw new Error(`Template "${template}" not found locally or in any configured registry (${regNames}).\n` +
+        `  Check available templates: loom search ${template}\n` +
+        `  Or provide a registry URL: loom apply ${template} --registry <url>`);
+}
+async function fileExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile() || s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=resolve-template.js.map

package/dist/resolve-template.js.map

@@ -0,0 +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"}

package/dist/search-registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Search Registry Resolution — resolves registry names to local index.yaml paths.
+ *
+ * Workflow:
+ * 1. Read ~/.loom/config.yaml for registered registries
+ * 2. Check .loom/registries/<name>/index.yaml for cached clones
+ * 3. If not cached, auto-clone (shallow) and cache
+ * 4. Return paths for search
+ */
+export interface RegistryResolutionOptions {
+    /** Search a specific registry by name (from config.yaml). If omitted, resolves all registries. */
+    registryName?: string;
+    /** Workspace directory (for .loom/registries/ cache) */
+    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;
+    /** Also check workspace root for index.yaml (workspace is itself a registry) */
+    includeWorkspaceRoot?: boolean;
+}
+/**
+ * Resolve registry index paths from config + local cache.
+ *
+ * Returns an array of { name, path } suitable for passing to searchTemplates().
+ */
+export declare function resolveRegistryIndexPaths(options: RegistryResolutionOptions): Promise<Array<{
+    name: string;
+    path: string;
+}>>;
+//# sourceMappingURL=search-registry.d.ts.map

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

@@ -0,0 +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"}

package/dist/search-registry.js

@@ -0,0 +1,96 @@
+/**
+ * Search Registry Resolution — resolves registry names to local index.yaml paths.
+ *
+ * Workflow:
+ * 1. Read ~/.loom/config.yaml for registered registries
+ * 2. Check .loom/registries/<name>/index.yaml for cached clones
+ * 3. If not cached, auto-clone (shallow) and cache
+ * 4. Return paths for search
+ */
+import { readFile, stat, mkdir } 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';
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Resolve registry index paths from config + local cache.
+ *
+ * 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 results = [];
+    // Load config
+    const config = await loadConfigFrom(configDir);
+    const registries = registryName
+        ? config.registries.filter((r) => r.name === registryName)
+        : config.registries;
+    for (const reg of registries) {
+        const indexPath = await resolveOneRegistry(reg, workspaceDir, execFn);
+        if (indexPath) {
+            results.push({ name: reg.name, path: indexPath });
+        }
+    }
+    // Also check workspace root if requested
+    if (includeWorkspaceRoot) {
+        const wsIndexPath = join(workspaceDir, 'index.yaml');
+        if (await fileExists(wsIndexPath)) {
+            results.push({ name: '__workspace__', path: wsIndexPath });
+        }
+    }
+    return results;
+}
+// =============================================================================
+// Internal helpers
+// =============================================================================
+/**
+ * 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' }); });
+    if (reg.url) {
+        try {
+            await mkdir(join(workspaceDir, '.loom', 'registries'), { recursive: true });
+            exec(`git clone --depth 1 "${reg.url}" "${cachedDir}"`);
+            if (await fileExists(cachedIndex)) {
+                return cachedIndex;
+            }
+        }
+        catch {
+            // Clone failed — skip silently
+        }
+    }
+    return undefined;
+}
+async function loadConfigFrom(configDir) {
+    try {
+        const configPath = join(configDir, 'config.yaml');
+        const raw = await readFile(configPath, 'utf-8');
+        const parsed = yaml.load(raw);
+        return parsed ?? { registries: [] };
+    }
+    catch {
+        return { registries: [] };
+    }
+}
+async function fileExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=search-registry.js.map

package/dist/search-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-registry.js","sourceRoot":"","sources":["../src/search-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,IAAI,MAAM,SAAS,CAAC;AAoB3B,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAkC;IAElC,MAAM,EACJ,YAAY,EACZ,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,EAC5B,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,EACpC,MAAM,EACN,oBAAoB,GACrB,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAA0C,EAAE,CAAC;IAE1D,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,YAAY;QAC7B,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;QAC1D,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,oBAAoB,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACrD,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAC/B,GAAmB,EACnB,YAAoB,EACpB,MAA8B;IAE9B,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAElD,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,iCAAiC;IACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,wBAAwB,GAAG,CAAC,GAAG,MAAM,SAAS,GAAG,CAAC,CAAC;YAExD,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAAiB;IAC7C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,CAAC;QACnD,OAAO,MAAM,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;AACH,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,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Search — searches index.yaml files across configured registries.
+ */
+import type { RegistryTemplateEntry, AgentRegistryEntry } from './types.js';
+export interface SearchResult extends RegistryTemplateEntry {
+    registry: string;
+    /** If this result matched at agent level, the matching agent info */
+    matchedAgent?: AgentRegistryEntry;
+    /** Parent team ID (set when matchedAgent is present) */
+    teamId?: string;
+}
+/**
+ * Search templates across local registry index files.
+ * Searches both team-level and agent-level entries.
+ */
+export declare function searchTemplates(indexPaths: Array<{
+    name: string;
+    path: string;
+}>, keyword: string): Promise<SearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAiB,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,YAAa,SAAQ,qBAAqB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CA+CzB"}

package/dist/search.js

@@ -0,0 +1,51 @@
+/**
+ * Search — searches index.yaml files across configured registries.
+ */
+import { readFile } from 'node:fs/promises';
+import yaml from 'js-yaml';
+/**
+ * Search templates across local registry index files.
+ * Searches both team-level and agent-level entries.
+ */
+export async function searchTemplates(indexPaths, keyword) {
+    const results = [];
+    const lower = keyword.toLowerCase();
+    for (const { name, path } of indexPaths) {
+        try {
+            const raw = await readFile(path, 'utf-8');
+            const index = yaml.load(raw);
+            for (const tmpl of index.templates) {
+                const teamMatches = tmpl.id.toLowerCase().includes(lower) ||
+                    tmpl.name.toLowerCase().includes(lower) ||
+                    tmpl.description.toLowerCase().includes(lower) ||
+                    tmpl.tags.some((t) => t.toLowerCase().includes(lower));
+                if (teamMatches) {
+                    results.push({ ...tmpl, registry: name });
+                }
+                // Also search inside nested agents
+                if (tmpl.agents) {
+                    for (const agent of tmpl.agents) {
+                        const agentMatches = agent.id.toLowerCase().includes(lower) ||
+                            agent.name.toLowerCase().includes(lower) ||
+                            agent.description.toLowerCase().includes(lower) ||
+                            agent.tags.some((t) => t.toLowerCase().includes(lower));
+                        // Only add agent result if the team itself didn't already match
+                        if (agentMatches && !teamMatches) {
+                            results.push({
+                                ...tmpl,
+                                registry: name,
+                                matchedAgent: agent,
+                                teamId: tmpl.id,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip unreadable registries
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,SAAS,CAAC;AAW3B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAiD,EACjD,OAAe;IAEf,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,CAAC;YAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,WAAW,GACf,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACrC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACvC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEzD,IAAI,WAAW,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBAED,mCAAmC;gBACnC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChC,MAAM,YAAY,GAChB,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;4BACtC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;4BACxC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;4BAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;wBAE1D,gEAAgE;wBAChE,IAAI,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC;4BACjC,OAAO,CAAC,IAAI,CAAC;gCACX,GAAG,IAAI;gCACP,QAAQ,EAAE,IAAI;gCACd,YAAY,EAAE,KAAK;gCACnB,MAAM,EAAE,IAAI,CAAC,EAAE;6BAChB,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/skill-fetcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Skill Fetcher — Resolves registry skills to local content
+ *
+ * Downloads/fetches skill content from external registries (craft, skills.sh)
+ * and converts them to local skills that can be placed in the workspace.
+ */
+import type { ResolvedSkill } from './types.js';
+/**
+ * A function that fetches skill content from a registry.
+ * Returns the SKILL.md content as a string.
+ */
+export type SkillFetcher = (registry: string, ref: string) => Promise<string>;
+/**
+ * Create a mock fetcher backed by a static map (for testing and offline use).
+ */
+export declare function createMockFetcher(skills: Record<string, string>): SkillFetcher;
+/**
+ * Create a fetcher for craft skills.
+ *
+ * Tries to fetch SKILL.md from the craft-skills GitHub repo.
+ * Falls back to a stub SKILL.md if the fetch fails.
+ *
+ * Supports optional authentication via tokenFn for private repos.
+ */
+export declare function createCraftFetcher(options?: {
+    baseUrl?: string;
+    tokenFn?: () => string | undefined;
+    fetchFn?: typeof globalThis.fetch;
+}): SkillFetcher;
+/**
+ * Resolve registry skills by fetching their content and converting
+ * them to local skills. If no fetcher is provided, registry skills
+ * are passed through unchanged.
+ *
+ * @param skills - Array of resolved skills (may include registry type)
+ * @param fetcher - Optional function to fetch skill content
+ * @returns Updated skills array with registry skills converted to local
+ */
+export declare function resolveRegistrySkills(skills: ResolvedSkill[], fetcher?: SkillFetcher): Promise<ResolvedSkill[]>;
+//# sourceMappingURL=skill-fetcher.d.ts.map

package/dist/skill-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-fetcher.d.ts","sourceRoot":"","sources":["../src/skill-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9E;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,YAAY,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACnC,GACA,YAAY,CA+Bd;AAkBD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAqB1B"}