@esankhan3/anvil-agent-core 0.1.0

package/dist/telemetry/attributes.js

@@ -0,0 +1,39 @@
+/**
+ * GenAI semantic-convention attribute keys.
+ *
+ * Mirrors the OpenTelemetry GenAI SIG spec
+ * (https://opentelemetry.io/docs/specs/semconv/gen-ai/llm-spans/) plus
+ * Anvil-specific extensions for cost USD, cache tokens, and tool argument
+ * size. Anvil-extension attributes follow the same `gen_ai.*` namespace so
+ * backends without LLM-specific UIs still render them as plain attributes.
+ */
+export const GenAi = {
+    // -- Spec --------------------------------------------------------------
+    SYSTEM: 'gen_ai.system',
+    REQUEST_MODEL: 'gen_ai.request.model',
+    REQUEST_MAX_TOKENS: 'gen_ai.request.max_tokens',
+    REQUEST_TEMPERATURE: 'gen_ai.request.temperature',
+    RESPONSE_FINISH_REASONS: 'gen_ai.response.finish_reasons',
+    RESPONSE_MODEL: 'gen_ai.response.model',
+    RESPONSE_ID: 'gen_ai.response.id',
+    USAGE_INPUT_TOKENS: 'gen_ai.usage.input_tokens',
+    USAGE_OUTPUT_TOKENS: 'gen_ai.usage.output_tokens',
+    TOOL_NAME: 'gen_ai.tool.name',
+    // -- Anvil extensions --------------------------------------------------
+    USAGE_CACHE_READ_TOKENS: 'gen_ai.usage.cache_read_tokens',
+    USAGE_CACHE_WRITE_TOKENS: 'gen_ai.usage.cache_write_tokens',
+    USAGE_CACHE_HIT_RATIO: 'gen_ai.usage.cache_hit_ratio',
+    USAGE_COST_USD: 'gen_ai.usage.cost_usd',
+    USAGE_COST_INPUT_USD: 'gen_ai.usage.cost_input_usd',
+    USAGE_COST_OUTPUT_USD: 'gen_ai.usage.cost_output_usd',
+    USAGE_COST_CACHE_READ_USD: 'gen_ai.usage.cost_cache_read_usd',
+    USAGE_COST_CACHE_WRITE_USD: 'gen_ai.usage.cost_cache_write_usd',
+    TOOL_ARGUMENTS_SIZE: 'gen_ai.tool.arguments_size_bytes',
+    REASONING_TOKENS: 'gen_ai.reasoning.tokens',
+    REASONING_TEXT: 'gen_ai.reasoning.text',
+    MESSAGES_COUNT: 'gen_ai.messages.count',
+    TOOLS_COUNT: 'gen_ai.tools.count',
+    PROMPT: 'gen_ai.prompt',
+    COMPLETION: 'gen_ai.completion',
+};
+//# sourceMappingURL=attributes.js.map

package/dist/telemetry/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/telemetry/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,yEAAyE;IACzE,MAAM,EAAE,eAAe;IACvB,aAAa,EAAE,sBAAsB;IACrC,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;IACjD,uBAAuB,EAAE,gCAAgC;IACzD,cAAc,EAAE,uBAAuB;IACvC,WAAW,EAAE,oBAAoB;IACjC,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;IACjD,SAAS,EAAE,kBAAkB;IAE7B,yEAAyE;IACzE,uBAAuB,EAAE,gCAAgC;IACzD,wBAAwB,EAAE,iCAAiC;IAC3D,qBAAqB,EAAE,8BAA8B;IACrD,cAAc,EAAE,uBAAuB;IACvC,oBAAoB,EAAE,6BAA6B;IACnD,qBAAqB,EAAE,8BAA8B;IACrD,yBAAyB,EAAE,kCAAkC;IAC7D,0BAA0B,EAAE,mCAAmC;IAC/D,mBAAmB,EAAE,kCAAkC;IACvD,gBAAgB,EAAE,yBAAyB;IAC3C,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,uBAAuB;IACvC,WAAW,EAAE,oBAAoB;IACjC,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,mBAAmB;CACvB,CAAC"}

