@esankhan3/anvil-agent-core 0.1.0

package/dist/router/config-loader.js

@@ -0,0 +1,155 @@
+/**
+ * `llm-router.yaml` discovery + parsing.
+ *
+ * Search order (locked in ADR R5):
+ *   1. process.env.ANVIL_ROUTER_CONFIG (full path)
+ *   2. <workspaceRoot>/.anvil/llm-router.yaml
+ *   3. $HOME/.anvil/llm-router.yaml (or $ANVIL_HOME/llm-router.yaml)
+ *   4. compiled-in defaults (router still works without any config file)
+ *
+ * `${env:VAR}` expansions inside string values are resolved against
+ * `process.env` — same convention as the MCP config-loader.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import * as YAML from 'yaml';
+import { DEFAULT_RETRY_POLICY } from './retry.js';
+import { DEFAULT_RATE_LIMITS } from './rate-limiter.js';
+import { DEFAULT_CIRCUIT_BREAKER } from './circuit-breaker.js';
+/** Returns the path of the canonical `llm-router.yaml`, or undefined. */
+export function findRouterConfigPath(opts = {}) {
+    const env = opts.env ?? process.env;
+    const home = opts.homeDir ?? homedir();
+    const anvilHome = env.ANVIL_HOME ?? join(home, '.anvil');
+    const candidates = [];
+    if (env.ANVIL_ROUTER_CONFIG)
+        candidates.push(env.ANVIL_ROUTER_CONFIG);
+    if (opts.workspaceRoot) {
+        candidates.push(join(opts.workspaceRoot, '.anvil', 'llm-router.yaml'));
+    }
+    candidates.push(join(anvilHome, 'llm-router.yaml'));
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return undefined;
+}
+const ENV_VAR_RE = /\$\{env:([A-Z_][A-Z0-9_]*)\}/g;
+function expandEnv(value, env) {
+    if (typeof value === 'string') {
+        return value.replace(ENV_VAR_RE, (_m, name) => env[name] ?? '');
+    }
+    if (Array.isArray(value))
+        return value.map((v) => expandEnv(v, env));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = expandEnv(v, env);
+        return out;
+    }
+    return value;
+}
+/**
+ * Compiled-in defaults that ensure the router functions out-of-the-box
+ * when no YAML file is found. Routes default to common Anthropic +
+ * OpenAI tags — callers can still pin via `opts.model` if they don't
+ * have a matching tag.
+ */
+export function defaultRouterConfig() {
+    const routes = [
+        {
+            tag: 'planner',
+            primary: 'claude-sonnet-4-6',
+            fallbacks: [
+                { model: 'claude-haiku-4-5-20251001', on: ['rate_limit', 'server_5xx', 'timeout'] },
+                { model: 'gpt-4o', on: ['server_5xx', 'timeout'] },
+            ],
+        },
+        {
+            tag: 'code-gen',
+            primary: 'claude-sonnet-4-6',
+            fallbacks: [
+                { model: 'claude-haiku-4-5-20251001', on: ['rate_limit', 'server_5xx', 'timeout'] },
+            ],
+        },
+        {
+            tag: 'reviewer',
+            primary: 'claude-sonnet-4-6',
+            fallbacks: [
+                { model: 'gpt-4o', on: ['server_5xx', 'timeout', 'rate_limit'] },
+            ],
+        },
+    ];
+    return {
+        routes,
+        retryPolicy: { ...DEFAULT_RETRY_POLICY },
+        rateLimit: { ...DEFAULT_RATE_LIMITS },
+        circuitBreaker: { ...DEFAULT_CIRCUIT_BREAKER },
+        onRateLimit: 'wait',
+        maxFallbackCostUsd: 1.0,
+    };
+}
+/**
+ * Load + parse the active router config. Returns compiled-in defaults
+ * if no YAML file is found (unless `requireFile: true`).
+ */
+export function loadRouterConfig(opts = {}) {
+    const env = opts.env ?? process.env;
+    const path = findRouterConfigPath(opts);
+    if (!path) {
+        if (opts.requireFile) {
+            throw new Error('LlmRouter: no router config file found and requireFile=true');
+        }
+        return defaultRouterConfig();
+    }
+    const raw = readFileSync(path, 'utf8');
+    const parsed = YAML.parse(raw);
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`LlmRouter: ${path} is empty or invalid YAML`);
+    }
+    const expanded = expandEnv(parsed, env);
+    return mergeWithDefaults(expanded);
+}
+/**
+ * Merge a user config object over the compiled-in defaults. Top-level
+ * fields (`routes`, `retryPolicy`, etc.) replace; sub-fields layer.
+ */
+export function mergeWithDefaults(input) {
+    const defaults = defaultRouterConfig();
+    const out = { ...defaults };
+    if (Array.isArray(input.routes)) {
+        out.routes = input.routes;
+    }
+    if (input.retryPolicy && typeof input.retryPolicy === 'object') {
+        out.retryPolicy = {
+            ...defaults.retryPolicy,
+            ...input.retryPolicy,
+        };
+    }
+    if (input.rateLimit && typeof input.rateLimit === 'object') {
+        out.rateLimit = {
+            ...defaults.rateLimit,
+            ...input.rateLimit,
+        };
+    }
+    if (input.circuitBreaker && typeof input.circuitBreaker === 'object') {
+        out.circuitBreaker = {
+            ...(defaults.circuitBreaker ?? DEFAULT_CIRCUIT_BREAKER),
+            ...input.circuitBreaker,
+        };
+    }
+    if (input.budgets && typeof input.budgets === 'object') {
+        out.budgets = input.budgets;
+    }
+    if (typeof input.maxFallbackCostUsd === 'number') {
+        out.maxFallbackCostUsd = input.maxFallbackCostUsd;
+    }
+    if (input.onRateLimit === 'wait' ||
+        input.onRateLimit === 'fail' ||
+        input.onRateLimit === 'fallback') {
+        out.onRateLimit = input.onRateLimit;
+    }
+    return out;
+}
+//# sourceMappingURL=config-loader.js.map

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

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

