sealbridge 0.2.1 → 0.3.0

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 (266) hide show
  1. package/README.ja.md +499 -31
  2. package/README.md +529 -110
  3. package/dist/cli/dist/accept.d.ts +13 -0
  4. package/dist/cli/dist/accept.js +115 -0
  5. package/dist/cli/dist/accept.js.map +1 -0
  6. package/dist/cli/dist/approval-summary.d.ts +1 -1
  7. package/dist/cli/dist/board.d.ts +10 -9
  8. package/dist/cli/dist/board.js +62 -31
  9. package/dist/cli/dist/board.js.map +1 -1
  10. package/dist/cli/dist/command-identity.d.ts +6 -0
  11. package/dist/cli/dist/command-identity.js +13 -0
  12. package/dist/cli/dist/command-identity.js.map +1 -0
  13. package/dist/cli/dist/config.d.ts +3 -0
  14. package/dist/cli/dist/config.js +29 -0
  15. package/dist/cli/dist/config.js.map +1 -0
  16. package/dist/cli/dist/connections.d.ts +15 -0
  17. package/dist/cli/dist/connections.js +191 -0
  18. package/dist/cli/dist/connections.js.map +1 -0
  19. package/dist/cli/dist/contacts.d.ts +4 -3
  20. package/dist/cli/dist/contacts.js +39 -28
  21. package/dist/cli/dist/contacts.js.map +1 -1
  22. package/dist/cli/dist/doctor.d.ts +9 -0
  23. package/dist/cli/dist/doctor.js +46 -5
  24. package/dist/cli/dist/doctor.js.map +1 -1
  25. package/dist/cli/dist/error-messages.js +24 -0
  26. package/dist/cli/dist/error-messages.js.map +1 -1
  27. package/dist/cli/dist/index.js +54 -6
  28. package/dist/cli/dist/index.js.map +1 -1
  29. package/dist/cli/dist/invite-output.d.ts +14 -0
  30. package/dist/cli/dist/invite-output.js +66 -0
  31. package/dist/cli/dist/invite-output.js.map +1 -0
  32. package/dist/cli/dist/invite-share.d.ts +6 -3
  33. package/dist/cli/dist/invite-share.js +40 -15
  34. package/dist/cli/dist/invite-share.js.map +1 -1
  35. package/dist/cli/dist/invites-migrate.d.ts +3 -0
  36. package/dist/cli/dist/invites-migrate.js +33 -0
  37. package/dist/cli/dist/invites-migrate.js.map +1 -0
  38. package/dist/cli/dist/mcp.d.ts +7 -5
  39. package/dist/cli/dist/mcp.js +23 -18
  40. package/dist/cli/dist/mcp.js.map +1 -1
  41. package/dist/cli/dist/network.d.ts +11 -1
  42. package/dist/cli/dist/network.js +150 -87
  43. package/dist/cli/dist/network.js.map +1 -1
  44. package/dist/cli/dist/pending.d.ts +8 -0
  45. package/dist/cli/dist/pending.js +50 -0
  46. package/dist/cli/dist/pending.js.map +1 -0
  47. package/dist/cli/dist/public-settings.d.ts +5 -4
  48. package/dist/cli/dist/public-settings.js +13 -15
  49. package/dist/cli/dist/public-settings.js.map +1 -1
  50. package/dist/cli/dist/receipt.d.ts +1 -1
  51. package/dist/cli/dist/relay-auth.d.ts +3 -0
  52. package/dist/cli/dist/relay-auth.js +23 -0
  53. package/dist/cli/dist/relay-auth.js.map +1 -0
  54. package/dist/cli/dist/requests.d.ts +10 -0
  55. package/dist/cli/dist/requests.js +91 -0
  56. package/dist/cli/dist/requests.js.map +1 -0
  57. package/dist/cli/dist/sdk.d.ts +10 -0
  58. package/dist/cli/dist/sdk.js +7 -0
  59. package/dist/cli/dist/sdk.js.map +1 -0
  60. package/dist/cli/dist/setup-files.d.ts +24 -0
  61. package/dist/cli/dist/setup-files.js +190 -0
  62. package/dist/cli/dist/setup-files.js.map +1 -0
  63. package/dist/cli/dist/setup-hosts.d.ts +29 -0
  64. package/dist/cli/dist/setup-hosts.js +75 -0
  65. package/dist/cli/dist/setup-hosts.js.map +1 -0
  66. package/dist/cli/dist/setup.d.ts +61 -0
  67. package/dist/cli/dist/setup.js +243 -0
  68. package/dist/cli/dist/setup.js.map +1 -0
  69. package/dist/cli/dist/task-input.d.ts +1 -1
  70. package/dist/cli/dist/wake-hook.d.ts +1 -1
  71. package/dist/cli/dist/worker-json.d.ts +4 -0
  72. package/dist/cli/dist/worker-json.js +87 -0
  73. package/dist/cli/dist/worker-json.js.map +1 -0
  74. package/dist/examples/two-owner-demo/dist/run-demo.d.ts +13 -13
  75. package/dist/package.json +1 -1
  76. package/dist/packages/adapters/dist/codex-config.d.ts +15 -0
  77. package/dist/packages/adapters/dist/codex-config.js +171 -0
  78. package/dist/packages/adapters/dist/codex-config.js.map +1 -0
  79. package/dist/packages/adapters/dist/command.d.ts +7 -3
  80. package/dist/packages/adapters/dist/command.js +74 -24
  81. package/dist/packages/adapters/dist/command.js.map +1 -1
  82. package/dist/packages/adapters/dist/credential-proxy.d.ts +4 -2
  83. package/dist/packages/adapters/dist/credential-proxy.js +5 -0
  84. package/dist/packages/adapters/dist/credential-proxy.js.map +1 -1
  85. package/dist/packages/adapters/dist/index.d.ts +1 -1
  86. package/dist/packages/adapters/dist/mcp.d.ts +2 -2
  87. package/dist/packages/adapters/dist/openai.d.ts +2 -2
  88. package/dist/packages/adapters/dist/sandbox.d.ts +2 -2
  89. package/dist/packages/adapters/dist/windows-command.d.ts +6 -0
  90. package/dist/packages/adapters/dist/windows-command.js +37 -0
  91. package/dist/packages/adapters/dist/windows-command.js.map +1 -0
  92. package/dist/packages/core/dist/connection.d.ts +58 -0
  93. package/dist/packages/core/dist/connection.js +132 -0
  94. package/dist/packages/core/dist/connection.js.map +1 -0
  95. package/dist/packages/core/dist/delivery-status.d.ts +22 -0
  96. package/dist/packages/core/dist/delivery-status.js +53 -0
  97. package/dist/packages/core/dist/delivery-status.js.map +1 -0
  98. package/dist/packages/core/dist/discovery.d.ts +7 -6
  99. package/dist/packages/core/dist/discovery.js +19 -20
  100. package/dist/packages/core/dist/discovery.js.map +1 -1
  101. package/dist/packages/core/dist/edge.d.ts +1 -0
  102. package/dist/packages/core/dist/edge.js +1 -0
  103. package/dist/packages/core/dist/edge.js.map +1 -1
  104. package/dist/packages/core/dist/index.d.ts +3 -0
  105. package/dist/packages/core/dist/index.js +3 -0
  106. package/dist/packages/core/dist/index.js.map +1 -1
  107. package/dist/packages/core/dist/protocol.d.ts +24 -0
  108. package/dist/packages/core/dist/protocol.js +54 -0
  109. package/dist/packages/core/dist/protocol.js.map +1 -0
  110. package/dist/packages/core/dist/receipts.d.ts +1 -0
  111. package/dist/packages/core/dist/receipts.js +1 -1
  112. package/dist/packages/core/dist/receipts.js.map +1 -1
  113. package/dist/packages/core/dist/schema.d.ts +1 -0
  114. package/dist/packages/core/dist/schema.js +13 -2
  115. package/dist/packages/core/dist/schema.js.map +1 -1
  116. package/dist/packages/ledger/dist/index.d.ts +1 -1
  117. package/dist/packages/relay/dist/admission.d.ts +14 -0
  118. package/dist/packages/relay/dist/admission.js +70 -0
  119. package/dist/packages/relay/dist/admission.js.map +1 -0
  120. package/dist/packages/relay/dist/fetch.d.ts +8 -2
  121. package/dist/packages/relay/dist/fetch.js +41 -12
  122. package/dist/packages/relay/dist/fetch.js.map +1 -1
  123. package/dist/packages/relay/dist/index.d.ts +23 -12
  124. package/dist/packages/relay/dist/index.js +130 -78
  125. package/dist/packages/relay/dist/index.js.map +1 -1
  126. package/dist/packages/relay/dist/journal.d.ts +1 -1
  127. package/dist/packages/relay/dist/notifications.d.ts +1 -1
  128. package/dist/packages/relay/dist/retry.d.ts +23 -0
  129. package/dist/packages/relay/dist/retry.js +43 -1
  130. package/dist/packages/relay/dist/retry.js.map +1 -1
  131. package/dist/packages/relay/dist/ssrf.d.ts +3 -2
  132. package/dist/packages/relay/dist/ssrf.js.map +1 -1
  133. package/dist/packages/relay/dist/worker.js +1 -1
  134. package/dist/packages/relay/dist/worker.js.map +1 -1
  135. package/dist/packages/runtime/dist/a2a.d.ts +1 -1
  136. package/dist/packages/runtime/dist/a2a.js +1 -1
  137. package/dist/packages/runtime/dist/adapter.d.ts +2 -2
  138. package/dist/packages/runtime/dist/application-config.d.ts +20 -0
  139. package/dist/packages/runtime/dist/application-config.js +222 -0
  140. package/dist/packages/runtime/dist/application-config.js.map +1 -0
  141. package/dist/packages/runtime/dist/approval-providers.d.ts +24 -3
  142. package/dist/packages/runtime/dist/approval-providers.js +79 -3
  143. package/dist/packages/runtime/dist/approval-providers.js.map +1 -1
  144. package/dist/packages/runtime/dist/connection-admission-review.d.ts +39 -0
  145. package/dist/packages/runtime/dist/connection-admission-review.js +86 -0
  146. package/dist/packages/runtime/dist/connection-admission-review.js.map +1 -0
  147. package/dist/packages/runtime/dist/connection-persistence.d.ts +35 -0
  148. package/dist/packages/runtime/dist/connection-persistence.js +181 -0
  149. package/dist/packages/runtime/dist/connection-persistence.js.map +1 -0
  150. package/dist/packages/runtime/dist/connection-records.d.ts +167 -0
  151. package/dist/packages/runtime/dist/connection-records.js +132 -0
  152. package/dist/packages/runtime/dist/connection-records.js.map +1 -0
  153. package/dist/packages/runtime/dist/connection-router.d.ts +45 -0
  154. package/dist/packages/runtime/dist/connection-router.js +130 -0
  155. package/dist/packages/runtime/dist/connection-router.js.map +1 -0
  156. package/dist/packages/runtime/dist/connection-service.d.ts +159 -0
  157. package/dist/packages/runtime/dist/connection-service.js +239 -0
  158. package/dist/packages/runtime/dist/connection-service.js.map +1 -0
  159. package/dist/packages/runtime/dist/connection-transport.d.ts +14 -0
  160. package/dist/packages/runtime/dist/connection-transport.js +89 -0
  161. package/dist/packages/runtime/dist/connection-transport.js.map +1 -0
  162. package/dist/packages/runtime/dist/delivery-records.d.ts +180 -0
  163. package/dist/packages/runtime/dist/delivery-records.js +205 -0
  164. package/dist/packages/runtime/dist/delivery-records.js.map +1 -0
  165. package/dist/packages/runtime/dist/delivery-status-router.d.ts +27 -0
  166. package/dist/packages/runtime/dist/delivery-status-router.js +150 -0
  167. package/dist/packages/runtime/dist/delivery-status-router.js.map +1 -0
  168. package/dist/packages/runtime/dist/delivery-status.d.ts +43 -0
  169. package/dist/packages/runtime/dist/delivery-status.js +193 -0
  170. package/dist/packages/runtime/dist/delivery-status.js.map +1 -0
  171. package/dist/packages/runtime/dist/delivery-store.d.ts +125 -0
  172. package/dist/packages/runtime/dist/delivery-store.js +1047 -0
  173. package/dist/packages/runtime/dist/delivery-store.js.map +1 -0
  174. package/dist/packages/runtime/dist/gateway.d.ts +4 -3
  175. package/dist/packages/runtime/dist/gateway.js.map +1 -1
  176. package/dist/packages/runtime/dist/held-request-review.d.ts +49 -0
  177. package/dist/packages/runtime/dist/held-request-review.js +122 -0
  178. package/dist/packages/runtime/dist/held-request-review.js.map +1 -0
  179. package/dist/packages/runtime/dist/held-request-store.d.ts +112 -0
  180. package/dist/packages/runtime/dist/held-request-store.js +290 -0
  181. package/dist/packages/runtime/dist/held-request-store.js.map +1 -0
  182. package/dist/packages/runtime/dist/idempotency-store.d.ts +53 -0
  183. package/dist/packages/runtime/dist/idempotency-store.js +331 -0
  184. package/dist/packages/runtime/dist/idempotency-store.js.map +1 -0
  185. package/dist/packages/runtime/dist/inbox.d.ts +1 -1
  186. package/dist/packages/runtime/dist/index.d.ts +27 -1
  187. package/dist/packages/runtime/dist/index.js +26 -0
  188. package/dist/packages/runtime/dist/index.js.map +1 -1
  189. package/dist/packages/runtime/dist/invite-store.d.ts +76 -0
  190. package/dist/packages/runtime/dist/invite-store.js +337 -0
  191. package/dist/packages/runtime/dist/invite-store.js.map +1 -0
  192. package/dist/packages/runtime/dist/key-store.d.ts +77 -0
  193. package/dist/packages/runtime/dist/key-store.js +226 -0
  194. package/dist/packages/runtime/dist/key-store.js.map +1 -0
  195. package/dist/packages/runtime/dist/local-identity.d.ts +33 -0
  196. package/dist/packages/runtime/dist/local-identity.js +278 -0
  197. package/dist/packages/runtime/dist/local-identity.js.map +1 -0
  198. package/dist/packages/runtime/dist/mcp-rpc.d.ts +19 -0
  199. package/dist/packages/runtime/dist/mcp-rpc.js +175 -0
  200. package/dist/packages/runtime/dist/mcp-rpc.js.map +1 -0
  201. package/dist/packages/runtime/dist/mcp-server.d.ts +46 -19
  202. package/dist/packages/runtime/dist/mcp-server.js +427 -184
  203. package/dist/packages/runtime/dist/mcp-server.js.map +1 -1
  204. package/dist/packages/runtime/dist/mcp-tool-catalog.d.ts +1 -1
  205. package/dist/packages/runtime/dist/mcp-tool-catalog.js +172 -13
  206. package/dist/packages/runtime/dist/mcp-tool-catalog.js.map +1 -1
  207. package/dist/packages/runtime/dist/mcp.d.ts +2 -2
  208. package/dist/packages/runtime/dist/message-status.d.ts +32 -0
  209. package/dist/packages/runtime/dist/message-status.js +29 -0
  210. package/dist/packages/runtime/dist/message-status.js.map +1 -0
  211. package/dist/packages/runtime/dist/outbox.d.ts +91 -0
  212. package/dist/packages/runtime/dist/outbox.js +462 -0
  213. package/dist/packages/runtime/dist/outbox.js.map +1 -0
  214. package/dist/packages/runtime/dist/policy.d.ts +1 -1
  215. package/dist/packages/runtime/dist/protocol-peer-store.d.ts +40 -0
  216. package/dist/packages/runtime/dist/protocol-peer-store.js +176 -0
  217. package/dist/packages/runtime/dist/protocol-peer-store.js.map +1 -0
  218. package/dist/packages/runtime/dist/protocol-release.d.ts +26 -0
  219. package/dist/packages/runtime/dist/protocol-release.js +76 -0
  220. package/dist/packages/runtime/dist/protocol-release.js.map +1 -0
  221. package/dist/packages/runtime/dist/quota.d.ts +1 -1
  222. package/dist/packages/runtime/dist/relay-selection.d.ts +20 -0
  223. package/dist/packages/runtime/dist/relay-selection.js +34 -0
  224. package/dist/packages/runtime/dist/relay-selection.js.map +1 -0
  225. package/dist/packages/runtime/dist/requester-pending-store.d.ts +59 -0
  226. package/dist/packages/runtime/dist/requester-pending-store.js +266 -0
  227. package/dist/packages/runtime/dist/requester-pending-store.js.map +1 -0
  228. package/dist/packages/runtime/dist/secret-store.d.ts +19 -0
  229. package/dist/packages/runtime/dist/secret-store.js +51 -0
  230. package/dist/packages/runtime/dist/secret-store.js.map +1 -0
  231. package/dist/packages/runtime/dist/session-audit.d.ts +29 -7
  232. package/dist/packages/runtime/dist/session-audit.js +149 -29
  233. package/dist/packages/runtime/dist/session-audit.js.map +1 -1
  234. package/dist/packages/runtime/dist/session.d.ts +101 -9
  235. package/dist/packages/runtime/dist/session.js +696 -96
  236. package/dist/packages/runtime/dist/session.js.map +1 -1
  237. package/dist/packages/runtime/dist/task-journal.d.ts +18 -3
  238. package/dist/packages/runtime/dist/task-journal.js +271 -18
  239. package/dist/packages/runtime/dist/task-journal.js.map +1 -1
  240. package/dist/packages/runtime/dist/verifier.d.ts +3 -2
  241. package/dist/packages/runtime/dist/verifier.js +1 -0
  242. package/dist/packages/runtime/dist/verifier.js.map +1 -1
  243. package/dist/packages/runtime/dist/worker-trust-store.d.ts +111 -0
  244. package/dist/packages/runtime/dist/worker-trust-store.js +592 -0
  245. package/dist/packages/runtime/dist/worker-trust-store.js.map +1 -0
  246. package/dist/packages/sandbox/dist/command-environment.d.ts +2 -0
  247. package/dist/packages/sandbox/dist/command-environment.js +29 -0
  248. package/dist/packages/sandbox/dist/command-environment.js.map +1 -0
  249. package/dist/packages/sandbox/dist/container.d.ts +1 -1
  250. package/dist/packages/sandbox/dist/index.d.ts +2 -1
  251. package/dist/packages/sandbox/dist/index.js +1 -0
  252. package/dist/packages/sandbox/dist/index.js.map +1 -1
  253. package/dist/spec/README.ja.md +21 -1
  254. package/dist/spec/README.md +20 -1
  255. package/dist/spec/agent-card.schema.json +11 -1
  256. package/dist/spec/delivery-status.schema.json +106 -0
  257. package/dist/spec/examples/protocol-versions/sample-agent-card.json +35 -0
  258. package/dist/spec/examples/sample-delivery-status.json +21 -0
  259. package/dist/spec/examples/sample-task-manifest.0.1.0.json +173 -0
  260. package/dist/spec/examples/sample-task-manifest.0.2.0.json +173 -0
  261. package/dist/spec/task-manifest.0.1.0.schema.json +422 -0
  262. package/dist/spec/task-manifest.0.2.0.schema.json +422 -0
  263. package/dist/spec/task-manifest.schema.json +9 -418
  264. package/docs/sdk.ja.md +133 -0
  265. package/docs/sdk.md +138 -0
  266. package/package.json +15 -3
