@agent-loom/loom 1.0.2 → 1.0.3

package/dist/chat/discovery.js

@@ -0,0 +1,68 @@
+/**
+ * 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 { existsSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parseAgentFrontmatter } from './frontmatter.js';
+/**
+ * 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 function findWorkspaceRoot(cwd) {
+    let current = resolve(cwd);
+    // Guard against infinite loops on edge cases where dirname() is a no-op.
+    let safety = 64;
+    while (safety-- > 0) {
+        const candidate = join(current, '.github', 'agents');
+        if (existsSync(candidate)) {
+            try {
+                if (statSync(candidate).isDirectory())
+                    return current;
+            }
+            catch { /* ignore and keep walking */ }
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+    return null;
+}
+/**
+ * List all agents in a workspace's `.github/agents/` directory.
+ * Returns an empty array if the directory doesn't exist.
+ */
+export function listWorkspaceAgents(workspaceDir) {
+    const agentDir = join(workspaceDir, '.github', 'agents');
+    if (!existsSync(agentDir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(agentDir);
+    }
+    catch {
+        return [];
+    }
+    const agents = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.agent.md'))
+            continue;
+        const agentId = entry.slice(0, -'.agent.md'.length);
+        const agentFilePath = join(agentDir, entry);
+        agents.push({
+            agentId,
+            agentFilePath,
+            metadata: parseAgentFrontmatter(agentFilePath),
+        });
+    }
+    agents.sort((a, b) => a.agentId.localeCompare(b.agentId));
+    return agents;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/chat/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/chat/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAYzD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,yEAAyE;IACzE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;oBAAE,OAAO,OAAO,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,SAAS;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC;YACV,OAAO;YACP,aAAa;YACb,QAAQ,EAAE,qBAAqB,CAAC,aAAa,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/chat/frontmatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Backwards-compatible re-exports of the frontmatter parser.
+ *
+ * The implementation lives under `src/util/frontmatter.ts` because every
+ * layer (chat, run, renderers, manifest) needs it — having it here forced
+ * renderers and util code to depend on a chat module. Existing imports
+ * from `./chat/frontmatter.js` still work via these re-exports, but new
+ * code should import from `../util/frontmatter.js`.
+ */
+export { parseFrontmatterRaw, stripFrontmatter, parseAgentFrontmatter, } from '../util/frontmatter.js';
+export type { AgentMetadata } from '../util/frontmatter.js';
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/chat/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/chat/frontmatter.js

@@ -0,0 +1,11 @@
+/**
+ * Backwards-compatible re-exports of the frontmatter parser.
+ *
+ * The implementation lives under `src/util/frontmatter.ts` because every
+ * layer (chat, run, renderers, manifest) needs it — having it here forced
+ * renderers and util code to depend on a chat module. Existing imports
+ * from `./chat/frontmatter.js` still work via these re-exports, but new
+ * code should import from `../util/frontmatter.js`.
+ */
+export { parseFrontmatterRaw, stripFrontmatter, parseAgentFrontmatter, } from '../util/frontmatter.js';
+//# sourceMappingURL=frontmatter.js.map

package/dist/chat/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/chat/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/chat/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public exports for the chat module.
+ * See `chat.ts` for behavior.
+ */
+export { chat, buildChatCommand, defaultPreChatBanner } from './chat.js';
+export type { ChatOptions, ChatResult, LaunchRuntimeKind, PreLaunchInfo, } from './chat.js';
+export { resolveAgentInWorkspace } from './resolve-agent.js';
+export type { ResolvedAgentRef, ResolveAgentOptions } from './resolve-agent.js';
+export { findWorkspaceRoot, listWorkspaceAgents } from './discovery.js';
+export type { WorkspaceAgentInfo } from './discovery.js';
+export { parseAgentFrontmatter } from './frontmatter.js';
+export type { AgentMetadata } from './frontmatter.js';
+export { suggestClosest, levenshtein } from './suggest.js';
+export { resolveAgentFromRegistry, listRegistryAgentIds, listRegistryAgents, } from './registry.js';
+export type { RegistryAgentHit, RegistryAgentListing, ResolveAgentFromRegistryOptions, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACzE,YAAY,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,eAAe,CAAC"}

package/dist/chat/index.js

@@ -0,0 +1,11 @@
+/**
+ * Public exports for the chat module.
+ * See `chat.ts` for behavior.
+ */
+export { chat, buildChatCommand, defaultPreChatBanner } from './chat.js';
+export { resolveAgentInWorkspace } from './resolve-agent.js';
+export { findWorkspaceRoot, listWorkspaceAgents } from './discovery.js';
+export { parseAgentFrontmatter } from './frontmatter.js';
+export { suggestClosest, levenshtein } from './suggest.js';
+export { resolveAgentFromRegistry, listRegistryAgentIds, listRegistryAgents, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAQzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/chat/registry.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Registry resolution for `loom <agent>`.
+ *
+ * When an agent id doesn't match an in-workspace `.github/agents/<id>.agent.md`
+ * file, we fall back to configured Loom registries. The registry index lists
+ * templates and their nested agents; we search it for an exact agent-id hit
+ * and return enough information for the launch code to stage the template
+ * into a session workspace via `applyTemplate`.
+ *
+ * This is deliberately *resolution only* — no staging, no filesystem writes
+ * beyond what `resolveRegistryIndexPaths` already does when it auto-clones a
+ * registry.
+ */
+import type { AgentRegistryEntry, RegistryTemplateEntry } from '../types.js';
+export interface RegistryAgentHit {
+    /** Registry name (as configured in ~/.loom/config.yaml). */
+    registryName: string;
+    /** Absolute path to the registry root (the dir containing index.yaml). */
+    registryRoot: string;
+    /** Id of the template that contains the matched agent. */
+    templateId: string;
+    /** Absolute path to the template directory (contains manifest.yaml). */
+    templatePath: string;
+    /** The matched agent id (== requested id). */
+    agentId: string;
+    /** Frontmatter/index metadata for the matched agent, when available. */
+    agent: AgentRegistryEntry;
+    /** Template metadata, for UX. */
+    template: RegistryTemplateEntry;
+}
+export interface ResolveAgentFromRegistryOptions {
+    /** The agent id to resolve (exact match against index entries). */
+    agentId: string;
+    /** Override `~/.loom` config dir (tests, power users). */
+    configDir?: string;
+    /** Override workspace dir used for registry cache. */
+    workspaceDir?: string;
+    /** Inject an exec fn to suppress real git clones during tests. */
+    execFn?: (cmd: string) => void;
+    /** Limit resolution to a single named registry. */
+    registryName?: string;
+}
+/**
+ * Walk all configured registries searching for a template whose nested
+ * agents include an exact match for `agentId`.
+ *
+ * Returns the first hit (deterministic: registries are iterated in config
+ * order). Returns an object describing the match or null if none found.
+ *
+ * Side effects: `resolveRegistryIndexPaths` may auto-clone registries that
+ * aren't yet cached. Callers that want a pure lookup must pre-populate the
+ * cache.
+ */
+export declare function resolveAgentFromRegistry(options: ResolveAgentFromRegistryOptions): Promise<RegistryAgentHit | null>;
+/**
+ * Discover all agent ids offered across configured registries — used for
+ * fuzzy suggestions when an exact match fails. Registry errors are swallowed.
+ */
+export declare function listRegistryAgentIds(options?: Omit<ResolveAgentFromRegistryOptions, 'agentId'>): Promise<string[]>;
+export interface RegistryAgentListing {
+    agentId: string;
+    agentName?: string;
+    description?: string;
+    registryName: string;
+    templateId: string;
+    tags?: string[];
+}
+/**
+ * Discover all agents across configured registries with enough metadata to
+ * render a "what could I launch?" listing. Registry errors are swallowed.
+ */
+export declare function listRegistryAgents(options?: Omit<ResolveAgentFromRegistryOptions, 'agentId'>): Promise<RegistryAgentListing[]>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/chat/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAiB,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuClC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,IAAI,CAAC,+BAA+B,EAAE,SAAS,CAAM,GAC7D,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,IAAI,CAAC,+BAA+B,EAAE,SAAS,CAAM,GAC7D,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC"}

package/dist/chat/registry.js

@@ -0,0 +1,118 @@
+/**
+ * Registry resolution for `loom <agent>`.
+ *
+ * When an agent id doesn't match an in-workspace `.github/agents/<id>.agent.md`
+ * file, we fall back to configured Loom registries. The registry index lists
+ * templates and their nested agents; we search it for an exact agent-id hit
+ * and return enough information for the launch code to stage the template
+ * into a session workspace via `applyTemplate`.
+ *
+ * This is deliberately *resolution only* — no staging, no filesystem writes
+ * beyond what `resolveRegistryIndexPaths` already does when it auto-clones a
+ * registry.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import yaml from 'js-yaml';
+import { resolveRegistryIndexPaths } from '../search-registry.js';
+import { resolveTemplatePath } from '../clone.js';
+/**
+ * Walk all configured registries searching for a template whose nested
+ * agents include an exact match for `agentId`.
+ *
+ * Returns the first hit (deterministic: registries are iterated in config
+ * order). Returns an object describing the match or null if none found.
+ *
+ * Side effects: `resolveRegistryIndexPaths` may auto-clone registries that
+ * aren't yet cached. Callers that want a pure lookup must pre-populate the
+ * cache.
+ */
+export async function resolveAgentFromRegistry(options) {
+    const indexPaths = await resolveRegistryIndexPaths({
+        registryName: options.registryName,
+        workspaceDir: options.workspaceDir,
+        configDir: options.configDir,
+        execFn: options.execFn,
+    });
+    for (const { name, path: indexPath } of indexPaths) {
+        let index;
+        try {
+            const raw = await readFile(indexPath, 'utf-8');
+            index = yaml.load(raw);
+        }
+        catch {
+            continue;
+        }
+        if (!index || !Array.isArray(index.templates))
+            continue;
+        for (const tmpl of index.templates) {
+            if (!tmpl.agents)
+                continue;
+            const match = tmpl.agents.find((a) => a.id === options.agentId);
+            if (!match)
+                continue;
+            // registryRoot is the directory containing index.yaml.
+            const registryRoot = dirname(indexPath);
+            const templatePath = resolveTemplatePath(registryRoot, tmpl.id);
+            return {
+                registryName: name,
+                registryRoot,
+                templateId: tmpl.id,
+                templatePath,
+                agentId: options.agentId,
+                agent: match,
+                template: tmpl,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Discover all agent ids offered across configured registries — used for
+ * fuzzy suggestions when an exact match fails. Registry errors are swallowed.
+ */
+export async function listRegistryAgentIds(options = {}) {
+    const listings = await listRegistryAgents(options);
+    return Array.from(new Set(listings.map((l) => l.agentId))).sort();
+}
+/**
+ * Discover all agents across configured registries with enough metadata to
+ * render a "what could I launch?" listing. Registry errors are swallowed.
+ */
+export async function listRegistryAgents(options = {}) {
+    const indexPaths = await resolveRegistryIndexPaths({
+        registryName: options.registryName,
+        workspaceDir: options.workspaceDir,
+        configDir: options.configDir,
+        execFn: options.execFn,
+    }).catch(() => []);
+    const out = [];
+    for (const { name, path: indexPath } of indexPaths) {
+        try {
+            const raw = await readFile(indexPath, 'utf-8');
+            const index = yaml.load(raw);
+            if (!index || !Array.isArray(index.templates))
+                continue;
+            for (const tmpl of index.templates) {
+                if (!tmpl.agents)
+                    continue;
+                for (const a of tmpl.agents) {
+                    out.push({
+                        agentId: a.id,
+                        agentName: a.name,
+                        description: a.description,
+                        registryName: name,
+                        templateId: tmpl.id,
+                        tags: a.tags,
+                    });
+                }
+            }
+        }
+        catch {
+            // skip unreadable index
+        }
+    }
+    out.sort((x, y) => x.agentId.localeCompare(y.agentId));
+    return out;
+}
+//# sourceMappingURL=registry.js.map

package/dist/chat/registry.js.map

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

package/dist/chat/resolve-agent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Agent Resolution for `loom <agent>`
+ *
+ * MVP: in-workspace resolution only.
+ *   Walks up from `cwd` to find the nearest workspace (directory containing
+ *   `.github/agents/`) and looks for `<id>.agent.md` there.
+ *
+ * Future layers (not yet implemented):
+ *   - Installed shortname lookup via ~/.loom/workspaces.yaml
+ *   - Registry-reference resolution (requires agent-definitions adapter)
+ */
+export interface ResolvedAgentRef {
+    /** Agent id (slug from filename) */
+    agentId: string;
+    /** Absolute path to the `.agent.md` file */
+    agentFilePath: string;
+    /** Absolute path to the workspace root (dir containing `.github/`) */
+    workspaceDir: string;
+    /** Resolution layer that produced the match */
+    source: 'workspace';
+}
+export interface ResolveAgentOptions {
+    /** Agent id to resolve (filename stem before `.agent.md`) */
+    agentId: string;
+    /** Directory to search from (typically process.cwd()) */
+    cwd: string;
+    /**
+     * If true, only look in `cwd` itself (no walk-up). Used for tests and
+     * for callers that need strict resolution semantics.
+     */
+    strictCwd?: boolean;
+}
+/**
+ * Resolve an agent id against the current workspace.
+ * Returns `null` if not found (caller decides whether to fall through
+ * to installed-shortname or registry layers in future iterations).
+ */
+export declare function resolveAgentInWorkspace(options: ResolveAgentOptions): ResolvedAgentRef | null;
+//# sourceMappingURL=resolve-agent.d.ts.map

package/dist/chat/resolve-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-agent.d.ts","sourceRoot":"","sources":["../../src/chat/resolve-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,GAC3B,gBAAgB,GAAG,IAAI,CAkBzB"}

package/dist/chat/resolve-agent.js

@@ -0,0 +1,36 @@
+/**
+ * Agent Resolution for `loom <agent>`
+ *
+ * MVP: in-workspace resolution only.
+ *   Walks up from `cwd` to find the nearest workspace (directory containing
+ *   `.github/agents/`) and looks for `<id>.agent.md` there.
+ *
+ * Future layers (not yet implemented):
+ *   - Installed shortname lookup via ~/.loom/workspaces.yaml
+ *   - Registry-reference resolution (requires agent-definitions adapter)
+ */
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { findWorkspaceRoot } from './discovery.js';
+/**
+ * Resolve an agent id against the current workspace.
+ * Returns `null` if not found (caller decides whether to fall through
+ * to installed-shortname or registry layers in future iterations).
+ */
+export function resolveAgentInWorkspace(options) {
+    const { agentId, cwd, strictCwd = false } = options;
+    if (!agentId || !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(agentId)) {
+        throw new Error(`Invalid agent id: "${agentId}". Must match [a-zA-Z0-9][a-zA-Z0-9._-]*`);
+    }
+    const workspaceDir = strictCwd ? resolve(cwd) : (findWorkspaceRoot(cwd) ?? resolve(cwd));
+    const agentFilePath = join(workspaceDir, '.github', 'agents', `${agentId}.agent.md`);
+    if (!existsSync(agentFilePath))
+        return null;
+    return {
+        agentId,
+        agentFilePath,
+        workspaceDir,
+        source: 'workspace',
+    };
+}
+//# sourceMappingURL=resolve-agent.js.map

package/dist/chat/resolve-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-agent.js","sourceRoot":"","sources":["../../src/chat/resolve-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAyBnD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA4B;IAE5B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACpD,IAAI,CAAC,OAAO,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,sBAAsB,OAAO,0CAA0C,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,WAAW,CAAC,CAAC;IACrF,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO;QACL,OAAO;QACP,aAAa;QACb,YAAY;QACZ,MAAM,EAAE,WAAW;KACpB,CAAC;AACJ,CAAC"}

package/dist/chat/suggest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Fuzzy suggestion helper for "agent not found" errors.
+ * Uses classic Levenshtein distance — small, fast, dependency-free,
+ * and adequate for the small candidate sets we deal with (dozens of
+ * agents per workspace at most).
+ */
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ * Case-insensitive comparison.
+ */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * Return up to `limit` candidates from `options` that are closest to `query`,
+ * ordered by distance ascending. Candidates with distance greater than
+ * `maxDistance` are excluded. When `maxDistance` is unset, defaults to
+ * max(2, ceil(query.length / 2)) — tolerates roughly half the characters
+ * wrong but at least two edits.
+ */
+export declare function suggestClosest(query: string, options: readonly string[], limit?: number, maxDistance?: number): string[];
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/chat/suggest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,SAAI,EACT,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,EAAE,CASV"}

package/dist/chat/suggest.js

@@ -0,0 +1,55 @@
+/**
+ * Fuzzy suggestion helper for "agent not found" errors.
+ * Uses classic Levenshtein distance — small, fast, dependency-free,
+ * and adequate for the small candidate sets we deal with (dozens of
+ * agents per workspace at most).
+ */
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ * Case-insensitive comparison.
+ */
+export function levenshtein(a, b) {
+    const s1 = a.toLowerCase();
+    const s2 = b.toLowerCase();
+    const m = s1.length;
+    const n = s2.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // Two-row DP to keep memory to O(min(m,n)).
+    let prev = new Array(n + 1);
+    let curr = new Array(n + 1);
+    for (let j = 0; j <= n; j++)
+        prev[j] = j;
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = s1.charCodeAt(i - 1) === s2.charCodeAt(j - 1) ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, // insert
+            prev[j] + 1, // delete
+            prev[j - 1] + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[n];
+}
+/**
+ * Return up to `limit` candidates from `options` that are closest to `query`,
+ * ordered by distance ascending. Candidates with distance greater than
+ * `maxDistance` are excluded. When `maxDistance` is unset, defaults to
+ * max(2, ceil(query.length / 2)) — tolerates roughly half the characters
+ * wrong but at least two edits.
+ */
+export function suggestClosest(query, options, limit = 3, maxDistance) {
+    const threshold = maxDistance ?? Math.max(2, Math.ceil(query.length / 2));
+    const scored = [];
+    for (const option of options) {
+        const d = levenshtein(query, option);
+        if (d <= threshold)
+            scored.push({ option, d });
+    }
+    scored.sort((a, b) => a.d - b.d || a.option.localeCompare(b.option));
+    return scored.slice(0, limit).map((s) => s.option);
+}
+//# sourceMappingURL=suggest.js.map

package/dist/chat/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../src/chat/suggest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtB,4CAA4C;IAC5C,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAS,SAAS;YACjC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAa,SAAS;YACjC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CACnB,CAAC;QACJ,CAAC;QACD,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,OAA0B,EAC1B,KAAK,GAAG,CAAC,EACT,WAAoB;IAEpB,MAAM,SAAS,GAAG,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}