@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import { types } from "node:util";
|
|
2
|
-
import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS,
|
|
2
|
+
import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, declarationFaultOf, declarationPath, declarerWord, readToolAxes, receiveDeclaration, toolAxesRefusal, } from "./mcp-server-spec.js";
|
|
3
|
+
import { callerText } from "./caller-text.js";
|
|
3
4
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
4
5
|
import { TOOL_FACE_WORDS, readToolFaces } from "./tool-face-reader.js";
|
|
5
6
|
import { judgeSessionMetaKey } from "./mcp-call-meta.js";
|
|
7
|
+
import { isMcpFaceWord } from "./mounted-mcp.js";
|
|
6
8
|
import { CONFIG_RECEIPT_MODE, optionKeys, strayMembersOf } from "./own-property-receipt.js";
|
|
7
9
|
import { isToolContentOrigin, TOOL_CONTENT_ORIGINS } from "./memory-engine/content-origin.js";
|
|
8
10
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
@@ -150,6 +152,17 @@ export function judgeEntrySessionMetaKey(copy) {
|
|
|
150
152
|
return { ok: true, entry: copy };
|
|
151
153
|
return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${inlineUntrusted(read.problem, 200)}. The key decides where the leg's session id rides on this server's requests, so it is refused rather than dropped or defaulted — a connector keyed on a session it never receives would share one state across every session.`) };
|
|
152
154
|
}
|
|
155
|
+
export function judgeEntryReservedKeys(copy) {
|
|
156
|
+
const reservedKey = (declared) => (isPlainRecord(declared) ? Object.keys(declared).find(isMcpFaceWord) : undefined);
|
|
157
|
+
const problem = (word) => `its key "${word}" is a reserved allowTools face word (a kind of read the engine makes of the server), never a tool name — no tool is ever mounted under it`;
|
|
158
|
+
const axesWord = reservedKey(copy.toolAxes);
|
|
159
|
+
if (axesWord !== undefined)
|
|
160
|
+
return { ok: false, error: toolAxesRefusal("mcp", declarerNameOf(copy.name), problem(axesWord)) };
|
|
161
|
+
const facesWord = reservedKey(copy.toolFaces);
|
|
162
|
+
if (facesWord !== undefined)
|
|
163
|
+
return { ok: false, error: toolFacesRefusal(declarerNameOf(copy.name), problem(facesWord)) };
|
|
164
|
+
return { ok: true, entry: copy };
|
|
165
|
+
}
|
|
153
166
|
const HOST_TRANSPORT_KEYS = optionKeys()({ kind: 0 });
|
|
154
167
|
export function judgeEntryHostTransport(copy) {
|
|
155
168
|
const transport = copy.transport;
|
|
@@ -158,16 +171,21 @@ export function judgeEntryHostTransport(copy) {
|
|
|
158
171
|
const stray = strayMembersOf(transport, { subject: "a host-supplied transport", unit: "member", moment: "when the entry is read" }, HOST_TRANSPORT_KEYS)?.names[0];
|
|
159
172
|
const extra = stray === undefined ? undefined : String(stray);
|
|
160
173
|
const problem = extra !== undefined
|
|
161
|
-
? `a host-supplied transport with the member ${
|
|
174
|
+
? `a host-supplied transport with the member ${callerText(extra)}: a host transport carries its kind alone — the host seat carries what each request needs, so a member here would read as in force while nothing carries it`
|
|
162
175
|
: copy.elicitation === true
|
|
163
176
|
? `elicitation on a host-supplied transport: the server behind a host's pipe is the host's own code, so a question it has for the user goes through the host's own interface — the engine advertises no elicitation for it`
|
|
164
177
|
: undefined;
|
|
165
178
|
return problem === undefined ? { ok: true, entry: copy } : { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${problem}.`) };
|
|
166
179
|
}
|
|
167
180
|
export function judgeMcpEntryDeclarations(copy) {
|
|
181
|
+
const entry = copy;
|
|
182
|
+
if (types.isProxy(entry) || !isPlainRecord(entry)) {
|
|
183
|
+
return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} declaration must be a plain object of the server's members (it is ${typeof entry === "object" && entry !== null && !Array.isArray(entry) ? "an object that is not a plain record: a Proxy, or one that carries a prototype" : callerText(entry)}) — an entry the engine cannot read as one is refused rather than judged ok or let throw.`) };
|
|
184
|
+
}
|
|
168
185
|
const axes = judgeEntryToolAxes(copy, "mcp");
|
|
169
186
|
const faces = axes.ok ? judgeEntryToolFaces(axes.entry) : axes;
|
|
170
|
-
const
|
|
187
|
+
const reserved = faces.ok ? judgeEntryReservedKeys(faces.entry) : faces;
|
|
188
|
+
const metaKey = reserved.ok ? judgeEntrySessionMetaKey(reserved.entry) : reserved;
|
|
171
189
|
return metaKey.ok ? judgeEntryHostTransport(metaKey.entry) : metaKey;
|
|
172
190
|
}
|
|
173
191
|
function declaredEntriesOf(declared, at, where) {
|
package/dist/core/lsp.js
CHANGED
|
@@ -8,6 +8,7 @@ import { Type } from "typebox";
|
|
|
8
8
|
import { defineTool, errorResult } from "./tools.js";
|
|
9
9
|
import { toolFace } from "./tool-catalog-entries.js";
|
|
10
10
|
import { thrownText } from "./thrown-value.js";
|
|
11
|
+
import { envErrorDetail } from "../tools/fs/env-error-detail.js";
|
|
11
12
|
export const LSP_OPERATIONS = [
|
|
12
13
|
"goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol",
|
|
13
14
|
"goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls",
|
|
@@ -107,7 +108,7 @@ export function lspReadGateOf(env, face, authorizedKey) {
|
|
|
107
108
|
return { ok: false, reason: thrownText(e) };
|
|
108
109
|
}
|
|
109
110
|
if (!held.ok)
|
|
110
|
-
return { ok: false, reason: held.error.message };
|
|
111
|
+
return { ok: false, reason: envErrorDetail(held.error.message) };
|
|
111
112
|
if ((await keyOf(filePath, signal)) !== key) {
|
|
112
113
|
await held.value.close();
|
|
113
114
|
return { ok: false, reason: "it resolved to a different file while it was being checked" };
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type RowCorrupt } from "./row-shape.js";
|
|
1
2
|
/** One parked message. `seq` is minted by the store, monotonic per (scope, handle), stable across
|
|
2
3
|
* lease/expiry cycles (a re-leased message keeps its number — dedup/ordering key). */
|
|
3
4
|
export interface MailboxMessage {
|
|
@@ -39,8 +40,26 @@ export type MailboxDecision = (typeof MAILBOX_DECISIONS)[number];
|
|
|
39
40
|
* as `held` — never delivered on a guess, and left for a person (or that newer engine) to decide. */
|
|
40
41
|
export declare function readStoredMailboxDecision(raw: unknown): MailboxDecision | undefined;
|
|
41
42
|
/** The refusal code of a malformed {@link MailboxStore.moveDecision} call (a word outside the
|
|
42
|
-
* closed set, a non-positive seq, or an edge the decision law does not allow). */
|
|
43
|
+
* closed set, a non-positive seq, a holder that is no lease-owner spelling, or an edge the decision law does not allow). */
|
|
43
44
|
export declare const MAILBOX_INVALID_DECISION_MOVE_CODE = "mailbox.invalid_decision_move";
|
|
45
|
+
/** The refusal code of a {@link MailboxStore.claimLease} whose `owner` is not a spelling a lease can be named by
|
|
46
|
+
* ({@link isMailboxNameSpelling}): the owner is the identity the lease fence ({@link mailboxDecisionMoveFenced}) and `ack`
|
|
47
|
+
* compare, so a blank or control-carrying one would make two different holders read as one. */
|
|
48
|
+
export declare const MAILBOX_INVALID_LEASE_OWNER_CODE = "mailbox.invalid_lease_owner";
|
|
49
|
+
/**
|
|
50
|
+
* THE one spelling judge of a name the box keeps and compares by equality — a receipt id, a lease owner, a decision move's holder: a
|
|
51
|
+
* string with visible content ({@link hasVisibleContent}: the one reading of "blank" a principal's name uses too — white space and the
|
|
52
|
+
* format characters, the joiners included, count for nothing), at most {@link NAME_MAX_CHARS} characters, and no control or
|
|
53
|
+
* format character. A blank one names nothing (`"" === ""` reads two holders as the same one; so does a string of one joiner or
|
|
54
|
+
* zero-width mark, which prints as nothing), a control character reads as another line wherever the name is printed, a format
|
|
55
|
+
* character (zero-width, a direction override) prints as nothing or reorders what is printed, and a name of any length is kept in
|
|
56
|
+
* every box record, log line and refusal sentence that carries it. The box keeps the name as an opaque key — it is not required to be
|
|
57
|
+
* a principal's name. Read by the receipt id's mint (`mintCrossPrincipalRecord`), by {@link assertMailboxLeaseOwner} (`claimLease`) and
|
|
58
|
+
* by {@link assertMailboxDecisionMove} (a move's `holder`); each refuses with the code of the call that was malformed.
|
|
59
|
+
*/
|
|
60
|
+
export declare function isMailboxNameSpelling(raw: unknown): raw is string;
|
|
61
|
+
/** The validator `claimLease` runs BEFORE touching storage, in every backend: a malformed owner has zero side effects. */
|
|
62
|
+
export declare function assertMailboxLeaseOwner(owner: unknown): void;
|
|
44
63
|
export declare function isMailboxDecision(value: unknown): value is MailboxDecision;
|
|
45
64
|
/** Final states: the record is never delivered again, by any consumer. */
|
|
46
65
|
export declare function isMailboxDecisionFinal(state: MailboxDecision | undefined): boolean;
|
|
@@ -49,12 +68,22 @@ export declare function isMailboxDecisionDeliverable(state: MailboxDecision | un
|
|
|
49
68
|
/**
|
|
50
69
|
* THE decision law — a decision only moves forward, and every hand-over of a held record is itself a move:
|
|
51
70
|
* absent → `held`; `held` → `approved` / `delivered` / `denied` / `expired` / `refused`; `approved` →
|
|
52
|
-
* `delivered` or a final state; `delivered` → `dropped` (the handed-over frame was refused by policy inside a lease-holding pass) only
|
|
53
|
-
* a final state never moves.
|
|
71
|
+
* `delivered` or a final state; `delivered` → `dropped` (the handed-over frame was refused by policy inside a lease-holding pass) only,
|
|
72
|
+
* and only by the box's lease holder ({@link mailboxDecisionMoveFenced}); a final state never moves.
|
|
54
73
|
*/
|
|
55
74
|
export declare function mailboxDecisionEdgeAllowed(from: MailboxDecision | undefined, to: MailboxDecision): boolean;
|
|
75
|
+
/**
|
|
76
|
+
* THE lease fence of the decision law, the one every backend reads after the record's state matched `expect`:
|
|
77
|
+
* `true` = the move must not happen. A record in `delivered` was handed over — its injection is owed by the consumer
|
|
78
|
+
* that holds the box — so an edge out of `delivered` is taken only by that consumer: the box's current lease must name
|
|
79
|
+
* `holder`, the fence {@link MailboxStore.ack} takes (a lease that lapsed and nobody claimed since is still its holder's;
|
|
80
|
+
* a box with no lease, or a caller that names no holder, holds nothing). Every other edge is a person's or a policy's
|
|
81
|
+
* answer about a held record, which any process may give: the lease is not asked.
|
|
82
|
+
*/
|
|
83
|
+
export declare function mailboxDecisionMoveFenced(expect: MailboxDecision | undefined, leaseOwner: string | undefined, holder: string | undefined): boolean;
|
|
56
84
|
/** What {@link MailboxStore.moveDecision} answers: the move happened, or the record's actual state
|
|
57
|
-
* (`unset` = never held, `gone` = no such record any more — acked, reaped or dropped).
|
|
85
|
+
* (`unset` = never held, `gone` = no such record any more — acked, reaped or dropped). The state is what the caller
|
|
86
|
+
* expected exactly when the lease fence refused it ({@link mailboxDecisionMoveFenced}: `current: "delivered"`). */
|
|
58
87
|
export type MailboxDecisionOutcome = {
|
|
59
88
|
readonly ok: true;
|
|
60
89
|
} | {
|
|
@@ -65,11 +94,12 @@ export type MailboxDecisionOutcome = {
|
|
|
65
94
|
* THE caller-side reading of {@link MailboxStore.moveDecision}: a fault can arrive AFTER the move
|
|
66
95
|
* committed (a lock release that failed, a reply lost on the wire), so a call that throws is asked once
|
|
67
96
|
* more, and a store that already holds `next` answers the first call's success. A second fault throws.
|
|
68
|
-
* Every engine-side decision move goes through this one function.
|
|
97
|
+
* Every engine-side decision move goes through this one function. `holder` = the lease owner the caller
|
|
98
|
+
* claims the box with (see {@link MailboxStore.moveDecision}).
|
|
69
99
|
*/
|
|
70
|
-
export declare function moveMailboxDecision(store: Pick<MailboxStore, "moveDecision">, scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
|
|
100
|
+
export declare function moveMailboxDecision(store: Pick<MailboxStore, "moveDecision">, scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
|
|
71
101
|
/** The one validator every backend runs BEFORE touching storage: a malformed call has zero side effects. */
|
|
72
|
-
export declare function assertMailboxDecisionMove(seq: unknown, expect: unknown, next: unknown): void;
|
|
102
|
+
export declare function assertMailboxDecisionMove(seq: unknown, expect: unknown, next: unknown, holder?: unknown): void;
|
|
73
103
|
/** design/385 — the typed peer-metadata record on a parked message. ONE optional object, one-time
|
|
74
104
|
* contract extension; every field optional. Bundled backends persist it verbatim and hand back a
|
|
75
105
|
* detached copy. */
|
|
@@ -127,7 +157,8 @@ export interface MailboxPeerNoticeMeta {
|
|
|
127
157
|
dropReason?: string;
|
|
128
158
|
/** idle_notice `idle`/`exited`: when the target finished its turn (epoch ms). */
|
|
129
159
|
finishedAt?: number;
|
|
130
|
-
/** idle_notice `idle`: the target's one-line detail (already bounded by the producer).
|
|
160
|
+
/** idle_notice `idle`: the target's one-line detail (already bounded by the producer). delivery_notice `refused`: who refused the
|
|
161
|
+
* message there; `delivered`: what released the held message (`approved` | `rejudge`, the peer-notices `PEER_RELEASE_CAUSES`). */
|
|
131
162
|
detail?: string;
|
|
132
163
|
/** idle_notice `expired` (the requester answering ITSELF): the label the ask carried for the target
|
|
133
164
|
* that never answered — the record's author is the requester, so the target must be named here. */
|
|
@@ -197,7 +228,10 @@ export declare const MAILBOX_TOMBSTONED_RECIPIENT_CODE = "mailbox.recipient_tomb
|
|
|
197
228
|
* A backend may raise the same code with a plain `Error` carrying `.code`; consumers branch on the
|
|
198
229
|
* string, not on this class (a cross-process/out-of-repo store cannot hand back an instance).
|
|
199
230
|
*/
|
|
200
|
-
export type MailboxStoreErrorCode = typeof MAILBOX_TOMBSTONED_RECIPIENT_CODE | typeof MAILBOX_INVALID_PEER_META_CODE | typeof MAILBOX_CROSS_PROCESS_UNSAFE_CODE | typeof MAILBOX_INVALID_DECISION_MOVE_CODE | typeof MAILBOX_INVALID_RECORD_ID_CODE | typeof MAILBOX_DUPLICATE_RECORD_ID_CODE;
|
|
231
|
+
export type MailboxStoreErrorCode = typeof MAILBOX_TOMBSTONED_RECIPIENT_CODE | typeof MAILBOX_INVALID_PEER_META_CODE | typeof MAILBOX_CROSS_PROCESS_UNSAFE_CODE | typeof MAILBOX_INVALID_DECISION_MOVE_CODE | typeof MAILBOX_INVALID_LEASE_OWNER_CODE | typeof MAILBOX_INVALID_RECORD_ID_CODE | typeof MAILBOX_DUPLICATE_RECORD_ID_CODE | typeof MAILBOX_ROW_MALFORMED_CODE;
|
|
232
|
+
/** A parked record (or an append's record) that does not read as {@link MAILBOX_MESSAGE_ROW_SHAPE}: an append refuses it before
|
|
233
|
+
* any side effect; on a held record, an `ack` that would consume past it and a decision move on it are refused. */
|
|
234
|
+
export declare const MAILBOX_ROW_MALFORMED_CODE = "mailbox.row_malformed";
|
|
201
235
|
export declare class MailboxStoreError extends Error {
|
|
202
236
|
readonly code: MailboxStoreErrorCode;
|
|
203
237
|
constructor(code: MailboxStoreErrorCode, message: string);
|
|
@@ -268,6 +302,37 @@ export declare function readMailboxRecordId(raw: unknown): string | undefined;
|
|
|
268
302
|
* mutation while the append waits for its lock, cannot make the record judged differ from the record stored.
|
|
269
303
|
*/
|
|
270
304
|
export declare function readMailboxAppend(msg: MailboxAppendMessage): MailboxAppendMessage;
|
|
305
|
+
/**
|
|
306
|
+
* THE PARKED RECORD'S MEMBER-SHAPE TABLE (`rowShapeReader`, row-shape.ts). `rowKey` is the box replay's predicate for an `append`
|
|
307
|
+
* event's record (an object with a finite `seq`); `members` is what a delivery reads: the content, the stamp, the producer's id
|
|
308
|
+
* ({@link readMailboxRecordId}), the sender name, the forwarding chain (a list of hops, a hole being absence), the peer metadata
|
|
309
|
+
* slot (an object — its words are validated at `append` by {@link readMailboxPeerMeta}; a stored slot whose words another writer
|
|
310
|
+
* chose is the drain's foreign judgment, never this table's) and the hold decision ({@link readStoredMailboxDecision}, which reads
|
|
311
|
+
* a word it does not know as `held`). The exit is `block`: a box is an ordered log, so its records before the first one that does not read are served and
|
|
312
|
+
* nothing at or past that one is leased, acknowledged, counted or swept — the box visibly stops there, every claim tells it, and
|
|
313
|
+
* the remedy is to drop the box or repair the record ({@link mailboxReadablePrefix}).
|
|
314
|
+
*/
|
|
315
|
+
export declare const MAILBOX_MESSAGE_ROW_SHAPE: import("./row-shape.js").RowShapeReader<MailboxMessage>;
|
|
316
|
+
/** A box's held records as a delivery reads them: the readable PREFIX, and — when one does not read — the record it stops at. */
|
|
317
|
+
export interface MailboxReadablePrefix {
|
|
318
|
+
readonly prefix: readonly MailboxMessage[];
|
|
319
|
+
readonly blocked?: {
|
|
320
|
+
readonly seq: number;
|
|
321
|
+
readonly corrupt: RowCorrupt;
|
|
322
|
+
};
|
|
323
|
+
}
|
|
324
|
+
/**
|
|
325
|
+
* The `block` exit over a box's held records (in seq order): the records before the first one that does not read
|
|
326
|
+
* ({@link MAILBOX_MESSAGE_ROW_SHAPE}), and that one. Every bundled backend's lease, ack fence and count read this, so no face serves,
|
|
327
|
+
* consumes or counts past a record nobody can read.
|
|
328
|
+
*/
|
|
329
|
+
export declare function mailboxReadablePrefix(messages: readonly MailboxMessage[]): MailboxReadablePrefix;
|
|
330
|
+
/** The sentence a box's disclosure carries when its delivery stops at a record that does not read. */
|
|
331
|
+
export declare function mailboxBlockedSentence(scope: string, handle: string, blocked: NonNullable<MailboxReadablePrefix["blocked"]>): string;
|
|
332
|
+
/** The refusal of an `ack` that would consume past a record that does not read: nothing is consumed. */
|
|
333
|
+
export declare function mailboxAckBlockedRefusal(blocked: NonNullable<MailboxReadablePrefix["blocked"]>): MailboxStoreError;
|
|
334
|
+
/** The refusal of a decision move on a held record that does not read: nothing moves. */
|
|
335
|
+
export declare function mailboxDecisionOnUnreadableRefusal(corrupt: RowCorrupt): MailboxStoreError;
|
|
271
336
|
/**
|
|
272
337
|
* THE append-by-identity judgment, the one every backend runs inside its write critical section
|
|
273
338
|
* (with `msg` already validated: `id` by {@link readMailboxRecordId}, `peerMeta` by {@link readMailboxPeerMeta}),
|
|
@@ -299,8 +364,16 @@ export declare function judgeMailboxAppendById(box: {
|
|
|
299
364
|
* per window — the row claim-CAS already guarantees one revival winner; this is the belt); the
|
|
300
365
|
* SAME owner re-claiming RENEWS the lease and picks up any newer messages (the crash-retry form
|
|
301
366
|
* — server[1523] 定谳: both bundled impls behave so, the contract follows the implementations).
|
|
367
|
+
* `owner` is a NAME the box compares by equality (the lease fence, `ack`, `releaseLease`): a string with a non-blank character and no
|
|
368
|
+
* control character ({@link isMailboxNameSpelling}); anything else is refused with {@link MAILBOX_INVALID_LEASE_OWNER_CODE} before
|
|
369
|
+
* any read or write ({@link assertMailboxLeaseOwner}, which every backend calls first) — a blank owner would make two holders read as one.
|
|
302
370
|
* - `ack` deletes every message with seq ≤ upToSeq (the winner calls it at ATTACH success, never
|
|
303
371
|
* before — §7.1: ack-late is what makes a crashed revival lossless).
|
|
372
|
+
* - A HELD RECORD THAT DOES NOT READ ({@link MAILBOX_MESSAGE_ROW_SHAPE}; the box's exit is `block`): `claimLease` serves the records
|
|
373
|
+
* before it and leases nothing at or past it (an empty prefix answers `null`); an `ack` whose `upToSeq` reaches it is refused with
|
|
374
|
+
* {@link MAILBOX_ROW_MALFORMED_CODE} and consumes nothing; `peekCount` counts the prefix; a decision move on it is refused in the
|
|
375
|
+
* same code. Nothing removes it but `drop` (or a repair of its bytes) — so a producer's retry under a later record's id is never
|
|
376
|
+
* absorbed by a received window the stuck record was folded past. {@link mailboxReadablePrefix} is the one reading.
|
|
304
377
|
* - `releaseLease` (best-effort) returns a lease early (spawn preflight failed before delivery).
|
|
305
378
|
* - `reap` ages out whole mailboxes by newest-message age (explicit policy). It is the BACKSTOP, not
|
|
306
379
|
* the only reclaim path: the winning-delete arm of `reapDurableAgents` calls {@link MailboxStore.drop}
|
|
@@ -343,6 +416,9 @@ export declare function judgeMailboxAppendById(box: {
|
|
|
343
416
|
* high-water mark, and the same judgment answers from it: the consumed record's `seq` (nothing written),
|
|
344
417
|
* or the refusal. `drop` clears the window; `reap` keeps it. Acceptance: the window cases of
|
|
345
418
|
* `mailboxStoreContract` (T1) and `mailboxCrossProcessContract` (T2).
|
|
419
|
+
* {@link MailboxStore.replayOf} is the same judgment asked without writing: a caller that must know whether
|
|
420
|
+
* its record is a repeat BEFORE it spends anything on it (a delivery gate's quota, an inbox bound) asks that,
|
|
421
|
+
* and the answer is the one `append` would give.
|
|
346
422
|
* - CROSS-PROCESS SAFETY (design/385, optional capability declared on the store): the session-box
|
|
347
423
|
* drain shares ONE box between several OS processes. A backend that is correct under that sharing —
|
|
348
424
|
* seq minted once across processes, lease/ack never crossing, one process's housekeeping never
|
|
@@ -370,6 +446,17 @@ export interface MailboxStore {
|
|
|
370
446
|
/** Durably park one message. Refuses `"mailbox.recipient_tombstoned"` when the backend can see
|
|
371
447
|
* that its recipient is in the deployment's pre-delete state (see the interface notes above). */
|
|
372
448
|
append(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number>;
|
|
449
|
+
/**
|
|
450
|
+
* Would `append(scope, handle, msg)` be a REPEAT? The read-only form of the record-identity judgment: the `seq`
|
|
451
|
+
* an append of `msg` would answer from a record the box holds or has received ({@link judgeMailboxAppendById}),
|
|
452
|
+
* `undefined` when it would write a new record (`msg` states no `id`, or the box has none under it), and the
|
|
453
|
+
* {@link MAILBOX_DUPLICATE_RECORD_ID_CODE} refusal an append would give when a different record holds the id.
|
|
454
|
+
* Writes nothing, creates no box, mints no seq, and does not consult the recipient's pre-delete state: a record
|
|
455
|
+
* the box already took is answered with its first `seq` whether or not its recipient is being deleted since. A
|
|
456
|
+
* malformed `msg` is refused with the codes `append` refuses it with, before anything is read. An answer is a
|
|
457
|
+
* snapshot: a repeat racing the first append can still read `undefined`, and its `append` then decides.
|
|
458
|
+
*/
|
|
459
|
+
replayOf(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number | undefined>;
|
|
373
460
|
claimLease(scope: string, handle: string, owner: string, ttlMs: number, now?: number): Promise<MailboxLease | null>;
|
|
374
461
|
/**
|
|
375
462
|
* Consume the leased prefix up to `upToSeq` (the records are DELETED). Fenced by the current lease:
|
|
@@ -385,15 +472,20 @@ export interface MailboxStore {
|
|
|
385
472
|
ack(scope: string, handle: string, owner: string, upToSeq: number): Promise<MailboxAckResult>;
|
|
386
473
|
/**
|
|
387
474
|
* Move one record's hold decision from `expect` (absent = never held) to `next`, atomically
|
|
388
|
-
* against every other transition and against `ack` — the compare-and-set every decision
|
|
389
|
-
* record goes through.
|
|
390
|
-
* record, whether or not it holds the box.
|
|
391
|
-
*
|
|
392
|
-
*
|
|
393
|
-
*
|
|
394
|
-
*
|
|
475
|
+
* against every other transition, against `claimLease` and against `ack` — the compare-and-set every decision
|
|
476
|
+
* about a held record goes through. A person's or a policy's answer about a held record is NOT fenced by the
|
|
477
|
+
* lease: it comes from whichever process shows the record, whether or not it holds the box. An edge out of
|
|
478
|
+
* `delivered` is: the record was handed over and its injection is owed by the box's lease holder, so the move
|
|
479
|
+
* happens only when the box's CURRENT lease names `holder` (the lease owner the caller claims the box with —
|
|
480
|
+
* the fence {@link ack} takes, read in the same atomic step as the record's state; {@link mailboxDecisionMoveFenced}
|
|
481
|
+
* is the one reading). `holder` absent = the caller claims no lease; on every other edge it is not read. A state
|
|
482
|
+
* that is not `expect` answers `{ ok: false, current }` and changes nothing; a move the lease fence refuses answers
|
|
483
|
+
* `{ ok: false, current: "delivered" }` and changes nothing; a record no longer in the box answers
|
|
484
|
+
* `current: "gone"`. A malformed call (see {@link assertMailboxDecisionMove}) is refused with
|
|
485
|
+
* {@link MAILBOX_INVALID_DECISION_MOVE_CODE} before any side effect. The state is durable like the record, and
|
|
486
|
+
* `ack` / `reap` / `drop` remove it with the record.
|
|
395
487
|
*/
|
|
396
|
-
moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
|
|
488
|
+
moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
|
|
397
489
|
releaseLease(scope: string, handle: string, owner: string): Promise<void>;
|
|
398
490
|
/** Observation face (the "N pending" receipt figure) — count of currently-visible messages. */
|
|
399
491
|
peekCount(scope: string, handle: string): Promise<number>;
|
|
@@ -503,9 +595,10 @@ export declare class InMemoryMailboxStore implements MailboxStore {
|
|
|
503
595
|
private key;
|
|
504
596
|
private box;
|
|
505
597
|
append(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number>;
|
|
598
|
+
replayOf(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number | undefined>;
|
|
506
599
|
claimLease(scope: string, handle: string, owner: string, ttlMs: number, now?: number): Promise<MailboxLease | null>;
|
|
507
600
|
ack(scope: string, handle: string, owner: string, upToSeq: number): Promise<MailboxAckResult>;
|
|
508
|
-
moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
|
|
601
|
+
moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
|
|
509
602
|
releaseLease(scope: string, handle: string, owner: string): Promise<void>;
|
|
510
603
|
peekCount(scope: string, handle: string): Promise<number>;
|
|
511
604
|
drop(scope: string, handle: string): Promise<void>;
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
+
import { isFiniteNumber, isListOf, isRecord, isRowCorrupt, isString, optional, required, rowShapeReader, takesExit, via } from "./row-shape.js";
|
|
2
3
|
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
4
|
import { readMemberGroup } from "./member-group.js";
|
|
5
|
+
import { NAME_MAX_CHARS, hasVisibleContent } from "./principal-name.js";
|
|
4
6
|
export const MAILBOX_DECISIONS = Object.freeze(["held", "approved", "delivered", "denied", "expired", "refused", "dropped"]);
|
|
5
7
|
export function readStoredMailboxDecision(raw) {
|
|
6
8
|
if (raw === undefined)
|
|
@@ -8,6 +10,17 @@ export function readStoredMailboxDecision(raw) {
|
|
|
8
10
|
return isMailboxDecision(raw) ? raw : "held";
|
|
9
11
|
}
|
|
10
12
|
export const MAILBOX_INVALID_DECISION_MOVE_CODE = "mailbox.invalid_decision_move";
|
|
13
|
+
export const MAILBOX_INVALID_LEASE_OWNER_CODE = "mailbox.invalid_lease_owner";
|
|
14
|
+
const CONTROL_CHARACTER = /\p{Cc}/u;
|
|
15
|
+
const FORMAT_CHARACTER = /(?![\u200c\u200d])\p{Cf}/u;
|
|
16
|
+
export function isMailboxNameSpelling(raw) {
|
|
17
|
+
return typeof raw === "string" && hasVisibleContent(raw) && raw.length <= NAME_MAX_CHARS && !CONTROL_CHARACTER.test(raw) && !FORMAT_CHARACTER.test(raw);
|
|
18
|
+
}
|
|
19
|
+
export function assertMailboxLeaseOwner(owner) {
|
|
20
|
+
if (!isMailboxNameSpelling(owner)) {
|
|
21
|
+
throw new MailboxStoreError(MAILBOX_INVALID_LEASE_OWNER_CODE, `MailboxStore.claimLease: owner must be a string with a non-blank character and no control character, no format character, and at most ${NAME_MAX_CHARS} characters`);
|
|
22
|
+
}
|
|
23
|
+
}
|
|
11
24
|
export function isMailboxDecision(value) {
|
|
12
25
|
return typeof value === "string" && MAILBOX_DECISIONS.includes(value);
|
|
13
26
|
}
|
|
@@ -28,21 +41,26 @@ export function mailboxDecisionEdgeAllowed(from, to) {
|
|
|
28
41
|
return to === "dropped";
|
|
29
42
|
return false;
|
|
30
43
|
}
|
|
31
|
-
export
|
|
44
|
+
export function mailboxDecisionMoveFenced(expect, leaseOwner, holder) {
|
|
45
|
+
return expect === "delivered" && (holder === undefined || leaseOwner !== holder);
|
|
46
|
+
}
|
|
47
|
+
export async function moveMailboxDecision(store, scope, handle, seq, expect, next, holder) {
|
|
32
48
|
try {
|
|
33
|
-
return await store.moveDecision(scope, handle, seq, expect, next);
|
|
49
|
+
return await store.moveDecision(scope, handle, seq, expect, next, holder);
|
|
34
50
|
}
|
|
35
51
|
catch {
|
|
36
|
-
const again = await store.moveDecision(scope, handle, seq, expect, next);
|
|
52
|
+
const again = await store.moveDecision(scope, handle, seq, expect, next, holder);
|
|
37
53
|
return !again.ok && again.current === next ? { ok: true } : again;
|
|
38
54
|
}
|
|
39
55
|
}
|
|
40
|
-
export function assertMailboxDecisionMove(seq, expect, next) {
|
|
56
|
+
export function assertMailboxDecisionMove(seq, expect, next, holder) {
|
|
41
57
|
const refuse = (why) => {
|
|
42
58
|
throw new MailboxStoreError(MAILBOX_INVALID_DECISION_MOVE_CODE, `MailboxStore.moveDecision: ${why}`);
|
|
43
59
|
};
|
|
44
60
|
if (typeof seq !== "number" || !Number.isInteger(seq) || seq < 1)
|
|
45
61
|
refuse(`seq must be a positive integer (got ${String(seq)})`);
|
|
62
|
+
if (holder !== undefined && !isMailboxNameSpelling(holder))
|
|
63
|
+
refuse(`holder must be absent or a lease owner spelling — a string with a non-blank character and no control character, no format character, and at most ${NAME_MAX_CHARS} characters (got ${typeof holder === "string" ? "a string that is not one" : typeof holder})`);
|
|
46
64
|
if (expect !== undefined && !isMailboxDecision(expect))
|
|
47
65
|
refuse(`expect must be absent or one of ${MAILBOX_DECISIONS.join("|")}`);
|
|
48
66
|
if (!isMailboxDecision(next))
|
|
@@ -144,6 +162,7 @@ export function cloneMailboxPeerMeta(meta) {
|
|
|
144
162
|
return meta === undefined ? undefined : { ...meta, ...(meta.notice !== undefined ? { notice: { ...meta.notice } } : {}) };
|
|
145
163
|
}
|
|
146
164
|
export const MAILBOX_TOMBSTONED_RECIPIENT_CODE = "mailbox.recipient_tombstoned";
|
|
165
|
+
export const MAILBOX_ROW_MALFORMED_CODE = "mailbox.row_malformed";
|
|
147
166
|
export class MailboxStoreError extends Error {
|
|
148
167
|
code;
|
|
149
168
|
constructor(code, message) {
|
|
@@ -183,14 +202,62 @@ export function readMailboxAppend(msg) {
|
|
|
183
202
|
const content = msg.content;
|
|
184
203
|
const sentAt = msg.sentAt;
|
|
185
204
|
const hopChain = msg.hopChain;
|
|
186
|
-
|
|
205
|
+
const record = {
|
|
187
206
|
...(id !== undefined ? { id } : {}),
|
|
188
207
|
...(from !== undefined ? { from } : {}),
|
|
189
208
|
content,
|
|
190
209
|
sentAt,
|
|
191
|
-
...(hopChain !== undefined ? { hopChain
|
|
210
|
+
...(hopChain !== undefined ? { hopChain } : {}),
|
|
192
211
|
...(peerMeta !== undefined ? { peerMeta } : {}),
|
|
193
212
|
};
|
|
213
|
+
const answer = MAILBOX_MESSAGE_ROW_SHAPE.admit(record, { key: "" }, ["members"]);
|
|
214
|
+
if (isRowCorrupt(answer))
|
|
215
|
+
throw new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.append: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(answer)}`);
|
|
216
|
+
return { ...record, ...(hopChain !== undefined ? { hopChain: [...hopChain] } : {}) };
|
|
217
|
+
}
|
|
218
|
+
const isChainHop = (v) => (v === undefined || v === null || typeof v === "string" ? undefined : "is not a string");
|
|
219
|
+
export const MAILBOX_MESSAGE_ROW_SHAPE = rowShapeReader({
|
|
220
|
+
family: "mailbox",
|
|
221
|
+
code: MAILBOX_ROW_MALFORMED_CODE,
|
|
222
|
+
sentence: "This mailbox holds a record that does not read the way this engine reads a parked message — an earlier engine release wrote it, or it was changed in storage. Delivery stops in front of it: the records before it are delivered, and nothing at or after it is leased, acknowledged or counted until the box is dropped or the record repaired.",
|
|
223
|
+
exit: "block",
|
|
224
|
+
segments: [
|
|
225
|
+
{ name: "rowKey", entries: [required("seq", isFiniteNumber)] },
|
|
226
|
+
{
|
|
227
|
+
name: "members",
|
|
228
|
+
entries: [
|
|
229
|
+
required("content", isString),
|
|
230
|
+
required("sentAt", isFiniteNumber),
|
|
231
|
+
via("id", readMailboxRecordId),
|
|
232
|
+
optional("from", isString),
|
|
233
|
+
optional("hopChain", isListOf(isChainHop)),
|
|
234
|
+
optional("peerMeta", isRecord),
|
|
235
|
+
via("decision", readStoredMailboxDecision),
|
|
236
|
+
],
|
|
237
|
+
},
|
|
238
|
+
],
|
|
239
|
+
});
|
|
240
|
+
export function mailboxReadablePrefix(messages) {
|
|
241
|
+
const prefix = [];
|
|
242
|
+
for (const m of messages) {
|
|
243
|
+
const answer = MAILBOX_MESSAGE_ROW_SHAPE.read(m, { key: String(m.seq) });
|
|
244
|
+
if (!isRowCorrupt(answer)) {
|
|
245
|
+
prefix.push(answer.row);
|
|
246
|
+
continue;
|
|
247
|
+
}
|
|
248
|
+
takesExit(answer, "block", "mailbox delivery");
|
|
249
|
+
return { prefix, blocked: { seq: m.seq, corrupt: answer } };
|
|
250
|
+
}
|
|
251
|
+
return { prefix };
|
|
252
|
+
}
|
|
253
|
+
export function mailboxBlockedSentence(scope, handle, blocked) {
|
|
254
|
+
return `mailbox (${JSON.stringify(scope)}, ${JSON.stringify(handle)}): the record at seq ${blocked.seq} does not read (${blocked.corrupt.why}) — delivery stops in front of it`;
|
|
255
|
+
}
|
|
256
|
+
export function mailboxAckBlockedRefusal(blocked) {
|
|
257
|
+
return new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.ack: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(blocked.corrupt)} Nothing was consumed: an ack stops before seq ${blocked.seq}.`);
|
|
258
|
+
}
|
|
259
|
+
export function mailboxDecisionOnUnreadableRefusal(corrupt) {
|
|
260
|
+
return new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.moveDecision: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(corrupt)}`);
|
|
194
261
|
}
|
|
195
262
|
function facetSpelling(v) {
|
|
196
263
|
if (v === undefined || v === null)
|
|
@@ -288,15 +355,26 @@ export class InMemoryMailboxStore {
|
|
|
288
355
|
b.messages.push({ seq, ...record });
|
|
289
356
|
return seq;
|
|
290
357
|
}
|
|
358
|
+
async replayOf(scope, handle, msg) {
|
|
359
|
+
if (scope === undefined || scope === "")
|
|
360
|
+
throw new Error("MailboxStore.replayOf: refusing a message without a scope");
|
|
361
|
+
const record = readMailboxAppend(msg);
|
|
362
|
+
const b = this.boxes.get(this.key(scope, handle));
|
|
363
|
+
return judgeMailboxAppendById({ held: b?.messages ?? [], consumed: b?.consumed ?? [] }, record);
|
|
364
|
+
}
|
|
291
365
|
async claimLease(scope, handle, owner, ttlMs, now = Date.now()) {
|
|
366
|
+
assertMailboxLeaseOwner(owner);
|
|
292
367
|
const b = this.boxes.get(this.key(scope, handle));
|
|
293
|
-
if (!b
|
|
368
|
+
if (!b)
|
|
369
|
+
return null;
|
|
370
|
+
const { prefix } = mailboxReadablePrefix(b.messages);
|
|
371
|
+
if (prefix.length === 0)
|
|
294
372
|
return null;
|
|
295
373
|
if (b.lease !== undefined && b.lease.expiresAt > now && b.lease.owner !== owner)
|
|
296
374
|
return null;
|
|
297
|
-
const maxSeq =
|
|
375
|
+
const maxSeq = prefix[prefix.length - 1].seq;
|
|
298
376
|
b.lease = { owner, expiresAt: now + ttlMs, maxSeq };
|
|
299
|
-
return { messages:
|
|
377
|
+
return { messages: prefix.map((m) => detachMailboxMessage(m)), maxSeq };
|
|
300
378
|
}
|
|
301
379
|
async ack(scope, handle, owner, upToSeq) {
|
|
302
380
|
const b = this.boxes.get(this.key(scope, handle));
|
|
@@ -304,19 +382,28 @@ export class InMemoryMailboxStore {
|
|
|
304
382
|
return { acked: false };
|
|
305
383
|
if (b.lease === undefined || b.lease.owner !== owner)
|
|
306
384
|
return { acked: false };
|
|
385
|
+
const { blocked } = mailboxReadablePrefix(b.messages);
|
|
386
|
+
if (blocked !== undefined && upToSeq >= blocked.seq)
|
|
387
|
+
throw mailboxAckBlockedRefusal(blocked);
|
|
307
388
|
b.consumed = foldMailboxConsumed(b.consumed, b.messages.filter((m) => m.seq <= upToSeq));
|
|
308
389
|
b.messages = b.messages.filter((m) => m.seq > upToSeq);
|
|
309
390
|
if (b.lease.maxSeq <= upToSeq)
|
|
310
391
|
b.lease = undefined;
|
|
311
392
|
return { acked: true };
|
|
312
393
|
}
|
|
313
|
-
async moveDecision(scope, handle, seq, expect, next) {
|
|
314
|
-
assertMailboxDecisionMove(seq, expect, next);
|
|
315
|
-
const
|
|
394
|
+
async moveDecision(scope, handle, seq, expect, next, holder) {
|
|
395
|
+
assertMailboxDecisionMove(seq, expect, next, holder);
|
|
396
|
+
const b = this.boxes.get(this.key(scope, handle));
|
|
397
|
+
const m = b?.messages.find((x) => x.seq === seq);
|
|
316
398
|
if (m === undefined)
|
|
317
399
|
return { ok: false, current: "gone" };
|
|
400
|
+
const read = MAILBOX_MESSAGE_ROW_SHAPE.read(m, { key: String(m.seq) });
|
|
401
|
+
if (isRowCorrupt(read))
|
|
402
|
+
throw mailboxDecisionOnUnreadableRefusal(read);
|
|
318
403
|
if (m.decision !== expect)
|
|
319
404
|
return { ok: false, current: m.decision ?? "unset" };
|
|
405
|
+
if (mailboxDecisionMoveFenced(expect, b?.lease?.owner, holder))
|
|
406
|
+
return { ok: false, current: m.decision ?? "unset" };
|
|
320
407
|
m.decision = next;
|
|
321
408
|
return { ok: true };
|
|
322
409
|
}
|
|
@@ -326,7 +413,8 @@ export class InMemoryMailboxStore {
|
|
|
326
413
|
b.lease = undefined;
|
|
327
414
|
}
|
|
328
415
|
async peekCount(scope, handle) {
|
|
329
|
-
|
|
416
|
+
const b = this.boxes.get(this.key(scope, handle));
|
|
417
|
+
return b === undefined ? 0 : mailboxReadablePrefix(b.messages).prefix.length;
|
|
330
418
|
}
|
|
331
419
|
async drop(scope, handle) {
|
|
332
420
|
this.boxes.delete(this.key(scope, handle));
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
2
|
import { types } from "node:util";
|
|
3
3
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
4
|
-
import { callerText, dataKind } from "./
|
|
4
|
+
import { callerText, dataKind } from "./caller-text.js";
|
|
5
5
|
export const MCP_TOOL_USE_ID_META_KEY = "sema/toolUseId";
|
|
6
6
|
export const MCP_REQUEST_META_KEY = "sema/requestMeta";
|
|
7
7
|
export const MCP_REQUEST_META_MAX_BYTES = 262_144;
|
|
@@ -14,7 +14,8 @@
|
|
|
14
14
|
* a revived one), so the DECLARATION stays the one source of truth — no handle is ever recorded anywhere.
|
|
15
15
|
*
|
|
16
16
|
* THE KEY is the server's declaration as the dial reads it (name and transport) and the principal the task runs under: a
|
|
17
|
-
* different principal is a different identity at the server.
|
|
17
|
+
* different principal is a different identity at the server. A task whose isolation scope names a partition other than that
|
|
18
|
+
* person adds it to the key (a connection's state between requests is one partition's working state). The transport holds no value (a declaration carries at most an
|
|
18
19
|
* opaque credential reference, so two references that differ never share a connection); the pieces a request carries are the
|
|
19
20
|
* peer seat's, asked under this same identity, so every holder of a connection sends what the one seat answers for it. A server that opted in to elicitation never enters the pool — the
|
|
20
21
|
* answer to its questions belongs to the leg that is waiting on it.
|
|
@@ -50,8 +51,13 @@ export declare class McpConnectionPool {
|
|
|
50
51
|
* So is the startup bound the dial runs under (`startupMs`, the dial's one reading of {@link mcpStartupTimeoutMs}, threaded like `kind`):
|
|
51
52
|
* a connection is dialled under the declaration of the mount that dials it, so a mount never waits on, or shares, a dial bounded by
|
|
52
53
|
* another mount's clock. No bound in force (none declared, no environment seat) leaves the key as it always was.
|
|
54
|
+
* So is the task's isolation scope (`isolationScope`, the value of `isolationScopeOf(spec)` — `isolation-scope.ts`) when it names a
|
|
55
|
+
* partition other than the person: what a connection holds between requests (a server-side session, its state) belongs to the working
|
|
56
|
+
* state of one partition, so the same person in two partitions holds two connections. The identity the connection presents at the server
|
|
57
|
+
* stays the person's (`principal`). A partition that is the person (no `TaskSpec.isolationScope`, or the same string) leaves the key as it
|
|
58
|
+
* always was.
|
|
53
59
|
*/
|
|
54
|
-
static keyOf(spec: McpServerSpec, principal: string | undefined, kind: string | undefined, startupMs: number | undefined): string;
|
|
60
|
+
static keyOf(spec: McpServerSpec, principal: string | undefined, kind: string | undefined, startupMs: number | undefined, isolationScope?: string): string;
|
|
55
61
|
/**
|
|
56
62
|
* Lease the connection for `key`, dialling it with `dial` when none is live. `fresh` replaces the pool's current connection with a new
|
|
57
63
|
* dial (a re-dial): the connection it replaces lives on until its other holders release it. Resolves `undefined` once the pool is
|
|
@@ -10,7 +10,7 @@ export class McpConnectionPool {
|
|
|
10
10
|
dialing = new Map();
|
|
11
11
|
generation = new Map();
|
|
12
12
|
shut = false;
|
|
13
|
-
static keyOf(spec, principal, kind, startupMs) {
|
|
13
|
+
static keyOf(spec, principal, kind, startupMs, isolationScope) {
|
|
14
14
|
const rest = Object.fromEntries(Object.keys(spec.transport).filter((k) => k !== "kind").map((k) => [k, Reflect.get(spec.transport, k)]));
|
|
15
15
|
const fingerprint = spec.fingerprint;
|
|
16
16
|
const identity = [spec.name, kind ?? null, rest, principal ?? null];
|
|
@@ -18,6 +18,8 @@ export class McpConnectionPool {
|
|
|
18
18
|
identity.push(fingerprint);
|
|
19
19
|
if (startupMs !== undefined)
|
|
20
20
|
identity.push({ startupTimeoutMs: startupMs });
|
|
21
|
+
if (isolationScope !== undefined && isolationScope !== principal)
|
|
22
|
+
identity.push({ isolationScope });
|
|
21
23
|
return canonicalize(identity);
|
|
22
24
|
}
|
|
23
25
|
async acquire(key, dial, opts) {
|
|
@@ -34,10 +34,13 @@ import type { McpTransportKind } from "./mcp-server-spec.js";
|
|
|
34
34
|
* remote, or handed its dial no pipe the engine could take (it said so, or what it handed is no
|
|
35
35
|
* transport or was already taken): nothing ran, and nothing is said about whether the remote can be
|
|
36
36
|
* reached;
|
|
37
|
+
* · `revoked` — the deployment's revocation ledger answered that the server or peer is withdrawn, so the engine did not send
|
|
38
|
+
* the request — or, at a redirect, its next hop (protocol-revocation.ts): nothing is said about whether the remote
|
|
39
|
+
* can be reached;
|
|
37
40
|
* · `unknown` — the thrown value carried no structure this table reads, or the host seat took the request
|
|
38
41
|
* and cannot tell how it ended (said at the dial, nothing of the caller's was sent either way).
|
|
39
42
|
*/
|
|
40
|
-
export declare const MCP_FAILURE_KINDS: readonly ["connect_refused", "connection_failed", "connection_closed", "unauthorized", "http_status", "not_mcp_response", "spawn_failed", "timeout", "protocol", "invalid_config", "credential_unavailable", "host_refused", "unknown"];
|
|
43
|
+
export declare const MCP_FAILURE_KINDS: readonly ["connect_refused", "connection_failed", "connection_closed", "unauthorized", "http_status", "not_mcp_response", "spawn_failed", "timeout", "protocol", "invalid_config", "credential_unavailable", "host_refused", "revoked", "unknown"];
|
|
41
44
|
export type McpFailureKind = (typeof MCP_FAILURE_KINDS)[number];
|
|
42
45
|
/**
|
|
43
46
|
* Why a server is `unauthorized` ({@link McpAuthorization.reason}), closed:
|
|
@@ -90,6 +93,7 @@ export declare const DELIVERED_BY_KIND: {
|
|
|
90
93
|
readonly invalid_config: "no";
|
|
91
94
|
readonly credential_unavailable: "no";
|
|
92
95
|
readonly host_refused: "no";
|
|
96
|
+
readonly revoked: "unknown";
|
|
93
97
|
readonly unknown: "unknown";
|
|
94
98
|
};
|
|
95
99
|
/** The fence over the delivery table: `never` while every kind has a verdict. */
|
|
@@ -154,6 +158,7 @@ export declare const LIVENESS_BY_FAILURE_KIND: {
|
|
|
154
158
|
readonly invalid_config: undefined;
|
|
155
159
|
readonly credential_unavailable: undefined;
|
|
156
160
|
readonly host_refused: undefined;
|
|
161
|
+
readonly revoked: undefined;
|
|
157
162
|
readonly unknown: "unknown";
|
|
158
163
|
};
|
|
159
164
|
/** The fence over the liveness table: `never` while every kind has a verdict. */
|