@esankhan3/anvil-agent-core 0.1.2 → 0.2.0

package/dist/mcp/pool.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `McpClientPool` — workspace-scoped, session-lifetime pool of
+ * `McpAgentClient`s.
+ *
+ * Lifecycle owned by `AgentProcess` so resume turns reuse already-connected
+ * servers instead of re-paying the 250–1000 ms connect cost per turn. Each
+ * client is lazy-connected on first need; failures are logged + that server
+ * is dropped from the pool (not propagated as a spawn failure — one sick
+ * MCP shouldn't poison the run).
+ *
+ * Reconnect-on-EOF: if a stdio server crashes mid-session, the next tool
+ * call attempts to reconnect once before surfacing the error to the model.
+ */
+import { type McpToolDescriptor, type McpProgressEvent } from './client.js';
+import { loadMcpServers } from './config-loader.js';
+import type { McpServerConfig } from './types.js';
+export interface McpClientPoolOpts {
+    /** Workspace root used to resolve `mcp.json` discovery. */
+    workspaceRoot?: string;
+    /** Pre-resolved server configs — bypasses `loadMcpServers`. Test seam. */
+    servers?: McpServerConfig[];
+    /** Per-call deadline for `connect()` on each server. Defaults to 5 s. */
+    connectTimeoutMs?: number;
+    /** Optional run id forwarded to each client for stderr log naming. */
+    runId?: string;
+    /** Forwarded to every client constructed by the pool. */
+    onProgress?: (ev: McpProgressEvent) => void;
+    /** Test seam — override the loader. */
+    loader?: typeof loadMcpServers;
+}
+export declare class McpClientPool {
+    private readonly opts;
+    private readonly clients;
+    /** Tools discovered + cached. Refreshed on first call after reconnect. */
+    private toolsCache;
+    private discovering;
+    private closed;
+    /** Names of servers that failed to connect + the reason — surfaced to
+     *  diagnostics so the dashboard activity panel can show "github-mcp
+     *  failed to connect: ECONNREFUSED". */
+    readonly failures: Array<{
+        server: string;
+        reason: string;
+    }>;
+    constructor(opts: McpClientPoolOpts);
+    private loadConfig;
+    /** True iff at least one server is configured (regardless of liveness). */
+    hasServers(): boolean;
+    /**
+     * Connect every configured server in parallel, with a per-server
+     * timeout. Servers that fail to connect are removed from the pool and
+     * recorded in `failures` — they cannot serve tools but the run continues.
+     * Returns the union of tool descriptors from connected servers.
+     */
+    discoverTools(): Promise<McpToolDescriptor[]>;
+    private _discoverTools;
+    /**
+     * Dispatch a namespaced (`mcp__<server>__<tool>`) call. Returns the
+     * SDK's raw result for the merged executor to flatten. Throws when the
+     * server isn't connected and reconnect fails — caller wraps as a tool
+     * error so the model can recover.
+     */
+    callTool(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
+    /** Abort every in-flight tool call across every client. */
+    cancelInFlight(reason?: string): void;
+    /** Close every client. Idempotent. */
+    close(): Promise<void>;
+    /** Find the owning server name for a `mcp__<server>__<tool>` id. */
+    private findOwner;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/mcp/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/mcp/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,cAAc,EAA8B,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,cAAc,CAAC;CAChC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,MAAM,CAAS;IACvB;;4CAEwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;gBAEtD,IAAI,EAAE,iBAAiB;IAcnC,OAAO,CAAC,UAAU;IAWlB,2EAA2E;IAC3E,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAQrC,cAAc;IA8B5B;;;;;OAKG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA8BnB,2DAA2D;IAC3D,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMrC,sCAAsC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,oEAAoE;IACpE,OAAO,CAAC,SAAS;CAUlB"}

package/dist/mcp/pool.js

@@ -0,0 +1,171 @@
+/**
+ * `McpClientPool` — workspace-scoped, session-lifetime pool of
+ * `McpAgentClient`s.
+ *
+ * Lifecycle owned by `AgentProcess` so resume turns reuse already-connected
+ * servers instead of re-paying the 250–1000 ms connect cost per turn. Each
+ * client is lazy-connected on first need; failures are logged + that server
+ * is dropped from the pool (not propagated as a spawn failure — one sick
+ * MCP shouldn't poison the run).
+ *
+ * Reconnect-on-EOF: if a stdio server crashes mid-session, the next tool
+ * call attempts to reconnect once before surfacing the error to the model.
+ */
+import { McpAgentClient } from './client.js';
+import { loadMcpServers } from './config-loader.js';
+export class McpClientPool {
+    opts;
+    clients = new Map();
+    /** Tools discovered + cached. Refreshed on first call after reconnect. */
+    toolsCache = null;
+    discovering = null;
+    closed = false;
+    /** Names of servers that failed to connect + the reason — surfaced to
+     *  diagnostics so the dashboard activity panel can show "github-mcp
+     *  failed to connect: ECONNREFUSED". */
+    failures = [];
+    constructor(opts) {
+        this.opts = opts;
+        const servers = opts.servers ?? this.loadConfig();
+        for (const cfg of servers) {
+            this.clients.set(cfg.name, new McpAgentClient(cfg, {
+                runId: opts.runId,
+                onProgress: opts.onProgress,
+            }));
+        }
+    }
+    loadConfig() {
+        const loaderOpts = { workspaceRoot: this.opts.workspaceRoot };
+        const fn = this.opts.loader ?? loadMcpServers;
+        try {
+            return fn(loaderOpts);
+        }
+        catch (err) {
+            this.failures.push({ server: '<config>', reason: err.message });
+            return [];
+        }
+    }
+    /** True iff at least one server is configured (regardless of liveness). */
+    hasServers() {
+        return this.clients.size > 0;
+    }
+    /**
+     * Connect every configured server in parallel, with a per-server
+     * timeout. Servers that fail to connect are removed from the pool and
+     * recorded in `failures` — they cannot serve tools but the run continues.
+     * Returns the union of tool descriptors from connected servers.
+     */
+    async discoverTools() {
+        if (this.closed)
+            return [];
+        if (this.toolsCache)
+            return this.toolsCache;
+        if (this.discovering)
+            return this.discovering;
+        this.discovering = this._discoverTools().finally(() => { this.discovering = null; });
+        return this.discovering;
+    }
+    async _discoverTools() {
+        const timeout = this.opts.connectTimeoutMs ?? 5000;
+        const results = await Promise.allSettled(Array.from(this.clients.entries()).map(async ([name, client]) => {
+            try {
+                await Promise.race([
+                    client.connect(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`connect timed out after ${timeout}ms`)), timeout)),
+                ]);
+                return await client.listTools();
+            }
+            catch (err) {
+                this.failures.push({ server: name, reason: err.message });
+                // Drop the client — it's unusable. listTools() may throw because
+                // the connect failed too.
+                this.clients.delete(name);
+                try {
+                    await client.close();
+                }
+                catch { /* ok */ }
+                return [];
+            }
+        }));
+        const tools = [];
+        for (const r of results) {
+            if (r.status === 'fulfilled')
+                tools.push(...r.value);
+        }
+        this.toolsCache = tools;
+        return tools;
+    }
+    /**
+     * Dispatch a namespaced (`mcp__<server>__<tool>`) call. Returns the
+     * SDK's raw result for the merged executor to flatten. Throws when the
+     * server isn't connected and reconnect fails — caller wraps as a tool
+     * error so the model can recover.
+     */
+    async callTool(toolName, args, signal) {
+        if (this.closed)
+            throw new Error('McpClientPool is closed');
+        const owner = this.findOwner(toolName);
+        if (!owner)
+            throw new Error(`No MCP server owns "${toolName}"`);
+        const client = this.clients.get(owner);
+        if (!client)
+            throw new Error(`MCP server "${owner}" is unavailable`);
+        try {
+            return await client.callTool(toolName, args, signal);
+        }
+        catch (err) {
+            // EOF on stdio = server died. Try to reconnect once + replay.
+            const msg = err.message ?? '';
+            if (/closed|EPIPE|ECONNRESET|connection.*lost|EOF/i.test(msg)) {
+                try {
+                    await client.close();
+                    await client.connect();
+                    this.toolsCache = null; // tool list may have changed
+                    return await client.callTool(toolName, args, signal);
+                }
+                catch (reconnectErr) {
+                    this.failures.push({
+                        server: owner,
+                        reason: `reconnect failed: ${reconnectErr.message}`,
+                    });
+                    this.clients.delete(owner);
+                    throw reconnectErr;
+                }
+            }
+            throw err;
+        }
+    }
+    /** Abort every in-flight tool call across every client. */
+    cancelInFlight(reason) {
+        for (const c of this.clients.values()) {
+            try {
+                c.cancelInFlight(reason);
+            }
+            catch { /* ok */ }
+        }
+    }
+    /** Close every client. Idempotent. */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.cancelInFlight('pool closing');
+        await Promise.allSettled(Array.from(this.clients.values()).map((c) => c.close()));
+        this.clients.clear();
+        this.toolsCache = null;
+    }
+    /** Find the owning server name for a `mcp__<server>__<tool>` id. */
+    findOwner(toolName) {
+        // Format: mcp__<server>__<tool>. Server names may themselves contain
+        // underscores so we resolve by longest matching prefix.
+        if (!toolName.startsWith('mcp__'))
+            return undefined;
+        const candidates = Array.from(this.clients.keys()).sort((a, b) => b.length - a.length);
+        for (const name of candidates) {
+            if (toolName.startsWith(`mcp__${name}__`))
+                return name;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/mcp/pool.js.map

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

package/dist/mcp/tool-merger.d.ts

@@ -1,10 +1,13 @@
 /**
- * `buildAgentToolset` — merge built-in tools with MCP-discovered tools into a
- * single `ToolSchema[]` registered with the LLM provider, plus a dispatch
- * map from namespaced tool name → owning MCP client.
+ * `buildAgentToolset` — legacy helper that merges built-in tool schemas with
+ * MCP-discovered tools into a single `ToolSchema[]` plus a dispatch map.
  *
- * Per ADR §H7, the provider doesn't know MCP exists; the agent layer routes
- * tool calls based on whether the name is in `mcpDispatch`.
+ * Superseded by `MergedToolExecutor` for live agent paths — that class is
+ * what the bridge wires into `ModelAdapterConfig.toolExecutor`. This
+ * helper remains for callers that want the flat tools+dispatch shape (and
+ * for backward compat with the existing test surface).
+ *
+ * Naming convention is `mcp__<server>__<tool>` (Claude Code convention).
  */
 import type { ToolSchema } from '../types.js';
 import type { McpAgentClient } from './client.js';

package/dist/mcp/tool-merger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-merger.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,EAAE,cAAc,EAAE,GAC3B,OAAO,CAAC,YAAY,CAAC,CA4BvB"}
+{"version":3,"file":"tool-merger.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,EAAE,cAAc,EAAE,GAC3B,OAAO,CAAC,YAAY,CAAC,CA4BvB"}

package/dist/mcp/tool-merger.js

@@ -1,32 +1,24 @@
-/**
- * `buildAgentToolset` — merge built-in tools with MCP-discovered tools into a
- * single `ToolSchema[]` registered with the LLM provider, plus a dispatch
- * map from namespaced tool name → owning MCP client.
- *
- * Per ADR §H7, the provider doesn't know MCP exists; the agent layer routes
- * tool calls based on whether the name is in `mcpDispatch`.
- */
 export async function buildAgentToolset(builtIn, mcpClients) {
     const tools = [...builtIn];
     const mcpDispatch = new Map();
     const seen = new Set(builtIn.map((t) => t.name));
     for (const client of mcpClients) {
-        let mcpTools;
+        let mcpDescriptors;
         try {
-            mcpTools = await client.listTools();
+            mcpDescriptors = await client.listTools();
         }
         catch (err) {
             process.stderr.write(`[anvil-mcp] WARN: server "${client.config.name}" listTools failed: ${err.message}\n`);
             continue;
         }
-        for (const t of mcpTools) {
-            if (seen.has(t.name)) {
-                process.stderr.write(`[anvil-mcp] WARN: tool name collision "${t.name}"; ignoring duplicate from "${client.config.name}"\n`);
+        for (const desc of mcpDescriptors) {
+            if (seen.has(desc.name)) {
+                process.stderr.write(`[anvil-mcp] WARN: tool name collision "${desc.name}"; ignoring duplicate from "${client.config.name}"\n`);
                 continue;
             }
-            tools.push(t);
-            mcpDispatch.set(t.name, client);
-            seen.add(t.name);
+            tools.push(desc.schema);
+            mcpDispatch.set(desc.name, client);
+            seen.add(desc.name);
         }
     }
     return { tools, mcpDispatch };

package/dist/mcp/tool-merger.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-merger.js","sourceRoot":"","sources":["../../src/mcp/tool-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB,EACrB,UAA4B;IAE5B,MAAM,KAAK,GAAiB,CAAC,GAAG,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,QAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,uBAAwB,GAAa,CAAC,OAAO,IAAI,CACjG,CAAC;YACF,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0CAA0C,CAAC,CAAC,IAAI,+BAA+B,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CACvG,CAAC;gBACF,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACd,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"tool-merger.js","sourceRoot":"","sources":["../../src/mcp/tool-merger.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB,EACrB,UAA4B;IAE5B,MAAM,KAAK,GAAiB,CAAC,GAAG,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,cAAc,CAAC;QACnB,IAAI,CAAC;YACH,cAAc,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,uBAAwB,GAAa,CAAC,OAAO,IAAI,CACjG,CAAC;YACF,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0CAA0C,IAAI,CAAC,IAAI,+BAA+B,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAC1G,CAAC;gBACF,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/dist/model-catalog.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Model catalog — single source of truth for per-model token limits.
+ *
+ * Promoted to `@esankhan3/anvil-agent-core` in Phase F1 of the dashboard
+ * pipeline-runner deprecation plan (`docs/dashboard-pipeline-deprecation-plan.md`).
+ * Lives next to the provider adapters because token limits are
+ * provider-shaped knowledge — same layer as which envelope each provider
+ * accepts. Cli + dashboard + future tooling all read from here.
+ *
+ * Resolution order (first match wins):
+ *   1. ENV override — `ANVIL_CONTEXT_WINDOW_<sanitized-model-id>` (e.g. `ANVIL_CONTEXT_WINDOW_CLAUDE_OPUS_4_7=1000000`)
+ *   2. Explicit override table — for models that diverge from their family defaults (legacy 200K variants)
+ *   3. Family rules — regex match on model ID, ordered from most specific to least
+ *   4. OpenRouter-style `org/model` — recurse on the model segment
+ *   5. Conservative DEFAULT
+ *
+ * Source: https://docs.claude.com/en/docs/about-claude/models/overview
+ * (Opus 4.7, Opus 4.6, and Sonnet 4.6 all ship with native 1M context windows;
+ * Haiku 4.5 stays at 200K. Legacy Sonnet/Opus 4.5 and earlier remain 200K.)
+ *
+ * To refresh limits without code changes, set env vars or edit OVERRIDES below.
+ * Programmatic refresh path: Anthropic Models API exposes `max_input_tokens` per model.
+ */
+export interface ModelSpec {
+    contextWindow: number;
+    maxOutput: number;
+}
+/** Conservative default for completely unknown model IDs. */
+export declare const DEFAULT_SPEC: ModelSpec;
+/** Resolve the full spec (context window + max output) for a model ID. */
+export declare function getModelSpec(modelId: string): ModelSpec;
+/** Context window (input tokens) for a model ID. */
+export declare function getContextWindow(modelId: string): number;
+/** Max output tokens for a model ID. */
+export declare function getMaxOutput(modelId: string): number;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,eAAO,MAAM,YAAY,EAAE,SAAyD,CAAC;AAqDrF,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAuBvD;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/model-catalog.js

@@ -0,0 +1,102 @@
+/**
+ * Model catalog — single source of truth for per-model token limits.
+ *
+ * Promoted to `@esankhan3/anvil-agent-core` in Phase F1 of the dashboard
+ * pipeline-runner deprecation plan (`docs/dashboard-pipeline-deprecation-plan.md`).
+ * Lives next to the provider adapters because token limits are
+ * provider-shaped knowledge — same layer as which envelope each provider
+ * accepts. Cli + dashboard + future tooling all read from here.
+ *
+ * Resolution order (first match wins):
+ *   1. ENV override — `ANVIL_CONTEXT_WINDOW_<sanitized-model-id>` (e.g. `ANVIL_CONTEXT_WINDOW_CLAUDE_OPUS_4_7=1000000`)
+ *   2. Explicit override table — for models that diverge from their family defaults (legacy 200K variants)
+ *   3. Family rules — regex match on model ID, ordered from most specific to least
+ *   4. OpenRouter-style `org/model` — recurse on the model segment
+ *   5. Conservative DEFAULT
+ *
+ * Source: https://docs.claude.com/en/docs/about-claude/models/overview
+ * (Opus 4.7, Opus 4.6, and Sonnet 4.6 all ship with native 1M context windows;
+ * Haiku 4.5 stays at 200K. Legacy Sonnet/Opus 4.5 and earlier remain 200K.)
+ *
+ * To refresh limits without code changes, set env vars or edit OVERRIDES below.
+ * Programmatic refresh path: Anthropic Models API exposes `max_input_tokens` per model.
+ */
+/** Conservative default for completely unknown model IDs. */
+export const DEFAULT_SPEC = { contextWindow: 128_000, maxOutput: 16_000 };
+/**
+ * Exceptions to family rules. Only list a model here when it differs from its
+ * family default (e.g. a 200K legacy variant whose family now defaults to 1M).
+ */
+const OVERRIDES = {
+    // Legacy Claude models that kept 200K
+    'claude-sonnet-4-5': { contextWindow: 200_000, maxOutput: 64_000 },
+    'claude-sonnet-4-5-20250929': { contextWindow: 200_000, maxOutput: 64_000 },
+    'claude-opus-4-5': { contextWindow: 200_000, maxOutput: 64_000 },
+    'claude-opus-4-5-20251101': { contextWindow: 200_000, maxOutput: 64_000 },
+    'claude-opus-4-1': { contextWindow: 200_000, maxOutput: 32_000 },
+    'claude-opus-4-1-20250805': { contextWindow: 200_000, maxOutput: 32_000 },
+    'claude-sonnet-4-20250514': { contextWindow: 200_000, maxOutput: 64_000 },
+    'claude-opus-4-20250514': { contextWindow: 200_000, maxOutput: 32_000 },
+    'claude-3-5-sonnet': { contextWindow: 200_000, maxOutput: 8_000 },
+    'claude-3-opus': { contextWindow: 200_000, maxOutput: 4_000 },
+    'claude-3-haiku-20240307': { contextWindow: 200_000, maxOutput: 4_000 },
+};
+/**
+ * Family rules — tried in order. First match wins.
+ * Add new families here rather than enumerating individual model IDs.
+ */
+const FAMILY_RULES = [
+    // Claude Haiku (all versions): 200K — stayed at 200K through 4.5
+    { pattern: /(^|[^a-z])haiku/i, spec: { contextWindow: 200_000, maxOutput: 64_000 } },
+    // Claude Opus / Sonnet — current generation is 1M native (Opus 4.6+, Sonnet 4.6+, aliases)
+    // Covers: `opus`, `sonnet`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-sonnet-4-6`, `claude-opus-4-7[1m]`, etc.
+    { pattern: /^(claude-)?(opus|sonnet)(-|$|\[)/i, spec: { contextWindow: 1_000_000, maxOutput: 64_000 } },
+    { pattern: /^claude-(opus|sonnet)-/i, spec: { contextWindow: 1_000_000, maxOutput: 64_000 } },
+    // Catch-all for any other claude-* model — assume modern 1M, override above if legacy
+    { pattern: /^claude-/i, spec: { contextWindow: 1_000_000, maxOutput: 64_000 } },
+    // Gemini 2.x+ — 1M native
+    { pattern: /^gemini-[2-9]/i, spec: { contextWindow: 1_000_000, maxOutput: 64_000 } },
+    { pattern: /^gemini/i, spec: { contextWindow: 1_000_000, maxOutput: 32_000 } },
+    // OpenAI reasoning (o1, o3, o4...) — 200K
+    { pattern: /^o[1-9](-|$)/i, spec: { contextWindow: 200_000, maxOutput: 100_000 } },
+    // OpenAI GPT-4.x / 4o — 128K
+    { pattern: /^gpt-4/i, spec: { contextWindow: 128_000, maxOutput: 16_000 } },
+];
+/** Sanitize model ID into an env-var-safe key. */
+function envKeyFor(modelId) {
+    return `ANVIL_CONTEXT_WINDOW_${modelId.replace(/[^a-z0-9]/gi, '_').toUpperCase()}`;
+}
+/** Resolve the full spec (context window + max output) for a model ID. */
+export function getModelSpec(modelId) {
+    // 1. ENV override — operator tuning without redeploy
+    const envVal = process.env[envKeyFor(modelId)];
+    if (envVal) {
+        const n = parseInt(envVal, 10);
+        if (Number.isFinite(n) && n > 0)
+            return { ...DEFAULT_SPEC, contextWindow: n };
+    }
+    // 2. Explicit override for legacy variants
+    if (OVERRIDES[modelId])
+        return OVERRIDES[modelId];
+    // 3. Family rules
+    for (const { pattern, spec } of FAMILY_RULES) {
+        if (pattern.test(modelId))
+            return spec;
+    }
+    // 4. OpenRouter-style `org/model` — recurse on the model segment
+    if (modelId.includes('/')) {
+        const segment = modelId.split('/').slice(-1)[0];
+        if (segment && segment !== modelId)
+            return getModelSpec(segment);
+    }
+    return DEFAULT_SPEC;
+}
+/** Context window (input tokens) for a model ID. */
+export function getContextWindow(modelId) {
+    return getModelSpec(modelId).contextWindow;
+}
+/** Max output tokens for a model ID. */
+export function getMaxOutput(modelId) {
+    return getModelSpec(modelId).maxOutput;
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/model-catalog.js.map

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

package/dist/model-tier-resolver.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Dynamic model tier resolver — resolves model IDs from a discovery
+ * result instead of hardcoding them.
+ *
+ * Promoted to `@esankhan3/anvil-agent-core` in Phase F2 of the dashboard
+ * pipeline-runner deprecation plan (`docs/dashboard-pipeline-deprecation-plan.md`).
+ * Lives next to the provider adapters because tier-based routing is
+ * provider-shaped knowledge — same layer as `model-catalog`. The
+ * dashboard's discovery layer (`provider-registry.ts`, FS+exec heavy)
+ * stays in dashboard and produces values that satisfy this resolver's
+ * structural input types.
+ *
+ * Tier routing strategy defines which "weight class" each stage needs:
+ *   fast     → cheap model for most stages, balanced for build
+ *   balanced → mix of cheap and mid-range
+ *   thorough → mid-range for most, powerful for specs
+ *
+ * The resolver looks up the best available model for each weight class
+ * from the cached discovery result.
+ */
+/** Capability flags a discovered model may carry. */
+export type ResolverCapability = 'agentic' | 'chat' | 'embedding' | 'reranking';
+/** Per-model weight class. `'local'` is the zero-cost (Ollama) tier. */
+export type ResolverModelWeight = 'fast' | 'balanced' | 'powerful' | 'local';
+/** Minimum shape the resolver reads from each discovered model. */
+export interface ResolverModel {
+    id: string;
+    capabilities: ResolverCapability[];
+    tier?: ResolverModelWeight;
+}
+/** Minimum shape the resolver reads from a discovery result. */
+export interface ResolverDiscoveryResult {
+    models: ResolverModel[];
+}
+/**
+ * Dashboard-UI cost-tier vocabulary. Distinct from
+ * `router/model-registry.ts:ModelTier` (which uses the
+ * `'local' | 'cheap' | 'premium'` policy vocabulary). Renamed during
+ * Phase F2 to avoid a name collision when both types co-exist on the
+ * `@esankhan3/anvil-agent-core` public surface.
+ */
+export type ResolverTier = 'fast' | 'balanced' | 'thorough';
+/** @deprecated Use `ResolverTier`. Kept as an alias for back-compat. */
+export type ModelTier = ResolverTier;
+/**
+ * Provide the discovery result so the resolver can look up available models.
+ * Call this once after `discoverProviders()` completes.
+ */
+export declare function setDiscoveryResult(result: ResolverDiscoveryResult): void;
+/**
+ * Resolve the model ID for a given tier + stage combination.
+ * Uses the provider registry to find the best available model dynamically.
+ *
+ * @param tier - User-selected cost tier (fast/balanced/thorough)
+ * @param stageName - Pipeline stage name (clarify, build, etc.)
+ * @param fallbackModel - Model to use if registry lookup fails
+ */
+export declare function resolveModelByTier(tier: ResolverTier, stageName: string, fallbackModel: string): string;
+/** Invalidate the resolver cache (e.g., after provider changes) */
+export declare function invalidateResolverCache(): void;
+//# sourceMappingURL=model-tier-resolver.d.ts.map

package/dist/model-tier-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-tier-resolver.d.ts","sourceRoot":"","sources":["../src/model-tier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhF,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC;AA4DrC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAKxE;AA2CD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CA0CR;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}