@bitkyc08/opencodex 2.99.0 → 2.100.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (276) hide show
  1. package/AGENTS_INSTALL.md +19 -1
  2. package/README.md +37 -33
  3. package/SPONSORS.md +5 -1
  4. package/bin/ocx.mjs +1 -1
  5. package/gui/dist/assets/{App-C1hGwaN1.css → App-COo8Yopd.css} +1 -1
  6. package/gui/dist/assets/App-g3Cm2xhZ.js +59 -0
  7. package/gui/dist/assets/Tray-BMDkAiXy.js +1 -0
  8. package/gui/dist/assets/brand-mark-nr3ziR-T.js +1 -0
  9. package/gui/dist/assets/index-Bziu8gTy.css +2 -0
  10. package/gui/dist/assets/index-OYzhQUNP.js +94 -0
  11. package/gui/dist/assets/{segment-thumb-features-fYEMxBaW.js → segment-thumb-features-DKCVUUTi.js} +1 -1
  12. package/gui/dist/classic/assets/App-CgPBKUP-.js +58 -0
  13. package/gui/dist/classic/assets/{Tray-BqZueZOx.js → Tray-BedmOsE7.js} +1 -1
  14. package/gui/dist/classic/assets/index-BR-HhNrp.js +94 -0
  15. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +1 -0
  16. package/gui/dist/classic/index.html +1 -1
  17. package/gui/dist/index.html +2 -2
  18. package/native/ocx-child/Cargo.lock +215 -0
  19. package/native/ocx-child/Cargo.toml +31 -0
  20. package/native/ocx-child/src/cli.rs +1901 -0
  21. package/native/ocx-child/src/codex_home.rs +429 -0
  22. package/native/ocx-child/src/codex_settings.rs +231 -0
  23. package/native/ocx-child/src/daemon.rs +363 -0
  24. package/native/ocx-child/src/http_wire.rs +619 -0
  25. package/native/ocx-child/src/journal.rs +977 -0
  26. package/native/ocx-child/src/lib.rs +22 -0
  27. package/native/ocx-child/src/main.rs +9 -0
  28. package/native/ocx-child/src/parity.rs +102 -0
  29. package/native/ocx-child/src/platform.rs +1487 -0
  30. package/native/ocx-child/src/relay.rs +1288 -0
  31. package/native/ocx-child/src/relay_auth.rs +166 -0
  32. package/native/ocx-child/src/routes.rs +236 -0
  33. package/native/ocx-child/src/state.rs +190 -0
  34. package/native/ocx-child/src/test_hooks.rs +58 -0
  35. package/native/ocx-child/src/toml_surgeon.rs +1156 -0
  36. package/package.json +8 -2
  37. package/src/adapters/anthropic-image-normalize.ts +1 -1
  38. package/src/adapters/anthropic.ts +28 -2
  39. package/src/adapters/claude-cli/adapter.ts +5 -25
  40. package/src/adapters/claude-cli/instruction-images.ts +31 -0
  41. package/src/adapters/claude-cli/stable-replay.ts +42 -14
  42. package/src/adapters/claude-cli/usage-admission.ts +53 -64
  43. package/src/adapters/client-fingerprint.ts +1 -1
  44. package/src/adapters/coding-agent/protocol.ts +1 -1
  45. package/src/adapters/devin/live-models.ts +3 -0
  46. package/src/adapters/google-http.ts +3 -0
  47. package/src/adapters/google-vertex-key-project.ts +10 -2
  48. package/src/adapters/google.ts +40 -8
  49. package/src/adapters/kiro/usage.ts +3 -13
  50. package/src/adapters/openai-chat/mistral-image-limit.ts +28 -15
  51. package/src/adapters/openai-chat-images.ts +100 -0
  52. package/src/adapters/openai-chat.ts +6 -9
  53. package/src/adapters/openai-responses/passthrough.ts +5 -2
  54. package/src/adapters/openai-responses/request-strips.ts +32 -0
  55. package/src/adapters/openai-responses/tool-schema.ts +9 -4
  56. package/src/chat/inbound.ts +1 -1
  57. package/src/claude/auth-detect.ts +26 -8
  58. package/src/claude/inbound-content-options.ts +18 -3
  59. package/src/claude/inbound.ts +5 -2
  60. package/src/cli/bundled-bun-diagnostic.ts +91 -0
  61. package/src/cli/capabilities-agents-routing.ts +2 -2
  62. package/src/cli/capabilities-observe-system.ts +60 -0
  63. package/src/cli/combo-input.ts +6 -0
  64. package/src/cli/combo-result.ts +1 -1
  65. package/src/cli/combo.ts +4 -0
  66. package/src/cli/config-command.ts +16 -2
  67. package/src/cli/connect.ts +12 -10
  68. package/src/cli/dispatch.ts +4 -0
  69. package/src/cli/doctor.ts +11 -0
  70. package/src/cli/help.ts +1 -0
  71. package/src/cli/init.ts +4 -0
  72. package/src/cli/link-enrollment.ts +152 -25
  73. package/src/cli/link-local-control.ts +49 -0
  74. package/src/cli/link.ts +37 -10
  75. package/src/cli/provider-lifecycle-runtime.ts +4 -2
  76. package/src/cli/registry.ts +13 -0
  77. package/src/cli/star-prompt.ts +2 -0
  78. package/src/cli/status.ts +1 -1
  79. package/src/cli/telemetry-profile.ts +206 -0
  80. package/src/cli/telemetry.ts +260 -0
  81. package/src/client/hub-relay.ts +26 -0
  82. package/src/client/machine-api.ts +3 -0
  83. package/src/clients/config-export/t3code.ts +44 -5
  84. package/src/clients/omo-role-models.ts +1 -1
  85. package/src/codex/catalog/bundled.ts +44 -2
  86. package/src/codex/runtime.ts +12 -0
  87. package/src/codex/shim-restore-lock.ts +67 -30
  88. package/src/combos/types.ts +21 -1
  89. package/src/config/atomic-write.ts +24 -1
  90. package/src/config/diagnostics.ts +15 -0
  91. package/src/config/live-reconcile.ts +17 -0
  92. package/src/config/load-degrade.ts +16 -0
  93. package/src/config/provider-validation.ts +29 -0
  94. package/src/config/schema/config-schema.ts +24 -0
  95. package/src/config/schema/leaf-validators.ts +17 -0
  96. package/src/config/telemetry-carry.ts +30 -0
  97. package/src/config.ts +13 -1
  98. package/src/generated/compatibility-version.json +422 -170
  99. package/src/generated/model-metadata.ts +3 -3
  100. package/src/integrations/aside-profiles.ts +7 -1
  101. package/src/integrations/owned-refresh.ts +9 -2
  102. package/src/lab/artifacts/secure-fs.ts +12 -11
  103. package/src/lab/fabric/scratch.ts +11 -9
  104. package/src/lab/public/community.ts +2 -3
  105. package/src/lab/public/file-safety.ts +18 -20
  106. package/src/lab/public/mutation-lock.ts +109 -337
  107. package/src/lab/public/private-file.ts +4 -3
  108. package/src/lib/bun-runtime-preflight.ts +1 -1
  109. package/src/lib/codex-catalog-read-only.ts +122 -0
  110. package/src/lib/config-ownership.ts +56 -18
  111. package/src/lib/errors.ts +11 -0
  112. package/src/lib/gcp-adc.ts +167 -48
  113. package/src/lib/jsonc.ts +4 -2
  114. package/src/lib/local-control-socket.ts +88 -0
  115. package/src/lib/privacy.ts +15 -0
  116. package/src/lib/provider-client-headers.ts +3 -0
  117. package/src/lib/token-estimate.ts +13 -2
  118. package/src/link/child-binary-source.ts +228 -0
  119. package/src/link/ephemeral-child.ts +45 -0
  120. package/src/link/remote-plant.ts +306 -0
  121. package/src/link/remote-windows.ts +59 -5
  122. package/src/link/ssh-argv.ts +71 -8
  123. package/src/link/status-projection.ts +2 -0
  124. package/src/link/store.ts +5 -1
  125. package/src/oauth/anthropic-model-quota.ts +12 -0
  126. package/src/oauth/anthropic-routing.ts +11 -4
  127. package/src/oauth/claude-keychain-read.ts +165 -0
  128. package/src/oauth/kiro-iam-identity-center.ts +4 -1
  129. package/src/oauth/local-token-detect.ts +14 -17
  130. package/src/protocols/envelope.ts +20 -2
  131. package/src/providers/api-key-selection.ts +8 -2
  132. package/src/providers/claude-cli-identity.ts +9 -3
  133. package/src/providers/claude-cli-usage-state.ts +93 -0
  134. package/src/providers/claude-cli-usage.ts +3 -2
  135. package/src/providers/github-copilot-auto.ts +25 -5
  136. package/src/providers/meta-muse-plan-refusal.ts +94 -0
  137. package/src/providers/model-rename-fields.ts +3 -0
  138. package/src/providers/quota/anthropic-family-headers.ts +8 -1
  139. package/src/providers/quota/anthropic-usage-windows.ts +49 -2
  140. package/src/providers/quota/vendor-probes-key.ts +23 -4
  141. package/src/providers/quota/vendor-probes-oauth.ts +59 -0
  142. package/src/providers/quota/workbuddy.ts +2 -2
  143. package/src/providers/quota-types.ts +7 -0
  144. package/src/providers/quota.ts +25 -18
  145. package/src/providers/registry/entries-core.ts +7 -4
  146. package/src/providers/registry/entries-extended.ts +42 -8
  147. package/src/providers/registry/model-ids.ts +1 -0
  148. package/src/providers/registry/model-seeds.ts +10 -2
  149. package/src/providers/registry/types.ts +6 -0
  150. package/src/providers/resolved-model-policy.ts +4 -0
  151. package/src/providers/routed-config.ts +30 -3
  152. package/src/providers/stale-no-vision-seed-migration.ts +7 -0
  153. package/src/providers/vertex-environment-authority.ts +50 -0
  154. package/src/providers/workbuddy-credit-balance.ts +38 -6
  155. package/src/quota-pool/assemble.ts +14 -6
  156. package/src/responses/retained-compaction.ts +31 -5
  157. package/src/router.ts +1 -0
  158. package/src/server/adapter-resolve.ts +11 -6
  159. package/src/server/audio-dictation.ts +21 -7
  160. package/src/server/auth-cors.ts +19 -0
  161. package/src/server/background-lifecycle.ts +71 -0
  162. package/src/server/chat-completions.ts +2 -0
  163. package/src/server/claude-messages.ts +30 -3
  164. package/src/server/index/live-sideband.ts +15 -1
  165. package/src/server/index/local-control-listener.ts +515 -0
  166. package/src/server/index/optional-listeners.ts +21 -1
  167. package/src/server/index/serve-options.ts +4 -3
  168. package/src/server/index/websocket-handler.ts +2 -0
  169. package/src/server/index.ts +3 -0
  170. package/src/server/management/combo-routes.ts +6 -1
  171. package/src/server/management/context.ts +1 -0
  172. package/src/server/management/link-child-preflight.ts +74 -0
  173. package/src/server/management/link-enrollment.ts +190 -25
  174. package/src/server/management/link-route-state.ts +6 -1
  175. package/src/server/management/link-routes.ts +27 -9
  176. package/src/server/management/model-rows.ts +4 -0
  177. package/src/server/management/oauth-account-routes.ts +9 -4
  178. package/src/server/management/provider-overwrite-carry.ts +9 -2
  179. package/src/server/management/provider-routes.ts +14 -0
  180. package/src/server/management/provider-thinking-display-patch.ts +54 -0
  181. package/src/server/management/route-registry.ts +7 -0
  182. package/src/server/management/session-routes.ts +4 -1
  183. package/src/server/management/telemetry-routes.ts +37 -0
  184. package/src/server/management/usage-aggregate-cache.ts +290 -67
  185. package/src/server/management-api.ts +11 -2
  186. package/src/server/messages-native-preflight.ts +166 -0
  187. package/src/server/messages-native.ts +143 -43
  188. package/src/server/messages-shared.ts +14 -0
  189. package/src/server/proxy-liveness.ts +99 -6
  190. package/src/server/request-log-conversation.ts +18 -2
  191. package/src/server/request-log.ts +7 -2
  192. package/src/server/responses/adapter-continuation.ts +1 -0
  193. package/src/server/responses/adapter-dispatch.ts +11 -28
  194. package/src/server/responses/adapter-failure-message.ts +68 -0
  195. package/src/server/responses/combo-stream-preflight.ts +14 -2
  196. package/src/server/responses/compact.ts +13 -1
  197. package/src/server/responses/core-auth.ts +26 -5
  198. package/src/server/responses/core-codex-account.ts +8 -1
  199. package/src/server/responses/core-combo-failure.ts +6 -1
  200. package/src/server/responses/core-combo-native.ts +150 -37
  201. package/src/server/responses/core-combo.ts +15 -9
  202. package/src/server/responses/core-normalize.ts +1 -0
  203. package/src/server/responses/core-options.ts +7 -1
  204. package/src/server/responses/core-pipeline.ts +21 -1
  205. package/src/server/responses/fetch-helpers.ts +5 -0
  206. package/src/server/responses/opengateway-completion-guard.ts +7 -3
  207. package/src/server/responses/passthrough-delivery.ts +8 -1
  208. package/src/server/responses/passthrough-error.ts +22 -0
  209. package/src/server/responses/request-prepare.ts +7 -1
  210. package/src/server/responses/request-transport.ts +28 -5
  211. package/src/server/responses/run-turn-execution.ts +13 -0
  212. package/src/server/sse-frame-buffer.ts +5 -0
  213. package/src/server/ws-bridge.ts +10 -0
  214. package/src/service/launchd.ts +78 -4
  215. package/src/telemetry/aggregate.ts +348 -0
  216. package/src/telemetry/consent.ts +128 -0
  217. package/src/telemetry/contract.ts +403 -0
  218. package/src/telemetry/disclosure.ts +19 -0
  219. package/src/telemetry/install-id.ts +226 -0
  220. package/src/telemetry/payload.ts +129 -0
  221. package/src/telemetry/profile/client.ts +150 -0
  222. package/src/telemetry/profile/contract.ts +288 -0
  223. package/src/telemetry/profile/disclosure.ts +14 -0
  224. package/src/telemetry/profile/paths.ts +13 -0
  225. package/src/telemetry/profile/routes.ts +99 -0
  226. package/src/telemetry/profile/service.ts +234 -0
  227. package/src/telemetry/profile/state.ts +189 -0
  228. package/src/telemetry/profile/sync.ts +276 -0
  229. package/src/telemetry/routes.ts +183 -0
  230. package/src/telemetry/scheduler.ts +386 -0
  231. package/src/telemetry/sender.ts +97 -0
  232. package/src/telemetry/state.ts +334 -0
  233. package/src/types/combo-jev-effort-mode.ts +11 -0
  234. package/src/types/config.ts +3 -0
  235. package/src/types/provider.ts +11 -1
  236. package/src/types/request.ts +2 -0
  237. package/src/types/telemetry.ts +15 -0
  238. package/src/types/wire.ts +10 -0
  239. package/src/types.ts +5 -0
  240. package/src/update/index.ts +7 -1
  241. package/src/update/minisign.d.mts +17 -0
  242. package/src/update/minisign.mjs +88 -0
  243. package/src/update/signed-supply.d.mts +59 -0
  244. package/src/update/signed-supply.mjs +289 -0
  245. package/src/update/trust-root.json +38 -0
  246. package/src/update/update-bounded-json.d.mts +4 -0
  247. package/src/update/update-bounded-json.mjs +113 -0
  248. package/src/update/update-bytes.d.mts +2 -0
  249. package/src/update/update-bytes.mjs +23 -0
  250. package/src/update/update-candidate-id.d.mts +2 -0
  251. package/src/update/update-candidate-id.mjs +23 -0
  252. package/src/update/update-checkpoint-codec.d.mts +33 -0
  253. package/src/update/update-checkpoint-codec.mjs +217 -0
  254. package/src/update/update-contracts.d.mts +24 -0
  255. package/src/update/update-contracts.mjs +207 -0
  256. package/src/update/update-signature-threshold.d.mts +12 -0
  257. package/src/update/update-signature-threshold.mjs +47 -0
  258. package/src/update/update-signed-version.d.mts +5 -0
  259. package/src/update/update-signed-version.mjs +25 -0
  260. package/src/update/update-trust-anchor.d.mts +2 -0
  261. package/src/update/update-trust-anchor.mjs +2 -0
  262. package/src/usage/cache-diagnostic.ts +195 -50
  263. package/src/usage/expected-prices.ts +20 -2
  264. package/src/usage/filter-index.ts +1469 -0
  265. package/src/usage/ledger-scanner.ts +245 -4
  266. package/src/usage/source-filter.ts +10 -2
  267. package/src/usage/summary.ts +16 -0
  268. package/src/web-search/parse.ts +265 -38
  269. package/gui/dist/assets/App-BepstgEN.js +0 -59
  270. package/gui/dist/assets/Tray-BinxbEZo.js +0 -1
  271. package/gui/dist/assets/brand-mark-wzPe3R-J.js +0 -1
  272. package/gui/dist/assets/index-C-9X2yaI.js +0 -94
  273. package/gui/dist/assets/index-bnUWypyz.css +0 -2
  274. package/gui/dist/classic/assets/App-DX88_GCW.js +0 -58
  275. package/gui/dist/classic/assets/index-fSP71pLB.js +0 -94
  276. package/gui/dist/classic/assets/quota-summary-y2fl0WBv.js +0 -1
