sealbridge 0.2.2 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +492 -30
- package/README.md +522 -109
- package/dist/cli/dist/accept.d.ts +13 -0
- package/dist/cli/dist/accept.js +115 -0
- package/dist/cli/dist/accept.js.map +1 -0
- package/dist/cli/dist/approval-summary.d.ts +1 -1
- package/dist/cli/dist/board.d.ts +10 -9
- package/dist/cli/dist/board.js +62 -31
- package/dist/cli/dist/board.js.map +1 -1
- package/dist/cli/dist/command-identity.d.ts +6 -0
- package/dist/cli/dist/command-identity.js +13 -0
- package/dist/cli/dist/command-identity.js.map +1 -0
- package/dist/cli/dist/config.d.ts +3 -0
- package/dist/cli/dist/config.js +29 -0
- package/dist/cli/dist/config.js.map +1 -0
- package/dist/cli/dist/connections.d.ts +15 -0
- package/dist/cli/dist/connections.js +191 -0
- package/dist/cli/dist/connections.js.map +1 -0
- package/dist/cli/dist/contacts.d.ts +4 -3
- package/dist/cli/dist/contacts.js +39 -28
- package/dist/cli/dist/contacts.js.map +1 -1
- package/dist/cli/dist/doctor.d.ts +9 -0
- package/dist/cli/dist/doctor.js +46 -5
- package/dist/cli/dist/doctor.js.map +1 -1
- package/dist/cli/dist/error-messages.js +22 -0
- package/dist/cli/dist/error-messages.js.map +1 -1
- package/dist/cli/dist/index.js +44 -6
- package/dist/cli/dist/index.js.map +1 -1
- package/dist/cli/dist/invite-output.d.ts +14 -0
- package/dist/cli/dist/invite-output.js +66 -0
- package/dist/cli/dist/invite-output.js.map +1 -0
- package/dist/cli/dist/invite-share.d.ts +6 -3
- package/dist/cli/dist/invite-share.js +40 -15
- package/dist/cli/dist/invite-share.js.map +1 -1
- package/dist/cli/dist/invites-migrate.d.ts +3 -0
- package/dist/cli/dist/invites-migrate.js +33 -0
- package/dist/cli/dist/invites-migrate.js.map +1 -0
- package/dist/cli/dist/mcp.d.ts +7 -5
- package/dist/cli/dist/mcp.js +23 -18
- package/dist/cli/dist/mcp.js.map +1 -1
- package/dist/cli/dist/network.d.ts +11 -1
- package/dist/cli/dist/network.js +150 -87
- package/dist/cli/dist/network.js.map +1 -1
- package/dist/cli/dist/pending.d.ts +8 -0
- package/dist/cli/dist/pending.js +50 -0
- package/dist/cli/dist/pending.js.map +1 -0
- package/dist/cli/dist/public-settings.d.ts +5 -4
- package/dist/cli/dist/public-settings.js +13 -15
- package/dist/cli/dist/public-settings.js.map +1 -1
- package/dist/cli/dist/receipt.d.ts +1 -1
- package/dist/cli/dist/relay-auth.d.ts +3 -0
- package/dist/cli/dist/relay-auth.js +23 -0
- package/dist/cli/dist/relay-auth.js.map +1 -0
- package/dist/cli/dist/requests.d.ts +10 -0
- package/dist/cli/dist/requests.js +91 -0
- package/dist/cli/dist/requests.js.map +1 -0
- package/dist/cli/dist/sdk.d.ts +10 -0
- package/dist/cli/dist/sdk.js +7 -0
- package/dist/cli/dist/sdk.js.map +1 -0
- package/dist/cli/dist/setup-files.d.ts +24 -0
- package/dist/cli/dist/setup-files.js +190 -0
- package/dist/cli/dist/setup-files.js.map +1 -0
- package/dist/cli/dist/setup-hosts.d.ts +29 -0
- package/dist/cli/dist/setup-hosts.js +75 -0
- package/dist/cli/dist/setup-hosts.js.map +1 -0
- package/dist/cli/dist/setup.d.ts +61 -0
- package/dist/cli/dist/setup.js +243 -0
- package/dist/cli/dist/setup.js.map +1 -0
- package/dist/cli/dist/task-input.d.ts +1 -1
- package/dist/cli/dist/wake-hook.d.ts +1 -1
- package/dist/cli/dist/worker-json.d.ts +4 -0
- package/dist/cli/dist/worker-json.js +87 -0
- package/dist/cli/dist/worker-json.js.map +1 -0
- package/dist/examples/two-owner-demo/dist/run-demo.d.ts +13 -13
- package/dist/package.json +1 -1
- package/dist/packages/adapters/dist/command.d.ts +2 -2
- package/dist/packages/adapters/dist/credential-proxy.d.ts +2 -2
- package/dist/packages/adapters/dist/index.d.ts +1 -1
- package/dist/packages/adapters/dist/mcp.d.ts +2 -2
- package/dist/packages/adapters/dist/openai.d.ts +2 -2
- package/dist/packages/adapters/dist/sandbox.d.ts +2 -2
- package/dist/packages/core/dist/connection.d.ts +58 -0
- package/dist/packages/core/dist/connection.js +132 -0
- package/dist/packages/core/dist/connection.js.map +1 -0
- package/dist/packages/core/dist/delivery-status.d.ts +22 -0
- package/dist/packages/core/dist/delivery-status.js +53 -0
- package/dist/packages/core/dist/delivery-status.js.map +1 -0
- package/dist/packages/core/dist/discovery.d.ts +7 -6
- package/dist/packages/core/dist/discovery.js +19 -20
- package/dist/packages/core/dist/discovery.js.map +1 -1
- package/dist/packages/core/dist/edge.d.ts +1 -0
- package/dist/packages/core/dist/edge.js +1 -0
- package/dist/packages/core/dist/edge.js.map +1 -1
- package/dist/packages/core/dist/index.d.ts +3 -0
- package/dist/packages/core/dist/index.js +3 -0
- package/dist/packages/core/dist/index.js.map +1 -1
- package/dist/packages/core/dist/protocol.d.ts +24 -0
- package/dist/packages/core/dist/protocol.js +54 -0
- package/dist/packages/core/dist/protocol.js.map +1 -0
- package/dist/packages/core/dist/receipts.d.ts +1 -0
- package/dist/packages/core/dist/receipts.js +1 -1
- package/dist/packages/core/dist/receipts.js.map +1 -1
- package/dist/packages/core/dist/schema.d.ts +1 -0
- package/dist/packages/core/dist/schema.js +13 -2
- package/dist/packages/core/dist/schema.js.map +1 -1
- package/dist/packages/ledger/dist/index.d.ts +1 -1
- package/dist/packages/relay/dist/admission.d.ts +14 -0
- package/dist/packages/relay/dist/admission.js +70 -0
- package/dist/packages/relay/dist/admission.js.map +1 -0
- package/dist/packages/relay/dist/fetch.d.ts +8 -2
- package/dist/packages/relay/dist/fetch.js +41 -12
- package/dist/packages/relay/dist/fetch.js.map +1 -1
- package/dist/packages/relay/dist/index.d.ts +23 -12
- package/dist/packages/relay/dist/index.js +130 -78
- package/dist/packages/relay/dist/index.js.map +1 -1
- package/dist/packages/relay/dist/journal.d.ts +1 -1
- package/dist/packages/relay/dist/notifications.d.ts +1 -1
- package/dist/packages/relay/dist/retry.d.ts +23 -0
- package/dist/packages/relay/dist/retry.js +43 -1
- package/dist/packages/relay/dist/retry.js.map +1 -1
- package/dist/packages/relay/dist/ssrf.d.ts +3 -2
- package/dist/packages/relay/dist/ssrf.js.map +1 -1
- package/dist/packages/relay/dist/worker.js +1 -1
- package/dist/packages/relay/dist/worker.js.map +1 -1
- package/dist/packages/runtime/dist/a2a.d.ts +1 -1
- package/dist/packages/runtime/dist/a2a.js +1 -1
- package/dist/packages/runtime/dist/adapter.d.ts +2 -2
- package/dist/packages/runtime/dist/application-config.d.ts +20 -0
- package/dist/packages/runtime/dist/application-config.js +218 -0
- package/dist/packages/runtime/dist/application-config.js.map +1 -0
- package/dist/packages/runtime/dist/approval-providers.d.ts +24 -3
- package/dist/packages/runtime/dist/approval-providers.js +79 -3
- package/dist/packages/runtime/dist/approval-providers.js.map +1 -1
- package/dist/packages/runtime/dist/connection-admission-review.d.ts +39 -0
- package/dist/packages/runtime/dist/connection-admission-review.js +86 -0
- package/dist/packages/runtime/dist/connection-admission-review.js.map +1 -0
- package/dist/packages/runtime/dist/connection-persistence.d.ts +35 -0
- package/dist/packages/runtime/dist/connection-persistence.js +181 -0
- package/dist/packages/runtime/dist/connection-persistence.js.map +1 -0
- package/dist/packages/runtime/dist/connection-records.d.ts +167 -0
- package/dist/packages/runtime/dist/connection-records.js +132 -0
- package/dist/packages/runtime/dist/connection-records.js.map +1 -0
- package/dist/packages/runtime/dist/connection-router.d.ts +45 -0
- package/dist/packages/runtime/dist/connection-router.js +130 -0
- package/dist/packages/runtime/dist/connection-router.js.map +1 -0
- package/dist/packages/runtime/dist/connection-service.d.ts +159 -0
- package/dist/packages/runtime/dist/connection-service.js +239 -0
- package/dist/packages/runtime/dist/connection-service.js.map +1 -0
- package/dist/packages/runtime/dist/connection-transport.d.ts +14 -0
- package/dist/packages/runtime/dist/connection-transport.js +89 -0
- package/dist/packages/runtime/dist/connection-transport.js.map +1 -0
- package/dist/packages/runtime/dist/delivery-records.d.ts +180 -0
- package/dist/packages/runtime/dist/delivery-records.js +205 -0
- package/dist/packages/runtime/dist/delivery-records.js.map +1 -0
- package/dist/packages/runtime/dist/delivery-status-router.d.ts +27 -0
- package/dist/packages/runtime/dist/delivery-status-router.js +150 -0
- package/dist/packages/runtime/dist/delivery-status-router.js.map +1 -0
- package/dist/packages/runtime/dist/delivery-status.d.ts +43 -0
- package/dist/packages/runtime/dist/delivery-status.js +193 -0
- package/dist/packages/runtime/dist/delivery-status.js.map +1 -0
- package/dist/packages/runtime/dist/delivery-store.d.ts +125 -0
- package/dist/packages/runtime/dist/delivery-store.js +1047 -0
- package/dist/packages/runtime/dist/delivery-store.js.map +1 -0
- package/dist/packages/runtime/dist/gateway.d.ts +4 -3
- package/dist/packages/runtime/dist/gateway.js.map +1 -1
- package/dist/packages/runtime/dist/held-request-review.d.ts +49 -0
- package/dist/packages/runtime/dist/held-request-review.js +122 -0
- package/dist/packages/runtime/dist/held-request-review.js.map +1 -0
- package/dist/packages/runtime/dist/held-request-store.d.ts +112 -0
- package/dist/packages/runtime/dist/held-request-store.js +290 -0
- package/dist/packages/runtime/dist/held-request-store.js.map +1 -0
- package/dist/packages/runtime/dist/idempotency-store.d.ts +53 -0
- package/dist/packages/runtime/dist/idempotency-store.js +331 -0
- package/dist/packages/runtime/dist/idempotency-store.js.map +1 -0
- package/dist/packages/runtime/dist/inbox.d.ts +1 -1
- package/dist/packages/runtime/dist/index.d.ts +27 -1
- package/dist/packages/runtime/dist/index.js +26 -0
- package/dist/packages/runtime/dist/index.js.map +1 -1
- package/dist/packages/runtime/dist/invite-store.d.ts +76 -0
- package/dist/packages/runtime/dist/invite-store.js +337 -0
- package/dist/packages/runtime/dist/invite-store.js.map +1 -0
- package/dist/packages/runtime/dist/key-store.d.ts +77 -0
- package/dist/packages/runtime/dist/key-store.js +226 -0
- package/dist/packages/runtime/dist/key-store.js.map +1 -0
- package/dist/packages/runtime/dist/local-identity.d.ts +33 -0
- package/dist/packages/runtime/dist/local-identity.js +279 -0
- package/dist/packages/runtime/dist/local-identity.js.map +1 -0
- package/dist/packages/runtime/dist/mcp-rpc.d.ts +19 -0
- package/dist/packages/runtime/dist/mcp-rpc.js +175 -0
- package/dist/packages/runtime/dist/mcp-rpc.js.map +1 -0
- package/dist/packages/runtime/dist/mcp-server.d.ts +46 -19
- package/dist/packages/runtime/dist/mcp-server.js +427 -184
- package/dist/packages/runtime/dist/mcp-server.js.map +1 -1
- package/dist/packages/runtime/dist/mcp-tool-catalog.d.ts +1 -1
- package/dist/packages/runtime/dist/mcp-tool-catalog.js +172 -13
- package/dist/packages/runtime/dist/mcp-tool-catalog.js.map +1 -1
- package/dist/packages/runtime/dist/mcp.d.ts +2 -2
- package/dist/packages/runtime/dist/message-status.d.ts +32 -0
- package/dist/packages/runtime/dist/message-status.js +29 -0
- package/dist/packages/runtime/dist/message-status.js.map +1 -0
- package/dist/packages/runtime/dist/outbox.d.ts +91 -0
- package/dist/packages/runtime/dist/outbox.js +462 -0
- package/dist/packages/runtime/dist/outbox.js.map +1 -0
- package/dist/packages/runtime/dist/policy.d.ts +1 -1
- package/dist/packages/runtime/dist/protocol-peer-store.d.ts +40 -0
- package/dist/packages/runtime/dist/protocol-peer-store.js +176 -0
- package/dist/packages/runtime/dist/protocol-peer-store.js.map +1 -0
- package/dist/packages/runtime/dist/protocol-release.d.ts +26 -0
- package/dist/packages/runtime/dist/protocol-release.js +76 -0
- package/dist/packages/runtime/dist/protocol-release.js.map +1 -0
- package/dist/packages/runtime/dist/quota.d.ts +1 -1
- package/dist/packages/runtime/dist/relay-selection.d.ts +20 -0
- package/dist/packages/runtime/dist/relay-selection.js +34 -0
- package/dist/packages/runtime/dist/relay-selection.js.map +1 -0
- package/dist/packages/runtime/dist/requester-pending-store.d.ts +59 -0
- package/dist/packages/runtime/dist/requester-pending-store.js +266 -0
- package/dist/packages/runtime/dist/requester-pending-store.js.map +1 -0
- package/dist/packages/runtime/dist/secret-store.d.ts +19 -0
- package/dist/packages/runtime/dist/secret-store.js +51 -0
- package/dist/packages/runtime/dist/secret-store.js.map +1 -0
- package/dist/packages/runtime/dist/session-audit.d.ts +29 -7
- package/dist/packages/runtime/dist/session-audit.js +149 -29
- package/dist/packages/runtime/dist/session-audit.js.map +1 -1
- package/dist/packages/runtime/dist/session.d.ts +101 -9
- package/dist/packages/runtime/dist/session.js +696 -96
- package/dist/packages/runtime/dist/session.js.map +1 -1
- package/dist/packages/runtime/dist/task-journal.d.ts +18 -3
- package/dist/packages/runtime/dist/task-journal.js +271 -18
- package/dist/packages/runtime/dist/task-journal.js.map +1 -1
- package/dist/packages/runtime/dist/verifier.d.ts +3 -2
- package/dist/packages/runtime/dist/verifier.js +1 -0
- package/dist/packages/runtime/dist/verifier.js.map +1 -1
- package/dist/packages/runtime/dist/worker-trust-store.d.ts +111 -0
- package/dist/packages/runtime/dist/worker-trust-store.js +592 -0
- package/dist/packages/runtime/dist/worker-trust-store.js.map +1 -0
- package/dist/packages/sandbox/dist/container.d.ts +1 -1
- package/dist/packages/sandbox/dist/index.d.ts +1 -1
- package/dist/spec/README.ja.md +21 -1
- package/dist/spec/README.md +20 -1
- package/dist/spec/agent-card.schema.json +11 -1
- package/dist/spec/delivery-status.schema.json +106 -0
- package/dist/spec/examples/protocol-versions/sample-agent-card.json +35 -0
- package/dist/spec/examples/sample-delivery-status.json +21 -0
- package/dist/spec/examples/sample-task-manifest.0.1.0.json +173 -0
- package/dist/spec/examples/sample-task-manifest.0.2.0.json +173 -0
- package/dist/spec/task-manifest.0.1.0.schema.json +422 -0
- package/dist/spec/task-manifest.0.2.0.schema.json +422 -0
- package/dist/spec/task-manifest.schema.json +9 -418
- package/docs/sdk.ja.md +133 -0
- package/docs/sdk.md +138 -0
- 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 {};
|