@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
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { readlinkSync } from "node:fs";
|
|
2
|
+
import { hostname, uptime } from "node:os";
|
|
3
|
+
import { hrtime } from "node:process";
|
|
4
|
+
import { execFileSync } from "node:child_process";
|
|
5
|
+
import { inheritedHostEnv } from "./secret-env.js";
|
|
6
|
+
const UNCHECKABLE_TEXT = Object.freeze({
|
|
7
|
+
another_host: "it was written on another host",
|
|
8
|
+
another_pid_namespace: "it was written in another pid namespace (another container, or one this process cannot name)",
|
|
9
|
+
pid_namespace_unrecorded: "it was written without naming its pid namespace (by an engine before this one, or by a process that could not read it), and this host has more than one",
|
|
10
|
+
start_time_unknown: "no start time could be compared, so a process now holding that pid cannot be told apart from the one that wrote it",
|
|
11
|
+
probe_refused: "the process table refused the question",
|
|
12
|
+
});
|
|
13
|
+
export function uncheckableProcessText(why) {
|
|
14
|
+
return UNCHECKABLE_TEXT[why];
|
|
15
|
+
}
|
|
16
|
+
const START_TIME_TOLERANCE_MS = 2_000;
|
|
17
|
+
const START_TIME_PROBE_TIMEOUT_MS = 2_000;
|
|
18
|
+
const START_TIME_PROBE_PRECISION_MS = 250;
|
|
19
|
+
const ETIME_PATTERN = /^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/;
|
|
20
|
+
const PID_NAMESPACE_LINK = "/proc/self/ns/pid";
|
|
21
|
+
let cachedHostname;
|
|
22
|
+
let cachedPidNamespace;
|
|
23
|
+
let selfFingerprint;
|
|
24
|
+
let startTimeProbeUnavailable = false;
|
|
25
|
+
function thisHost() {
|
|
26
|
+
return (cachedHostname ??= hostname());
|
|
27
|
+
}
|
|
28
|
+
function uptimeMs() {
|
|
29
|
+
try {
|
|
30
|
+
return Math.round(uptime() * 1000);
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
return null;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
function ownPidNamespace() {
|
|
37
|
+
if (cachedPidNamespace === undefined) {
|
|
38
|
+
try {
|
|
39
|
+
const link = readlinkSync(PID_NAMESPACE_LINK);
|
|
40
|
+
cachedPidNamespace = typeof link === "string" && link !== "" ? link : null;
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
cachedPidNamespace = null;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return cachedPidNamespace;
|
|
47
|
+
}
|
|
48
|
+
function announceStartTimeDegrade(reason) {
|
|
49
|
+
if (startTimeProbeUnavailable)
|
|
50
|
+
return;
|
|
51
|
+
startTimeProbeUnavailable = true;
|
|
52
|
+
console.warn(`[sema] this host cannot report process start times (${reason}), so a record naming a process — a file store's ` +
|
|
53
|
+
`directory lock, a run claim, a memory writer's session account — is judged by PID ALONE. A record left behind ` +
|
|
54
|
+
`by a crashed process whose pid the OS has since handed to an unrelated process then reads as a LIVE owner: a ` +
|
|
55
|
+
`lock or claim stays refused until it is removed by hand, and a writer's account stays open until its session ` +
|
|
56
|
+
`resumes or the host closes it.`);
|
|
57
|
+
}
|
|
58
|
+
const START_TIME_PROBE_ATTEMPTS = 3;
|
|
59
|
+
function probeStartTimes(pid) {
|
|
60
|
+
for (let attempt = 0; attempt < START_TIME_PROBE_ATTEMPTS; attempt++) {
|
|
61
|
+
const reading = probeStartTimesOnce(pid);
|
|
62
|
+
if (reading !== "imprecise")
|
|
63
|
+
return reading;
|
|
64
|
+
}
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
function probeStartTimesOnce(pid) {
|
|
68
|
+
if (startTimeProbeUnavailable)
|
|
69
|
+
return null;
|
|
70
|
+
const knownToExist = pid === process.pid;
|
|
71
|
+
if (process.platform === "win32") {
|
|
72
|
+
announceStartTimeDegrade("no ps(1) on win32");
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
const monotonicBefore = hrtime.bigint();
|
|
76
|
+
const wallBefore = Date.now();
|
|
77
|
+
const uptimeBefore = uptimeMs();
|
|
78
|
+
if (uptimeBefore === null) {
|
|
79
|
+
announceStartTimeDegrade("the host refused its uptime");
|
|
80
|
+
return null;
|
|
81
|
+
}
|
|
82
|
+
let raw;
|
|
83
|
+
try {
|
|
84
|
+
raw = execFileSync("ps", ["-p", String(pid), "-o", "etime="], {
|
|
85
|
+
encoding: "utf8",
|
|
86
|
+
timeout: START_TIME_PROBE_TIMEOUT_MS,
|
|
87
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
88
|
+
env: { ...inheritedHostEnv("scrub"), LC_ALL: "C", LANG: "C" },
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
catch (err) {
|
|
92
|
+
if (typeof err.status === "number") {
|
|
93
|
+
if (knownToExist)
|
|
94
|
+
announceStartTimeDegrade("ps refused a query about this very process");
|
|
95
|
+
return null;
|
|
96
|
+
}
|
|
97
|
+
announceStartTimeDegrade(`ps failed (${err.code ?? "unknown"})`);
|
|
98
|
+
return null;
|
|
99
|
+
}
|
|
100
|
+
const latency = Number(hrtime.bigint() - monotonicBefore) / 1e6;
|
|
101
|
+
const wallDelta = Date.now() - wallBefore;
|
|
102
|
+
const trimmed = raw.trim();
|
|
103
|
+
const parts = ETIME_PATTERN.exec(trimmed);
|
|
104
|
+
if (parts === null) {
|
|
105
|
+
if (trimmed !== "" || knownToExist)
|
|
106
|
+
announceStartTimeDegrade("ps produced no elapsed time");
|
|
107
|
+
return null;
|
|
108
|
+
}
|
|
109
|
+
if (latency > START_TIME_PROBE_PRECISION_MS)
|
|
110
|
+
return "imprecise";
|
|
111
|
+
if (Math.abs(wallDelta - latency) > START_TIME_PROBE_PRECISION_MS)
|
|
112
|
+
return "imprecise";
|
|
113
|
+
const elapsedMs = (Number(parts[1] ?? "0") * 86_400 + Number(parts[2] ?? "0") * 3_600 + Number(parts[3] ?? "0") * 60 + Number(parts[4] ?? "0")) *
|
|
114
|
+
1000;
|
|
115
|
+
return {
|
|
116
|
+
startedAtMs: Math.round((wallBefore - elapsedMs) / 1000) * 1000,
|
|
117
|
+
startedSinceBootMs: Math.round((uptimeBefore - elapsedMs) / 1000) * 1000,
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
export function processFingerprint(pid) {
|
|
121
|
+
const host = thisHost();
|
|
122
|
+
const pidNs = ownPidNamespace();
|
|
123
|
+
const of = (id, probed) => ({
|
|
124
|
+
pid: id,
|
|
125
|
+
startedAtMs: probed?.startedAtMs ?? null,
|
|
126
|
+
startedSinceBootMs: probed?.startedSinceBootMs ?? null,
|
|
127
|
+
host,
|
|
128
|
+
...(pidNs !== null ? { pidNs } : {}),
|
|
129
|
+
});
|
|
130
|
+
if (pid === undefined || pid === process.pid) {
|
|
131
|
+
if (selfFingerprint === undefined || selfFingerprint.startedAtMs === null) {
|
|
132
|
+
const answer = of(process.pid, probeStartTimes(process.pid));
|
|
133
|
+
if (answer.startedAtMs === null)
|
|
134
|
+
return answer;
|
|
135
|
+
selfFingerprint = answer;
|
|
136
|
+
}
|
|
137
|
+
return selfFingerprint;
|
|
138
|
+
}
|
|
139
|
+
if (processFingerprint().startedAtMs === null)
|
|
140
|
+
return of(pid, null);
|
|
141
|
+
return of(pid, probeStartTimes(pid));
|
|
142
|
+
}
|
|
143
|
+
function signalProbe(pid) {
|
|
144
|
+
try {
|
|
145
|
+
process.kill(pid, 0);
|
|
146
|
+
return "present";
|
|
147
|
+
}
|
|
148
|
+
catch (err) {
|
|
149
|
+
const code = err.code;
|
|
150
|
+
if (code === "ESRCH")
|
|
151
|
+
return "absent";
|
|
152
|
+
return code === "EPERM" ? "present" : "refused";
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
function isMeasure(value) {
|
|
156
|
+
return typeof value === "number" && Number.isFinite(value);
|
|
157
|
+
}
|
|
158
|
+
const GONE = Object.freeze({ state: "gone" });
|
|
159
|
+
const RUNNING = Object.freeze({ state: "running" });
|
|
160
|
+
function uncheckable(why) {
|
|
161
|
+
return { state: "uncheckable", why };
|
|
162
|
+
}
|
|
163
|
+
export function processCensus() {
|
|
164
|
+
const signalled = new Map();
|
|
165
|
+
const observed = new Map();
|
|
166
|
+
const signal = (pid) => {
|
|
167
|
+
let answer = signalled.get(pid);
|
|
168
|
+
if (answer === undefined) {
|
|
169
|
+
answer = signalProbe(pid);
|
|
170
|
+
signalled.set(pid, answer);
|
|
171
|
+
}
|
|
172
|
+
return answer;
|
|
173
|
+
};
|
|
174
|
+
const observe = (pid) => {
|
|
175
|
+
let fp = observed.get(pid);
|
|
176
|
+
if (fp === undefined) {
|
|
177
|
+
fp = processFingerprint(pid);
|
|
178
|
+
observed.set(pid, fp);
|
|
179
|
+
}
|
|
180
|
+
return fp;
|
|
181
|
+
};
|
|
182
|
+
return {
|
|
183
|
+
verdict(record) {
|
|
184
|
+
if (typeof record.host === "string" && record.host !== "" && record.host !== thisHost())
|
|
185
|
+
return uncheckable("another_host");
|
|
186
|
+
const theirs = typeof record.pidNs === "string" && record.pidNs !== "" ? record.pidNs : null;
|
|
187
|
+
if (theirs !== ownPidNamespace())
|
|
188
|
+
return uncheckable(theirs === null ? "pid_namespace_unrecorded" : "another_pid_namespace");
|
|
189
|
+
const answer = signal(record.pid);
|
|
190
|
+
if (answer === "absent")
|
|
191
|
+
return GONE;
|
|
192
|
+
if (answer === "refused")
|
|
193
|
+
return uncheckable("probe_refused");
|
|
194
|
+
if (!isMeasure(record.startedAtMs) && !isMeasure(record.startedSinceBootMs))
|
|
195
|
+
return uncheckable("start_time_unknown");
|
|
196
|
+
const now = observe(record.pid);
|
|
197
|
+
const falsified = (was, seen) => isMeasure(was) && seen !== null && seen - was > START_TIME_TOLERANCE_MS;
|
|
198
|
+
const bootIsOver = (was) => {
|
|
199
|
+
if (!isMeasure(was))
|
|
200
|
+
return false;
|
|
201
|
+
const up = uptimeMs();
|
|
202
|
+
return up !== null && was - up > START_TIME_TOLERANCE_MS;
|
|
203
|
+
};
|
|
204
|
+
const wallSaysGone = falsified(record.startedAtMs, now.startedAtMs);
|
|
205
|
+
const uptimeSaysGone = falsified(record.startedSinceBootMs, now.startedSinceBootMs) || bootIsOver(record.startedSinceBootMs);
|
|
206
|
+
if (wallSaysGone && uptimeSaysGone)
|
|
207
|
+
return GONE;
|
|
208
|
+
const compared = (isMeasure(record.startedAtMs) && now.startedAtMs !== null) || (isMeasure(record.startedSinceBootMs) && now.startedSinceBootMs !== null);
|
|
209
|
+
return compared ? RUNNING : uncheckable("start_time_unknown");
|
|
210
|
+
},
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
export function isProcessLive(record) {
|
|
214
|
+
return processCensus().verdict(record).state !== "gone";
|
|
215
|
+
}
|
|
@@ -12,9 +12,10 @@
|
|
|
12
12
|
*
|
|
13
13
|
* A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
|
|
14
14
|
* peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
|
|
15
|
-
* is not made.
|
|
16
|
-
*
|
|
17
|
-
*
|
|
15
|
+
* is not made. Every send that carries pieces — an MCP request (the seat's fetch, `peerFetch`) and an A2A send, whose card may name
|
|
16
|
+
* another endpoint — is bound by the one judge {@link assertEndpointBound}: over https (or plain http to this machine) and to a
|
|
17
|
+
* declared origin. Neither follows a redirect while it carries them (the MCP fetch follows none; A2A's follow law reads
|
|
18
|
+
* {@link carriesDeclaredHeaders}).
|
|
18
19
|
*/
|
|
19
20
|
import type { ProtocolId } from "./protocol-table.js";
|
|
20
21
|
import { type Egress } from "./untrusted-egress.js";
|
|
@@ -96,9 +97,30 @@ export declare function remoteWords(text: string, declared: readonly string[]):
|
|
|
96
97
|
/** Whether a resolved header set carries anything the declaration bound to its endpoints — a request that does follows no redirect (the
|
|
97
98
|
* next hop is not a declared endpoint; A2A's follow law reads this). */
|
|
98
99
|
export declare function carriesDeclaredHeaders(headers: Record<string, string> | undefined): boolean;
|
|
100
|
+
/** The code a send carrying a credential is refused with when its endpoint is reached in the clear across a network
|
|
101
|
+
* ({@link crossesNetworkInClear}): a protocol send carrying pieces (the peer seat's headers, the principal header;
|
|
102
|
+
* {@link assertEndpointBound}), a model request carrying a key or a credential header (the model lane's pairing law,
|
|
103
|
+
* `adjudicateModelRoute` in src/brain/route-adjudicator.ts, where it is a `RouteRefusalCode` word), and the memory distiller's
|
|
104
|
+
* chat seat (src/core/memory-engine/distiller.ts, refused when it is built). One code for the one question, wherever it is asked. */
|
|
105
|
+
export declare const PROTOCOL_PLAINTEXT_CREDENTIALS_CODE = "config.protocol_plaintext_credentials";
|
|
99
106
|
/**
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
107
|
+
* Would a request to this endpoint cross a network in the clear — the ONE "over what" question every credential-carrying send asks
|
|
108
|
+
* before it is made: `true` unless the scheme is `https:`, or the scheme is plain `http:` and the host is this machine
|
|
109
|
+
* (`isLoopbackHost`, the private-network floor's own loopback reading, over the host as `URL` normalizes it: no DNS, so a name other
|
|
110
|
+
* than `localhost` is not this machine whatever it resolves to, and RFC 1918 / cluster addresses are not exempt). A send that carries
|
|
111
|
+
* no credential does not ask it. Read by {@link assertEndpointBound} (the protocol chains), the model lane's pairing law and the
|
|
112
|
+
* memory distiller's chat seat; exported from the package root for a host that sends a credential itself.
|
|
113
|
+
*/
|
|
114
|
+
export declare function crossesNetworkInClear(endpoint: URL): boolean;
|
|
115
|
+
/**
|
|
116
|
+
* THE judge of where a send that carries pieces may go — the seat's answered headers and the principal under the principal header, as
|
|
117
|
+
* {@link carriesDeclaredHeaders} reads the resolved set — for MCP and A2A alike, judged at every send (each MCP request; each A2A card
|
|
118
|
+
* fetch and JSON-RPC send) and at an A2A card's advertised endpoint before its skills mount. Two questions, in this order:
|
|
119
|
+
* 1. over what ({@link crossesNetworkInClear}): `https:`, or plain `http:` to this machine; anything else is
|
|
120
|
+
* `config.protocol_plaintext_credentials` — the pieces would cross a network in the clear (a URL that names credentials is the
|
|
121
|
+
* hop judge's own refusal, not this one's);
|
|
122
|
+
* 2. to whom: an origin the declaration names (an MCP server's `url`; an A2A peer's `url` and `cardUrl`); anything else is
|
|
123
|
+
* `config.protocol_endpoint_unbound`.
|
|
124
|
+
* A send that carries none goes where it goes (the hop judge, host-floor.ts, judges every hop of every request either way).
|
|
103
125
|
*/
|
|
104
126
|
export declare function assertEndpointBound(protocol: ProtocolId, peer: string, endpoint: string, declared: readonly string[], headers: Record<string, string> | undefined): void;
|
|
@@ -1,7 +1,9 @@
|
|
|
1
|
+
import { isLoopbackHost } from "./host-floor.js";
|
|
1
2
|
import { authSchemeCredentials } from "./secret-env.js";
|
|
2
3
|
import { egressText } from "./untrusted-egress.js";
|
|
3
4
|
import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
|
|
4
5
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
6
|
+
import { callerText } from "./caller-text.js";
|
|
5
7
|
export const MCP_ASSERTION_HEADER = "connector-assertion";
|
|
6
8
|
const PROTOCOL_OWNED_HEADERS = Object.freeze({
|
|
7
9
|
mcp: Object.freeze(["mcp-session-id", "mcp-protocol-version", "content-type", "accept", "last-event-id"]),
|
|
@@ -33,8 +35,8 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
|
|
|
33
35
|
const collision = headerOwnershipCollision(own, protocol);
|
|
34
36
|
if (collision !== undefined) {
|
|
35
37
|
const problem = collision.engineOwned
|
|
36
|
-
? `the header
|
|
37
|
-
: `the header
|
|
38
|
+
? `the header ${callerText(collision.second)} is the ${PROTOCOL_OWNED_HEADERS[protocol].includes(collision.first) ? "protocol's own" : "engine's"} ${collision.first} header (header names are case-insensitive) and not ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header's name" : "a header an answer may set"} — remove it`
|
|
39
|
+
: `the header ${callerText(collision.first)} is named twice (as ${callerText(collision.second)} — header names are case-insensitive); ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header is the engine's to send, so the answer may not set it" : "keep one spelling"}`;
|
|
38
40
|
throw Object.assign(new Error(`${protocol}: ${problem} — this peer is not dialed`), { code: "config.protocol_header_collision" });
|
|
39
41
|
}
|
|
40
42
|
if (principalHeader && principal !== undefined) {
|
|
@@ -117,13 +119,15 @@ function markedOver(text, removed) {
|
|
|
117
119
|
removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
|
|
118
120
|
let out = "";
|
|
119
121
|
let kept = 0;
|
|
122
|
+
let wrote = false;
|
|
120
123
|
for (const [start, end] of removed) {
|
|
121
|
-
if (start
|
|
124
|
+
if (wrote && start <= kept) {
|
|
122
125
|
kept = Math.max(kept, end);
|
|
123
126
|
continue;
|
|
124
127
|
}
|
|
125
128
|
out += text.slice(kept, start) + REDACTION_MARK;
|
|
126
129
|
kept = end;
|
|
130
|
+
wrote = true;
|
|
127
131
|
}
|
|
128
132
|
return out + text.slice(kept);
|
|
129
133
|
}
|
|
@@ -207,12 +211,25 @@ function valueHits(text, forms) {
|
|
|
207
211
|
export function carriesDeclaredHeaders(headers) {
|
|
208
212
|
return headers !== undefined && Object.keys(headers).length > 0;
|
|
209
213
|
}
|
|
214
|
+
export const PROTOCOL_PLAINTEXT_CREDENTIALS_CODE = "config.protocol_plaintext_credentials";
|
|
215
|
+
export function crossesNetworkInClear(endpoint) {
|
|
216
|
+
if (endpoint.protocol === "https:")
|
|
217
|
+
return false;
|
|
218
|
+
return !(endpoint.protocol === "http:" && isLoopbackHost(endpoint.hostname));
|
|
219
|
+
}
|
|
210
220
|
export function assertEndpointBound(protocol, peer, endpoint, declared, headers) {
|
|
211
221
|
if (!carriesDeclaredHeaders(headers))
|
|
212
222
|
return;
|
|
223
|
+
const subject = `${protocol}: ${protocol === "mcp" ? "server" : "peer"} "${inlineUntrusted(peer, 80)}"`;
|
|
224
|
+
const url = new URL(endpoint);
|
|
225
|
+
const carried = Object.values(headers ?? {});
|
|
226
|
+
const named = (text) => inlineUntrusted(eraseSentCredentials(text, carried), 120);
|
|
227
|
+
if (crossesNetworkInClear(url)) {
|
|
228
|
+
throw Object.assign(new Error(`${subject} would send the headers its peer seat answers or its principal header to ${named(url.origin === "null" ? url.protocol : url.origin)}, which is not https — they travel only over https, or over plain http to this machine (localhost, 127.0.0.0/8, ::1); declare the endpoint as an https url, or send it neither pieces nor a principal header`), { code: PROTOCOL_PLAINTEXT_CREDENTIALS_CODE });
|
|
229
|
+
}
|
|
213
230
|
const origins = declared.map((u) => new URL(u).origin);
|
|
214
|
-
const at =
|
|
231
|
+
const at = url.origin;
|
|
215
232
|
if (origins.includes(at))
|
|
216
233
|
return;
|
|
217
|
-
throw Object.assign(new Error(`${
|
|
234
|
+
throw Object.assign(new Error(`${subject} advertises the endpoint origin ${named(at)}, outside the origins its declaration names (${origins.map((o) => inlineUntrusted(o, 120)).join(", ")}); the headers the peer seat answers travel only to those — declare that origin as the peer's url (and the card's location as cardUrl) or have the seat answer none for it`), { code: "config.protocol_endpoint_unbound" });
|
|
218
235
|
}
|
|
@@ -40,6 +40,13 @@ export declare function clampNameSegment(seg: string, max?: number): string;
|
|
|
40
40
|
* (ticket #10), and the property test holds the two legs to the identical law.
|
|
41
41
|
*/
|
|
42
42
|
export declare function mintNamespacePrefix(ns: ProtocolNamespace, peer: string): string;
|
|
43
|
+
/**
|
|
44
|
+
* Is the peer segment {@link mintNamespacePrefix} spells for `peer` the peer's own name — only charset-normalized and
|
|
45
|
+
* separator-folded (`github.com` → `github_com`), so a person reads it back to the name? False when the length budget cut
|
|
46
|
+
* the name and gave it a digest, and when nothing of it was nameable and the segment is a bare digest: such a segment is
|
|
47
|
+
* not something a person can derive from the name. Read off the same two steps the mint takes, never a second criterion.
|
|
48
|
+
*/
|
|
49
|
+
export declare function mintKeepsPeerName(ns: ProtocolNamespace, peer: string): boolean;
|
|
43
50
|
/**
|
|
44
51
|
* The first pair of peers in `peers` that mint the SAME {@link mintNamespacePrefix} — i.e. that would
|
|
45
52
|
* register into one indistinguishable namespace domain — or `undefined` when every peer owns its own.
|
|
@@ -4,7 +4,10 @@ export const MINTED_TOOL_SEGMENT_MIN_CHARS = 16;
|
|
|
4
4
|
const SEGMENT_DIGEST_CHARS = 8;
|
|
5
5
|
const NAME_SEP = "__";
|
|
6
6
|
export function normalizeNameSegment(name) {
|
|
7
|
-
return clampNameSegment(name
|
|
7
|
+
return clampNameSegment(charsetNormalize(name));
|
|
8
|
+
}
|
|
9
|
+
function charsetNormalize(name) {
|
|
10
|
+
return name.replace(/[^a-zA-Z0-9_-]/g, "_");
|
|
8
11
|
}
|
|
9
12
|
const SEGMENT_DIGEST_JOIN = "-";
|
|
10
13
|
export function clampNameSegment(seg, max = TOOL_NAME_MAX_CHARS) {
|
|
@@ -17,15 +20,22 @@ export function clampNameSegment(seg, max = TOOL_NAME_MAX_CHARS) {
|
|
|
17
20
|
return keep > 0 ? `${seg.slice(0, keep)}${SEGMENT_DIGEST_JOIN}${digest}` : digest.slice(0, max);
|
|
18
21
|
}
|
|
19
22
|
function settlePeerSegment(clamped) {
|
|
20
|
-
const folded = clamped
|
|
23
|
+
const folded = foldSeparatorRuns(clamped);
|
|
21
24
|
if (folded !== "")
|
|
22
25
|
return folded;
|
|
23
26
|
return createHash("sha256").update(clamped).digest("hex").slice(0, SEGMENT_DIGEST_CHARS);
|
|
24
27
|
}
|
|
28
|
+
function foldSeparatorRuns(segment) {
|
|
29
|
+
return segment.replace(/_{2,}/g, "_").replace(/_+$/, "");
|
|
30
|
+
}
|
|
25
31
|
export function mintNamespacePrefix(ns, peer) {
|
|
26
32
|
const peerBudget = Math.max(1, TOOL_NAME_MAX_CHARS - ns.prefix.length - NAME_SEP.length - MINTED_TOOL_SEGMENT_MIN_CHARS);
|
|
27
33
|
return `${ns.prefix}${settlePeerSegment(clampNameSegment(normalizeNameSegment(peer), peerBudget))}${NAME_SEP}`;
|
|
28
34
|
}
|
|
35
|
+
export function mintKeepsPeerName(ns, peer) {
|
|
36
|
+
const minted = mintNamespacePrefix(ns, peer).slice(ns.prefix.length, -NAME_SEP.length);
|
|
37
|
+
return minted === foldSeparatorRuns(charsetNormalize(peer));
|
|
38
|
+
}
|
|
29
39
|
export function findNamespacePrefixCollision(ns, peers) {
|
|
30
40
|
return findNamespacePrefixCollisions(ns, peers)[0];
|
|
31
41
|
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Which declaration a request goes to, as the ledger is asked about it: the protocol, and the declaration's name in that protocol's own
|
|
3
|
+
* namespace (an MCP server named "x" and an A2A peer named "x" are two declarations). `fingerprint` is present exactly when the MCP
|
|
4
|
+
* server's declaration carries one (`McpServerSpec.fingerprint`); an A2A peer declares none.
|
|
5
|
+
*/
|
|
6
|
+
export type ProtocolRevocationTarget = {
|
|
7
|
+
readonly protocol: "mcp";
|
|
8
|
+
readonly server: string;
|
|
9
|
+
readonly fingerprint?: string;
|
|
10
|
+
} | {
|
|
11
|
+
readonly protocol: "a2a";
|
|
12
|
+
readonly peer: string;
|
|
13
|
+
};
|
|
14
|
+
/** The host's revocation ledger ({@link RunnerDeps.protocolRevocations}): `revoked` answers, synchronously, whether the deployment has
|
|
15
|
+
* withdrawn the declaration the target names. */
|
|
16
|
+
export interface ProtocolRevocationLedger {
|
|
17
|
+
revoked(target: ProtocolRevocationTarget): boolean;
|
|
18
|
+
}
|
|
19
|
+
/** The code a request refused because its target was revoked is answered with, per protocol: each protocol's own namespace. */
|
|
20
|
+
export declare const REVOKED_PEER_CODES: Readonly<{
|
|
21
|
+
readonly mcp: "mcp.server_revoked";
|
|
22
|
+
readonly a2a: "a2a.peer_revoked";
|
|
23
|
+
}>;
|
|
24
|
+
export type RevokedPeerCode = (typeof REVOKED_PEER_CODES)[keyof typeof REVOKED_PEER_CODES];
|
|
25
|
+
/** The declaration's name as the target carries it. */
|
|
26
|
+
export declare function revocationTargetName(target: ProtocolRevocationTarget): string;
|
|
27
|
+
/**
|
|
28
|
+
* A request the revocation ledger stopped at the request exit: nothing of it was sent. Thrown by the exits only; every outlet that answers
|
|
29
|
+
* the model maps it to its own result form (mcp-server-link.ts `revokedCallResult`), and the failure classifier reads it as `revoked`
|
|
30
|
+
* (mcp-failure.ts). Its code comes from {@link REVOKED_PEER_CODES} and nowhere else. `afterSentHop`: the door stopped a REDIRECT of a
|
|
31
|
+
* request whose earlier hop was already sent (an A2A hop judge), so what the peer did with that hop is unknown. Its `details` say what
|
|
32
|
+
* any failure record says of it — `delivered: "no"` when nothing of the request was sent, `"unknown"` after a sent hop — so a re-send
|
|
33
|
+
* the door stopped does not speak for a call whose first attempt was sent (the peer seat's re-send rule, `sentOnceMore`): that call
|
|
34
|
+
* answers what its first attempt met.
|
|
35
|
+
*/
|
|
36
|
+
export declare class ProtocolRevokedRefusal extends Error {
|
|
37
|
+
readonly code: RevokedPeerCode;
|
|
38
|
+
readonly target: ProtocolRevocationTarget;
|
|
39
|
+
readonly afterSentHop: boolean;
|
|
40
|
+
readonly details: {
|
|
41
|
+
readonly code: RevokedPeerCode;
|
|
42
|
+
readonly delivered: "no" | "unknown";
|
|
43
|
+
};
|
|
44
|
+
constructor(target: ProtocolRevocationTarget, afterSentHop?: boolean);
|
|
45
|
+
}
|
|
46
|
+
/** Run `send` carrying the revocation question `ask` to its exit ({@link askCarriedRevocation}). */
|
|
47
|
+
export declare function carryRevocation<T>(ask: () => ProtocolRevokedRefusal | undefined, send: () => Promise<T>): Promise<T>;
|
|
48
|
+
/** A transport's send, said for what it is — a request's own bytes, or anything else — under the question it carries, if any. Only the
|
|
49
|
+
* transport knows which message a send carries; the exit it reaches does not. */
|
|
50
|
+
export declare function sendingUnder<T>(sending: "request" | "other", send: () => Promise<T>): Promise<T>;
|
|
51
|
+
/** At a request exit, after the pieces were taken and before anything is sent: the question the send carries, asked; its refusal is
|
|
52
|
+
* thrown. A send that carries none, or that is not a request's own, is not asked. */
|
|
53
|
+
export declare function askCarriedRevocation(): void;
|
|
54
|
+
/** One question to the ledger as a materialization asks it: fail-open, told once (see {@link revocationProbe}). */
|
|
55
|
+
export type RevocationProbe = (target: ProtocolRevocationTarget) => boolean;
|
|
56
|
+
/**
|
|
57
|
+
* The one reader of a revocation seat handed to the engine (`new Runner`, the two library materializations): absent ⇒ `undefined`; else
|
|
58
|
+
* an object whose `revoked` member is a function, read once and kept bound to that object in a frozen copy — or refused
|
|
59
|
+
* (`config.invalid_argument`) naming what does not fit. The form before this seat (`{ isRevoked(serverName, mount?) }`) is refused by
|
|
60
|
+
* name with the form that replaced it: a ledger of that form, handed a target object, would answer "not revoked" for every request.
|
|
61
|
+
*/
|
|
62
|
+
export declare function receiveProtocolRevocations(raw: unknown, subject: string): ProtocolRevocationLedger | undefined;
|
|
63
|
+
/** The revocation argument of a library materialization: the seat ({@link receiveProtocolRevocations}) and, beside it, the optional
|
|
64
|
+
* `onProbeFailure` that hears a broken probe once per call of the entrance. */
|
|
65
|
+
export declare function libraryRevocationProbe(raw: unknown, subject: string): RevocationProbe | undefined;
|
|
66
|
+
/**
|
|
67
|
+
* THE probe over one ledger, for one leg (the runner builds one per leg and hands it to both materializations; a library entrance builds
|
|
68
|
+
* one per call): each question asks the ledger again — the answer is never kept — and an answer that is not a boolean, or a throw, is a
|
|
69
|
+
* broken probe answered `false` (not revoked). The first broken answer is told to `onProbeFailure` once; later ones stay quiet (the
|
|
70
|
+
* condition is standing, not news per request). A sink that throws is not a second fault source.
|
|
71
|
+
*/
|
|
72
|
+
export declare function revocationProbe(ledger: ProtocolRevocationLedger | undefined, onProbeFailure: ((error: unknown) => void) | undefined): RevocationProbe | undefined;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
|
+
import { types } from "node:util";
|
|
3
|
+
import { declarerWord } from "./mcp-server-spec.js";
|
|
4
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
5
|
+
export const REVOKED_PEER_CODES = Object.freeze({ mcp: "mcp.server_revoked", a2a: "a2a.peer_revoked" });
|
|
6
|
+
export function revocationTargetName(target) {
|
|
7
|
+
return target.protocol === "mcp" ? target.server : target.peer;
|
|
8
|
+
}
|
|
9
|
+
export class ProtocolRevokedRefusal extends Error {
|
|
10
|
+
code;
|
|
11
|
+
target;
|
|
12
|
+
afterSentHop;
|
|
13
|
+
details;
|
|
14
|
+
constructor(target, afterSentHop = false) {
|
|
15
|
+
super(`${declarerWord(target.protocol)} "${inlineUntrusted(revocationTargetName(target), 120)}" was revoked by the operator; ` +
|
|
16
|
+
(afterSentHop ? "the request's redirect was NOT followed" : "the request was NOT sent"));
|
|
17
|
+
this.name = "ProtocolRevokedRefusal";
|
|
18
|
+
this.code = REVOKED_PEER_CODES[target.protocol];
|
|
19
|
+
this.target = target;
|
|
20
|
+
this.afterSentHop = afterSentHop;
|
|
21
|
+
this.details = Object.freeze({ code: this.code, delivered: afterSentHop ? "unknown" : "no" });
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
const carried = new AsyncLocalStorage();
|
|
25
|
+
export function carryRevocation(ask, send) {
|
|
26
|
+
return carried.run({ ask }, send);
|
|
27
|
+
}
|
|
28
|
+
export function sendingUnder(sending, send) {
|
|
29
|
+
const question = carried.getStore();
|
|
30
|
+
return question === undefined ? send() : carried.run({ ask: question.ask, sending }, send);
|
|
31
|
+
}
|
|
32
|
+
export function askCarriedRevocation() {
|
|
33
|
+
const question = carried.getStore();
|
|
34
|
+
if (question === undefined || question.sending === "other")
|
|
35
|
+
return;
|
|
36
|
+
const refused = question.ask();
|
|
37
|
+
if (refused !== undefined)
|
|
38
|
+
throw refused;
|
|
39
|
+
}
|
|
40
|
+
const SEAT_FORM = "the revocation seat is an object { revoked({ protocol, server | peer, fingerprint? }) } that answers synchronously";
|
|
41
|
+
function refusal(subject, problem) {
|
|
42
|
+
return Object.assign(new Error(`${subject} ${problem} — ${SEAT_FORM}`), { code: "config.invalid_argument" });
|
|
43
|
+
}
|
|
44
|
+
export function receiveProtocolRevocations(raw, subject) {
|
|
45
|
+
if (raw === undefined)
|
|
46
|
+
return undefined;
|
|
47
|
+
if (typeof raw !== "object" || raw === null || types.isProxy(raw))
|
|
48
|
+
throw refusal(subject, raw === null ? "is null" : typeof raw !== "object" ? `is a ${typeof raw}` : "is a Proxy");
|
|
49
|
+
const member = readMemberOf(raw, "revoked", subject);
|
|
50
|
+
if (typeof member !== "function") {
|
|
51
|
+
const retired = member === undefined && typeof readMemberOf(raw, "isRevoked", subject) === "function";
|
|
52
|
+
throw refusal(subject, retired ? "is the MCP-only ledger form `{ isRevoked(serverName, mount?) }`: name the method `revoked` and read the target's `protocol`, `server` / `peer` and `fingerprint`" : "has no `revoked` function");
|
|
53
|
+
}
|
|
54
|
+
return Object.freeze({ revoked: (target) => Reflect.apply(member, raw, [target]) });
|
|
55
|
+
}
|
|
56
|
+
export function libraryRevocationProbe(raw, subject) {
|
|
57
|
+
const ledger = receiveProtocolRevocations(raw, subject);
|
|
58
|
+
if (ledger === undefined)
|
|
59
|
+
return undefined;
|
|
60
|
+
const sink = readMemberOf(raw, "onProbeFailure", subject);
|
|
61
|
+
if (sink !== undefined && typeof sink !== "function")
|
|
62
|
+
throw refusal(subject, `has an \`onProbeFailure\` that is a ${sink === null ? "null" : typeof sink}, not a function`);
|
|
63
|
+
return revocationProbe(ledger, sink === undefined ? undefined : (error) => void Reflect.apply(sink, raw, [error]));
|
|
64
|
+
}
|
|
65
|
+
function readMemberOf(raw, name, subject) {
|
|
66
|
+
try {
|
|
67
|
+
return Reflect.get(raw, name);
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
throw refusal(subject, `threw while its \`${name}\` was read`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
export function revocationProbe(ledger, onProbeFailure) {
|
|
74
|
+
if (ledger === undefined)
|
|
75
|
+
return undefined;
|
|
76
|
+
let told = false;
|
|
77
|
+
return (target) => {
|
|
78
|
+
try {
|
|
79
|
+
const answer = ledger.revoked(Object.freeze({ ...target }));
|
|
80
|
+
if (typeof answer === "boolean")
|
|
81
|
+
return answer;
|
|
82
|
+
if (typeof answer?.then === "function")
|
|
83
|
+
Promise.resolve(answer).catch(() => undefined);
|
|
84
|
+
throw new Error(`revoked returned ${answer instanceof Promise ? "a Promise — the ledger seat is SYNCHRONOUS by contract" : `a non-boolean (${answer === null ? "null" : typeof answer})`}`);
|
|
85
|
+
}
|
|
86
|
+
catch (e) {
|
|
87
|
+
if (!told) {
|
|
88
|
+
told = true;
|
|
89
|
+
try {
|
|
90
|
+
onProbeFailure?.(e);
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
return false;
|
|
96
|
+
}
|
|
97
|
+
};
|
|
98
|
+
}
|
|
@@ -7,10 +7,10 @@
|
|
|
7
7
|
* makes "which protocol owns this tool name" a lookup: a second protocol (e.g. A2A) lands by
|
|
8
8
|
* APPENDING one entry, and every table-driven site picks it up unchanged.
|
|
9
9
|
*
|
|
10
|
-
*
|
|
11
|
-
* as its public `MCP_PREFIX` face, never the other way
|
|
12
|
-
* normalization + the assembled-name budget, which needs a digest)
|
|
13
|
-
* imports this module's type; the dependency never runs the other way
|
|
10
|
+
* Pure string logic: its one import is the zero-import text leaf a refusal echoes an identity through —
|
|
11
|
+
* `mcp.ts` re-exports {@link MCP_NAMESPACE}'s prefix as its public `MCP_PREFIX` face, never the other way
|
|
12
|
+
* around. The MINTING pipeline (charset normalization + the assembled-name budget, which needs a digest)
|
|
13
|
+
* lives in `protocol-naming.ts`, which imports this module's type; the dependency never runs the other way.
|
|
14
14
|
*/
|
|
15
15
|
/** The ids of every protocol the engine speaks. Doubles as the protocol slice of the tool-manifest
|
|
16
16
|
* `ToolOrigin` union — adding a protocol extends BOTH (tsc pairs the change). */
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
1
2
|
const NAME_SEP = "__";
|
|
2
3
|
function makeProtocolNamespace(id, prefix) {
|
|
3
4
|
const parse = (name) => {
|
|
@@ -14,10 +15,10 @@ function makeProtocolNamespace(id, prefix) {
|
|
|
14
15
|
};
|
|
15
16
|
const makeName = (peer, tool) => {
|
|
16
17
|
if (peer.length === 0 || tool.length === 0) {
|
|
17
|
-
throw new Error(`protocol table (${id}): peer and tool must both be non-empty (got peer
|
|
18
|
+
throw new Error(`protocol table (${id}): peer and tool must both be non-empty (got an empty ${peer.length === 0 ? "peer" : "tool"})`);
|
|
18
19
|
}
|
|
19
20
|
if (peer.includes(NAME_SEP)) {
|
|
20
|
-
throw new Error(`protocol table (${id}): peer must not contain the ${NAME_SEP} separator (got ${
|
|
21
|
+
throw new Error(`protocol table (${id}): peer must not contain the ${NAME_SEP} separator (got "${inlineUntrusted(peer)}") — the composed name would parse back as a DIFFERENT peer`);
|
|
21
22
|
}
|
|
22
23
|
return `${prefix}${peer}${NAME_SEP}${tool}`;
|
|
23
24
|
};
|
|
@@ -1,12 +1,45 @@
|
|
|
1
|
-
/**
|
|
1
|
+
/**
|
|
2
|
+
* A place a writer keeps in a {@link PushQueue}: what it puts there is delivered at that place, and every value pushed after the
|
|
3
|
+
* place was kept waits behind it until the place is filled. `put` delivers values and keeps the place (more may follow there);
|
|
4
|
+
* `fill` delivers values and frees the place. Once filled, the place takes nothing more (a later `put` / `fill` is a no-op);
|
|
5
|
+
* filling with nothing frees it.
|
|
6
|
+
*/
|
|
7
|
+
export interface QueueSlot<T> {
|
|
8
|
+
put(values: readonly T[]): void;
|
|
9
|
+
fill(values: readonly T[]): void;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* A minimal async iterable you can push values into and close. Backpressure-free (buffers).
|
|
13
|
+
*
|
|
14
|
+
* A writer that must decide later what stands at the present point of the stream keeps a place with {@link reserve}: values pushed
|
|
15
|
+
* after it are held behind it (accepted, in push order) until it is filled. `close()` refuses later pushes and later places, and the
|
|
16
|
+
* iteration ends once every place kept before the close is filled and everything ahead of the end is delivered — a kept place is
|
|
17
|
+
* part of what was pushed before the close, so its owner must fill it (a place that is never filled holds the iteration open).
|
|
18
|
+
*/
|
|
2
19
|
export declare class PushQueue<T> implements AsyncIterable<T> {
|
|
3
20
|
private buffer;
|
|
4
21
|
private waiters;
|
|
5
22
|
private closed;
|
|
23
|
+
/** What waits behind the oldest open place, in order — empty when no place is kept. */
|
|
24
|
+
private held;
|
|
6
25
|
/** Returns whether the value was ACCEPTED (`false` after close — the push is a silent no-op then).
|
|
7
26
|
* Callers that mirror a pushed value to a second reader gate on this so both sides stay in parity
|
|
8
|
-
* (#253: a status frame must not reach a side sink the stream itself already refused).
|
|
27
|
+
* (#253: a status frame must not reach a side sink the stream itself already refused). A value accepted while a place is kept
|
|
28
|
+
* is delivered after that place is filled: a reader mirroring at push sees it earlier than the stream's reader does. */
|
|
9
29
|
push(value: T): boolean;
|
|
30
|
+
/** Keep a place at the present point of the stream; `undefined` after close (nothing more is accepted). */
|
|
31
|
+
reserve(): QueueSlot<T> | undefined;
|
|
10
32
|
close(): void;
|
|
33
|
+
/**
|
|
34
|
+
* Free every kept place with what was put into it so far: the writer that kept them can no longer fill them (the run that
|
|
35
|
+
* owned it died before its own settle). Values held behind the places are delivered in order; a later `put` / `fill` on a
|
|
36
|
+
* freed place is a no-op.
|
|
37
|
+
*/
|
|
38
|
+
freePlaces(): void;
|
|
39
|
+
/** Deliver what stands ahead of the oldest open place (and what was put into it), then end the iteration if it is closed and
|
|
40
|
+
* nothing is held. */
|
|
41
|
+
private release;
|
|
42
|
+
private deliver;
|
|
43
|
+
private endIfDone;
|
|
11
44
|
[Symbol.asyncIterator](): AsyncIterator<T>;
|
|
12
45
|
}
|