attention-manifest-protocol 0.4.2 → 0.4.4
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/CHANGELOG.md +341 -293
- package/CHANGELOG.zh-CN.md +41 -8
- package/README.md +250 -171
- package/README.zh-CN.md +251 -171
- package/lib/assignment/assign.d.ts +102 -0
- package/lib/assignment/assign.js +556 -0
- package/lib/assignment/binding.d.ts +103 -0
- package/lib/assignment/binding.js +575 -0
- package/lib/assignment/errors.d.ts +14 -0
- package/lib/assignment/errors.js +16 -0
- package/lib/assignment/guards.d.ts +18 -0
- package/lib/assignment/guards.js +28 -0
- package/lib/assignment/index.d.ts +10 -0
- package/lib/assignment/index.js +10 -0
- package/lib/assignment/types.d.ts +169 -0
- package/lib/assignment/types.js +1 -0
- package/lib/attention/budget.d.ts +1 -1
- package/lib/attention/budget.js +31 -9
- package/lib/bayes/engine.js +2 -1
- package/lib/bayes/reliability.js +25 -10
- package/lib/boundary/frame.d.ts +10 -4
- package/lib/boundary/frame.js +346 -109
- package/lib/boundary/kinds.d.ts +11 -0
- package/lib/boundary/kinds.js +33 -0
- package/lib/boundary/refTable.d.ts +19 -9
- package/lib/boundary/refTable.js +128 -30
- package/lib/boundary/toolCall.d.ts +22 -10
- package/lib/boundary/toolCall.js +798 -97
- package/lib/concept/conceptBudget.js +10 -1
- package/lib/concurrency/idempotency.d.ts +4 -3
- package/lib/concurrency/idempotency.js +57 -13
- package/lib/concurrency/retry.js +18 -3
- package/lib/context/agentContext.d.ts +13 -0
- package/lib/context/agentContext.js +14 -1
- package/lib/context/ast.d.ts +4 -1
- package/lib/context/ast.js +13 -3
- package/lib/context/contentStore.js +22 -9
- package/lib/context/contextBuilder.d.ts +457 -0
- package/lib/context/contextBuilder.js +1395 -0
- package/lib/context/contextPackage.d.ts +214 -0
- package/lib/context/contextPackage.js +191 -0
- package/lib/context/index.d.ts +14 -3
- package/lib/context/index.js +9 -1
- package/lib/context/relevance.d.ts +171 -0
- package/lib/context/relevance.js +250 -0
- package/lib/context/workspaceDiff.d.ts +105 -0
- package/lib/context/workspaceDiff.js +238 -0
- package/lib/context/workspaceService.d.ts +236 -1
- package/lib/context/workspaceService.js +1501 -73
- package/lib/cooperation/collaboration.d.ts +9 -0
- package/lib/cooperation/session.d.ts +4 -4
- package/lib/cooperation/session.js +3 -3
- package/lib/database/adapter/filesystemStore.d.ts +145 -0
- package/lib/database/adapter/filesystemStore.js +321 -0
- package/lib/database/adapter/index.d.ts +2 -0
- package/lib/database/adapter/index.js +2 -0
- package/lib/database/adapter/workspaceSessionStore.d.ts +118 -0
- package/lib/database/adapter/workspaceSessionStore.js +120 -0
- package/lib/database/entity/fileGraph.d.ts +53 -0
- package/lib/database/entity/fileGraph.js +15 -0
- package/lib/database/entity/fileTree.d.ts +76 -0
- package/lib/database/entity/fileTree.js +39 -0
- package/lib/database/entity/hook.d.ts +29 -0
- package/lib/database/entity/hook.js +18 -0
- package/lib/database/entity/index.d.ts +4 -0
- package/lib/database/entity/index.js +4 -0
- package/lib/database/entity/workspaceSession.d.ts +53 -0
- package/lib/database/entity/workspaceSession.js +28 -0
- package/lib/database/repository/fileAnnotationRepository.d.ts +75 -0
- package/lib/database/repository/fileAnnotationRepository.js +109 -0
- package/lib/database/repository/fileGraphRepository.d.ts +188 -0
- package/lib/database/repository/fileGraphRepository.js +648 -0
- package/lib/database/repository/fileNodeRepository.d.ts +116 -0
- package/lib/database/repository/fileNodeRepository.js +263 -0
- package/lib/database/repository/fileOutlineRepository.d.ts +40 -0
- package/lib/database/repository/fileOutlineRepository.js +104 -0
- package/lib/database/repository/fileWriteRepository.d.ts +41 -0
- package/lib/database/repository/fileWriteRepository.js +93 -0
- package/lib/database/repository/hookRepository.d.ts +67 -0
- package/lib/database/repository/hookRepository.js +150 -0
- package/lib/database/repository/index.d.ts +7 -0
- package/lib/database/repository/index.js +7 -0
- package/lib/database/repository/workspaceSessionRepository.d.ts +134 -0
- package/lib/database/repository/workspaceSessionRepository.js +327 -0
- package/lib/database/service/database.d.ts +14 -0
- package/lib/database/service/database.js +21 -0
- package/lib/database/sql/schema.js +187 -0
- package/lib/database/store/database.js +6 -1
- package/lib/delegate/team.d.ts +5 -0
- package/lib/delegate/team.js +83 -20
- package/lib/discover/classify.d.ts +20 -0
- package/lib/discover/classify.js +85 -0
- package/lib/discover/host.d.ts +20 -0
- package/lib/discover/host.js +89 -0
- package/lib/discover/index.d.ts +11 -0
- package/lib/discover/index.js +11 -0
- package/lib/discover/kinds.d.ts +14 -0
- package/lib/discover/kinds.js +23 -0
- package/lib/discover/tree.d.ts +7 -0
- package/lib/discover/tree.js +432 -0
- package/lib/discover/types.d.ts +115 -0
- package/lib/discover/types.js +1 -0
- package/lib/error/boundaryRejection.d.ts +1 -1
- package/lib/evaluation/agreement.js +2 -2
- package/lib/execution/handles.js +6 -0
- package/lib/execution/pin.js +2 -2
- package/lib/file/cfb.d.ts +56 -0
- package/lib/file/cfb.js +396 -0
- package/lib/file/dependency.d.ts +151 -0
- package/lib/file/dependency.js +568 -0
- package/lib/file/directory.d.ts +34 -0
- package/lib/file/directory.js +141 -0
- package/lib/file/errors.d.ts +20 -0
- package/lib/file/errors.js +18 -0
- package/lib/file/exportGraph.d.ts +31 -0
- package/lib/file/exportGraph.js +554 -0
- package/lib/file/file.d.ts +40 -0
- package/lib/file/file.js +339 -0
- package/lib/file/importGraph.d.ts +121 -0
- package/lib/file/importGraph.js +1022 -0
- package/lib/file/index.d.ts +45 -0
- package/lib/file/index.js +30 -0
- package/lib/file/metadata.d.ts +66 -0
- package/lib/file/metadata.js +470 -0
- package/lib/file/path.d.ts +60 -0
- package/lib/file/path.js +259 -0
- package/lib/file/read.d.ts +168 -0
- package/lib/file/read.js +541 -0
- package/lib/file/runtime.d.ts +95 -0
- package/lib/file/runtime.js +150 -0
- package/lib/file/service.d.ts +227 -0
- package/lib/file/service.js +663 -0
- package/lib/file/syntaxTree.d.ts +7 -0
- package/lib/file/syntaxTree.js +38 -0
- package/lib/file/time.d.ts +38 -0
- package/lib/file/time.js +44 -0
- package/lib/file/tree.d.ts +53 -0
- package/lib/file/tree.js +417 -0
- package/lib/file/types.d.ts +371 -0
- package/lib/file/types.js +1 -0
- package/lib/file/write.d.ts +159 -0
- package/lib/file/write.js +1028 -0
- package/lib/file/zip.d.ts +35 -0
- package/lib/file/zip.js +349 -0
- package/lib/fingerprint/algorithm.d.ts +97 -0
- package/lib/fingerprint/algorithm.js +271 -0
- package/lib/fingerprint/bytes.d.ts +18 -0
- package/lib/fingerprint/bytes.js +31 -0
- package/lib/fingerprint/error.d.ts +73 -0
- package/lib/fingerprint/error.js +86 -0
- package/lib/fingerprint/file.d.ts +71 -0
- package/lib/fingerprint/file.js +254 -0
- package/lib/fingerprint/index.d.ts +37 -0
- package/lib/fingerprint/index.js +12 -0
- package/lib/fingerprint/json.d.ts +41 -0
- package/lib/fingerprint/json.js +94 -0
- package/lib/fingerprint/number.d.ts +32 -0
- package/lib/fingerprint/number.js +95 -0
- package/lib/fingerprint/policy.d.ts +54 -0
- package/lib/fingerprint/policy.js +50 -0
- package/lib/fingerprint/preimage.d.ts +84 -0
- package/lib/fingerprint/preimage.js +133 -0
- package/lib/fingerprint/raw.d.ts +26 -0
- package/lib/fingerprint/raw.js +45 -0
- package/lib/fingerprint/ref.d.ts +39 -0
- package/lib/fingerprint/ref.js +178 -0
- package/lib/fingerprint/text.d.ts +42 -0
- package/lib/fingerprint/text.js +155 -0
- package/lib/fingerprint/tree.d.ts +56 -0
- package/lib/fingerprint/tree.js +288 -0
- package/lib/fingerprint/verify.d.ts +20 -0
- package/lib/fingerprint/verify.js +99 -0
- package/lib/global/filesystem.d.ts +43 -0
- package/lib/global/filesystem.js +75 -0
- package/lib/global/index.d.ts +8 -0
- package/lib/global/index.js +8 -0
- package/lib/global/service.d.ts +51 -0
- package/lib/global/service.js +98 -0
- package/lib/governance/transport.js +18 -6
- package/lib/hook/ast.d.ts +29 -0
- package/lib/hook/ast.js +22 -0
- package/lib/hook/code.d.ts +55 -0
- package/lib/hook/code.js +47 -0
- package/lib/hook/dependency.d.ts +45 -0
- package/lib/hook/dependency.js +28 -0
- package/lib/hook/diff.d.ts +114 -0
- package/lib/hook/diff.js +327 -0
- package/lib/hook/exportation.d.ts +31 -0
- package/lib/hook/exportation.js +24 -0
- package/lib/hook/file.d.ts +44 -0
- package/lib/hook/file.js +154 -0
- package/lib/hook/importation.d.ts +33 -0
- package/lib/hook/importation.js +22 -0
- package/lib/hook/index.d.ts +30 -0
- package/lib/hook/index.js +23 -0
- package/lib/hook/outline.d.ts +35 -0
- package/lib/hook/outline.js +27 -0
- package/lib/hook/project.d.ts +65 -0
- package/lib/hook/project.js +217 -0
- package/lib/hook/types.d.ts +114 -0
- package/lib/hook/types.js +407 -0
- package/lib/index.d.ts +9 -0
- package/lib/index.js +9 -0
- package/lib/lock/lease.js +28 -3
- package/lib/manifest/cardSign.d.ts +1 -1
- package/lib/manifest/cardSign.js +37 -7
- package/lib/manifest/federation.js +13 -6
- package/lib/manifest/trust.d.ts +2 -0
- package/lib/manifest/trust.js +27 -6
- package/lib/module/index.d.ts +4 -0
- package/lib/module/index.js +4 -0
- package/lib/module/mcp/client.js +21 -2
- package/lib/module/mcp/filesystemServer.d.ts +24 -0
- package/lib/module/mcp/filesystemServer.js +102 -0
- package/lib/module/mcp/http.js +32 -19
- package/lib/module/mcp/workspaceServer.js +20 -3
- package/lib/module/tool/filesystemExecutor.d.ts +18 -0
- package/lib/module/tool/filesystemExecutor.js +49 -0
- package/lib/module/tool/globalExecutor.d.ts +17 -0
- package/lib/module/tool/globalExecutor.js +39 -0
- package/lib/module/tool/globalFilesystemExecutor.d.ts +18 -0
- package/lib/module/tool/globalFilesystemExecutor.js +49 -0
- package/lib/module/tool/workspaceExecutor.d.ts +9 -0
- package/lib/module/tool/workspaceExecutor.js +16 -3
- package/lib/naming/aliases.d.ts +48 -0
- package/lib/naming/aliases.js +79 -0
- package/lib/naming/catalog.d.ts +117 -0
- package/lib/naming/catalog.js +108 -0
- package/lib/naming/grammar.d.ts +67 -0
- package/lib/naming/grammar.js +212 -0
- package/lib/naming/ids.d.ts +157 -0
- package/lib/naming/ids.js +119 -0
- package/lib/naming/index.d.ts +13 -0
- package/lib/naming/index.js +13 -0
- package/lib/outline/index.d.ts +9 -0
- package/lib/outline/index.js +8 -0
- package/lib/outline/office.d.ts +160 -0
- package/lib/outline/office.js +2375 -0
- package/lib/outline/officeBridge.d.ts +32 -0
- package/lib/outline/officeBridge.js +27 -0
- package/lib/outline/outline.d.ts +159 -0
- package/lib/outline/outline.js +837 -0
- package/lib/outline/outlineIndex.d.ts +97 -0
- package/lib/outline/outlineIndex.js +325 -0
- package/lib/outline/outlineKeywords.d.ts +59 -0
- package/lib/outline/outlineKeywords.js +143 -0
- package/lib/outline/outlineStrategies.d.ts +414 -0
- package/lib/outline/outlineStrategies.js +8324 -0
- package/lib/outline/reactOutline.d.ts +37 -0
- package/lib/outline/reactOutline.js +1070 -0
- package/lib/outline/shellOutline.d.ts +65 -0
- package/lib/outline/shellOutline.js +873 -0
- package/lib/outline/sqlOutline.d.ts +170 -0
- package/lib/outline/sqlOutline.js +1536 -0
- package/lib/outline/strategy.d.ts +46 -0
- package/lib/outline/strategy.js +1 -0
- package/lib/outline/types.d.ts +95 -0
- package/lib/outline/types.js +1 -0
- package/lib/outline/visualBasicOutline.d.ts +27 -0
- package/lib/outline/visualBasicOutline.js +750 -0
- package/lib/protocol/filesystem.d.ts +55 -0
- package/lib/protocol/filesystem.js +105 -0
- package/lib/protocol/global.d.ts +42 -0
- package/lib/protocol/global.js +63 -0
- package/lib/protocol/globalFilesystem.d.ts +40 -0
- package/lib/protocol/globalFilesystem.js +59 -0
- package/lib/protocol/index.d.ts +4 -0
- package/lib/protocol/index.js +4 -0
- package/lib/protocol/protocol.d.ts +4 -0
- package/lib/protocol/wire.js +5 -2
- package/lib/protocol/workspace.d.ts +305 -0
- package/lib/protocol/workspace.js +258 -0
- package/lib/receipt/receipt.d.ts +8 -0
- package/lib/registry/content.js +9 -3
- package/lib/runtime/kernelRuntime.js +9 -1
- package/lib/scenario/scenario.js +5 -4
- package/lib/semantic/canonical.d.ts +61 -0
- package/lib/semantic/canonical.js +135 -8
- package/lib/semantic/jsonValue.d.ts +31 -0
- package/lib/semantic/jsonValue.js +122 -0
- package/lib/semantic/sha256.js +3 -0
- package/lib/semantic/time.d.ts +14 -0
- package/lib/semantic/time.js +56 -0
- package/lib/session/context.d.ts +76 -0
- package/lib/session/context.js +419 -0
- package/lib/session/errors.d.ts +24 -0
- package/lib/session/errors.js +22 -0
- package/lib/session/identity.d.ts +24 -0
- package/lib/session/identity.js +56 -0
- package/lib/session/index.d.ts +14 -0
- package/lib/session/index.js +12 -0
- package/lib/session/registry.d.ts +130 -0
- package/lib/session/registry.js +908 -0
- package/lib/session/types.d.ts +227 -0
- package/lib/session/types.js +14 -0
- package/lib/structure/index.d.ts +1 -0
- package/lib/structure/index.js +1 -0
- package/lib/structure/trie.d.ts +88 -0
- package/lib/structure/trie.js +183 -0
- package/lib/syntax/byteIndex.d.ts +44 -0
- package/lib/syntax/byteIndex.js +148 -0
- package/lib/syntax/charset.d.ts +88 -0
- package/lib/syntax/charset.js +276 -0
- package/lib/syntax/index.d.ts +6 -0
- package/lib/syntax/index.js +5 -0
- package/lib/syntax/syntaxRegistry.d.ts +150 -0
- package/lib/syntax/syntaxRegistry.js +314 -0
- package/lib/syntax/syntaxTree.d.ts +106 -0
- package/lib/syntax/syntaxTree.js +668 -0
- package/lib/syntax/types.d.ts +15 -0
- package/lib/syntax/types.js +1 -0
- package/lib/types/common.d.ts +1 -1
- package/package.json +72 -193
- package/.editorconfig +0 -12
- package/.prettierignore +0 -17
- package/MCP-Token/347/250/216/344/270/216/344/270/213/344/270/200/344/273/243/345/267/245/345/205/267/345/215/217/350/256/256.html +0 -1763
- package/docs/annotation-campaign-A.csv +0 -54
- package/docs/annotation-campaign-B.csv +0 -54
- package/docs/annotation-campaign.csv +0 -54
- package/docs/eval/annotations-A.jsonl +0 -16
- package/docs/eval/annotations.json +0 -122
- package/docs/eval/recorded-labels.json +0 -12
- package/docs/eval/replay-cases.json +0 -14
- package/docs/eval/replay-labels-b.json +0 -14
- package/docs/examples/attention-request.json +0 -16
- package/docs/examples/checkpoint.json +0 -15
- package/docs/examples/claim.json +0 -66
- package/docs/examples/collaboration.json +0 -66
- package/docs/examples/concept-checkpoint.json +0 -15
- package/docs/examples/concept-prune-plan.json +0 -45
- package/docs/examples/federation.json +0 -126
- package/docs/examples/frame-chain.json +0 -77
- package/docs/examples/ledger-snapshot.json +0 -108
- package/docs/examples/manifest.json +0 -77
- package/docs/examples/message.json +0 -19
- package/docs/examples/other-model.json +0 -45
- package/docs/examples/plan.json +0 -50
- package/docs/examples/prune-plan.json +0 -48
- package/docs/examples/receipt.json +0 -22
- package/docs/examples/runtime-run.json +0 -573
- package/docs/examples/team.json +0 -66
- package/docs/examples/verb-note.json +0 -11
- package/docs/probes/bayes-scores.json +0 -1452
- package/docs/probes/calibration-imported.json +0 -141
- package/docs/probes/context-ast-deepseek.json +0 -1577
- package/docs/probes/deepseek-probe.json +0 -917
- package/docs/probes/eval-recorded-replay.json +0 -597
- package/docs/probes/eval-replay.json +0 -124
- package/docs/probes/eval-summary.json +0 -42
- package/docs/probes/runtime-eval.json +0 -4230
- package/eslint.config.mts +0 -96
- package/index.html +0 -13
- package/prettier.config.mts +0 -37
- package/public/favicon.svg +0 -1
- package/public/icons.svg +0 -24
- package/src/attention/attention.ts +0 -347
- package/src/attention/budget.ts +0 -72
- package/src/attention/cognition.ts +0 -519
- package/src/attention/index.ts +0 -8
- package/src/attention/interrupts.ts +0 -228
- package/src/attention/resource.ts +0 -316
- package/src/attention/social.ts +0 -217
- package/src/attention/socialTypes.ts +0 -115
- package/src/authz/authz.ts +0 -305
- package/src/authz/index.ts +0 -1
- package/src/bayes/calibration.ts +0 -204
- package/src/bayes/calibrationRegistry.ts +0 -111
- package/src/bayes/calibrationSelection.ts +0 -154
- package/src/bayes/engine.ts +0 -532
- package/src/bayes/index.ts +0 -6
- package/src/bayes/reliability.ts +0 -62
- package/src/bayes/scopedPriors.ts +0 -88
- package/src/boundary/frame.ts +0 -322
- package/src/boundary/ids.ts +0 -14
- package/src/boundary/index.ts +0 -12
- package/src/boundary/refTable.ts +0 -125
- package/src/boundary/toolCall.ts +0 -212
- package/src/concept/concept.ts +0 -75
- package/src/concept/conceptBudget.ts +0 -346
- package/src/concept/conceptBudgetTypes.ts +0 -79
- package/src/concept/index.ts +0 -3
- package/src/concurrency/idempotency.ts +0 -41
- package/src/concurrency/index.ts +0 -5
- package/src/concurrency/mutex.ts +0 -26
- package/src/concurrency/namedLocks.ts +0 -35
- package/src/concurrency/retry.ts +0 -50
- package/src/concurrency/worker.ts +0 -128
- package/src/context/agentContext.ts +0 -308
- package/src/context/ast.ts +0 -499
- package/src/context/contentStore.ts +0 -75
- package/src/context/context.ts +0 -65
- package/src/context/contextIndex.ts +0 -85
- package/src/context/document.ts +0 -137
- package/src/context/fileStorePath.ts +0 -14
- package/src/context/index.ts +0 -43
- package/src/context/lifecycle.ts +0 -221
- package/src/context/projections.ts +0 -151
- package/src/context/workspace.ts +0 -422
- package/src/context/workspaceProtocol.ts +0 -112
- package/src/context/workspaceService.ts +0 -423
- package/src/cooperation/board.ts +0 -104
- package/src/cooperation/collaboration.ts +0 -60
- package/src/cooperation/index.ts +0 -6
- package/src/cooperation/merge.ts +0 -190
- package/src/cooperation/metrics.ts +0 -57
- package/src/cooperation/session.ts +0 -131
- package/src/cooperation/unified.ts +0 -56
- package/src/counter.ts +0 -9
- package/src/database/adapter/adapters.ts +0 -35
- package/src/database/adapter/index.ts +0 -4
- package/src/database/adapter/runtimeSink.ts +0 -74
- package/src/database/adapter/sessionStore.ts +0 -32
- package/src/database/adapter/turnStore.ts +0 -23
- package/src/database/entity/agent.ts +0 -199
- package/src/database/entity/entity.ts +0 -1046
- package/src/database/entity/handle.ts +0 -79
- package/src/database/entity/index.ts +0 -32
- package/src/database/entity/message.ts +0 -74
- package/src/database/entity/meta.ts +0 -11
- package/src/database/entity/object.ts +0 -42
- package/src/database/entity/outbox.ts +0 -15
- package/src/database/entity/process.ts +0 -65
- package/src/database/entity/registry.ts +0 -155
- package/src/database/entity/runtimeApproval.ts +0 -30
- package/src/database/entity/runtimeSession.ts +0 -13
- package/src/database/entity/runtimeTurn.ts +0 -15
- package/src/database/entity/thread.ts +0 -85
- package/src/database/entity/window.ts +0 -85
- package/src/database/entity/worker.ts +0 -90
- package/src/database/index.ts +0 -6
- package/src/database/repository/addressSpaceRepository.ts +0 -72
- package/src/database/repository/agentRepository.ts +0 -460
- package/src/database/repository/base.ts +0 -41
- package/src/database/repository/executionRepository.ts +0 -477
- package/src/database/repository/handleRepository.ts +0 -64
- package/src/database/repository/index.ts +0 -20
- package/src/database/repository/messageRepository.ts +0 -52
- package/src/database/repository/objectRepository.ts +0 -69
- package/src/database/repository/outboxRepository.ts +0 -63
- package/src/database/repository/processRepository.ts +0 -58
- package/src/database/repository/registryRepository.ts +0 -119
- package/src/database/repository/repository.ts +0 -491
- package/src/database/repository/runtimeApprovalRepository.ts +0 -44
- package/src/database/repository/runtimeSessionRepository.ts +0 -27
- package/src/database/repository/runtimeTurnRepository.ts +0 -39
- package/src/database/repository/socialRepository.ts +0 -185
- package/src/database/repository/threadRepository.ts +0 -57
- package/src/database/repository/windowRepository.ts +0 -88
- package/src/database/repository/workerRepository.ts +0 -69
- package/src/database/service/database.ts +0 -90
- package/src/database/service/handleService.ts +0 -48
- package/src/database/service/index.ts +0 -16
- package/src/database/service/messageService.ts +0 -61
- package/src/database/service/objectService.ts +0 -59
- package/src/database/service/processService.ts +0 -61
- package/src/database/service/registryServices.ts +0 -88
- package/src/database/service/service.ts +0 -183
- package/src/database/service/stepService.ts +0 -53
- package/src/database/service/threadService.ts +0 -65
- package/src/database/service/windowService.ts +0 -30
- package/src/database/service/workerService.ts +0 -57
- package/src/database/sql/index.ts +0 -3
- package/src/database/sql/schema.ts +0 -418
- package/src/database/sql/sql.ts +0 -543
- package/src/database/store/database.ts +0 -210
- package/src/database/store/index.ts +0 -3
- package/src/database/store/store.ts +0 -266
- package/src/delegate/index.ts +0 -2
- package/src/delegate/team.ts +0 -268
- package/src/delegate/teamTypes.ts +0 -47
- package/src/diagnosis/checklist.ts +0 -74
- package/src/diagnosis/context.ts +0 -93
- package/src/diagnosis/frame.ts +0 -256
- package/src/diagnosis/index.ts +0 -5
- package/src/diagnosis/router.ts +0 -72
- package/src/diagnosis/types.ts +0 -89
- package/src/error/agentError.ts +0 -16
- package/src/error/ampError.ts +0 -20
- package/src/error/authzError.ts +0 -14
- package/src/error/boundaryRejection.ts +0 -20
- package/src/error/index.ts +0 -7
- package/src/error/kernelError.ts +0 -27
- package/src/error/mailboxError.ts +0 -9
- package/src/error/windowError.ts +0 -12
- package/src/evaluation/agreement.ts +0 -96
- package/src/evaluation/index.ts +0 -2
- package/src/evaluation/labels.ts +0 -241
- package/src/evidence/evidenceGraph.ts +0 -205
- package/src/evidence/index.ts +0 -4
- package/src/evidence/revalidation.ts +0 -191
- package/src/execution/exec.ts +0 -408
- package/src/execution/handles.ts +0 -65
- package/src/execution/index.ts +0 -3
- package/src/execution/pin.ts +0 -154
- package/src/frame/frame.ts +0 -70
- package/src/frame/index.ts +0 -1
- package/src/goal/goal.ts +0 -43
- package/src/goal/index.ts +0 -2
- package/src/goal/plan.ts +0 -196
- package/src/governance/attentionManifest.ts +0 -802
- package/src/governance/audit.ts +0 -362
- package/src/governance/budget.ts +0 -628
- package/src/governance/context.ts +0 -356
- package/src/governance/control.ts +0 -159
- package/src/governance/cooperation.ts +0 -479
- package/src/governance/credential.ts +0 -359
- package/src/governance/httpServer.ts +0 -99
- package/src/governance/index.ts +0 -32
- package/src/governance/legal.ts +0 -574
- package/src/governance/matrix.ts +0 -460
- package/src/governance/perspectives.ts +0 -406
- package/src/governance/signing.ts +0 -407
- package/src/governance/store.ts +0 -125
- package/src/governance/switching.ts +0 -459
- package/src/governance/toolPolicy.ts +0 -80
- package/src/governance/transport.ts +0 -204
- package/src/governance/types.ts +0 -380
- package/src/governance/workflow.ts +0 -743
- package/src/index.ts +0 -11
- package/src/interaction/index.ts +0 -1
- package/src/interaction/interaction.ts +0 -391
- package/src/ipc/index.ts +0 -4
- package/src/ipc/mailbox.ts +0 -132
- package/src/ipc/memorySocialStore.ts +0 -93
- package/src/ipc/social.ts +0 -93
- package/src/kernel/index.ts +0 -14
- package/src/kernel/scheduler.ts +0 -498
- package/src/ledger/checkpoint.ts +0 -304
- package/src/ledger/index.ts +0 -4
- package/src/ledger/ledger.ts +0 -31
- package/src/ledger/persistence.ts +0 -159
- package/src/ledger/share.ts +0 -80
- package/src/lock/index.ts +0 -2
- package/src/lock/lease.ts +0 -74
- package/src/main.ts +0 -199
- package/src/manifest/agentCard.ts +0 -72
- package/src/manifest/cardSign.ts +0 -87
- package/src/manifest/federation.ts +0 -237
- package/src/manifest/federationTypes.ts +0 -55
- package/src/manifest/index.ts +0 -8
- package/src/manifest/keys.ts +0 -643
- package/src/manifest/manifest.ts +0 -114
- package/src/manifest/sign.ts +0 -134
- package/src/manifest/trust.ts +0 -146
- package/src/mission/index.ts +0 -2
- package/src/mission/missionQueue.ts +0 -75
- package/src/module/index.ts +0 -9
- package/src/module/llm/deepseek.ts +0 -214
- package/src/module/llm/llm.ts +0 -84
- package/src/module/mcp/client.ts +0 -110
- package/src/module/mcp/http.ts +0 -102
- package/src/module/mcp/protocol.ts +0 -77
- package/src/module/mcp/server.ts +0 -148
- package/src/module/mcp/transport.ts +0 -30
- package/src/module/mcp/workspaceServer.ts +0 -111
- package/src/module/sandbox/sandbox.ts +0 -29
- package/src/module/tool/mcpExecutor.ts +0 -54
- package/src/module/tool/policy.ts +0 -52
- package/src/module/tool/redact.ts +0 -29
- package/src/module/tool/tool.ts +0 -53
- package/src/module/tool/workspaceExecutor.ts +0 -35
- package/src/policy/guard.ts +0 -240
- package/src/policy/index.ts +0 -2
- package/src/policy/policy.ts +0 -561
- package/src/process/agent.ts +0 -341
- package/src/process/agentService.ts +0 -236
- package/src/process/agentStore.ts +0 -378
- package/src/process/executionStore.ts +0 -151
- package/src/process/index.ts +0 -5
- package/src/process/process.ts +0 -240
- package/src/process/transitions.ts +0 -19
- package/src/progress/index.ts +0 -2
- package/src/progress/progress.ts +0 -85
- package/src/protocol/a2a.ts +0 -120
- package/src/protocol/channel.ts +0 -44
- package/src/protocol/envelope.ts +0 -655
- package/src/protocol/httpChannel.ts +0 -87
- package/src/protocol/index.ts +0 -6
- package/src/protocol/protocol.ts +0 -138
- package/src/protocol/wire.ts +0 -60
- package/src/receipt/index.ts +0 -1
- package/src/receipt/receipt.ts +0 -47
- package/src/registry/content.ts +0 -69
- package/src/registry/index.ts +0 -23
- package/src/registry/registry.ts +0 -599
- package/src/runtime/action.ts +0 -87
- package/src/runtime/behavior.ts +0 -330
- package/src/runtime/behaviorTuning.ts +0 -163
- package/src/runtime/cognitiveRuntime.ts +0 -703
- package/src/runtime/escalation.ts +0 -35
- package/src/runtime/governedTask.ts +0 -233
- package/src/runtime/index.ts +0 -15
- package/src/runtime/kernelRuntime.ts +0 -144
- package/src/runtime/operation.ts +0 -35
- package/src/runtime/replay.ts +0 -71
- package/src/runtime/routing.ts +0 -58
- package/src/runtime/safety.ts +0 -48
- package/src/runtime/session.ts +0 -341
- package/src/runtime/sessionStore.ts +0 -43
- package/src/runtime/telemetry.ts +0 -55
- package/src/runtime/turnStore.ts +0 -30
- package/src/scenario/index.ts +0 -1
- package/src/scenario/scenario.ts +0 -299
- package/src/semantic/canonical.ts +0 -24
- package/src/semantic/index.ts +0 -2
- package/src/semantic/sha256.ts +0 -82
- package/src/storage/appendLog.ts +0 -372
- package/src/storage/fileAppendSink.ts +0 -40
- package/src/storage/index.ts +0 -2
- package/src/store/bindCache.ts +0 -22
- package/src/store/cache.ts +0 -191
- package/src/store/context.ts +0 -31
- package/src/store/handleStore.ts +0 -31
- package/src/store/index.ts +0 -9
- package/src/store/messageStore.ts +0 -31
- package/src/store/objectStore.ts +0 -31
- package/src/store/processStore.ts +0 -31
- package/src/store/threadStore.ts +0 -31
- package/src/store/windowStore.ts +0 -31
- package/src/structure/abstractSyntaxTree.ts +0 -493
- package/src/structure/avlTree.ts +0 -408
- package/src/structure/binarySearchTree.ts +0 -352
- package/src/structure/binaryTree.ts +0 -525
- package/src/structure/bloomFilter.ts +0 -231
- package/src/structure/compare.ts +0 -110
- package/src/structure/cuckooFilter.ts +0 -337
- package/src/structure/deque.ts +0 -223
- package/src/structure/filterKey.ts +0 -36
- package/src/structure/hash.ts +0 -279
- package/src/structure/heap.ts +0 -268
- package/src/structure/index.ts +0 -20
- package/src/structure/iterator.ts +0 -22
- package/src/structure/lru.ts +0 -619
- package/src/structure/ordered.ts +0 -399
- package/src/structure/priority.ts +0 -915
- package/src/structure/queue.ts +0 -168
- package/src/structure/redBlackTree.ts +0 -680
- package/src/structure/segmentTree.ts +0 -248
- package/src/structure/stack.ts +0 -118
- package/src/structure/unordered.ts +0 -407
- package/src/style.css +0 -278
- package/src/thread/index.ts +0 -2
- package/src/thread/thread.ts +0 -176
- package/src/thread/transitions.ts +0 -17
- package/src/types/common.ts +0 -119
- package/src/types/index.ts +0 -23
- package/src/warrant/epistemic.ts +0 -154
- package/src/warrant/index.ts +0 -3
- package/src/warrant/inquiry.ts +0 -166
- package/src/warrant/warrant.ts +0 -179
- package/src/window/compaction.ts +0 -403
- package/src/window/compactionTypes.ts +0 -119
- package/src/window/index.ts +0 -7
- package/src/window/page.ts +0 -18
- package/src/window/window.ts +0 -244
- package/tools/_helpers.ts +0 -34
- package/tools/a2a-check.ts +0 -110
- package/tools/a2a-flow-check.ts +0 -78
- package/tools/agent-card-check.ts +0 -76
- package/tools/agent-check.ts +0 -236
- package/tools/agent-store-check.ts +0 -153
- package/tools/agreement-check.ts +0 -27
- package/tools/annotation-server-check.ts +0 -48
- package/tools/annotation-server.ts +0 -230
- package/tools/annotation-status.ts +0 -65
- package/tools/approval-access-check.ts +0 -66
- package/tools/arch-check.ts +0 -72
- package/tools/attention-core-check.ts +0 -48
- package/tools/attention-resource-check.ts +0 -169
- package/tools/audit-check.ts +0 -207
- package/tools/authority-check.ts +0 -124
- package/tools/authz-check.ts +0 -138
- package/tools/bayes-check.ts +0 -162
- package/tools/bayes-probe.ts +0 -154
- package/tools/behavior-tuning-check.ts +0 -53
- package/tools/board-check.ts +0 -87
- package/tools/boundary-check.ts +0 -199
- package/tools/bundle-trust-check.ts +0 -96
- package/tools/calibrate-imported.ts +0 -108
- package/tools/calibration-check.ts +0 -44
- package/tools/calibration-registry-check.ts +0 -40
- package/tools/calibration-sim.ts +0 -40
- package/tools/card-sign-check.ts +0 -71
- package/tools/card-trust-check.ts +0 -78
- package/tools/channel-check.ts +0 -86
- package/tools/checkpoint-check.ts +0 -620
- package/tools/cleanup-style-configs.ts +0 -29
- package/tools/cognition-check.ts +0 -648
- package/tools/cognitive-runtime-check.ts +0 -609
- package/tools/collaboration-demo.ts +0 -78
- package/tools/compaction-check.ts +0 -266
- package/tools/concept-check.ts +0 -260
- package/tools/concurrency-check.ts +0 -242
- package/tools/conformance-runtime.ts +0 -389
- package/tools/conformance.ts +0 -651
- package/tools/context-ast-check.ts +0 -90
- package/tools/context-ast-deepseek.ts +0 -242
- package/tools/context-graph-bench.ts +0 -50
- package/tools/context-graph-check.ts +0 -229
- package/tools/context-index-check.ts +0 -48
- package/tools/context-lifecycle-check.ts +0 -69
- package/tools/context-projection-check.ts +0 -73
- package/tools/context-scope-check.ts +0 -134
- package/tools/context-storage-check.ts +0 -113
- package/tools/cooperation-check.ts +0 -517
- package/tools/cooperation-http-check.ts +0 -125
- package/tools/deepseek-llm-check.ts +0 -147
- package/tools/deepseek-probe.ts +0 -494
- package/tools/diagnosis-check.ts +0 -109
- package/tools/diagnosis-router-check.ts +0 -50
- package/tools/document-context-check.ts +0 -237
- package/tools/envelope-check.ts +0 -659
- package/tools/eslint-rules/index.ts +0 -26
- package/tools/eslint-rules/rules/jsdoc-comment-format.ts +0 -105
- package/tools/eslint-rules/rules/no-function-keyword.ts +0 -60
- package/tools/eslint-rules/rules/no-multiline-parameters.ts +0 -71
- package/tools/eslint-rules/rules/no-multiline-type-parameters.ts +0 -57
- package/tools/eslint-rules/rules/no-undefined-comparison.ts +0 -115
- package/tools/eslint-rules/rules/prefer-template-for-string-conversion.ts +0 -97
- package/tools/eslint-rules/rules/require-typeof-parentheses.ts +0 -49
- package/tools/eslint-rules/rules/require-variable-type.ts +0 -36
- package/tools/eslint-rules/rules/variable-naming.ts +0 -175
- package/tools/eval-recorded-replay.ts +0 -215
- package/tools/eval-replay.ts +0 -139
- package/tools/eval-summary.ts +0 -136
- package/tools/evidence-revalidation-check.ts +0 -235
- package/tools/exec-check.ts +0 -217
- package/tools/federation-check.ts +0 -166
- package/tools/federation-demo.ts +0 -45
- package/tools/filter-check.ts +0 -243
- package/tools/governance-check.ts +0 -680
- package/tools/governance-store-check.ts +0 -131
- package/tools/governed-task-check.ts +0 -227
- package/tools/guard-check.ts +0 -122
- package/tools/http-channel-check.ts +0 -125
- package/tools/import-campaign.ts +0 -28
- package/tools/inquiry-check.ts +0 -126
- package/tools/interaction-check.ts +0 -171
- package/tools/interrupts-check.ts +0 -173
- package/tools/ipc-check.ts +0 -170
- package/tools/kernel-async-check.ts +0 -136
- package/tools/kernel-check.ts +0 -369
- package/tools/kernel-runtime-check.ts +0 -276
- package/tools/keys-check.ts +0 -559
- package/tools/label-audit.ts +0 -70
- package/tools/labels-workflow-check.ts +0 -49
- package/tools/linear-structure-check.ts +0 -524
- package/tools/live-exec.ts +0 -62
- package/tools/live-governance-eval.ts +0 -813
- package/tools/live-legacy.ts +0 -50
- package/tools/lru-check.ts +0 -182
- package/tools/make-annotation-campaign.ts +0 -57
- package/tools/mcp-executor-check.ts +0 -33
- package/tools/merge-annotations.ts +0 -32
- package/tools/merge-check.ts +0 -98
- package/tools/metrics-check.ts +0 -84
- package/tools/net-probe.ts +0 -107
- package/tools/oauth-probe.ts +0 -117
- package/tools/outbox-check.ts +0 -50
- package/tools/persistence-check.ts +0 -144
- package/tools/pin-check.ts +0 -116
- package/tools/platform-check.ts +0 -281
- package/tools/policy-check.ts +0 -514
- package/tools/prettier-plugin/index.mts +0 -84
- package/tools/priority-check.ts +0 -627
- package/tools/probe-context7.ts +0 -63
- package/tools/registry-check.ts +0 -252
- package/tools/reliability-check.ts +0 -25
- package/tools/retry-check.ts +0 -85
- package/tools/rewrite-declaration-extensions.ts +0 -98
- package/tools/runtime-check.ts +0 -165
- package/tools/runtime-deepseek-check.ts +0 -85
- package/tools/runtime-eval.ts +0 -358
- package/tools/scenario-check.ts +0 -161
- package/tools/scenario-incident.ts +0 -162
- package/tools/scoped-priors-check.ts +0 -35
- package/tools/scoped-priors-pooling.ts +0 -34
- package/tools/segment-ast-check.ts +0 -649
- package/tools/session-check.ts +0 -196
- package/tools/session-store-check.ts +0 -73
- package/tools/share-check.ts +0 -88
- package/tools/sign-check.ts +0 -95
- package/tools/signing-check.ts +0 -275
- package/tools/snapshot-demo.ts +0 -65
- package/tools/social-check.ts +0 -146
- package/tools/structure-compare-check.ts +0 -95
- package/tools/support/documentScanner.ts +0 -577
- package/tools/support/texScanner.ts +0 -631
- package/tools/support/workspaceScanner.ts +0 -476
- package/tools/team-check.ts +0 -163
- package/tools/team-demo.ts +0 -36
- package/tools/telemetry-check.ts +0 -44
- package/tools/tex-context-check.ts +0 -263
- package/tools/tool-gate-check.ts +0 -98
- package/tools/tree-structure-check.ts +0 -786
- package/tools/trust-flow-check.ts +0 -158
- package/tools/turn-store-check.ts +0 -57
- package/tools/unified-check.ts +0 -83
- package/tools/validate.ts +0 -309
- package/tools/wire-check.ts +0 -96
- package/tools/workspace-agent-check.ts +0 -486
- package/tools/workspace-agent-demo.ts +0 -62
- package/tools/workspace-agent-server.ts +0 -101
- package/tools/workspace-context-check.ts +0 -331
- package/tools/workspace-context.ts +0 -131
- package/tsconfig.build.json +0 -14
- package/tsconfig.json +0 -24
- package/tsconfig.tools.json +0 -31
- package/viz/context-ast.json +0 -1577
package/src/protocol/envelope.ts
DELETED
|
@@ -1,655 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AMP v0.1 A-surface runtime: one sealed envelope for the seven performatives.
|
|
3
|
-
*
|
|
4
|
-
* The signature covers the canonical envelope except `sig`. Ordering, replay,
|
|
5
|
-
* dedupe and cancellation are receiver-local decisions; no peer promise is
|
|
6
|
-
* trusted. FIFO is scoped to `(from, to, thread)`; cross-thread ordering is not
|
|
7
|
-
* guaranteed.
|
|
8
|
-
*/
|
|
9
|
-
import type { Digest, Id, Ref, Timestamp } from "../types/common.ts";
|
|
10
|
-
import type { Performative } from "./protocol.ts";
|
|
11
|
-
import { canonical, digestOf } from "../semantic/canonical.ts";
|
|
12
|
-
import type { KeyPair } from "../manifest/sign.ts";
|
|
13
|
-
|
|
14
|
-
export type { Performative };
|
|
15
|
-
|
|
16
|
-
const Encoder: TextEncoder = new TextEncoder();
|
|
17
|
-
|
|
18
|
-
const PERFORMATIVES: ReadonlySet<string> = new Set(["inform", "request", "propose", "commit", "decline", "cancel", "release"]);
|
|
19
|
-
|
|
20
|
-
type VersionTuple = readonly [number, number];
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
* Inclusive `major.minor` version window. Comparison is numeric, not lexical.
|
|
24
|
-
*/
|
|
25
|
-
export interface VersionRange {
|
|
26
|
-
min: string;
|
|
27
|
-
max: string;
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
/**
|
|
31
|
-
* The wire form of an authenticated AMP A-surface message.
|
|
32
|
-
*/
|
|
33
|
-
export interface SealedEnvelope<T = unknown> {
|
|
34
|
-
amp: "0.1";
|
|
35
|
-
kind: "envelope";
|
|
36
|
-
id: Id;
|
|
37
|
-
from: Ref;
|
|
38
|
-
to: Ref;
|
|
39
|
-
thread: Id;
|
|
40
|
-
seq: number;
|
|
41
|
-
type: Performative;
|
|
42
|
-
sent: Timestamp;
|
|
43
|
-
expires?: Timestamp;
|
|
44
|
-
nonce: string;
|
|
45
|
-
version: VersionRange;
|
|
46
|
-
payload: T;
|
|
47
|
-
kid: string;
|
|
48
|
-
sig: string;
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* Caller-supplied fields; `sealEnvelope` fills every omitted default.
|
|
53
|
-
*/
|
|
54
|
-
export interface EnvelopeInput<T> {
|
|
55
|
-
id?: Id;
|
|
56
|
-
from: Ref;
|
|
57
|
-
to: Ref;
|
|
58
|
-
thread: Id;
|
|
59
|
-
seq?: number;
|
|
60
|
-
type: Performative;
|
|
61
|
-
sent?: Timestamp;
|
|
62
|
-
ttlMs?: number;
|
|
63
|
-
nonce?: string;
|
|
64
|
-
version?: VersionRange;
|
|
65
|
-
payload: T;
|
|
66
|
-
kid?: string;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* Receiver outcome. `ok` is true only for `status: 'accepted'`.
|
|
71
|
-
*/
|
|
72
|
-
export interface EnvelopeVerdict {
|
|
73
|
-
ok: boolean;
|
|
74
|
-
status: "accepted" | "duplicate" | "out_of_order" | "cancelled" | "invalid";
|
|
75
|
-
reasons: string[];
|
|
76
|
-
envelope?: SealedEnvelope;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
/**
|
|
80
|
-
* Runtime clock, local version window and tolerated clock skew.
|
|
81
|
-
*/
|
|
82
|
-
export interface EnvelopeRuntimeOptions {
|
|
83
|
-
now: () => Timestamp;
|
|
84
|
-
version: VersionRange;
|
|
85
|
-
clockSkewMs?: number;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Optional receiver settings for `verifyEnvelope`.
|
|
90
|
-
*/
|
|
91
|
-
export interface EnvelopeVerifyOptions {
|
|
92
|
-
now?: Timestamp;
|
|
93
|
-
expectedVersion?: VersionRange;
|
|
94
|
-
clockSkewMs?: number;
|
|
95
|
-
seenNonces?: Set<string>;
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
type EnvelopeVerification = Pick<EnvelopeVerdict, "ok" | "reasons">;
|
|
99
|
-
|
|
100
|
-
const isRecord: (value: unknown) => value is Record<string, unknown> = (value: unknown): value is Record<string, unknown> => {
|
|
101
|
-
return typeof(value) === "object" && value !== null && !Array.isArray(value);
|
|
102
|
-
};
|
|
103
|
-
|
|
104
|
-
const isRef: (value: unknown) => value is Ref = (value: unknown): value is Ref => {
|
|
105
|
-
return isRecord(value) && typeof(value.kind) === "string" && typeof(value.id) === "string" && value.id.length > 0;
|
|
106
|
-
};
|
|
107
|
-
|
|
108
|
-
const timestampMs: (value: unknown) => number | null = (value: unknown): number | null => {
|
|
109
|
-
if (typeof(value) !== "string") {
|
|
110
|
-
return null;
|
|
111
|
-
}
|
|
112
|
-
const parsed: number = Date.parse(value);
|
|
113
|
-
return Number.isFinite(parsed) ? parsed : null;
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
const parseVersion: (value: string) => VersionTuple | null = (value: string): VersionTuple | null => {
|
|
117
|
-
const match: RegExpExecArray | null = /^([0-9]+)\.([0-9]+)$/.exec(value);
|
|
118
|
-
if (!match) {
|
|
119
|
-
return null;
|
|
120
|
-
}
|
|
121
|
-
const major: number = Number(match[1]);
|
|
122
|
-
const minor: number = Number(match[2]);
|
|
123
|
-
if (!Number.isSafeInteger(major) || !Number.isSafeInteger(minor)) {
|
|
124
|
-
return null;
|
|
125
|
-
}
|
|
126
|
-
return [major, minor];
|
|
127
|
-
};
|
|
128
|
-
|
|
129
|
-
const compareVersions: (left: VersionTuple, right: VersionTuple) => number = (left: VersionTuple, right: VersionTuple): number => {
|
|
130
|
-
if (left[0] !== right[0]) {
|
|
131
|
-
return left[0] < right[0] ? -1 : 1;
|
|
132
|
-
}
|
|
133
|
-
if (left[1] !== right[1]) {
|
|
134
|
-
return left[1] < right[1] ? -1 : 1;
|
|
135
|
-
}
|
|
136
|
-
return 0;
|
|
137
|
-
};
|
|
138
|
-
|
|
139
|
-
const formatVersion: (version: VersionTuple) => string = (version: VersionTuple): string => {
|
|
140
|
-
return `${version[0]}.${version[1]}`;
|
|
141
|
-
};
|
|
142
|
-
|
|
143
|
-
/**
|
|
144
|
-
* Rejects malformed, inverted and non-`major.minor` ranges.
|
|
145
|
-
*/
|
|
146
|
-
const normalizeVersionRange: (value: unknown) => VersionRange | null = (value: unknown): VersionRange | null => {
|
|
147
|
-
if (!isRecord(value)) {
|
|
148
|
-
return null;
|
|
149
|
-
}
|
|
150
|
-
if (typeof(value.min) !== "string" || typeof(value.max) !== "string") {
|
|
151
|
-
return null;
|
|
152
|
-
}
|
|
153
|
-
const min: VersionTuple | null = parseVersion(value.min);
|
|
154
|
-
const max: VersionTuple | null = parseVersion(value.max);
|
|
155
|
-
if (!min || !max) {
|
|
156
|
-
return null;
|
|
157
|
-
}
|
|
158
|
-
if (compareVersions(min, max) > 0) {
|
|
159
|
-
return null;
|
|
160
|
-
}
|
|
161
|
-
return { min: formatVersion(min), max: formatVersion(max) };
|
|
162
|
-
};
|
|
163
|
-
|
|
164
|
-
type VersionNegotiator = (local: VersionRange, remote: VersionRange) => VersionRange | null;
|
|
165
|
-
|
|
166
|
-
/**
|
|
167
|
-
* Intersects two inclusive `major.minor` windows.
|
|
168
|
-
*
|
|
169
|
-
* Versions compare numerically (`0.10` is newer than `0.9`), with no
|
|
170
|
-
* prerelease or patch semantics. Malformed or inverted ranges yield `null`,
|
|
171
|
-
* as does a disjoint pair such as `0.1` with `0.2`.
|
|
172
|
-
*/
|
|
173
|
-
export const negotiateVersion: VersionNegotiator = (local: VersionRange, remote: VersionRange): VersionRange | null => {
|
|
174
|
-
const left: VersionRange | null = normalizeVersionRange(local);
|
|
175
|
-
const right: VersionRange | null = normalizeVersionRange(remote);
|
|
176
|
-
if (!left || !right) {
|
|
177
|
-
return null;
|
|
178
|
-
}
|
|
179
|
-
const leftMin: VersionTuple = parseVersion(left.min) as VersionTuple;
|
|
180
|
-
const leftMax: VersionTuple = parseVersion(left.max) as VersionTuple;
|
|
181
|
-
const rightMin: VersionTuple = parseVersion(right.min) as VersionTuple;
|
|
182
|
-
const rightMax: VersionTuple = parseVersion(right.max) as VersionTuple;
|
|
183
|
-
const min: VersionTuple = compareVersions(leftMin, rightMin) >= 0 ? leftMin : rightMin;
|
|
184
|
-
const max: VersionTuple = compareVersions(leftMax, rightMax) <= 0 ? leftMax : rightMax;
|
|
185
|
-
if (compareVersions(min, max) > 0) {
|
|
186
|
-
return null;
|
|
187
|
-
}
|
|
188
|
-
return { min: formatVersion(min), max: formatVersion(max) };
|
|
189
|
-
};
|
|
190
|
-
|
|
191
|
-
const toBase64Url: (bytes: ArrayBuffer) => string = (bytes: ArrayBuffer): string => {
|
|
192
|
-
const view: Uint8Array = new Uint8Array(bytes);
|
|
193
|
-
let binary: string = "";
|
|
194
|
-
for (let index: number = 0; index < view.length; index += 1) {
|
|
195
|
-
const byte: number = view[index];
|
|
196
|
-
binary += String.fromCharCode(byte);
|
|
197
|
-
}
|
|
198
|
-
return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
199
|
-
};
|
|
200
|
-
|
|
201
|
-
const fromBase64Url: (text: string) => BufferSource = (text: string): BufferSource => {
|
|
202
|
-
const padded: string = text.replace(/-/g, "+").replace(/_/g, "/");
|
|
203
|
-
if (!/^[A-Za-z0-9+/]*={0,2}$/.test(padded)) {
|
|
204
|
-
throw new Error("invalid base64url");
|
|
205
|
-
}
|
|
206
|
-
const pad: string = padded.length % 4 ? "=".repeat(4 - (padded.length % 4)) : "";
|
|
207
|
-
const binary: string = atob(padded + pad);
|
|
208
|
-
return Uint8Array.from(binary, (char) => char.charCodeAt(0)) as unknown as BufferSource;
|
|
209
|
-
};
|
|
210
|
-
|
|
211
|
-
const signingBytes: (value: unknown) => BufferSource = (value: unknown): BufferSource => {
|
|
212
|
-
return Encoder.encode(canonical(value)) as unknown as BufferSource;
|
|
213
|
-
};
|
|
214
|
-
|
|
215
|
-
type SignatureStripper = (envelope: Record<string, unknown>) => Record<string, unknown>;
|
|
216
|
-
|
|
217
|
-
const withoutSignature: SignatureStripper = (envelope: Record<string, unknown>): Record<string, unknown> => {
|
|
218
|
-
const body: Record<string, unknown> = {};
|
|
219
|
-
const entries: [string, unknown][] = Object.entries(envelope);
|
|
220
|
-
for (let index: number = 0; index < entries.length; index += 1) {
|
|
221
|
-
const [entryKey, entryValue]: [string, unknown] = entries[index];
|
|
222
|
-
if (entryKey !== "sig") {
|
|
223
|
-
body[entryKey] = entryValue;
|
|
224
|
-
}
|
|
225
|
-
}
|
|
226
|
-
return body;
|
|
227
|
-
};
|
|
228
|
-
|
|
229
|
-
const randomHex: (bytes: number) => string = (bytes: number): string => {
|
|
230
|
-
const values: Uint8Array = crypto.getRandomValues(new Uint8Array(bytes));
|
|
231
|
-
let hex: string = "";
|
|
232
|
-
for (let index: number = 0; index < values.length; index += 1) {
|
|
233
|
-
const value: number = values[index];
|
|
234
|
-
hex += value.toString(16).padStart(2, "0");
|
|
235
|
-
}
|
|
236
|
-
return hex;
|
|
237
|
-
};
|
|
238
|
-
|
|
239
|
-
const normalizedSkew: (value: number | undefined) => number = (value: number | undefined): number => {
|
|
240
|
-
return value !== (void 0) && Number.isFinite(value) && value > 0 ? value : 0;
|
|
241
|
-
};
|
|
242
|
-
|
|
243
|
-
/**
|
|
244
|
-
* Content digest of the signed envelope body (everything except `sig`).
|
|
245
|
-
* Useful for logs and idempotency indexes; it is not a substitute for a
|
|
246
|
-
* signature check.
|
|
247
|
-
*/
|
|
248
|
-
export const envelopeDigest: (envelope: SealedEnvelope) => Digest = (envelope: SealedEnvelope): Digest => {
|
|
249
|
-
return digestOf(withoutSignature(envelope as unknown as Record<string, unknown>));
|
|
250
|
-
};
|
|
251
|
-
|
|
252
|
-
type EnvelopeSealer = <T>(input: EnvelopeInput<T>, key: KeyPair) => Promise<SealedEnvelope<T>>;
|
|
253
|
-
|
|
254
|
-
/**
|
|
255
|
-
* Seals one A-surface envelope with Ed25519.
|
|
256
|
-
*
|
|
257
|
-
* Defaults: a fresh random `id`, a 16-byte hex `nonce`, `seq` 0, an `amp`
|
|
258
|
-
* 0.1 version window, `kid` from the key unless explicitly supplied, `sent`
|
|
259
|
-
* from the real clock and no expiry. A supplied `ttlMs` is added to `sent` to
|
|
260
|
-
* produce `expires`; negative or non-finite TTLs are rejected. The signature
|
|
261
|
-
* covers the canonical envelope excluding only `sig`.
|
|
262
|
-
*/
|
|
263
|
-
export const sealEnvelope: EnvelopeSealer = async <T>(input: EnvelopeInput<T>, key: KeyPair): Promise<SealedEnvelope<T>> => {
|
|
264
|
-
const ttl: number | undefined = input.ttlMs;
|
|
265
|
-
if (ttl !== (void 0) && (!Number.isFinite(ttl) || ttl < 0)) {
|
|
266
|
-
throw new RangeError("ttlMs must be a non-negative finite number");
|
|
267
|
-
}
|
|
268
|
-
|
|
269
|
-
const sent: Timestamp = input.sent ?? new Date().toISOString();
|
|
270
|
-
const sentMs: number | null = timestampMs(sent);
|
|
271
|
-
if (sentMs === null) {
|
|
272
|
-
throw new Error("sent must be a valid timestamp");
|
|
273
|
-
}
|
|
274
|
-
|
|
275
|
-
const seq: number = input.seq ?? 0;
|
|
276
|
-
if (!Number.isSafeInteger(seq) || seq < 0) {
|
|
277
|
-
throw new RangeError("seq must be a non-negative safe integer");
|
|
278
|
-
}
|
|
279
|
-
|
|
280
|
-
const id: Id = input.id ?? `m.${randomHex(16)}`;
|
|
281
|
-
const nonce: string = input.nonce ?? randomHex(16);
|
|
282
|
-
const version: VersionRange = input.version ? { min: input.version.min, max: input.version.max } : { min: "0.1", max: "0.1" };
|
|
283
|
-
|
|
284
|
-
let expires: Timestamp | undefined;
|
|
285
|
-
if (ttl !== (void 0)) {
|
|
286
|
-
const expiresMs: number = sentMs + ttl;
|
|
287
|
-
if (!Number.isFinite(expiresMs) || Math.abs(expiresMs) > 8_640_000_000_000_000) {
|
|
288
|
-
throw new RangeError("expires is outside the supported timestamp range");
|
|
289
|
-
}
|
|
290
|
-
expires = new Date(expiresMs).toISOString();
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
const unsigned: Omit<SealedEnvelope<T>, "sig"> = {
|
|
294
|
-
amp: "0.1",
|
|
295
|
-
kind: "envelope",
|
|
296
|
-
id,
|
|
297
|
-
from: input.from,
|
|
298
|
-
to: input.to,
|
|
299
|
-
thread: input.thread,
|
|
300
|
-
seq,
|
|
301
|
-
type: input.type,
|
|
302
|
-
sent,
|
|
303
|
-
...(expires === (void 0) ? {} : { expires }),
|
|
304
|
-
nonce,
|
|
305
|
-
version,
|
|
306
|
-
payload: input.payload,
|
|
307
|
-
kid: input.kid ?? key.kid,
|
|
308
|
-
};
|
|
309
|
-
|
|
310
|
-
const signature: ArrayBuffer = await crypto.subtle.sign("Ed25519", key.privateKey, signingBytes(unsigned));
|
|
311
|
-
return { ...unsigned, sig: toBase64Url(signature) };
|
|
312
|
-
};
|
|
313
|
-
|
|
314
|
-
type EnvelopeVerifier = (envelope: SealedEnvelope, publicKey: CryptoKey, options?: EnvelopeVerifyOptions) => Promise<EnvelopeVerification>;
|
|
315
|
-
|
|
316
|
-
/**
|
|
317
|
-
* Verifies an envelope's structure, amp/kind, expiry (with skew), version
|
|
318
|
-
* intersection, optional nonce uniqueness and Ed25519 signature.
|
|
319
|
-
*
|
|
320
|
-
* A nonce is added to `seenNonces` only after every check passes, so a forged
|
|
321
|
-
* or expired copy cannot burn a legitimate nonce. Expiry is accepted up to and
|
|
322
|
-
* including `expires + clockSkewMs`.
|
|
323
|
-
*/
|
|
324
|
-
export const verifyEnvelope: EnvelopeVerifier = async (envelope: SealedEnvelope, publicKey: CryptoKey, options: EnvelopeVerifyOptions = {}) => {
|
|
325
|
-
if (!isRecord(envelope)) {
|
|
326
|
-
return { ok: false, reasons: ["envelope is not an object"] };
|
|
327
|
-
}
|
|
328
|
-
|
|
329
|
-
const record: Record<string, unknown> = envelope as unknown as Record<string, unknown>;
|
|
330
|
-
const reasons: string[] = [];
|
|
331
|
-
|
|
332
|
-
if (record.amp !== "0.1") {
|
|
333
|
-
reasons.push('amp must be "0.1"');
|
|
334
|
-
}
|
|
335
|
-
if (record.kind !== "envelope") {
|
|
336
|
-
reasons.push('kind must be "envelope"');
|
|
337
|
-
}
|
|
338
|
-
if (typeof(record.id) !== "string" || record.id.length === 0) {
|
|
339
|
-
reasons.push("id must be a non-empty string");
|
|
340
|
-
}
|
|
341
|
-
if (!isRef(record.from)) {
|
|
342
|
-
reasons.push("from must be a Ref with a non-empty id");
|
|
343
|
-
}
|
|
344
|
-
if (!isRef(record.to)) {
|
|
345
|
-
reasons.push("to must be a Ref with a non-empty id");
|
|
346
|
-
}
|
|
347
|
-
if (typeof(record.thread) !== "string" || record.thread.length === 0) {
|
|
348
|
-
reasons.push("thread must be a non-empty string");
|
|
349
|
-
}
|
|
350
|
-
if (!Number.isSafeInteger(record.seq) || (record.seq as number) < 0) {
|
|
351
|
-
reasons.push("seq must be a non-negative safe integer");
|
|
352
|
-
}
|
|
353
|
-
if (typeof(record.type) !== "string" || !PERFORMATIVES.has(record.type)) {
|
|
354
|
-
reasons.push("type must be one of the seven performatives");
|
|
355
|
-
}
|
|
356
|
-
if (timestampMs(record.sent) === null) {
|
|
357
|
-
reasons.push("sent must be a valid timestamp");
|
|
358
|
-
}
|
|
359
|
-
if (record.expires !== (void 0) && timestampMs(record.expires) === null) {
|
|
360
|
-
reasons.push("expires must be a valid timestamp");
|
|
361
|
-
}
|
|
362
|
-
if (typeof(record.nonce) !== "string" || record.nonce.length === 0) {
|
|
363
|
-
reasons.push("nonce must be a non-empty string");
|
|
364
|
-
}
|
|
365
|
-
if (!Object.hasOwn(record, "payload") || record.payload === (void 0)) {
|
|
366
|
-
reasons.push("payload is required");
|
|
367
|
-
}
|
|
368
|
-
if (typeof(record.kid) !== "string" || record.kid.length === 0) {
|
|
369
|
-
reasons.push("kid must be a non-empty string");
|
|
370
|
-
}
|
|
371
|
-
|
|
372
|
-
const version: VersionRange | null = normalizeVersionRange(record.version);
|
|
373
|
-
if (!version) {
|
|
374
|
-
reasons.push("version must be an inclusive major.minor range");
|
|
375
|
-
}
|
|
376
|
-
|
|
377
|
-
if (options.expectedVersion !== (void 0)) {
|
|
378
|
-
const expected: VersionRange | null = normalizeVersionRange(options.expectedVersion);
|
|
379
|
-
if (!expected) {
|
|
380
|
-
reasons.push("expectedVersion must be an inclusive major.minor range");
|
|
381
|
-
} else if (version && negotiateVersion(version, expected) === null) {
|
|
382
|
-
reasons.push("version ranges do not intersect");
|
|
383
|
-
}
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
if (record.expires !== (void 0)) {
|
|
387
|
-
const expiresMs: number | null = timestampMs(record.expires);
|
|
388
|
-
if (expiresMs !== null) {
|
|
389
|
-
const now: number | null = timestampMs(options.now ?? new Date().toISOString());
|
|
390
|
-
if (now === null) {
|
|
391
|
-
reasons.push("now must be a valid timestamp");
|
|
392
|
-
} else if (now > expiresMs + normalizedSkew(options.clockSkewMs)) {
|
|
393
|
-
reasons.push("envelope has expired");
|
|
394
|
-
}
|
|
395
|
-
}
|
|
396
|
-
}
|
|
397
|
-
|
|
398
|
-
const nonce: string | null = typeof(record.nonce) === "string" && record.nonce.length > 0 ? record.nonce : null;
|
|
399
|
-
if (nonce !== null && options.seenNonces?.has(nonce)) {
|
|
400
|
-
reasons.push("nonce has already been seen");
|
|
401
|
-
}
|
|
402
|
-
|
|
403
|
-
if (typeof(record.sig) !== "string" || record.sig.length === 0) {
|
|
404
|
-
reasons.push("signature is missing");
|
|
405
|
-
} else {
|
|
406
|
-
try {
|
|
407
|
-
const valid: boolean = await crypto.subtle.verify("Ed25519", publicKey, fromBase64Url(record.sig), signingBytes(withoutSignature(record)));
|
|
408
|
-
if (!valid) {
|
|
409
|
-
reasons.push("signature does not verify");
|
|
410
|
-
}
|
|
411
|
-
} catch {
|
|
412
|
-
reasons.push("signature is malformed");
|
|
413
|
-
}
|
|
414
|
-
}
|
|
415
|
-
|
|
416
|
-
if (reasons.length === 0 && nonce !== null) {
|
|
417
|
-
options.seenNonces?.add(nonce);
|
|
418
|
-
}
|
|
419
|
-
return { ok: reasons.length === 0, reasons };
|
|
420
|
-
};
|
|
421
|
-
|
|
422
|
-
const identityKey: (envelope: SealedEnvelope) => string | null = (envelope: SealedEnvelope): string | null => {
|
|
423
|
-
if (typeof(envelope.id) !== "string" || envelope.id.length === 0) {
|
|
424
|
-
return null;
|
|
425
|
-
}
|
|
426
|
-
if (!isRef(envelope.from)) {
|
|
427
|
-
return null;
|
|
428
|
-
}
|
|
429
|
-
return JSON.stringify([envelope.from.id, envelope.id]);
|
|
430
|
-
};
|
|
431
|
-
|
|
432
|
-
const sequenceKey: (envelope: SealedEnvelope) => string = (envelope: SealedEnvelope): string => {
|
|
433
|
-
const fromId: string | null = isRef(envelope.from) ? envelope.from.id : null;
|
|
434
|
-
const toId: string | null = isRef(envelope.to) ? envelope.to.id : null;
|
|
435
|
-
return JSON.stringify([fromId, toId, envelope.thread]);
|
|
436
|
-
};
|
|
437
|
-
|
|
438
|
-
const tombstoneKey: (fromId: string, targetId: string) => string = (fromId: string, targetId: string): string => {
|
|
439
|
-
return JSON.stringify([fromId, targetId]);
|
|
440
|
-
};
|
|
441
|
-
|
|
442
|
-
const cancelTargetId: (payload: unknown) => string | null = (payload: unknown): string | null => {
|
|
443
|
-
if (!isRecord(payload)) {
|
|
444
|
-
return null;
|
|
445
|
-
}
|
|
446
|
-
if (typeof(payload.targetId) === "string" && payload.targetId.length > 0) {
|
|
447
|
-
return payload.targetId;
|
|
448
|
-
}
|
|
449
|
-
if (typeof(payload.request) === "string" && payload.request.length > 0) {
|
|
450
|
-
return payload.request;
|
|
451
|
-
}
|
|
452
|
-
return null;
|
|
453
|
-
};
|
|
454
|
-
|
|
455
|
-
type VerdictFactory = (status: EnvelopeVerdict["status"], reasons: string[], envelope?: SealedEnvelope) => EnvelopeVerdict;
|
|
456
|
-
|
|
457
|
-
const verdictOf: VerdictFactory = (status: EnvelopeVerdict["status"], reasons: string[], envelope?: SealedEnvelope): EnvelopeVerdict => {
|
|
458
|
-
return {
|
|
459
|
-
ok: status === "accepted",
|
|
460
|
-
status,
|
|
461
|
-
reasons,
|
|
462
|
-
...(envelope === (void 0) ? {} : { envelope }),
|
|
463
|
-
};
|
|
464
|
-
};
|
|
465
|
-
|
|
466
|
-
/**
|
|
467
|
-
* Authenticated receiver for one A-surface participant.
|
|
468
|
-
*
|
|
469
|
-
* `receive` verifies signature, TTL, version intersection and nonce replay
|
|
470
|
-
* before touching sequence state. It enforces `(from, to, thread)` FIFO,
|
|
471
|
-
* global `(from, id)` dedupe within this runtime, and sticky `(from, targetId)`
|
|
472
|
-
* cancel tombstones. A cancel is subject to the same sequence ordering as
|
|
473
|
-
* every other performative. An envelope whose `seq` is ahead of the next
|
|
474
|
-
* expected value is queued as `out_of_order` and becomes deliverable when the
|
|
475
|
-
* gap closes. Threads and recipient pairs advance independently.
|
|
476
|
-
*
|
|
477
|
-
* A receiver is not configured with its own `to` identity, so `to` participates
|
|
478
|
-
* in the ordering key but audience rejection is the caller's responsibility.
|
|
479
|
-
*/
|
|
480
|
-
export class EnvelopeRuntime {
|
|
481
|
-
private readonly now: () => Timestamp;
|
|
482
|
-
private readonly version: VersionRange;
|
|
483
|
-
private readonly clockSkewMs: number;
|
|
484
|
-
private readonly nextByThread = new Map<string, number>();
|
|
485
|
-
private readonly queueByThread = new Map<string, Map<number, SealedEnvelope>>();
|
|
486
|
-
private readonly seenIds = new Set<string>();
|
|
487
|
-
private readonly seenNonces = new Set<string>();
|
|
488
|
-
private readonly tombstones = new Set<string>();
|
|
489
|
-
private readonly deliveredEnvelopes: SealedEnvelope[] = [];
|
|
490
|
-
private readonly cancelledEnvelopes: SealedEnvelope[] = [];
|
|
491
|
-
|
|
492
|
-
/**
|
|
493
|
-
* Builds a receiver around an injected clock and local version window.
|
|
494
|
-
*/
|
|
495
|
-
constructor(options: EnvelopeRuntimeOptions) {
|
|
496
|
-
this.now = options.now;
|
|
497
|
-
this.version = { min: options.version.min, max: options.version.max };
|
|
498
|
-
this.clockSkewMs = normalizedSkew(options.clockSkewMs);
|
|
499
|
-
}
|
|
500
|
-
|
|
501
|
-
/**
|
|
502
|
-
* Verifies and admits one envelope.
|
|
503
|
-
*
|
|
504
|
-
* Invalid envelopes leave the message id, nonce and sequence state
|
|
505
|
-
* untouched. A duplicate id short-circuits to `duplicate`; a stale sequence
|
|
506
|
-
* is also reported as `duplicate`; a future sequence is queued without
|
|
507
|
-
* delivery. A cancelled target consumes its sequence slot so the FIFO can
|
|
508
|
-
* continue.
|
|
509
|
-
*/
|
|
510
|
-
async receive(envelope: SealedEnvelope, publicKey: CryptoKey): Promise<EnvelopeVerdict> {
|
|
511
|
-
if (!isRecord(envelope)) {
|
|
512
|
-
return verdictOf("invalid", ["envelope is not an object"]);
|
|
513
|
-
}
|
|
514
|
-
|
|
515
|
-
const initialIdentity: string | null = identityKey(envelope);
|
|
516
|
-
if (initialIdentity !== null && this.seenIds.has(initialIdentity)) {
|
|
517
|
-
return verdictOf("duplicate", ["envelope id has already been received"], envelope);
|
|
518
|
-
}
|
|
519
|
-
|
|
520
|
-
const nonces: Set<string> = new Set(this.seenNonces);
|
|
521
|
-
const verification: EnvelopeVerification = await verifyEnvelope(envelope, publicKey, {
|
|
522
|
-
now: this.now(),
|
|
523
|
-
expectedVersion: this.version,
|
|
524
|
-
clockSkewMs: this.clockSkewMs,
|
|
525
|
-
seenNonces: nonces,
|
|
526
|
-
});
|
|
527
|
-
if (!verification.ok) {
|
|
528
|
-
return verdictOf("invalid", [...verification.reasons], envelope);
|
|
529
|
-
}
|
|
530
|
-
|
|
531
|
-
const identity: string | null = identityKey(envelope);
|
|
532
|
-
if (identity === null) {
|
|
533
|
-
return verdictOf("invalid", ["envelope has no usable (from, id) identity"], envelope);
|
|
534
|
-
}
|
|
535
|
-
if (this.seenIds.has(identity)) {
|
|
536
|
-
return verdictOf("duplicate", ["envelope id has already been received"], envelope);
|
|
537
|
-
}
|
|
538
|
-
|
|
539
|
-
const cancelTarget: string | null = envelope.type === "cancel" ? cancelTargetId(envelope.payload) : null;
|
|
540
|
-
if (envelope.type === "cancel" && cancelTarget === null) {
|
|
541
|
-
return verdictOf("invalid", ["cancel payload must include a non-empty targetId or request"], envelope);
|
|
542
|
-
}
|
|
543
|
-
|
|
544
|
-
if (this.seenNonces.has(envelope.nonce)) {
|
|
545
|
-
return verdictOf("invalid", ["nonce has already been seen"], envelope);
|
|
546
|
-
}
|
|
547
|
-
|
|
548
|
-
this.seenNonces.add(envelope.nonce);
|
|
549
|
-
this.seenIds.add(identity);
|
|
550
|
-
|
|
551
|
-
const key: string = sequenceKey(envelope);
|
|
552
|
-
const next: number = this.nextByThread.get(key) ?? 0;
|
|
553
|
-
|
|
554
|
-
if (envelope.seq > next) {
|
|
555
|
-
const queue: Map<number, SealedEnvelope> = this.queueByThread.get(key) ?? new Map<number, SealedEnvelope>();
|
|
556
|
-
if (queue.has(envelope.seq)) {
|
|
557
|
-
return verdictOf("duplicate", [`sequence ${envelope.seq} is already queued`], envelope);
|
|
558
|
-
}
|
|
559
|
-
queue.set(envelope.seq, envelope);
|
|
560
|
-
this.queueByThread.set(key, queue);
|
|
561
|
-
return verdictOf("out_of_order", [`sequence ${envelope.seq} arrived before expected ${next}`], envelope);
|
|
562
|
-
}
|
|
563
|
-
|
|
564
|
-
if (envelope.seq < next) {
|
|
565
|
-
return verdictOf("duplicate", [`sequence ${envelope.seq} is stale; expected ${next}`], envelope);
|
|
566
|
-
}
|
|
567
|
-
|
|
568
|
-
const outcome: "accepted" | "cancelled" = this.settle(envelope);
|
|
569
|
-
this.nextByThread.set(key, envelope.seq + 1);
|
|
570
|
-
this.drain(key);
|
|
571
|
-
|
|
572
|
-
if (outcome === "cancelled") {
|
|
573
|
-
return verdictOf("cancelled", [`envelope ${envelope.id} was cancelled`], envelope);
|
|
574
|
-
}
|
|
575
|
-
return verdictOf("accepted", [], envelope);
|
|
576
|
-
}
|
|
577
|
-
|
|
578
|
-
/**
|
|
579
|
-
* Delivered envelopes in sequence order, including cancel performatives.
|
|
580
|
-
*/
|
|
581
|
-
get delivered(): readonly SealedEnvelope[] {
|
|
582
|
-
return [...this.deliveredEnvelopes];
|
|
583
|
-
}
|
|
584
|
-
|
|
585
|
-
/**
|
|
586
|
-
* Convenience alias for `delivered`; both exclude cancelled targets.
|
|
587
|
-
*/
|
|
588
|
-
get accepted(): readonly SealedEnvelope[] {
|
|
589
|
-
return [...this.deliveredEnvelopes];
|
|
590
|
-
}
|
|
591
|
-
|
|
592
|
-
/**
|
|
593
|
-
* Verified envelopes suppressed by a previously delivered cancel tombstone.
|
|
594
|
-
*/
|
|
595
|
-
get cancelled(): readonly SealedEnvelope[] {
|
|
596
|
-
return [...this.cancelledEnvelopes];
|
|
597
|
-
}
|
|
598
|
-
|
|
599
|
-
/**
|
|
600
|
-
* Verified envelopes still waiting behind an earlier sequence gap.
|
|
601
|
-
*/
|
|
602
|
-
get pending(): readonly SealedEnvelope[] {
|
|
603
|
-
const queued: SealedEnvelope[] = [];
|
|
604
|
-
const queues: Map<number, SealedEnvelope>[] = [...this.queueByThread.values()];
|
|
605
|
-
for (let index: number = 0; index < queues.length; index += 1) {
|
|
606
|
-
const queue: Map<number, SealedEnvelope> = queues[index];
|
|
607
|
-
queued.push(...queue.values());
|
|
608
|
-
}
|
|
609
|
-
return queued.sort((left, right) => left.seq - right.seq);
|
|
610
|
-
}
|
|
611
|
-
|
|
612
|
-
private settle(envelope: SealedEnvelope): "accepted" | "cancelled" {
|
|
613
|
-
if (envelope.type === "cancel") {
|
|
614
|
-
const target: string | null = cancelTargetId(envelope.payload);
|
|
615
|
-
if (target !== null) {
|
|
616
|
-
this.tombstones.add(tombstoneKey(envelope.from.id, target));
|
|
617
|
-
}
|
|
618
|
-
this.deliveredEnvelopes.push(envelope);
|
|
619
|
-
return "accepted";
|
|
620
|
-
}
|
|
621
|
-
|
|
622
|
-
if (this.tombstones.has(tombstoneKey(envelope.from.id, envelope.id))) {
|
|
623
|
-
this.cancelledEnvelopes.push(envelope);
|
|
624
|
-
return "cancelled";
|
|
625
|
-
}
|
|
626
|
-
|
|
627
|
-
this.deliveredEnvelopes.push(envelope);
|
|
628
|
-
return "accepted";
|
|
629
|
-
}
|
|
630
|
-
|
|
631
|
-
/**
|
|
632
|
-
* Consumes every contiguous queued sequence after an accepted envelope.
|
|
633
|
-
*/
|
|
634
|
-
private drain(key: string): void {
|
|
635
|
-
const queue: Map<number, SealedEnvelope> | undefined = this.queueByThread.get(key);
|
|
636
|
-
if (!queue) {
|
|
637
|
-
return;
|
|
638
|
-
}
|
|
639
|
-
|
|
640
|
-
let next: number = this.nextByThread.get(key) ?? 0;
|
|
641
|
-
while (true) {
|
|
642
|
-
const queued: SealedEnvelope | undefined = queue.get(next);
|
|
643
|
-
if (!queued) {
|
|
644
|
-
break;
|
|
645
|
-
}
|
|
646
|
-
queue.delete(next);
|
|
647
|
-
this.settle(queued);
|
|
648
|
-
next += 1;
|
|
649
|
-
}
|
|
650
|
-
this.nextByThread.set(key, next);
|
|
651
|
-
if (queue.size === 0) {
|
|
652
|
-
this.queueByThread.delete(key);
|
|
653
|
-
}
|
|
654
|
-
}
|
|
655
|
-
}
|