package/dist/telemetry/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Telemetry configuration — resolved from environment variables.
+ *
+ * Resolution order:
+ * 1. ANVIL_OTEL_DISABLED=1            → disabled (kill-switch wins)
+ * 2. OTEL_EXPORTER_OTLP_ENDPOINT set  → otlp mode, enabled
+ * 3. ANVIL_OTEL_CONSOLE=1             → console mode, enabled
+ * 4. otherwise                         → noop mode, disabled
+ *
+ * Prompt content recording is OFF by default — opt in via
+ * ANVIL_OTEL_RECORD_CONTENT=1 (decision O5).
+ */
+export interface TelemetryConfig {
+    /** True when at least one exporter is wired up. */
+    enabled: boolean;
+    /** Which exporter the tracer should install. */
+    exporterMode: 'noop' | 'console' | 'otlp';
+    /** OTLP endpoint URL. Only meaningful when exporterMode === 'otlp'. */
+    endpoint?: string;
+    /** Headers parsed from OTEL_EXPORTER_OTLP_HEADERS (key=value pairs, comma separated). */
+    headers?: Record<string, string>;
+    /** When true, prompt + completion text are attached to spans. Default false. */
+    recordContent: boolean;
+    /** Resource attribute service.name. */
+    serviceName: string;
+    /** Optional sampler hint (mirrors OTEL_TRACES_SAMPLER); the SDK reads this env var natively. */
+    sampler?: string;
+}
+export declare function loadTelemetryConfig(): TelemetryConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/telemetry/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,wBAAgB,mBAAmB,IAAI,eAAe,CA0BrD"}

package/dist/telemetry/config.js