package/dist/router/discovery.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Discovery — boot-time pass that pings each model's provider for liveness
+ * and writes the result into `registry.availability`. The resolver later
+ * consults this map to filter unavailable models.
+ *
+ * Mutates the registry in place. Idempotent — re-running just refreshes
+ * the timestamps. Capability metadata is NEVER changed by this pass; only
+ * `availability` is touched.
+ */
+import type { ProviderName } from '../types.js';
+import type { ModelRegistry } from './model-registry.js';
+export interface DiscoveryAdapter {
+    checkAvailability(): Promise<{
+        available: boolean;
+        version?: string;
+        error?: string;
+    }>;
+}
+export interface DiscoveryDeps {
+    /** Resolve a provider name to an adapter that can `checkAvailability`. */
+    getAdapter(provider: ProviderName): DiscoveryAdapter | undefined;
+    now?: () => number;
+}
+export interface DiscoveryOptions {
+    /** Per-provider timeout for `checkAvailability`. Default 3000ms. */
+    timeoutMs?: number;
+}
+/**
+ * Walks the registry, probes each model's provider, and writes the result
+ * into `registry.availability`. One probe per UNIQUE provider — adapters
+ * report at the provider level, so the result is replicated across all
+ * registry entries that share that provider.
+ *
+ * Returns the same registry reference (mutation), so callers can chain.
+ */
+export declare function discoverAvailability(registry: ModelRegistry, deps: DiscoveryDeps, opts?: DiscoveryOptions): Promise<ModelRegistry>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/router/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/router/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACjE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAyCxB"}

package/dist/router/discovery.js

