@armoriq/sdk-dev 0.8.0 → 0.8.3

package/dist/token_usage.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.summarizeTranscriptUsage = summarizeTranscriptUsage;
+exports.summarizeTranscriptUsageByDay = summarizeTranscriptUsageByDay;
 /**
  * Token-usage capture — shared across all ArmorIQ tool integrations
  * (ArmorClaude / ArmorCodex / ArmorCopilot / future agents).
@@ -39,14 +40,51 @@ function safeEmit(fn) {
  * failure never affects the returned entries.
  */
 async function summarizeTranscriptUsage(transcriptPath, otel) {
+    const { days } = readTranscriptUsage(transcriptPath);
+    const entries = mergeEntries(days.flatMap((day) => day.entries));
+    await emitModelSpans(entries, otel ?? null);
+    return entries;
+}
+/**
+ * Same parse as `summarizeTranscriptUsage`, split by the UTC day each message
+ * was sent and carrying the transcript's working directory. Posting one row per
+ * day keeps a multi-day session's tokens on the days they were spent.
+ */
+function summarizeTranscriptUsageByDay(transcriptPath) {
+    return readTranscriptUsage(transcriptPath);
+}
+function emptyEntry(model) {
+    return { model, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 };
+}
+function addInto(acc, e) {
+    acc.inputTokens += e.inputTokens;
+    acc.outputTokens += e.outputTokens;
+    acc.cacheReadTokens += e.cacheReadTokens;
+    acc.cacheWriteTokens += e.cacheWriteTokens;
+}
+function mergeEntries(entries) {
+    const byModel = new Map();
+    for (const e of entries) {
+        const acc = byModel.get(e.model) ?? emptyEntry(e.model);
+        addInto(acc, e);
+        byModel.set(e.model, acc);
+    }
+    return [...byModel.values()];
+}
+function readTranscriptUsage(transcriptPath) {
     let raw;
     try {
         raw = (0, fs_1.readFileSync)(transcriptPath, 'utf8');
     }
     catch {
-        return [];
+        return { days: [] };
     }
-    const byModel = new Map();
+    const byDay = new Map();
+    // Claude Code writes one line per content block of an assistant message, each
+    // repeating that message's full usage. Count each message once.
+    const seen = new Set();
+    let repo;
+    let lastDay;
     for (const line of raw.split('\n')) {
         const trimmed = line.trim();
         if (!trimmed)
@@ -58,37 +96,80 @@ async function summarizeTranscriptUsage(transcriptPath, otel) {
         catch {
             continue;
         }
-        // Tolerate both Anthropic (Claude Code) and OpenAI (Codex CLI) shapes, and
-        // common nestings (top-level, message.*, payload.*).
-        const msg = obj?.message ?? obj?.payload ?? obj;
+        if (!repo && typeof obj?.cwd === 'string' && obj.cwd)
+            repo = obj.cwd;
+        const day = utcDay(obj?.timestamp) ?? lastDay;
+        if (day)
+            lastDay = day;
+        const msg = firstObject(obj?.message, obj?.payload) ?? obj;
         const usage = msg?.usage ?? obj?.usage;
         const model = typeof msg?.model === 'string' ? msg.model : typeof obj?.model === 'string' ? obj.model : '';
         if (!usage || !model || model === '<synthetic>')
             continue;
-        // Anthropic: input_tokens/output_tokens; OpenAI: prompt_tokens/completion_tokens.
-        const inTok = Number(usage.input_tokens ?? usage.prompt_tokens) || 0;
-        const outTok = Number(usage.output_tokens ?? usage.completion_tokens) || 0;
-        const cacheRead = Number(usage.cache_read_input_tokens ?? usage.prompt_tokens_details?.cached_tokens) || 0;
-        const cacheWrite = Number(usage.cache_creation_input_tokens) || 0;
+        const messageId = typeof msg?.id === 'string' ? msg.id : '';
+        if (messageId) {
+            const key = `${messageId}:${typeof obj?.requestId === 'string' ? obj.requestId : ''}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+        }
+        const inTok = tokenCount(usage.input_tokens ?? usage.prompt_tokens);
+        const outTok = tokenCount(usage.output_tokens ?? usage.completion_tokens);
+        const cacheRead = tokenCount(usage.cache_read_input_tokens ?? usage.prompt_tokens_details?.cached_tokens);
+        const cacheWrite = tokenCount(usage.cache_creation_input_tokens);
         if (inTok + outTok + cacheRead + cacheWrite === 0)
             continue;
-        const acc = byModel.get(model) ||
-            {
-                model,
-                inputTokens: 0,
-                outputTokens: 0,
-                cacheReadTokens: 0,
-                cacheWriteTokens: 0,
-            };
-        acc.inputTokens += inTok;
-        acc.outputTokens += outTok;
-        acc.cacheReadTokens += cacheRead;
-        acc.cacheWriteTokens += cacheWrite;
-        byModel.set(model, acc);
+        const bucketKey = day ?? '';
+        let models = byDay.get(bucketKey);
+        if (!models) {
+            models = new Map();
+            byDay.set(bucketKey, models);
+        }
+        const acc = models.get(model) ?? emptyEntry(model);
+        addInto(acc, {
+            model,
+            inputTokens: inTok,
+            outputTokens: outTok,
+            cacheReadTokens: cacheRead,
+            cacheWriteTokens: cacheWrite,
+        });
+        models.set(model, acc);
     }
-    const entries = [...byModel.values()];
-    await emitModelSpans(entries, otel ?? null);
-    return entries;
+    // Lines before the first timestamp belong to the first dated day.
+    const undated = byDay.get('');
+    byDay.delete('');
+    const dates = [...byDay.keys()].sort();
+    if (undated) {
+        const target = dates[0] ?? new Date().toISOString().slice(0, 10);
+        const models = byDay.get(target) ?? new Map();
+        for (const e of undated.values()) {
+            const acc = models.get(e.model) ?? emptyEntry(e.model);
+            addInto(acc, e);
+            models.set(e.model, acc);
+        }
+        byDay.set(target, models);
+    }
+    const days = [...byDay.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([usageDate, models]) => ({ usageDate, entries: [...models.values()] }));
+    return repo ? { days, repo } : { days };
+}
+// A timestamp with no offset is read as UTC, not the machine's zone, so every
+// machine files the same message under the same day (matches the Python SDK).
+function utcDay(timestamp) {
+    if (typeof timestamp !== 'string' || !timestamp)
+        return undefined;
+    const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(timestamp.trim());
+    const d = new Date(hasZone || !timestamp.includes('T') ? timestamp : `${timestamp}Z`);
+    return Number.isNaN(d.getTime()) ? undefined : d.toISOString().slice(0, 10);
+}
+/** Whole, non-negative token count; anything unparseable counts as 0. */
+function tokenCount(value) {
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+function firstObject(...values) {
+    return values.find((v) => v !== null && typeof v === 'object' && Object.keys(v).length > 0);
 }
 /**
  * Emit one native `gen_ai.chat` model span per per-model usage entry via

package/dist/token_usage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armoriq/sdk-dev",
-  "version": "0.8.0",
+  "version": "0.8.3",
   "description": "ArmorIQ SDK - Build secure AI agents with cryptographic intent verification.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/observability/handle.d.ts

@@ -1,41 +0,0 @@
-/**
- * Standalone helper API for the chokepoints.
- *
- * The session chokepoints (in `src/session.ts`, owned by the peer subagent)
- * call these helpers instead of going through `ObservabilityRecorder` methods
- * directly. The wrapper signature is uniform:
- *
- *   const ctx = startTrace(obs, 'iap.enforce', { toolName });
- *   recordPolicyCall(obs, ctx, { ... });
- *   endTrace(obs, ctx, { status: 'ok' });
- *
- * All helpers are thin pass-throughs to the recorder — they're the
- * stable interface the chokepoints can import without needing to know
- * about the recorder's internal class shape.
- */
-import { type ObservabilityRecorder } from './recorder';
-import type { TraceContext, SpanRecord } from './schema';
-export declare function startTrace(recorder: ObservabilityRecorder, name: string, attributes?: Record<string, unknown>, sessionId?: string | null): TraceContext;
-export declare function recordSpan(recorder: ObservabilityRecorder, ctx: TraceContext, span: SpanRecord): void;
-export declare function recordPolicyCall(recorder: ObservabilityRecorder, ctx: TraceContext, attrs: Parameters<ObservabilityRecorder['recordPolicyCall']>[1], parentSpanId?: string | null): SpanRecord;
-export declare function recordGeneration(recorder: ObservabilityRecorder, ctx: TraceContext, attrs: Parameters<ObservabilityRecorder['recordGeneration']>[1], parentSpanId?: string | null): SpanRecord;
-export declare function recordEvent(recorder: ObservabilityRecorder, ctx: TraceContext, attrs: {
-    message: string;
-    level?: 'info' | 'warn' | 'error';
-}, parentSpanId?: string | null): SpanRecord;
-export declare function openSpan(recorder: ObservabilityRecorder, ctx: TraceContext, opts: {
-    name: string;
-    attributes?: Record<string, unknown>;
-    parentSpanId?: string | null;
-}): string;
-export declare function closeSpan(recorder: ObservabilityRecorder, ctx: TraceContext, spanId: string, opts?: {
-    status?: 'ok' | 'error' | 'denied';
-    durationMs?: number;
-    errorMessage?: string;
-}): void;
-export declare function endTrace(recorder: ObservabilityRecorder, ctx: TraceContext, opts?: {
-    status?: 'ok' | 'error' | 'denied';
-    errorMessage?: string;
-}): void;
-export declare function flushObservability(recorder: ObservabilityRecorder): Promise<void>;
-//# sourceMappingURL=handle.d.ts.map

package/dist/observability/handle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/observability/handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,wBAAgB,UAAU,CACxB,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,YAAY,CAEd;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,UAAU,GACf,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,UAAU,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,UAAU,CAEZ;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,UAAU,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,UAAU,CAEZ;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,EAC7D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,UAAU,CAEZ;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzF,MAAM,CAER;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF,IAAI,CAEN;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,qBAAqB,EAC/B,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,IAAI,CAEN;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/observability/handle.js

@@ -1,54 +0,0 @@
-"use strict";
-/**
- * Standalone helper API for the chokepoints.
- *
- * The session chokepoints (in `src/session.ts`, owned by the peer subagent)
- * call these helpers instead of going through `ObservabilityRecorder` methods
- * directly. The wrapper signature is uniform:
- *
- *   const ctx = startTrace(obs, 'iap.enforce', { toolName });
- *   recordPolicyCall(obs, ctx, { ... });
- *   endTrace(obs, ctx, { status: 'ok' });
- *
- * All helpers are thin pass-throughs to the recorder — they're the
- * stable interface the chokepoints can import without needing to know
- * about the recorder's internal class shape.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startTrace = startTrace;
-exports.recordSpan = recordSpan;
-exports.recordPolicyCall = recordPolicyCall;
-exports.recordGeneration = recordGeneration;
-exports.recordEvent = recordEvent;
-exports.openSpan = openSpan;
-exports.closeSpan = closeSpan;
-exports.endTrace = endTrace;
-exports.flushObservability = flushObservability;
-function startTrace(recorder, name, attributes, sessionId) {
-    return recorder.startTrace(name, attributes, sessionId);
-}
-function recordSpan(recorder, ctx, span) {
-    recorder.recordSpan(ctx, span);
-}
-function recordPolicyCall(recorder, ctx, attrs, parentSpanId) {
-    return recorder.recordPolicyCall(ctx, attrs, parentSpanId);
-}
-function recordGeneration(recorder, ctx, attrs, parentSpanId) {
-    return recorder.recordGeneration(ctx, attrs, parentSpanId);
-}
-function recordEvent(recorder, ctx, attrs, parentSpanId) {
-    return recorder.recordEvent(ctx, attrs, parentSpanId);
-}
-function openSpan(recorder, ctx, opts) {
-    return recorder.openSpan(ctx, opts);
-}
-function closeSpan(recorder, ctx, spanId, opts) {
-    recorder.closeSpan(ctx, spanId, opts);
-}
-function endTrace(recorder, ctx, opts) {
-    recorder.endTrace(ctx, opts);
-}
-async function flushObservability(recorder) {
-    await recorder.flush();
-}
-//# sourceMappingURL=handle.js.map

package/dist/observability/handle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/observability/handle.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAUH,gCAOC;AAED,gCAMC;AAED,4CAOC;AAED,4CAOC;AAED,kCAOC;AAED,4BAMC;AAED,8BAOC;AAED,4BAMC;AAED,gDAIC;AAzED,SAAgB,UAAU,CACxB,QAA+B,EAC/B,IAAY,EACZ,UAAoC,EACpC,SAAyB;IAEzB,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,UAAU,CACxB,QAA+B,EAC/B,GAAiB,EACjB,IAAgB;IAEhB,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,gBAAgB,CAC9B,QAA+B,EAC/B,GAAiB,EACjB,KAA+D,EAC/D,YAA4B;IAE5B,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,gBAAgB,CAC9B,QAA+B,EAC/B,GAAiB,EACjB,KAA+D,EAC/D,YAA4B;IAE5B,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,WAAW,CACzB,QAA+B,EAC/B,GAAiB,EACjB,KAA6D,EAC7D,YAA4B;IAE5B,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,QAAQ,CACtB,QAA+B,EAC/B,GAAiB,EACjB,IAA0F;IAE1F,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,SAAS,CACvB,QAA+B,EAC/B,GAAiB,EACjB,MAAc,EACd,IAAyF;IAEzF,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,QAAQ,CACtB,QAA+B,EAC/B,GAAiB,EACjB,IAAoE;IAEpE,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,QAA+B;IAE/B,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/observability/recorder.d.ts

@@ -1,245 +0,0 @@
-/**
- * ObservabilityRecorder — in-memory ring buffer for traces + spans.
- *
- * The recorder is the only place in the SDK that mints trace/span IDs. The
- * session chokepoints (peer subagent's wrap) call `startTrace` /
- * `recordPolicyCall` / `endTrace` and the recorder takes care of:
- *   1. Validating each emit (cheap shape checks; bad data is logged + dropped,
- *      never thrown into the SDK consumer).
- *   2. Minting IDs and computing endTime/durationMs.
- *   3. Holding the in-memory ring buffer (default 1000 traces). On overflow,
- *      the oldest trace AND all its spans are dropped (we never want a partial
- *      trace at the backend).
- *   4. Pushing ended traces onto the shipper's queue.
- *   5. Forwarding every emit to the test sink (if set) so tests can assert
- *      on the exact lifecycle.
- *
- * Per plan §9 Q3: in-memory only. `durable: true` is parsed and stored but
- * does nothing in v1 — a one-time warning is logged the first time a
- * consumer opts in.
- */
-import { AxiosInstance } from 'axios';
-import { ObservabilityShipper } from './shipper';
-import { type SpanRecord, type SpanStatus, type TraceContext, type TraceRecord } from './schema';
-export interface ObservabilityConfig {
-    /** Master kill switch. Default: true. */
-    enabled: boolean;
-    /** Full URL of the ingest endpoint, e.g. https://api.armoriq.ai/observability/spans. */
-    endpoint: string;
-    /** API key used in the X-API-Key header. */
-    apiKey: string;
-    /** Product tag sent with every ingest payload (e.g. 'armorclaude' | 'armorcodex' | 'armorcopilot' | 'armorgemini'). */
-    product: string;
-    /**
-     * Default session id applied to every trace started on this recorder when
-     * the caller doesn't pass an explicit `sessionId` to `startTrace()`. This
-     * is how `ArmorIQSession` stamps ITS one stable (UUID) session id onto
-     * every trace uniformly, without every chokepoint having to pass it
-     * explicitly. Must be a valid UUID or `null` — the backend's
-     * `obs_sessions.id` column is a UUID column, so a non-UUID value can never
-     * form a session.
-     */
-    sessionId?: string | null;
-    /** SDK user id (denormalized onto every trace). May be null for multi-user flows. */
-    userId?: string | null;
-    /** SDK agent id (denormalized onto every trace). May be null for multi-user flows. */
-    agentId?: string | null;
-    /** Override the SDK's HTTP client (axios instance). Used for tests. */
-    httpClient?: AxiosInstance;
-    /** Max traces in the in-memory ring buffer. Default 1000. */
-    maxBufferSize?: number;
-    /** Auto-flush interval (ms). Default 5000. */
-    flushIntervalMs?: number;
-    /**
-     * Max batches per ingest POST. Default 100. The shipper chunks the queue
-     * into groups of at most this size at flush time, so a burst of traces
-     * never sends a single unbounded giant POST.
-     */
-    batchSize?: number;
-    /** Optional onSpan hook. Called for every span after it's validated. */
-    onSpan?: (span: SpanRecord) => void;
-    /** Disk-backed WAL opt-in. Parsed and stored; unused in v1. */
-    durable?: boolean;
-    /** Data dir for the future WAL. Stored; unused in v1. */
-    dataDir?: string;
-}
-export type SinkEvent = {
-    kind: 'trace_started';
-    trace: TraceRecord;
-    sessionId: string | null;
-} | {
-    kind: 'span_recorded';
-    traceId: string;
-    traceSessionId: string | null;
-    span: SpanRecord;
-} | {
-    kind: 'trace_ended';
-    trace: TraceRecord;
-    spans: SpanRecord[];
-};
-export type ObservabilitySink = (event: SinkEvent) => void;
-export declare function __setObservabilitySinkForTests(sink: ObservabilitySink | null): void;
-export declare class ObservabilityRecorder {
-    private readonly enabled;
-    private readonly product;
-    private readonly userId;
-    private readonly agentId;
-    private readonly defaultSessionId;
-    private readonly maxBufferSize;
-    private readonly onSpan?;
-    private readonly buffer;
-    private readonly bufferIndex;
-    private readonly shipper;
-    private warnedDurable;
-    constructor(config: ObservabilityConfig);
-    /** Internal accessor for tests; not part of the public API. */
-    get __shipper(): ObservabilityShipper;
-    /** True when the consumer passed `enabled: true` (the default). */
-    get isEnabled(): boolean;
-    /**
-     * Mint a new trace and return its context. The trace is added to the
-     * in-memory buffer (dropping the oldest if at capacity) and the context
-     * is passed to subsequent `recordSpan` / `endTrace` calls.
-     */
-    startTrace(name: string, attributes?: Record<string, unknown>, sessionId?: string | null): TraceContext;
-    /**
-     * Append a span to an existing trace. The span is validated against the
-     * wire schema; an invalid span is logged and dropped (never thrown).
-     */
-    recordSpan(ctx: TraceContext, span: SpanRecord): void;
-    /**
-     * Construct a `kind: 'policy_call'` span from the supplied fields and
-     * record it under the given trace. Returns the constructed span (useful
-     * for tests); otherwise the return value can be ignored.
-     */
-    recordPolicyCall(ctx: TraceContext, attrs: {
-        policyId: string | null;
-        policyName: string | null;
-        decision: 'allow' | 'deny' | 'hold' | 'ask';
-        reason: string | null;
-        source: 'native' | 'sdk-local' | 'sdk' | 'proxy' | 'opa' | 'opa_fallback';
-        input: unknown;
-        output: unknown;
-        policyHash?: string | null;
-        policyVersion?: string | null;
-        matchedRuleId?: string | null;
-        dataClasses?: string[];
-        enforcementAction?: 'allow' | 'allow_log' | 'hold' | 'block' | null;
-        obligations?: unknown;
-        delegationId?: string | null;
-        durationMs?: number | null;
-    }, parentSpanId?: string | null): SpanRecord;
-    /**
-     * Construct a `kind: 'generation'` span from the supplied fields,
-     * compute `costUsd` from the static price table, and record it.
-     * Unknown models yield costUsd=0 (the span is still recorded).
-     * Pass `costUsd` to override the computed value (e.g. when the caller
-     * already has a precomputed cost from a third-party billing system).
-     */
-    recordGeneration(ctx: TraceContext, attrs: {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        cacheReadTokens?: number | null;
-        cacheWriteTokens?: number | null;
-        prompt?: string | null;
-        completion?: string | null;
-        finishReason?: string | null;
-        costUsd?: number | null;
-    }, parentSpanId?: string | null): SpanRecord;
-    /**
-     * Record a `kind: 'event'` span — a point-in-time annotation (e.g.
-     * "plan growth", "approval polled"). Use sparingly; events are cheap
-     * but they still count toward the ring buffer.
-     */
-    recordEvent(ctx: TraceContext, attrs: {
-        message: string;
-        level?: 'info' | 'warn' | 'error';
-    }, parentSpanId?: string | null): SpanRecord;
-    /**
-     * Mint + record a `kind: 'span'` CONTAINER span — a nesting point that
-     * groups the child spans emitted by one chokepoint (e.g. `iap.enforce.local`)
-     * under the session's single active plan trace (Model A: trace-per-plan).
-     *
-     * The container starts open (`status: 'ok'`, `endTime: null`,
-     * `durationMs: null`) and MUST be finalized with `closeSpan()` once the
-     * chokepoint's work completes (success or error). A container span with a
-     * null `endTime` is intentionally valid mid-flight — see
-     * `isValidGenericSpanAttributes`/`isValidSpanRecord`, which permit a
-     * null `endTime`/`durationMs` for exactly this reason (Task 1 risk #1).
-     *
-     * Returns the minted span id — even when the recorder is disabled, so
-     * call sites can pass it along unconditionally as a `parentSpanId` to
-     * `recordPolicyCall`/`recordGeneration`/`recordEvent` without special-casing
-     * the disabled path.
-     */
-    openSpan(ctx: TraceContext, opts: {
-        name: string;
-        attributes?: Record<string, unknown>;
-        parentSpanId?: string | null;
-    }): string;
-    /**
-     * Finalize a container span previously opened with `openSpan()`: sets
-     * `endTime`, optionally `durationMs`/`status`/`attributes.errorMessage`.
-     * No-op (never throws) when the recorder is disabled, the trace is
-     * unknown, or the spanId doesn't match a buffered span (e.g. it already
-     * shipped) — mirrors `endTrace`'s defensive lookup.
-     */
-    closeSpan(ctx: TraceContext, spanId: string, opts?: {
-        status?: SpanStatus;
-        durationMs?: number;
-        errorMessage?: string;
-    }): void;
-    /**
-     * Finalize a trace: set endTime, compute durationMs, apply optional
-     * status / errorMessage. Pushes the (trace, spans) batch to the
-     * shipper's queue, then REMOVES the entry from the in-memory ring buffer
-     * — once a trace has been handed to the shipper, the shipper's own queue
-     * is the durable record; keeping a second copy in the ring buffer would
-     * let ended/shipped traces occupy buffer slots until overflow/flush,
-     * needlessly evicting still-in-flight traces sooner. No-op when disabled
-     * or when the trace is unknown.
-     */
-    endTrace(ctx: TraceContext, opts?: {
-        status?: 'ok' | 'error' | 'denied';
-        errorMessage?: string;
-    }): void;
-    /**
-     * Drain the in-memory buffer. Returns a readonly array of the current
-     * (trace, spans) pairs. The buffer is NOT cleared by this call — that
-     * is `flush()`'s job. `drain()` is for inspection (tests, debugging).
-     *
-     * Note: since `endTrace()` removes entries once they're handed to the
-     * shipper (see #8), `drain()` only ever reflects traces that are still
-     * in-flight (started but not yet ended).
-     */
-    drain(): ReadonlyArray<{
-        trace: TraceRecord;
-        spans: SpanRecord[];
-    }>;
-    /**
-     * POST any queued (ended) batches via the shipper. Returns the shipper's
-     * accepted/rejected counts. NEVER throws — observability failures must
-     * not break the SDK consumer.
-     *
-     * Only ended traces (`trace.endTime !== null`) are ever handed to the
-     * shipper (see `endTrace()`); in-flight (un-ended) traces stay in the
-     * in-memory ring buffer untouched — flushing must never drop a trace
-     * that's still being built. As an extra safety net (in case some future
-     * caller enqueues directly), any buffer entries whose trace happens to
-     * already carry an `endTime` are also handed to the shipper and removed
-     * here; anything without an `endTime` is left alone and a warning is
-     * logged with the retained count.
-     */
-    flush(): Promise<{
-        accepted: number;
-        rejected: number;
-    }>;
-    /**
-     * Stop the underlying shipper (clears the periodic interval + final
-     * flush). Call on session close. Safe to call multiple times.
-     */
-    stop(): Promise<void>;
-    private appendToBuffer;
-}
-//# sourceMappingURL=recorder.d.ts.map

package/dist/observability/recorder.d.ts.map

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