@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
@@ -0,0 +1,289 @@
1
+ import { createHash } from "node:crypto";
2
+ import { parseRootTransitionEnvelope, parseSignatureEnvelope, parseUpdateDocument } from "./update-contracts.mjs";
3
+ import { EMBEDDED_ROOT_SHA256 } from "./update-trust-anchor.mjs";
4
+ import { snapshotUpdateBytes } from "./update-bytes.mjs";
5
+ import { verifySignatureThreshold } from "./update-signature-threshold.mjs";
6
+ import { deriveCandidateId } from "./update-candidate-id.mjs";
7
+ import { decodePublicKey, verifyMinisignBytes } from "./minisign.mjs";
8
+ import { trustedCommentMatchesVersion } from "./update-signed-version.mjs";
9
+
10
+ // Handles are module-owned and contain no caller-mutable trust data.
11
+ const ROOTS = new WeakMap();
12
+ const TRANSITIONS = new WeakMap();
13
+ const RELEASES = new WeakMap();
14
+ const CANDIDATES = new WeakMap();
15
+ const ARTIFACTS = new WeakMap();
16
+ const RECEIPTS = new WeakMap();
17
+ const TREES = new WeakMap();
18
+ const CAPABILITIES = new WeakMap();
19
+
20
+ function currentRoot(handle, nowMs) {
21
+ if (!Number.isSafeInteger(nowMs) || nowMs < 0) throw new Error("Invalid trust clock");
22
+ const state = ROOTS.get(handle) || TRANSITIONS.get(handle);
23
+ if (!state || Date.parse(state.root.expiresAt) <= nowMs) throw new Error("Invalid or expired update root");
24
+ return state;
25
+ }
26
+
27
+ /** Authenticate the one root whose digest is compiled into this module closure. */
28
+ export function bootstrapEmbeddedRoot(bytes, nowMs) {
29
+ if (!Number.isSafeInteger(nowMs) || nowMs < 0) throw new Error("Invalid embedded root input");
30
+ const snapshot = snapshotUpdateBytes(bytes, 65536);
31
+ const digest = createHash("sha256").update(snapshot).digest("hex");
32
+ if (digest !== EMBEDDED_ROOT_SHA256) throw new Error("Embedded root digest mismatch");
33
+ const root = parseUpdateDocument(snapshot, "ocx.update.root/1");
34
+ if (Date.parse(root.expiresAt) <= nowMs) throw new Error("Embedded root expired");
35
+ const handle = Object.freeze(Object.create(null));
36
+ ROOTS.set(handle, { root, bytes: snapshot, digest });
37
+ return handle;
38
+ }
39
+
40
+ /** Verify a dual-threshold root transition as evidence, without promoting trust. */
41
+ export function verifyRootTransition(predecessorBasis, bytes, envelopeBytes, nowMs) {
42
+ const previous = currentRoot(predecessorBasis, nowMs);
43
+ const nextBytes = snapshotUpdateBytes(bytes, 65536);
44
+ const signatureBytes = snapshotUpdateBytes(envelopeBytes, 262144);
45
+ const envelope = parseRootTransitionEnvelope(signatureBytes);
46
+ const root = parseUpdateDocument(nextBytes, "ocx.update.root/1");
47
+ if (root.revision <= previous.root.revision || Date.parse(root.expiresAt) <= nowMs) {
48
+ throw new Error("Invalid successor root");
49
+ }
50
+ const oldKeys = new Map(previous.root.rootKeys.map((key) => [key.keyId, key]));
51
+ const newKeys = new Map(root.rootKeys.map((key) => [key.keyId, key]));
52
+ for (const [fingerprint, oldKey] of oldKeys) {
53
+ const newKey = newKeys.get(fingerprint);
54
+ if (newKey) {
55
+ const decode = (key) => decodePublicKey(Buffer.from(key.publicKey, "base64").toString("utf8"));
56
+ if (decode(oldKey).keyId !== decode(newKey).keyId) throw new Error("Incompatible root key packet identifiers");
57
+ }
58
+ }
59
+ if (envelope.signatures.some((signature) => !oldKeys.has(signature.keyFingerprint) && !newKeys.has(signature.keyFingerprint))) {
60
+ throw new Error("Unknown root transition signer");
61
+ }
62
+ const subset = (keys) => ({ signatures: envelope.signatures.filter((signature) => keys.has(signature.keyFingerprint)) });
63
+ verifySignatureThreshold(nextBytes, subset(oldKeys), previous.root.rootKeys, previous.root.rootThreshold);
64
+ verifySignatureThreshold(nextBytes, subset(newKeys), root.rootKeys, root.rootThreshold);
65
+ const digest = createHash("sha256").update(nextBytes).digest("hex");
66
+ const handle = Object.freeze(Object.create(null));
67
+ TRANSITIONS.set(handle, { root, bytes: nextBytes, digest, predecessorDigest: previous.digest,
68
+ predecessorRevision: previous.root.revision, envelopeBytes: signatureBytes });
69
+ return handle;
70
+ }
71
+
72
+ /** Return diagnostic data only; this does not promote or persist a root. */
73
+ export function inspectTransition(transition) {
74
+ const state = TRANSITIONS.get(transition);
75
+ if (!state) throw new Error("Invalid root transition evidence");
76
+ return Object.freeze({ predecessorDigest: state.predecessorDigest, predecessorRevision: state.predecessorRevision,
77
+ successorDigest: state.digest, successorRevision: state.root.revision });
78
+ }
79
+
80
+ /** Verify exact release bytes under a root basis as evidence only. */
81
+ export function verifyReleaseEvidence(bytes, envelopeBytes, rootBasis, expectedChannel, nowMs) {
82
+ const state = currentRoot(rootBasis, nowMs);
83
+ if (!state.root.channels.includes(expectedChannel)) throw new Error("Unsupported update channel");
84
+ const releaseBytes = snapshotUpdateBytes(bytes, 1048576);
85
+ const signatureBytes = snapshotUpdateBytes(envelopeBytes, 65536);
86
+ const envelope = parseSignatureEnvelope(signatureBytes);
87
+ const keys = state.root.releaseKeys.filter((key) => key.channels.includes(expectedChannel) && key.roles.includes("release"));
88
+ verifySignatureThreshold(releaseBytes, envelope, keys, state.root.releaseThreshold);
89
+ const release = parseUpdateDocument(releaseBytes, "ocx.update.release/1");
90
+ if (release.channel !== expectedChannel) throw new Error("Signed release channel mismatch");
91
+ const digest = createHash("sha256").update(releaseBytes).digest("hex");
92
+ const handle = Object.freeze(Object.create(null));
93
+ RELEASES.set(handle, { release, root: rootBasis, digest, bytes: releaseBytes, envelopeBytes: signatureBytes });
94
+ return handle;
95
+ }
96
+
97
+ /** Select a signed tuple; the resulting identity is a lookup, not install authority. */
98
+ export function selectTargetEvidence(releaseEvidence, selection) {
99
+ const state = RELEASES.get(releaseEvidence);
100
+ const fields = ["platform", "arch", "owner", "artifactKind", "bundleKind"];
101
+ if (!state || !selection || typeof selection !== "object" || Array.isArray(selection)
102
+ || Object.keys(selection).length !== fields.length || !fields.every((field) => Object.hasOwn(selection, field))) {
103
+ throw new Error("Invalid verified update selection");
104
+ }
105
+ const matches = state.release.targets.filter((target) => fields.every((field) => target[field] === selection[field]));
106
+ if (matches.length !== 1) throw new Error("Update target unavailable");
107
+ const candidateId = deriveCandidateId(state.digest, matches[0].id);
108
+ const handle = Object.freeze({ candidateId });
109
+ CANDIDATES.set(handle, { release: releaseEvidence, root: state.root, target: matches[0] });
110
+ return handle;
111
+ }
112
+
113
+ /** Verify artifact bytes as evidence; this grants no staging or install authority. */
114
+ export function verifyArtifactEvidence(targetEvidence, bytes, basis, nowMs) {
115
+ const state = currentRoot(basis, nowMs);
116
+ const candidate = CANDIDATES.get(targetEvidence);
117
+ if (!candidate || candidate.root !== basis) throw new Error("Invalid target evidence basis");
118
+ const release = RELEASES.get(candidate.release);
119
+ if (!release || release.root !== basis) throw new Error("Invalid release evidence basis");
120
+ const target = candidate.target;
121
+ const roles = { tauri: "desktop-artifact", standalone: "standalone-artifact", guardian: "guardian-artifact", tree: "tree" };
122
+ const role = roles[target.artifactKind];
123
+ if (!role || state.root.releaseThreshold !== 1) throw new Error("Unsupported artifact signature threshold");
124
+ const key = state.root.releaseKeys.find((entry) => entry.keyId === target.artifact.signerFingerprint
125
+ && entry.channels.includes(release.release.channel) && entry.roles.includes(role));
126
+ if (!key) throw new Error("Artifact signer is not delegated");
127
+ const snapshot = snapshotUpdateBytes(bytes, target.artifact.size);
128
+ if (snapshot.byteLength !== target.artifact.size
129
+ || createHash("sha256").update(snapshot).digest("hex") !== target.artifact.sha256) {
130
+ throw new Error("Artifact bytes do not match signed target");
131
+ }
132
+ const publicBox = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(Buffer.from(key.publicKey, "base64"));
133
+ const result = verifyMinisignBytes(snapshot, target.artifact.signatureBox, decodePublicKey(publicBox));
134
+ if (!trustedCommentMatchesVersion(result.trustedComment, release.release.version)) {
135
+ throw new Error("Signed artifact version mismatch");
136
+ }
137
+ const handle = Object.freeze(Object.create(null));
138
+ ARTIFACTS.set(handle, { target: targetEvidence, basis, digest: target.artifact.sha256, size: snapshot.byteLength });
139
+ return handle;
140
+ }
141
+
142
+ function checkedBytes(bytes, expected, cap) {
143
+ if (expected.size > cap) throw new Error("Metadata size exceeds limit");
144
+ const snapshot = snapshotUpdateBytes(bytes, expected.size);
145
+ if (snapshot.byteLength !== expected.size || createHash("sha256").update(snapshot).digest("hex") !== expected.sha256) {
146
+ throw new Error("Metadata bytes do not match signed record");
147
+ }
148
+ return snapshot;
149
+ }
150
+
151
+ function requireAsset(receipt, name, expected) {
152
+ const matches = receipt.assets.filter((asset) => asset.name === name);
153
+ if (matches.length !== 1 || (expected && (matches[0].sha256 !== expected.sha256 || matches[0].size !== expected.size))) {
154
+ throw new Error("Receipt asset mismatch");
155
+ }
156
+ return matches[0];
157
+ }
158
+
159
+ /** Verify receipt, tree or capability evidence against one signed target and basis. */
160
+ export function verifyExternalMetadataEvidence(targetEvidence, input, basis, nowMs) {
161
+ const state = currentRoot(basis, nowMs);
162
+ const candidate = CANDIDATES.get(targetEvidence);
163
+ if (!candidate || candidate.root !== basis) throw new Error("Invalid target evidence basis");
164
+ const releaseState = RELEASES.get(candidate.release);
165
+ if (!releaseState || releaseState.root !== basis || !input || typeof input !== "object" || Array.isArray(input)) {
166
+ throw new Error("Invalid metadata evidence input");
167
+ }
168
+ const release = releaseState.release;
169
+ const target = candidate.target;
170
+ const prefix = `ocx-update-${release.version}-${release.channel}-${target.id}`;
171
+ const treeName = `${prefix}.tree.json`;
172
+ const capabilityName = `${prefix}.capabilities.json`;
173
+ const descriptors = Object.getOwnPropertyDescriptors(input);
174
+ const kind = descriptors.kind && Object.hasOwn(descriptors.kind, "value") ? descriptors.kind.value : undefined;
175
+ const fields = kind === "receipt" ? ["kind", "bytes"]
176
+ : kind === "tree" ? ["kind", "bytes", "signatureEnvelopeBytes", "receiptEvidence"]
177
+ : kind === "capability" ? ["kind", "bytes", "receiptEvidence"] : [];
178
+ if (!fields.length || Reflect.ownKeys(descriptors).length !== fields.length
179
+ || !fields.every((field) => Object.hasOwn(descriptors, field) && descriptors[field].enumerable
180
+ && Object.hasOwn(descriptors[field], "value"))) {
181
+ throw new Error("Invalid metadata evidence input");
182
+ }
183
+ const data = Object.fromEntries(fields.map((field) => [field, descriptors[field].value]));
184
+ if (kind === "receipt") {
185
+ const bytes = checkedBytes(data.bytes, release.receipt, 1048576);
186
+ const receipt = parseUpdateDocument(bytes, "ocx.update.verification/1");
187
+ if (receipt.version !== release.version || receipt.channel !== release.channel || receipt.sourceCommit !== release.sourceCommit) {
188
+ throw new Error("Receipt release mismatch");
189
+ }
190
+ requireAsset(receipt, target.assetName, target.artifact);
191
+ requireAsset(receipt, capabilityName, target.capabilities);
192
+ if (target.tree) {
193
+ requireAsset(receipt, treeName, target.tree);
194
+ requireAsset(receipt, `${treeName}.signatures.json`);
195
+ }
196
+ if (target.platform === "macos" && target.owner === "desktop" && target.artifactKind === "tauri" && target.bundleKind === "app-tar-gz") {
197
+ const proofs = receipt.universalProofs.filter((proof) => proof.assetName === target.assetName && proof.artifactSha256 === target.artifact.sha256);
198
+ if (proofs.length !== 1) throw new Error("Missing or ambiguous universal artifact proof");
199
+ } else if (target.platform === "macos") {
200
+ const proofs = receipt.architectureProofs.filter((proof) => proof.targetId === target.id && proof.assetName === target.assetName
201
+ && proof.artifactSha256 === target.artifact.sha256 && proof.arch === target.arch);
202
+ if (proofs.length !== 1) throw new Error("Missing or ambiguous architecture proof");
203
+ }
204
+ const handle = Object.freeze(Object.create(null));
205
+ RECEIPTS.set(handle, { receipt, bytes, target: targetEvidence, basis });
206
+ return handle;
207
+ }
208
+ const receiptState = RECEIPTS.get(data.receiptEvidence);
209
+ if (!receiptState || receiptState.target !== targetEvidence || receiptState.basis !== basis) throw new Error("Receipt evidence mismatch");
210
+ if (kind === "tree") {
211
+ if (!target.tree) throw new Error("Target has no tree metadata");
212
+ const treeBytes = checkedBytes(data.bytes, target.tree, 16777216);
213
+ const signatureEntry = requireAsset(receiptState.receipt, `${treeName}.signatures.json`);
214
+ const signatureBytes = checkedBytes(data.signatureEnvelopeBytes, signatureEntry, 65536);
215
+ const envelope = parseSignatureEnvelope(signatureBytes);
216
+ const keys = state.root.releaseKeys.filter((key) => key.channels.includes(release.channel) && key.roles.includes("tree"));
217
+ verifySignatureThreshold(treeBytes, envelope, keys, state.root.releaseThreshold);
218
+ const tree = parseUpdateDocument(treeBytes, "ocx.update.tree/1");
219
+ if (tree.version !== release.version || tree.target !== target.id) throw new Error("Tree target mismatch");
220
+ const handle = Object.freeze(Object.create(null));
221
+ TREES.set(handle, { tree, bytes: treeBytes, envelopeBytes: signatureBytes, target: targetEvidence, basis, receipt: data.receiptEvidence });
222
+ return handle;
223
+ }
224
+ const bytes = checkedBytes(data.bytes, target.capabilities, 1048576);
225
+ const capability = parseUpdateDocument(bytes, "ocx.link-capabilities/1");
226
+ if (capability.version !== release.version || capability.channel !== release.channel
227
+ || capability.target !== target.id || capability.artifactSha256 !== target.artifact.sha256) {
228
+ throw new Error("Capability target mismatch");
229
+ }
230
+ const handle = Object.freeze(Object.create(null));
231
+ CAPABILITIES.set(handle, { capability, bytes, target: targetEvidence, basis, receipt: data.receiptEvidence });
232
+ return handle;
233
+ }
234
+
235
+ const evidenceRecord = (kind, fields) => Object.freeze(Object.assign(Object.create(null), { kind }, fields));
236
+ const copyEvidenceBytes = (bytes, cap) => snapshotUpdateBytes(bytes, cap);
237
+ const evidenceDigest = (bytes) => createHash("sha256").update(bytes).digest("hex");
238
+
239
+ function evidenceBasis(handle) {
240
+ const state = ROOTS.get(handle) || TRANSITIONS.get(handle);
241
+ return { basisDigest: state.digest, basisRevision: state.root.revision };
242
+ }
243
+
244
+ function targetSnapshotFields(handle) {
245
+ const candidate = CANDIDATES.get(handle);
246
+ const release = RELEASES.get(candidate.release);
247
+ return { releaseDigest: release.digest, targetId: candidate.target.id,
248
+ candidateId: deriveCandidateId(release.digest, candidate.target.id), ...evidenceBasis(candidate.root) };
249
+ }
250
+
251
+ /** Return detached evidence data only; snapshots confer no update authority. */
252
+ export function snapshotEvidence(handle) {
253
+ let state = ROOTS.get(handle);
254
+ if (state) return evidenceRecord("root", { rootBytes: copyEvidenceBytes(state.bytes, 65536),
255
+ rootDigest: state.digest, rootRevision: state.root.revision, anchorDigest: EMBEDDED_ROOT_SHA256 });
256
+ state = TRANSITIONS.get(handle);
257
+ if (state) return evidenceRecord("transition", { rootBytes: copyEvidenceBytes(state.bytes, 65536),
258
+ envelopeBytes: copyEvidenceBytes(state.envelopeBytes, 262144), rootDigest: state.digest,
259
+ rootRevision: state.root.revision, predecessorDigest: state.predecessorDigest, predecessorRevision: state.predecessorRevision });
260
+ state = RELEASES.get(handle);
261
+ if (state) return evidenceRecord("release", { releaseBytes: copyEvidenceBytes(state.bytes, 1048576),
262
+ envelopeBytes: copyEvidenceBytes(state.envelopeBytes, 65536), releaseDigest: state.digest,
263
+ channel: state.release.channel, ...evidenceBasis(state.root) });
264
+ state = CANDIDATES.get(handle);
265
+ if (state) {
266
+ const { platform, arch, owner, artifactKind, bundleKind } = state.target;
267
+ return evidenceRecord("target", { ...targetSnapshotFields(handle),
268
+ selection: Object.freeze({ platform, arch, owner, artifactKind, bundleKind }) });
269
+ }
270
+ state = ARTIFACTS.get(handle);
271
+ if (state) {
272
+ const target = CANDIDATES.get(state.target).target;
273
+ return evidenceRecord("artifact", { ...targetSnapshotFields(state.target), artifactDigest: state.digest,
274
+ artifactSize: state.size, signatureBox: target.artifact.signatureBox, signerFingerprint: target.artifact.signerFingerprint });
275
+ }
276
+ state = RECEIPTS.get(handle);
277
+ if (state) return evidenceRecord("receipt", { receiptBytes: copyEvidenceBytes(state.bytes, 1048576),
278
+ receiptDigest: evidenceDigest(state.bytes), receiptSize: state.bytes.byteLength, ...targetSnapshotFields(state.target) });
279
+ state = TREES.get(handle);
280
+ if (state) return evidenceRecord("tree", { treeBytes: copyEvidenceBytes(state.bytes, 16777216),
281
+ envelopeBytes: copyEvidenceBytes(state.envelopeBytes, 65536), treeDigest: evidenceDigest(state.bytes),
282
+ treeSize: state.bytes.byteLength, envelopeDigest: evidenceDigest(state.envelopeBytes), envelopeSize: state.envelopeBytes.byteLength,
283
+ receiptDigest: evidenceDigest(RECEIPTS.get(state.receipt).bytes), ...targetSnapshotFields(state.target) });
284
+ state = CAPABILITIES.get(handle);
285
+ if (state) return evidenceRecord("capability", { capabilityBytes: copyEvidenceBytes(state.bytes, 1048576),
286
+ capabilityDigest: evidenceDigest(state.bytes), capabilitySize: state.bytes.byteLength,
287
+ receiptDigest: evidenceDigest(RECEIPTS.get(state.receipt).bytes), ...targetSnapshotFields(state.target) });
288
+ throw new Error("Invalid update evidence");
289
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "schema": "ocx.update.root/1",
3
+ "revision": 1,
4
+ "expiresAt": "2028-11-07T00:00:00Z",
5
+ "rootKeys": [
6
+ {
7
+ "keyId": "eae4c0180e8ca39a844b3c0e1ec28842261e85628d6dee77ceff5dd081853799",
8
+ "algorithm": "minisign-ed25519-blake2b512/1",
9
+ "publicKey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IEFDNzZCMDg0NkVCRUJGODEKUldTQnY3NXVoTEIyckhRUXJMOXJRUDR0aHQ2L3pLVHVweXFSc1lzS24vWDNiSUJ5MXJIZmpyb2sK"
10
+ }
11
+ ],
12
+ "rootThreshold": 1,
13
+ "releaseKeys": [
14
+ {
15
+ "keyId": "eae4c0180e8ca39a844b3c0e1ec28842261e85628d6dee77ceff5dd081853799",
16
+ "algorithm": "minisign-ed25519-blake2b512/1",
17
+ "publicKey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IEFDNzZCMDg0NkVCRUJGODEKUldTQnY3NXVoTEIyckhRUXJMOXJRUDR0aHQ2L3pLVHVweXFSc1lzS24vWDNiSUJ5MXJIZmpyb2sK",
18
+ "channels": [
19
+ "latest",
20
+ "preview",
21
+ "nightly"
22
+ ],
23
+ "roles": [
24
+ "release",
25
+ "tree",
26
+ "desktop-artifact",
27
+ "standalone-artifact",
28
+ "guardian-artifact"
29
+ ]
30
+ }
31
+ ],
32
+ "releaseThreshold": 1,
33
+ "channels": [
34
+ "latest",
35
+ "preview",
36
+ "nightly"
37
+ ]
38
+ }
@@ -0,0 +1,4 @@
1
+ export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
2
+
3
+ /** Parses data only: callers must separately validate schema and authority. */
4
+ export function parseBoundedJson(bytes: Uint8Array, maxBytes: number): JsonValue;
@@ -0,0 +1,113 @@
1
+ // Parsing produces data only. It does not establish schema validity or trust.
2
+ import { snapshotUpdateBytes } from "./update-bytes.mjs";
3
+ const MAX_DOCUMENT_BYTES = 16 * 1024 * 1024;
4
+ const MAX_DEPTH = 16;
5
+ const MAX_MEMBERS = 32;
6
+ const MAX_ITEMS = 4096;
7
+ const MAX_TEXT_BYTES = 16384;
8
+ // The six maximal capability arrays require 73,735 values including containers.
9
+ const MAX_VALUES = 81920;
10
+ const NUMBER = /-?(?:0|[1-9][0-9]*)/y;
11
+
12
+ function invalid() {
13
+ throw new Error("Invalid bounded update JSON");
14
+ }
15
+
16
+ function validUnicode(text) {
17
+ for (let i = 0; i < text.length; i++) {
18
+ const code = text.charCodeAt(i);
19
+ if (code >= 0xd800 && code <= 0xdbff) {
20
+ const next = text.charCodeAt(++i);
21
+ if (!(next >= 0xdc00 && next <= 0xdfff)) return false;
22
+ } else if (code >= 0xdc00 && code <= 0xdfff) return false;
23
+ }
24
+ return true;
25
+ }
26
+
27
+ /** Parse bounded UTF-8 JSON, refusing ambiguous names and unsafe numbers. */
28
+ export function parseBoundedJson(bytes, maxBytes) {
29
+ if (!(bytes instanceof Uint8Array) || !Number.isSafeInteger(maxBytes)
30
+ || maxBytes < 1 || maxBytes > MAX_DOCUMENT_BYTES) invalid();
31
+ let source;
32
+ try {
33
+ const snapshot = snapshotUpdateBytes(bytes, maxBytes);
34
+ source = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(snapshot);
35
+ } catch {
36
+ invalid();
37
+ }
38
+ let offset = 0;
39
+ let values = 0;
40
+ const whitespace = () => {
41
+ while (source[offset] === " " || source[offset] === "\n"
42
+ || source[offset] === "\r" || source[offset] === "\t") offset++;
43
+ };
44
+ const readString = () => {
45
+ if (source[offset] !== '"') invalid();
46
+ const start = offset++;
47
+ while (offset < source.length) {
48
+ const char = source[offset++];
49
+ if (char === '"') {
50
+ let result;
51
+ try { result = JSON.parse(source.slice(start, offset)); } catch { invalid(); }
52
+ if (!validUnicode(result) || Buffer.byteLength(result, "utf8") > MAX_TEXT_BYTES) invalid();
53
+ return result;
54
+ }
55
+ if (char === "\\") offset++;
56
+ else if (char.charCodeAt(0) < 0x20) invalid();
57
+ }
58
+ invalid();
59
+ };
60
+ const readValue = (depth) => {
61
+ if (++values > MAX_VALUES) invalid();
62
+ whitespace();
63
+ const first = source[offset];
64
+ if (first === '"') return readString();
65
+ if (first === "{" || first === "[") {
66
+ if (depth >= MAX_DEPTH) invalid();
67
+ offset++;
68
+ whitespace();
69
+ if (first === "{") {
70
+ const result = Object.create(null);
71
+ const names = new Set();
72
+ if (source[offset] === "}") { offset++; return result; }
73
+ while (true) {
74
+ whitespace();
75
+ const key = readString();
76
+ if (names.has(key) || names.size >= MAX_MEMBERS) invalid();
77
+ names.add(key);
78
+ whitespace();
79
+ if (source[offset++] !== ":") invalid();
80
+ result[key] = readValue(depth + 1);
81
+ whitespace();
82
+ const delimiter = source[offset++];
83
+ if (delimiter === "}") return result;
84
+ if (delimiter !== ",") invalid();
85
+ }
86
+ }
87
+ const result = [];
88
+ if (source[offset] === "]") { offset++; return result; }
89
+ while (true) {
90
+ if (result.length >= MAX_ITEMS) invalid();
91
+ result.push(readValue(depth + 1));
92
+ whitespace();
93
+ const delimiter = source[offset++];
94
+ if (delimiter === "]") return result;
95
+ if (delimiter !== ",") invalid();
96
+ }
97
+ }
98
+ for (const [literal, value] of [["true", true], ["false", false], ["null", null]]) {
99
+ if (source.startsWith(literal, offset)) { offset += literal.length; return value; }
100
+ }
101
+ NUMBER.lastIndex = offset;
102
+ const match = NUMBER.exec(source);
103
+ if (!match || match[0] === "-0") invalid();
104
+ const number = Number(match[0]);
105
+ if (!Number.isSafeInteger(number)) invalid();
106
+ offset = NUMBER.lastIndex;
107
+ return number;
108
+ };
109
+ const value = readValue(0);
110
+ whitespace();
111
+ if (offset !== source.length) invalid();
112
+ return value;
113
+ }
@@ -0,0 +1,2 @@
1
+ /** Returns a private snapshot without invoking caller-defined byte-view properties. */
2
+ export function snapshotUpdateBytes(bytes: Uint8Array, maxBytes: number): Uint8Array;
@@ -0,0 +1,23 @@
1
+ // Capture native typed-array accessors so caller-defined properties are never read.
2
+ const typedArrayPrototype = Object.getPrototypeOf(Uint8Array.prototype);
3
+ const getBuffer = Object.getOwnPropertyDescriptor(typedArrayPrototype, "buffer").get;
4
+ const getByteOffset = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteOffset").get;
5
+ const getByteLength = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteLength").get;
6
+ const setBytes = Uint8Array.prototype.set;
7
+
8
+ /** Copy a bounded byte view without invoking caller-defined getters or iterators. */
9
+ export function snapshotUpdateBytes(bytes, maxBytes) {
10
+ if (!(bytes instanceof Uint8Array) || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
11
+ throw new Error("Invalid update bytes");
12
+ }
13
+ try {
14
+ const length = getByteLength.call(bytes);
15
+ if (length > maxBytes) throw new Error("Update bytes exceed limit");
16
+ const view = new Uint8Array(getBuffer.call(bytes), getByteOffset.call(bytes), length);
17
+ const snapshot = new Uint8Array(length);
18
+ setBytes.call(snapshot, view);
19
+ return snapshot;
20
+ } catch {
21
+ throw new Error("Invalid update bytes");
22
+ }
23
+ }
@@ -0,0 +1,2 @@
1
+ /** A lookup identity only; the value does not grant update authority. */
2
+ export function deriveCandidateId(releaseDigest: string, targetId: string): string;
@@ -0,0 +1,23 @@
1
+ import { createHash } from "node:crypto";
2
+
3
+ const DOMAIN = Buffer.from("ocx.update.candidate/1\0", "ascii");
4
+
5
+ /** Derive a lookup identifier; callers must separately verify release and target authority. */
6
+ export function deriveCandidateId(releaseDigest, targetId) {
7
+ if (typeof releaseDigest !== "string" || !/^[0-9a-f]{64}$/.test(releaseDigest)) {
8
+ throw new Error("Invalid release digest");
9
+ }
10
+ if (typeof targetId !== "string" || !/^[A-Za-z0-9._-]{1,128}$/.test(targetId)
11
+ || targetId === "." || targetId === "..") {
12
+ throw new Error("Invalid target ID");
13
+ }
14
+ const target = Buffer.from(targetId, "utf8");
15
+ const length = Buffer.alloc(4);
16
+ length.writeUInt32BE(target.length);
17
+ return createHash("sha256")
18
+ .update(DOMAIN)
19
+ .update(Buffer.from(releaseDigest, "hex"))
20
+ .update(length)
21
+ .update(target)
22
+ .digest("hex");
23
+ }
@@ -0,0 +1,33 @@
1
+ /** Unauthenticated checkpoint data. These types do not grant update authority. */
2
+ export type CheckpointChannel = "latest" | "preview" | "nightly";
3
+ export interface CheckpointHistoryEntry {
4
+ previousRevision: number;
5
+ previousDigest: Uint8Array;
6
+ nextRevision: number;
7
+ nextDigest: Uint8Array;
8
+ acceptedAtMs: number;
9
+ rootBytes: Uint8Array;
10
+ envelopeBytes: Uint8Array;
11
+ }
12
+ export interface CheckpointFloor { sequence: number; releaseDigest: Uint8Array; version: string }
13
+ export interface CheckpointObservation { candidateDigest: Uint8Array; firstSeenMs: number }
14
+ export interface CheckpointPayload {
15
+ namespaceDigest: Uint8Array;
16
+ principalDigest: Uint8Array;
17
+ ownerKind: "desktop" | "npm" | "pnpm" | "bun" | "standalone" | "service";
18
+ consentGeneration: number;
19
+ identityKind: "posix" | "windows";
20
+ identityBytes: Uint8Array;
21
+ generation: number;
22
+ rootRevision: number;
23
+ rootDigest: Uint8Array;
24
+ rootBytes: Uint8Array;
25
+ history: CheckpointHistoryEntry[];
26
+ channels: Record<CheckpointChannel, CheckpointFloor | null>;
27
+ firstSeen: Record<CheckpointChannel, CheckpointObservation[]>;
28
+ clockHighWaterMs: number;
29
+ securityEpoch: number;
30
+ }
31
+ export function encodeCheckpointPayload(record: CheckpointPayload): Uint8Array;
32
+ export function decodeCheckpointPayload(bytes: Uint8Array): CheckpointPayload;
33
+ export function checkpointPayloadDigest(bytes: Uint8Array): string;