@@ -0,0 +1,54 @@
+/**
+ * Walks the registry, probes each model's provider, and writes the result
+ * into `registry.availability`. One probe per UNIQUE provider — adapters
+ * report at the provider level, so the result is replicated across all
+ * registry entries that share that provider.
+ *
+ * Returns the same registry reference (mutation), so callers can chain.
+ */
+export async function discoverAvailability(registry, deps, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 3000;
+    const now = deps.now ?? Date.now;
+    if (!registry.availability)
+        registry.availability = new Map();
+    const map = registry.availability;
+    const providersInUse = new Set();
+    for (const m of registry.models)
+        providersInUse.add(m.provider);
+    const probes = Array.from(providersInUse).map(async (provider) => {
+        const adapter = deps.getAdapter(provider);
+        if (!adapter) {
+            return { provider, result: { available: false, error: 'no adapter registered' } };
+        }
+        try {
+            const result = await raceWithTimeout(adapter.checkAvailability(), timeoutMs);
+            return { provider, result };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return { provider, result: { available: false, error } };
+        }
+    });
+    const settled = await Promise.all(probes);
+    const byProvider = new Map();
+    for (const { provider, result } of settled) {
+        byProvider.set(provider, { available: result.available, error: result.error });
+    }
+    const ts = now();
+    for (const m of registry.models) {
+        const probe = byProvider.get(m.provider);
+        map.set(m.id, {
+            available: probe?.available === true,
+            lastChecked: ts,
+            error: probe?.error,
+        });
+    }
+    return registry;
+}
+function raceWithTimeout(p, ms) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(() => reject(new Error(`timeout after ${ms}ms`)), ms);
+        p.then((v) => { clearTimeout(t); resolve(v); }, (e) => { clearTimeout(t); reject(e); });
+    });
+}
+//# sourceMappingURL=discovery.js.map

package/dist/router/discovery.js.map

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

package/dist/router/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Router error classification + RouterError type.
+ *
+ * `classifyError` is a best-effort heuristic over (status, code, message).
+ * Per ADR R2, providers can register adapter-specific overrides via
+ * `RouterConfig.errorClassifiers[provider]` (Phase 2+).
+ */
+import type { ErrorClass, RouteAttempt } from './types.js';
+/**
+ * Error thrown when the entire route walk fails. Carries the full
+ * attempt history so callers can introspect what was tried.
+ */
+export declare class RouterError extends Error {
+    readonly attempts: ReadonlyArray<RouteAttempt>;
+    readonly cause?: Error;
+    constructor(message: string, opts: {
+        attempts: ReadonlyArray<RouteAttempt>;
+        cause?: Error;
+    });
+}
+/**
+ * Map a raw error to an `ErrorClass`.
+ *
+ * Recognizes:
+ *   - 429 → rate_limit
+ *   - 5xx → server_5xx
+ *   - 401/403 → auth
+ *   - 400 + content/safety hints → content_policy
+ *   - 400 → invalid_request
+ *   - timeout/abort/etimedout/econnreset/socket-hang-up → timeout
+ *   - otherwise → unknown
+ */
+export declare function classifyError(err: unknown): ErrorClass;
+/**
+ * Parse a `Retry-After` header value (seconds-since-now or HTTP-date)
+ * into a millisecond delay. Returns `null` if absent or unparseable.
+ */
+export declare function parseRetryAfterMs(headers?: Record<string, string | undefined>): number | null;
+//# sourceMappingURL=errors.d.ts.map

package/dist/router/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/router/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAOjE;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAkDtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,CAY7F"}

package/dist/router/errors.js