@@ -0,0 +1,290 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import * as fs from 'node:fs';
3
+ import { createHash, randomUUID } from 'node:crypto';
4
+ import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
5
+ import { digest, isEncryptedEnvelopePayload, resolveDid, signPayload, verifyEnvelope, verifySigned } from '../../core/dist/index.js';
6
+ import { checkPath, inspectDirectory, privateDirectory, readPrivateFile, resolveDataRoot, writePrivateFile } from './local-identity.js';
7
+ export const HELD_CONTENT_BOUNDS = Object.freeze({
8
+ retentionMs: 24 * 60 * 60_000, envelopeBytes: 256 * 1024, records: 100,
9
+ totalEnvelopeBytes: 32 * 1024 * 1024, metadataBytes: 8 * 1024,
10
+ });
11
+ const idPattern = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
12
+ export const isHeldDigest = (value) => typeof value === 'string' && /^sha256:[a-f0-9]{64}$/.test(value);
13
+ const kinds = ['task', 'connection', 'application'];
14
+ function fail() { throw new Error('QUARANTINE_INVALID'); }
15
+ function keys(value, allowed) { return Object.keys(value).every(k => allowed.includes(k)); }
16
+ function signedShape(value) {
17
+ return keys(value, ['payload', 'signature']) && !!value.signature && keys(value.signature, ['signerDid', 'canonicalization', 'payloadDigest', 'signedAt', 'signature']);
18
+ }
19
+ function identifier(value) { return value === undefined || typeof value === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(value); }
20
+ function bytes(value) { return Buffer.byteLength(JSON.stringify(value)); }
21
+ function encrypted(envelope, ownerDid) {
22
+ if (!isEncryptedEnvelopePayload(envelope?.payload?.payload))
23
+ throw new Error('UNENCRYPTED_ENVELOPE_REJECTED');
24
+ const payload = envelope.payload.payload;
25
+ if (!verifyEnvelope(envelope, ownerDid) || !keys(payload, ['__acpEncrypted', 'ephemeralPublicKey', 'iv', 'ciphertext', 'tag']) ||
26
+ ![payload.ephemeralPublicKey, payload.iv, payload.ciphertext, payload.tag].every(s => /^[A-Za-z0-9_-]*$/.test(s)) ||
27
+ Buffer.from(payload.iv, 'base64url').length !== 12 || Buffer.from(payload.tag, 'base64url').length !== 16)
28
+ fail();
29
+ }
30
+ export function heldRequestDirectory(ownerDid, options = {}) {
31
+ return join(resolveDataRoot(options), 'quarantine', createHash('sha256').update(ownerDid).digest('hex'));
32
+ }
33
+ export function heldSummary(record, now) {
34
+ return { id: record.id, kind: record.kind, ownerDid: record.ownerDid, senderOwnerDid: record.senderOwnerDid,
35
+ ...(record.requestId === undefined ? {} : { requestId: record.requestId }),
36
+ ...(record.taskId === undefined ? {} : { taskId: record.taskId }),
37
+ contentDigest: record.contentDigest, envelopeDigest: record.envelopeDigest,
38
+ receivedAt: record.receivedAt, expiresAt: record.expiresAt,
39
+ state: record.expiresAt <= now ? 'expired' : record.state,
40
+ inspectionStatus: record.inspectionReceipt?.payload.status ?? 'pending', sizeBytes: bytes(record.envelope) };
41
+ }
42
+ /** Owner-local ciphertext storage. Reads never create, migrate, prune or rewrite files. */
43
+ export class HeldRequestStore {
44
+ owner;
45
+ directory;
46
+ transitionSink;
47
+ setTransitionSink(sink) { this.transitionSink = sink; }
48
+ io;
49
+ platform;
50
+ now;
51
+ limits;
52
+ constructor(owner, options = {}) {
53
+ this.owner = owner;
54
+ this.transitionSink = options.transitionSink;
55
+ this.directory = heldRequestDirectory(owner.did, options);
56
+ this.io = options.fs ?? fs;
57
+ this.platform = options.platform ?? process.platform;
58
+ this.now = options.now ?? Date.now;
59
+ this.limits = { ...HELD_CONTENT_BOUNDS, ...options.limits };
60
+ for (const name of ['envelopeBytes', 'records', 'totalEnvelopeBytes'])
61
+ if (!Number.isInteger(this.limits[name]) || this.limits[name] < 1 || this.limits[name] > HELD_CONTENT_BOUNDS[name])
62
+ fail();
63
+ if (options.workspaceDir !== undefined) {
64
+ const path = relative(resolve(options.workspaceDir), this.directory);
65
+ if (!path || !isAbsolute(path) && path !== '..' && !path.startsWith('..' + sep))
66
+ fail();
67
+ }
68
+ }
69
+ directories() { return [dirname(dirname(this.directory)), dirname(this.directory), this.directory]; }
70
+ path(id) { if (!idPattern.test(id))
71
+ fail(); return join(this.directory, id + '.json'); }
72
+ validate(record, id) {
73
+ if (!record || !keys(record, ['version', 'id', 'kind', 'ownerDid', 'senderOwnerDid', 'requestId', 'taskId', 'contentDigest',
74
+ 'envelopeDigest', 'receivedAt', 'expiresAt', 'state', 'envelope', 'inspectionReceipt']) || record.version !== 1 ||
75
+ record.id !== id || record.ownerDid !== this.owner.did || !kinds.includes(record.kind) ||
76
+ !identifier(record.requestId) || !identifier(record.taskId) || !isHeldDigest(record.contentDigest) ||
77
+ ![record.receivedAt, record.expiresAt].every(Number.isSafeInteger) || record.expiresAt <= record.receivedAt ||
78
+ record.expiresAt - record.receivedAt > HELD_CONTENT_BOUNDS.retentionMs ||
79
+ !['held', 'reviewable'].includes(record.state) || record.envelopeDigest !== digest(record.envelope))
80
+ fail();
81
+ resolveDid(record.senderOwnerDid);
82
+ encrypted(record.envelope, this.owner.did);
83
+ if (record.taskId !== undefined && record.taskId !== record.envelope.payload.taskId)
84
+ fail();
85
+ const receipt = record.inspectionReceipt, p = receipt?.payload;
86
+ if (receipt && (!signedShape(receipt) || !verifySigned(receipt, this.owner.did) || !p ||
87
+ !keys(p, ['type', 'v', 'recordId', 'ownerDid', 'kind', 'contentDigest', 'envelopeDigest', 'status', 'reportDigest', 'inspectedAt']) ||
88
+ p.type !== 'HeldContentInspection' || p.v !== 1 || p.recordId !== id || p.ownerDid !== this.owner.did || p.kind !== record.kind ||
89
+ p.contentDigest !== record.contentDigest || p.envelopeDigest !== record.envelopeDigest ||
90
+ !['complete', 'unavailable', 'error'].includes(p.status) || !Number.isSafeInteger(p.inspectedAt) ||
91
+ p.inspectedAt < record.receivedAt || p.inspectedAt >= record.expiresAt ||
92
+ (p.reportDigest !== undefined && !isHeldDigest(p.reportDigest)) || p.status === 'complete' && !p.reportDigest))
93
+ fail();
94
+ if ((record.state === 'reviewable') !== (p?.status === 'complete'))
95
+ fail();
96
+ const { envelope, ...metadata } = record;
97
+ if (bytes(envelope) > HELD_CONTENT_BOUNDS.envelopeBytes || bytes(metadata) + 1024 > HELD_CONTENT_BOUNDS.metadataBytes)
98
+ fail();
99
+ }
100
+ /** Returns ciphertext and signed inspection metadata, never decrypted content. */
101
+ read(id) {
102
+ const path = this.path(id);
103
+ try {
104
+ for (const directory of this.directories()) {
105
+ try {
106
+ inspectDirectory(directory, this.io, this.platform);
107
+ }
108
+ catch (e) {
109
+ if (e.code !== 'ENOENT')
110
+ throw e;
111
+ }
112
+ }
113
+ const raw = readPrivateFile(path, this.io, HELD_CONTENT_BOUNDS.envelopeBytes + HELD_CONTENT_BOUNDS.metadataBytes, this.platform);
114
+ if (raw === undefined)
115
+ return undefined;
116
+ const signed = JSON.parse(raw);
117
+ if (!signedShape(signed) || !verifySigned(signed, this.owner.did))
118
+ fail();
119
+ this.validate(signed.payload, id);
120
+ return signed.payload;
121
+ }
122
+ catch {
123
+ fail();
124
+ }
125
+ }
126
+ records() {
127
+ try {
128
+ for (const directory of this.directories()) {
129
+ try {
130
+ inspectDirectory(directory, this.io, this.platform);
131
+ }
132
+ catch (e) {
133
+ if (e.code !== 'ENOENT')
134
+ throw e;
135
+ }
136
+ }
137
+ let names;
138
+ try {
139
+ names = this.io.readdirSync(this.directory);
140
+ }
141
+ catch (e) {
142
+ if (e.code === 'ENOENT')
143
+ return [];
144
+ throw e;
145
+ }
146
+ const files = names.filter(n => n.endsWith('.json'));
147
+ if (files.length > HELD_CONTENT_BOUNDS.records)
148
+ fail();
149
+ return files.sort().map(name => this.read(name.slice(0, -5)) ?? fail());
150
+ }
151
+ catch {
152
+ fail();
153
+ }
154
+ }
155
+ list() { const now = this.now(); return this.records().map(r => heldSummary(r, now)); }
156
+ mutate(operation) {
157
+ const lock = join(this.directory, '.lock');
158
+ let locked = false;
159
+ try {
160
+ for (const directory of this.directories())
161
+ privateDirectory(directory, this.io, this.platform);
162
+ try {
163
+ writePrivateFile(lock, Buffer.alloc(0), this.io, this.platform);
164
+ locked = true;
165
+ }
166
+ catch (e) {
167
+ if (e.code === 'EEXIST')
168
+ throw new Error('QUARANTINE_BUSY');
169
+ throw e;
170
+ }
171
+ return operation(this.records());
172
+ }
173
+ catch (e) {
174
+ if (e instanceof Error && /^(QUARANTINE_|INSPECTION_|UNENCRYPTED_ENVELOPE_REJECTED$)/.test(e.message))
175
+ throw e;
176
+ throw new Error('QUARANTINE_UNWRITABLE');
177
+ }
178
+ finally {
179
+ if (locked)
180
+ this.io.unlinkSync(lock);
181
+ }
182
+ }
183
+ publish(record) {
184
+ this.validate(record, record.id);
185
+ const target = this.path(record.id), temporary = target + '.' + randomUUID() + '.tmp';
186
+ try {
187
+ writePrivateFile(temporary, Buffer.from(JSON.stringify(signPayload(record, this.owner, new Date(this.now()).toISOString())) + '\n'), this.io, this.platform);
188
+ checkPath(target, this.io, this.platform);
189
+ this.io.renameSync(temporary, target);
190
+ }
191
+ finally {
192
+ try {
193
+ this.io.unlinkSync(temporary);
194
+ }
195
+ catch (e) {
196
+ if (e.code !== 'ENOENT')
197
+ throw e;
198
+ }
199
+ }
200
+ }
201
+ /** Caller validates sender-owner delegation and the task/offer deadline before holding. Return only after publication. */
202
+ hold(request) {
203
+ let record;
204
+ try {
205
+ const now = this.now();
206
+ encrypted(request.envelope, this.owner.did);
207
+ if (!Number.isSafeInteger(request.deadline))
208
+ fail();
209
+ if (bytes(request.envelope) > this.limits.envelopeBytes)
210
+ throw new Error('QUARANTINE_FULL');
211
+ record = { version: 1, id: request.id ?? randomUUID(), kind: request.kind, ownerDid: this.owner.did,
212
+ senderOwnerDid: request.senderOwnerDid, contentDigest: request.contentDigest, envelopeDigest: digest(request.envelope),
213
+ receivedAt: now, expiresAt: Math.min(request.deadline, now + HELD_CONTENT_BOUNDS.retentionMs), state: 'held',
214
+ envelope: structuredClone(request.envelope),
215
+ ...(request.taskId === undefined ? {} : { taskId: request.taskId }),
216
+ ...(request.requestId === undefined ? {} : { requestId: request.requestId }) };
217
+ this.path(record.id);
218
+ this.validate(record, record.id);
219
+ }
220
+ catch (e) {
221
+ if (e instanceof Error && /^(QUARANTINE_|UNENCRYPTED_ENVELOPE_REJECTED$)/.test(e.message))
222
+ throw e;
223
+ fail();
224
+ }
225
+ return this.mutate(records => {
226
+ const previous = records.find(r => r.id === record.id);
227
+ if (previous) {
228
+ if (previous.expiresAt <= this.now() || previous.envelopeDigest !== record.envelopeDigest || previous.contentDigest !== record.contentDigest ||
229
+ previous.kind !== record.kind || previous.senderOwnerDid !== record.senderOwnerDid ||
230
+ previous.requestId !== record.requestId || previous.taskId !== record.taskId)
231
+ fail();
232
+ this.transitionSink?.(previous, 'held');
233
+ return heldSummary(previous, this.now());
234
+ }
235
+ this.prune(records);
236
+ const live = records.filter(r => r.expiresAt > this.now());
237
+ if (live.length >= this.limits.records || live.reduce((sum, r) => sum + bytes(r.envelope), 0) + bytes(record.envelope) > this.limits.totalEnvelopeBytes)
238
+ throw new Error('QUARANTINE_FULL');
239
+ this.publish(record);
240
+ this.transitionSink?.(record, 'held');
241
+ return heldSummary(record, this.now());
242
+ });
243
+ }
244
+ /** Commits a provider completion bound to the stored ciphertext. Does not approve a task or a connection. */
245
+ recordInspection(id, receipt) {
246
+ return this.mutate(records => {
247
+ const record = records.find(r => r.id === id && r.expiresAt > this.now());
248
+ if (!record)
249
+ throw new Error('QUARANTINE_NOT_FOUND');
250
+ if (record.state === 'reviewable')
251
+ return heldSummary(record, this.now());
252
+ record.inspectionReceipt = structuredClone(receipt);
253
+ record.state = receipt.payload.status === 'complete' ? 'reviewable' : 'held';
254
+ this.publish(record);
255
+ return heldSummary(record, this.now());
256
+ });
257
+ }
258
+ prune(records) {
259
+ const expired = records.filter(r => r.expiresAt <= this.now());
260
+ for (const r of expired) {
261
+ this.transitionSink?.(r, 'closed');
262
+ this.io.unlinkSync(this.path(r.id));
263
+ }
264
+ return expired.length;
265
+ }
266
+ expire() { return this.mutate(records => this.prune(records)); }
267
+ discard(id, cause = 'closed') {
268
+ this.path(id);
269
+ return this.mutate(records => { const record = records.find(r => r.id === id); if (!record)
270
+ return false; this.transitionSink?.(record, cause); this.io.unlinkSync(this.path(id)); return true; });
271
+ }
272
+ /** Call when a peer is blocked; connection state is managed separately. */
273
+ discardPeer(senderOwnerDid) {
274
+ return this.mutate(records => {
275
+ const matches = records.filter(r => r.senderOwnerDid === senderOwnerDid);
276
+ for (const r of matches) {
277
+ this.transitionSink?.(r, 'closed');
278
+ this.io.unlinkSync(this.path(r.id));
279
+ }
280
+ return matches.length;
281
+ });
282
+ }
283
+ clear() {
284
+ return this.mutate(records => { for (const r of records) {
285
+ this.transitionSink?.(r, 'closed');
286
+ this.io.unlinkSync(this.path(r.id));
287
+ } return records.length; });
288
+ }
289
+ }
290
+ //# sourceMappingURL=held-request-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"held-request-store.js","sourceRoot":"","sources":["../src/held-request-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import type { Json, KeyPair } from '../../core/dist/index.js';
2
+ import { DeliveryStore } from './delivery-store.js';
3
+ import type { DeliveryStoreOptions } from './delivery-store.js';
4
+ import type { IdempotencyAuthorization, PreparedIdempotentAction } from './delivery-records.js';
5
+ type Mutation = Pick<DeliveryStore, 'read' | 'write' | 'reserveIdempotencyCapacity'>;
6
+ export type IdempotencyResponse = {
7
+ isError: boolean;
8
+ value: Json;
9
+ };
10
+ export interface IdempotencyStoreOptions extends DeliveryStoreOptions {
11
+ leaseMs?: number;
12
+ }
13
+ export declare function validateIdempotencyKey(value: unknown): asserts value is string;
14
+ export declare function idempotencyKeyHash(owner: string, tool: string, key: string): string;
15
+ export declare function idempotencyFailure(error: unknown): IdempotencyResponse;
16
+ export declare function unwrapIdempotency<T>(response: IdempotencyResponse): T;
17
+ /** Remove process-local hooks and paths; retain every execution option in the fingerprint. */
18
+ export declare function runtimeIdempotencyAction(options: object, defaults?: Record<string, unknown>): Json;
19
+ /** One operation owns preparation, authorization and all fan-out children. */
20
+ export declare class IdempotencyOperation {
21
+ readonly store: IdempotencyStore;
22
+ readonly operationId: string;
23
+ readonly holderId: string;
24
+ readonly children: number;
25
+ private readonly keyHash;
26
+ private readonly ready;
27
+ private readonly waiters;
28
+ private preparationFailure?;
29
+ private prepared;
30
+ constructor(store: IdempotencyStore, operationId: string, holderId: string, children: number, keyHash: string);
31
+ private change;
32
+ prepare(action: PreparedIdempotentAction): Promise<void>;
33
+ childReady(index: number, error?: unknown): Promise<void>;
34
+ authorize(childIndex: number, evidence: IdempotencyAuthorization | void): Promise<void>;
35
+ sending(): Promise<void>;
36
+ renew(): Promise<void>;
37
+ }
38
+ /** Owner-signed operation cache sharing C1's atomic store and short signer lock. */
39
+ export declare class IdempotencyStore {
40
+ readonly records: DeliveryStore;
41
+ readonly leaseMs: number;
42
+ private readonly live;
43
+ constructor(owner: KeyPair, options?: IdempotencyStoreOptions);
44
+ /** Plan under the signer lock, write outside it, then compare before publishing. */
45
+ mutate<T>(change: (records: Mutation) => T): Promise<T>;
46
+ private storeError;
47
+ run(tool: string, key: string, action: Json, run: (operation: IdempotencyOperation) => Promise<IdempotencyResponse>, options?: {
48
+ children?: number;
49
+ deadline?: number;
50
+ }): Promise<IdempotencyResponse>;
51
+ private execute;
52
+ }
53
+ export {};