@shpitdev/convex-cliproxy-observability 0.1.0 → 0.2.0

package/dist/protocols/framing.js

@@ -52,6 +52,81 @@ export class SSEReader {
             throw new Error("SSE frame limit");
         return frames;
     }
+    /** Derive frames from pinned stock pre-framer callbacks; stored bytes stay untouched. */
+    feedStock(bytes, protocol, observedAt) {
+        const decoder = new TextDecoder("utf-8", { fatal: true });
+        if (protocol === "chat_completions" && (this.pending[0] ?? bytes[0]) === 123) {
+            if (this.pending.length + bytes.length > this.maxBytes)
+                throw new Error("SSE frame limit");
+            const combined = new Uint8Array(this.pending.length + bytes.length);
+            combined.set(this.pending);
+            combined.set(bytes, this.pending.length);
+            this.pending = combined;
+            try {
+                const data = decoder.decode(combined);
+                JSON.parse(data);
+                this.pending = new Uint8Array();
+                return [{ data, observedAt }];
+            }
+            catch {
+                return [];
+            }
+        }
+        if (protocol === "responses" && this.pending.length && bytes.length) {
+            // Only an event-only field can gain a missing separator. A data: prefix
+            // inside fragmented JSON is content, not a new line.
+            const event = new TextDecoder().decode(this.pending);
+            if (/^event: *[a-zA-Z0-9][a-zA-Z0-9._:-]{0,126} *$/.test(event) &&
+                bytes[0] === 100 &&
+                bytes[1] === 97 &&
+                bytes[2] === 116 &&
+                bytes[3] === 97 &&
+                bytes[4] === 58) {
+                const line = new Uint8Array(bytes.length + 1);
+                line[0] = 10;
+                line.set(bytes, 1);
+                bytes = line;
+            }
+        }
+        const frames = this.feed(bytes, observedAt);
+        if (protocol !== "responses")
+            return frames;
+        let candidate;
+        try {
+            candidate = decoder.decode(this.pending);
+        }
+        catch {
+            return frames;
+        }
+        if (!candidate.trim()) {
+            this.pending = new Uint8Array();
+            return frames;
+        }
+        const data = [];
+        let event;
+        for (const line of candidate.replaceAll("\r\n", "\n").replaceAll("\r", "\n").split("\n")) {
+            if (line.startsWith("data:"))
+                data.push(line.slice(5).replace(/^ /, ""));
+            else if (line.startsWith("event:"))
+                event = line.slice(6).trim();
+            else if (line !== "" && !line.startsWith(":"))
+                return frames;
+        }
+        if (!data.length)
+            return frames;
+        const payload = data.join("\n");
+        if (payload !== "[DONE]") {
+            try {
+                JSON.parse(payload);
+            }
+            catch {
+                return frames;
+            }
+        }
+        this.pending = new Uint8Array();
+        frames.push({ data: payload, event, observedAt });
+        return frames;
+    }
     finish() {
         return {
             truncated: new TextDecoder("utf-8", { fatal: true }).decode(this.pending).trim().length > 0,

package/dist/protocols/framing.js.map

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

package/dist/protocols/index.d.ts

@@ -7,7 +7,7 @@ export type { SSEFrame, SSECheckpoint } from "./framing.js";
 export type { CliproxyProjection, ProjectionState } from "./types.js";
 export { assembleResponsesStream, assembleChatStream, assembleAnthropicStream };
 export { nanoTime } from "./values.js";
-export declare const PARSER_VERSION = "client-protocol-v1";
+export declare const PARSER_VERSION = "client-protocol-v2";
 export declare function protocolForRoute(route: string): CliproxyProjection["protocol"];
 /** Bounded replay helper for fixtures and selected-call export; never fetches data itself. */
 export declare function projectCapturedPayloads(args: {
@@ -16,5 +16,7 @@ export declare function projectCapturedPayloads(args: {
     response?: Uint8Array;
     chunks?: readonly Uint8Array[];
     complete?: boolean;
+    /** Set only for capturePolicy hook-body-v1, never historical canonical SSE. */
+    stockHookChunks?: boolean;
 }): CliproxyProjection;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAM9E;AACD,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,kBAAkB,CAgHrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAM9E;AACD,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,kBAAkB,CAkHrB"}

package/dist/protocols/index.js

@@ -7,7 +7,7 @@ import { requestInput, responseOutput } from "./output.js";
 export { SSEReader } from "./framing.js";
 export { assembleResponsesStream, assembleChatStream, assembleAnthropicStream };
 export { nanoTime } from "./values.js";
-export const PARSER_VERSION = "client-protocol-v1";
+export const PARSER_VERSION = "client-protocol-v2";
 export function protocolForRoute(route) {
     if (route === "POST /v1/messages" || route === "POST /v1/messages/count_tokens")
         return "anthropic_messages";
@@ -65,7 +65,9 @@ export function projectCapturedPayloads(args) {
             if (bytes > 16 * 1024 * 1024)
                 throw new Error("bounded replay limit; use event pages for larger calls");
             try {
-                for (const frame of reader.feed(chunk)) {
+                for (const frame of args.stockHookChunks
+                    ? reader.feedStock(chunk, projection.protocol)
+                    : reader.feed(chunk)) {
                     if (frame.data === "[DONE]") {
                         done = true;
                         continue;

package/dist/protocols/index.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shpitdev/convex-cliproxy-observability",
   "description": "Private stock CLIProxy capture, protocol projections, and bounded model-call reads.",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "Anand Pant",
   "license": "Apache-2.0",
   "repository": "github:anandpant/convex-components",

package/src/capture/index.ts

@@ -12,33 +12,50 @@ const routes = new Set([
 export type CaptureObservationV1 = {
   schemaVersion: 1;
   pluginVersion: string;
-  redactionVersion: string;
+  /** Historical redacted observations retain their original policy label. */
+  redactionVersion?: string;
+  capturePolicy?: "hook-body-v1";
   destinationId: string;
   instanceId: string;
   pluginBootId: string;
   requestId: string;
   sequence: number;
-  kind: "request" | "response" | "stream_init" | "stream_chunk" | "completion" | "capture_health";
+  kind:
+    | "request"
+    | "request_after_auth"
+    | "response"
+    | "stream_init"
+    | "stream_chunk"
+    | "completion"
+    | "capture_health";
   observedAt: string;
   offsetNs: number;
   route: string;
   configRevision: string;
   sourceFormat?: string;
   requestedModel?: string;
+  executionModel?: string;
+  selectedAuthId?: string;
+  selectedAuthIndex?: string;
+  executionProtocol?: string;
+  metadataOmissions?: string[];
   sourceTraceId?: string;
   correlation?: ExactCorrelation;
   correlationConflicts?: string[];
   stockChunkIndex?: number;
   body?: string;
   observedBodyBytes?: number;
-  bodyFraming?: "stock_json_chunk" | "stock_sse_candidate";
+  bodyFraming?: "stock_json_chunk" | "stock_sse_candidate" | "stock_hook_chunk";
   contentSha256: string;
   contentBytes: number;
   completionOutcome?: string;
   executionStatusCode?: number;
   executionStartedAt?: string;
   executionCompletedAt?: string;
+  /** Exact bounded stock completion diagnostic; private event content. */
   error?: string;
+  errorPresent?: boolean;
+  observedErrorBytes?: number;
   gap?: string;
   bodyFromSequence?: number;
   droppedObservationsTotal?: number;
@@ -92,6 +109,51 @@ export async function validateObservation(
   if (!value || typeof value !== "object" || Array.isArray(value))
     throw new Error("observation required");
   const o = value as CaptureObservationV1;
+  const fields = new Set([
+    "schemaVersion",
+    "pluginVersion",
+    "redactionVersion",
+    "capturePolicy",
+    "destinationId",
+    "instanceId",
+    "pluginBootId",
+    "requestId",
+    "sequence",
+    "kind",
+    "observedAt",
+    "offsetNs",
+    "route",
+    "configRevision",
+    "sourceFormat",
+    "requestedModel",
+    "executionModel",
+    "executionProtocol",
+    "selectedAuthId",
+    "selectedAuthIndex",
+    "metadataOmissions",
+    "sourceTraceId",
+    "correlation",
+    "correlationConflicts",
+    "stockChunkIndex",
+    "body",
+    "observedBodyBytes",
+    "bodyFraming",
+    "contentSha256",
+    "contentBytes",
+    "completionOutcome",
+    "executionStatusCode",
+    "executionStartedAt",
+    "executionCompletedAt",
+    "error",
+    "errorPresent",
+    "observedErrorBytes",
+    "gap",
+    "bodyFromSequence",
+    "droppedObservationsTotal",
+    "scopeConflictsTotal",
+  ]);
+  if (Object.keys(o).some((key) => !fields.has(key)))
+    throw new Error("unsupported observation field");
   if (
     o.schemaVersion !== 1 ||
     o.destinationId !== expected.destinationId ||
@@ -119,7 +181,14 @@ export async function validateObservation(
   )
     throw new Error("invalid observation metadata");
   if (
-    !["request", "response", "stream_init", "stream_chunk", "completion"].includes(o.kind) ||
+    ![
+      "request",
+      "request_after_auth",
+      "response",
+      "stream_init",
+      "stream_chunk",
+      "completion",
+    ].includes(o.kind) ||
     !/^[a-f0-9]{64}$/.test(o.contentSha256)
   )
     throw new Error("unsupported observation");
@@ -154,6 +223,10 @@ export async function validateObservation(
     "redactionVersion",
     "sourceFormat",
     "requestedModel",
+    "executionModel",
+    "selectedAuthId",
+    "selectedAuthIndex",
+    "executionProtocol",
     "sourceTraceId",
     "gap",
     "completionOutcome",
@@ -161,7 +234,33 @@ export async function validateObservation(
     if (o[field] !== undefined && (typeof o[field] !== "string" || o[field]!.length > 256))
       throw new Error("invalid optional metadata");
   }
-  if (!o.pluginVersion || !o.redactionVersion) throw new Error("capture versions required");
+  if (!o.pluginVersion || (!o.redactionVersion && o.capturePolicy !== "hook-body-v1"))
+    throw new Error("capture versions required");
+  if (
+    o.capturePolicy !== undefined &&
+    (o.capturePolicy !== "hook-body-v1" || o.redactionVersion !== undefined)
+  )
+    throw new Error("invalid capture policy");
+  if (
+    o.metadataOmissions !== undefined &&
+    (!Array.isArray(o.metadataOmissions) ||
+      o.metadataOmissions.length > 16 ||
+      o.metadataOmissions.some((x) => typeof x !== "string" || x.length > 64))
+  )
+    throw new Error("invalid metadata omissions");
+  if (o.error !== undefined && (typeof o.error !== "string" || o.error.length > 4096))
+    throw new Error("invalid error detail");
+  if (
+    (o.kind === "request_after_auth" || o.bodyFraming === "stock_hook_chunk") &&
+    o.capturePolicy !== "hook-body-v1"
+  )
+    throw new Error("raw hook policy required");
+  if (
+    o.capturePolicy === "hook-body-v1" &&
+    (o.bodyFromSequence !== undefined ||
+      (o.kind === "stream_chunk" && o.bodyFraming !== "stock_hook_chunk"))
+  )
+    throw new Error("raw hook provenance required");
   if (
     o.kind === "completion" &&
     !["succeeded", "failed", "canceled", "rejected"].includes(o.completionOutcome ?? "")
@@ -169,7 +268,7 @@ export async function validateObservation(
     throw new Error("invalid completion outcome");
   if (
     o.bodyFraming !== undefined &&
-    !["stock_json_chunk", "stock_sse_candidate"].includes(o.bodyFraming)
+    !["stock_json_chunk", "stock_sse_candidate", "stock_hook_chunk"].includes(o.bodyFraming)
   )
     throw new Error("invalid body framing");
   if (
@@ -179,6 +278,15 @@ export async function validateObservation(
       o.observedBodyBytes > MAX_ENVELOPE_BYTES)
   )
     throw new Error("invalid observed byte count");
+  if (o.errorPresent !== undefined && typeof o.errorPresent !== "boolean")
+    throw new Error("invalid error presence");
+  if (
+    o.observedErrorBytes !== undefined &&
+    (!Number.isSafeInteger(o.observedErrorBytes) ||
+      o.observedErrorBytes < 0 ||
+      o.observedErrorBytes > MAX_ENVELOPE_BYTES)
+  )
+    throw new Error("invalid observed diagnostic size");
   const body = decodeBody(o);
   if ((await sha256(body)) !== o.contentSha256) throw new Error("content digest mismatch");
   return {

package/src/client.ts

@@ -105,6 +105,7 @@ export function initialCall(
       parserVersion: PARSER_VERSION,
       pluginVersion: o.pluginVersion,
       redactionVersion: o.redactionVersion,
+      capturePolicy: o.capturePolicy,
       lastObservedAt: o.observedAt,
     },
     receivedAt,
@@ -266,7 +267,13 @@ export async function handleCliproxyCaptureRequest(
     });
     // Scheduling failure returns retryable 503 after durable receipt; retry is idempotent.
     await options.scheduleProjection(ctx, callId);
-    return Response.json({ ...receipt, rawCommitted: true, projectionCommitted: false });
+    return Response.json({
+      ...receipt,
+      destinationId: options.destinationId,
+      deploymentId: options.deploymentId,
+      rawCommitted: true,
+      projectionCommitted: false,
+    });
   } catch (error) {
     const message = error instanceof Error ? error.message : "";
     return new Response(

package/src/model-call/index.ts

@@ -54,6 +54,11 @@ export type ModelCallV1 = {
   parentSpanId?: string;
   requestModel?: string;
   responseModel?: string;
+  /** Last observed after-auth execution, not inferred provider identity. */
+  executionModel?: string;
+  selectedAuthId?: string;
+  selectedAuthIndex?: string;
+  executionProtocol?: string;
   providerName?: string;
   streamed?: boolean;
   operation: "generation" | "token_count" | "discovery" | "unknown";
@@ -85,6 +90,8 @@ export type ModelCallV1 = {
   capture: {
     raw: EvidenceState;
     projection: EvidenceState;
+    projectionIssue?:
+      "malformed_payload" | "truncated_frame" | "frame_limit" | "unsupported_protocol";
     usage: EvidenceState;
     preHook: "unavailable";
     projectedThroughSequence: number;
@@ -94,6 +101,7 @@ export type ModelCallV1 = {
     parserVersion: string;
     pluginVersion?: string;
     redactionVersion?: string;
+    capturePolicy?: "hook-body-v1";
     lastObservedAt?: string;
   };
   receivedAt: number;
@@ -111,6 +119,11 @@ export type OpenRouterSpanInput = {
   parentSpanId?: string;
   requestModel?: string;
   responseModel?: string;
+  /** Last observed after-auth execution, not inferred provider identity. */
+  executionModel?: string;
+  selectedAuthId?: string;
+  selectedAuthIndex?: string;
+  executionProtocol?: string;
   providerName?: string;
   streamed?: boolean;
   startTimeUnixNano?: string;

package/src/protocols/checkpoint.ts

@@ -18,6 +18,8 @@ export type ProjectionCheckpoint = {
   terminal?: string;
   usageFinal?: boolean;
   invalid?: boolean;
+  truncated?: boolean;
+  frameLimit?: boolean;
   unsupported?: boolean;
   rawGap?: boolean;
   streamed?: boolean;
@@ -192,6 +194,14 @@ export function applyObservation(
   }
   const body = decodeBody(o);
   const decoder = new TextDecoder("utf-8", { fatal: true });
+  if (o.kind === "request_after_auth" || o.kind === "stream_init") {
+    call.selectedAuthId = o.selectedAuthId;
+    call.selectedAuthIndex = o.selectedAuthIndex;
+  }
+  if (o.kind === "request_after_auth") {
+    call.executionModel = o.executionModel;
+    call.executionProtocol = o.executionProtocol;
+  }
   if (o.kind === "request") {
     state.inputSeen = true;
     if (o.requestedModel) call.requestModel = o.requestedModel.slice(0, 256);
@@ -221,7 +231,9 @@ export function applyObservation(
       }
       if ((o.kind === "stream_chunk" || o.kind === "completion") && body.length) {
         const reader = new SSEReader(state.sse);
-        for (const frame of reader.feed(body, o.observedAt)) {
+        for (const frame of o.bodyFraming === "stock_hook_chunk"
+          ? reader.feedStock(body, call.clientProtocol, o.observedAt)
+          : reader.feed(body, o.observedAt)) {
           if (frame.data === "[DONE]") {
             if (call.clientProtocol === "chat_completions" && state.chatFinished)
               state.terminal = "completed";
@@ -234,13 +246,14 @@ export function applyObservation(
         }
         state.sse = reader.checkpoint();
       }
-    } catch {
+    } catch (error) {
       state.invalid = true;
+      if (error instanceof Error && error.message === "SSE frame limit") state.frameLimit = true;
     }
   }
   if (o.kind === "completion") {
     try {
-      if (new SSEReader(state.sse).finish().truncated) state.invalid = true;
+      if (new SSEReader(state.sse).finish().truncated) state.truncated = true;
     } catch {
       state.invalid = true;
     }
@@ -275,7 +288,12 @@ export function applyObservation(
   }
   call.protocolTerminal = state.terminal;
   const final =
-    !!state.terminal && state.usageFinal && !state.invalid && !state.unsupported && !state.rawGap;
+    !!state.terminal &&
+    state.usageFinal &&
+    !state.invalid &&
+    !state.truncated &&
+    !state.unsupported &&
+    !state.rawGap;
   const projection: CliproxyProjection = {
     version: 1,
     protocol: call.clientProtocol ?? "unknown",
@@ -331,12 +349,23 @@ export function applyObservation(
   call.capture.persistedThroughSequence = o.sequence;
   call.capture.raw =
     call.capture.terminalSequence === o.sequence && !state.rawGap ? "complete" : "partial";
+  call.capture.projectionIssue = state.frameLimit
+    ? "frame_limit"
+    : state.invalid
+      ? "malformed_payload"
+      : state.truncated
+        ? "truncated_frame"
+        : state.unsupported
+          ? "unsupported_protocol"
+          : undefined;
   call.capture.projection = state.invalid
     ? "invalid"
-    : state.unsupported
-      ? "unsupported"
-      : state.terminal
-        ? "complete"
-        : "partial";
+    : state.truncated
+      ? "partial"
+      : state.unsupported
+        ? "unsupported"
+        : state.terminal
+          ? "complete"
+          : "partial";
   call.capture.usage = call.usage.length ? (final ? "complete" : "partial") : "unavailable";
 }

package/src/protocols/framing.ts

@@ -49,6 +49,74 @@ export class SSEReader {
     if (this.pending.length > this.maxBytes) throw new Error("SSE frame limit");
     return frames;
   }
+  /** Derive frames from pinned stock pre-framer callbacks; stored bytes stay untouched. */
+  feedStock(bytes: Uint8Array, protocol?: string, observedAt?: string): SSEFrame[] {
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    if (protocol === "chat_completions" && (this.pending[0] ?? bytes[0]) === 123) {
+      if (this.pending.length + bytes.length > this.maxBytes) throw new Error("SSE frame limit");
+      const combined = new Uint8Array(this.pending.length + bytes.length);
+      combined.set(this.pending);
+      combined.set(bytes, this.pending.length);
+      this.pending = combined;
+      try {
+        const data = decoder.decode(combined);
+        JSON.parse(data);
+        this.pending = new Uint8Array();
+        return [{ data, observedAt }];
+      } catch {
+        return [];
+      }
+    }
+    if (protocol === "responses" && this.pending.length && bytes.length) {
+      // Only an event-only field can gain a missing separator. A data: prefix
+      // inside fragmented JSON is content, not a new line.
+      const event = new TextDecoder().decode(this.pending);
+      if (
+        /^event: *[a-zA-Z0-9][a-zA-Z0-9._:-]{0,126} *$/.test(event) &&
+        bytes[0] === 100 &&
+        bytes[1] === 97 &&
+        bytes[2] === 116 &&
+        bytes[3] === 97 &&
+        bytes[4] === 58
+      ) {
+        const line = new Uint8Array(bytes.length + 1);
+        line[0] = 10;
+        line.set(bytes, 1);
+        bytes = line;
+      }
+    }
+    const frames = this.feed(bytes, observedAt);
+    if (protocol !== "responses") return frames;
+    let candidate: string;
+    try {
+      candidate = decoder.decode(this.pending);
+    } catch {
+      return frames;
+    }
+    if (!candidate.trim()) {
+      this.pending = new Uint8Array();
+      return frames;
+    }
+    const data: string[] = [];
+    let event: string | undefined;
+    for (const line of candidate.replaceAll("\r\n", "\n").replaceAll("\r", "\n").split("\n")) {
+      if (line.startsWith("data:")) data.push(line.slice(5).replace(/^ /, ""));
+      else if (line.startsWith("event:")) event = line.slice(6).trim();
+      else if (line !== "" && !line.startsWith(":")) return frames;
+    }
+    if (!data.length) return frames;
+    const payload = data.join("\n");
+    if (payload !== "[DONE]") {
+      try {
+        JSON.parse(payload);
+      } catch {
+        return frames;
+      }
+    }
+    this.pending = new Uint8Array();
+    frames.push({ data: payload, event, observedAt });
+    return frames;
+  }
   finish(): { truncated: boolean } {
     return {
       truncated: new TextDecoder("utf-8", { fatal: true }).decode(this.pending).trim().length > 0,

package/src/protocols/index.ts

@@ -10,7 +10,7 @@ export type { SSEFrame, SSECheckpoint } from "./framing.js";
 export type { CliproxyProjection, ProjectionState } from "./types.js";
 export { assembleResponsesStream, assembleChatStream, assembleAnthropicStream };
 export { nanoTime } from "./values.js";
-export const PARSER_VERSION = "client-protocol-v1";
+export const PARSER_VERSION = "client-protocol-v2";
 export function protocolForRoute(route: string): CliproxyProjection["protocol"] {
   if (route === "POST /v1/messages" || route === "POST /v1/messages/count_tokens")
     return "anthropic_messages";
@@ -25,6 +25,8 @@ export function projectCapturedPayloads(args: {
   response?: Uint8Array;
   chunks?: readonly Uint8Array[];
   complete?: boolean;
+  /** Set only for capturePolicy hook-body-v1, never historical canonical SSE. */
+  stockHookChunks?: boolean;
 }): CliproxyProjection {
   const projection: CliproxyProjection = {
     version: 1,
@@ -68,7 +70,9 @@ export function projectCapturedPayloads(args: {
       if (bytes > 16 * 1024 * 1024)
         throw new Error("bounded replay limit; use event pages for larger calls");
       try {
-        for (const frame of reader.feed(chunk)) {
+        for (const frame of args.stockHookChunks
+          ? reader.feedStock(chunk, projection.protocol)
+          : reader.feed(chunk)) {
           if (frame.data === "[DONE]") {
             done = true;
             continue;