@graphorin/observability 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @graphorin/observability
+
+## 0.1.0
+
+Initial release. See the workspace root `CHANGELOG.md` for the full
+release notes; the per-package changelog is generated by Changesets
+and tracks subsequent updates.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleksiy Stepurenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @graphorin/observability
+
+> Observability primitives for the [Graphorin](https://github.com/o-stepper/graphorin) framework.
+
+`@graphorin/observability` ships every cross-cutting tracing,
+redaction, replay, cost, and structured-logging primitive every other
+`@graphorin/*` package builds on. The package is intentionally
+opinionated: every exporter must be wrapped through
+`withValidation(...)` before it can ship a single span, the validator
+defaults to **default-deny non-public**, and the framework makes zero
+outbound network calls without an explicit user action.
+
+## Highlights
+
+- **Typed `AISpan<T>` tracer.** `createTracer({...})` returns a
+  `GraphorinTracer` that emits `AISpan<SpanType>` records compatible
+  with OpenTelemetry. Sampling rules + per-event sampling cover noisy
+  span kinds (`memory.embed`, `tool.execute.partial`, …).
+- **Mandatory `withValidation(...)` wrapper.** Every exporter passed to
+  `createTracer({ exporters })` is wrapped through the configured
+  `RedactionValidator`. Registering a raw exporter while
+  `validation: 'off'` triggers `UnvalidatedExporterError` at startup —
+  there is no silent path.
+- **`RedactionValidator` with 14 built-in patterns.** API key / JWT /
+  PEM private key / GitHub PAT / AWS access key / Graphorin token /
+  bearer header / basic-auth header / email / credit card / US SSN /
+  E.164 phone / IBAN — all on by default. Three additional patterns
+  (IPv4, IPv6, GCP service account) are opt-in.
+- **OpenTelemetry GenAI semantic-conventions conformance.**
+  `emitGenAIAttributes(span, {...})`, `emitGenAIMessageEvents(span, [...])`,
+  and `deriveGenAISystem(...)` ship the canonical
+  `gen_ai.*` attribute family alongside the existing
+  `graphorin.*` attributes — additive, never replacing.
+- **OpenInference span-kind layer.** `emitOpenInferenceKind(span)` emits
+  the `openinference.span.kind` attribute via the canonical
+  per-`SpanType` mapping (`agent.*` → `AGENT`,
+  `provider.*` → `LLM`, `tool.execute` → `TOOL`,
+  `memory.*` → `RETRIEVER` / `EMBEDDING`, `workflow.*` → `CHAIN`,
+  `agent.evaluator.iteration` → `EVALUATOR`).
+- **`ConsoleExporter`, `JSONLExporter`, `OTLPHttpExporter`.** The
+  built-in exporters cover dev (console), replay (append-only JSONL
+  with `0700` directories + `0600` files), and remote OTLP collectors
+  (`fetch`-based reference implementation, swappable `fetchImpl`).
+- **Sanitized-by-default `Replay`.** `createReplay({...})` exposes a
+  `run(...)` async iterator that yields `replay.start` /
+  `replay.event` / `replay.skipped` / `replay.end` markers. Raw mode
+  requires the `canReadRaw` callback to return `true` and emits an
+  audit-bridge entry on every invocation.
+- **Hierarchical `CostTracker`.** `createCostTracker({...})` rolls up
+  tokens + cost across parent-child spans and supports per-run /
+  per-session / per-agent / per-user budgets with an `onExceed`
+  callback.
+- **Structured logger.** `createLogger({...})` writes JSON or pretty
+  records, automatically correlates with the current span via
+  `withCurrentSpan(...)`, and pipes every field through the validator.
+- **Zero-default telemetry.** `getTelemetryStatus()` and
+  `announceTelemetryPosture()` expose the v0.1 promise: the framework
+  performs zero outbound network calls, no version pings, no crash
+  reports, no auto-updates. The `GRAPHORIN_TELEMETRY` and
+  `GRAPHORIN_NO_PHONE_HOME` environment variables are reserved for
+  forward compatibility and are acknowledged at startup.
+
+## Installation
+
+```bash
+pnpm add @graphorin/observability
+# Optional peer deps for OTLP export — install only when you need them:
+pnpm add @opentelemetry/api @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http
+```
+
+## Quick start
+
+```ts
+import {
+  createTracer,
+  createConsoleExporter,
+  createJSONLExporter,
+  withValidation,
+} from '@graphorin/observability';
+
+const tracer = createTracer({
+  serviceName: 'my-assistant',
+  exporters: [
+    // Auto-wrapped via the tracer-managed validator.
+    createConsoleExporter({ pretty: true }),
+    // Manually wrapped — useful when each exporter needs its own policy.
+    withValidation(createJSONLExporter({ path: './traces' }), {
+      minTier: 'internal',
+    }),
+  ],
+  validation: { minTier: 'public', failOnUnredactedSensitive: false },
+  sampling: {
+    rate: 1.0,
+    rules: [{ type: 'memory.embed', rate: 0.1 }],
+  },
+});
+
+await tracer.span(
+  { type: 'agent.run', attrs: { 'graphorin.agent.id': 'support-bot' } },
+  async (span) => {
+    span.setAttributes({ 'graphorin.session.id': 'session-123' });
+    return runAgent();
+  },
+);
+
+await tracer.shutdown();
+```
+
+## License
+
+MIT © 2026 [Oleksiy Stepurenko](https://github.com/o-stepper).
+
+---
+
+**Project Graphorin** · v0.5.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/cost/cost-tracker.d.ts

@@ -0,0 +1,28 @@
+import { CostRecordInput, CostScope, CostSnapshot, CostTrackerOptions } from "./types.js";
+
+//#region src/cost/cost-tracker.d.ts
+
+/**
+ * @stable
+ */
+interface CostTracker {
+  /** Record a single LLM-call usage / cost figure. */
+  record(input: CostRecordInput): void;
+  /** Snapshot for a given scope id. Returns zero figures when unknown. */
+  usage(scope: CostScope, id: string): CostSnapshot;
+  /** Snapshot for a single span id (carries nested attributions). */
+  usageForSpan(spanId: string): CostSnapshot;
+  /** Reset every counter back to zero. */
+  reset(): void;
+  /** Subscribe to per-scope rollup notifications. Returns an unsubscribe. */
+  onRollup(listener: (input: CostRecordInput) => void): () => void;
+}
+/**
+ * Build a {@link CostTracker} configured with the supplied budgets.
+ *
+ * @stable
+ */
+declare function createCostTracker(opts?: CostTrackerOptions): CostTracker;
+//#endregion
+export { CostTracker, createCostTracker };
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/cost/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","names":[],"sources":["../../src/cost/cost-tracker.ts"],"sourcesContent":[],"mappings":";;;;;;;UA2BiB,WAAA;;gBAED;;eAED,wBAAwB;;gCAEP;;;;6BAIH;;;;;;;iBAmGb,iBAAA,QAAwB,qBAA0B"}

package/dist/cost/cost-tracker.js

@@ -0,0 +1,169 @@
+//#region src/cost/cost-tracker.ts
+function freshBucket() {
+	return {
+		promptTokens: 0,
+		completionTokens: 0,
+		reasoningTokens: 0,
+		callCount: 0,
+		costAmount: 0,
+		costCurrency: null,
+		mixedCurrency: false,
+		byModel: /* @__PURE__ */ new Map(),
+		exceeded: false
+	};
+}
+function addCost(bucket, cost) {
+	if (bucket.costCurrency !== null && bucket.costCurrency !== cost.currency) bucket.mixedCurrency = true;
+	else if (bucket.costCurrency === null) bucket.costCurrency = cost.currency;
+	bucket.costAmount += cost.amount;
+}
+function combine(target, input) {
+	target.promptTokens += input.promptTokens;
+	target.completionTokens += input.completionTokens;
+	target.reasoningTokens += input.reasoningTokens ?? 0;
+	target.callCount += 1;
+	if (input.cost !== void 0) addCost(target, input.cost);
+	const modelBucket = target.byModel.get(input.model) ?? freshBucket();
+	modelBucket.promptTokens += input.promptTokens;
+	modelBucket.completionTokens += input.completionTokens;
+	modelBucket.reasoningTokens += input.reasoningTokens ?? 0;
+	modelBucket.callCount += 1;
+	if (input.cost !== void 0) addCost(modelBucket, input.cost);
+	target.byModel.set(input.model, modelBucket);
+}
+function snapshotOf(bucket) {
+	const cost = bucket.costCurrency === null ? null : {
+		amount: bucket.costAmount,
+		currency: bucket.costCurrency
+	};
+	return {
+		promptTokens: bucket.promptTokens,
+		completionTokens: bucket.completionTokens,
+		reasoningTokens: bucket.reasoningTokens,
+		totalTokens: bucket.promptTokens + bucket.completionTokens + bucket.reasoningTokens,
+		callCount: bucket.callCount,
+		cost,
+		mixedCurrency: bucket.mixedCurrency,
+		byModel: [...bucket.byModel.entries()].map(([model, b]) => ({
+			model,
+			promptTokens: b.promptTokens,
+			completionTokens: b.completionTokens,
+			reasoningTokens: b.reasoningTokens,
+			callCount: b.callCount,
+			cost: b.costCurrency === null ? null : {
+				amount: b.costAmount,
+				currency: b.costCurrency
+			},
+			mixedCurrency: b.mixedCurrency
+		}))
+	};
+}
+const ZERO = Object.freeze({
+	promptTokens: 0,
+	completionTokens: 0,
+	reasoningTokens: 0,
+	totalTokens: 0,
+	callCount: 0,
+	cost: null,
+	mixedCurrency: false,
+	byModel: []
+});
+/**
+* Build a {@link CostTracker} configured with the supplied budgets.
+*
+* @stable
+*/
+function createCostTracker(opts = {}) {
+	const budgets = opts.budgets ?? {};
+	const currency = budgets.currency ?? "USD";
+	const onExceed = opts.onExceed;
+	const bySpan = /* @__PURE__ */ new Map();
+	const byScope = {
+		run: /* @__PURE__ */ new Map(),
+		session: /* @__PURE__ */ new Map(),
+		agent: /* @__PURE__ */ new Map(),
+		user: /* @__PURE__ */ new Map()
+	};
+	const parents = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	function bump(scope, id, input) {
+		if (id === void 0) return;
+		const map = byScope[scope];
+		const bucket = map.get(id) ?? freshBucket();
+		combine(bucket, input);
+		map.set(id, bucket);
+		enforceBudget(scope, id, bucket, onExceed);
+	}
+	function enforceBudget(scope, id, bucket, cb) {
+		const limit = pickBudget(budgets, scope);
+		if (limit === void 0) return;
+		if (bucket.exceeded) return;
+		if (bucket.costAmount > limit) {
+			bucket.exceeded = true;
+			cb?.({
+				scope,
+				id,
+				budget: limit,
+				actual: bucket.costAmount,
+				currency: bucket.costCurrency ?? currency
+			});
+		}
+	}
+	return {
+		record(input) {
+			const spanBucket = bySpan.get(input.spanId) ?? freshBucket();
+			combine(spanBucket, input);
+			bySpan.set(input.spanId, spanBucket);
+			if (input.parentSpanId !== void 0) parents.set(input.spanId, input.parentSpanId);
+			const seen = /* @__PURE__ */ new Set();
+			let ancestor = parents.get(input.spanId);
+			while (ancestor !== void 0 && !seen.has(ancestor)) {
+				seen.add(ancestor);
+				const ancestorBucket = bySpan.get(ancestor) ?? freshBucket();
+				combine(ancestorBucket, input);
+				bySpan.set(ancestor, ancestorBucket);
+				ancestor = parents.get(ancestor);
+			}
+			bump("run", input.runId, input);
+			bump("session", input.sessionId, input);
+			bump("agent", input.agentId, input);
+			bump("user", input.userId, input);
+			for (const listener of listeners) try {
+				listener(input);
+			} catch {}
+		},
+		usage(scope, id) {
+			const bucket = byScope[scope].get(id);
+			if (bucket === void 0) return ZERO;
+			return snapshotOf(bucket);
+		},
+		usageForSpan(spanId) {
+			const bucket = bySpan.get(spanId);
+			if (bucket === void 0) return ZERO;
+			return snapshotOf(bucket);
+		},
+		reset() {
+			bySpan.clear();
+			for (const map of Object.values(byScope)) map.clear();
+			parents.clear();
+		},
+		onRollup(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+}
+function pickBudget(budgets, scope) {
+	switch (scope) {
+		case "session": return budgets.perSession;
+		case "user": return budgets.perUser;
+		case "agent": return budgets.perAgent;
+		case "run": return budgets.perRun;
+	}
+}
+
+//#endregion
+export { createCostTracker };
+//# sourceMappingURL=cost-tracker.js.map

package/dist/cost/cost-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","names":["cost: Cost | null","ZERO: CostSnapshot","budgets: CostBudgets","byScope: Record<CostScope, Map<string, AggregateBucket>>"],"sources":["../../src/cost/cost-tracker.ts"],"sourcesContent":["/**\n * `createCostTracker(...)` — aggregate token + cost figures across\n * spans and provide per-scope queries.\n *\n * The tracker preserves parent-child relationships: when\n * `record({ parentSpanId })` is supplied, the recorded usage is also\n * attributed to the ancestor span via the configured spans-by-id\n * lookup. Aggregations across runs / sessions / agents / users are\n * computed on demand.\n *\n * @packageDocumentation\n */\n\nimport type { Cost } from '@graphorin/core';\n\nimport type {\n  CostBudgetExceededCallback,\n  CostBudgets,\n  CostRecordInput,\n  CostScope,\n  CostSnapshot,\n  CostTrackerOptions,\n} from './types.js';\n\n/**\n * @stable\n */\nexport interface CostTracker {\n  /** Record a single LLM-call usage / cost figure. */\n  record(input: CostRecordInput): void;\n  /** Snapshot for a given scope id. Returns zero figures when unknown. */\n  usage(scope: CostScope, id: string): CostSnapshot;\n  /** Snapshot for a single span id (carries nested attributions). */\n  usageForSpan(spanId: string): CostSnapshot;\n  /** Reset every counter back to zero. */\n  reset(): void;\n  /** Subscribe to per-scope rollup notifications. Returns an unsubscribe. */\n  onRollup(listener: (input: CostRecordInput) => void): () => void;\n}\n\ninterface AggregateBucket {\n  promptTokens: number;\n  completionTokens: number;\n  reasoningTokens: number;\n  callCount: number;\n  costAmount: number;\n  costCurrency: string | null;\n  /** RP-22: set when records carrying differing currencies are aggregated. */\n  mixedCurrency: boolean;\n  byModel: Map<string, AggregateBucket>;\n  exceeded: boolean;\n}\n\nfunction freshBucket(): AggregateBucket {\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    reasoningTokens: 0,\n    callCount: 0,\n    costAmount: 0,\n    costCurrency: null,\n    mixedCurrency: false,\n    byModel: new Map(),\n    exceeded: false,\n  };\n}\n\n// RP-22: accumulate a cost without silently overwriting the currency. The\n// first currency seen is kept; a record in a different currency flags the\n// bucket as `mixedCurrency` so a USD + EUR total is never reported as one\n// clean figure.\nfunction addCost(bucket: AggregateBucket, cost: Cost): void {\n  if (bucket.costCurrency !== null && bucket.costCurrency !== cost.currency) {\n    bucket.mixedCurrency = true;\n  } else if (bucket.costCurrency === null) {\n    bucket.costCurrency = cost.currency;\n  }\n  bucket.costAmount += cost.amount;\n}\n\nfunction combine(target: AggregateBucket, input: CostRecordInput): void {\n  target.promptTokens += input.promptTokens;\n  target.completionTokens += input.completionTokens;\n  target.reasoningTokens += input.reasoningTokens ?? 0;\n  target.callCount += 1;\n  if (input.cost !== undefined) addCost(target, input.cost);\n  const modelBucket = target.byModel.get(input.model) ?? freshBucket();\n  modelBucket.promptTokens += input.promptTokens;\n  modelBucket.completionTokens += input.completionTokens;\n  modelBucket.reasoningTokens += input.reasoningTokens ?? 0;\n  modelBucket.callCount += 1;\n  if (input.cost !== undefined) addCost(modelBucket, input.cost);\n  target.byModel.set(input.model, modelBucket);\n}\n\nfunction snapshotOf(bucket: AggregateBucket): CostSnapshot {\n  const cost: Cost | null =\n    bucket.costCurrency === null\n      ? null\n      : { amount: bucket.costAmount, currency: bucket.costCurrency };\n  return {\n    promptTokens: bucket.promptTokens,\n    completionTokens: bucket.completionTokens,\n    reasoningTokens: bucket.reasoningTokens,\n    totalTokens: bucket.promptTokens + bucket.completionTokens + bucket.reasoningTokens,\n    callCount: bucket.callCount,\n    cost,\n    mixedCurrency: bucket.mixedCurrency,\n    byModel: [...bucket.byModel.entries()].map(([model, b]) => ({\n      model,\n      promptTokens: b.promptTokens,\n      completionTokens: b.completionTokens,\n      reasoningTokens: b.reasoningTokens,\n      callCount: b.callCount,\n      cost: b.costCurrency === null ? null : { amount: b.costAmount, currency: b.costCurrency },\n      mixedCurrency: b.mixedCurrency,\n    })),\n  };\n}\n\nconst ZERO: CostSnapshot = Object.freeze({\n  promptTokens: 0,\n  completionTokens: 0,\n  reasoningTokens: 0,\n  totalTokens: 0,\n  callCount: 0,\n  cost: null,\n  mixedCurrency: false,\n  byModel: [],\n});\n\n/**\n * Build a {@link CostTracker} configured with the supplied budgets.\n *\n * @stable\n */\nexport function createCostTracker(opts: CostTrackerOptions = {}): CostTracker {\n  const budgets: CostBudgets = opts.budgets ?? {};\n  const currency = budgets.currency ?? 'USD';\n  const onExceed = opts.onExceed;\n\n  const bySpan = new Map<string, AggregateBucket>();\n  const byScope: Record<CostScope, Map<string, AggregateBucket>> = {\n    run: new Map(),\n    session: new Map(),\n    agent: new Map(),\n    user: new Map(),\n  };\n\n  // Parent index: child span -> parent span. Used to roll attributions\n  // up the ancestor chain on every record call.\n  const parents = new Map<string, string>();\n  const listeners = new Set<(input: CostRecordInput) => void>();\n\n  function bump(scope: CostScope, id: string | undefined, input: CostRecordInput): void {\n    if (id === undefined) return;\n    const map = byScope[scope];\n    const bucket = map.get(id) ?? freshBucket();\n    combine(bucket, input);\n    map.set(id, bucket);\n    enforceBudget(scope, id, bucket, onExceed);\n  }\n\n  function enforceBudget(\n    scope: CostScope,\n    id: string,\n    bucket: AggregateBucket,\n    cb?: CostBudgetExceededCallback,\n  ): void {\n    const limit = pickBudget(budgets, scope);\n    if (limit === undefined) return;\n    if (bucket.exceeded) return;\n    if (bucket.costAmount > limit) {\n      bucket.exceeded = true;\n      cb?.({\n        scope,\n        id,\n        budget: limit,\n        actual: bucket.costAmount,\n        currency: bucket.costCurrency ?? currency,\n      });\n    }\n  }\n\n  return {\n    record(input: CostRecordInput): void {\n      // Record the raw span figures.\n      const spanBucket = bySpan.get(input.spanId) ?? freshBucket();\n      combine(spanBucket, input);\n      bySpan.set(input.spanId, spanBucket);\n\n      // Walk the ancestor chain so that the figures roll up to every\n      // parent span. The walker breaks if it encounters a cycle.\n      if (input.parentSpanId !== undefined) {\n        parents.set(input.spanId, input.parentSpanId);\n      }\n      const seen = new Set<string>();\n      let ancestor = parents.get(input.spanId);\n      while (ancestor !== undefined && !seen.has(ancestor)) {\n        seen.add(ancestor);\n        const ancestorBucket = bySpan.get(ancestor) ?? freshBucket();\n        combine(ancestorBucket, input);\n        bySpan.set(ancestor, ancestorBucket);\n        ancestor = parents.get(ancestor);\n      }\n\n      // Roll up to the requested aggregation scopes.\n      bump('run', input.runId, input);\n      bump('session', input.sessionId, input);\n      bump('agent', input.agentId, input);\n      bump('user', input.userId, input);\n\n      for (const listener of listeners) {\n        try {\n          listener(input);\n        } catch {\n          // Listeners must never break the tracker.\n        }\n      }\n    },\n    usage(scope: CostScope, id: string): CostSnapshot {\n      const bucket = byScope[scope].get(id);\n      if (bucket === undefined) return ZERO;\n      return snapshotOf(bucket);\n    },\n    usageForSpan(spanId: string): CostSnapshot {\n      const bucket = bySpan.get(spanId);\n      if (bucket === undefined) return ZERO;\n      return snapshotOf(bucket);\n    },\n    reset(): void {\n      bySpan.clear();\n      for (const map of Object.values(byScope)) {\n        map.clear();\n      }\n      parents.clear();\n    },\n    onRollup(listener): () => void {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\nfunction pickBudget(budgets: CostBudgets, scope: CostScope): number | undefined {\n  switch (scope) {\n    case 'session':\n      return budgets.perSession;\n    case 'user':\n      return budgets.perUser;\n    case 'agent':\n      return budgets.perAgent;\n    case 'run':\n      return budgets.perRun;\n  }\n}\n"],"mappings":"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"}

package/dist/cost/index.d.ts

@@ -0,0 +1,3 @@
+import { CostBudgetExceededCallback, CostBudgets, CostRecordInput, CostScope, CostSnapshot, CostTrackerOptions } from "./types.js";
+import { CostTracker, createCostTracker } from "./cost-tracker.js";
+export { type CostBudgetExceededCallback, type CostBudgets, type CostRecordInput, type CostScope, type CostSnapshot, type CostTracker, type CostTrackerOptions, createCostTracker };

package/dist/cost/index.js

@@ -0,0 +1,3 @@
+import { createCostTracker } from "./cost-tracker.js";
+
+export { createCostTracker };

package/dist/cost/types.d.ts

@@ -0,0 +1,104 @@
+import { Cost } from "@graphorin/core";
+
+//#region src/cost/types.d.ts
+
+/**
+ * Aggregation scope used by {@link CostTracker.usage}. The framework
+ * tracks four canonical scopes; deployments needing additional
+ * dimensions can build them by registering listeners on
+ * `CostTracker.onRollup(...)`.
+ *
+ * @stable
+ */
+type CostScope = 'run' | 'session' | 'agent' | 'user';
+/**
+ * Per-call usage record fed into {@link CostTracker.record}.
+ *
+ * @stable
+ */
+interface CostRecordInput {
+  readonly model: string;
+  readonly promptTokens: number;
+  readonly completionTokens: number;
+  readonly reasoningTokens?: number;
+  readonly cost?: Cost;
+  /** Span id; used to thread parent-child rollups. */
+  readonly spanId: string;
+  /** Optional parent span id (when the call is part of a nested run). */
+  readonly parentSpanId?: string;
+  readonly runId?: string;
+  readonly sessionId?: string;
+  readonly agentId?: string;
+  readonly userId?: string;
+}
+/**
+ * Snapshot returned by {@link CostTracker.usage}.
+ *
+ * @stable
+ */
+interface CostSnapshot {
+  readonly totalTokens: number;
+  readonly promptTokens: number;
+  readonly completionTokens: number;
+  readonly reasoningTokens: number;
+  readonly callCount: number;
+  readonly cost: Cost | null;
+  /**
+   * RP-22: `true` when records carrying differing currencies were aggregated
+   * into this snapshot. `cost.amount` is then a sum across currencies and must
+   * not be treated as a single clean figure.
+   */
+  readonly mixedCurrency: boolean;
+  readonly byModel: ReadonlyArray<{
+    readonly model: string;
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly reasoningTokens: number;
+    readonly callCount: number;
+    readonly cost: Cost | null;
+    readonly mixedCurrency: boolean;
+  }>;
+}
+/**
+ * Budget configuration shape consumed by {@link createCostTracker}.
+ *
+ * @stable
+ */
+interface CostBudgets {
+  /** Per-session budget in the configured currency. */
+  readonly perSession?: number;
+  /** Per-user budget. */
+  readonly perUser?: number;
+  /** Per-agent budget. */
+  readonly perAgent?: number;
+  /** Per-run budget. */
+  readonly perRun?: number;
+  /** Currency. Defaults to `'USD'`. */
+  readonly currency?: string;
+}
+/**
+ * Callback invoked when an aggregation scope crosses its configured
+ * budget. The handler receives a sanitized payload — the secret-free
+ * scope id + the breached numbers.
+ *
+ * @stable
+ */
+type CostBudgetExceededCallback = (event: {
+  readonly scope: CostScope;
+  readonly id: string;
+  readonly budget: number;
+  readonly actual: number;
+  readonly currency: string;
+}) => void;
+/**
+ * Configuration shape for {@link createCostTracker}.
+ *
+ * @stable
+ */
+interface CostTrackerOptions {
+  readonly budgets?: CostBudgets;
+  readonly onExceed?: CostBudgetExceededCallback;
+}
+//#endregion
+export { CostBudgetExceededCallback, CostBudgets, CostRecordInput, CostScope, CostSnapshot, CostTrackerOptions };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/cost/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyEA;AAoBA;AAaA;;KA1FY,SAAA;;;;;;UAOK,eAAA;;;;;kBAKC;;;;;;;;;;;;;;;UAgBD,YAAA;;;;;;iBAMA;;;;;;;oBAOG;;;;;;mBAMD;;;;;;;;;UAUF,WAAA;;;;;;;;;;;;;;;;;;;KAoBL,0BAAA;kBACM;;;;;;;;;;;UAYD,kBAAA;qBACI;sBACC"}

package/dist/eval/index.d.ts

@@ -0,0 +1,3 @@
+import { Case, Dataset, EvalCaseResult, EvalReport, RunEvalOptions, ScoreResult, Scorer } from "./types.js";
+import { runEval } from "./runner.js";
+export { type Case, type Dataset, type EvalCaseResult, type EvalReport, type RunEvalOptions, type ScoreResult, type Scorer, runEval };

package/dist/eval/index.js

@@ -0,0 +1,3 @@
+import { runEval } from "./runner.js";
+
+export { runEval };

package/dist/eval/runner.d.ts

@@ -0,0 +1,11 @@
+import { EvalReport, RunEvalOptions } from "./types.js";
+
+//#region src/eval/runner.d.ts
+
+/**
+ * @stable
+ */
+declare function runEval<I, O>(opts: RunEvalOptions<I, O>): Promise<EvalReport<I, O>>;
+//#endregion
+export { runEval };
+//# sourceMappingURL=runner.d.ts.map

package/dist/eval/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","names":[],"sources":["../../src/eval/runner.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAwBsB,oBAAoB,eAAe,GAAG,KAAK,QAAQ,WAAW,GAAG"}

package/dist/eval/runner.js

@@ -0,0 +1,113 @@
+//#region src/eval/runner.ts
+/**
+* @stable
+*/
+async function runEval(opts) {
+	const iterations = Math.max(1, opts.iterations ?? 1);
+	const signal = opts.signal;
+	const results = [];
+	for (let iter = 0; iter < iterations; iter++) for (let idx = 0; idx < opts.dataset.cases.length; idx++) {
+		throwIfAborted(signal);
+		const sampleCase = opts.dataset.cases[idx];
+		if (sampleCase === void 0) continue;
+		const baseId = sampleCase.id ?? `case-${idx}`;
+		const caseId = iterations === 1 ? baseId : `${baseId}-iter-${iter}`;
+		const startedAt = Date.now();
+		const output = await opts.agent.run(sampleCase.input);
+		const durationMs = Date.now() - startedAt;
+		const scores = [];
+		for (const scorer of opts.scorers) {
+			throwIfAborted(signal);
+			const result = await safeScore(scorer, sampleCase, output, durationMs);
+			scores.push({
+				scorer: scorer.name,
+				result
+			});
+		}
+		results.push({
+			caseId,
+			input: sampleCase.input,
+			output,
+			durationMs,
+			scores
+		});
+	}
+	return summarize(results, opts.scorers);
+}
+async function safeScore(scorer, c, output, durationMs) {
+	try {
+		return await scorer.score({
+			case: c,
+			output,
+			durationMs
+		});
+	} catch (err) {
+		return {
+			pass: false,
+			reason: `Scorer "${scorer.name}" threw: ${err instanceof Error ? err.message : String(err)}`
+		};
+	}
+}
+function summarize(results, scorers) {
+	const total = results.length;
+	let passed = 0;
+	let failed = 0;
+	let durationSum = 0;
+	const byScorer = {};
+	for (const scorer of scorers) byScorer[scorer.name] = {
+		passed: 0,
+		failed: 0,
+		scoreSum: 0,
+		scoreCount: 0
+	};
+	for (const r of results) {
+		durationSum += r.durationMs;
+		let passEntire = true;
+		for (const { scorer, result } of r.scores) {
+			const bucket = byScorer[scorer] ?? {
+				passed: 0,
+				failed: 0,
+				scoreSum: 0,
+				scoreCount: 0
+			};
+			if (result.pass) bucket.passed += 1;
+			else {
+				bucket.failed += 1;
+				passEntire = false;
+			}
+			if (typeof result.score === "number" && Number.isFinite(result.score)) {
+				bucket.scoreSum += result.score;
+				bucket.scoreCount += 1;
+			}
+			byScorer[scorer] = bucket;
+		}
+		if (passEntire) passed += 1;
+		else failed += 1;
+	}
+	const summaryByScorer = {};
+	for (const [scorer, b] of Object.entries(byScorer)) summaryByScorer[scorer] = {
+		passed: b.passed,
+		failed: b.failed,
+		avgScore: b.scoreCount === 0 ? null : b.scoreSum / b.scoreCount
+	};
+	return {
+		results,
+		summary: {
+			total,
+			passed,
+			failed,
+			avgDurationMs: total === 0 ? 0 : durationSum / total,
+			byScorer: Object.freeze(summaryByScorer)
+		}
+	};
+}
+function throwIfAborted(signal) {
+	if (signal?.aborted === true) {
+		const reason = signal.reason;
+		throw reason instanceof Error ? reason : /* @__PURE__ */ new Error("Eval run aborted");
+	}
+}
+
+//#endregion
+export { runEval };
+//# sourceMappingURL=runner.js.map

package/dist/eval/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","names":["results: EvalCaseResult<I, O>[]","scores: EvalCaseResult<I, O>['scores'][number][]","byScorer: Record<\n    string,\n    { passed: number; failed: number; scoreSum: number; scoreCount: number }\n  >","summaryByScorer: Record<\n    string,\n    { passed: number; failed: number; avgScore: number | null }\n  >"],"sources":["../../src/eval/runner.ts"],"sourcesContent":["/**\n * `runEval(...)` — minimal inline eval runner. Walks every case in\n * the dataset, calls `agent.run(case.input)`, applies every supplied\n * scorer, and returns an aggregated {@link EvalReport}.\n *\n * The runner is deliberately tiny — it has no parallelism, no\n * retries, no reporters, no dataset loaders. Production scenarios\n * that need any of those should `pnpm add @graphorin/evals` (post-MVP).\n *\n * @packageDocumentation\n */\n\nimport type {\n  Case,\n  EvalCaseResult,\n  EvalReport,\n  RunEvalOptions,\n  ScoreResult,\n  Scorer,\n} from './types.js';\n\n/**\n * @stable\n */\nexport async function runEval<I, O>(opts: RunEvalOptions<I, O>): Promise<EvalReport<I, O>> {\n  const iterations = Math.max(1, opts.iterations ?? 1);\n  const signal = opts.signal;\n  const results: EvalCaseResult<I, O>[] = [];\n\n  for (let iter = 0; iter < iterations; iter++) {\n    for (let idx = 0; idx < opts.dataset.cases.length; idx++) {\n      throwIfAborted(signal);\n      const sampleCase = opts.dataset.cases[idx];\n      if (sampleCase === undefined) continue;\n      // EB-6: disambiguate a caller-provided id per iteration too, not just the\n      // synthetic fallback — otherwise iterations>1 emits duplicate caseIds.\n      const baseId = sampleCase.id ?? `case-${idx}`;\n      const caseId = iterations === 1 ? baseId : `${baseId}-iter-${iter}`;\n\n      const startedAt = Date.now();\n      const output = await opts.agent.run(sampleCase.input);\n      const durationMs = Date.now() - startedAt;\n\n      const scores: EvalCaseResult<I, O>['scores'][number][] = [];\n      for (const scorer of opts.scorers) {\n        throwIfAborted(signal);\n        const result = await safeScore(scorer, sampleCase, output, durationMs);\n        scores.push({ scorer: scorer.name, result });\n      }\n\n      results.push({\n        caseId,\n        input: sampleCase.input,\n        output,\n        durationMs,\n        scores,\n      });\n    }\n  }\n\n  return summarize(results, opts.scorers);\n}\n\nasync function safeScore<I, O>(\n  scorer: Scorer<I, O>,\n  c: Case<I, O>,\n  output: O,\n  durationMs: number,\n): Promise<ScoreResult> {\n  try {\n    return await scorer.score({ case: c, output, durationMs });\n  } catch (err) {\n    return {\n      pass: false,\n      reason: `Scorer \"${scorer.name}\" threw: ${err instanceof Error ? err.message : String(err)}`,\n    };\n  }\n}\n\nfunction summarize<I, O>(\n  results: ReadonlyArray<EvalCaseResult<I, O>>,\n  scorers: ReadonlyArray<Scorer<I, O>>,\n): EvalReport<I, O> {\n  const total = results.length;\n  let passed = 0;\n  let failed = 0;\n  let durationSum = 0;\n  const byScorer: Record<\n    string,\n    { passed: number; failed: number; scoreSum: number; scoreCount: number }\n  > = {};\n\n  for (const scorer of scorers) {\n    byScorer[scorer.name] = { passed: 0, failed: 0, scoreSum: 0, scoreCount: 0 };\n  }\n\n  for (const r of results) {\n    durationSum += r.durationMs;\n    let passEntire = true;\n    for (const { scorer, result } of r.scores) {\n      const bucket = byScorer[scorer] ?? { passed: 0, failed: 0, scoreSum: 0, scoreCount: 0 };\n      if (result.pass) bucket.passed += 1;\n      else {\n        bucket.failed += 1;\n        passEntire = false;\n      }\n      if (typeof result.score === 'number' && Number.isFinite(result.score)) {\n        bucket.scoreSum += result.score;\n        bucket.scoreCount += 1;\n      }\n      byScorer[scorer] = bucket;\n    }\n    if (passEntire) passed += 1;\n    else failed += 1;\n  }\n\n  const summaryByScorer: Record<\n    string,\n    { passed: number; failed: number; avgScore: number | null }\n  > = {};\n  for (const [scorer, b] of Object.entries(byScorer)) {\n    summaryByScorer[scorer] = {\n      passed: b.passed,\n      failed: b.failed,\n      avgScore: b.scoreCount === 0 ? null : b.scoreSum / b.scoreCount,\n    };\n  }\n\n  return {\n    results,\n    summary: {\n      total,\n      passed,\n      failed,\n      avgDurationMs: total === 0 ? 0 : durationSum / total,\n      byScorer: Object.freeze(summaryByScorer),\n    },\n  };\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted === true) {\n    const reason = signal.reason;\n    throw reason instanceof Error ? reason : new Error('Eval run aborted');\n  }\n}\n"],"mappings":";;;;AAwBA,eAAsB,QAAc,MAAuD;CACzF,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,cAAc,EAAE;CACpD,MAAM,SAAS,KAAK;CACpB,MAAMA,UAAkC,EAAE;AAE1C,MAAK,IAAI,OAAO,GAAG,OAAO,YAAY,OACpC,MAAK,IAAI,MAAM,GAAG,MAAM,KAAK,QAAQ,MAAM,QAAQ,OAAO;AACxD,iBAAe,OAAO;EACtB,MAAM,aAAa,KAAK,QAAQ,MAAM;AACtC,MAAI,eAAe,OAAW;EAG9B,MAAM,SAAS,WAAW,MAAM,QAAQ;EACxC,MAAM,SAAS,eAAe,IAAI,SAAS,GAAG,OAAO,QAAQ;EAE7D,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,SAAS,MAAM,KAAK,MAAM,IAAI,WAAW,MAAM;EACrD,MAAM,aAAa,KAAK,KAAK,GAAG;EAEhC,MAAMC,SAAmD,EAAE;AAC3D,OAAK,MAAM,UAAU,KAAK,SAAS;AACjC,kBAAe,OAAO;GACtB,MAAM,SAAS,MAAM,UAAU,QAAQ,YAAY,QAAQ,WAAW;AACtE,UAAO,KAAK;IAAE,QAAQ,OAAO;IAAM;IAAQ,CAAC;;AAG9C,UAAQ,KAAK;GACX;GACA,OAAO,WAAW;GAClB;GACA;GACA;GACD,CAAC;;AAIN,QAAO,UAAU,SAAS,KAAK,QAAQ;;AAGzC,eAAe,UACb,QACA,GACA,QACA,YACsB;AACtB,KAAI;AACF,SAAO,MAAM,OAAO,MAAM;GAAE,MAAM;GAAG;GAAQ;GAAY,CAAC;UACnD,KAAK;AACZ,SAAO;GACL,MAAM;GACN,QAAQ,WAAW,OAAO,KAAK,WAAW,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GAC3F;;;AAIL,SAAS,UACP,SACA,SACkB;CAClB,MAAM,QAAQ,QAAQ;CACtB,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,cAAc;CAClB,MAAMC,WAGF,EAAE;AAEN,MAAK,MAAM,UAAU,QACnB,UAAS,OAAO,QAAQ;EAAE,QAAQ;EAAG,QAAQ;EAAG,UAAU;EAAG,YAAY;EAAG;AAG9E,MAAK,MAAM,KAAK,SAAS;AACvB,iBAAe,EAAE;EACjB,IAAI,aAAa;AACjB,OAAK,MAAM,EAAE,QAAQ,YAAY,EAAE,QAAQ;GACzC,MAAM,SAAS,SAAS,WAAW;IAAE,QAAQ;IAAG,QAAQ;IAAG,UAAU;IAAG,YAAY;IAAG;AACvF,OAAI,OAAO,KAAM,QAAO,UAAU;QAC7B;AACH,WAAO,UAAU;AACjB,iBAAa;;AAEf,OAAI,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,OAAO,MAAM,EAAE;AACrE,WAAO,YAAY,OAAO;AAC1B,WAAO,cAAc;;AAEvB,YAAS,UAAU;;AAErB,MAAI,WAAY,WAAU;MACrB,WAAU;;CAGjB,MAAMC,kBAGF,EAAE;AACN,MAAK,MAAM,CAAC,QAAQ,MAAM,OAAO,QAAQ,SAAS,CAChD,iBAAgB,UAAU;EACxB,QAAQ,EAAE;EACV,QAAQ,EAAE;EACV,UAAU,EAAE,eAAe,IAAI,OAAO,EAAE,WAAW,EAAE;EACtD;AAGH,QAAO;EACL;EACA,SAAS;GACP;GACA;GACA;GACA,eAAe,UAAU,IAAI,IAAI,cAAc;GAC/C,UAAU,OAAO,OAAO,gBAAgB;GACzC;EACF;;AAGH,SAAS,eAAe,QAAuC;AAC7D,KAAI,QAAQ,YAAY,MAAM;EAC5B,MAAM,SAAS,OAAO;AACtB,QAAM,kBAAkB,QAAQ,yBAAS,IAAI,MAAM,mBAAmB"}