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
|
@@ -1,228 +0,0 @@
|
|
|
1
|
-
import type { Budget, Id, Ref, Timestamp } from "../types/common.ts";
|
|
2
|
-
import type { Receipt } from "../receipt/receipt.ts";
|
|
3
|
-
import type { AttentionRequest, InterruptClass } from "./socialTypes.ts";
|
|
4
|
-
import { AttentionBroker, type AttentionDecision, type AttentionPolicy } from "./social.ts";
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* The Attention Ledger's missing object: an `Interrupt`.
|
|
8
|
-
*
|
|
9
|
-
* `AttentionBroker` makes a grant/defer/deny decision, but the decision is not
|
|
10
|
-
* itself an auditable ledger row and deferred requests never expire unless a
|
|
11
|
-
* caller manually resolves them. This wrapper turns each decision into an
|
|
12
|
-
* `Interrupt` record, emits the matching receipt, and sweeps deferred requests
|
|
13
|
-
* whose response window has elapsed.
|
|
14
|
-
*
|
|
15
|
-
* It deliberately does not replace `AttentionBroker`: policy, quiet hours,
|
|
16
|
-
* cooldowns and debt stay in one place.
|
|
17
|
-
*/
|
|
18
|
-
|
|
19
|
-
export type InterruptStatus = "granted" | "deferred" | "denied" | "answered" | "expired" | "withdrawn";
|
|
20
|
-
|
|
21
|
-
export interface InterruptRecord {
|
|
22
|
-
amp: "0.1";
|
|
23
|
-
kind: "interrupt";
|
|
24
|
-
id: Id;
|
|
25
|
-
request: Id;
|
|
26
|
-
class: InterruptClass;
|
|
27
|
-
target: Ref;
|
|
28
|
-
urgency: number;
|
|
29
|
-
granted: boolean;
|
|
30
|
-
status: InterruptStatus;
|
|
31
|
-
cost: Budget;
|
|
32
|
-
at: Timestamp;
|
|
33
|
-
expires?: Timestamp;
|
|
34
|
-
debt_weight: number;
|
|
35
|
-
reason: string;
|
|
36
|
-
receipt: Id;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
export interface AttentionLedgerOptions {
|
|
40
|
-
now: () => Timestamp;
|
|
41
|
-
policy?: Partial<AttentionPolicy>;
|
|
42
|
-
/**
|
|
43
|
-
* Response window for a deferred request that carries no `expires`.
|
|
44
|
-
*/
|
|
45
|
-
defaultExpiryMs?: number;
|
|
46
|
-
onReceipt?: (receipt: Receipt) => void;
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export const MaxExternalShare: number = 0.15;
|
|
50
|
-
|
|
51
|
-
export interface AdmissionVerdict {
|
|
52
|
-
ok: boolean;
|
|
53
|
-
reason?: string;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
type ExternalAdmissionInput = {
|
|
57
|
-
role: string;
|
|
58
|
-
share: number;
|
|
59
|
-
goalSlot?: boolean;
|
|
60
|
-
maxShare?: number;
|
|
61
|
-
};
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* A-4: external content may be present, but it cannot buy its own salience and
|
|
65
|
-
* cannot occupy the goal slot. The numeric share is the proportion of the
|
|
66
|
-
* assembled context attributable to external content.
|
|
67
|
-
*/
|
|
68
|
-
export const admitExternal: (input: ExternalAdmissionInput) => AdmissionVerdict = (input: ExternalAdmissionInput): AdmissionVerdict => {
|
|
69
|
-
if (input.goalSlot) {
|
|
70
|
-
return { ok: false, reason: "external content cannot occupy the goal slot" };
|
|
71
|
-
}
|
|
72
|
-
if (!Number.isFinite(input.share) || input.share < 0 || input.share > 1) {
|
|
73
|
-
return { ok: false, reason: `invalid external share: ${`${input.share}`}` };
|
|
74
|
-
}
|
|
75
|
-
const limit: number = input.maxShare ?? MaxExternalShare;
|
|
76
|
-
if (!Number.isFinite(limit) || limit < 0 || limit > 1) {
|
|
77
|
-
throw new RangeError("maxShare must be in [0, 1]");
|
|
78
|
-
}
|
|
79
|
-
if (input.share > limit) {
|
|
80
|
-
return { ok: false, reason: `external share ${input.share} exceeds ${limit}` };
|
|
81
|
-
}
|
|
82
|
-
return { ok: true };
|
|
83
|
-
};
|
|
84
|
-
|
|
85
|
-
type TimestampAdder = (at: Timestamp, ms: number) => Timestamp;
|
|
86
|
-
|
|
87
|
-
const addTimestamps: TimestampAdder = (at: Timestamp, ms: number): Timestamp => new Date(Date.parse(at) + ms).toISOString();
|
|
88
|
-
|
|
89
|
-
/**
|
|
90
|
-
* Interrupt-producing facade over `AttentionBroker`.
|
|
91
|
-
*
|
|
92
|
-
* Every submitted request produces exactly one `InterruptRecord` and one
|
|
93
|
-
* `Receipt` (op `ask`). Deferred records own debt until resolved or expired;
|
|
94
|
-
* `sweep()` closes the bookkeeping for elapsed windows.
|
|
95
|
-
*/
|
|
96
|
-
export class AttentionLedger {
|
|
97
|
-
readonly broker: AttentionBroker;
|
|
98
|
-
private readonly now: () => Timestamp;
|
|
99
|
-
private readonly defaultExpiryMs: number;
|
|
100
|
-
private readonly onReceipt?: (receipt: Receipt) => void;
|
|
101
|
-
private readonly records: InterruptRecord[] = [];
|
|
102
|
-
private readonly byRequest = new Map<Id, InterruptRecord>();
|
|
103
|
-
private seq = 0;
|
|
104
|
-
|
|
105
|
-
constructor(options: AttentionLedgerOptions) {
|
|
106
|
-
this.now = options.now;
|
|
107
|
-
this.defaultExpiryMs = options.defaultExpiryMs ?? 60_000;
|
|
108
|
-
this.onReceipt = options.onReceipt;
|
|
109
|
-
this.broker = new AttentionBroker({ now: options.now, policy: options.policy });
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
submit(request: AttentionRequest): {
|
|
113
|
-
interrupt: InterruptRecord;
|
|
114
|
-
decision: AttentionDecision;
|
|
115
|
-
receipt: Receipt;
|
|
116
|
-
} {
|
|
117
|
-
if (this.byRequest.has(request.id)) {
|
|
118
|
-
throw new Error(`duplicate interrupt request: ${request.id}`);
|
|
119
|
-
}
|
|
120
|
-
const decision: AttentionDecision = this.broker.submit(request);
|
|
121
|
-
const status: InterruptStatus = statusOf(decision);
|
|
122
|
-
this.seq += 1;
|
|
123
|
-
const id: Id = `int.${this.seq}`;
|
|
124
|
-
const expires: Timestamp | undefined = status === "deferred" ? (request.expires ?? addTimestamps(decision.at, this.defaultExpiryMs)) : request.expires;
|
|
125
|
-
const interrupt: InterruptRecord = {
|
|
126
|
-
amp: "0.1",
|
|
127
|
-
kind: "interrupt",
|
|
128
|
-
id,
|
|
129
|
-
request: request.id,
|
|
130
|
-
class: request.class,
|
|
131
|
-
target: request.target,
|
|
132
|
-
urgency: request.urgency,
|
|
133
|
-
granted: status === "granted",
|
|
134
|
-
status,
|
|
135
|
-
cost: request.cost,
|
|
136
|
-
at: decision.at,
|
|
137
|
-
expires,
|
|
138
|
-
debt_weight: request.urgency,
|
|
139
|
-
reason: decision.reason,
|
|
140
|
-
receipt: `rc.ask.${this.seq}`,
|
|
141
|
-
};
|
|
142
|
-
const receipt: Receipt = {
|
|
143
|
-
amp: "0.1",
|
|
144
|
-
kind: "receipt",
|
|
145
|
-
id: interrupt.receipt,
|
|
146
|
-
op: "ask",
|
|
147
|
-
target: request.target,
|
|
148
|
-
at: decision.at,
|
|
149
|
-
usage: { interrupts: status === "granted" ? 1 : 0, ...request.cost },
|
|
150
|
-
outcome: status === "denied" ? "blocked" : status === "deferred" ? "partial" : "success",
|
|
151
|
-
note: `${request.class}:${status}:${decision.reason}`,
|
|
152
|
-
};
|
|
153
|
-
this.records.push(interrupt);
|
|
154
|
-
this.byRequest.set(request.id, interrupt);
|
|
155
|
-
this.onReceipt?.(receipt);
|
|
156
|
-
return { interrupt, decision, receipt };
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
/**
|
|
160
|
-
* Resolve a deferred request. Returns the updated record or undefined.
|
|
161
|
-
*/
|
|
162
|
-
resolve(requestId: Id, outcome: "answered" | "expired" | "withdrawn" = "answered"): InterruptRecord | undefined {
|
|
163
|
-
const record: InterruptRecord | undefined = this.byRequest.get(requestId);
|
|
164
|
-
if (!record || record.status !== "deferred") {
|
|
165
|
-
return undefined;
|
|
166
|
-
}
|
|
167
|
-
try {
|
|
168
|
-
this.broker.resolve(requestId, outcome);
|
|
169
|
-
} catch {
|
|
170
|
-
/**
|
|
171
|
-
* The broker may already have closed the debt through a prior sweep.
|
|
172
|
-
*/
|
|
173
|
-
}
|
|
174
|
-
record.status = outcome;
|
|
175
|
-
return record;
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
/**
|
|
179
|
-
* Expire deferred requests whose response window has elapsed.
|
|
180
|
-
* Idempotent: already-resolved/expired records are skipped.
|
|
181
|
-
*/
|
|
182
|
-
sweep(at: Timestamp = this.now()): InterruptRecord[] {
|
|
183
|
-
const now: number = Date.parse(at);
|
|
184
|
-
const expired: InterruptRecord[] = [];
|
|
185
|
-
for (let index: number = 0; index < this.records.length; index += 1) {
|
|
186
|
-
const record: InterruptRecord = this.records[index];
|
|
187
|
-
if (record.status !== "deferred" || record.expires === (void 0)) {
|
|
188
|
-
continue;
|
|
189
|
-
}
|
|
190
|
-
if (Date.parse(record.expires) > now) {
|
|
191
|
-
continue;
|
|
192
|
-
}
|
|
193
|
-
this.resolve(record.request, "expired");
|
|
194
|
-
expired.push(record);
|
|
195
|
-
}
|
|
196
|
-
return expired;
|
|
197
|
-
}
|
|
198
|
-
|
|
199
|
-
all(): readonly InterruptRecord[] {
|
|
200
|
-
return this.records;
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
get(requestId: Id): InterruptRecord | undefined {
|
|
204
|
-
return this.byRequest.get(requestId);
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
open(): InterruptRecord[] {
|
|
208
|
-
return this.records.filter((record) => record.status === "deferred");
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
grantedCount(): number {
|
|
212
|
-
return this.records.filter((record) => record.status === "granted").length;
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
debtScore(at: Timestamp = this.now()): number {
|
|
216
|
-
return this.broker.debtScore(at);
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
const statusOf: (decision: AttentionDecision) => InterruptStatus = (decision: AttentionDecision): InterruptStatus => {
|
|
221
|
-
if (decision.decision === "grant") {
|
|
222
|
-
return "granted";
|
|
223
|
-
}
|
|
224
|
-
if (decision.decision === "defer") {
|
|
225
|
-
return "deferred";
|
|
226
|
-
}
|
|
227
|
-
return "denied";
|
|
228
|
-
};
|
|
@@ -1,316 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Attention as a bounded, multi-dimensional resource.
|
|
3
|
-
*
|
|
4
|
-
* This is the resource layer above `cognition.ts`:
|
|
5
|
-
* - `ProcessAttention` is the agent-level capacity, reserve and recovery debt.
|
|
6
|
-
* - `ThreadAttention` is the per-task allocation inside that capacity.
|
|
7
|
-
*
|
|
8
|
-
* CPU analogies are structural only: a CPU can run at 100% indefinitely, a
|
|
9
|
-
* person cannot. The policy therefore caps foreground utilization below 1,
|
|
10
|
-
* keeps a safety/reserve floor, and schedules rest when recovery debt is high.
|
|
11
|
-
*/
|
|
12
|
-
import type { Pid } from "../types/common.ts";
|
|
13
|
-
import type { CognitiveState } from "./cognition.ts";
|
|
14
|
-
|
|
15
|
-
export interface AttentionResourcePolicy {
|
|
16
|
-
/**
|
|
17
|
-
* Working-memory chunks assumed when no measured capacity exists.
|
|
18
|
-
*/
|
|
19
|
-
baseSlots: number;
|
|
20
|
-
/**
|
|
21
|
-
* Fraction kept away from foreground work (background, safety, recovery).
|
|
22
|
-
*/
|
|
23
|
-
reserveRatio: number;
|
|
24
|
-
/**
|
|
25
|
-
* Hard safety floor, in slots, reserved even under pressure.
|
|
26
|
-
*/
|
|
27
|
-
safetyFloorRatio: number;
|
|
28
|
-
/**
|
|
29
|
-
* Foreground utilization ceiling; must stay below 1.0.
|
|
30
|
-
*/
|
|
31
|
-
maxForegroundUtil: number;
|
|
32
|
-
/**
|
|
33
|
-
* Minimum allocation for an admitted task, in slots.
|
|
34
|
-
*/
|
|
35
|
-
minSliceSlots: number;
|
|
36
|
-
/**
|
|
37
|
-
* Rest after this many cycles without a rest frame.
|
|
38
|
-
*/
|
|
39
|
-
restAfterCycles: number;
|
|
40
|
-
/**
|
|
41
|
-
* Rest when vigilance falls to this level.
|
|
42
|
-
*/
|
|
43
|
-
vigilanceFloor: number;
|
|
44
|
-
/**
|
|
45
|
-
* Rest when load reaches this level.
|
|
46
|
-
*/
|
|
47
|
-
loadCeiling: number;
|
|
48
|
-
/**
|
|
49
|
-
* Rest when recovery debt reaches this level.
|
|
50
|
-
*/
|
|
51
|
-
recoveryDebtThreshold: number;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
export const DefaultAttentionPolicy: AttentionResourcePolicy = {
|
|
55
|
-
baseSlots: 4,
|
|
56
|
-
reserveRatio: 0.25,
|
|
57
|
-
safetyFloorRatio: 0.1,
|
|
58
|
-
maxForegroundUtil: 0.75,
|
|
59
|
-
minSliceSlots: 1,
|
|
60
|
-
restAfterCycles: 8,
|
|
61
|
-
vigilanceFloor: 0.25,
|
|
62
|
-
loadCeiling: 0.9,
|
|
63
|
-
recoveryDebtThreshold: 0.7,
|
|
64
|
-
};
|
|
65
|
-
|
|
66
|
-
export interface ProcessAttention {
|
|
67
|
-
pid: Pid;
|
|
68
|
-
/**
|
|
69
|
-
* Effective working-memory slots after load penalty.
|
|
70
|
-
*/
|
|
71
|
-
effectiveSlots: number;
|
|
72
|
-
/**
|
|
73
|
-
* Foreground ceiling (`floor(effective * maxForegroundUtil)`).
|
|
74
|
-
*/
|
|
75
|
-
foregroundCap: number;
|
|
76
|
-
/**
|
|
77
|
-
* Slots kept out of foreground allocation.
|
|
78
|
-
*/
|
|
79
|
-
reserveSlots: number;
|
|
80
|
-
/**
|
|
81
|
-
* Hard safety floor inside the reserve.
|
|
82
|
-
*/
|
|
83
|
-
safetySlots: number;
|
|
84
|
-
state: CognitiveState;
|
|
85
|
-
/**
|
|
86
|
-
* [0, 1] accumulated need for rest.
|
|
87
|
-
*/
|
|
88
|
-
recoveryDebt: number;
|
|
89
|
-
/**
|
|
90
|
-
* True when the policy says no foreground work should run.
|
|
91
|
-
*/
|
|
92
|
-
offline: boolean;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
export type ThreadDeferReason = "budget" | "offline" | "low-priority" | "floor";
|
|
96
|
-
|
|
97
|
-
export interface ThreadAttentionCandidate {
|
|
98
|
-
tid: number;
|
|
99
|
-
pid: Pid;
|
|
100
|
-
priority: number;
|
|
101
|
-
/**
|
|
102
|
-
* Desired slots; the planner clamps to capacity.
|
|
103
|
-
*/
|
|
104
|
-
preferredSlots: number;
|
|
105
|
-
/**
|
|
106
|
-
* Minimum slots if admitted; defaults to policy.minSliceSlots.
|
|
107
|
-
*/
|
|
108
|
-
minSlots?: number;
|
|
109
|
-
/**
|
|
110
|
-
* Background tasks use the reserve and never the foreground slot.
|
|
111
|
-
*/
|
|
112
|
-
foreground?: boolean;
|
|
113
|
-
/**
|
|
114
|
-
* Extra pressure from role/context switching.
|
|
115
|
-
*/
|
|
116
|
-
switchCost?: number;
|
|
117
|
-
role?: string;
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export interface ThreadAttention {
|
|
121
|
-
tid: number;
|
|
122
|
-
pid: Pid;
|
|
123
|
-
slots: number;
|
|
124
|
-
foreground: boolean;
|
|
125
|
-
priority: number;
|
|
126
|
-
switchCost: number;
|
|
127
|
-
role?: string;
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
export interface DeferredAttention {
|
|
131
|
-
tid: number;
|
|
132
|
-
reason: ThreadDeferReason;
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
export interface AttentionPlan {
|
|
136
|
-
process: ProcessAttention;
|
|
137
|
-
foreground?: ThreadAttention;
|
|
138
|
-
background: ThreadAttention[];
|
|
139
|
-
deferred: DeferredAttention[];
|
|
140
|
-
/**
|
|
141
|
-
* Allocated slots / effective slots.
|
|
142
|
-
*/
|
|
143
|
-
utilization: number;
|
|
144
|
-
/**
|
|
145
|
-
* Deferred pressure plus switch cost, [0, 1+].
|
|
146
|
-
*/
|
|
147
|
-
pressure: number;
|
|
148
|
-
/**
|
|
149
|
-
* True when the policy wants a rest frame.
|
|
150
|
-
*/
|
|
151
|
-
rest: boolean;
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
const clamp01 = (value: number): number => Math.max(0, Math.min(1, value));
|
|
155
|
-
|
|
156
|
-
export const recoveryDebtOf = (state: CognitiveState): number => {
|
|
157
|
-
return clamp01(0.5 * (1 - state.vigilance) + 0.3 * state.load + 0.2 * state.pLapse);
|
|
158
|
-
};
|
|
159
|
-
|
|
160
|
-
export const shouldRest = (state: CognitiveState, policy: AttentionResourcePolicy = DefaultAttentionPolicy): boolean => {
|
|
161
|
-
return (
|
|
162
|
-
state.cyclesSinceRest >= policy.restAfterCycles ||
|
|
163
|
-
state.vigilance <= policy.vigilanceFloor ||
|
|
164
|
-
state.load >= policy.loadCeiling ||
|
|
165
|
-
recoveryDebtOf(state) >= policy.recoveryDebtThreshold
|
|
166
|
-
);
|
|
167
|
-
};
|
|
168
|
-
|
|
169
|
-
export const processAttention = (pid: Pid, state: CognitiveState, policy: AttentionResourcePolicy = DefaultAttentionPolicy): ProcessAttention => {
|
|
170
|
-
const effectiveSlots = Math.max(1, Math.floor(state.capacityEff));
|
|
171
|
-
const safetySlots = Math.min(effectiveSlots, Math.max(1, Math.floor(effectiveSlots * policy.safetyFloorRatio)));
|
|
172
|
-
const rawCap = Math.max(0, Math.floor(effectiveSlots * policy.maxForegroundUtil));
|
|
173
|
-
const foregroundCap = Math.max(0, Math.min(rawCap, effectiveSlots - safetySlots));
|
|
174
|
-
const reserveSlots = Math.max(safetySlots, effectiveSlots - foregroundCap);
|
|
175
|
-
return {
|
|
176
|
-
pid,
|
|
177
|
-
effectiveSlots,
|
|
178
|
-
foregroundCap,
|
|
179
|
-
reserveSlots,
|
|
180
|
-
safetySlots,
|
|
181
|
-
state,
|
|
182
|
-
recoveryDebt: recoveryDebtOf(state),
|
|
183
|
-
offline: shouldRest(state, policy),
|
|
184
|
-
};
|
|
185
|
-
};
|
|
186
|
-
|
|
187
|
-
const toAttention = (candidate: ThreadAttentionCandidate, slots: number, foreground: boolean): ThreadAttention => {
|
|
188
|
-
const attention: ThreadAttention = {
|
|
189
|
-
tid: candidate.tid,
|
|
190
|
-
pid: candidate.pid,
|
|
191
|
-
slots,
|
|
192
|
-
foreground,
|
|
193
|
-
priority: candidate.priority,
|
|
194
|
-
switchCost: Math.max(0, candidate.switchCost ?? 0),
|
|
195
|
-
};
|
|
196
|
-
if (candidate.role !== (void 0)) {
|
|
197
|
-
attention.role = candidate.role;
|
|
198
|
-
}
|
|
199
|
-
return attention;
|
|
200
|
-
};
|
|
201
|
-
|
|
202
|
-
/**
|
|
203
|
-
* Allocate one foreground task and, from the reserve, background tasks.
|
|
204
|
-
*
|
|
205
|
-
* Floors are intentionally asymmetric: safety is always reserved, every
|
|
206
|
-
* admitted task gets `minSlots`, but a deferred task gets no floor. Guaranteeing
|
|
207
|
-
* a floor to every candidate would make admission meaningless under pressure.
|
|
208
|
-
*/
|
|
209
|
-
export const planAttention = (
|
|
210
|
-
process: ProcessAttention,
|
|
211
|
-
candidates: readonly ThreadAttentionCandidate[],
|
|
212
|
-
policy: AttentionResourcePolicy = DefaultAttentionPolicy,
|
|
213
|
-
): AttentionPlan => {
|
|
214
|
-
const deferred: DeferredAttention[] = [];
|
|
215
|
-
const background: ThreadAttention[] = [];
|
|
216
|
-
const sorted = [...candidates].sort((left, right) => right.priority - left.priority || left.tid - right.tid);
|
|
217
|
-
const foregroundCandidates = sorted.filter((candidate) => candidate.foreground !== false);
|
|
218
|
-
const backgroundCandidates = sorted.filter((candidate) => candidate.foreground === false);
|
|
219
|
-
|
|
220
|
-
if (process.offline) {
|
|
221
|
-
for (const candidate of foregroundCandidates) {
|
|
222
|
-
deferred.push({ tid: candidate.tid, reason: "offline" });
|
|
223
|
-
}
|
|
224
|
-
return {
|
|
225
|
-
process,
|
|
226
|
-
background,
|
|
227
|
-
deferred,
|
|
228
|
-
utilization: 0,
|
|
229
|
-
pressure: 1,
|
|
230
|
-
rest: true,
|
|
231
|
-
};
|
|
232
|
-
}
|
|
233
|
-
|
|
234
|
-
let foreground: ThreadAttention | undefined;
|
|
235
|
-
let remaining = process.foregroundCap;
|
|
236
|
-
for (let index = 0; index < foregroundCandidates.length; index += 1) {
|
|
237
|
-
const candidate = foregroundCandidates[index];
|
|
238
|
-
const minSlots = Math.max(1, candidate.minSlots ?? policy.minSliceSlots);
|
|
239
|
-
if (index === 0 && remaining >= minSlots) {
|
|
240
|
-
const slots = Math.min(remaining, Math.max(minSlots, Math.floor(candidate.preferredSlots)));
|
|
241
|
-
foreground = toAttention(candidate, slots, true);
|
|
242
|
-
remaining -= slots;
|
|
243
|
-
} else {
|
|
244
|
-
deferred.push({ tid: candidate.tid, reason: index === 0 ? "budget" : "low-priority" });
|
|
245
|
-
}
|
|
246
|
-
}
|
|
247
|
-
|
|
248
|
-
let reserveRemaining = Math.max(0, process.effectiveSlots - process.safetySlots - (foreground?.slots ?? 0));
|
|
249
|
-
for (const candidate of backgroundCandidates) {
|
|
250
|
-
const minSlots = Math.max(1, candidate.minSlots ?? policy.minSliceSlots);
|
|
251
|
-
if (reserveRemaining < minSlots) {
|
|
252
|
-
deferred.push({ tid: candidate.tid, reason: "budget" });
|
|
253
|
-
continue;
|
|
254
|
-
}
|
|
255
|
-
const slots = Math.min(reserveRemaining, Math.max(minSlots, Math.floor(candidate.preferredSlots)));
|
|
256
|
-
background.push(toAttention(candidate, slots, false));
|
|
257
|
-
reserveRemaining -= slots;
|
|
258
|
-
}
|
|
259
|
-
|
|
260
|
-
const allocated = (foreground?.slots ?? 0) + background.reduce((sum, task) => sum + task.slots, 0);
|
|
261
|
-
const utilization = allocated / process.effectiveSlots;
|
|
262
|
-
const switchPressure = foreground === (void 0) ? 0 : Math.min(1, foreground.switchCost / Math.max(1, process.effectiveSlots));
|
|
263
|
-
const pressure = Math.min(1.5, deferred.length / Math.max(1, candidates.length) + switchPressure);
|
|
264
|
-
|
|
265
|
-
return {
|
|
266
|
-
process,
|
|
267
|
-
...(foreground === (void 0) ? {} : { foreground }),
|
|
268
|
-
background,
|
|
269
|
-
deferred,
|
|
270
|
-
utilization,
|
|
271
|
-
pressure,
|
|
272
|
-
rest: false,
|
|
273
|
-
};
|
|
274
|
-
};
|
|
275
|
-
|
|
276
|
-
/**
|
|
277
|
-
* Rest restores vigilance, reduces load and clears the rest counter.
|
|
278
|
-
*/
|
|
279
|
-
export const applyRest = (state: CognitiveState, cycles: number = 1): CognitiveState => {
|
|
280
|
-
const amount = Math.max(1, Math.floor(cycles));
|
|
281
|
-
const vigilance = clamp01(state.vigilance + 0.25 * amount);
|
|
282
|
-
const load = clamp01(state.load - 0.2 * amount);
|
|
283
|
-
return {
|
|
284
|
-
...state,
|
|
285
|
-
vigilance,
|
|
286
|
-
load,
|
|
287
|
-
pLapse: clamp01(1 - vigilance),
|
|
288
|
-
cyclesSinceRest: 0,
|
|
289
|
-
};
|
|
290
|
-
};
|
|
291
|
-
|
|
292
|
-
export interface OutcomeStats {
|
|
293
|
-
successes: number;
|
|
294
|
-
attempts: number;
|
|
295
|
-
errors: number;
|
|
296
|
-
rework: number;
|
|
297
|
-
attentionSlots: number;
|
|
298
|
-
}
|
|
299
|
-
|
|
300
|
-
/**
|
|
301
|
-
* Efficiency is useful outcomes per unit of attention, not raw utilization.
|
|
302
|
-
* Errors and rework are subtracted so a busy-but-wrong agent cannot win.
|
|
303
|
-
*/
|
|
304
|
-
export const qualityAdjustedThroughput = (stats: OutcomeStats): number => {
|
|
305
|
-
const useful = Math.max(0, stats.successes - stats.errors - stats.rework);
|
|
306
|
-
return useful / Math.max(1, stats.attentionSlots);
|
|
307
|
-
};
|
|
308
|
-
|
|
309
|
-
export const attentionHealth = (plan: AttentionPlan): { utilization: number; pressure: number; headroom: number; rest: boolean } => {
|
|
310
|
-
return {
|
|
311
|
-
utilization: plan.utilization,
|
|
312
|
-
pressure: plan.pressure,
|
|
313
|
-
headroom: Math.max(0, 1 - plan.utilization),
|
|
314
|
-
rest: plan.rest,
|
|
315
|
-
};
|
|
316
|
-
};
|