@@ -0,0 +1,103 @@
+/**
+ * Router error classification + RouterError type.
+ *
+ * `classifyError` is a best-effort heuristic over (status, code, message).
+ * Per ADR R2, providers can register adapter-specific overrides via
+ * `RouterConfig.errorClassifiers[provider]` (Phase 2+).
+ */
+/**
+ * Error thrown when the entire route walk fails. Carries the full
+ * attempt history so callers can introspect what was tried.
+ */
+export class RouterError extends Error {
+    attempts;
+    cause;
+    constructor(message, opts) {
+        super(message);
+        this.name = 'RouterError';
+        this.attempts = opts.attempts;
+        this.cause = opts.cause;
+    }
+}
+/**
+ * Map a raw error to an `ErrorClass`.
+ *
+ * Recognizes:
+ *   - 429 → rate_limit
+ *   - 5xx → server_5xx
+ *   - 401/403 → auth
+ *   - 400 + content/safety hints → content_policy
+ *   - 400 → invalid_request
+ *   - timeout/abort/etimedout/econnreset/socket-hang-up → timeout
+ *   - otherwise → unknown
+ */
+export function classifyError(err) {
+    if (!err)
+        return 'unknown';
+    const e = err;
+    // Network / timeout heuristics first — these can co-exist with no status.
+    const codeStr = typeof e.code === 'string' ? e.code.toUpperCase() : '';
+    if (codeStr === 'ETIMEDOUT' || codeStr === 'ECONNRESET' || codeStr === 'ECONNABORTED') {
+        return 'timeout';
+    }
+    if (e.name === 'AbortError' || e.name === 'TimeoutError')
+        return 'timeout';
+    const message = (e.message ?? '').toLowerCase();
+    if (message.includes('timeout') || message.includes('timed out') || message.includes('socket hang up')) {
+        return 'timeout';
+    }
+    const status = e.status ?? e.statusCode;
+    if (typeof status === 'number') {
+        if (status === 429)
+            return 'rate_limit';
+        if (status >= 500 && status < 600)
+            return 'server_5xx';
+        if (status === 401 || status === 403)
+            return 'auth';
+        if (status === 400) {
+            // Content-policy filter signals
+            const innerType = e.error?.type?.toLowerCase() ?? '';
+            const innerCode = e.error?.code?.toLowerCase() ?? '';
+            if (innerType.includes('content') ||
+                innerType.includes('safety') ||
+                innerCode.includes('content_policy') ||
+                innerCode.includes('safety') ||
+                message.includes('content policy') ||
+                message.includes('safety filter') ||
+                message.includes('refused')) {
+                return 'content_policy';
+            }
+            return 'invalid_request';
+        }
+    }
+    // Non-status providers (e.g. SDK throws with content_filter type)
+    const innerType = e.error?.type?.toLowerCase() ?? '';
+    if (innerType.includes('content') || innerType.includes('safety')) {
+        return 'content_policy';
+    }
+    if (e.type && /content|safety/i.test(e.type)) {
+        return 'content_policy';
+    }
+    return 'unknown';
+}
+/**
+ * Parse a `Retry-After` header value (seconds-since-now or HTTP-date)
+ * into a millisecond delay. Returns `null` if absent or unparseable.
+ */
+export function parseRetryAfterMs(headers) {
+    if (!headers)
+        return null;
+    const raw = headers['retry-after'] ?? headers['Retry-After'];
+    if (!raw)
+        return null;
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.round(seconds * 1000);
+    const dateMs = Date.parse(raw);
+    if (!Number.isNaN(dateMs)) {
+        const delta = dateMs - Date.now();
+        return delta > 0 ? delta : 0;
+    }
+    return null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/router/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/router/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,QAAQ,CAA8B;IACtC,KAAK,CAAS;IAEvB,YACE,OAAe,EACf,IAA8D;QAE9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAcD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,GAAG,GAAgB,CAAC;IAE3B,0EAA0E;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IAE3E,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvG,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC;IACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,YAAY,CAAC;QACxC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,YAAY,CAAC;QACvD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC;QACpD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,gCAAgC;YAChC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACrD,IACE,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC5B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAC3B,CAAC;gBACD,OAAO,gBAAgB,CAAC;YAC1B,CAAC;YACD,OAAO,iBAAiB,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4C;IAC5E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@esankhan3/anvil-agent-core/router` — barrel.
+ *
+ * Public surface for the LLM router subsystem. See
+ * `AGENT-CORE-LLM-ROUTER-PLAN.md` for the phased rollout.
+ */
+export type { ErrorClass, RetryPolicy, RouteFallback, RouteConfig, BudgetConfig, CircuitBreakerConfig, RateLimitProviderConfig, RouterConfig, InvokeOpts, RouteAttempt, RouteOutcome, } from './types.js';
+export { ALL_ERROR_CLASSES } from './types.js';
+export { LlmRouter } from './router.js';
+export type { LlmRouterDeps, AdapterResolver } from './router.js';
+export { RouterError, classifyError, parseRetryAfterMs } from './errors.js';
+export { runWithRetry, DEFAULT_RETRY_POLICY } from './retry.js';
+export type { RetryAttempt, RunWithRetryDeps, RunWithRetryResult } from './retry.js';
+export { TokenBucketRateLimiter, RateLimitedError, DEFAULT_RATE_LIMITS, } from './rate-limiter.js';
+export type { RateLimiterDeps } from './rate-limiter.js';
+export { SpendLedger, SPEND_LEDGER_SCHEMA_SQL, defaultSpendLedgerPath, } from './spend-ledger.js';
+export type { SpendRow, SpendQueryOpts } from './spend-ledger.js';
+export { CircuitBreaker, DEFAULT_CIRCUIT_BREAKER } from './circuit-breaker.js';
+export type { CircuitBreakerDeps, CircuitState } from './circuit-breaker.js';
+export { loadRouterConfig, findRouterConfigPath, defaultRouterConfig, mergeWithDefaults, } from './config-loader.js';
+export type { LoadRouterConfigOptions } from './config-loader.js';
+export { invokeWithSpans, ROUTER_INVOKE_SPAN, ROUTER_ATTEMPT_SPAN, RouterAttr, } from './telemetry.js';
+export { loadModelRegistry, parseModelRegistry, findModelsConfigPath, DEFAULT_WALKER_CONFIG, ModelRegistryParseError, ModelRegistryValidationError, } from './model-registry.js';
+export type { ModelEntry, ModelRegistry, ModelAvailability, ModelCapability, ModelComplexity, ModelTier, ModelConsumer, WalkerConfig, LoadModelRegistryOptions, } from './model-registry.js';
+export { resolveModel, ModelResolutionError } from './resolver.js';
+export type { ResolveModelOptions, ResolvedChain, ResolutionDiagnostic, } from './resolver.js';
+export { LocalExecutor, localExecutor } from './local-executor.js';
+export type { LocalExecutorDeps, LocalExecutorInspection, } from './local-executor.js';
+export { discoverAvailability } from './discovery.js';
+export type { DiscoveryAdapter, DiscoveryDeps, DiscoveryOptions, } from './discovery.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,EACZ,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EACV,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@esankhan3/anvil-agent-core/router` — barrel.
+ *
+ * Public surface for the LLM router subsystem. See
+ * `AGENT-CORE-LLM-ROUTER-PLAN.md` for the phased rollout.
+ */
+export { ALL_ERROR_CLASSES } from './types.js';
+export { LlmRouter } from './router.js';
+export { RouterError, classifyError, parseRetryAfterMs } from './errors.js';
+export { runWithRetry, DEFAULT_RETRY_POLICY } from './retry.js';
+export { TokenBucketRateLimiter, RateLimitedError, DEFAULT_RATE_LIMITS, } from './rate-limiter.js';
+export { SpendLedger, SPEND_LEDGER_SCHEMA_SQL, defaultSpendLedgerPath, } from './spend-ledger.js';
+export { CircuitBreaker, DEFAULT_CIRCUIT_BREAKER } from './circuit-breaker.js';
+export { loadRouterConfig, findRouterConfigPath, defaultRouterConfig, mergeWithDefaults, } from './config-loader.js';
+export { invokeWithSpans, ROUTER_INVOKE_SPAN, ROUTER_ATTEMPT_SPAN, RouterAttr, } from './telemetry.js';
+export { loadModelRegistry, parseModelRegistry, findModelsConfigPath, DEFAULT_WALKER_CONFIG, ModelRegistryParseError, ModelRegistryValidationError, } from './model-registry.js';
+export { resolveModel, ModelResolutionError } from './resolver.js';
+export { LocalExecutor, localExecutor } from './local-executor.js';
+export { discoverAvailability } from './discovery.js';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAMnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/router/local-executor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * LocalExecutor — process-local FIFO single-slot queue for exclusive
+ * local models (Ollama big-model slots that can't co-reside on a 16GB
+ * GPU). Embedding + reranker models bypass this entirely.
+ *
+ * Contract:
+ *   • At most ONE exclusive model is loaded at a time.
+ *   • Concurrent callers are serialized in FIFO order — no deadlock,
+ *     no priority inversion.
+ *   • Switching from model A → model B triggers a synchronous eviction
+ *     of A via Ollama's `POST /api/generate {model: A, prompt: '',
+ *     keep_alive: 0}`, then polls `/api/ps` until A is no longer
+ *     resident before letting B's call go through. Confirmed eviction
+ *     prevents the GPU from briefly holding both.
+ *   • Before every load, the executor probes `/api/ps` for OUT-OF-BAND
+ *     resident exclusive models (e.g. an Ollama CLI session on the
+ *     host loaded one independently). Intruders are evicted before B
+ *     loads, so no two exclusive models are ever resident at once.
+ *   • If `fn` throws, the slot is released and the queue keeps moving.
+ *   • Same-id consecutive calls do NOT trigger eviction.
+ */
+export interface LocalExecutorDeps {
+    /** Override the eviction call (used by tests; defaults to `fetch` to Ollama). */
+    evict?: (modelId: string) => Promise<void>;
+    /** Returns the model ids Ollama currently has resident. Tests inject
+     *  to assert intruder-detection. Default = hits /api/ps. */
+    probeResident?: () => Promise<string[]>;
+    /** Returns true when modelId is an exclusive-slot model (i.e. should
+     *  NOT co-reside with another exclusive model). Default returns true
+     *  for every input — the legacy executor cared only about its own
+     *  internal `loaded`. New callers can wire it to the model registry
+     *  for correct intruder filtering. */
+    isExclusive?: (modelId: string) => boolean;
+    /** Override now() for deterministic tests. */
+    now?: () => number;
+}
+export interface LocalExecutorInspection {
+    loaded: string | null;
+    queueDepth: number;
+}
+export declare class LocalExecutor {
+    private loaded;
+    private queue;
+    private busy;
+    private readonly deps;
+    constructor(deps?: LocalExecutorDeps);
+    withModel<T>(modelId: string, fn: () => Promise<T>): Promise<T>;
+    inspect(): LocalExecutorInspection;
+    private pump;
+}
+/**
+ * Process-local singleton. Modules that wrap exclusive-slot calls
+ * import this directly; tests construct their own instance to avoid
+ * cross-test pollution.
+ *
+ * The singleton is wired with the real Ollama probe so production
+ * intruder-detection works; per-test instances default to a no-op
+ * probe so they don't pay for a network round-trip they don't care
+ * about.
+ */
+export declare const localExecutor: LocalExecutor;
+//# sourceMappingURL=local-executor.d.ts.map

package/dist/router/local-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.d.ts","sourceRoot":"","sources":["../../src/router/local-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;gEAC4D;IAC5D,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC;;;;0CAIsC;IACtC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;gBAEvC,IAAI,GAAE,iBAAsB;IAaxC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY/D,OAAO,IAAI,uBAAuB;YAIpB,IAAI;CAwCnB;AAwDD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,eAExB,CAAC"}