@@ -6,9 +6,21 @@ import {
6
6
  type UsageLogRevision,
7
7
  } from "../../usage/log";
8
8
  import {
9
+ readUsageLedgerRowsAtOffsets,
9
10
  scanUsageLedgerCooperatively,
10
11
  UsageLedgerRebuildRequiredError,
11
12
  } from "../../usage/ledger-scanner";
13
+ import {
14
+ readUsageFilterCandidates,
15
+ readUsageFilterCandidatesPassive,
16
+ requestUsageFilterIndexRebuild,
17
+ resetUsageFilterIndexForTests,
18
+ type UsageFilterCandidateRead,
19
+ type UsageFilterIndexQuery,
20
+ type UsageFilterIndexSnapshot,
21
+ type UsageFilterQueryStats,
22
+ } from "../../usage/filter-index";
23
+ import { isPassiveRead } from "../../lib/passive-read";
12
24
  import {
13
25
  createUsageSummaryAccumulator,
14
26
  type UsageSummaryAccumulator,
@@ -63,6 +75,11 @@ export interface UsageAggregateResult {
63
75
  overlayVersion: number;
64
76
  timeZone: string;
65
77
  update: "unchanged" | "append" | "rebuild";
78
+ /**
79
+ * Present on filtered results: how many ledger rows the derived candidate index read to
80
+ * answer this filter, against the whole ledger. A full scan reports the same number twice.
81
+ */
82
+ filterIndex?: UsageFilterQueryStats;
66
83
  }
67
84
 
68
85
  export interface UsageAggregateOptions {
@@ -88,13 +105,19 @@ export interface UsageAggregateRetainedStats {
88
105
  }
89
106
 
90
107
  const MAX_REBUILD_ATTEMPTS = 2;
108
+ // A filtered read can lose a race with a concurrent index rebuild and a ledger replacement in
109
+ // the same call, so it gets one more attempt than a plain scan rebuild.
110
+ const MAX_FILTER_INDEX_ATTEMPTS = 3;
111
+ // Selected rows are folded in bounded batches, so a filter that matches most of a large ledger
112
+ // costs the same peak memory as the streaming scan it replaces.
113
+ const FILTER_ROW_READ_BATCH = 2_000;
91
114
  const MAX_RETAINED_FILTERED_AGGREGATES = 4;
92
115
 
93
116
  let retainedAggregate: RetainedUsageAggregate | null = null;
94
117
  const pinnedAggregates = new Set<RetainedAggregateState>();
95
118
  let baseFlight: Promise<UsageAggregateResult> | null = null;
96
119
  const filteredFlights = new Map<string, Promise<UsageAggregateResult>>();
97
- const retainedFilteredAggregates = new Map<string, RetainedUsageAggregate>();
120
+ const retainedFilteredAggregates = new Map<string, RetainedFilteredAggregate>();
98
121
  const MAX_CONCURRENT_FILTERED_AGGREGATES = 4;
99
122
  const retainedJevStatsAggregates = new Map<string, RetainedJevStatsAggregate>();
100
123
  const jevStatsFlights = new Map<string, Promise<JevStatsAggregateResult>>();
@@ -341,6 +364,162 @@ type NormalizedUsageFilter = {
341
364
  configuredApiKeyIds?: readonly string[];
342
365
  };
343
366
 
367
+ /**
368
+ * A retained filtered projection plus the index generation its candidates came from.
369
+ * `null` means it was built by the streaming fallback and cannot be extended incrementally.
370
+ */
371
+ type RetainedFilteredAggregate = RetainedUsageAggregate & { indexGeneration: string | null };
372
+
373
+ /** The derived index and the ledger disagree about where a row starts. */
374
+ class UsageFilterIndexCorruptError extends Error {}
375
+
376
+ /** Pricing or time-zone inputs moved while a filtered projection was being built. */
377
+ class UsageAggregationInputsChangedError extends Error {}
378
+
379
+ function filterQuery(
380
+ filter: NormalizedUsageFilter,
381
+ window?: UsageTimeWindow,
382
+ ): UsageFilterIndexQuery {
383
+ return {
384
+ provider: filter.provider,
385
+ model: filter.model,
386
+ apiKeyId: filter.apiKeyId,
387
+ ...(filter.sourceFilter ? { sourceFilter: filter.sourceFilter } : {}),
388
+ ...(filter.configuredApiKeyIds ? { configuredApiKeyIds: filter.configuredApiKeyIds } : {}),
389
+ ...(window ? { window } : {}),
390
+ };
391
+ }
392
+
393
+ function filterStats(
394
+ read: UsageFilterCandidateRead,
395
+ update: UsageAggregateResult["update"],
396
+ ): UsageFilterQueryStats {
397
+ return {
398
+ totalRows: read.snapshot.indexedRows,
399
+ candidateRows: read.offsets.length,
400
+ scope: update,
401
+ ingestedRows: read.snapshot.ingestedRows,
402
+ ingestPasses: read.snapshot.ingestPasses,
403
+ };
404
+ }
405
+
406
+ function filteredStateFrom(
407
+ accumulator: UsageSummaryAccumulator,
408
+ snapshot: UsageFilterIndexSnapshot,
409
+ overlayVersion: number,
410
+ timeZone: string,
411
+ ): RetainedFilteredAggregate {
412
+ return {
413
+ accumulator,
414
+ // Diagnostics describe the whole ledger, not the selected candidates: an invalid or
415
+ // oversized row outside the filter still means the report is incomplete.
416
+ usageIncomplete: snapshot.oversizedRows > 0,
417
+ usageInvalidRows: snapshot.invalidRows > 0,
418
+ revision: snapshot.revision,
419
+ identityKey: snapshot.identityKey,
420
+ revisionKey: usageLogRevisionKey(snapshot.revision),
421
+ processedThroughBytes: snapshot.indexedOffset,
422
+ processedThroughDigest: snapshot.processedThroughDigest,
423
+ overlayVersion,
424
+ timeZone,
425
+ retainedAt: Date.now(),
426
+ indexGeneration: snapshot.generation,
427
+ };
428
+ }
429
+
430
+ /** The pre-index streaming read, used when the projection is unavailable or passive. */
431
+ function streamingStateFrom(
432
+ accumulator: UsageSummaryAccumulator,
433
+ scan: Awaited<ReturnType<typeof scanUsageLedgerCooperatively>>,
434
+ overlayVersion: number,
435
+ timeZone: string,
436
+ ): RetainedFilteredAggregate {
437
+ return {
438
+ accumulator,
439
+ usageIncomplete: scan.oversizedRows > 0,
440
+ usageInvalidRows: scan.invalidRows > 0,
441
+ revision: scan.revision,
442
+ identityKey: usageLogIdentityKey(scan.revision),
443
+ revisionKey: usageLogRevisionKey(scan.revision),
444
+ processedThroughBytes: scan.processedThroughBytes,
445
+ processedThroughDigest: scan.processedThroughDigest,
446
+ overlayVersion,
447
+ timeZone,
448
+ retainedAt: Date.now(),
449
+ indexGeneration: null,
450
+ };
451
+ }
452
+
453
+ /**
454
+ * Candidate selection for one filter.
455
+ *
456
+ * A passive management read must not create or write anything, so it only uses a projection
457
+ * that is already current; otherwise the caller streams. Both paths return null when the
458
+ * acceleration is unusable, never when the ledger itself failed.
459
+ */
460
+ async function readCandidates(
461
+ query: UsageFilterIndexQuery,
462
+ ): Promise<UsageFilterCandidateRead | null> {
463
+ return isPassiveRead()
464
+ ? readUsageFilterCandidatesPassive(query)
465
+ : readUsageFilterCandidates(query);
466
+ }
467
+
468
+ async function accumulateCandidates(
469
+ accumulator: UsageSummaryAccumulator,
470
+ read: UsageFilterCandidateRead,
471
+ filter: NormalizedUsageFilter,
472
+ ): Promise<void> {
473
+ // Always read at least once, even with no candidates: the reader validates the snapshot
474
+ // against the ledger, and an empty selection must not skip that check.
475
+ const batchCount = Math.max(1, Math.ceil(read.offsets.length / FILTER_ROW_READ_BATCH));
476
+ for (let batch = 0; batch < batchCount; batch += 1) {
477
+ const start = batch * FILTER_ROW_READ_BATCH;
478
+ const rows = await readUsageLedgerRowsAtOffsets({
479
+ offsets: read.offsets.slice(start, start + FILTER_ROW_READ_BATCH),
480
+ expectedIdentityKey: read.snapshot.identityKey,
481
+ // The offsets belong to this index snapshot. If the ledger moved since the snapshot,
482
+ // the reader re-validates the boundary before trusting any of them, and a rewrite of
483
+ // the indexed tail becomes a rebuild instead of a silently different row set.
484
+ expectedRevisionKey: usageLogRevisionKey(read.snapshot.revision),
485
+ expectedProcessedThroughBytes: read.snapshot.indexedOffset,
486
+ expectedProcessedThroughDigest: read.snapshot.processedThroughDigest,
487
+ // The physical size at publish time; a torn suffix makes it larger than the boundary.
488
+ expectedFileSize: read.snapshot.revision?.size,
489
+ });
490
+ if (rows.unreadableOffsets.length > 0) {
491
+ // Serving only the rows that happened to parse would silently under-report the filter.
492
+ throw new UsageFilterIndexCorruptError();
493
+ }
494
+ for (const entry of rows.entries) accumulator.add(entry);
495
+ }
496
+ // Without a source filter the reported span covers the whole ledger, including rows this
497
+ // filter never selected. A source filter derives its span from the rows that match it, so
498
+ // only the unfiltered-source case needs the ledger-wide span restored.
499
+ if (!filter.sourceFilter) {
500
+ accumulator.noteLedgerSpan(read.snapshot.minTimestamp, read.snapshot.maxTimestamp);
501
+ }
502
+ }
503
+
504
+ async function withFilterIndexRetry<T>(run: () => Promise<T>): Promise<T> {
505
+ let lastError: unknown;
506
+ for (let attempt = 0; attempt < MAX_FILTER_INDEX_ATTEMPTS; attempt += 1) {
507
+ try {
508
+ return await run();
509
+ } catch (error) {
510
+ lastError = error;
511
+ if (error instanceof UsageFilterIndexCorruptError) {
512
+ requestUsageFilterIndexRebuild();
513
+ continue;
514
+ }
515
+ if (error instanceof UsageLedgerRebuildRequiredError) continue;
516
+ if (error instanceof UsageAggregationInputsChangedError) continue;
517
+ throw error;
518
+ }
519
+ }
520
+ throw lastError ?? new Error("filtered usage aggregate did not settle");
521
+ }
522
+
344
523
  function trimRetainedFilteredAggregates(): void {
345
524
  while (retainedFilteredAggregates.size > MAX_RETAINED_FILTERED_AGGREGATES) {
346
525
  const oldest = [...retainedFilteredAggregates]
@@ -353,87 +532,98 @@ function trimRetainedFilteredAggregates(): void {
353
532
 
354
533
  function publishFilteredAggregate(
355
534
  key: string,
356
- state: RetainedUsageAggregate,
535
+ state: RetainedFilteredAggregate,
357
536
  update: UsageAggregateResult["update"],
537
+ read: UsageFilterCandidateRead | null,
358
538
  ): UsageAggregateResult {
359
539
  retainedFilteredAggregates.set(key, state);
360
540
  trimRetainedFilteredAggregates();
361
541
  enforceAppOwnedMemoryBudget();
362
- return resultFrom(state, update);
542
+ return read
543
+ ? { ...resultFrom(state, update), filterIndex: filterStats(read, update) }
544
+ : resultFrom(state, update);
363
545
  }
364
546
 
365
547
  async function rebuildFilteredAggregate(
366
548
  key: string,
367
549
  filter: NormalizedUsageFilter,
368
550
  window?: UsageTimeWindow,
551
+ overlayVersion: number = userCostOverlayVersion(),
552
+ timeZone: string = currentTimeZone(),
369
553
  ): Promise<UsageAggregateResult> {
370
- let lastError: unknown;
371
- for (let attempt = 0; attempt < MAX_REBUILD_ATTEMPTS; attempt += 1) {
372
- const overlayVersion = userCostOverlayVersion();
373
- const timeZone = currentTimeZone();
374
- const accumulator = createUsageSummaryAccumulator({ filter, mode: "row-unique", window });
375
- try {
376
- const scan = await scanUsageLedgerCooperatively({ onEntry: entry => accumulator.add(entry) });
377
- if (userCostOverlayVersion() !== overlayVersion || currentTimeZone() !== timeZone) {
378
- lastError = new Error("usage aggregation inputs changed during filtered scan");
379
- continue;
380
- }
381
- const state = makeRetainedAggregate(accumulator, scan, overlayVersion, timeZone);
382
- return publishFilteredAggregate(key, state, "rebuild");
383
- } catch (error) {
384
- lastError = error;
385
- if (!(error instanceof UsageLedgerRebuildRequiredError) || attempt + 1 >= MAX_REBUILD_ATTEMPTS) {
386
- throw error;
387
- }
388
- }
554
+ const read = await readCandidates(filterQuery(filter, window));
555
+ if (!read) {
556
+ return rebuildFilteredAggregateStreaming(key, filter, window, overlayVersion, timeZone);
389
557
  }
390
- throw lastError ?? new Error("filtered usage scan did not settle");
558
+ const accumulator = createUsageSummaryAccumulator({
559
+ filter,
560
+ mode: "row-unique",
561
+ ...(window ? { window } : {}),
562
+ });
563
+ await accumulateCandidates(accumulator, read, filter);
564
+ if (userCostOverlayVersion() !== overlayVersion || currentTimeZone() !== timeZone) {
565
+ throw new UsageAggregationInputsChangedError();
566
+ }
567
+ return publishFilteredAggregate(
568
+ key,
569
+ filteredStateFrom(accumulator, read.snapshot, overlayVersion, timeZone),
570
+ "rebuild",
571
+ read,
572
+ );
573
+ }
574
+
575
+ async function rebuildFilteredAggregateStreaming(
576
+ key: string,
577
+ filter: NormalizedUsageFilter,
578
+ window: UsageTimeWindow | undefined,
579
+ overlayVersion: number,
580
+ timeZone: string,
581
+ ): Promise<UsageAggregateResult> {
582
+ const accumulator = createUsageSummaryAccumulator({
583
+ filter,
584
+ mode: "row-unique",
585
+ ...(window ? { window } : {}),
586
+ });
587
+ const scan = await scanUsageLedgerCooperatively({ onEntry: entry => accumulator.add(entry) });
588
+ if (userCostOverlayVersion() !== overlayVersion || currentTimeZone() !== timeZone) {
589
+ throw new UsageAggregationInputsChangedError();
590
+ }
591
+ return publishFilteredAggregate(
592
+ key,
593
+ streamingStateFrom(accumulator, scan, overlayVersion, timeZone),
594
+ "rebuild",
595
+ null,
596
+ );
391
597
  }
392
598
 
393
599
  async function appendFilteredAggregate(
394
600
  key: string,
395
- state: RetainedUsageAggregate,
601
+ state: RetainedFilteredAggregate,
396
602
  filter: NormalizedUsageFilter,
397
- window?: UsageTimeWindow,
603
+ read: UsageFilterCandidateRead,
604
+ overlayVersion: number,
605
+ timeZone: string,
398
606
  ): Promise<UsageAggregateResult> {
399
607
  pinnedAggregates.add(state);
400
- let rebuildAfterUnpin = false;
401
608
  try {
402
609
  const candidate = state.accumulator.clone();
403
- const scan = await scanUsageLedgerCooperatively({
404
- startAtBytes: state.processedThroughBytes,
405
- expectedIdentityKey: state.identityKey,
406
- expectedProcessedThroughDigest: state.processedThroughDigest,
407
- onEntry: entry => candidate.add(entry),
408
- });
409
- if (userCostOverlayVersion() !== state.overlayVersion || currentTimeZone() !== state.timeZone) {
410
- if (retainedFilteredAggregates.get(key) === state) retainedFilteredAggregates.delete(key);
411
- rebuildAfterUnpin = true;
412
- } else {
413
- const next: RetainedUsageAggregate = {
414
- ...state,
415
- accumulator: candidate,
416
- usageIncomplete: state.usageIncomplete || scan.oversizedRows > 0,
417
- usageInvalidRows: state.usageInvalidRows || scan.invalidRows > 0,
418
- revision: scan.revision,
419
- identityKey: usageLogIdentityKey(scan.revision),
420
- revisionKey: usageLogRevisionKey(scan.revision),
421
- processedThroughBytes: scan.processedThroughBytes,
422
- processedThroughDigest: scan.processedThroughDigest,
423
- retainedAt: Date.now(),
424
- };
425
- return publishFilteredAggregate(key, next, "append");
610
+ await accumulateCandidates(candidate, read, filter);
611
+ if (userCostOverlayVersion() !== overlayVersion || currentTimeZone() !== timeZone) {
612
+ throw new UsageAggregationInputsChangedError();
426
613
  }
614
+ return publishFilteredAggregate(
615
+ key,
616
+ filteredStateFrom(candidate, read.snapshot, overlayVersion, timeZone),
617
+ "append",
618
+ read,
619
+ );
427
620
  } catch (error) {
428
621
  if (retainedFilteredAggregates.get(key) === state) retainedFilteredAggregates.delete(key);
429
- if (error instanceof UsageLedgerRebuildRequiredError) rebuildAfterUnpin = true;
430
- else throw error;
622
+ throw error;
431
623
  } finally {
432
624
  pinnedAggregates.delete(state);
433
625
  trimRetainedFilteredAggregates();
434
626
  }
435
- if (rebuildAfterUnpin) return rebuildFilteredAggregate(key, filter, window);
436
- throw new Error("filtered usage append did not settle");
437
627
  }
438
628
 
439
629
  async function refreshFilteredAggregate(
@@ -441,20 +631,52 @@ async function refreshFilteredAggregate(
441
631
  filter: NormalizedUsageFilter,
442
632
  window?: UsageTimeWindow,
443
633
  ): Promise<UsageAggregateResult> {
444
- const state = retainedFilteredAggregates.get(key);
445
- if (!state) return rebuildFilteredAggregate(key, filter, window);
446
- const observed = currentUsageLogRevision();
447
- const overlayVersion = userCostOverlayVersion();
448
- const timeZone = currentTimeZone();
449
- if (requiresRebuild(state, observed, overlayVersion, timeZone)) {
450
- retainedFilteredAggregates.delete(key);
451
- return rebuildFilteredAggregate(key, filter, window);
452
- }
453
- if (state.revisionKey === usageLogRevisionKey(observed)) {
454
- state.retainedAt = Date.now();
455
- return resultFrom(state, "unchanged");
456
- }
457
- return appendFilteredAggregate(key, state, filter, window);
634
+ return withFilterIndexRetry(async () => {
635
+ const overlayVersion = userCostOverlayVersion();
636
+ const timeZone = currentTimeZone();
637
+ const state = retainedFilteredAggregates.get(key);
638
+ if (!state
639
+ || state.overlayVersion !== overlayVersion
640
+ || state.timeZone !== timeZone
641
+ || state.indexGeneration === null) {
642
+ return rebuildFilteredAggregate(key, filter, window, overlayVersion, timeZone);
643
+ }
644
+ const read = await readCandidates({
645
+ ...filterQuery(filter, window),
646
+ afterOffset: state.processedThroughBytes,
647
+ });
648
+ if (!read) {
649
+ retainedFilteredAggregates.delete(key);
650
+ return rebuildFilteredAggregate(key, filter, window, overlayVersion, timeZone);
651
+ }
652
+ if (state.indexGeneration !== read.snapshot.generation
653
+ || state.identityKey !== read.snapshot.identityKey
654
+ || state.processedThroughBytes > read.snapshot.indexedOffset) {
655
+ retainedFilteredAggregates.delete(key);
656
+ return rebuildFilteredAggregate(key, filter, window, overlayVersion, timeZone);
657
+ }
658
+ if (state.processedThroughBytes === read.snapshot.indexedOffset) {
659
+ // Even an unchanged retained projection validates the ledger against the snapshot, so a
660
+ // rewrite in the window between the index refresh and this return is not served stale.
661
+ await readUsageLedgerRowsAtOffsets({
662
+ offsets: [],
663
+ expectedIdentityKey: read.snapshot.identityKey,
664
+ expectedRevisionKey: usageLogRevisionKey(read.snapshot.revision),
665
+ expectedProcessedThroughBytes: read.snapshot.indexedOffset,
666
+ expectedProcessedThroughDigest: read.snapshot.processedThroughDigest,
667
+ expectedFileSize: read.snapshot.revision?.size,
668
+ });
669
+ state.retainedAt = Date.now();
670
+ // Whole-ledger diagnostics can move without the boundary moving: a torn oversized or
671
+ // malformed suffix is observed by every append scan and never advances the offset.
672
+ state.usageIncomplete = read.snapshot.oversizedRows > 0;
673
+ state.usageInvalidRows = read.snapshot.invalidRows > 0;
674
+ state.revision = read.snapshot.revision;
675
+ state.revisionKey = usageLogRevisionKey(read.snapshot.revision);
676
+ return publishFilteredAggregate(key, state, "unchanged", read);
677
+ }
678
+ return appendFilteredAggregate(key, state, filter, read, overlayVersion, timeZone);
679
+ });
458
680
  }
459
681
 
460
682
  function jevStatsResultFrom(
@@ -681,4 +903,5 @@ export function resetUsageAggregateCacheForTests(): void {
681
903
  retainedFilteredAggregates.clear();
682
904
  jevStatsFlights.clear();
683
905
  retainedJevStatsAggregates.clear();
906
+ resetUsageFilterIndexForTests();
684
907
  }
@@ -94,7 +94,7 @@ import { CatalogGatherBusyError } from "../codex/catalog/provider-fetch";
94
94
  import type { CatalogDisposition, ConvergeCodex } from "../codex/convergence-types";
95
95
  import { normalizeCatalogDisposition } from "../codex/catalog-refresh-status";
96
96
  import { managementBodyTooLargeResponse } from "./management/body";
97
- import { handleSessionRoutes } from "./management/session-routes";
97
+ import { handleSessionRoutes, SESSION_REMEMBER_PATH } from "./management/session-routes";
98
98
  import { siblingRefusesManagementRequest } from "./management/sibling-guard";
99
99
  import { siblingOfLivePort, siblingSkipMessage } from "../codex/sibling-start";
100
100
  import { packageVersion } from "../lib/package-version";
@@ -238,6 +238,12 @@ async function handleLinkRoutesOnDemand(ctx: ManagementContext): Promise<Respons
238
238
  return handleLinkRoutes(ctx);
239
239
  }
240
240
 
241
+ async function handleTelemetryRoutesOnDemand(ctx: ManagementContext): Promise<Response | null> {
242
+ if (!pathInManagementNamespace(ctx.url.pathname, "/api/telemetry")) return null;
243
+ const { handleTelemetryRoutes } = await import("./management/telemetry-routes");
244
+ return handleTelemetryRoutes(ctx);
245
+ }
246
+
241
247
  export async function handleManagementAPI(
242
248
  req: Request,
243
249
  url: URL,
@@ -248,7 +254,9 @@ export async function handleManagementAPI(
248
254
  requestIngress: ManagementRequestIngress = { trustedLoopback: false },
249
255
  ): Promise<Response | null> {
250
256
  if (!isAllowedManagementOrigin(req, config)) {
251
- return jsonResponse({ error: "cross-origin request blocked" }, 403, req, config);
257
+ // A proxied dashboard reaches Remember through this gate first; name the reason (#8338).
258
+ const remember = url.pathname === SESSION_REMEMBER_PATH ? { code: "remember_requires_direct_origin" } : {};
259
+ return jsonResponse({ error: "cross-origin request blocked", ...remember }, 403, req, config);
252
260
  }
253
261
  if (principal === "local-account-switch-capability") {
254
262
  if (req.method !== "PUT" || !isLocalAccountSwitchPath(url.pathname) || url.search !== "") {
@@ -393,6 +401,7 @@ export async function handleManagementAPI(
393
401
  ?? (await handleComboRoutes(ctx))
394
402
  ?? (await handleSystemRoutes(ctx))
395
403
  ?? (await handleLabRoutesOnDemand(ctx))
404
+ ?? (await handleTelemetryRoutesOnDemand(ctx))
396
405
  ?? (await handleUsageTimelineRoutes(ctx))
397
406
  ?? (await handleCompanionRoutes(ctx))
398
407
  ?? (await handleSidebarRoutes(ctx));
@@ -0,0 +1,166 @@
1
+ import { comboFailureDecision } from "../combos";
2
+ import { httpStatusFromTerminalError } from "../lib/errors";
3
+ import { redactSecretString } from "../lib/redact";
4
+ import { sseFieldValue } from "../lib/sse-decoder";
5
+ import type { TranslatorBudget } from "../lib/translator-budget";
6
+ import { anthropicUsageToOcx } from "./messages-shared";
7
+ import type { RequestLogContext } from "./request-log";
8
+ import { BoundedSseFrameBuffer, MAX_CLIENT_SSE_FRAME_BYTES, SseFrameCountLimitError, SseFrameTooLargeError } from "./sse-frame-buffer";
9
+ import { UNDECLARED_TOOL_CALL_ERROR_CODE } from "./responses-undeclared-tool-guard";
10
+
11
+ type Rec = Record<string, unknown>;
12
+ const isRec = (value: unknown): value is Rec => value !== null && typeof value === "object" && !Array.isArray(value);
13
+
14
+ /** Capture replay evidence before any relay can split a physical upstream read into frames. */
15
+ export function observeNativeMessagesReplayBoundary(body: ReadableStream<Uint8Array>, logCtx: RequestLogContext, replay: { committed: boolean; pending: boolean }): ReadableStream<Uint8Array> {
16
+ const reader = body.getReader();
17
+ const inspector = new BoundedSseFrameBuffer();
18
+ const decoder = new TextDecoder();
19
+ let active = true;
20
+ return new ReadableStream<Uint8Array>({
21
+ async pull(controller) {
22
+ try {
23
+ const next = await reader.read();
24
+ if (next.done) { inspector.dispose(); controller.close(); return; }
25
+ if (active) {
26
+ let errorSeen = false;
27
+ let finished = false;
28
+ try {
29
+ for (const frame of inspector.feed(next.value)) {
30
+ if (frame.continuation) continue;
31
+ const lines = decoder.decode(frame.block).split(/\r\n|\r|\n/);
32
+ const event = lines.map(line => sseFieldValue(line, "event")).findLast(value => value !== null) ?? null;
33
+ const dataFields = lines.map(line => sseFieldValue(line, "data")).filter(value => value !== null);
34
+ const data = dataFields.join("\n");
35
+ let payload: unknown;
36
+ try { payload = JSON.parse(data); } catch { payload = undefined; }
37
+ const type = isRec(payload) && (event === null || event === payload.type) ? payload.type : undefined;
38
+ if (errorSeen && (event !== null || dataFields.length > 0) && type !== "ping") logCtx.streamErrorFollowed = true;
39
+ if (type === "error" && isRec(payload) && isRec(payload.error)) errorSeen = true;
40
+ else if ((event !== null || dataFields.length > 0) && type !== "ping" && !(type === "message_start" && isRec(payload) && isRec(payload.message) && Array.isArray(payload.message.content) && payload.message.content.length === 0)) {
41
+ replay.committed = true; finished = true;
42
+ }
43
+ }
44
+ replay.pending = inspector.pendingBytes > 0;
45
+ // An unfinished event can still acquire a different name or payload on the next read.
46
+ if (errorSeen && inspector.pendingBytes > 0) logCtx.streamErrorFollowed = true;
47
+ if (errorSeen || finished) { active = false; inspector.dispose(); }
48
+ } catch (error) {
49
+ if (!(error instanceof SseFrameTooLargeError || error instanceof SseFrameCountLimitError)) throw error;
50
+ logCtx.streamErrorFollowed = true;
51
+ replay.committed = true;
52
+ active = false; inspector.dispose();
53
+ }
54
+ }
55
+ controller.enqueue(next.value);
56
+ } catch (error) { inspector.dispose(); controller.error(error); }
57
+ },
58
+ cancel(reason) { inspector.dispose(); return reader.cancel(reason); },
59
+ }, { highWaterMark: 0 });
60
+ }
61
+
62
+ /** Inspect only the bounded protocol prelude. Any block, unknown payload or cap commits. */
63
+ export async function preflightNativeMessagesResponse(
64
+ response: Response, logCtx: RequestLogContext, budget: TranslatorBudget, replay?: { committed: boolean },
65
+ ): Promise<{ kind: "accepted" | "failed"; response: Response }> {
66
+ if (!response.ok || !response.body || !response.headers.get("content-type")?.toLowerCase().includes("text/event-stream")) {
67
+ return { kind: "accepted", response };
68
+ }
69
+ let committed = false;
70
+ let terminal = false;
71
+ let failure: Rec | undefined;
72
+ let failureStatus = 502;
73
+ let usage: Rec = {};
74
+ const inspector = new BoundedSseFrameBuffer();
75
+ const decoder = new TextDecoder();
76
+ const inspectFrame = (block: Uint8Array) => {
77
+ // A retryable failure keeps reading its chunk: later output in it still commits.
78
+ if (committed || terminal) return;
79
+ const lines = decoder.decode(block).split(/\r\n|\r|\n/);
80
+ const event = lines.map(line => sseFieldValue(line, "event")).findLast(value => value !== null) ?? null;
81
+ const data = lines.map(line => sseFieldValue(line, "data")).filter(value => value !== null).join("\n");
82
+ // A named event without a payload is malformed and commits; a comment-only block is skipped.
83
+ if (!data) { if (event !== null) committed = true; return; }
84
+ let payload: unknown;
85
+ try { payload = JSON.parse(data); } catch { committed = true; return; }
86
+ // Match the native log tap: the last, untrimmed event field is authoritative. A payload
87
+ // under another event name is unknown output, never a replayable refusal or prelude.
88
+ if (!isRec(payload) || (event !== null && event !== payload.type)) { committed = true; return; }
89
+ if (payload.type === "message_start" && isRec(payload.message)) {
90
+ if (isRec(payload.message.usage)) usage = { ...usage, ...payload.message.usage };
91
+ if (!Array.isArray(payload.message.content) || payload.message.content.length !== 0) committed = true;
92
+ } else if (payload.type === "ping") {
93
+ // Protocol liveness is not output.
94
+ } else if (payload.type === "error" && isRec(payload.error)) {
95
+ const error = payload.error;
96
+ const status = httpStatusFromTerminalError({ type: typeof error.type === "string" ? error.type : undefined,
97
+ code: typeof error.code === "string" ? error.code : undefined,
98
+ message: typeof error.message === "string" ? error.message : undefined }) ?? 502;
99
+ if (logCtx.terminalSource !== "synthetic" && logCtx.errorCode !== UNDECLARED_TOOL_CALL_ERROR_CODE
100
+ && comboFailureDecision(status, typeof error.message === "string" ? error.message : "", {
101
+ code: typeof error.code === "string" ? error.code : undefined,
102
+ }) === "hop") { failure = error; failureStatus = status; }
103
+ else committed = true;
104
+ } else if (payload.type === "message_stop") terminal = true;
105
+ else committed = true;
106
+ };
107
+ const reader = response.body.getReader();
108
+ const chunks: Uint8Array[] = [];
109
+ let retained = 0;
110
+ const release = () => { budget.releaseRetained(retained, { kind: "retained_collectors" }); retained = 0; };
111
+ try {
112
+ for (;;) {
113
+ const next = await reader.read();
114
+ if (next.done) { terminal = true; break; }
115
+ // The one upstream chunk already exists; retain it without a copy if the cap commits.
116
+ if (retained + next.value.byteLength > MAX_CLIENT_SSE_FRAME_BYTES || chunks.length >= 1024) {
117
+ chunks.push(next.value); committed = true; break;
118
+ }
119
+ // Classify before retaining: a chunk that commits is held like the cap's, so a budget
120
+ // refusal can only meet a prelude that is still safe to replay.
121
+ try {
122
+ for (const frame of inspector.feed(next.value)) if (!frame.continuation) inspectFrame(frame.block);
123
+ } catch (error) {
124
+ if (!(error instanceof SseFrameTooLargeError || error instanceof SseFrameCountLimitError)) throw error;
125
+ committed = true;
126
+ }
127
+ if (!committed) {
128
+ budget.chargeRetained(next.value.byteLength, { kind: "retained_collectors" });
129
+ retained += next.value.byteLength;
130
+ }
131
+ chunks.push(next.value);
132
+ if (committed || terminal || failure) break;
133
+ }
134
+ // The tap read the original upstream chunk; output after the error there commits too.
135
+ if (failure && !committed && !replay?.committed && !logCtx.streamErrorFollowed) {
136
+ logCtx.usage = anthropicUsageToOcx(usage);
137
+ const message = redactSecretString(typeof failure.message === "string" ? failure.message : "Provider stream failed before output");
138
+ logCtx.upstreamError = `Provider stream failed (${failureStatus})`;
139
+ void reader.cancel("retrying native Messages pre-output refusal").catch(() => {});
140
+ release();
141
+ const headers = new Headers(response.headers);
142
+ headers.set("content-type", "application/json"); headers.delete("content-length"); headers.delete("content-encoding");
143
+ return { kind: "failed", response: Response.json({ error: {
144
+ ...(typeof failure.type === "string" ? { type: failure.type } : {}),
145
+ ...(typeof failure.code === "string" ? { code: failure.code } : {}),
146
+ message,
147
+ } }, { status: failureStatus, headers }) };
148
+ }
149
+ let index = 0;
150
+ const body = new ReadableStream<Uint8Array>({
151
+ async pull(controller) {
152
+ try {
153
+ if (index < chunks.length) { controller.enqueue(chunks[index++]!); return; }
154
+ chunks.length = 0;
155
+ release();
156
+ const next = await reader.read();
157
+ if (next.done) controller.close(); else controller.enqueue(next.value);
158
+ } catch (error) { release(); controller.error(error); }
159
+ },
160
+ cancel(reason) { release(); void reader.cancel(reason).catch(() => {}); },
161
+ }, { highWaterMark: 0 });
162
+ return { kind: "accepted", response: new Response(body, { status: response.status, headers: response.headers }) };
163
+ } catch (error) {
164
+ release(); void reader.cancel(error).catch(() => {}); throw error;
165
+ } finally { inspector.dispose(); }
166
+ }