@esankhan3/anvil-agent-core 0.1.0

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * @esankhan3/anvil-agent-core — public barrel.
+ *
+ * What lives here today (Phase 1):
+ *   - Shared LLM types: `LanguageModel`, `ModelAdapter`, `ProviderName`,
+ *     `ProviderTier`, `StreamEvent`, `InvokeResult`, etc.
+ *   - VERSION constant.
+ *
+ * What will land in subsequent phases:
+ *   - Phase 2: stream-format types (NDJSON event shapes)
+ *   - Phase 3: ProviderRegistry singleton
+ *   - Phase 4: 7 provider adapters
+ *   - Phase 5: single-shot wrapper (runLLM / runClaude / runGemini)
+ *   - Phase 6: agent subprocess machinery (AgentManager, spawn, etc.)
+ *   - Phase 7: cost table loader
+ */
+export * from './types.js';
+export * from './stream-format.js';
+export * from './registry.js';
+export { ClaudeAdapter } from './claude-adapter.js';
+export { OpenAIAdapter } from './openai-adapter.js';
+export { GeminiAdapter } from './gemini-adapter.js';
+export { OpenRouterAdapter } from './openrouter-adapter.js';
+export { OllamaAdapter } from './ollama-adapter.js';
+export { GeminiCliAdapter } from './gemini-cli-adapter.js';
+export { AdkAdapter } from './adk-adapter.js';
+export { OpenCodeAdapter } from './opencode-adapter.js';
+export { FallbackAdapter } from './fallback-adapter.js';
+export * from './single-shot.js';
+export * from './agent/index.js';
+export * from './checkpoint/index.js';
+export * from './cost.js';
+export * from './telemetry/index.js';
+export * from './skills/index.js';
+export * from './mcp/index.js';
+export * from './router/index.js';
+export * from './tools/index.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `McpAgentClient` — wraps the official MCP TypeScript SDK with the lifecycle
+ * Anvil's agent layer needs (lazy connect, tool listing with namespacing,
+ * tool dispatch, clean close).
+ *
+ * One instance per configured MCP server. The agent's tool-call loop owns
+ * close() so subprocesses don't leak between invocations.
+ */
+import type { ToolSchema } from '../types.js';
+import type { McpServerConfig } from './types.js';
+export declare class McpAgentClient {
+    readonly config: McpServerConfig;
+    private client;
+    private connected;
+    constructor(config: McpServerConfig);
+    connect(): Promise<void>;
+    /**
+     * Returns the server's tools, namespaced as `<serverName>/<toolName>` so
+     * multiple MCP servers exposing identically-named tools don't collide in
+     * the agent's flat tool registry.
+     */
+    listTools(): Promise<ToolSchema[]>;
+    /**
+     * Dispatch a tool call. Accepts either the namespaced form
+     * (`<server>/<tool>`) or the bare tool name; strips the server prefix
+     * before forwarding to the SDK.
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBAAa,cAAc;aAIG,MAAM,EAAE,eAAe;IAHnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEE,MAAM,EAAE,eAAe;IAO7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAUxC;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAW3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,WAAW,IAAI,OAAO;CAGvB"}

package/dist/mcp/client.js

@@ -0,0 +1,92 @@
+/**
+ * `McpAgentClient` — wraps the official MCP TypeScript SDK with the lifecycle
+ * Anvil's agent layer needs (lazy connect, tool listing with namespacing,
+ * tool dispatch, clean close).
+ *
+ * One instance per configured MCP server. The agent's tool-call loop owns
+ * close() so subprocesses don't leak between invocations.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { VERSION } from '../version.js';
+const CLIENT_NAME = 'anvil-agent';
+export class McpAgentClient {
+    config;
+    client;
+    connected = false;
+    constructor(config) {
+        this.config = config;
+        this.client = new Client({ name: CLIENT_NAME, version: VERSION }, { capabilities: {} });
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        if (this.config.transport === 'stdio') {
+            if (!this.config.command) {
+                throw new Error(`MCP server "${this.config.name}" has stdio transport but no command`);
+            }
+            const transport = new StdioClientTransport({
+                command: this.config.command,
+                args: this.config.args ?? [],
+                env: this.config.env,
+            });
+            await this.client.connect(transport);
+        }
+        else {
+            if (!this.config.url) {
+                throw new Error(`MCP server "${this.config.name}" has streamable-http transport but no url`);
+            }
+            const transport = new StreamableHTTPClientTransport(new URL(this.config.url), {
+                requestInit: { headers: this.config.headers },
+            });
+            await this.client.connect(transport);
+        }
+        this.connected = true;
+    }
+    /**
+     * Returns the server's tools, namespaced as `<serverName>/<toolName>` so
+     * multiple MCP servers exposing identically-named tools don't collide in
+     * the agent's flat tool registry.
+     */
+    async listTools() {
+        if (!this.connected)
+            await this.connect();
+        const result = await this.client.listTools();
+        return result.tools.map((t) => ({
+            name: `${this.config.name}/${t.name}`,
+            description: t.description ?? '',
+            inputSchema: t.inputSchema ?? {},
+        }));
+    }
+    /**
+     * Dispatch a tool call. Accepts either the namespaced form
+     * (`<server>/<tool>`) or the bare tool name; strips the server prefix
+     * before forwarding to the SDK.
+     */
+    async callTool(toolName, args) {
+        if (!this.connected)
+            await this.connect();
+        const prefix = `${this.config.name}/`;
+        const stripped = toolName.startsWith(prefix) ? toolName.slice(prefix.length) : toolName;
+        const result = await this.client.callTool({
+            name: stripped,
+            arguments: args,
+        });
+        return result;
+    }
+    async close() {
+        if (!this.connected)
+            return;
+        try {
+            await this.client.close();
+        }
+        finally {
+            this.connected = false;
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/mcp/client.js.map

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

package/dist/mcp/config-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `mcp.json` discovery + parsing.
+ *
+ * Search order (locked in ADR §4.3):
+ *   1. process.env.ANVIL_MCP_CONFIG (full path)
+ *   2. <workspaceRoot>/mcp.json
+ *   3. <workspaceRoot>/.mcp/servers.json
+ *   4. <workspaceRoot>/.claude/mcp.json
+ *   5. $HOME/.claude/mcp.json
+ *
+ * The first existing file wins; configs do not merge.
+ *
+ * Each entry's transport is inferred from shape (`command` → stdio,
+ * `url` → streamable-http). Entries with both or neither are dropped with a
+ * stderr warning.
+ *
+ * `${env:VAR}` substitutions in env/headers values are expanded against
+ * `process.env` (or the provided env override).
+ */
+import type { McpServerConfig } from './types.js';
+export interface LoadMcpServersOptions {
+    /** Absolute workspace root used for ranks 2–4. */
+    workspaceRoot?: string;
+    /** Override `process.env`; supports both `ANVIL_MCP_CONFIG` and `${env:VAR}` substitution. */
+    env?: NodeJS.ProcessEnv;
+    /** Override `$HOME` (test seam). */
+    homeDir?: string;
+}
+/** Returns the path of the canonical `mcp.json` for the workspace, or undefined. */
+export declare function findMcpConfigPath(opts?: LoadMcpServersOptions): string | undefined;
+/**
+ * Read and parse the `mcp.json` for `workspaceRoot`. Returns `[]` when no
+ * config is found (graceful no-op for projects without MCP).
+ */
+export declare function loadMcpServers(opts?: LoadMcpServersOptions): McpServerConfig[];
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/mcp/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/mcp/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,GAAG,SAAS,CAmBtF;AAuDD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,eAAe,EAAE,CA+ClF"}

package/dist/mcp/config-loader.js

@@ -0,0 +1,129 @@
+/**
+ * `mcp.json` discovery + parsing.
+ *
+ * Search order (locked in ADR §4.3):
+ *   1. process.env.ANVIL_MCP_CONFIG (full path)
+ *   2. <workspaceRoot>/mcp.json
+ *   3. <workspaceRoot>/.mcp/servers.json
+ *   4. <workspaceRoot>/.claude/mcp.json
+ *   5. $HOME/.claude/mcp.json
+ *
+ * The first existing file wins; configs do not merge.
+ *
+ * Each entry's transport is inferred from shape (`command` → stdio,
+ * `url` → streamable-http). Entries with both or neither are dropped with a
+ * stderr warning.
+ *
+ * `${env:VAR}` substitutions in env/headers values are expanded against
+ * `process.env` (or the provided env override).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/** Returns the path of the canonical `mcp.json` for the workspace, or undefined. */
+export function findMcpConfigPath(opts = {}) {
+    const env = opts.env ?? process.env;
+    const home = opts.homeDir ?? homedir();
+    const candidates = [];
+    if (env.ANVIL_MCP_CONFIG)
+        candidates.push(env.ANVIL_MCP_CONFIG);
+    if (opts.workspaceRoot) {
+        candidates.push(join(opts.workspaceRoot, 'mcp.json'), join(opts.workspaceRoot, '.mcp', 'servers.json'), join(opts.workspaceRoot, '.claude', 'mcp.json'));
+    }
+    candidates.push(join(home, '.claude', 'mcp.json'));
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return undefined;
+}
+const ENV_VAR_RE = /\$\{env:([A-Z_][A-Z0-9_]*)\}/g;
+function substituteEnvVars(value, env, fieldDesc, warn) {
+    return value.replace(ENV_VAR_RE, (_match, name) => {
+        const v = env[name];
+        if (v === undefined || v === '') {
+            warn(`[anvil-mcp] WARN: env var \${env:${name}} unset — ${fieldDesc} resolves to empty`);
+            return '';
+        }
+        return v;
+    });
+}
+function expandEntryStrings(obj, env, fieldDesc, warn) {
+    if (!obj)
+        return undefined;
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (typeof v !== 'string') {
+            warn(`[anvil-mcp] WARN: ${fieldDesc}.${k} is not a string; skipping`);
+            continue;
+        }
+        out[k] = substituteEnvVars(v, env, `${fieldDesc}.${k}`, warn);
+    }
+    return out;
+}
+function inferTransport(entry, name, warn) {
+    const hasCmd = typeof entry.command === 'string' && entry.command.length > 0;
+    const hasUrl = typeof entry.url === 'string' && entry.url.length > 0;
+    if (hasCmd && hasUrl) {
+        warn(`[anvil-mcp] WARN: server "${name}" has both command and url; dropping`);
+        return undefined;
+    }
+    if (hasCmd)
+        return 'stdio';
+    if (hasUrl)
+        return 'streamable-http';
+    warn(`[anvil-mcp] WARN: server "${name}" has neither command nor url; dropping`);
+    return undefined;
+}
+/**
+ * Read and parse the `mcp.json` for `workspaceRoot`. Returns `[]` when no
+ * config is found (graceful no-op for projects without MCP).
+ */
+export function loadMcpServers(opts = {}) {
+    const env = opts.env ?? process.env;
+    const path = findMcpConfigPath({ ...opts, env });
+    if (!path)
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch (err) {
+        process.stderr.write(`[anvil-mcp] WARN: cannot read ${path}: ${err.message}\n`);
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`[anvil-mcp] WARN: ${path} is not valid JSON: ${err.message}\n`);
+        return [];
+    }
+    if (!parsed.mcpServers || typeof parsed.mcpServers !== 'object') {
+        process.stderr.write(`[anvil-mcp] WARN: ${path} missing top-level "mcpServers" object\n`);
+        return [];
+    }
+    const warn = (msg) => process.stderr.write(msg + '\n');
+    const out = [];
+    for (const [name, entry] of Object.entries(parsed.mcpServers)) {
+        if (!entry || typeof entry !== 'object') {
+            warn(`[anvil-mcp] WARN: server "${name}" entry is not an object; dropping`);
+            continue;
+        }
+        const transport = inferTransport(entry, name, warn);
+        if (!transport)
+            continue;
+        out.push({
+            name,
+            transport,
+            command: entry.command,
+            args: Array.isArray(entry.args) ? [...entry.args] : undefined,
+            env: expandEntryStrings(entry.env, env, `mcpServers.${name}.env`, warn),
+            url: entry.url,
+            headers: expandEntryStrings(entry.headers, env, `mcpServers.${name}.headers`, warn),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/mcp/config-loader.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @esankhan3/anvil-agent-core/mcp — Model Context Protocol *client*-side helpers.
+ *
+ * Companion to `code-search-mcp` (which is the MCP *server* Anvil already
+ * publishes). The client side lets Anvil's agent connect to OTHER MCP
+ * servers configured per project.
+ */
+export type { McpTransport, McpServerConfig, McpServerEntry, McpServersFile, } from './types.js';
+export { loadMcpServers, findMcpConfigPath, type LoadMcpServersOptions, } from './config-loader.js';
+export { McpAgentClient } from './client.js';
+export { buildAgentToolset, type AgentToolset, } from './tool-merger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,11 @@
+/**
+ * @esankhan3/anvil-agent-core/mcp — Model Context Protocol *client*-side helpers.
+ *
+ * Companion to `code-search-mcp` (which is the MCP *server* Anvil already
+ * publishes). The client side lets Anvil's agent connect to OTHER MCP
+ * servers configured per project.
+ */
+export { loadMcpServers, findMcpConfigPath, } from './config-loader.js';
+export { McpAgentClient } from './client.js';
+export { buildAgentToolset, } from './tool-merger.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,iBAAiB,GAElB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * `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`.
+ */
+import type { ToolSchema } from '../types.js';
+import type { McpAgentClient } from './client.js';
+export interface AgentToolset {
+    /** Flat list of tools to pass to `LanguageModel.invokeStream({ tools })`. */
+    tools: ToolSchema[];
+    /** Maps namespaced tool name to the MCP client that owns it. */
+    mcpDispatch: Map<string, McpAgentClient>;
+}
+export declare function buildAgentToolset(builtIn: ToolSchema[], mcpClients: McpAgentClient[]): Promise<AgentToolset>;
+//# sourceMappingURL=tool-merger.d.ts.map

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

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

package/dist/mcp/tool-merger.js

@@ -0,0 +1,34 @@
+/**
+ * `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;
+        try {
+            mcpTools = 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`);
+                continue;
+            }
+            tools.push(t);
+            mcpDispatch.set(t.name, client);
+            seen.add(t.name);
+        }
+    }
+    return { tools, mcpDispatch };
+}
+//# sourceMappingURL=tool-merger.js.map

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

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MCP client types — agent-layer abstractions over the official SDK's
+ * stdio/streamable-http transports.
+ *
+ * See AGENT-HARNESS-ADR.md §4 for the locked mcp.json schema. Transport is
+ * inferred from shape: `command` present → 'stdio'; `url` present →
+ * 'streamable-http'; never both.
+ */
+export type McpTransport = 'stdio' | 'streamable-http';
+export interface McpServerConfig {
+    /** Logical name of the server (used to namespace tools as `<name>/<tool>`). */
+    name: string;
+    /** Inferred from {command, url} presence at parse time. */
+    transport: McpTransport;
+    /** stdio: spawn `command args[]` with `env`. */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** streamable-http: POST to `url` with `headers`. */
+    url?: string;
+    headers?: Record<string, string>;
+}
+/** Raw shape of an `mcp.json` file. */
+export interface McpServersFile {
+    mcpServers: Record<string, McpServerEntry>;
+}
+/** Raw shape of one entry inside `mcpServers`. */
+export interface McpServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,iBAAiB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,SAAS,EAAE,YAAY,CAAC;IACxB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/mcp/types.js

@@ -0,0 +1,10 @@
+/**
+ * MCP client types — agent-layer abstractions over the official SDK's
+ * stdio/streamable-http transports.
+ *
+ * See AGENT-HARNESS-ADR.md §4 for the locked mcp.json schema. Transport is
+ * inferred from shape: `command` present → 'stdio'; `url` present →
+ * 'streamable-http'; never both.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/ollama-adapter.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Ollama adapter — HTTP API for local Ollama server, no npm dependencies.
+ *
+ * Base URL: OLLAMA_HOST env var or http://localhost:11434
+ * Streaming: NDJSON (not SSE) from POST /api/chat
+ *
+ * Two modes, picked at runtime by the presence of `config.toolExecutor`:
+ *
+ *   1. Single-shot chat — no tool executor. Drains one /api/chat
+ *      response, emits text + result. Backwards-compatible with every
+ *      caller that existed before agentic support landed.
+ *
+ *   2. Agentic loop — tool executor present. Each turn the adapter
+ *      sends `tools: [...]` (OpenAI-compatible JSON Schema), parses
+ *      `message.tool_calls` from the response, executes each call via
+ *      the executor, appends the assistant + tool messages to history,
+ *      and re-POSTs. Loops until the model returns no tool_calls or
+ *      the `maxToolIterations` cap fires.
+ *
+ * Capabilities flip to `tier: 'agentic'` because the adapter now drives
+ * a full agentic loop. Stage-policy.yaml's build/validate/ship preferences
+ * for `local` are real — the adapter can hold its end of those stages.
+ */
+import type { ModelAdapter, ModelAdapterConfig, ModelAdapterResult, ProviderCapabilities } from './types.js';
+import { LocalExecutor } from './router/local-executor.js';
+/** Thrown when the conversation history can't be trimmed below num_ctx
+ *  (e.g. one tool result alone exceeds the window). The dashboard
+ *  resolver catches this and re-runs the stage with an escalation chain
+ *  that skips local. */
+export declare class ContextExhaustedError extends Error {
+    readonly model: string;
+    readonly numCtx: number;
+    readonly historyTokens: number;
+    constructor(model: string, numCtx: number, historyTokens: number);
+}
+interface OllamaToolCall {
+    function: {
+        name: string;
+        arguments: Record<string, unknown> | string;
+    };
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: OllamaToolCall[];
+    tool_call_id?: string;
+}
+export declare class OllamaAdapter implements ModelAdapter {
+    private readonly executor;
+    readonly provider: "ollama";
+    readonly capabilities: ProviderCapabilities;
+    /**
+     * In-flight AbortControllers — one per concurrent run() invocation.
+     * The adapter is a singleton, but per-repo stages (build/validate/
+     * specs/tasks) run multiple repos in parallel against it. A single
+     * instance-level field would let one call's `finally` block null out
+     * the controller while another is still mid-fetch, causing
+     * "Cannot read properties of null (reading 'signal')". The Set lets
+     * concurrent calls each own their own controller; kill() aborts all.
+     */
+    private activeControllers;
+    /**
+     * @param executor — Single-slot FIFO queue used when a call sets
+     * `config.exclusiveSlot === true`. Defaults to the process-wide
+     * singleton; tests inject a fresh instance for isolation.
+     */
+    constructor(executor?: LocalExecutor);
+    supportsModel(_modelId: string): boolean;
+    getModelPricing(_modelId: string): [number, number] | null;
+    checkAvailability(): Promise<{
+        available: boolean;
+        version?: string;
+        error?: string;
+    }>;
+    kill(): void;
+    run(config: ModelAdapterConfig, output: NodeJS.WritableStream): Promise<ModelAdapterResult>;
+    private runInner;
+    /**
+     * One round-trip with Ollama: send messages + tools, drain the NDJSON
+     * stream, return the assistant's text accumulator + any tool_calls
+     * the model emitted in the final chunk.
+     */
+    private runOneTurn;
+}
+/**
+ * Drop the oldest tool-role messages until the history fits below
+ * SOFT_TRIM_RATIO × numCtx. Keeps system + user prompts intact (they
+ * carry the original task framing) and keeps the most recent turns
+ * intact (where the active state of the loop lives). If we can't trim
+ * enough — e.g. a single tool_result is bigger than the window —
+ * escalate via ContextExhaustedError.
+ */
+export declare function trimHistoryIfNeeded(messages: ChatMessage[], numCtx: number, model: string): void;
+export {};
+//# sourceMappingURL=ollama-adapter.d.ts.map

package/dist/ollama-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-adapter.d.ts","sourceRoot":"","sources":["../src/ollama-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EAIrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAiB,MAAM,4BAA4B,CAAC;AAmB1E;;;wBAGwB;AACxB,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBACnB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUjE;AAuBD,UAAU,cAAc;IACtB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;KAC7C,CAAC;CACH;AAWD,UAAU,WAAW;IACnB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,aAAc,YAAW,YAAY;IA+BpC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA9BrC,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IAEtC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAUzC;IAEF;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB,CAA8B;IAEvD;;;;OAIG;gBAC0B,QAAQ,GAAE,aAA6B;IAEpE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpD,iBAAiB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAY5F,IAAI,IAAI,IAAI;IAON,GAAG,CACP,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,OAAO,CAAC,kBAAkB,CAAC;YAOhB,QAAQ;IAsGtB;;;;OAIG;YACW,UAAU;CAuGzB;AAwED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN"}