@esankhan3/anvil-agent-core 0.1.0

package/dist/router/telemetry.js

@@ -0,0 +1,112 @@
+/**
+ * Router telemetry — OTel parent + child spans for `LlmRouter.invoke`.
+ *
+ * Span hierarchy (per ADR R10):
+ *   anvil.router.invoke         — one per invoke() call
+ *     anvil.router.attempt      — one per RouteAttempt (success or failure)
+ *       gen_ai.invoke           — emitted by instrumentModelAdapter (legacy
+ *                                  adapters) or LanguageModel callers
+ *
+ * Attributes:
+ *   anvil.router.route_id, anvil.router.tag, anvil.router.run_id,
+ *   anvil.router.attempt, anvil.router.error_class,
+ *   anvil.router.fallback_index, anvil.router.budget_remaining_usd,
+ *   anvil.router.circuit_breaker_state, anvil.router.total_cost_usd,
+ *   anvil.router.attempt_count
+ *
+ * Wrapper-style — call `withRouterSpans(router, opts)` to capture spans
+ * around a single invoke. The wrapper is a no-op when `recordContent` is
+ * false; it never throws on tracer absence.
+ */
+import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
+import { getTracer } from '../telemetry/tracer.js';
+import { RouterError } from './errors.js';
+export const ROUTER_INVOKE_SPAN = 'anvil.router.invoke';
+export const ROUTER_ATTEMPT_SPAN = 'anvil.router.attempt';
+export const RouterAttr = {
+    ROUTE_ID: 'anvil.router.route_id',
+    TAG: 'anvil.router.tag',
+    RUN_ID: 'anvil.router.run_id',
+    PROJECT: 'anvil.router.project',
+    USER: 'anvil.router.user',
+    ATTEMPT: 'anvil.router.attempt',
+    ATTEMPT_COUNT: 'anvil.router.attempt_count',
+    ERROR_CLASS: 'anvil.router.error_class',
+    FALLBACK_INDEX: 'anvil.router.fallback_index',
+    BUDGET_REMAINING_USD: 'anvil.router.budget_remaining_usd',
+    CIRCUIT_BREAKER_STATE: 'anvil.router.circuit_breaker_state',
+    TOTAL_COST_USD: 'anvil.router.total_cost_usd',
+    PROVIDER: 'anvil.router.provider',
+    MODEL: 'anvil.router.model',
+    COST_USD: 'anvil.router.cost_usd',
+};
+/**
+ * Wrap a single `LlmRouter.invoke()` call with a parent span and one
+ * child span per RouteAttempt. The wrapper post-walks `outcome.attempts`
+ * to emit children — this keeps the router code itself untouched.
+ */
+export async function invokeWithSpans(router, opts) {
+    const tracer = getTracer();
+    return tracer.startActiveSpan(ROUTER_INVOKE_SPAN, { kind: SpanKind.INTERNAL }, async (parent) => {
+        parent.setAttribute(RouterAttr.TAG, opts.tag);
+        if (opts.runId)
+            parent.setAttribute(RouterAttr.RUN_ID, opts.runId);
+        if (opts.project)
+            parent.setAttribute(RouterAttr.PROJECT, opts.project);
+        if (opts.user)
+            parent.setAttribute(RouterAttr.USER, opts.user);
+        try {
+            const outcome = await router.invoke(opts);
+            emitAttemptChildren(tracer, outcome.attempts);
+            parent.setAttributes({
+                [RouterAttr.ATTEMPT_COUNT]: outcome.attempts.length,
+                [RouterAttr.TOTAL_COST_USD]: outcome.totalCostUsd,
+            });
+            if (outcome.budgetRemainingUsd !== undefined) {
+                parent.setAttribute(RouterAttr.BUDGET_REMAINING_USD, outcome.budgetRemainingUsd);
+            }
+            parent.setStatus({ code: SpanStatusCode.OK });
+            return outcome;
+        }
+        catch (err) {
+            if (err instanceof RouterError) {
+                emitAttemptChildren(tracer, err.attempts);
+                parent.setAttribute(RouterAttr.ATTEMPT_COUNT, err.attempts.length);
+            }
+            parent.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err instanceof Error ? err.message : String(err),
+            });
+            if (err instanceof Error)
+                parent.recordException(err);
+            throw err;
+        }
+        finally {
+            parent.end();
+        }
+    });
+}
+function emitAttemptChildren(tracer, attempts) {
+    for (const a of attempts) {
+        tracer.startActiveSpan(ROUTER_ATTEMPT_SPAN, { kind: SpanKind.INTERNAL }, (child) => {
+            child.setAttributes({
+                [RouterAttr.PROVIDER]: a.provider,
+                [RouterAttr.MODEL]: a.model,
+                [RouterAttr.ATTEMPT]: a.attemptIndex,
+                [RouterAttr.FALLBACK_INDEX]: a.fallbackIndex,
+            });
+            if (a.errorClass)
+                child.setAttribute(RouterAttr.ERROR_CLASS, a.errorClass);
+            if (a.costUsd !== undefined)
+                child.setAttribute(RouterAttr.COST_USD, a.costUsd);
+            if (a.errorClass) {
+                child.setStatus({ code: SpanStatusCode.ERROR, message: a.errorClass });
+            }
+            else {
+                child.setStatus({ code: SpanStatusCode.OK });
+            }
+            child.end();
+        });
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/router/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/router/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,uBAAuB;IACjC,GAAG,EAAE,kBAAkB;IACvB,MAAM,EAAE,qBAAqB;IAC7B,OAAO,EAAE,sBAAsB;IAC/B,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,sBAAsB;IAC/B,aAAa,EAAE,4BAA4B;IAC3C,WAAW,EAAE,0BAA0B;IACvC,cAAc,EAAE,6BAA6B;IAC7C,oBAAoB,EAAE,mCAAmC;IACzD,qBAAqB,EAAE,oCAAoC;IAC3D,cAAc,EAAE,6BAA6B;IAC7C,QAAQ,EAAE,uBAAuB;IACjC,KAAK,EAAE,oBAAoB;IAC3B,QAAQ,EAAE,uBAAuB;CACzB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,IAAgB;IAEhB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,MAAM,CAAC,eAAe,CAC3B,kBAAkB,EAClB,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAC3B,KAAK,EAAE,MAAY,EAAE,EAAE;QACrB,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,aAAa,CAAC;gBACnB,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;gBACnD,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY;aAClD,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBAC7C,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,oBAAoB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;gBAC/B,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,SAAS,CAAC;gBACf,IAAI,EAAE,cAAc,CAAC,KAAK;gBAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;YACH,IAAI,GAAG,YAAY,KAAK;gBAAE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAoC,EACpC,QAAqC;IAErC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,eAAe,CACpB,mBAAmB,EACnB,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAC3B,CAAC,KAAW,EAAE,EAAE;YACd,KAAK,CAAC,aAAa,CAAC;gBAClB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ;gBACjC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK;gBAC3B,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,YAAY;gBACpC,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,aAAa;aAC7C,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,UAAU;gBAAE,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YAC3E,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;gBAAE,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAChF,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/router/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `@esankhan3/anvil-agent-core/router` — schema types.
+ *
+ * Locked verbatim in `AGENT-CORE-LLM-ROUTER-ADR.md` §4. Keep this file
+ * declaration-only — runtime behavior lives in router.ts and friends.
+ */
+import type { LanguageModelInvokeOptions, InvokeResult, ProviderName } from '../types.js';
+export type ErrorClass = 'rate_limit' | 'timeout' | 'server_5xx' | 'auth' | 'content_policy' | 'invalid_request' | 'unknown';
+export declare const ALL_ERROR_CLASSES: readonly ErrorClass[];
+export interface RetryPolicy {
+    /** 0 = no retry. The total attempt count is `attempts + 1`. */
+    attempts: number;
+    backoff: 'exponential' | 'linear' | 'constant';
+    /** Base backoff in milliseconds. */
+    baseMs: number;
+    /** Ceiling for exponential growth. */
+    maxMs?: number;
+    /** Default true — adds ±25% jitter to the computed delay. */
+    jitter?: boolean;
+}
+export interface RouteFallback {
+    model: string;
+    /** Restrict this fallback to specified error classes; undefined = any retryable. */
+    on?: ErrorClass[];
+}
+export interface RouteConfig {
+    tag: string;
+    primary: string;
+    fallbacks?: RouteFallback[];
+}
+export interface BudgetConfig {
+    dailyUsd?: number;
+    perRunUsd?: number;
+    perTagUsd?: Record<string, number>;
+    /** Behavior when a budget is exhausted. */
+    onBreach: 'fail' | 'downgrade' | 'queue';
+}
+export interface CircuitBreakerConfig {
+    /** Open after N consecutive failures. */
+    failureThreshold: number;
+    /** Half-open after this window. */
+    cooldownMs: number;
+    /** Number of probe attempts during half-open. */
+    halfOpenAttempts: number;
+}
+export interface RateLimitProviderConfig {
+    rpm?: number;
+    tpm?: number;
+}
+export interface RouterConfig {
+    routes: RouteConfig[];
+    retryPolicy: Record<ErrorClass, RetryPolicy>;
+    /** Per-provider rate limits; keyed by ProviderName. */
+    rateLimit?: Record<string, RateLimitProviderConfig>;
+    budgets?: BudgetConfig;
+    circuitBreaker?: CircuitBreakerConfig;
+    /** Per-call hard cap across the fallback walk. */
+    maxFallbackCostUsd?: number;
+    /** Behavior when bucket dry. */
+    onRateLimit?: 'wait' | 'fallback' | 'fail';
+}
+export interface InvokeOpts extends Omit<LanguageModelInvokeOptions, 'model' | 'messages'> {
+    /** Tag selects a route from RouterConfig.routes. */
+    tag: string;
+    /** Either a raw prompt string or a structured message array. */
+    prompt: string | Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Escape hatch — pin a specific model id, bypassing tag routing. */
+    model?: string;
+    runId?: string;
+    project?: string;
+    user?: string;
+}
+export interface RouteAttempt {
+    model: string;
+    provider: ProviderName | string;
+    /** 0-based attempt counter within a single fallback step. */
+    attemptIndex: number;
+    /** 0 = primary, N = N-th declared fallback. */
+    fallbackIndex: number;
+    errorClass?: ErrorClass;
+    durationMs: number;
+    costUsd?: number;
+}
+export interface RouteOutcome {
+    result?: InvokeResult;
+    error?: Error;
+    attempts: RouteAttempt[];
+    totalDurationMs: number;
+    totalCostUsd: number;
+    budgetRemainingUsd?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/router/types.js

@@ -0,0 +1,16 @@
+/**
+ * `@esankhan3/anvil-agent-core/router` — schema types.
+ *
+ * Locked verbatim in `AGENT-CORE-LLM-ROUTER-ADR.md` §4. Keep this file
+ * declaration-only — runtime behavior lives in router.ts and friends.
+ */
+export const ALL_ERROR_CLASSES = [
+    'rate_limit',
+    'timeout',
+    'server_5xx',
+    'auth',
+    'content_policy',
+    'invalid_request',
+    'unknown',
+];
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACtD,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,MAAM;IACN,gBAAgB;IAChB,iBAAiB;IACjB,SAAS;CACD,CAAC"}

package/dist/single-shot.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Single-shot LLM runner — agent-core's analytical-shape entry point.
+ *
+ * Used by knowledge-core consumers (repo-profiler, service-mesh-inferrer,
+ * rag-evaluator) that want a `prompt + system → text + cost` round trip
+ * without managing the streaming surface themselves.
+ *
+ * Two transports:
+ *   - 'cli' (default) — spawns claude / gemini binary
+ *   - 'api'           — direct HTTP calls to Anthropic or OpenAI-compat endpoint
+ *   - 'none'          — disabled; throws on every call
+ *
+ * Mode resolution (ANVIL_LLM_MODE → CODE_SEARCH_LLM_MODE → auto-detect):
+ *   1. explicit 'cli'/'api'/'none' wins
+ *   2. else if API key present → 'api'
+ *   3. else if claude binary on PATH → 'cli'
+ *   4. else 'none'
+ *
+ * Env-var aliasing (Phase 5): ANVIL_* is canonical; CODE_SEARCH_LLM_* + a few
+ * unscoped legacy names (CLAUDE_BIN, GEMINI_BIN, ANVIL_AGENT_CMD, FF_AGENT_CMD,
+ * ANTHROPIC_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY) are kept as aliases. A
+ * deprecation warning is emitted to stderr if a legacy var is set without its
+ * canonical counterpart.
+ *
+ * Note on the unification path: this runner currently spawns subprocesses + makes
+ * HTTP calls directly (lift-and-shift from the original
+ * knowledge-core/claude-runner.ts). It does NOT yet route through
+ * `ProviderRegistry` + `LanguageModel.invoke()` — that requires every adapter
+ * to grow an `invoke()` impl, which is a follow-up phase. Both paths produce
+ * the same `ClaudeResult` shape, so callers don't see the difference.
+ */
+/** Test seam — reset cached config (call between tests that override env). */
+export declare function resetLlmConfig(): void;
+/** Report whether any LLM transport is currently usable. */
+export declare function isLlmAvailable(): boolean;
+export interface ClaudeResult {
+    result: string;
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+}
+export interface LLMRunOptions {
+    model?: string;
+    timeoutMs?: number;
+    provider?: 'claude' | 'gemini';
+}
+/** Run Claude — dispatches to CLI or API based on resolved LLM mode. */
+export declare function runClaude(prompt: string, systemPrompt: string, opts?: {
+    model?: string;
+    timeoutMs?: number;
+}): Promise<ClaudeResult>;
+/** Run Gemini CLI — CLI mode only (no Gemini API integration today). */
+export declare function runGemini(prompt: string, systemPrompt: string, opts?: {
+    model?: string;
+    timeoutMs?: number;
+}): Promise<ClaudeResult>;
+/** Provider-aware facade — defaults to Claude. */
+export declare function runLLM(prompt: string, systemPrompt: string, opts?: LLMRunOptions): Promise<ClaudeResult>;
+//# sourceMappingURL=single-shot.d.ts.map

package/dist/single-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-shot.d.ts","sourceRoot":"","sources":["../src/single-shot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA0GH,8EAA8E;AAC9E,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAsBD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAoDD,kDAAkD;AAClD,wBAAsB,MAAM,CAC1B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,YAAY,CAAC,CAIvB"}