@shpitdev/convex-cliproxy-observability 0.1.0

package/dist/model-call/index.d.ts

@@ -0,0 +1,120 @@
+/** Read contract only: storage and ingestion remain independently owned. */
+export type ModelCallSource = "cliproxy" | "openrouter" | "cliproxy_legacy";
+export type ModelCallState = "in_progress" | "succeeded" | "failed" | "aborted" | "rejected" | "interrupted" | "unknown";
+export type EvidenceState = "complete" | "partial" | "unavailable" | "invalid" | "unsupported";
+export type ExactCorrelation = Partial<Record<"requestId" | "runId" | "jobId" | "traceId" | "rootExecutionId" | "opencodeSessionId" | "operationId" | "stepId" | "partId" | "attemptId", string>>;
+export type UsageMeasurement = {
+    value: number;
+    nativeField: string;
+    source: "client_protocol" | "openrouter_span";
+    scope: "call";
+    unit: "tokens";
+    finality: "final" | "partial" | "unknown";
+    semanticsVersion: string;
+};
+export type PrivateContentReference = {
+    key: string;
+    sha256: string;
+    byteLength: number;
+    contentType: string;
+};
+export type ModelCallV1 = {
+    schemaVersion: 1;
+    source: ModelCallSource;
+    callId: string;
+    sourceDocumentId: string;
+    gateway: "cliproxy" | "openrouter";
+    deploymentId?: string;
+    environment?: "dev" | "prod";
+    route?: string;
+    configRevision?: string;
+    authType: "unknown";
+    destinationId?: string;
+    instanceId?: string;
+    pluginBootId?: string;
+    executionId?: string;
+    sourceTraceId?: string;
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    requestModel?: string;
+    responseModel?: string;
+    providerName?: string;
+    streamed?: boolean;
+    operation: "generation" | "token_count" | "discovery" | "unknown";
+    tokenCount?: number;
+    clientProtocol?: "anthropic_messages" | "responses" | "chat_completions" | "unknown";
+    state: ModelCallState;
+    completionOutcome?: string;
+    executionStatusCode?: number;
+    protocolTerminal?: string;
+    finishReason?: string;
+    startTimeUnixNano?: string;
+    endTimeUnixNano?: string;
+    latencyMs?: number;
+    timeToFirstByteMs?: number;
+    timeToFirstContentMs?: number;
+    timingSource: "plugin_observed" | "openrouter_span" | "unavailable";
+    correlation: ExactCorrelation;
+    correlationConflicts: string[];
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    reasoningTokens?: number;
+    cachedInputTokens?: number;
+    usage: UsageMeasurement[];
+    cost: {
+        kind: "unknown";
+    } | {
+        kind: "provider_billed" | "proxy_reported";
+        currency: string;
+        total: string;
+    };
+    attemptDetail: "unavailable";
+    capture: {
+        raw: EvidenceState;
+        projection: EvidenceState;
+        usage: EvidenceState;
+        preHook: "unavailable";
+        projectedThroughSequence: number;
+        persistedThroughSequence: number;
+        terminalSequence?: number;
+        gaps: string[];
+        parserVersion: string;
+        pluginVersion?: string;
+        redactionVersion?: string;
+        lastObservedAt?: string;
+    };
+    receivedAt: number;
+};
+export type ModelCallSummaryV1 = ModelCallV1;
+/** Structural input: there is no runtime dependency on the OpenRouter component. */
+export type OpenRouterSpanInput = {
+    _id: string;
+    receivedAt: number;
+    totalCost?: number;
+    openrouterUsageCost?: number;
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    requestModel?: string;
+    responseModel?: string;
+    providerName?: string;
+    streamed?: boolean;
+    startTimeUnixNano?: string;
+    endTimeUnixNano?: string;
+    finishReason?: string;
+    requestId?: string;
+    runId?: string;
+    jobId?: string;
+    rootExecutionId?: string;
+    opencodeSessionId?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    reasoningTokens?: number;
+    cachedInputTokens?: number;
+};
+export declare function fromOpenRouterSpan(span: OpenRouterSpanInput): ModelCallV1;
+export declare function fromLegacyCliproxySpan(span: OpenRouterSpanInput): ModelCallV1;
+//# sourceMappingURL=index.d.ts.map

