@esankhan3/anvil-agent-core 0.1.0

package/dist/claude-adapter.js

@@ -0,0 +1,233 @@
+/**
+ * Claude CLI ModelAdapter.
+ *
+ * The simplest adapter — Claude CLI already outputs Anvil Stream Format
+ * natively (`--output-format stream-json`), so we just pipe stdout through
+ * with zero transformation.
+ */
+import { spawn, execSync } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { UpstreamError, synthesizeStatusFromCli } from './upstream-error.js';
+// ---------------------------------------------------------------------------
+// Pricing table — [inputPer1M, outputPer1M]
+// ---------------------------------------------------------------------------
+const PRICING = {
+    sonnet: [3.0, 15.0],
+    opus: [15.0, 75.0],
+    haiku: [0.25, 1.25],
+};
+function pricingKeyFromModel(modelId) {
+    const lower = modelId.toLowerCase();
+    for (const key of Object.keys(PRICING)) {
+        if (lower.includes(key))
+            return key;
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Binary resolution
+// ---------------------------------------------------------------------------
+function resolveBinary() {
+    return (process.env.ANVIL_AGENT_CMD ??
+        process.env.FF_AGENT_CMD ??
+        process.env.CLAUDE_BIN ??
+        'claude');
+}
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export class ClaudeAdapter {
+    provider = 'claude';
+    capabilities = {
+        tier: 'agentic',
+        streaming: true,
+        toolUse: true,
+        fileSystem: true,
+        shellExecution: true,
+        sessionResume: true,
+        promptCaching: true,
+        cache: 'explicit',
+        cacheTtlSeconds: 300,
+        structuredOutput: 'tool-shim',
+        // Claude CLI doesn't expose a max-tokens flag today; bridges/router callers
+        // may pass it but the adapter ignores it.
+        maxOutputTokens: false,
+    };
+    child = null;
+    supportsModel(modelId) {
+        const lower = modelId.toLowerCase();
+        return (lower.startsWith('claude-') ||
+            lower.includes('sonnet') ||
+            lower.includes('opus') ||
+            lower.includes('haiku'));
+    }
+    getModelPricing(modelId) {
+        const key = pricingKeyFromModel(modelId);
+        return key ? PRICING[key] : null;
+    }
+    async checkAvailability() {
+        try {
+            const bin = resolveBinary();
+            const version = execSync(`${bin} --version`, { encoding: 'utf-8', timeout: 10_000 }).trim();
+            return { available: true, version };
+        }
+        catch (err) {
+            return { available: false, error: err.message };
+        }
+    }
+    async run(config, output) {
+        const bin = resolveBinary();
+        const startTime = Date.now();
+        // ---- Build args -------------------------------------------------------
+        const args = [
+            '-p', config.userPrompt,
+            '--output-format', 'stream-json',
+            '--verbose',
+        ];
+        if (config.projectPrompt) {
+            // Claude CLI's flag is --system-prompt (replaces default) or
+            // --append-system-prompt (extends default). The legacy
+            // single-shot.ts uses --system-prompt. We follow that convention
+            // since the dashboard's projectPrompt is a full persona prompt.
+            args.push('--system-prompt', config.projectPrompt);
+        }
+        if (config.model) {
+            args.push('--model', config.model);
+        }
+        // Claude CLI: --session-id starts a NEW session with that UUID;
+        // --resume <id> continues an existing one. The two flags are mutually
+        // exclusive — passing both makes the CLI exit non-zero immediately.
+        if (config.resume && config.sessionId) {
+            args.push('--resume', config.sessionId);
+        }
+        else if (config.sessionId) {
+            args.push('--session-id', config.sessionId);
+        }
+        else if (config.resume) {
+            args.push('--resume');
+        }
+        if (config.permissionMode) {
+            args.push('--permission-mode', config.permissionMode);
+        }
+        if (config.allowedTools?.length) {
+            args.push('--allowedTools', config.allowedTools.join(','));
+        }
+        if (config.disallowedTools?.length) {
+            args.push('--disallowedTools', config.disallowedTools.join(','));
+        }
+        if (config.mcpConfigPath) {
+            // Claude CLI: --mcp-config points at an mcp.json that claude-cli
+            // reads to bootstrap MCP server connections. defaultAdapterFactory
+            // resolves the path from the spawn's workspaceDir.
+            args.push('--mcp-config', config.mcpConfigPath);
+        }
+        // ---- Spawn ------------------------------------------------------------
+        const child = spawn(bin, args, {
+            cwd: config.workingDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.child = child;
+        // End stdin immediately — prompt is passed via args
+        child.stdin.end();
+        // Forward stderr to process.stderr while ALSO buffering it so we
+        // can scan for retryable upstream conditions (rate-limit, quota,
+        // overload) on a non-zero exit. Capped to 16 KB to avoid blowing
+        // memory on a chatty failure.
+        let stderrBuf = '';
+        const STDERR_CAP = 16 * 1024;
+        child.stderr.on('data', (chunk) => {
+            process.stderr.write(chunk);
+            if (stderrBuf.length < STDERR_CAP) {
+                stderrBuf += chunk.toString('utf8').slice(0, STDERR_CAP - stderrBuf.length);
+            }
+        });
+        // ---- Pipe stdout & capture result in parallel -------------------------
+        let resultMsg = null;
+        let fullOutput = '';
+        let toolCallCount = 0;
+        // Anthropic stream-json stamps stop_reason on the assistant frame, not
+        // the result frame, so we cache the most recent one and surface it on
+        // ModelAdapterResult below.
+        let lastStopReason;
+        // We read stdout line-by-line to capture the result message while also
+        // piping every line to the output writable unchanged.
+        const rl = createInterface({ input: child.stdout, crlfDelay: Infinity });
+        rl.on('line', (line) => {
+            // Pipe through unchanged
+            output.write(line + '\n');
+            // Try to parse the result message
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.type === 'result') {
+                    resultMsg = parsed;
+                    fullOutput = parsed.result ?? '';
+                }
+                else if (parsed.type === 'assistant' && Array.isArray(parsed.message?.content)) {
+                    // Count tool_use blocks for telemetry; pure-pipe semantics preserved.
+                    for (const block of parsed.message.content) {
+                        if (block?.type === 'tool_use')
+                            toolCallCount += 1;
+                    }
+                    if (typeof parsed.message?.stop_reason === 'string') {
+                        lastStopReason = parsed.message.stop_reason;
+                    }
+                }
+            }
+            catch {
+                // Not JSON — pass through silently
+            }
+        });
+        // ---- Wait for exit ----------------------------------------------------
+        const exitCode = await new Promise((resolve, reject) => {
+            child.on('close', (code) => resolve(code ?? 0));
+            child.on('error', reject);
+        });
+        this.child = null;
+        const durationMs = Date.now() - startTime;
+        if (exitCode !== 0 && !resultMsg) {
+            // Try to classify the failure from stderr so the dashboard's
+            // chain-fallback can hop to another provider on a quota/rate-limit
+            // hit instead of dying. Anthropic's CLI surfaces these as
+            // "rate_limit_error", "overloaded_error", "Credit balance is too
+            // low", or HTTP-style status numbers in the stderr body.
+            const synth = synthesizeStatusFromCli(stderrBuf);
+            if (synth) {
+                throw new UpstreamError(synth.status, stderrBuf || `Claude CLI exited with code ${exitCode}`, {
+                    provider: 'claude',
+                    retryable: synth.retryable,
+                });
+            }
+            throw new Error(`Claude CLI exited with code ${exitCode}${stderrBuf ? `\n${stderrBuf.slice(0, 400)}` : ''}`);
+        }
+        // ---- Build result -----------------------------------------------------
+        const pricing = this.getModelPricing(config.model) ?? [3.0, 15.0];
+        const rm = resultMsg;
+        const inputTokens = rm?.usage?.input_tokens ?? 0;
+        const outputTokens = rm?.usage?.output_tokens ?? 0;
+        const cacheReadTokens = rm?.usage?.cache_read_input_tokens ?? 0;
+        const cacheWriteTokens = rm?.usage?.cache_creation_input_tokens ?? 0;
+        const costUsd = rm?.total_cost_usd ??
+            (inputTokens * pricing[0] + outputTokens * pricing[1]) / 1_000_000;
+        return {
+            output: fullOutput,
+            inputTokens,
+            outputTokens,
+            costUsd,
+            durationMs,
+            sessionId: rm?.session_id,
+            provider: 'claude',
+            model: config.model,
+            cacheReadTokens,
+            cacheWriteTokens,
+            toolCallCount,
+            stopReason: lastStopReason,
+        };
+    }
+    kill() {
+        if (this.child && !this.child.killed) {
+            this.child.kill('SIGTERM');
+            this.child = null;
+        }
+    }
+}
+//# sourceMappingURL=claude-adapter.js.map

package/dist/claude-adapter.js.map

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

package/dist/cost.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Central cost calculator — backed by a vendored snapshot of LiteLLM's
+ * `model_prices_and_context_window.json` (Apache-2.0).
+ *
+ * The snapshot lives at `data/model-prices.json` (committed). Refresh via
+ * `node scripts/refresh-cost-table.mjs` (quarterly + on adding new models).
+ *
+ * LiteLLM's keys use full versioned model IDs (e.g. `claude-3-5-sonnet-20241022`).
+ * Anvil's adapter PRICING tables historically use short canonical names
+ * (`sonnet`, `opus`, `haiku`). The `MODEL_ALIASES` table below bridges the
+ * two — short name → LiteLLM key. When the loader fails on the literal model
+ * ID, it falls back to the alias table.
+ *
+ * Pricing units in this module:
+ *   input_cost_per_token / output_cost_per_token from LiteLLM are PER-TOKEN.
+ *   We convert to PER-1M-TOKENS to match the existing ModelAdapter contract
+ *   (`getModelPricing(modelId): [number, number] | null` where the tuple is
+ *   `[inputPer1M, outputPer1M]`).
+ */
+/**
+ * Look up a model in the cost table.
+ *
+ * @returns `[inputPer1M, outputPer1M]` in USD, or `null` if the model is
+ *   unknown. Cache pricing is intentionally NOT exposed via this surface —
+ *   use `getDetailedPricing` for that.
+ */
+export declare function getModelPricing(model: string): [number, number] | null;
+export interface DetailedPricing {
+    inputPer1M: number;
+    outputPer1M: number;
+    cacheReadPer1M?: number;
+    cacheWritePer1M?: number;
+    maxInputTokens?: number;
+    maxOutputTokens?: number;
+}
+/** Detailed pricing including cache columns + context-window limits. */
+export declare function getDetailedPricing(model: string): DetailedPricing | null;
+export interface UsageInput {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface CostBreakdown {
+    totalUsd: number;
+    inputUsd: number;
+    outputUsd: number;
+    cacheReadUsd: number;
+    cacheWriteUsd: number;
+}
+/**
+ * Compute a per-component cost breakdown.
+ *
+ * Returns all-zero values when the model isn't in the cost table — caller
+ * decides whether to fall back to an adapter-supplied cost (the existing
+ * legacy path). Cache components are zero when either the usage doesn't
+ * include cache tokens or the pricing entry doesn't list a cache rate.
+ */
+export declare function calculateCostBreakdown(model: string, usage: UsageInput): CostBreakdown;
+/**
+ * Compute USD cost for a usage block at the given model's pricing.
+ * Returns 0 if the model is unknown.
+ */
+export declare function calculateCost(model: string, usage: UsageInput): number;
+/** Test seam — clear the in-memory cache. */
+export declare function resetCostTable(): void;
+//# sourceMappingURL=cost.d.ts.map

package/dist/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAyDH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAMtE;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiBxE;AAoBD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,CAoBtF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAEtE;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/cost.js

@@ -0,0 +1,148 @@
+/**
+ * Central cost calculator — backed by a vendored snapshot of LiteLLM's
+ * `model_prices_and_context_window.json` (Apache-2.0).
+ *
+ * The snapshot lives at `data/model-prices.json` (committed). Refresh via
+ * `node scripts/refresh-cost-table.mjs` (quarterly + on adding new models).
+ *
+ * LiteLLM's keys use full versioned model IDs (e.g. `claude-3-5-sonnet-20241022`).
+ * Anvil's adapter PRICING tables historically use short canonical names
+ * (`sonnet`, `opus`, `haiku`). The `MODEL_ALIASES` table below bridges the
+ * two — short name → LiteLLM key. When the loader fails on the literal model
+ * ID, it falls back to the alias table.
+ *
+ * Pricing units in this module:
+ *   input_cost_per_token / output_cost_per_token from LiteLLM are PER-TOKEN.
+ *   We convert to PER-1M-TOKENS to match the existing ModelAdapter contract
+ *   (`getModelPricing(modelId): [number, number] | null` where the tuple is
+ *   `[inputPer1M, outputPer1M]`).
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PRICES_PATH = join(__dirname, 'data', 'model-prices.json');
+let _modelPrices = null;
+function loadModelPrices() {
+    if (_modelPrices)
+        return _modelPrices;
+    try {
+        _modelPrices = JSON.parse(readFileSync(PRICES_PATH, 'utf-8'));
+    }
+    catch (err) {
+        process.stderr.write(`[anvil-cost] WARNING: failed to load model-prices.json from ${PRICES_PATH}: ` +
+            `${err.message}. Cost calculations will return 0.\n`);
+        _modelPrices = {};
+    }
+    return _modelPrices;
+}
+// ── Anvil short-name → LiteLLM canonical-name aliases ─────────────────────
+/**
+ * Bridge table — maps Anvil's short canonical model names (used in
+ * `model-router.ts` and adapter PRICING tables) to specific LiteLLM keys.
+ * Conservative: each short name resolves to a stable, recent flagship version.
+ * Refresh in lockstep with the cost-table snapshot when new flagships ship.
+ */
+const MODEL_ALIASES = {
+    // Anthropic short names
+    'sonnet': 'claude-sonnet-4-6',
+    'opus': 'claude-opus-4-7',
+    'haiku': 'claude-haiku-4-5',
+    'claude-sonnet-4': 'claude-sonnet-4-6',
+    'claude-opus-4': 'claude-opus-4-7',
+    'claude-haiku-4': 'claude-haiku-4-5',
+};
+// ── Lookup ────────────────────────────────────────────────────────────────
+/**
+ * Look up a model in the cost table.
+ *
+ * @returns `[inputPer1M, outputPer1M]` in USD, or `null` if the model is
+ *   unknown. Cache pricing is intentionally NOT exposed via this surface —
+ *   use `getDetailedPricing` for that.
+ */
+export function getModelPricing(model) {
+    const entry = lookupEntry(model);
+    if (!entry || typeof entry.input_cost_per_token !== 'number' || typeof entry.output_cost_per_token !== 'number') {
+        return null;
+    }
+    return [entry.input_cost_per_token * 1_000_000, entry.output_cost_per_token * 1_000_000];
+}
+/** Detailed pricing including cache columns + context-window limits. */
+export function getDetailedPricing(model) {
+    const entry = lookupEntry(model);
+    if (!entry || typeof entry.input_cost_per_token !== 'number' || typeof entry.output_cost_per_token !== 'number') {
+        return null;
+    }
+    return {
+        inputPer1M: entry.input_cost_per_token * 1_000_000,
+        outputPer1M: entry.output_cost_per_token * 1_000_000,
+        cacheReadPer1M: entry.cache_read_input_token_cost !== undefined
+            ? entry.cache_read_input_token_cost * 1_000_000
+            : undefined,
+        cacheWritePer1M: entry.cache_creation_input_token_cost !== undefined
+            ? entry.cache_creation_input_token_cost * 1_000_000
+            : undefined,
+        maxInputTokens: entry.max_input_tokens,
+        maxOutputTokens: entry.max_output_tokens,
+    };
+}
+function lookupEntry(model) {
+    const prices = loadModelPrices();
+    // 1. Exact match.
+    if (prices[model])
+        return prices[model];
+    // 2. Alias bridge.
+    const aliased = MODEL_ALIASES[model.toLowerCase()];
+    if (aliased && prices[aliased])
+        return prices[aliased];
+    // 3. Substring match — for short names that didn't make it into MODEL_ALIASES.
+    //    Iterate aliases first (cheap, small set), then bail.
+    const lower = model.toLowerCase();
+    for (const [alias, target] of Object.entries(MODEL_ALIASES)) {
+        if (lower.includes(alias) && prices[target])
+            return prices[target];
+    }
+    return undefined;
+}
+/**
+ * Compute a per-component cost breakdown.
+ *
+ * Returns all-zero values when the model isn't in the cost table — caller
+ * decides whether to fall back to an adapter-supplied cost (the existing
+ * legacy path). Cache components are zero when either the usage doesn't
+ * include cache tokens or the pricing entry doesn't list a cache rate.
+ */
+export function calculateCostBreakdown(model, usage) {
+    const p = getDetailedPricing(model);
+    if (!p) {
+        return { totalUsd: 0, inputUsd: 0, outputUsd: 0, cacheReadUsd: 0, cacheWriteUsd: 0 };
+    }
+    const inputUsd = (usage.inputTokens / 1_000_000) * p.inputPer1M;
+    const outputUsd = (usage.outputTokens / 1_000_000) * p.outputPer1M;
+    const cacheReadUsd = usage.cacheReadTokens && p.cacheReadPer1M
+        ? (usage.cacheReadTokens / 1_000_000) * p.cacheReadPer1M
+        : 0;
+    const cacheWriteUsd = usage.cacheWriteTokens && p.cacheWritePer1M
+        ? (usage.cacheWriteTokens / 1_000_000) * p.cacheWritePer1M
+        : 0;
+    return {
+        totalUsd: inputUsd + outputUsd + cacheReadUsd + cacheWriteUsd,
+        inputUsd,
+        outputUsd,
+        cacheReadUsd,
+        cacheWriteUsd,
+    };
+}
+/**
+ * Compute USD cost for a usage block at the given model's pricing.
+ * Returns 0 if the model is unknown.
+ */
+export function calculateCost(model, usage) {
+    return calculateCostBreakdown(model, usage).totalUsd;
+}
+/** Test seam — clear the in-memory cache. */
+export function resetCostTable() {
+    _modelPrices = null;
+}
+//# sourceMappingURL=cost.js.map

package/dist/cost.js.map

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