@tangle-network/agent-app 0.60.250 → 0.60.251

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 (222) hide show
  1. package/dist/DesignCanvas-L6J72JQ2.js +15 -0
  2. package/dist/DesignCanvasEditor-QFQD63MR.js +18 -0
  3. package/dist/agent-enrollment/drizzle.js +3 -3
  4. package/dist/agent-enrollment/index.js +3 -3
  5. package/dist/app-auth/drizzle.d.ts +561 -0
  6. package/dist/app-auth/drizzle.js +72 -0
  7. package/dist/app-auth/drizzle.js.map +1 -0
  8. package/dist/app-auth/index.js +5 -3
  9. package/dist/app-auth/index.js.map +1 -1
  10. package/dist/app-oauth/drizzle.d.ts +2080 -0
  11. package/dist/app-oauth/drizzle.js +161 -0
  12. package/dist/app-oauth/drizzle.js.map +1 -0
  13. package/dist/app-oauth/index.d.ts +4 -0
  14. package/dist/app-oauth/index.js +8 -222
  15. package/dist/app-oauth/index.js.map +1 -1
  16. package/dist/app-oauth/issuer.d.ts +133 -0
  17. package/dist/app-oauth/issuer.js +247 -0
  18. package/dist/app-oauth/issuer.js.map +1 -0
  19. package/dist/assistant/index.js +13 -13
  20. package/dist/chat-react/index.js +4 -4
  21. package/dist/chat-routes/index.js +37 -67
  22. package/dist/chat-routes/index.js.map +1 -1
  23. package/dist/chat-routes/promote-file-part.d.ts +2 -3
  24. package/dist/chat-store/index.js +4 -4
  25. package/dist/{chunk-MY3EJJ6Y.js → chunk-4FEH6266.js} +2 -2
  26. package/dist/{chunk-5Y7Z5G3Y.js → chunk-4GCPADYG.js} +20 -336
  27. package/dist/chunk-4GCPADYG.js.map +1 -0
  28. package/dist/{chunk-X556WVBG.js → chunk-4ZSLX3LY.js} +2 -2
  29. package/dist/chunk-57XPEL7X.js +26 -0
  30. package/dist/chunk-57XPEL7X.js.map +1 -0
  31. package/dist/chunk-6Z7TZVKZ.js +26 -0
  32. package/dist/chunk-6Z7TZVKZ.js.map +1 -0
  33. package/dist/{chunk-7KKOFMLD.js → chunk-AWIQQEFP.js} +1 -1
  34. package/dist/chunk-AWIQQEFP.js.map +1 -0
  35. package/dist/{chunk-VBKP2NLI.js → chunk-BTKI4XMM.js} +2 -2
  36. package/dist/{chunk-63QAQP7I.js → chunk-CNBVWPQC.js} +7 -7
  37. package/dist/{chunk-FENBDSIW.js → chunk-CQGEGPY7.js} +75 -3
  38. package/dist/chunk-CQGEGPY7.js.map +1 -0
  39. package/dist/chunk-CTREXL3O.js +335 -0
  40. package/dist/chunk-CTREXL3O.js.map +1 -0
  41. package/dist/chunk-DLWO3J7D.js +238 -0
  42. package/dist/chunk-DLWO3J7D.js.map +1 -0
  43. package/dist/{chunk-LWSJK546.js → chunk-DSMGS4IV.js} +5 -5
  44. package/dist/{chunk-LWSJK546.js.map → chunk-DSMGS4IV.js.map} +1 -1
  45. package/dist/{chunk-A3KPDLSF.js → chunk-EFPIHR6F.js} +18 -18
  46. package/dist/chunk-FRAICFTZ.js +191 -0
  47. package/dist/chunk-FRAICFTZ.js.map +1 -0
  48. package/dist/chunk-GS7VWV26.js +61 -0
  49. package/dist/chunk-GS7VWV26.js.map +1 -0
  50. package/dist/{chunk-NMSAZFRL.js → chunk-H5GQMLHA.js} +2 -2
  51. package/dist/{chunk-OQE6WMDP.js → chunk-HN6MZ2XL.js} +5 -5
  52. package/dist/chunk-HY57QRRW.js +11 -0
  53. package/dist/chunk-HY57QRRW.js.map +1 -0
  54. package/dist/{chunk-TCGZFSN5.js → chunk-KH4QSBNI.js} +2 -2
  55. package/dist/{chunk-JH3CKHF4.js → chunk-KJODHPWM.js} +8 -8
  56. package/dist/chunk-LSBI5MWS.js +66 -0
  57. package/dist/chunk-LSBI5MWS.js.map +1 -0
  58. package/dist/chunk-MDRH3SDA.js +106 -0
  59. package/dist/chunk-MDRH3SDA.js.map +1 -0
  60. package/dist/{chunk-VBWYH7UZ.js → chunk-NHYRIM4I.js} +3 -3
  61. package/dist/{chunk-BYP54FMI.js → chunk-O2RCDK5D.js} +30 -15
  62. package/dist/{chunk-BYP54FMI.js.map → chunk-O2RCDK5D.js.map} +1 -1
  63. package/dist/{chunk-EWOJATDS.js → chunk-PDD5A43Y.js} +3 -3
  64. package/dist/{chunk-23JUSUUB.js → chunk-RZLCBWGG.js} +2 -2
  65. package/dist/chunk-SFZELD6V.js +52 -0
  66. package/dist/chunk-SFZELD6V.js.map +1 -0
  67. package/dist/{chunk-Y4W6GK5X.js → chunk-UGFCLD32.js} +2 -2
  68. package/dist/{chunk-ZGUXI5SI.js → chunk-VUBJZEZB.js} +2 -2
  69. package/dist/{chunk-LQYIBL3G.js → chunk-WL7PZK7Q.js} +71 -1
  70. package/dist/chunk-WL7PZK7Q.js.map +1 -0
  71. package/dist/{chunk-7HZCFG2A.js → chunk-WP2GYFZ4.js} +38 -1
  72. package/dist/chunk-WP2GYFZ4.js.map +1 -0
  73. package/dist/{chunk-JK7R7BZQ.js → chunk-ZWJ3SZ2G.js} +2 -2
  74. package/dist/crypto/digest.d.ts +2 -0
  75. package/dist/crypto/index.d.ts +1 -0
  76. package/dist/crypto/index.js +6 -2
  77. package/dist/design-canvas/index.js +5 -3
  78. package/dist/design-canvas/index.js.map +1 -1
  79. package/dist/design-canvas-react/engine.js +7 -5
  80. package/dist/design-canvas-react/index.js +14 -12
  81. package/dist/design-canvas-react/index.js.map +1 -1
  82. package/dist/design-canvas-react/lazy.js +1 -1
  83. package/dist/eval/index.d.ts +4 -0
  84. package/dist/eval/index.js +125 -0
  85. package/dist/eval/index.js.map +1 -1
  86. package/dist/eval/persona-driver.d.ts +37 -0
  87. package/dist/eval/research-plan.d.ts +25 -0
  88. package/dist/eval/research-plan.js +55 -0
  89. package/dist/eval/research-plan.js.map +1 -0
  90. package/dist/eval/scorecard.d.ts +38 -0
  91. package/dist/forms/blank.d.ts +2 -2
  92. package/dist/forms/index.js +4 -5
  93. package/dist/forms/index.js.map +1 -1
  94. package/dist/hosted-agent/application.js +2 -2
  95. package/dist/interactions/index.js +3 -3
  96. package/dist/knowledge/prelaunch-audit.d.ts +17 -0
  97. package/dist/knowledge/prelaunch-audit.js +67 -0
  98. package/dist/knowledge/prelaunch-audit.js.map +1 -0
  99. package/dist/media/drizzle.d.ts +207 -0
  100. package/dist/media/drizzle.js +26 -0
  101. package/dist/media/drizzle.js.map +1 -0
  102. package/dist/media/generate-request.d.ts +53 -0
  103. package/dist/media/generation-record.d.ts +68 -0
  104. package/dist/media/index.d.ts +13 -0
  105. package/dist/media/index.js +653 -0
  106. package/dist/media/index.js.map +1 -0
  107. package/dist/media/model-catalog.d.ts +109 -0
  108. package/dist/media/router-client.d.ts +40 -0
  109. package/dist/media/router-generation.d.ts +44 -0
  110. package/dist/media/speech-script.d.ts +20 -0
  111. package/dist/openui/index.js +1 -1
  112. package/dist/operator/index.js +4 -5
  113. package/dist/operator/index.js.map +1 -1
  114. package/dist/plans/decision.d.ts +48 -0
  115. package/dist/plans/drizzle.d.ts +25 -0
  116. package/dist/plans/drizzle.js +97 -0
  117. package/dist/plans/drizzle.js.map +1 -0
  118. package/dist/plans/index.d.ts +1 -1
  119. package/dist/plans/index.js +11 -3
  120. package/dist/platform/billing-config.d.ts +22 -0
  121. package/dist/platform/billing-config.js +36 -0
  122. package/dist/platform/billing-config.js.map +1 -0
  123. package/dist/platform/index.js +13 -11
  124. package/dist/platform/index.js.map +1 -1
  125. package/dist/preset-cloudflare/index.js +2 -1
  126. package/dist/preset-cloudflare/index.js.map +1 -1
  127. package/dist/profile/index.js +4 -5
  128. package/dist/profile/index.js.map +1 -1
  129. package/dist/public-consultation/index.d.ts +1 -1
  130. package/dist/public-consultation/index.js +13 -11
  131. package/dist/public-consultation/index.js.map +1 -1
  132. package/dist/runtime/telemetry-cap.d.ts +24 -0
  133. package/dist/runtime/telemetry-cap.js +36 -0
  134. package/dist/runtime/telemetry-cap.js.map +1 -0
  135. package/dist/sandbox/index.js +12 -9
  136. package/dist/sequences/index.js +4 -2
  137. package/dist/sequences/index.js.map +1 -1
  138. package/dist/skills-placement/box.d.ts +50 -0
  139. package/dist/skills-placement/box.js +204 -0
  140. package/dist/skills-placement/box.js.map +1 -0
  141. package/dist/skills-placement/index.js +8 -96
  142. package/dist/skills-placement/index.js.map +1 -1
  143. package/dist/spend/budget.d.ts +13 -0
  144. package/dist/spend/drizzle.d.ts +55 -0
  145. package/dist/spend/drizzle.js +131 -0
  146. package/dist/spend/drizzle.js.map +1 -0
  147. package/dist/spend/index.d.ts +2 -1
  148. package/dist/spend/index.js +77 -58
  149. package/dist/spend/index.js.map +1 -1
  150. package/dist/spend/platform-settlements.d.ts +46 -0
  151. package/dist/stream/index.js +19 -19
  152. package/dist/studio/generated-media/index.d.ts +6 -0
  153. package/dist/studio/generated-media/index.js +590 -0
  154. package/dist/studio/generated-media/index.js.map +1 -0
  155. package/dist/studio/generated-media/output.d.ts +27 -0
  156. package/dist/studio/generated-media/store.d.ts +175 -0
  157. package/dist/studio-react/download-generations.d.ts +7 -0
  158. package/dist/studio-react/index.d.ts +1 -0
  159. package/dist/studio-react/index.js +85 -0
  160. package/dist/studio-react/index.js.map +1 -1
  161. package/dist/studio-react/use-studio-route.d.ts +44 -0
  162. package/dist/teams/invitations-api.d.ts +4 -0
  163. package/dist/teams/invitations-api.js +44 -32
  164. package/dist/teams/invitations-api.js.map +1 -1
  165. package/dist/theme/dom.d.ts +22 -0
  166. package/dist/theme/dom.js +18 -0
  167. package/dist/theme/dom.js.map +1 -0
  168. package/dist/vault/collaboration.d.ts +83 -0
  169. package/dist/vault/collaboration.js +215 -0
  170. package/dist/vault/collaboration.js.map +1 -0
  171. package/dist/vault/server.js +6 -53
  172. package/dist/vault/server.js.map +1 -1
  173. package/dist/vault/store/coordinator.d.ts +64 -0
  174. package/dist/vault/store/index.d.ts +12 -0
  175. package/dist/vault/store/index.js +1202 -0
  176. package/dist/vault/store/index.js.map +1 -0
  177. package/dist/vault/store/paths.d.ts +65 -0
  178. package/dist/vault/store/revisions.d.ts +211 -0
  179. package/dist/vault/store/sandbox-sync.d.ts +74 -0
  180. package/dist/vault/store/store.d.ts +161 -0
  181. package/dist/vault/store/tree.d.ts +11 -0
  182. package/dist/web/entry-server.d.ts +7 -0
  183. package/dist/web/entry-server.js +29 -0
  184. package/dist/web/entry-server.js.map +1 -0
  185. package/dist/web/fetch-guard.d.ts +6 -0
  186. package/dist/web/index.d.ts +3 -0
  187. package/dist/web/index.js +20 -4
  188. package/dist/web/mime.d.ts +16 -0
  189. package/dist/web/rate-limit.d.ts +25 -0
  190. package/dist/web/timeout.d.ts +9 -0
  191. package/dist/web-react/agent-profile-editor.js +3 -3
  192. package/dist/web-react/api-access-panel.d.ts +4 -2
  193. package/dist/web-react/document.d.ts +41 -0
  194. package/dist/web-react/document.js +103 -0
  195. package/dist/web-react/document.js.map +1 -0
  196. package/dist/web-react/index.js +31 -31
  197. package/dist/workspace-react/index.js +5 -5
  198. package/package.json +95 -4
  199. package/dist/DesignCanvas-OW3W2QXW.js +0 -13
  200. package/dist/DesignCanvasEditor-TCHZF25W.js +0 -16
  201. package/dist/chunk-5Y7Z5G3Y.js.map +0 -1
  202. package/dist/chunk-7HZCFG2A.js.map +0 -1
  203. package/dist/chunk-7KKOFMLD.js.map +0 -1
  204. package/dist/chunk-FENBDSIW.js.map +0 -1
  205. package/dist/chunk-LQYIBL3G.js.map +0 -1
  206. /package/dist/{DesignCanvas-OW3W2QXW.js.map → DesignCanvas-L6J72JQ2.js.map} +0 -0
  207. /package/dist/{DesignCanvasEditor-TCHZF25W.js.map → DesignCanvasEditor-QFQD63MR.js.map} +0 -0
  208. /package/dist/{chunk-MY3EJJ6Y.js.map → chunk-4FEH6266.js.map} +0 -0
  209. /package/dist/{chunk-X556WVBG.js.map → chunk-4ZSLX3LY.js.map} +0 -0
  210. /package/dist/{chunk-VBKP2NLI.js.map → chunk-BTKI4XMM.js.map} +0 -0
  211. /package/dist/{chunk-63QAQP7I.js.map → chunk-CNBVWPQC.js.map} +0 -0
  212. /package/dist/{chunk-A3KPDLSF.js.map → chunk-EFPIHR6F.js.map} +0 -0
  213. /package/dist/{chunk-NMSAZFRL.js.map → chunk-H5GQMLHA.js.map} +0 -0
  214. /package/dist/{chunk-OQE6WMDP.js.map → chunk-HN6MZ2XL.js.map} +0 -0
  215. /package/dist/{chunk-TCGZFSN5.js.map → chunk-KH4QSBNI.js.map} +0 -0
  216. /package/dist/{chunk-JH3CKHF4.js.map → chunk-KJODHPWM.js.map} +0 -0
  217. /package/dist/{chunk-VBWYH7UZ.js.map → chunk-NHYRIM4I.js.map} +0 -0
  218. /package/dist/{chunk-EWOJATDS.js.map → chunk-PDD5A43Y.js.map} +0 -0
  219. /package/dist/{chunk-23JUSUUB.js.map → chunk-RZLCBWGG.js.map} +0 -0
  220. /package/dist/{chunk-Y4W6GK5X.js.map → chunk-UGFCLD32.js.map} +0 -0
  221. /package/dist/{chunk-ZGUXI5SI.js.map → chunk-VUBJZEZB.js.map} +0 -0
  222. /package/dist/{chunk-JK7R7BZQ.js.map → chunk-ZWJ3SZ2G.js.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/vault/store/revisions.ts","../../../src/vault/store/tree.ts","../../../src/vault/store/store.ts","../../../src/vault/store/coordinator.ts","../../../src/vault/store/sandbox-sync.ts"],"sourcesContent":["/**\n * The Vault's revision model over a KV store: one head key per path, one\n * immutable revision record per write (committed or conflicting), and an\n * operation record that makes a multi-path batch visible all at once.\n *\n * `applyVaultMutationBatch` is the only writer. It must run under one writer\n * per workspace (the coordinator Durable Object, or the store's local queue);\n * readers use `readVaultHeadState`, which hides a batch that has not\n * committed by answering with its parent revision.\n */\nimport { sha256Hex } from '../../crypto/digest'\nimport type { KVStore } from '../../store'\nimport {\n validateVaultMutationKeys,\n vaultHeadKey,\n vaultOperationKey,\n vaultRevisionKey,\n} from './paths'\n\nexport const VAULT_HEAD_SCHEMA = 'vault-head-v1'\nexport const VAULT_REVISION_SCHEMA = 'vault-revision-v1'\nexport const VAULT_OPERATION_SCHEMA = 'vault-operation-v1'\nexport const VAULT_READ_CONVERGENCE_TIMEOUT_MS = 2_000\nexport const VAULT_READ_CONVERGENCE_INITIAL_DELAY_MS = 25\nexport const VAULT_READ_CONVERGENCE_MAX_DELAY_MS = 250\n/** Committed revisions of one path a lineage lookup reads before it gives up. */\nexport const VAULT_LINEAGE_MAX_REVISIONS = 32\n\nexport class VaultReadConvergenceError extends Error {\n readonly code = 'vault.read_not_converged'\n readonly retryable = true\n readonly workspaceId?: string\n readonly path?: string\n readonly expectedRevision?: string\n\n constructor(input: string | {\n message?: string\n workspaceId?: string\n path?: string\n expectedRevision?: string\n } = {}) {\n const detail = typeof input === 'string' ? { message: input } : input\n super(detail.message ?? 'Vault read did not converge before the retry deadline')\n this.name = 'VaultReadConvergenceError'\n this.workspaceId = detail.workspaceId\n this.path = detail.path\n this.expectedRevision = detail.expectedRevision\n }\n}\n\nexport type VaultWriterKind = 'frontend' | 'sandbox' | 'system'\nexport type VaultLearningActor = 'agent' | 'owner' | 'maintenance' | 'unknown'\n\n/** Who caused a write and through which surface. `source` values are product vocabulary. */\nexport interface VaultWriteProvenance {\n actor: VaultLearningActor\n source: string\n executionId?: string\n threadId?: string\n messageId?: string\n}\n\nexport interface VaultWriter {\n kind: VaultWriterKind\n id?: string\n authKind?: 'operator'\n keyId?: string\n provenance?: VaultWriteProvenance\n}\n\n/**\n * Attribution recorded at the writer, without prompt text or inferred\n * execution identities. Defaults follow the writer kind; `allowedSources` is\n * the product's provenance vocabulary and anything outside it is refused.\n */\nexport function normalizeVaultWriterProvenance(writer: VaultWriter, allowedSources: readonly string[]): VaultWriter {\n const supplied = writer.provenance\n const actor = writer.authKind === 'operator' ? 'unknown' : supplied?.actor\n ?? (writer.kind === 'sandbox' ? 'agent' : writer.kind === 'frontend' ? 'owner' : 'unknown')\n if (!['agent', 'owner', 'maintenance', 'unknown'].includes(actor)) throw new Error('Invalid Vault provenance actor')\n const source = supplied?.source ?? (writer.kind === 'sandbox' ? 'sandbox-sync' : writer.kind === 'frontend' ? 'vault-api' : 'unknown')\n if (!allowedSources.includes(source)) throw new Error('Invalid Vault provenance source')\n const provenance: VaultWriteProvenance = { actor, source }\n for (const key of ['executionId', 'threadId', 'messageId'] as const) {\n const value = supplied?.[key]\n if (value === undefined) continue\n if (typeof value !== 'string' || value.length > 128 || !/^(?:[A-Za-z0-9:_-]|%[A-Fa-f0-9]{2})+$/.test(value)) throw new Error(`Invalid Vault provenance ${key}`)\n provenance[key] = value\n }\n return { ...writer, provenance }\n}\n\n/** Who created the live entry and when; carried across updates, set again after a delete. */\nexport interface VaultCreation {\n by: string\n at: string\n}\n\n/** The actor a writer reads as in creation records. */\nexport function vaultWriterActor(writer: VaultWriter): string {\n if (writer.kind === 'sandbox') return writer.id ? `sandbox:${writer.id}` : 'vault:sandbox'\n return writer.id ?? `vault:${writer.kind}`\n}\n\nexport interface VaultHeadMetadata {\n schema: typeof VAULT_HEAD_SCHEMA\n revision: string\n contentHash: string | null\n deleted: boolean\n operationId: string\n updatedAt: string\n writer: VaultWriter\n batchOperation?: boolean\n /** Writes to this path so far, deletes included; absent on heads written before it existed. */\n sequence?: number\n created?: VaultCreation\n /** Opaque tag a product adapter records to decode its own writes. */\n storeFormat?: string\n}\n\ninterface VaultOperationState {\n schema: typeof VAULT_OPERATION_SCHEMA\n status: 'preparing' | 'committed'\n}\n\nexport interface VaultRevisionMetadata {\n schema: typeof VAULT_REVISION_SCHEMA\n workspaceId: string\n path: string\n revision: string\n parentRevision: string | null\n contentHash: string | null\n /** Actual UTF8 bytes recorded by the immutable revision writer; absent on older revisions. */\n contentBytes?: number\n deleted: boolean\n operationId: string\n createdAt: string\n writer: VaultWriter\n outcome: 'committed' | 'conflict'\n batchOperation?: boolean\n sequence?: number\n storeFormat?: string\n}\n\nexport interface VaultMutationChange {\n path: string\n kind: 'put' | 'delete'\n content?: string\n expectedRevision: string | null\n storeFormat?: string\n}\n\nexport interface VaultMutationRequest {\n workspaceId: string\n operationId: string\n writer: VaultWriter\n changes: VaultMutationChange[]\n}\n\nexport interface VaultMutationFileResult {\n path: string\n revision: string\n contentHash: string | null\n deleted: boolean\n /** Absent from a coordinator still running code from before the count existed. */\n sequence?: number\n updatedAt?: string\n}\n\nexport interface VaultMutationConflict {\n path: string\n expectedRevision: string | null\n currentRevision: string | null\n conflictRevision: string\n}\n\nexport type VaultMutationResult =\n | { status: 'applied'; files: VaultMutationFileResult[] }\n | { status: 'conflict'; conflicts: VaultMutationConflict[] }\n\nexport interface VaultHeadState {\n revision: string | null\n contentHash: string | null\n deleted: boolean\n content: string | null\n metadata: VaultHeadMetadata | null\n /** Set when `metadata` is null but the write count is known, as for a batch still in flight. */\n sequence?: number\n}\n\n/** What a mutation does to the writer before it is recorded (a product's provenance rules). */\nexport interface VaultMutationPolicy {\n normalizeWriter?: (writer: VaultWriter) => VaultWriter\n}\n\nfunction positiveInteger(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isSafeInteger(value) && value >= 1 ? value : undefined\n}\n\n/**\n * The per-path write count: 0 for a path never written, and deletes count. A\n * head written before the count existed reads as 1, so the next write records\n * 2 and the count only grows.\n */\nexport function vaultHeadSequence(state: Pick<VaultHeadState, 'revision' | 'metadata' | 'sequence'>): number {\n return positiveInteger(state.sequence) ?? positiveInteger(state.metadata?.sequence) ?? (state.revision ? 1 : 0)\n}\n\n/** The recorded creation of a head, or null when the Vault recorded none. */\nexport function vaultHeadCreation(metadata: VaultHeadMetadata | null): VaultCreation | null {\n const created = metadata?.created\n return created && typeof created.by === 'string' && created.by && typeof created.at === 'string' && created.at\n ? { by: created.by, at: created.at }\n : null\n}\n\nexport interface VaultVisibilityFence {\n schema: 'vault-visibility-fence-v1'\n path: string\n revision: string\n contentHash: string | null\n deleted: boolean\n operationId: string\n headVisible: boolean\n listVisible: boolean\n committedAt: string\n}\n\nexport type VaultHeadReader = (\n workspaceId: string,\n path: string,\n) => Promise<VaultHeadState>\n\nexport interface VaultConvergenceOptions {\n timeoutMs?: number\n now?: () => number\n sleep?: (delayMs: number) => Promise<void>\n}\n\nexport interface VaultSandboxBaselineFile {\n revision: string | null\n contentHash: string | null\n deleted: boolean\n binary?: boolean\n onDiskHash?: string | null\n}\n\nexport interface VaultSandboxProgress {\n operation: 'hydrate'\n cursor?: string\n processedHeadCount: number\n unseenBaselinePaths: string[]\n}\n\n/** What a sandbox's copy of the Vault held when it last agreed with KV. */\nexport interface VaultSandboxBaseline {\n schema: 'vault-sandbox-baseline-v2' | 'vault-sandbox-baseline-v3'\n workspaceId: string\n sandboxId: string\n /**\n * Control-plane filesystem identity that authorized this baseline. Required\n * by v3; absent only on legacy v2 records during rollout.\n */\n filesystemIncarnationId?: string\n /** Absent on retained baselines whose mirror is the legacy native cwd. */\n mirrorRoot?: string\n files: Record<string, VaultSandboxBaselineFile>\n progress?: VaultSandboxProgress\n updatedAt: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n\nexport function parseVaultHeadMetadata(value: unknown): VaultHeadMetadata | null {\n if (!isRecord(value) || value.schema !== VAULT_HEAD_SCHEMA) return null\n if (typeof value.revision !== 'string' || !value.revision) return null\n if (typeof value.deleted !== 'boolean') return null\n if (value.contentHash !== null && typeof value.contentHash !== 'string') return null\n if (typeof value.operationId !== 'string' || typeof value.updatedAt !== 'string') return null\n if (!isRecord(value.writer) || !['frontend', 'sandbox', 'system'].includes(String(value.writer.kind))) return null\n return value as unknown as VaultHeadMetadata\n}\n\nexport function vaultHeadMatchesFence(\n state: Pick<VaultHeadState, 'revision' | 'contentHash' | 'deleted' | 'metadata'>,\n fence: VaultVisibilityFence,\n): boolean {\n return state.revision === fence.revision\n && state.contentHash === fence.contentHash\n && state.deleted === fence.deleted\n && state.metadata?.operationId === fence.operationId\n}\n\n/** Read the head until it exposes the fenced revision, or throw `VaultReadConvergenceError`. */\nexport async function readVaultHeadStateConverged(\n kv: KVStore,\n workspaceId: string,\n path: string,\n fence: VaultVisibilityFence,\n options: VaultConvergenceOptions = {},\n): Promise<VaultHeadState> {\n const timeoutMs = options.timeoutMs ?? VAULT_READ_CONVERGENCE_TIMEOUT_MS\n const now = options.now ?? Date.now\n const sleep = options.sleep ?? ((delayMs: number) => new Promise((resolve) => setTimeout(resolve, delayMs)))\n const startedAt = now()\n let delayMs = VAULT_READ_CONVERGENCE_INITIAL_DELAY_MS\n\n while (true) {\n const state = await readVaultHeadState(kv, workspaceId, path)\n if (vaultHeadMatchesFence(state, fence)) return state\n\n const elapsedMs = now() - startedAt\n if (elapsedMs >= timeoutMs) {\n throw new VaultReadConvergenceError({\n message: `Vault head for ${path} did not expose fenced revision ${fence.revision} within ${timeoutMs}ms`,\n workspaceId,\n path,\n expectedRevision: fence.revision,\n })\n }\n const remainingMs = timeoutMs - elapsedMs\n await sleep(Math.min(delayMs, remainingMs))\n delayMs = Math.min(delayMs * 2, VAULT_READ_CONVERGENCE_MAX_DELAY_MS)\n }\n}\n\n/**\n * Workspace erasure runs with writers closed. A visible committed descendant\n * can supersede its fence, but only after its immutable lineage proves that\n * fence was included. Ordinary Vault reads keep exact-fence convergence.\n */\nexport async function readVaultHeadStateForErasure(\n kv: KVStore,\n workspaceId: string,\n path: string,\n fence: VaultVisibilityFence,\n options: VaultConvergenceOptions = {},\n): Promise<VaultHeadState> {\n const head = await readVaultHeadState(kv, workspaceId, path)\n if (vaultHeadMatchesFence(head, fence)) return head\n let revision = head.metadata?.revision === head.revision && fence.path === path ? head.revision : null\n for (let read = 0; revision && read < VAULT_LINEAGE_MAX_REVISIONS; read++) {\n const record = await kv.getWithMetadata(vaultRevisionKey(workspaceId, revision, path))\n const metadata = record.metadata as VaultRevisionMetadata | null\n if (record.value === null || metadata?.schema !== VAULT_REVISION_SCHEMA\n || metadata.workspaceId !== workspaceId || metadata.path !== path || metadata.revision !== revision\n || metadata.outcome !== 'committed'\n || (metadata.parentRevision !== null && typeof metadata.parentRevision !== 'string')) break\n if (metadata.batchOperation && !await vaultOperationCommitted(kv, workspaceId, metadata.operationId, path)) break\n if (read === 0 && (metadata.contentHash !== head.contentHash || metadata.deleted !== head.deleted\n || metadata.operationId !== head.metadata?.operationId)) break\n if (revision === fence.revision) {\n if (metadata.contentHash !== fence.contentHash || metadata.deleted !== fence.deleted\n || metadata.operationId !== fence.operationId) break\n // A writer outside the closed coordinator must not race the proven head.\n const current = await readVaultHeadState(kv, workspaceId, path)\n if (current.revision !== head.revision || current.contentHash !== head.contentHash\n || current.deleted !== head.deleted || current.metadata?.operationId !== head.metadata?.operationId) break\n return head\n }\n revision = metadata.parentRevision\n }\n // A missing, unrelated or newer fence still requires its exact committed head.\n return readVaultHeadStateConverged(kv, workspaceId, path, fence, options)\n}\n\nexport async function vaultOperationCommitted(kv: KVStore, workspaceId: string, operationId: string, path?: string): Promise<boolean> {\n const operation = await kv.get(vaultOperationKey(workspaceId, operationId, path))\n const state = operation ? JSON.parse(operation) as Partial<VaultOperationState> : null\n return state?.schema === VAULT_OPERATION_SCHEMA && state.status === 'committed'\n}\n\n/**\n * The head of `path` as readers must see it. A head written by a batch that\n * has not committed answers with its parent revision; a legacy value with no\n * metadata answers with a revision derived from its content.\n */\nexport async function readVaultHeadState(\n kv: KVStore,\n workspaceId: string,\n path: string,\n): Promise<VaultHeadState> {\n const result = await kv.getWithMetadata(vaultHeadKey(workspaceId, path))\n const metadata = parseVaultHeadMetadata(result.metadata)\n if (metadata) {\n if (metadata.batchOperation) {\n if (!await vaultOperationCommitted(kv, workspaceId, metadata.operationId, path)) {\n const revision = await kv.getWithMetadata(vaultRevisionKey(workspaceId, metadata.revision, path))\n const revisionMetadata = revision.metadata as VaultRevisionMetadata | null\n const parentRevision = revisionMetadata?.parentRevision ?? null\n if (!parentRevision) {\n return { revision: null, contentHash: null, deleted: true, content: null, metadata: null }\n }\n const parent = await kv.getWithMetadata(vaultRevisionKey(workspaceId, parentRevision, path))\n const parentMetadata = parent.metadata as VaultRevisionMetadata | null\n if (!parentMetadata || parentMetadata.schema !== VAULT_REVISION_SCHEMA) {\n throw new Error(`Vault batch parent revision is missing: ${parentRevision}`)\n }\n return {\n revision: parentRevision,\n contentHash: parentMetadata.contentHash,\n deleted: parentMetadata.deleted,\n content: parentMetadata.deleted ? null : parent.value,\n metadata: null,\n sequence: positiveInteger(parentMetadata.sequence) ?? 1,\n }\n }\n }\n return {\n revision: metadata.revision,\n contentHash: metadata.contentHash,\n deleted: metadata.deleted,\n content: metadata.deleted ? null : result.value,\n metadata,\n }\n }\n if (result.value === null) {\n return { revision: null, contentHash: null, deleted: true, content: null, metadata: null }\n }\n const contentHash = await sha256Hex(result.value)\n const legacyRevision = await sha256Hex(`${path}\\0${contentHash}`)\n return {\n revision: `legacy-${legacyRevision}`,\n contentHash,\n deleted: false,\n content: result.value,\n metadata: null,\n }\n}\n\nasync function revisionIdFor(\n request: VaultMutationRequest,\n change: VaultMutationChange,\n contentHash: string | null,\n): Promise<string> {\n return sha256Hex([\n request.workspaceId,\n request.operationId,\n change.kind,\n change.path,\n change.expectedRevision ?? 'absent',\n contentHash ?? 'deleted',\n ].join('\\0'))\n}\n\nasync function ensureRevisionRecord(\n kv: KVStore,\n metadata: VaultRevisionMetadata,\n content: string,\n): Promise<void> {\n const key = vaultRevisionKey(metadata.workspaceId, metadata.revision, metadata.path)\n const existing = await kv.getWithMetadata(key)\n if (existing.value !== null) return\n await kv.put(key, content, { metadata })\n}\n\ninterface PreparedChange {\n change: VaultMutationChange\n current: VaultHeadState\n content: string\n contentHash: string | null\n revision: string\n sequence: number\n alreadyApplied: boolean\n}\n\n/**\n * Apply a batch of path changes against their expected revisions. Any stale\n * expectation turns the whole batch into a conflict (each blocked change is\n * kept as a conflict revision); otherwise every change commits, a multi-path\n * batch behind an operation record. Replaying an applied operation is a no-op.\n */\nexport async function applyVaultMutationBatch(\n kv: KVStore,\n request: VaultMutationRequest,\n readHead: VaultHeadReader = (workspaceId, path) => readVaultHeadState(kv, workspaceId, path),\n policy: VaultMutationPolicy = {},\n): Promise<VaultMutationResult> {\n if (policy.normalizeWriter) request = { ...request, writer: policy.normalizeWriter(request.writer) }\n if (!request.operationId) throw new Error('Vault mutation operationId is required')\n if (request.changes.length === 0) return { status: 'applied', files: [] }\n validateVaultMutationKeys(request)\n if (new Set(request.changes.map((change) => change.path)).size !== request.changes.length) {\n throw new Error('Vault mutation contains duplicate paths')\n }\n\n const prepared = await Promise.all(request.changes.map(async (change): Promise<PreparedChange> => {\n if (change.kind === 'put' && typeof change.content !== 'string') {\n throw new Error(`Vault put requires content: ${change.path}`)\n }\n const content = change.kind === 'put' ? change.content as string : ''\n const contentHash = change.kind === 'put' ? await sha256Hex(content) : null\n const current = await readHead(request.workspaceId, change.path)\n const alreadyApplied = current.metadata?.operationId === request.operationId\n && current.deleted === (change.kind === 'delete')\n && current.contentHash === contentHash\n return {\n change,\n current,\n content,\n contentHash,\n revision: alreadyApplied && current.revision\n ? current.revision\n : await revisionIdFor(request, change, contentHash),\n sequence: vaultHeadSequence(current) + (alreadyApplied ? 0 : 1),\n alreadyApplied,\n }\n }))\n validateVaultMutationKeys({\n ...request,\n changes: prepared.map(({ change, revision }) => ({ path: change.path, revision })),\n })\n\n const conflicting = prepared.filter(({ change, current, alreadyApplied }) => (\n !alreadyApplied && current.revision !== change.expectedRevision\n ))\n if (conflicting.length > 0) {\n const createdAt = new Date().toISOString()\n const blocked = prepared.filter(({ alreadyApplied }) => !alreadyApplied)\n await Promise.all(blocked.map(async ({ change, content, contentHash, revision }) => {\n await ensureRevisionRecord(kv, {\n schema: VAULT_REVISION_SCHEMA,\n workspaceId: request.workspaceId,\n path: change.path,\n revision,\n parentRevision: change.expectedRevision,\n contentHash,\n deleted: change.kind === 'delete',\n operationId: request.operationId,\n createdAt,\n writer: request.writer,\n outcome: 'conflict',\n }, content)\n }))\n return {\n status: 'conflict',\n conflicts: blocked.map(({ change, current, revision }) => ({\n path: change.path,\n expectedRevision: change.expectedRevision,\n currentRevision: current.revision,\n conflictRevision: revision,\n })),\n }\n }\n\n const updatedAt = new Date().toISOString()\n const isBatch = prepared.length > 1 && prepared.some(({ alreadyApplied }) => !alreadyApplied)\n if (isBatch) {\n const operation: VaultOperationState = { schema: VAULT_OPERATION_SCHEMA, status: 'preparing' }\n await kv.put(vaultOperationKey(request.workspaceId, request.operationId), JSON.stringify(operation))\n }\n for (const item of prepared) {\n const { change, current, content, contentHash, revision, sequence, alreadyApplied } = item\n if (alreadyApplied) continue\n\n if (current.metadata === null && current.content !== null && current.revision && current.contentHash) {\n const legacyWriter: VaultWriter = { kind: 'system', id: 'legacy-import' }\n await ensureRevisionRecord(kv, {\n schema: VAULT_REVISION_SCHEMA,\n workspaceId: request.workspaceId,\n path: change.path,\n revision: current.revision,\n parentRevision: null,\n contentHash: current.contentHash,\n deleted: false,\n operationId: `legacy:${current.revision}`,\n createdAt: updatedAt,\n writer: policy.normalizeWriter?.(legacyWriter) ?? legacyWriter,\n outcome: 'committed',\n }, current.content)\n }\n\n const revisionMetadata: VaultRevisionMetadata = {\n schema: VAULT_REVISION_SCHEMA,\n contentBytes: new TextEncoder().encode(content).byteLength,\n workspaceId: request.workspaceId,\n path: change.path,\n revision,\n parentRevision: current.revision,\n contentHash,\n deleted: change.kind === 'delete',\n operationId: request.operationId,\n createdAt: updatedAt,\n writer: request.writer,\n outcome: 'committed',\n batchOperation: isBatch || undefined,\n sequence,\n storeFormat: change.storeFormat,\n }\n await ensureRevisionRecord(kv, revisionMetadata, content)\n // A put over a live entry keeps its creator; one over nothing starts a new entry.\n const live = !current.deleted && current.revision !== null\n const created = change.kind === 'delete' || live\n ? vaultHeadCreation(current.metadata) ?? undefined\n : { by: vaultWriterActor(request.writer), at: updatedAt }\n const headMetadata: VaultHeadMetadata = {\n schema: VAULT_HEAD_SCHEMA,\n revision,\n contentHash,\n deleted: change.kind === 'delete',\n operationId: request.operationId,\n updatedAt,\n writer: request.writer,\n batchOperation: isBatch || undefined,\n sequence,\n created,\n storeFormat: change.storeFormat,\n }\n await kv.put(vaultHeadKey(request.workspaceId, change.path), content, { metadata: headMetadata })\n }\n\n if (isBatch) {\n const operation: VaultOperationState = { schema: VAULT_OPERATION_SCHEMA, status: 'committed' }\n await kv.put(vaultOperationKey(request.workspaceId, request.operationId), JSON.stringify(operation))\n }\n\n return {\n status: 'applied',\n files: prepared.map(({ change, current, contentHash, revision, sequence, alreadyApplied }) => ({\n path: change.path,\n revision,\n contentHash,\n deleted: change.kind === 'delete',\n sequence,\n updatedAt: alreadyApplied ? current.metadata?.updatedAt : updatedAt,\n })),\n }\n}\n","import { isWorkspaceFileExportable } from '../../web/file-export'\n\n/** One node of the Vault file tree the store lists. */\nexport interface VaultNode {\n name: string\n path: string\n type: 'file' | 'directory'\n children?: VaultNode[]\n}\n\n/** Nest flat file paths into a tree: directories first, then names in locale order. */\nexport function buildTreeFromPaths(paths: string[]): VaultNode[] {\n interface TreeMap { [key: string]: { node: VaultNode; children: TreeMap } }\n const tree: TreeMap = {}\n for (const path of paths) {\n if (!isWorkspaceFileExportable(path)) continue\n const parts = path.split('/')\n let current = tree\n parts.forEach((name, i) => {\n const isFile = i === parts.length - 1\n const entry = current[name] ??= {\n node: { name, path: parts.slice(0, i + 1).join('/'), type: isFile ? 'file' : 'directory' },\n children: {},\n }\n if (isFile) entry.node.type = 'file'\n current = entry.children\n })\n }\n function toNodes(map: TreeMap): VaultNode[] {\n return Object.values(map)\n .map(({ node, children }) => {\n const childNodes = toNodes(children)\n if (childNodes.length > 0 || node.type === 'directory') {\n return { ...node, type: 'directory' as const, children: childNodes }\n }\n return node\n })\n .sort((a, b) => {\n if (a.type !== b.type) return a.type === 'directory' ? -1 : 1\n return a.name.localeCompare(b.name)\n })\n }\n return toNodes(tree)\n}\n\n/** Flatten a `VaultNode` tree back to its file paths, dropping directories. */\nexport function flattenVaultTreePaths(nodes: VaultNode[]): string[] {\n return nodes.flatMap((node) => {\n if (node.type === 'file') return [node.path]\n return node.children ? flattenVaultTreePaths(node.children) : []\n })\n}\n","/**\n * The Vault file store: reads, writes, listings and revision history over a\n * KV namespace, with every mutation and head read routed through the\n * workspace's coordinator Durable Object when one is bound (see\n * `./coordinator`). Without a coordinator (local runs, evals) mutations are\n * serialized per workspace in-process and reads go straight to KV.\n *\n * A product creates one store with `createVaultStore`, binds its KV and\n * coordinator per request, and supplies its frontmatter codec and the few\n * product rules that surround a write (writer provenance, side records a\n * delete must remove, a local write closure).\n */\nimport { sha256Hex } from '../../crypto/digest'\nimport type { KVStore } from '../../store'\nimport { isWorkspaceFileExportable } from '../../web/file-export'\nimport {\n parseVaultPathErrorResponse,\n VaultPathError,\n validateVaultFilePath,\n validateWorkspaceId,\n isHiddenVaultFilePath,\n vaultHeadPathPrefix,\n vaultHeadPrefix,\n vaultMetaKey,\n vaultRevisionKey,\n vaultRevisionPrefix,\n} from './paths'\nimport {\n applyVaultMutationBatch,\n parseVaultHeadMetadata,\n readVaultHeadState,\n vaultOperationCommitted,\n VaultReadConvergenceError,\n VAULT_LINEAGE_MAX_REVISIONS,\n VAULT_REVISION_SCHEMA,\n type VaultHeadState,\n type VaultMutationPolicy,\n type VaultMutationRequest,\n type VaultMutationResult,\n type VaultRevisionMetadata,\n type VaultWriter,\n} from './revisions'\nimport { buildTreeFromPaths, type VaultNode } from './tree'\n\n/** The Durable Object namespace surface the store calls; Cloudflare's binding satisfies it. */\nexport interface VaultCoordinatorNamespace {\n idFromName(name: string): unknown\n get(id: any): { fetch(input: string, init?: RequestInit): Promise<Response> }\n}\n\n/** A coordinator's structured error, as its JSON body carries it. */\nexport interface VaultCoordinatorErrorDetail {\n code?: string\n message?: string\n retryable?: boolean\n workspaceId?: string\n path?: string\n expectedRevision?: string\n}\n\nexport class VaultFileNotFoundError extends VaultPathError {\n override readonly code = 'vault.file_not_found'\n\n constructor(filePath: string) {\n super(`File not found: ${filePath}`, filePath)\n this.name = 'VaultFileNotFoundError'\n }\n}\n\nexport class VaultConflictError extends Error {\n readonly code = 'vault.conflict'\n readonly conflicts: Extract<VaultMutationResult, { status: 'conflict' }>['conflicts']\n\n constructor(result: Extract<VaultMutationResult, { status: 'conflict' }>) {\n super(`Vault conflict: ${result.conflicts.map((conflict) => conflict.path).join(', ')}`)\n this.name = 'VaultConflictError'\n this.conflicts = result.conflicts\n }\n}\n\n/** Frontmatter parse result: a parse failure keeps the raw text and its error. */\nexport type VaultFrontmatterParse =\n | { succeeded: true; frontmatter: Record<string, unknown>; body: string }\n | { succeeded: false; raw: string; error: { code: string; message: string } }\n\n/** How a product stores frontmatter and body in one Vault file. */\nexport interface VaultFrontmatterCodec {\n parse(raw: string): VaultFrontmatterParse\n serialize(frontmatter: Record<string, unknown>, body: string): string\n}\n\n/** A text file as the store reads or wrote it. */\nexport interface VaultStoredFile {\n path: string\n content: string\n frontmatter: Record<string, unknown>\n body: string\n parseError?: { code: string; message: string }\n /** The `mime` frontmatter field, when the file records one. */\n mimeType?: string\n revision: string\n contentHash: string\n}\n\nexport interface VaultMutationOptions {\n expectedRevision?: string | null\n operationId?: string\n writer?: VaultWriter\n}\n\nexport interface VaultHeadListEntry {\n path: string\n revision: string | null\n contentHash: string | null\n deleted: boolean\n}\n\nexport interface VaultHeadListPage {\n entries: VaultHeadListEntry[]\n complete: boolean\n cursor: string | null\n}\n\n/** Saved versions of one file a history listing returns at most. */\nexport const VAULT_HISTORY_MAX_REVISIONS = 20\n\n/** Revision ids are hex digests; anything else cannot name a record. */\nconst VAULT_REVISION_ID = /^[A-Za-z0-9_-]{1,128}$/\n\nconst HIDDEN_VAULT_PURGE_MARKER = 'hidden-path-purge-v1'\n\n/** One committed version of a file, as the Vault History lists it. */\nexport interface VaultFileRevision {\n revision: string\n createdAt: string\n writer: VaultWriter\n /** True for the version the head holds now. */\n current: boolean\n}\n\nexport interface VaultRevisionsPage {\n revisions: VaultRevisionMetadata[]\n complete: boolean\n /** False when a listed key carried no readable metadata or an uncommitted batch. */\n metadataComplete: boolean\n cursor: string | null\n}\n\nexport interface VaultStoreConfig {\n /** How a file's frontmatter and body are stored. */\n codec: VaultFrontmatterCodec\n /** Headers for each coordinator request (JSON content type plus any channel auth). */\n coordinatorHeaders?: (workspaceId: string) => Promise<Record<string, string>>\n /** A product error a coordinator response carries, typed; null when it is not one. */\n decodeCoordinatorError?: (detail: VaultCoordinatorErrorDetail, fallback: string) => Error | null\n /** Writer rules every mutation applies; the coordinator must apply the same ones. */\n mutationPolicy?: VaultMutationPolicy\n /** Runs inside the local mutation queue before a write without a coordinator; throw to refuse it. */\n beforeLocalMutation?: (kv: KVStore, request: VaultMutationRequest) => Promise<void>\n /** Runs before a file delete commits, for product records tied to the path. */\n beforeDelete?: (workspaceId: string, filePath: string) => Promise<void>\n}\n\n/** The store's head-list query: a page of heads, optionally under a path prefix. */\nexport interface VaultHeadListOptions {\n cursor?: string\n limit?: number\n prefix?: string\n}\n\nfunction revisionRecordFor(\n metadata: unknown,\n workspaceId: string,\n path: string,\n): VaultRevisionMetadata | null {\n const record = metadata as VaultRevisionMetadata | null\n if (!record || record.schema !== VAULT_REVISION_SCHEMA) return null\n if (record.workspaceId !== workspaceId || record.path !== path) return null\n return record\n}\n\n/** KV and coordinator binding: where each mutation and head read goes. */\nfunction createVaultRuntime<Namespace extends VaultCoordinatorNamespace>(config: VaultStoreConfig) {\n // `kv` is the portable KV port: Cloudflare's KVNamespace satisfies it, so\n // production passes the binding unchanged and local runs pass an in-memory KV.\n let kv: KVStore | null = null\n let coordinator: Namespace | null = null\n const localMutationQueues = new Map<string, Promise<void>>()\n\n function setVaultKV(next: KVStore): void { kv = next }\n function setVaultCoordinator(next: Namespace | null): void { coordinator = next }\n function getVaultCoordinator(): Namespace | null { return coordinator }\n function getVaultKV(): KVStore {\n if (!kv) throw new Error('VAULT_KV not initialized. Call setVaultKV() first.')\n return kv\n }\n\n /** POST `body` to a route of the workspace's Vault coordinator Durable Object. */\n async function postVaultCoordinator(\n namespace: Namespace,\n workspaceId: string,\n route: string,\n body: unknown,\n ): Promise<Response> {\n const headers = config.coordinatorHeaders\n ? await config.coordinatorHeaders(workspaceId)\n : { 'Content-Type': 'application/json' }\n return namespace.get(namespace.idFromName(workspaceId)).fetch(`https://session-stream.internal/vault/${route}`, {\n method: 'POST',\n headers,\n body: JSON.stringify(body),\n })\n }\n\n async function throwVaultCoordinatorError(response: Response, fallback: string): Promise<never> {\n const detail = await response.json().catch(() => null) as { error?: string | VaultCoordinatorErrorDetail } | null\n const pathError = parseVaultPathErrorResponse(detail)\n if (pathError) throw pathError\n if (typeof detail?.error === 'object') {\n const decoded = config.decodeCoordinatorError?.(detail.error, fallback)\n if (decoded) throw decoded\n if (detail.error.code === 'vault.read_not_converged') {\n throw new VaultReadConvergenceError({\n message: detail.error.message,\n workspaceId: detail.error.workspaceId,\n path: detail.error.path,\n expectedRevision: detail.error.expectedRevision,\n })\n }\n }\n const message = typeof detail?.error === 'string' ? detail.error : detail?.error?.message\n throw new Error(`${fallback} (${response.status})${message ? `: ${message}` : ''}`)\n }\n\n /** Serialize Vault writes (and product steps that must not interleave with them) per workspace when no coordinator is bound. */\n function enqueueLocalVaultMutation<T>(workspaceId: string, run: () => Promise<T>): Promise<T> {\n const previous = localMutationQueues.get(workspaceId) ?? Promise.resolve()\n const next = previous.catch(() => undefined).then(run)\n localMutationQueues.set(workspaceId, next.then(() => undefined, () => undefined))\n return next\n }\n\n async function commitVaultMutation(request: VaultMutationRequest): Promise<VaultMutationResult> {\n validateWorkspaceId(request.workspaceId)\n for (const change of request.changes) validateVaultFilePath(change.path)\n const namespace = coordinator\n if (!namespace) {\n return enqueueLocalVaultMutation(request.workspaceId, async () => {\n await config.beforeLocalMutation?.(getVaultKV(), request)\n return applyVaultMutationBatch(getVaultKV(), request, undefined, config.mutationPolicy)\n })\n }\n const response = await postVaultCoordinator(namespace, request.workspaceId, 'mutate', request)\n if (response.status !== 200 && response.status !== 409) {\n await throwVaultCoordinatorError(response, 'Vault mutation coordinator failed')\n }\n return response.json() as Promise<VaultMutationResult>\n }\n\n async function readVaultFileState(workspaceId: string, filePath: string): Promise<VaultHeadState> {\n validateVaultFilePath(filePath)\n validateWorkspaceId(workspaceId)\n const namespace = coordinator\n if (!namespace) return readVaultHeadState(getVaultKV(), workspaceId, filePath)\n const response = await postVaultCoordinator(namespace, workspaceId, 'head/get', { workspaceId, path: filePath })\n if (!response.ok) await throwVaultCoordinatorError(response, 'Vault head read failed')\n const body = await response.json() as { state: VaultHeadState }\n return body.state\n }\n\n return {\n setVaultKV, getVaultKV, setVaultCoordinator, getVaultCoordinator, postVaultCoordinator,\n throwVaultCoordinatorError, enqueueLocalVaultMutation, commitVaultMutation, readVaultFileState,\n }\n}\n\ntype VaultRuntime<Namespace extends VaultCoordinatorNamespace> = ReturnType<typeof createVaultRuntime<Namespace>>\n\n/** File reads, writes, deletes and listings over the runtime. */\nfunction createVaultFiles<Namespace extends VaultCoordinatorNamespace>(runtime: VaultRuntime<Namespace>, config: VaultStoreConfig) {\n const { getVaultKV, getVaultCoordinator, postVaultCoordinator, throwVaultCoordinatorError, commitVaultMutation, readVaultFileState } = runtime\n\n async function expectedRevisionFor(\n workspaceId: string,\n filePath: string,\n options?: VaultMutationOptions,\n ): Promise<string | null> {\n if (options && Object.prototype.hasOwnProperty.call(options, 'expectedRevision')) {\n return options.expectedRevision ?? null\n }\n return (await readVaultFileState(workspaceId, filePath)).revision\n }\n\n async function commitSingleVaultMutation(\n workspaceId: string,\n change: { path: string; kind: 'put' | 'delete'; content?: string },\n options?: VaultMutationOptions,\n ): Promise<Extract<VaultMutationResult, { status: 'applied' }>['files'][number]> {\n const result = await commitVaultMutation({\n workspaceId,\n operationId: options?.operationId ?? crypto.randomUUID(),\n writer: options?.writer ?? { kind: 'system' },\n changes: [{\n ...change,\n expectedRevision: await expectedRevisionFor(workspaceId, change.path, options),\n }],\n })\n if (result.status === 'conflict') throw new VaultConflictError(result)\n const file = result.files[0]\n if (!file) throw new Error(`Vault mutation returned no result for ${change.path}`)\n return file\n }\n\n function storedFile(filePath: string, content: string, revision: string, contentHash: string): VaultStoredFile {\n const parsed = config.codec.parse(content)\n const mimeType = parsed.succeeded && typeof parsed.frontmatter.mime === 'string' ? parsed.frontmatter.mime : undefined\n return {\n path: filePath,\n content,\n frontmatter: parsed.succeeded ? parsed.frontmatter : {},\n body: parsed.succeeded ? parsed.body : parsed.raw,\n parseError: parsed.succeeded ? undefined : parsed.error,\n mimeType,\n revision,\n contentHash,\n }\n }\n\n function getVaultRoot(workspaceId: string): string {\n validateWorkspaceId(workspaceId)\n return vaultHeadPrefix(workspaceId).slice(0, -1)\n }\n\n async function writeVaultFile(\n workspaceId: string,\n filePath: string,\n content: { frontmatter: Record<string, unknown>; body: string },\n options?: VaultMutationOptions,\n ): Promise<VaultStoredFile> {\n validateVaultFilePath(filePath)\n validateWorkspaceId(workspaceId)\n const fileContent = config.codec.serialize(content.frontmatter, content.body)\n const result = await commitSingleVaultMutation(workspaceId, { path: filePath, kind: 'put', content: fileContent }, options)\n if (!result.contentHash) throw new Error(`Vault put returned no content hash for ${filePath}`)\n return {\n path: filePath,\n content: fileContent,\n frontmatter: content.frontmatter,\n body: content.body,\n revision: result.revision,\n contentHash: result.contentHash,\n }\n }\n\n async function writeVaultRawFile(\n workspaceId: string,\n filePath: string,\n content: string,\n options?: VaultMutationOptions,\n ): Promise<VaultStoredFile> {\n validateVaultFilePath(filePath)\n validateWorkspaceId(workspaceId)\n const result = await commitSingleVaultMutation(workspaceId, { path: filePath, kind: 'put', content }, options)\n if (!result.contentHash) throw new Error(`Vault put returned no content hash for ${filePath}`)\n const { mimeType: _mimeType, ...file } = storedFile(filePath, content, result.revision, result.contentHash)\n return file\n }\n\n async function readVaultFile(workspaceId: string, filePath: string): Promise<VaultStoredFile> {\n validateVaultFilePath(filePath)\n validateWorkspaceId(workspaceId)\n const state = await readVaultFileState(workspaceId, filePath)\n if (state.deleted || state.content === null || !state.revision || !state.contentHash) {\n throw new VaultFileNotFoundError(filePath)\n }\n return storedFile(filePath, state.content, state.revision, state.contentHash)\n }\n\n async function deleteVaultFile(workspaceId: string, filePath: string, options?: VaultMutationOptions): Promise<void> {\n validateVaultFilePath(filePath)\n validateWorkspaceId(workspaceId)\n await config.beforeDelete?.(workspaceId, filePath)\n await commitSingleVaultMutation(workspaceId, { path: filePath, kind: 'delete' }, options)\n }\n\n async function listVaultHeadPage(workspaceId: string, options: VaultHeadListOptions = {}): Promise<VaultHeadListPage> {\n validateWorkspaceId(workspaceId)\n const pathPrefix = options.prefix ?? ''\n const namespace = getVaultCoordinator()\n if (namespace) {\n const response = await postVaultCoordinator(namespace, workspaceId, 'head/list', { workspaceId, ...options })\n if (!response.ok) await throwVaultCoordinatorError(response, 'Vault head listing failed')\n const page = await response.json() as VaultHeadListPage\n // A coordinator from before prefix listing returns every head; filter here too.\n return {\n ...page,\n entries: page.entries.filter((entry) => isWorkspaceFileExportable(entry.path) && entry.path.startsWith(pathPrefix)),\n }\n }\n const prefix = vaultHeadPrefix(workspaceId)\n const list = await getVaultKV().list({\n prefix: vaultHeadPathPrefix(workspaceId, pathPrefix),\n cursor: options.cursor,\n ...(options.limit === undefined ? {} : { limit: options.limit }),\n })\n if (!list.list_complete && !list.cursor) {\n throw new Error(`Vault KV listing did not provide a cursor for ${workspaceId}`)\n }\n const entries = (await Promise.all(list.keys.map(async (key) => {\n const path = key.name.slice(prefix.length)\n if (!isWorkspaceFileExportable(path)) return null\n validateVaultFilePath(path)\n const metadata = parseVaultHeadMetadata((key as { metadata?: unknown }).metadata)\n if (metadata && !metadata.batchOperation) {\n return { path, revision: metadata.revision, contentHash: metadata.contentHash, deleted: metadata.deleted }\n }\n const state = await readVaultHeadState(getVaultKV(), workspaceId, path)\n return { path, revision: state.revision, contentHash: state.contentHash, deleted: state.deleted }\n }))).filter((entry): entry is VaultHeadListEntry => entry !== null)\n return {\n entries,\n complete: list.list_complete,\n cursor: list.list_complete ? null : list.cursor as string,\n }\n }\n\n /** Every visible Vault file path in the workspace, flat and unordered. */\n async function listVaultFilePaths(workspaceId: string): Promise<string[]> {\n validateWorkspaceId(workspaceId)\n const paths: string[] = []\n let cursor: string | undefined\n do {\n const page = await listVaultHeadPage(workspaceId, { cursor })\n paths.push(...page.entries.filter((entry) => !entry.deleted).map((entry) => entry.path))\n cursor = page.cursor ?? undefined\n } while (cursor)\n return paths\n }\n\n async function listVaultTree(workspaceId: string): Promise<VaultNode[]> {\n return buildTreeFromPaths(await listVaultFilePaths(workspaceId))\n }\n\n return {\n getVaultRoot, writeVaultFile, writeVaultRawFile, readVaultFile, deleteVaultFile,\n listVaultHeadPage, listVaultFilePaths, listVaultTree,\n }\n}\n\n/** Revision lineage reads and KV maintenance (conflict records, hidden paths). */\nfunction createVaultHistory<Namespace extends VaultCoordinatorNamespace>(runtime: VaultRuntime<Namespace>) {\n const { getVaultKV, readVaultFileState } = runtime\n\n /**\n * The committed revision of `path`, at `headRevision` or earlier in its\n * lineage, whose content hash is `contentHash`; null when none is found.\n *\n * Revision records are immutable, so the walk follows `parentRevision` links\n * and stops at a record it cannot read rather than guessing past it.\n */\n async function findVaultRevisionWithContent(\n workspaceId: string,\n path: string,\n headRevision: string,\n contentHash: string,\n options: { matchesContent?: (content: string) => Promise<boolean> } = {},\n ): Promise<string | null> {\n validateVaultFilePath(path)\n validateWorkspaceId(workspaceId)\n const store = getVaultKV()\n let revision: string | null = headRevision\n for (let read = 0; revision && read < VAULT_LINEAGE_MAX_REVISIONS; read++) {\n const record = await store.getWithMetadata(vaultRevisionKey(workspaceId, revision, path))\n const metadata = record.metadata as VaultRevisionMetadata | null\n if (!metadata || metadata.schema !== VAULT_REVISION_SCHEMA || metadata.path !== path) return null\n if (metadata.outcome === 'committed' && !metadata.deleted) {\n if (!options.matchesContent && metadata.contentHash === contentHash) return revision\n if (options.matchesContent && typeof record.value === 'string'\n && await sha256Hex(record.value) === metadata.contentHash && await options.matchesContent(record.value)) return revision\n }\n revision = metadata.parentRevision\n }\n return null\n }\n\n /**\n * The committed versions of `path`, newest first, read by following\n * `parentRevision` links back from the head. Deletions in the lineage are\n * skipped, so a path deleted and written again still lists what it held\n * before. Every committed write keeps its full text in its revision record,\n * so each listed version can be read back with `readVaultFileRevision`.\n */\n async function listVaultFileRevisions(\n workspaceId: string,\n path: string,\n limit = VAULT_HISTORY_MAX_REVISIONS,\n ): Promise<VaultFileRevision[]> {\n validateVaultFilePath(path)\n validateWorkspaceId(workspaceId)\n const head = await readVaultFileState(workspaceId, path)\n if (head.deleted || !head.revision) return []\n const store = getVaultKV()\n const versions: VaultFileRevision[] = []\n let revision: string | null = head.revision\n for (let read = 0; revision && versions.length < limit && read < VAULT_LINEAGE_MAX_REVISIONS; read++) {\n const record = await store.getWithMetadata(vaultRevisionKey(workspaceId, revision, path))\n const metadata = revisionRecordFor(record.metadata, workspaceId, path)\n if (!metadata) {\n // A head written moments ago can be visible before its revision record;\n // it is still the current version, and its lineage appears once KV catches up.\n if (read === 0 && head.metadata) {\n versions.push({ revision, createdAt: head.metadata.updatedAt, writer: head.metadata.writer, current: true })\n }\n break\n }\n if (metadata.outcome === 'committed' && !metadata.deleted) {\n versions.push({ revision, createdAt: metadata.createdAt, writer: metadata.writer, current: read === 0 })\n }\n revision = metadata.parentRevision\n }\n return versions\n }\n\n /**\n * Bounded metadata-only page over committed writes whose path `includePath`\n * accepts, superseded revisions included. Batch writes count only once their\n * operation committed.\n */\n async function listCommittedVaultRevisionsPage(\n workspaceId: string,\n options: { cursor?: string; limit?: number; includePath: (path: string) => boolean },\n ): Promise<VaultRevisionsPage> {\n validateWorkspaceId(workspaceId)\n const store = getVaultKV()\n const page = await store.list({ prefix: vaultRevisionPrefix(workspaceId), limit: options.limit ?? 1000, cursor: options.cursor })\n if (!page.list_complete && !page.cursor) throw new Error('Vault revision listing did not provide a cursor')\n let metadataComplete = true\n const candidates = page.keys.flatMap((key) => {\n const record = (key as { metadata?: unknown }).metadata as VaultRevisionMetadata | null\n if (!record || record.schema !== VAULT_REVISION_SCHEMA) metadataComplete = false\n return record?.schema === VAULT_REVISION_SCHEMA && record.workspaceId === workspaceId\n && record.outcome === 'committed' && !record.deleted && options.includePath(record.path) ? [record] : []\n })\n const operations = new Map<string, Promise<boolean>>()\n const committed = await Promise.all(candidates.map(async (record) => {\n if (!record.batchOperation) return record\n let operation = operations.get(record.operationId)\n if (!operation) {\n operation = vaultOperationCommitted(store, workspaceId, record.operationId, record.path)\n operations.set(record.operationId, operation)\n }\n if (await operation) return record\n metadataComplete = false\n return null\n }))\n const revisions = committed.filter((record): record is VaultRevisionMetadata => record !== null)\n return { revisions, complete: page.list_complete, metadataComplete, cursor: page.list_complete ? null : page.cursor ?? null }\n }\n\n /** Exact immutable revision metadata, without loading the artifact body. Missing or partial inventory is not proof. */\n async function readVaultRevisionMetadata(workspaceId: string, path: string, revision: string): Promise<VaultRevisionMetadata | null> {\n validateVaultFilePath(path)\n validateWorkspaceId(workspaceId)\n if (!VAULT_REVISION_ID.test(revision)) return null\n const key = vaultRevisionKey(workspaceId, revision, path)\n const store = getVaultKV()\n const page = await store.list({ prefix: key, limit: 2 })\n const entry = page.keys[0]\n if (!page.list_complete || page.keys.length !== 1 || !entry || entry.name !== key) return null\n const metadata = revisionRecordFor('metadata' in entry ? entry.metadata : undefined, workspaceId, path)\n if (!metadata || metadata.revision !== revision || metadata.outcome !== 'committed' || metadata.deleted\n || !/^[a-f0-9]{64}$/.test(metadata.contentHash ?? '') || !metadata.operationId\n || (metadata.contentBytes !== undefined && (!Number.isSafeInteger(metadata.contentBytes) || metadata.contentBytes < 0))) return null\n if (metadata.batchOperation && !await vaultOperationCommitted(store, workspaceId, metadata.operationId)) return null\n return metadata\n }\n\n /** The full text `path` held at `revision`, or null when that is not a committed version of it. */\n async function readVaultFileRevision(\n workspaceId: string,\n path: string,\n revision: string,\n options: { maxBytes?: number } = {},\n ): Promise<string | null> {\n validateVaultFilePath(path)\n validateWorkspaceId(workspaceId)\n if (!VAULT_REVISION_ID.test(revision)) return null\n const maxBytes = options.maxBytes\n if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) return null\n const proof = maxBytes !== undefined ? await readVaultRevisionMetadata(workspaceId, path, revision) : null\n if (maxBytes !== undefined && (!proof || proof.contentBytes === undefined || proof.contentBytes > maxBytes)) return null\n const record = await getVaultKV().getWithMetadata(vaultRevisionKey(workspaceId, revision, path))\n const metadata = revisionRecordFor(record.metadata, workspaceId, path)\n if (!metadata || metadata.outcome !== 'committed' || metadata.deleted || typeof record.value !== 'string') return null\n if (proof && (metadata.revision !== revision || metadata.contentHash !== proof.contentHash || metadata.contentBytes !== proof.contentBytes\n || new TextEncoder().encode(record.value).byteLength !== proof.contentBytes || await sha256Hex(record.value) !== proof.contentHash)) return null\n return record.value\n }\n\n /**\n * Delete the conflict records a writer received for its own refused changes.\n * The coordinator named each record in its refusal, so the key is known and\n * nothing is read first: a read could miss a record written moments ago.\n */\n async function eraseVaultConflictRecords(\n workspaceId: string,\n conflicts: ReadonlyArray<{ path: string; conflictRevision: string }>,\n ): Promise<void> {\n validateWorkspaceId(workspaceId)\n const store = getVaultKV()\n await Promise.all(conflicts.map(({ path, conflictRevision }) => (\n store.delete(vaultRevisionKey(workspaceId, conflictRevision, path))\n )))\n }\n\n /** Remove heads under hidden paths once per workspace; returns how many were removed. */\n async function purgeHiddenVaultFiles(workspaceId: string): Promise<number> {\n validateWorkspaceId(workspaceId)\n const store = getVaultKV()\n const markerKey = vaultMetaKey(workspaceId, HIDDEN_VAULT_PURGE_MARKER)\n if (await store.get(markerKey)) return 0\n\n const prefix = vaultHeadPrefix(workspaceId)\n let deleted = 0\n let cursor: string | undefined\n do {\n const list = await store.list({ prefix, cursor })\n await Promise.all(list.keys.map(async (key) => {\n const path = key.name.slice(prefix.length)\n if (!isHiddenVaultFilePath(path)) return\n await store.delete(key.name)\n deleted += 1\n }))\n if (list.list_complete) {\n cursor = undefined\n } else if (list.cursor) {\n cursor = list.cursor\n } else {\n throw new Error(`Vault KV listing did not provide a cursor for ${workspaceId}`)\n }\n } while (cursor)\n\n await store.put(markerKey, new Date().toISOString())\n return deleted\n }\n\n return {\n findVaultRevisionWithContent, listVaultFileRevisions, listCommittedVaultRevisionsPage,\n readVaultRevisionMetadata, readVaultFileRevision, eraseVaultConflictRecords, purgeHiddenVaultFiles,\n }\n}\n\n/** Create a Vault store bound per request with `setVaultKV` and `setVaultCoordinator`. */\nexport function createVaultStore<Namespace extends VaultCoordinatorNamespace = VaultCoordinatorNamespace>(\n config: VaultStoreConfig,\n) {\n const runtime = createVaultRuntime<Namespace>(config)\n return { ...runtime, ...createVaultFiles(runtime, config), ...createVaultHistory(runtime) }\n}\n\nexport type VaultStore<Namespace extends VaultCoordinatorNamespace = VaultCoordinatorNamespace> =\n ReturnType<typeof createVaultStore<Namespace>>\n","/**\n * The Vault's single writer, hosted in a workspace's Durable Object. It\n * serializes mutations, answers head reads and listings after every queued\n * mutation, and fences each committed revision until KV shows it.\n *\n * KV point reads and listings lag their own writes independently, so a\n * revision this coordinator just committed can be missing from either. A\n * visibility fence records the committed truth for that window: head reads\n * wait for the fenced revision, and listings report it in place of what KV\n * lists. A fence retires once both surfaces have shown it.\n *\n * The product's Durable Object routes `/vault/mutate`, `/vault/head/get` and\n * `/vault/head/list` to the handlers here and owns every other route.\n */\nimport type { KVStore } from '../../store'\nimport { isWorkspaceFileExportable } from '../../web/file-export'\nimport {\n VaultPathError,\n validateVaultFilePath,\n validateWorkspaceId,\n vaultHeadPathPrefix,\n vaultHeadPrefix,\n vaultPathErrorResponseBody,\n} from './paths'\nimport {\n applyVaultMutationBatch,\n parseVaultHeadMetadata,\n readVaultHeadState,\n readVaultHeadStateConverged,\n vaultHeadMatchesFence,\n VaultReadConvergenceError,\n type VaultHeadState,\n type VaultMutationPolicy,\n type VaultMutationRequest,\n type VaultMutationResult,\n type VaultVisibilityFence,\n} from './revisions'\nimport type { VaultHeadListEntry } from './store'\n\nconst VAULT_FENCE_STORAGE_PREFIX = 'vaultFence:'\n\n/** The Durable Object storage calls the coordinator makes; Cloudflare's storage satisfies it. */\nexport interface VaultCoordinatorStorage {\n get<T>(key: string): Promise<T | undefined>\n put<T>(key: string, value: T): Promise<void>\n delete(key: string): Promise<void | boolean>\n list<T>(options: { prefix: string }): Promise<Map<string, T>>\n}\n\n/** Sizes of one head listing, for products that watch Durable Object memory. */\nexport interface VaultHeadListStats {\n workspaceId: string\n fences: number\n headKeys: number\n entries: number\n paged: boolean\n}\n\nexport interface VaultCoordinatorOptions {\n storage: VaultCoordinatorStorage\n kv: KVStore\n /** Writer rules every mutation applies; the store's local path must apply the same ones. */\n mutationPolicy?: VaultMutationPolicy\n /**\n * Runs each queued mutation. `apply` commits the batch and fences what it\n * applied; throw before calling it to refuse the mutation, or do product work\n * around it. Defaults to calling `apply`.\n */\n aroundMutation?: (request: VaultMutationRequest, apply: () => Promise<VaultMutationResult>) => Promise<VaultMutationResult>\n onHeadList?: (stats: VaultHeadListStats) => void\n}\n\nexport function vaultCoordinatorJson(body: unknown, status = 200): Response {\n return new Response(JSON.stringify(body), {\n status,\n headers: { 'Content-Type': 'application/json' },\n })\n}\n\n/** The 503 body a client turns back into `VaultReadConvergenceError`. */\nexport function vaultConvergenceResponse(error: VaultReadConvergenceError): Response {\n return vaultCoordinatorJson({\n error: {\n code: error.code,\n message: error.message,\n retryable: error.retryable,\n workspaceId: error.workspaceId,\n path: error.path,\n expectedRevision: error.expectedRevision,\n },\n }, 503)\n}\n\n/** The 400 body a client turns back into the typed `VaultPathError`. */\nexport function vaultPathErrorResponse(error: VaultPathError): Response {\n return vaultCoordinatorJson(vaultPathErrorResponseBody(error), 400)\n}\n\nfunction nonEmptyString(value: unknown): string | null {\n return typeof value === 'string' && value.trim() ? value.trim() : null\n}\n\n/** Create the coordinator for one workspace Durable Object. */\nexport function createVaultCoordinator(options: VaultCoordinatorOptions) {\n const { storage, kv } = options\n let mutationQueue: Promise<void> = Promise.resolve()\n\n /** Run `work` after every queued mutation and before any later one. */\n function exclusive<T>(work: () => Promise<T>): Promise<T> {\n const run = mutationQueue.catch(() => undefined).then(work)\n mutationQueue = run.then(() => undefined, () => undefined)\n return run\n }\n\n /** Resolve once every mutation queued so far has settled. */\n async function settled(): Promise<void> {\n await mutationQueue.catch(() => undefined)\n }\n\n function fenceKey(path: string): string {\n return `${VAULT_FENCE_STORAGE_PREFIX}${encodeURIComponent(path)}`\n }\n\n async function readVaultFence(path: string): Promise<VaultVisibilityFence | null> {\n const fence = await storage.get<VaultVisibilityFence>(fenceKey(path))\n if (!fence) return null\n if (fence.schema !== 'vault-visibility-fence-v1' || fence.path !== path) {\n throw new Error(`Invalid Vault visibility fence for ${path}`)\n }\n return fence\n }\n\n async function writeVaultFence(fence: VaultVisibilityFence): Promise<void> {\n await storage.put(fenceKey(fence.path), fence)\n }\n\n async function observeVaultFence(fence: VaultVisibilityFence, surface: 'head' | 'list'): Promise<void> {\n const current = await readVaultFence(fence.path)\n if (!current || current.revision !== fence.revision || current.operationId !== fence.operationId) return\n const observed: VaultVisibilityFence = {\n ...current,\n headVisible: current.headVisible || surface === 'head',\n listVisible: current.listVisible || surface === 'list',\n }\n if (observed.headVisible && observed.listVisible) {\n await storage.delete(fenceKey(fence.path))\n } else {\n await writeVaultFence(observed)\n }\n }\n\n async function listVaultFences(): Promise<VaultVisibilityFence[]> {\n const stored = await storage.list<VaultVisibilityFence>({ prefix: VAULT_FENCE_STORAGE_PREFIX })\n const fences: VaultVisibilityFence[] = []\n for (const value of stored.values()) {\n if (value.schema !== 'vault-visibility-fence-v1' || !value.path || !value.revision) {\n throw new Error('Invalid persisted Vault visibility fence')\n }\n fences.push(value)\n }\n return fences\n }\n\n async function readVaultHeadFenced(workspaceId: string, path: string): Promise<VaultHeadState> {\n const fence = await readVaultFence(path)\n if (!fence) return readVaultHeadState(kv, workspaceId, path)\n const state = await readVaultHeadStateConverged(kv, workspaceId, path, fence)\n await observeVaultFence(fence, 'head')\n return state\n }\n\n async function handleVaultHeadGet(request: Request): Promise<Response> {\n const body = await request.json().catch(() => null) as { workspaceId?: unknown; path?: unknown } | null\n const workspaceId = nonEmptyString(body?.workspaceId)\n const path = nonEmptyString(body?.path)\n if (!workspaceId || !path) return vaultCoordinatorJson({ error: 'Missing workspaceId or path' }, 400)\n try {\n validateWorkspaceId(workspaceId)\n validateVaultFilePath(path)\n await settled()\n return vaultCoordinatorJson({ state: await readVaultHeadFenced(workspaceId, path) })\n } catch (error) {\n if (error instanceof VaultReadConvergenceError) return vaultConvergenceResponse(error)\n if (error instanceof VaultPathError) return vaultPathErrorResponse(error)\n throw error\n }\n }\n\n /**\n * One page of heads with fences layered over it. A fenced path present in\n * the page is reported at its fenced revision, never dropped: hydration\n * reads a page as the authoritative set for its key range and treats a\n * baseline path it never saw as deleted. Fenced paths the listing has not\n * surfaced at all are added on the first page only, where the whole key\n * range is still ahead.\n */\n async function handleVaultHeadList(request: Request): Promise<Response> {\n const body = await request.json().catch(() => null) as {\n workspaceId?: unknown\n cursor?: unknown\n limit?: unknown\n prefix?: unknown\n } | null\n const workspaceId = nonEmptyString(body?.workspaceId)\n const cursor = body?.cursor === undefined || body.cursor === null ? undefined : nonEmptyString(body.cursor)\n const limit = body?.limit === undefined ? undefined : Number(body.limit)\n const pathPrefix = body?.prefix === undefined ? '' : body.prefix\n if (!workspaceId || (body?.cursor !== undefined && body.cursor !== null && !cursor)\n || (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 1_000))\n || typeof pathPrefix !== 'string') {\n return vaultCoordinatorJson({ error: 'Invalid Vault head list request' }, 400)\n }\n\n try {\n validateWorkspaceId(workspaceId)\n await settled()\n const prefix = vaultHeadPrefix(workspaceId)\n const listPrefix = vaultHeadPathPrefix(workspaceId, pathPrefix)\n const [listed, allFences] = await Promise.all([\n kv.list({ prefix: listPrefix, cursor: cursor ?? undefined, ...(limit === undefined ? {} : { limit }) }),\n listVaultFences(),\n ])\n if (!listed.list_complete && !listed.cursor) {\n throw new Error(`Vault KV listing did not provide a cursor for ${workspaceId}`)\n }\n const fences = allFences.filter((fence) => fence.path.startsWith(pathPrefix) && isWorkspaceFileExportable(fence.path))\n const fencesByPath = new Map(fences.map((fence) => [fence.path, fence]))\n const entries = new Map<string, VaultHeadListEntry>()\n const listVisible: VaultVisibilityFence[] = []\n for (const key of listed.keys) {\n const path = key.name.slice(prefix.length)\n if (!isWorkspaceFileExportable(path)) continue\n validateVaultFilePath(path)\n const fence = fencesByPath.get(path)\n const metadata = parseVaultHeadMetadata((key as { metadata?: unknown }).metadata)\n if (fence) {\n entries.set(path, { path, revision: fence.revision, contentHash: fence.contentHash, deleted: fence.deleted })\n if (metadata && vaultHeadMatchesFence({\n revision: metadata.revision,\n contentHash: metadata.contentHash,\n deleted: metadata.deleted,\n metadata,\n }, fence)) listVisible.push(fence)\n continue\n }\n if (metadata && !metadata.batchOperation) {\n entries.set(path, { path, revision: metadata.revision, contentHash: metadata.contentHash, deleted: metadata.deleted })\n continue\n }\n // Absent or mid-batch metadata cannot be read off the listing.\n const state = await readVaultHeadState(kv, workspaceId, path)\n entries.set(path, { path, revision: state.revision, contentHash: state.contentHash, deleted: state.deleted })\n }\n if (!cursor) {\n for (const fence of fences) {\n if (fence.deleted || entries.has(fence.path)) continue\n entries.set(fence.path, { path: fence.path, revision: fence.revision, contentHash: fence.contentHash, deleted: false })\n }\n }\n for (const fence of listVisible) await observeVaultFence(fence, 'list')\n\n options.onHeadList?.({\n workspaceId,\n fences: fences.length,\n headKeys: listed.keys.length,\n entries: entries.size,\n paged: Boolean(cursor),\n })\n return vaultCoordinatorJson({\n entries: [...entries.values()].sort((left, right) => left.path.localeCompare(right.path)),\n complete: listed.list_complete,\n cursor: listed.list_complete ? null : listed.cursor,\n })\n } catch (error) {\n if (error instanceof VaultReadConvergenceError) return vaultConvergenceResponse(error)\n if (error instanceof VaultPathError) return vaultPathErrorResponse(error)\n throw error\n }\n }\n\n async function handleVaultMutation(request: Request): Promise<Response> {\n const body = await request.json().catch(() => null) as VaultMutationRequest | null\n if (!body || typeof body.workspaceId !== 'string' || typeof body.operationId !== 'string'\n || !body.writer || !Array.isArray(body.changes)) {\n return vaultCoordinatorJson({ error: 'Invalid Vault mutation request' }, 400)\n }\n\n const apply = async (): Promise<VaultMutationResult> => {\n const outcome = await applyVaultMutationBatch(\n kv,\n body,\n (workspaceId, path) => readVaultHeadFenced(workspaceId, path),\n options.mutationPolicy,\n )\n if (outcome.status === 'applied') {\n const committedAt = new Date().toISOString()\n await Promise.all(outcome.files.map((file) => writeVaultFence({\n schema: 'vault-visibility-fence-v1',\n path: file.path,\n revision: file.revision,\n contentHash: file.contentHash,\n deleted: file.deleted,\n operationId: body.operationId,\n headVisible: false,\n listVisible: false,\n committedAt,\n })))\n }\n return outcome\n }\n\n try {\n const outcome = await exclusive(() => options.aroundMutation ? options.aroundMutation(body, apply) : apply())\n return vaultCoordinatorJson(outcome, outcome.status === 'conflict' ? 409 : 200)\n } catch (error) {\n if (error instanceof VaultReadConvergenceError) return vaultConvergenceResponse(error)\n if (error instanceof VaultPathError) return vaultPathErrorResponse(error)\n return vaultCoordinatorJson({ error: error instanceof Error ? error.message : 'Vault mutation failed' }, 500)\n }\n }\n\n return {\n exclusive,\n settled,\n readVaultFence,\n observeVaultFence,\n readVaultHeadFenced,\n handleVaultHeadGet,\n handleVaultHeadList,\n handleVaultMutation,\n }\n}\n\nexport type VaultCoordinator = ReturnType<typeof createVaultCoordinator>\n","/**\n * Shared vocabulary and mechanics of syncing a sandbox's Vault copy with KV:\n * the baseline schema, the typed failures a sync reports, the filesystem\n * incarnation a baseline is bound to, and how changed paths are grouped into\n * mutation batches so a rename (a delete and a put of the same bytes) always\n * commits together. Products own the scan, the reads and the hydration walk.\n */\nimport { isWorkspaceFileExportable } from '../../web/file-export'\nimport { compareIncarnationBaseline, type FilesystemIncarnationLike } from '../server'\nimport type { VaultSandboxBaseline } from './revisions'\n\nexport const VAULT_SANDBOX_BASELINE_SCHEMA = 'vault-sandbox-baseline-v3' as const\nconst VAULT_SANDBOX_BASELINE_V2_SCHEMA = 'vault-sandbox-baseline-v2'\nconst VAULT_SANDBOX_BASELINE_V1_SCHEMA = 'vault-sandbox-baseline-v1'\n\nexport interface NormalizedVaultSandboxBaseline {\n baseline: VaultSandboxBaseline | null\n /** True when the stored blob used the v1 or v2 schema. Its file entries remain\n * valid text baselines, but they carry no binary/onDiskHash metadata, so\n * hydration must rewrite every head to materialize binary attachments as\n * decoded bytes. v1 pagination progress is dropped so hydration restarts\n * from the first page. */\n legacy: boolean\n}\n\n/** A stored baseline in the current schema, with entries outside the workspace export boundary dropped. */\nexport function normalizeVaultSandboxBaseline(stored: VaultSandboxBaseline | null): NormalizedVaultSandboxBaseline {\n if (!stored) return { baseline: null, legacy: false }\n stored = { ...stored, files: Object.fromEntries(Object.entries(stored.files).filter(([path]) => isWorkspaceFileExportable(path))) }\n const schema: string = stored.schema\n if (schema === VAULT_SANDBOX_BASELINE_SCHEMA) return { baseline: stored, legacy: false }\n if (schema === VAULT_SANDBOX_BASELINE_V2_SCHEMA) return { baseline: stored, legacy: true }\n if (schema === VAULT_SANDBOX_BASELINE_V1_SCHEMA) {\n const { progress: _progress, ...rest } = stored\n return { baseline: { ...rest, schema: VAULT_SANDBOX_BASELINE_V2_SCHEMA }, legacy: true }\n }\n return { baseline: null, legacy: false }\n}\n\nexport interface SandboxVaultSyncProgress {\n phase: 'reconcile' | 'hydrate'\n processedPaths: number\n totalPaths: number | null\n remainingPaths: number | null\n committedGroups: number\n}\n\nexport interface SandboxVaultPathRejection {\n path: string\n stage: 'authority' | 'manifest' | 'read' | 'commit'\n code: string\n message: string\n}\n\nexport interface SandboxVaultSyncChange {\n path: string\n kind: 'put' | 'delete'\n contentHash: string | null\n expectedRevision: string | null\n}\n\nexport function sandboxVaultRejection(\n path: string,\n stage: SandboxVaultPathRejection['stage'],\n code: string,\n error: unknown,\n): SandboxVaultPathRejection {\n return {\n path,\n stage,\n code,\n message: error instanceof Error ? error.message : String(error),\n }\n}\n\nexport class VaultHydrationError extends Error {\n readonly code = 'vault.hydration_failed'\n\n constructor(message: string, cause: unknown) {\n super(message, { cause })\n this.name = 'VaultHydrationError'\n }\n}\n\nexport class VaultHydrationIncompleteError extends Error {\n readonly code = 'vault.hydration_incomplete'\n readonly retryable = true\n readonly progress: SandboxVaultSyncProgress\n\n constructor(progress: SandboxVaultSyncProgress, detail?: string) {\n super(`Vault hydration is incomplete (${progress.processedPaths} heads processed)${detail ? `: ${detail}` : ''}`)\n this.name = 'VaultHydrationIncompleteError'\n this.progress = progress\n }\n}\n\nexport class VaultFilesystemIncarnationError extends Error {\n readonly code: 'vault.filesystem_incarnation_missing' | 'vault.filesystem_incarnation_not_ready'\n readonly retryable = true\n\n constructor(\n code: VaultFilesystemIncarnationError['code'],\n message: string,\n ) {\n super(message)\n this.name = 'VaultFilesystemIncarnationError'\n this.code = code\n }\n}\n\nexport interface ReadySandboxFilesystemIncarnation {\n id: string\n provenance: 'fresh' | 'restored' | 'unknown'\n}\n\n/** The box's filesystem incarnation, or the typed reason a sync must not trust it yet. */\nexport function readReadySandboxFilesystemIncarnation(\n box: object,\n): { succeeded: true; value: ReadySandboxFilesystemIncarnation } | {\n succeeded: false\n error: VaultFilesystemIncarnationError\n} {\n const candidate = box as FilesystemIncarnationLike\n const comparison = compareIncarnationBaseline(undefined, candidate)\n if (comparison.verdict === 'unidentified') {\n return {\n succeeded: false,\n error: new VaultFilesystemIncarnationError(\n 'vault.filesystem_incarnation_missing',\n 'Sandbox filesystem incarnation identity is unavailable',\n ),\n }\n }\n if (comparison.verdict === 'not-ready') {\n return {\n succeeded: false,\n error: new VaultFilesystemIncarnationError(\n 'vault.filesystem_incarnation_not_ready',\n `Sandbox filesystem incarnation ${candidate.filesystemIncarnationId} is ${String(comparison.readiness ?? 'not ready')}`,\n ),\n }\n }\n if (comparison.verdict !== 'no-baseline') {\n throw new Error(`Unexpected filesystem incarnation comparison verdict: ${comparison.verdict}`)\n }\n return {\n succeeded: true,\n value: {\n id: candidate.filesystemIncarnationId!,\n provenance: candidate.filesystemIncarnationProvenance!,\n },\n }\n}\n\nexport interface SandboxVaultRenameItem {\n path: string\n kind: 'put' | 'delete' | null\n contentHash: string | null\n}\n\n/**\n * Units of work in path order: a delete paired with a put of the same content\n * (a rename) forms one two-item unit, everything else is a unit of one.\n */\nexport function buildSandboxVaultRenameUnits<T>(\n items: T[],\n describe: (item: T) => SandboxVaultRenameItem,\n orderedItems = items,\n): T[][] {\n const putsByHash = new Map<string, T[]>()\n for (const item of items) {\n const candidate = describe(item)\n if (candidate.kind !== 'put' || candidate.contentHash === null) continue\n const puts = putsByHash.get(candidate.contentHash) ?? []\n puts.push(item)\n putsByHash.set(candidate.contentHash, puts)\n }\n const paired = new Set<T>()\n const units: T[][] = []\n for (const deletion of orderedItems) {\n const candidate = describe(deletion)\n if (candidate.kind !== 'delete' || candidate.contentHash === null) continue\n const destination = putsByHash.get(candidate.contentHash)?.find((put) => !paired.has(put))\n if (!destination) continue\n paired.add(deletion)\n paired.add(destination)\n units.push([deletion, destination].sort((left, right) => describe(left).path.localeCompare(describe(right).path)))\n }\n for (const item of orderedItems) if (!paired.has(item)) units.push([item])\n units.sort((left, right) => describe(left[0]!).path.localeCompare(describe(right[0]!).path))\n return units\n}\n\n/** Changes packed into mutation groups of at most `groupSize`, never splitting a rename. */\nexport function groupSandboxVaultChanges<T extends SandboxVaultRenameItem>(changes: T[], groupSize: number): T[][] {\n const units = buildSandboxVaultRenameUnits(changes, (change) => change)\n const groups: T[][] = []\n let current: T[] = []\n for (const unit of units) {\n if (current.length > 0 && current.length + unit.length > groupSize) {\n groups.push(current)\n current = []\n }\n current.push(...unit)\n }\n if (current.length > 0) groups.push(current)\n return groups\n}\n\n/** Map `values` with at most `concurrency` mappers in flight, keeping input order. */\nexport async function mapWithConcurrency<T, R>(\n values: readonly T[],\n concurrency: number,\n mapper: (value: T) => Promise<R>,\n): Promise<R[]> {\n const results = new Array<R>(values.length)\n let nextIndex = 0\n const workers = Array.from({ length: Math.min(concurrency, values.length) }, async () => {\n while (nextIndex < values.length) {\n const index = nextIndex\n nextIndex += 1\n results[index] = await mapper(values[index]!)\n }\n })\n await Promise.all(workers)\n return results\n}\n"],"mappings":"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","names":["delayMs"]}
@@ -0,0 +1,65 @@
1
+ export declare const VAULT_KV_KEY_MAX_BYTES = 512;
2
+ export declare class VaultPathError extends Error {
3
+ readonly code: string;
4
+ readonly path?: string;
5
+ constructor(message: string, path?: string);
6
+ }
7
+ /** A path the workspace export boundary keeps private (runtime configuration). */
8
+ export declare class VaultPrivateRuntimeFileError extends VaultPathError {
9
+ readonly code = "vault.private_runtime_file";
10
+ constructor(path: string);
11
+ }
12
+ export type VaultStorageKeyKind = 'head' | 'revision' | 'operation' | 'metadata' | 'prefix' | 'erasure';
13
+ export declare class VaultStorageKeyError extends VaultPathError {
14
+ readonly code = "vault.key_too_long";
15
+ readonly actualBytes: number;
16
+ readonly maxBytes = 512;
17
+ readonly keyKind: VaultStorageKeyKind;
18
+ constructor(input: {
19
+ path?: string;
20
+ actualBytes: number;
21
+ keyKind: VaultStorageKeyKind;
22
+ });
23
+ }
24
+ export interface VaultPathErrorResponseBody {
25
+ error: {
26
+ code: string;
27
+ message: string;
28
+ path?: string;
29
+ actualBytes?: number;
30
+ maxBytes?: number;
31
+ keyKind?: VaultStorageKeyKind;
32
+ };
33
+ }
34
+ export declare function vaultPathErrorResponseBody(error: VaultPathError): VaultPathErrorResponseBody;
35
+ /** The typed path error a coordinator response carries, or null when it carries none. */
36
+ export declare function parseVaultPathErrorResponse(value: unknown): VaultPathError | null;
37
+ export declare function validateWorkspaceId(workspaceId: string): void;
38
+ export declare function validateVaultFilePath(filePath: string): void;
39
+ /** Whether any segment of `filePath` is hidden (starts with a dot). */
40
+ export declare function isHiddenVaultFilePath(filePath: string): boolean;
41
+ export declare function vaultHeadKey(workspaceId: string, path: string): string;
42
+ export declare function vaultHeadPrefix(workspaceId: string): string;
43
+ /**
44
+ * Head keys under a path prefix. The prefix may end inside a segment (`notes/me`)
45
+ * or at a separator (`memories/workspace/`); empty means the whole Vault.
46
+ */
47
+ export declare function vaultHeadPathPrefix(workspaceId: string, pathPrefix: string): string;
48
+ /** Erasure audit rows of one path sort by its write count, zero-padded to 12 digits. */
49
+ export declare function vaultErasureKey(workspaceId: string, path: string, sequence: number): string;
50
+ /** An unfinished erasure's job record, or one chunk of the revision ids it collected. */
51
+ export declare function vaultErasureJobKey(workspaceId: string, path: string, sequence: number, chunk?: number): string;
52
+ export declare function vaultErasurePrefix(workspaceId: string, pathPrefix?: string): string;
53
+ export declare function vaultRevisionKey(workspaceId: string, revision: string, path?: string): string;
54
+ /** Every revision record of a workspace, committed and conflicting alike. */
55
+ export declare function vaultRevisionPrefix(workspaceId: string): string;
56
+ export declare function vaultOperationKey(workspaceId: string, operationId: string, path?: string): string;
57
+ export declare function vaultMetaKey(workspaceId: string, key: string): string;
58
+ export declare function validateVaultMutationKeys(input: {
59
+ workspaceId: string;
60
+ operationId: string;
61
+ changes: Array<{
62
+ path: string;
63
+ revision?: string;
64
+ }>;
65
+ }): void;
@@ -0,0 +1,211 @@
1
+ import type { KVStore } from '../../store';
2
+ export declare const VAULT_HEAD_SCHEMA = "vault-head-v1";
3
+ export declare const VAULT_REVISION_SCHEMA = "vault-revision-v1";
4
+ export declare const VAULT_OPERATION_SCHEMA = "vault-operation-v1";
5
+ export declare const VAULT_READ_CONVERGENCE_TIMEOUT_MS = 2000;
6
+ export declare const VAULT_READ_CONVERGENCE_INITIAL_DELAY_MS = 25;
7
+ export declare const VAULT_READ_CONVERGENCE_MAX_DELAY_MS = 250;
8
+ /** Committed revisions of one path a lineage lookup reads before it gives up. */
9
+ export declare const VAULT_LINEAGE_MAX_REVISIONS = 32;
10
+ export declare class VaultReadConvergenceError extends Error {
11
+ readonly code = "vault.read_not_converged";
12
+ readonly retryable = true;
13
+ readonly workspaceId?: string;
14
+ readonly path?: string;
15
+ readonly expectedRevision?: string;
16
+ constructor(input?: string | {
17
+ message?: string;
18
+ workspaceId?: string;
19
+ path?: string;
20
+ expectedRevision?: string;
21
+ });
22
+ }
23
+ export type VaultWriterKind = 'frontend' | 'sandbox' | 'system';
24
+ export type VaultLearningActor = 'agent' | 'owner' | 'maintenance' | 'unknown';
25
+ /** Who caused a write and through which surface. `source` values are product vocabulary. */
26
+ export interface VaultWriteProvenance {
27
+ actor: VaultLearningActor;
28
+ source: string;
29
+ executionId?: string;
30
+ threadId?: string;
31
+ messageId?: string;
32
+ }
33
+ export interface VaultWriter {
34
+ kind: VaultWriterKind;
35
+ id?: string;
36
+ authKind?: 'operator';
37
+ keyId?: string;
38
+ provenance?: VaultWriteProvenance;
39
+ }
40
+ /**
41
+ * Attribution recorded at the writer, without prompt text or inferred
42
+ * execution identities. Defaults follow the writer kind; `allowedSources` is
43
+ * the product's provenance vocabulary and anything outside it is refused.
44
+ */
45
+ export declare function normalizeVaultWriterProvenance(writer: VaultWriter, allowedSources: readonly string[]): VaultWriter;
46
+ /** Who created the live entry and when; carried across updates, set again after a delete. */
47
+ export interface VaultCreation {
48
+ by: string;
49
+ at: string;
50
+ }
51
+ /** The actor a writer reads as in creation records. */
52
+ export declare function vaultWriterActor(writer: VaultWriter): string;
53
+ export interface VaultHeadMetadata {
54
+ schema: typeof VAULT_HEAD_SCHEMA;
55
+ revision: string;
56
+ contentHash: string | null;
57
+ deleted: boolean;
58
+ operationId: string;
59
+ updatedAt: string;
60
+ writer: VaultWriter;
61
+ batchOperation?: boolean;
62
+ /** Writes to this path so far, deletes included; absent on heads written before it existed. */
63
+ sequence?: number;
64
+ created?: VaultCreation;
65
+ /** Opaque tag a product adapter records to decode its own writes. */
66
+ storeFormat?: string;
67
+ }
68
+ export interface VaultRevisionMetadata {
69
+ schema: typeof VAULT_REVISION_SCHEMA;
70
+ workspaceId: string;
71
+ path: string;
72
+ revision: string;
73
+ parentRevision: string | null;
74
+ contentHash: string | null;
75
+ /** Actual UTF8 bytes recorded by the immutable revision writer; absent on older revisions. */
76
+ contentBytes?: number;
77
+ deleted: boolean;
78
+ operationId: string;
79
+ createdAt: string;
80
+ writer: VaultWriter;
81
+ outcome: 'committed' | 'conflict';
82
+ batchOperation?: boolean;
83
+ sequence?: number;
84
+ storeFormat?: string;
85
+ }
86
+ export interface VaultMutationChange {
87
+ path: string;
88
+ kind: 'put' | 'delete';
89
+ content?: string;
90
+ expectedRevision: string | null;
91
+ storeFormat?: string;
92
+ }
93
+ export interface VaultMutationRequest {
94
+ workspaceId: string;
95
+ operationId: string;
96
+ writer: VaultWriter;
97
+ changes: VaultMutationChange[];
98
+ }
99
+ export interface VaultMutationFileResult {
100
+ path: string;
101
+ revision: string;
102
+ contentHash: string | null;
103
+ deleted: boolean;
104
+ /** Absent from a coordinator still running code from before the count existed. */
105
+ sequence?: number;
106
+ updatedAt?: string;
107
+ }
108
+ export interface VaultMutationConflict {
109
+ path: string;
110
+ expectedRevision: string | null;
111
+ currentRevision: string | null;
112
+ conflictRevision: string;
113
+ }
114
+ export type VaultMutationResult = {
115
+ status: 'applied';
116
+ files: VaultMutationFileResult[];
117
+ } | {
118
+ status: 'conflict';
119
+ conflicts: VaultMutationConflict[];
120
+ };
121
+ export interface VaultHeadState {
122
+ revision: string | null;
123
+ contentHash: string | null;
124
+ deleted: boolean;
125
+ content: string | null;
126
+ metadata: VaultHeadMetadata | null;
127
+ /** Set when `metadata` is null but the write count is known, as for a batch still in flight. */
128
+ sequence?: number;
129
+ }
130
+ /** What a mutation does to the writer before it is recorded (a product's provenance rules). */
131
+ export interface VaultMutationPolicy {
132
+ normalizeWriter?: (writer: VaultWriter) => VaultWriter;
133
+ }
134
+ /**
135
+ * The per-path write count: 0 for a path never written, and deletes count. A
136
+ * head written before the count existed reads as 1, so the next write records
137
+ * 2 and the count only grows.
138
+ */
139
+ export declare function vaultHeadSequence(state: Pick<VaultHeadState, 'revision' | 'metadata' | 'sequence'>): number;
140
+ /** The recorded creation of a head, or null when the Vault recorded none. */
141
+ export declare function vaultHeadCreation(metadata: VaultHeadMetadata | null): VaultCreation | null;
142
+ export interface VaultVisibilityFence {
143
+ schema: 'vault-visibility-fence-v1';
144
+ path: string;
145
+ revision: string;
146
+ contentHash: string | null;
147
+ deleted: boolean;
148
+ operationId: string;
149
+ headVisible: boolean;
150
+ listVisible: boolean;
151
+ committedAt: string;
152
+ }
153
+ export type VaultHeadReader = (workspaceId: string, path: string) => Promise<VaultHeadState>;
154
+ export interface VaultConvergenceOptions {
155
+ timeoutMs?: number;
156
+ now?: () => number;
157
+ sleep?: (delayMs: number) => Promise<void>;
158
+ }
159
+ export interface VaultSandboxBaselineFile {
160
+ revision: string | null;
161
+ contentHash: string | null;
162
+ deleted: boolean;
163
+ binary?: boolean;
164
+ onDiskHash?: string | null;
165
+ }
166
+ export interface VaultSandboxProgress {
167
+ operation: 'hydrate';
168
+ cursor?: string;
169
+ processedHeadCount: number;
170
+ unseenBaselinePaths: string[];
171
+ }
172
+ /** What a sandbox's copy of the Vault held when it last agreed with KV. */
173
+ export interface VaultSandboxBaseline {
174
+ schema: 'vault-sandbox-baseline-v2' | 'vault-sandbox-baseline-v3';
175
+ workspaceId: string;
176
+ sandboxId: string;
177
+ /**
178
+ * Control-plane filesystem identity that authorized this baseline. Required
179
+ * by v3; absent only on legacy v2 records during rollout.
180
+ */
181
+ filesystemIncarnationId?: string;
182
+ /** Absent on retained baselines whose mirror is the legacy native cwd. */
183
+ mirrorRoot?: string;
184
+ files: Record<string, VaultSandboxBaselineFile>;
185
+ progress?: VaultSandboxProgress;
186
+ updatedAt: string;
187
+ }
188
+ export declare function parseVaultHeadMetadata(value: unknown): VaultHeadMetadata | null;
189
+ export declare function vaultHeadMatchesFence(state: Pick<VaultHeadState, 'revision' | 'contentHash' | 'deleted' | 'metadata'>, fence: VaultVisibilityFence): boolean;
190
+ /** Read the head until it exposes the fenced revision, or throw `VaultReadConvergenceError`. */
191
+ export declare function readVaultHeadStateConverged(kv: KVStore, workspaceId: string, path: string, fence: VaultVisibilityFence, options?: VaultConvergenceOptions): Promise<VaultHeadState>;
192
+ /**
193
+ * Workspace erasure runs with writers closed. A visible committed descendant
194
+ * can supersede its fence, but only after its immutable lineage proves that
195
+ * fence was included. Ordinary Vault reads keep exact-fence convergence.
196
+ */
197
+ export declare function readVaultHeadStateForErasure(kv: KVStore, workspaceId: string, path: string, fence: VaultVisibilityFence, options?: VaultConvergenceOptions): Promise<VaultHeadState>;
198
+ export declare function vaultOperationCommitted(kv: KVStore, workspaceId: string, operationId: string, path?: string): Promise<boolean>;
199
+ /**
200
+ * The head of `path` as readers must see it. A head written by a batch that
201
+ * has not committed answers with its parent revision; a legacy value with no
202
+ * metadata answers with a revision derived from its content.
203
+ */
204
+ export declare function readVaultHeadState(kv: KVStore, workspaceId: string, path: string): Promise<VaultHeadState>;
205
+ /**
206
+ * Apply a batch of path changes against their expected revisions. Any stale
207
+ * expectation turns the whole batch into a conflict (each blocked change is
208
+ * kept as a conflict revision); otherwise every change commits, a multi-path
209
+ * batch behind an operation record. Replaying an applied operation is a no-op.
210
+ */
211
+ export declare function applyVaultMutationBatch(kv: KVStore, request: VaultMutationRequest, readHead?: VaultHeadReader, policy?: VaultMutationPolicy): Promise<VaultMutationResult>;
@@ -0,0 +1,74 @@
1
+ import type { VaultSandboxBaseline } from './revisions';
2
+ export declare const VAULT_SANDBOX_BASELINE_SCHEMA: 'vault-sandbox-baseline-v3';
3
+ export interface NormalizedVaultSandboxBaseline {
4
+ baseline: VaultSandboxBaseline | null;
5
+ /** True when the stored blob used the v1 or v2 schema. Its file entries remain
6
+ * valid text baselines, but they carry no binary/onDiskHash metadata, so
7
+ * hydration must rewrite every head to materialize binary attachments as
8
+ * decoded bytes. v1 pagination progress is dropped so hydration restarts
9
+ * from the first page. */
10
+ legacy: boolean;
11
+ }
12
+ /** A stored baseline in the current schema, with entries outside the workspace export boundary dropped. */
13
+ export declare function normalizeVaultSandboxBaseline(stored: VaultSandboxBaseline | null): NormalizedVaultSandboxBaseline;
14
+ export interface SandboxVaultSyncProgress {
15
+ phase: 'reconcile' | 'hydrate';
16
+ processedPaths: number;
17
+ totalPaths: number | null;
18
+ remainingPaths: number | null;
19
+ committedGroups: number;
20
+ }
21
+ export interface SandboxVaultPathRejection {
22
+ path: string;
23
+ stage: 'authority' | 'manifest' | 'read' | 'commit';
24
+ code: string;
25
+ message: string;
26
+ }
27
+ export interface SandboxVaultSyncChange {
28
+ path: string;
29
+ kind: 'put' | 'delete';
30
+ contentHash: string | null;
31
+ expectedRevision: string | null;
32
+ }
33
+ export declare function sandboxVaultRejection(path: string, stage: SandboxVaultPathRejection['stage'], code: string, error: unknown): SandboxVaultPathRejection;
34
+ export declare class VaultHydrationError extends Error {
35
+ readonly code = "vault.hydration_failed";
36
+ constructor(message: string, cause: unknown);
37
+ }
38
+ export declare class VaultHydrationIncompleteError extends Error {
39
+ readonly code = "vault.hydration_incomplete";
40
+ readonly retryable = true;
41
+ readonly progress: SandboxVaultSyncProgress;
42
+ constructor(progress: SandboxVaultSyncProgress, detail?: string);
43
+ }
44
+ export declare class VaultFilesystemIncarnationError extends Error {
45
+ readonly code: 'vault.filesystem_incarnation_missing' | 'vault.filesystem_incarnation_not_ready';
46
+ readonly retryable = true;
47
+ constructor(code: VaultFilesystemIncarnationError['code'], message: string);
48
+ }
49
+ export interface ReadySandboxFilesystemIncarnation {
50
+ id: string;
51
+ provenance: 'fresh' | 'restored' | 'unknown';
52
+ }
53
+ /** The box's filesystem incarnation, or the typed reason a sync must not trust it yet. */
54
+ export declare function readReadySandboxFilesystemIncarnation(box: object): {
55
+ succeeded: true;
56
+ value: ReadySandboxFilesystemIncarnation;
57
+ } | {
58
+ succeeded: false;
59
+ error: VaultFilesystemIncarnationError;
60
+ };
61
+ export interface SandboxVaultRenameItem {
62
+ path: string;
63
+ kind: 'put' | 'delete' | null;
64
+ contentHash: string | null;
65
+ }
66
+ /**
67
+ * Units of work in path order: a delete paired with a put of the same content
68
+ * (a rename) forms one two-item unit, everything else is a unit of one.
69
+ */
70
+ export declare function buildSandboxVaultRenameUnits<T>(items: T[], describe: (item: T) => SandboxVaultRenameItem, orderedItems?: T[]): T[][];
71
+ /** Changes packed into mutation groups of at most `groupSize`, never splitting a rename. */
72
+ export declare function groupSandboxVaultChanges<T extends SandboxVaultRenameItem>(changes: T[], groupSize: number): T[][];
73
+ /** Map `values` with at most `concurrency` mappers in flight, keeping input order. */
74
+ export declare function mapWithConcurrency<T, R>(values: readonly T[], concurrency: number, mapper: (value: T) => Promise<R>): Promise<R[]>;