package/dist/model-call/index.d.ts.map

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

package/dist/model-call/index.js

@@ -0,0 +1,96 @@
+export function fromOpenRouterSpan(span) {
+    const correlation = {};
+    for (const field of [
+        "requestId",
+        "runId",
+        "jobId",
+        "rootExecutionId",
+        "opencodeSessionId",
+    ]) {
+        if (span[field] !== undefined)
+            correlation[field] = span[field];
+    }
+    const usage = [];
+    for (const field of [
+        "inputTokens",
+        "outputTokens",
+        "totalTokens",
+        "reasoningTokens",
+        "cachedInputTokens",
+    ]) {
+        const value = span[field];
+        if (value !== undefined && Number.isSafeInteger(value) && value >= 0)
+            usage.push({
+                value,
+                nativeField: field,
+                source: "openrouter_span",
+                scope: "call",
+                unit: "tokens",
+                finality: "unknown",
+                semanticsVersion: "stored_openrouter_span_v1",
+            });
+    }
+    return {
+        schemaVersion: 1,
+        source: "openrouter",
+        callId: `openrouter:${span._id}`,
+        sourceDocumentId: span._id,
+        gateway: "openrouter",
+        authType: "unknown",
+        traceId: span.traceId,
+        spanId: span.spanId,
+        parentSpanId: span.parentSpanId,
+        requestModel: span.requestModel,
+        responseModel: span.responseModel,
+        providerName: span.providerName,
+        streamed: span.streamed,
+        operation: "generation",
+        state: "unknown",
+        finishReason: span.finishReason,
+        startTimeUnixNano: span.startTimeUnixNano,
+        endTimeUnixNano: span.endTimeUnixNano,
+        timingSource: "openrouter_span",
+        correlation,
+        correlationConflicts: [],
+        inputTokens: span.inputTokens,
+        outputTokens: span.outputTokens,
+        totalTokens: span.totalTokens,
+        reasoningTokens: span.reasoningTokens,
+        cachedInputTokens: span.cachedInputTokens,
+        usage,
+        cost: typeof (span.totalCost ?? span.openrouterUsageCost) === "number" &&
+            Number.isFinite(span.totalCost ?? span.openrouterUsageCost) &&
+            (span.totalCost ?? span.openrouterUsageCost) >= 0
+            ? {
+                kind: "proxy_reported",
+                currency: "USD",
+                total: String(span.totalCost ?? span.openrouterUsageCost),
+            }
+            : { kind: "unknown" },
+        attemptDetail: "unavailable",
+        capture: {
+            raw: "unavailable",
+            projection: "partial",
+            usage: usage.length ? "partial" : "unavailable",
+            preHook: "unavailable",
+            projectedThroughSequence: 0,
+            persistedThroughSequence: 0,
+            gaps: ["stream_events_and_attempt_detail_unavailable"],
+            parserVersion: "openrouter-structural-v1",
+        },
+        receivedAt: span.receivedAt,
+    };
+}
+export function fromLegacyCliproxySpan(span) {
+    const call = fromOpenRouterSpan(span);
+    return {
+        ...call,
+        source: "cliproxy_legacy",
+        callId: `cliproxy_legacy:${span._id}`,
+        gateway: "cliproxy",
+        providerName: undefined,
+        timingSource: "unavailable",
+        cost: { kind: "unknown" },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/model-call/index.js.map

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

package/dist/projection.d.ts

@@ -0,0 +1,19 @@
+import type { GenericActionCtx, GenericDataModel } from "convex/server";
+import type { CliproxyObservability } from "./client.js";
+import { type PrivateCaptureStorage } from "./content/index.js";
+/** Project at most two immutable segments. Host schedules the next page when `more` is true. */
+export declare function projectPendingSegments(ctx: Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation">, options: {
+    client: CliproxyObservability;
+    storage: PrivateCaptureStorage;
+    destinationId: string;
+    callId: string;
+}): Promise<{
+    progressed: boolean;
+    more: boolean;
+    waitingForGap?: undefined;
+} | {
+    progressed: boolean;
+    more: boolean;
+    waitingForGap: boolean;
+}>;
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAIjF,gGAAgG;AAChG,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,EACzE,OAAO,EAAE;IACP,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;;;;;;;;GAoFF"}

package/dist/projection.js

@@ -0,0 +1,83 @@
+import { resolveCallBlob } from "./content/index.js";
+import { sha256 } from "./capture/index.js";
+import { applyObservation } from "./protocols/checkpoint.js";
+/** Project at most two immutable segments. Host schedules the next page when `more` is true. */
+export async function projectPendingSegments(ctx, options) {
+    const { client, destinationId, callId } = options;
+    const state = await ctx.runQuery(client.component.queries.getProcessingState, {
+        destinationId,
+        callId,
+    });
+    if (!state)
+        return { progressed: false, more: false };
+    try {
+        const page = await ctx.runQuery(client.component.queries.pageEventSegments, {
+            destinationId,
+            callId,
+            afterSequence: state.projectedThroughSequence,
+            limit: 2,
+        });
+        const call = JSON.parse(state.summaryJson);
+        call.capture.projectedThroughSequence = state.projectedThroughSequence;
+        const checkpoint = JSON.parse(state.checkpointJson);
+        if (checkpoint.sseBlob) {
+            const stored = await resolveCallBlob(options.storage, [checkpoint.sseBlob], checkpoint.sseBlob);
+            checkpoint.sse = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(stored));
+            delete checkpoint.sseBlob;
+        }
+        let through = state.projectedThroughSequence;
+        let waitingForGap = false;
+        for (const segment of page.segments) {
+            if (segment.sequence !== through + 1) {
+                waitingForGap = true;
+                break;
+            }
+            const content = await resolveCallBlob(options.storage, [segment.reference], segment.reference);
+            for (const line of new TextDecoder("utf-8", { fatal: true })
+                .decode(content)
+                .split("\n")
+                .filter(Boolean))
+                applyObservation(call, checkpoint, JSON.parse(line));
+            through = segment.throughSequence;
+        }
+        if (through === state.projectedThroughSequence)
+            return { progressed: false, more: false, waitingForGap };
+        // A frame can exceed Convex's checkpoint budget. Persist pending framing bytes
+        // privately; the bounded component checkpoint owns the exact reference.
+        if (checkpoint.sse && checkpoint.sse.pendingBase64.length > 16 * 1024) {
+            const bytes = new TextEncoder().encode(JSON.stringify(checkpoint.sse));
+            const digest = await sha256(bytes);
+            const ref = {
+                key: `observability/cliproxy/v2/${destinationId}/${state.instanceId}/${callId}/parser/${digest}.json`,
+                sha256: digest,
+                byteLength: bytes.length,
+                contentType: "application/json",
+            };
+            await options.storage.put(ref, bytes);
+            checkpoint.sseBlob = ref;
+            delete checkpoint.sse;
+        }
+        const committed = await ctx.runMutation(client.component.ingest.commitProjection, {
+            destinationId,
+            callId,
+            expectedRevision: state.revision,
+            throughSequence: through,
+            summaryJson: JSON.stringify(call),
+            checkpointJson: JSON.stringify(checkpoint),
+        });
+        return {
+            progressed: committed.committed,
+            more: !committed.committed || (!page.done && !waitingForGap),
+            waitingForGap,
+        };
+    }
+    catch (error) {
+        await ctx.runMutation(client.component.ingest.recordProjectionFailure, {
+            destinationId,
+            callId,
+            expectedRevision: state.revision,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAA8B,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,MAAM,EAA6B,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAA6B,MAAM,2BAA2B,CAAC;AAExF,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAyE,EACzE,OAKC;IAED,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE;QAC5E,aAAa;QACb,MAAM;KACP,CAAC,CAAC;IACH,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAC1E,aAAa;YACb,MAAM;YACN,aAAa,EAAE,KAAK,CAAC,wBAAwB;YAC7C,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAgB,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAyB,CAAC;QAC5E,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,OAAO,CAAC,OAAO,EACf,CAAC,UAAU,CAAC,OAAO,CAAC,EACpB,UAAU,CAAC,OAAO,CACnB,CAAC;YACF,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACtF,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,CAAC,wBAAwB,CAAC;QAC7C,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,CAAC,EAAE,CAAC;gBACrC,aAAa,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,OAAO,CAAC,OAAO,EACf,CAAC,OAAO,CAAC,SAAS,CAAC,EACnB,OAAO,CAAC,SAAS,CAClB,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;iBACzD,MAAM,CAAC,OAAO,CAAC;iBACf,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,OAAO,CAAC;gBAChB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC,CAAC;YAC/E,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,CAAC,wBAAwB;YAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC3D,+EAA+E;QAC/E,wEAAwE;QACxE,IAAI,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACtE,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG;gBACV,GAAG,EAAE,6BAA6B,aAAa,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM,WAAW,MAAM,OAAO;gBACrG,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,WAAW,EAAE,kBAAkB;aAChC,CAAC;YACF,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;YACzB,OAAO,UAAU,CAAC,GAAG,CAAC;QACxB,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE;YAChF,aAAa;YACb,MAAM;YACN,gBAAgB,EAAE,KAAK,CAAC,QAAQ;YAChC,eAAe,EAAE,OAAO;YACxB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACjC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;SAC3C,CAAC,CAAC;QACH,OAAO;YACL,UAAU,EAAE,SAAS,CAAC,SAAS;YAC/B,IAAI,EAAE,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC;YAC5D,aAAa;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,uBAAuB,EAAE;YACrE,aAAa;YACb,MAAM;YACN,gBAAgB,EAAE,KAAK,CAAC,QAAQ;SACjC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/protocols/anthropic-messages.d.ts

@@ -0,0 +1,11 @@
+import type { RecordValue } from "./types.js";
+export declare function anthropicMessages(messages: unknown): RecordValue[];
+export declare function assembleAnthropicStream(events: RecordValue[]): {
+    response: RecordValue;
+    invalid: boolean;
+    recognized: boolean;
+    unsupported: boolean;
+    terminal: boolean;
+    terminalUsage: boolean;
+};
+//# sourceMappingURL=anthropic-messages.d.ts.map

package/dist/protocols/anthropic-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-messages.d.ts","sourceRoot":"","sources":["../../src/protocols/anthropic-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,EAAE,CAgDlE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE;;;;;;;EA8D5D"}

package/dist/protocols/anthropic-messages.js

@@ -0,0 +1,114 @@
+import { append, count, list, object } from "./values.js";
+export function anthropicMessages(messages) {
+    const result = [];
+    for (const value of list(messages)) {
+        const message = object(value);
+        if (!Array.isArray(message.content)) {
+            result.push(message);
+            continue;
+        }
+        let content = [];
+        let tools = [];
+        const flush = () => {
+            if (content.length || tools.length)
+                result.push({
+                    role: message.role,
+                    content,
+                    ...(tools.length ? { tool_calls: tools } : {}),
+                });
+            content = [];
+            tools = [];
+        };
+        for (const raw of message.content) {
+            const block = object(raw);
+            if (block.type === "tool_use") {
+                tools.push({
+                    id: block.id,
+                    type: "function",
+                    function: {
+                        name: block.name,
+                        arguments: typeof block.partial_json === "string"
+                            ? block.partial_json
+                            : JSON.stringify(block.input),
+                    },
+                });
+            }
+            else if (block.type === "tool_result") {
+                flush();
+                result.push({
+                    role: "tool",
+                    tool_call_id: block.tool_use_id,
+                    content: block.content,
+                    is_error: block.is_error,
+                });
+            }
+            else if (block.type === "text")
+                content.push({ type: "text", text: block.text });
+            else
+                content.push(block);
+        }
+        flush();
+    }
+    return result;
+}
+export function assembleAnthropicStream(events) {
+    let response = {};
+    let invalid = false, recognized = false, unsupported = false, terminal = false, terminalUsage = false;
+    const blocks = new Map();
+    const argumentsByIndex = new Map();
+    for (const event of events) {
+        const index = count(event.index);
+        if (event.type === "message_start") {
+            response = { ...object(event.message) };
+            recognized = true;
+            terminalUsage = false;
+        }
+        else if (event.type === "content_block_start" && index !== undefined)
+            blocks.set(index, { ...object(event.content_block) });
+        else if (event.type === "content_block_delta" && index !== undefined) {
+            const block = blocks.get(index);
+            const delta = object(event.delta);
+            if (!block) {
+                invalid = true;
+                continue;
+            }
+            if (!["text_delta", "thinking_delta", "signature_delta", "input_json_delta"].includes(String(delta.type)))
+                unsupported = true;
+            for (const key of ["text", "thinking", "signature"])
+                append(block, key, delta[key]);
+            if (typeof delta.partial_json === "string")
+                argumentsByIndex.set(index, (argumentsByIndex.get(index) ?? "") + delta.partial_json);
+        }
+        else if (event.type === "message_delta") {
+            Object.assign(response, object(event.delta));
+            // Message start and final delta are snapshots of different fields, not increments.
+            response.usage = { ...object(response.usage), ...object(event.usage) };
+            terminalUsage =
+                typeof object(event.delta).stop_reason === "string" &&
+                    count(object(event.usage).output_tokens) !== undefined;
+        }
+        else if (event.type === "message_stop")
+            terminal = true;
+        else if (event.type === "error") {
+            response.error = event.error;
+            recognized = true;
+            terminal = true;
+            terminalUsage = false;
+        }
+    }
+    for (const [index, argumentsText] of argumentsByIndex) {
+        const block = blocks.get(index);
+        if (block) {
+            try {
+                block.input = JSON.parse(argumentsText);
+            }
+            catch {
+                block.partial_json = argumentsText;
+                invalid ||= terminal;
+            }
+        }
+    }
+    response.content = [...blocks.entries()].toSorted(([a], [b]) => a - b).map(([, value]) => value);
+    return { response, invalid, recognized, unsupported, terminal, terminalUsage };
+}
+//# sourceMappingURL=anthropic-messages.js.map

package/dist/protocols/anthropic-messages.js.map

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

package/dist/protocols/chat-completions.d.ts

@@ -0,0 +1,10 @@
+import type { RecordValue } from "./types.js";
+export declare function assembleChatStream(events: RecordValue[], done: boolean, stockCompleted?: boolean): {
+    response: RecordValue;
+    invalid: boolean;
+    recognized: boolean;
+    unsupported: boolean;
+    terminal: boolean;
+    terminalUsage: boolean;
+};
+//# sourceMappingURL=chat-completions.d.ts.map

package/dist/protocols/chat-completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-completions.d.ts","sourceRoot":"","sources":["../../src/protocols/chat-completions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,UAAQ;;;;;;;EA2F9F"}

package/dist/protocols/chat-completions.js

@@ -0,0 +1,89 @@
+import { append, count, list, object } from "./values.js";
+export function assembleChatStream(events, done, stockCompleted = false) {
+    const response = {};
+    let invalid = false, recognized = false, unsupported = false, terminal = false, terminalUsage = false;
+    const choices = new Map();
+    const tools = new Map();
+    for (const event of events) {
+        if (Array.isArray(event.choices) || event.error)
+            recognized = true;
+        for (const key of ["id", "model", "object"])
+            if (event[key] !== undefined)
+                response[key] = event[key];
+        if (event.usage !== undefined && event.usage !== null)
+            response.usage = event.usage;
+        // Final usage is emitted on an empty choices chunk or with finished choices.
+        // A later [DONE] marker cannot turn an earlier running count into final usage.
+        if (Array.isArray(event.choices))
+            terminalUsage =
+                event.usage !== undefined &&
+                    event.usage !== null &&
+                    event.choices.every((choice) => typeof object(choice).finish_reason === "string");
+        if (event.error) {
+            response.error = event.error;
+            terminalUsage = false;
+        }
+        for (const raw of list(event.choices)) {
+            const choice = object(raw);
+            const index = count(choice.index);
+            if (index === undefined) {
+                invalid = true;
+                continue;
+            }
+            const saved = choices.get(index) ?? { index, message: { role: "assistant" } };
+            const message = object(saved.message);
+            const delta = object(choice.delta);
+            if (Object.keys(delta).some((key) => ![
+                "role",
+                "content",
+                "reasoning_content",
+                "reasoning",
+                "refusal",
+                "tool_calls",
+                "reasoning_details",
+            ].includes(key)))
+                unsupported = true;
+            for (const key of ["content", "reasoning_content", "reasoning", "refusal"])
+                append(message, key, delta[key]);
+            if (delta.reasoning_details !== undefined)
+                message.reasoning_details = [
+                    ...list(message.reasoning_details),
+                    ...list(delta.reasoning_details),
+                ];
+            const byIndex = tools.get(index) ?? new Map();
+            for (const rawTool of list(delta.tool_calls)) {
+                const tool = object(rawTool);
+                const toolIndex = count(tool.index);
+                if (toolIndex === undefined) {
+                    invalid = true;
+                    continue;
+                }
+                const savedTool = byIndex.get(toolIndex) ?? { type: "function", function: {} };
+                if (tool.id !== undefined)
+                    savedTool.id = tool.id;
+                if (tool.type !== undefined)
+                    savedTool.type = tool.type;
+                for (const key of ["name", "arguments"])
+                    append(object(savedTool.function), key, object(tool.function)[key]);
+                byIndex.set(toolIndex, savedTool);
+            }
+            tools.set(index, byIndex);
+            if (byIndex.size)
+                message.tool_calls = [...byIndex.entries()]
+                    .toSorted(([a], [b]) => a - b)
+                    .map(([, value]) => value);
+            if (choice.finish_reason !== undefined && choice.finish_reason !== null)
+                saved.finish_reason = choice.finish_reason;
+            choices.set(index, saved);
+        }
+    }
+    response.choices = [...choices.entries()].toSorted(([a], [b]) => a - b).map(([, value]) => value);
+    terminal =
+        done ||
+            response.error !== undefined ||
+            (stockCompleted &&
+                choices.size > 0 &&
+                [...choices.values()].every((choice) => typeof choice.finish_reason === "string"));
+    return { response, invalid, recognized, unsupported, terminal, terminalUsage };
+}
+//# sourceMappingURL=chat-completions.js.map

package/dist/protocols/chat-completions.js.map

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

package/dist/protocols/checkpoint.d.ts

@@ -0,0 +1,20 @@
+import type { ModelCallV1, PrivateContentReference } from "../model-call/index.js";
+import type { CaptureObservationV1 } from "../capture/index.js";
+import { type SSECheckpoint } from "./framing.js";
+import type { RecordValue } from "./types.js";
+/** Bounded semantic state. Emitted text/tools stay in immutable content segments. */
+export type ProjectionCheckpoint = {
+    sse?: SSECheckpoint;
+    sseBlob?: PrivateContentReference;
+    usage?: RecordValue;
+    terminal?: string;
+    usageFinal?: boolean;
+    invalid?: boolean;
+    unsupported?: boolean;
+    rawGap?: boolean;
+    streamed?: boolean;
+    inputSeen?: boolean;
+    chatFinished?: boolean;
+};
+export declare function applyObservation(call: ModelCallV1, state: ProjectionCheckpoint, o: CaptureObservationV1): void;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/protocols/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/protocols/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AA2JF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,oBAAoB,EAC3B,CAAC,EAAE,oBAAoB,GACtB,IAAI,CA6JN"}