@@ -0,0 +1,54 @@
+/**
+ * Telemetry configuration — resolved from environment variables.
+ *
+ * Resolution order:
+ * 1. ANVIL_OTEL_DISABLED=1            → disabled (kill-switch wins)
+ * 2. OTEL_EXPORTER_OTLP_ENDPOINT set  → otlp mode, enabled
+ * 3. ANVIL_OTEL_CONSOLE=1             → console mode, enabled
+ * 4. otherwise                         → noop mode, disabled
+ *
+ * Prompt content recording is OFF by default — opt in via
+ * ANVIL_OTEL_RECORD_CONTENT=1 (decision O5).
+ */
+function parseHeaders(raw) {
+    if (!raw)
+        return undefined;
+    const out = {};
+    for (const pair of raw.split(',')) {
+        const idx = pair.indexOf('=');
+        if (idx <= 0)
+            continue;
+        const key = pair.slice(0, idx).trim();
+        const value = pair.slice(idx + 1).trim();
+        if (key)
+            out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function loadTelemetryConfig() {
+    const disabled = process.env.ANVIL_OTEL_DISABLED === '1';
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
+    const consoleFlag = process.env.ANVIL_OTEL_CONSOLE === '1';
+    const recordContent = process.env.ANVIL_OTEL_RECORD_CONTENT === '1';
+    const serviceName = process.env.OTEL_SERVICE_NAME?.trim() || 'anvil-agent-core';
+    const sampler = process.env.OTEL_TRACES_SAMPLER?.trim() || undefined;
+    if (disabled) {
+        return { enabled: false, exporterMode: 'noop', recordContent: false, serviceName, sampler };
+    }
+    if (endpoint) {
+        return {
+            enabled: true,
+            exporterMode: 'otlp',
+            endpoint,
+            headers: parseHeaders(process.env.OTEL_EXPORTER_OTLP_HEADERS),
+            recordContent,
+            serviceName,
+            sampler,
+        };
+    }
+    if (consoleFlag) {
+        return { enabled: true, exporterMode: 'console', recordContent, serviceName, sampler };
+    }
+    return { enabled: false, exporterMode: 'noop', recordContent, serviceName, sampler };
+}
+//# sourceMappingURL=config.js.map

package/dist/telemetry/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,SAAS,YAAY,CAAC,GAAuB;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC;YAAE,SAAS;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,CAAC;IAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,CAAC;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,kBAAkB,CAAC;IAChF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAErE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,MAAM;YACpB,QAAQ;YACR,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;YAC7D,aAAa;YACb,WAAW;YACX,OAAO;SACR,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACvF,CAAC"}

package/dist/telemetry/exporters.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Exporter factory — produces an OTel SpanExporter from a TelemetryConfig.
+ *
+ * The 'noop' branch is intentionally unreachable here: callers gate on
+ * config.enabled before constructing an exporter (see tracer.ts).
+ */
+import { type SpanExporter } from '@opentelemetry/sdk-trace-base';
+import type { TelemetryConfig } from './config.js';
+export declare function buildExporter(config: TelemetryConfig): SpanExporter;
+//# sourceMappingURL=exporters.d.ts.map

package/dist/telemetry/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","sourceRoot":"","sources":["../../src/telemetry/exporters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyBnD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAYnE"}

package/dist/telemetry/exporters.js

@@ -0,0 +1,46 @@
+/**
+ * Exporter factory — produces an OTel SpanExporter from a TelemetryConfig.
+ *
+ * The 'noop' branch is intentionally unreachable here: callers gate on
+ * config.enabled before constructing an exporter (see tracer.ts).
+ */
+import { ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+/**
+ * Normalize an OTLP HTTP endpoint to include the `/v1/traces` signal path.
+ *
+ * The OTel JS SDK only auto-appends `/v1/traces` when reading the endpoint
+ * from the `OTEL_EXPORTER_OTLP_ENDPOINT` env var directly — not when the URL
+ * is passed via the exporter constructor. So `http://localhost:4318`
+ * silently 404s against any OTLP HTTP receiver. We append the suffix
+ * ourselves when the URL has no path component.
+ */
+function normalizeOtlpEndpoint(endpoint) {
+    if (!endpoint)
+        return endpoint;
+    try {
+        const url = new URL(endpoint);
+        if (url.pathname === '' || url.pathname === '/') {
+            url.pathname = '/v1/traces';
+            return url.toString();
+        }
+        return endpoint;
+    }
+    catch {
+        return endpoint;
+    }
+}
+export function buildExporter(config) {
+    switch (config.exporterMode) {
+        case 'console':
+            return new ConsoleSpanExporter();
+        case 'otlp':
+            return new OTLPTraceExporter({
+                url: normalizeOtlpEndpoint(config.endpoint),
+                headers: config.headers,
+            });
+        case 'noop':
+            throw new Error('buildExporter called with noop mode — callers must gate on config.enabled');
+    }
+}
+//# sourceMappingURL=exporters.js.map

package/dist/telemetry/exporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.js","sourceRoot":"","sources":["../../src/telemetry/exporters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,QAA4B;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;YAChD,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC;YAC5B,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,QAAQ,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QACL,KAAK,MAAM;YACT,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACjG,CAAC;AACH,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Public telemetry barrel for `@esankhan3/anvil-agent-core`.
+ *
+ * Consumers import the GenAi attribute constants and (optionally) the tracer
+ * accessor. The wrapper that emits spans (Phase 2) is not yet exposed —
+ * instrumentation is applied internally at the registry seam.
+ */
+export { getTracer, resetTracer, shutdownTracer, getTelemetryConfig } from './tracer.js';
+export { recordGenAiCall, shutdownMetrics } from './metrics.js';
+export type { GenAiCallMetrics } from './metrics.js';
+export { loadTelemetryConfig } from './config.js';
+export type { TelemetryConfig } from './config.js';
+export { GenAi } from './attributes.js';
+export type { GenAiAttribute } from './attributes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,12 @@
+/**
+ * Public telemetry barrel for `@esankhan3/anvil-agent-core`.
+ *
+ * Consumers import the GenAi attribute constants and (optionally) the tracer
+ * accessor. The wrapper that emits spans (Phase 2) is not yet exposed —
+ * instrumentation is applied internally at the registry seam.
+ */
+export { getTracer, resetTracer, shutdownTracer, getTelemetryConfig } from './tracer.js';
+export { recordGenAiCall, shutdownMetrics } from './metrics.js';
+export { loadTelemetryConfig } from './config.js';
+export { GenAi } from './attributes.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/telemetry/instrument.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Instrumentation wrapper — wraps a ModelAdapter so its `run()` method
+ * emits an OpenTelemetry span following the GenAI semantic conventions.
+ *
+ * Phase 2 deviation from plan §2.2: the plan envisioned wrapping
+ * `LanguageModel.invoke` / `invokeStream`, but the seven existing adapters
+ * implement only the legacy `ModelAdapter.run(config, output)` interface
+ * today (see AGENT-CORE-ADR.md §9 Phase 5 deviation). This wrapper targets
+ * `run` instead — same integration seam (registry.get), same GenAI
+ * attributes emitted, lower fidelity (one span per stage run, not per
+ * turn). When adapters gain native `invoke()` impls, this file gains a
+ * sibling wrapper for that surface.
+ *
+ * Tool-call and reasoning child spans are deferred to Phase 3, where
+ * per-adapter NDJSON parsing surfaces them.
+ */
+import type { ModelAdapter, ProviderName } from '../types.js';
+/**
+ * Wrap a single-shot LLM call (e.g. runClaude / runGemini in single-shot.ts)
+ * with a `gen_ai.invoke` span. The callback receives the active span only
+ * for diagnostic logging; it is auto-`end()`-ed via try/finally.
+ */
+export declare function withInvokeSpan<TResult>(args: {
+    provider: ProviderName | string;
+    model: string;
+    prompt?: string;
+    systemPrompt?: string;
+}, exec: () => Promise<TResult>, applyResult: (result: TResult) => Record<string, number | string | boolean | undefined>): Promise<TResult>;
+/**
+ * Return an instrumented view of the adapter. The new object delegates all
+ * methods to the wrapped instance; only `run` gets a span around it. When
+ * telemetry is disabled, OTel's no-op tracer makes the wrapper effectively
+ * free (no allocations beyond a closure).
+ */
+export declare function instrumentModelAdapter(adapter: ModelAdapter): ModelAdapter;
+//# sourceMappingURL=instrument.d.ts.map

package/dist/telemetry/instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../src/telemetry/instrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,YAAY,EAGZ,YAAY,EAEb,MAAM,aAAa,CAAC;AAOrB;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAC1C,IAAI,EAAE;IACJ,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GACtF,OAAO,CAAC,OAAO,CAAC,CAoClB;AAKD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAE1E"}

package/dist/telemetry/instrument.js

@@ -0,0 +1,215 @@
+/**
+ * Instrumentation wrapper — wraps a ModelAdapter so its `run()` method
+ * emits an OpenTelemetry span following the GenAI semantic conventions.
+ *
+ * Phase 2 deviation from plan §2.2: the plan envisioned wrapping
+ * `LanguageModel.invoke` / `invokeStream`, but the seven existing adapters
+ * implement only the legacy `ModelAdapter.run(config, output)` interface
+ * today (see AGENT-CORE-ADR.md §9 Phase 5 deviation). This wrapper targets
+ * `run` instead — same integration seam (registry.get), same GenAI
+ * attributes emitted, lower fidelity (one span per stage run, not per
+ * turn). When adapters gain native `invoke()` impls, this file gains a
+ * sibling wrapper for that surface.
+ *
+ * Tool-call and reasoning child spans are deferred to Phase 3, where
+ * per-adapter NDJSON parsing surfaces them.
+ */
+import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
+import { getTracer } from './tracer.js';
+import { loadTelemetryConfig } from './config.js';
+import { GenAi } from './attributes.js';
+import { recordGenAiCall } from './metrics.js';
+import { calculateCostBreakdown } from '../cost.js';
+/**
+ * Wrap a single-shot LLM call (e.g. runClaude / runGemini in single-shot.ts)
+ * with a `gen_ai.invoke` span. The callback receives the active span only
+ * for diagnostic logging; it is auto-`end()`-ed via try/finally.
+ */
+export async function withInvokeSpan(args, exec, applyResult) {
+    const tracer = getTracer();
+    const telemetry = loadTelemetryConfig();
+    return tracer.startActiveSpan(SPAN_NAME, { kind: SpanKind.CLIENT }, async (span) => {
+        span.setAttributes({
+            [GenAi.SYSTEM]: args.provider,
+            [GenAi.REQUEST_MODEL]: args.model,
+            [GenAi.MESSAGES_COUNT]: args.systemPrompt ? 2 : 1,
+        });
+        if (telemetry.recordContent && args.prompt) {
+            span.setAttribute(GenAi.PROMPT, args.prompt.slice(0, PROMPT_TRUNCATE_BYTES));
+        }
+        try {
+            const result = await exec();
+            const attrs = applyResult(result);
+            for (const [k, v] of Object.entries(attrs)) {
+                if (v !== undefined)
+                    span.setAttribute(k, v);
+            }
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.recordException(err);
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+const SPAN_NAME = 'gen_ai.invoke';
+const PROMPT_TRUNCATE_BYTES = 8192;
+/**
+ * Return an instrumented view of the adapter. The new object delegates all
+ * methods to the wrapped instance; only `run` gets a span around it. When
+ * telemetry is disabled, OTel's no-op tracer makes the wrapper effectively
+ * free (no allocations beyond a closure).
+ */
+export function instrumentModelAdapter(adapter) {
+    return new InstrumentedModelAdapter(adapter);
+}
+class InstrumentedModelAdapter {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    get provider() {
+        return this.inner.provider;
+    }
+    get capabilities() {
+        return this.inner.capabilities;
+    }
+    supportsModel(modelId) {
+        return this.inner.supportsModel(modelId);
+    }
+    getModelPricing(modelId) {
+        return this.inner.getModelPricing(modelId);
+    }
+    checkAvailability() {
+        return this.inner.checkAvailability();
+    }
+    kill() {
+        this.inner.kill?.();
+    }
+    async run(config, output) {
+        const tracer = getTracer();
+        const telemetry = loadTelemetryConfig();
+        return tracer.startActiveSpan(SPAN_NAME, { kind: SpanKind.CLIENT }, async (span) => {
+            span.setAttributes({
+                [GenAi.SYSTEM]: this.inner.provider,
+                [GenAi.REQUEST_MODEL]: config.model,
+                [GenAi.MESSAGES_COUNT]: 1,
+                [GenAi.TOOLS_COUNT]: config.allowedTools?.length ?? 0,
+                'anvil.stage': config.stage,
+                'anvil.persona': config.persona,
+                'anvil.session.resume': config.resume === true,
+                // Phase 9 — routing-decision attributes. Lets dashboards
+                // facet by routing tier and capability tier so users can
+                // tell at a glance how much work is going to local vs cloud.
+                'anvil.provider.tier': this.inner.capabilities.tier,
+                'anvil.provider.tool_use': this.inner.capabilities.toolUse,
+                ...(config.exclusiveSlot ? { 'anvil.local.exclusive_slot': true } : {}),
+                ...(config.toolExecutor ? { 'anvil.tool_executor.attached': true } : {}),
+                ...(typeof config.contextWindow === 'number'
+                    ? { 'anvil.context_window': config.contextWindow }
+                    : {}),
+            });
+            if (telemetry.recordContent) {
+                span.setAttribute(GenAi.PROMPT, config.userPrompt.slice(0, PROMPT_TRUNCATE_BYTES));
+            }
+            try {
+                const result = await this.inner.run(config, output);
+                // Compute the per-component breakdown from the central cost table.
+                // When the table doesn't know the model, breakdown.totalUsd is 0 —
+                // fall back to the adapter's costUsd so we never undercount in
+                // exported telemetry. (Decision O6: agent-core is the single source
+                // of truth, but only when it actually has data.)
+                const bd = calculateCostBreakdown(result.model, {
+                    inputTokens: result.inputTokens,
+                    outputTokens: result.outputTokens,
+                    cacheReadTokens: result.cacheReadTokens,
+                    cacheWriteTokens: result.cacheWriteTokens,
+                });
+                const totalUsd = bd.totalUsd > 0 ? bd.totalUsd : result.costUsd;
+                span.setAttributes({
+                    [GenAi.USAGE_INPUT_TOKENS]: result.inputTokens,
+                    [GenAi.USAGE_OUTPUT_TOKENS]: result.outputTokens,
+                    [GenAi.USAGE_COST_USD]: totalUsd,
+                    [GenAi.USAGE_COST_INPUT_USD]: bd.inputUsd,
+                    [GenAi.USAGE_COST_OUTPUT_USD]: bd.outputUsd,
+                    [GenAi.USAGE_COST_CACHE_READ_USD]: bd.cacheReadUsd,
+                    [GenAi.USAGE_COST_CACHE_WRITE_USD]: bd.cacheWriteUsd,
+                    [GenAi.RESPONSE_MODEL]: result.model,
+                    'anvil.duration_ms': result.durationMs,
+                });
+                if (result.sessionId) {
+                    span.setAttribute(GenAi.RESPONSE_ID, result.sessionId);
+                }
+                // Phase 3 — cache + reasoning + tool-call enrichment from
+                // per-adapter response parsing. Adapters that don't surface these
+                // simply leave the fields undefined; we don't fabricate zeros for
+                // providers where the data isn't reported.
+                if (typeof result.cacheReadTokens === 'number') {
+                    span.setAttribute(GenAi.USAGE_CACHE_READ_TOKENS, result.cacheReadTokens);
+                    const denom = result.inputTokens + result.cacheReadTokens;
+                    if (denom > 0) {
+                        span.setAttribute(GenAi.USAGE_CACHE_HIT_RATIO, result.cacheReadTokens / denom);
+                    }
+                }
+                if (typeof result.cacheWriteTokens === 'number') {
+                    span.setAttribute(GenAi.USAGE_CACHE_WRITE_TOKENS, result.cacheWriteTokens);
+                }
+                if (typeof result.reasoningTokens === 'number' && result.reasoningTokens > 0) {
+                    span.setAttribute(GenAi.REASONING_TOKENS, result.reasoningTokens);
+                }
+                if (typeof result.toolCallCount === 'number') {
+                    span.setAttribute('gen_ai.response.tool_call_count', result.toolCallCount);
+                }
+                if (telemetry.recordContent) {
+                    span.setAttribute(GenAi.COMPLETION, result.output.slice(0, PROMPT_TRUNCATE_BYTES));
+                }
+                // Mirror the span attrs into OTel metrics so Grafana can build
+                // counter/histogram dashboards. Failures here must not bubble —
+                // a metrics emit issue should never break the agent run.
+                try {
+                    recordGenAiCall({
+                        system: this.inner.provider,
+                        requestModel: config.model,
+                        responseModel: result.model,
+                        stage: config.stage,
+                        persona: config.persona,
+                        inputTokens: result.inputTokens,
+                        outputTokens: result.outputTokens,
+                        cacheReadTokens: result.cacheReadTokens ?? 0,
+                        cacheWriteTokens: result.cacheWriteTokens ?? 0,
+                        reasoningTokens: result.reasoningTokens,
+                        costInputUsd: bd.inputUsd,
+                        costOutputUsd: bd.outputUsd,
+                        costCacheReadUsd: bd.cacheReadUsd,
+                        costCacheWriteUsd: bd.cacheWriteUsd,
+                        costTotalUsd: totalUsd,
+                        durationMs: result.durationMs ?? 0,
+                    });
+                }
+                catch { /* never let metrics break a run */ }
+                span.setStatus({ code: SpanStatusCode.OK });
+                return result;
+            }
+            catch (err) {
+                span.recordException(err);
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+}
+//# sourceMappingURL=instrument.js.map

package/dist/telemetry/instrument.js.map

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

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * GenAI metrics — emits OTel metrics on every adapter call alongside the
+ * existing trace span. Mirrors the OTel GenAI semconv counters/histograms
+ * so dashboards built against any compliant collector keep working.
+ *
+ * Instruments:
+ *   - gen_ai.client.token.usage   (counter, by io_type ∈ input|output|cache_read|cache_write|reasoning)
+ *   - gen_ai.client.cost_usd      (counter, by component ∈ input|output|cache_read|cache_write|total)
+ *   - gen_ai.client.operation.duration  (histogram, ms)
+ *   - gen_ai.cache.hit_ratio      (gauge per call, 0–1)
+ *
+ * All instruments inherit the shared resource (service.name, anvil.run_id,
+ * etc.) registered in tracer.ts. Metrics shipping is gated on the same
+ * TelemetryConfig as traces — disabled telemetry produces no-op meters.
+ */
+export interface GenAiCallMetrics {
+    /** OTel `gen_ai.system` (provider) — e.g. 'claude', 'gemini'. */
+    system: string;
+    /** Model identifier sent in the request. */
+    requestModel: string;
+    /** Model identifier returned in the response (often resolved/aliased). */
+    responseModel?: string;
+    /** Anvil-specific labels — kept on metric attributes for slicing. */
+    stage?: string;
+    persona?: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens?: number;
+    /** USD cost broken into components — every field is a delta to add. */
+    costInputUsd: number;
+    costOutputUsd: number;
+    costCacheReadUsd: number;
+    costCacheWriteUsd: number;
+    costTotalUsd: number;
+    /** Wall-clock duration of the call. */
+    durationMs: number;
+}
+/** Record one adapter call — emits all 4 instruments with consistent labels.
+ * Safe to call when telemetry is disabled (no-op meter eats the writes). */
+export declare function recordGenAiCall(m: GenAiCallMetrics): void;
+/** Force-flush any pending metric data and tear down the provider. */
+export declare function shutdownMetrics(): Promise<void>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/telemetry/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwJH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAsCzD;AAED,sEAAsE;AACtE,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD"}