@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -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 +169 -0
- package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
- package/dist/core/roles.js +148 -21
- 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 +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
- package/dist/index.js +45 -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 +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -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
|
@@ -37,6 +37,9 @@ export interface McpServerSpec {
|
|
|
37
37
|
kind: "host";
|
|
38
38
|
} | {
|
|
39
39
|
kind: "http";
|
|
40
|
+
/** The server's endpoint. A request that carries pieces the peer seat answers or the principal header goes only to this
|
|
41
|
+
* url, over `https:` or plain `http:` to this machine (`config.protocol_plaintext_credentials` otherwise, refused at the
|
|
42
|
+
* request that would carry them — the dial's own requests first). */
|
|
40
43
|
url: string;
|
|
41
44
|
credentials?: CredentialRef;
|
|
42
45
|
/**
|
|
@@ -168,9 +171,9 @@ export interface McpServerSpec {
|
|
|
168
171
|
/**
|
|
169
172
|
* The host's identity of THIS MOUNT of the server — a non-empty string (≤ 128 characters) the host
|
|
170
173
|
* minted from the declaration; the engine computes nothing from it and reads nothing off it. When present
|
|
171
|
-
* it rides the revocation
|
|
172
|
-
* host can tell one mount generation of a server from a re-declared one under the same name. Absent ⇒
|
|
173
|
-
* the
|
|
174
|
+
* it rides the revocation question (`ProtocolRevocationTarget.fingerprint` of `RunnerDeps.protocolRevocations`),
|
|
175
|
+
* so the host can tell one mount generation of a server from a re-declared one under the same name. Absent ⇒
|
|
176
|
+
* the question carries the name alone. Any other value refuses this server at its dial
|
|
174
177
|
* (`config.mcp_fingerprint_invalid`).
|
|
175
178
|
*/
|
|
176
179
|
fingerprint?: string;
|
|
@@ -231,15 +234,6 @@ export type ToolAxesRead = {
|
|
|
231
234
|
ok: false;
|
|
232
235
|
problem: string;
|
|
233
236
|
};
|
|
234
|
-
/**
|
|
235
|
-
* THE one shape text the caller wrote takes in a judge's sentence — a value, or a key the caller chose (a tool or skill name, the name of
|
|
236
|
-
* a member the declaration does not have, a `_meta` key): the redaction mark and its length, never the text. A caller's text can be
|
|
237
|
-
* anything a deployment put in the wrong field, a credential included, and the sentence travels to logs, panels and probes. A value that
|
|
238
|
-
* is no string is named by its kind ({@link dataKind}). Everything else a judge's sentence says is the engine's own: where (the
|
|
239
|
-
* declaration's member names, a list index), why (the closed vocabulary, a kind, a count and its bound) and whose (the declarer's name,
|
|
240
|
-
* the entry's published identity, which the engine already mints into every tool name it mounts).
|
|
241
|
-
*/
|
|
242
|
-
export declare function callerText(value: unknown): string;
|
|
243
237
|
/**
|
|
244
238
|
* Where in a declaration a sentence points, from `base`: a list index in brackets, a member name after a dot — the declaration's own
|
|
245
239
|
* member names (`words`, the engine's words) as written, any other key in the caller's-text shape ({@link callerText}). Bounded: no key is
|
|
@@ -248,8 +242,6 @@ export declare function callerText(value: unknown): string;
|
|
|
248
242
|
*/
|
|
249
243
|
export declare function declarationPath(path: readonly (string | number)[], words: ReadonlySet<string>, base?: string): string;
|
|
250
244
|
export declare const DECLARATION_ENTRY_WORDS: ReadonlySet<string>;
|
|
251
|
-
/** The kind of a value that is plain data, for a sentence that names what was declared without carrying it. */
|
|
252
|
-
export declare function dataKind(value: unknown): string;
|
|
253
245
|
/**
|
|
254
246
|
* Where a declaration stops being one: the path from the declaration's root — a list index as a number, a member name as a string — and
|
|
255
247
|
* the clause that says what is there ("it contains itself; …"): a kind and a remedy, never a value the declarer wrote.
|
|
@@ -335,8 +327,15 @@ type PerToolDeclarationRead = {
|
|
|
335
327
|
*/
|
|
336
328
|
export declare function receivePerToolDeclaration(declared: unknown, field: PerToolDeclaration, unit: string, words: ReadonlySet<string>): PerToolDeclarationRead;
|
|
337
329
|
/** The sentence for one tool's (or skill's) declaration that does not fit: `detail` says which member and why. The tool's name is the
|
|
338
|
-
* caller's text ({@link callerText})
|
|
339
|
-
|
|
330
|
+
* caller's text ({@link callerText}) — its mark and length, never the text — so two names of one length are told apart by `at`, the
|
|
331
|
+
* entry's place among the declaration's names (no text of the caller's in it): `index` counts from 0 in the order the engine reads
|
|
332
|
+
* the names, `of` is how many the declaration holds. The readers that hold the record say it, and it leads the sentence, ahead of the
|
|
333
|
+
* bound that cuts a refusal's tail. `at` is absent only where the engine holds no record to count in — a declaration the receipt itself
|
|
334
|
+
* refused ({@link receivePerToolDeclaration}'s refusal). */
|
|
335
|
+
export declare function perToolEntryRefusal(field: PerToolDeclaration, unit: string, key: string, detail: string, at?: {
|
|
336
|
+
readonly index: number;
|
|
337
|
+
readonly of: number;
|
|
338
|
+
}): string;
|
|
340
339
|
/** The member names of one tool's axes ({@link TOOL_AXIS_MEMBERS}): the words a `toolAxes` refusal's member path spells. */
|
|
341
340
|
export declare const TOOL_AXIS_WORDS: ReadonlySet<string>;
|
|
342
341
|
/** The sentence for a per-tool declaration that names a tool (or skill) with an empty name. */
|
|
@@ -351,7 +350,9 @@ export declare function perToolEmptyName(field: PerToolDeclaration, unit: string
|
|
|
351
350
|
* unknown member, a word outside the vocabulary or a non-boolean `egress` on ANY one tool refuses the whole
|
|
352
351
|
* declaration (`ok: false`) — the good tools are not kept and nothing is defaulted, since a caller axis is
|
|
353
352
|
* two-way (it can vouch a tool down as well as mark it up) and a silently lost half is a trust root that is
|
|
354
|
-
* not in force.
|
|
353
|
+
* not in force. The refusal names the entry in the caller's-text shape (its mark and length) and by its place among the declaration's
|
|
354
|
+
* entries (`entry 2 of 3`, in the order the engine reads them), so two names of one length are told apart without showing any text.
|
|
355
|
+
* `boundaryFlow: "engine"` (the call's effect stays inside the engine — the tool's roster row states no
|
|
355
356
|
* boundary legs) needs `egress: false` in the same entry — `egress: true` contradicts it and an absent one leaves a server hint
|
|
356
357
|
* or the peer default marking it an external write — refused here; whether the other axes contradict each other (`egress`
|
|
357
358
|
* over a non-write effect) is the ingestion's own arithmetic. The declaration is read once, as plain data, by {@link receiveDeclaration} — a
|
|
@@ -376,15 +377,6 @@ export declare function declarerWord(at: ToolAxesSurface): string;
|
|
|
376
377
|
export declare function toolAxesRefusal(at: ToolAxesSurface, name: string, problem: string): Error & {
|
|
377
378
|
code: "config.invalid_argument";
|
|
378
379
|
};
|
|
379
|
-
/** The identity of one mount of a declared server, as the host minted it ({@link McpServerSpec.fingerprint}). */
|
|
380
|
-
export interface McpMountIdentity {
|
|
381
|
-
readonly fingerprint: string;
|
|
382
|
-
}
|
|
383
|
-
/** The host's MCP revocation ledger ({@link RunnerDeps.mcpRevocations}) — declared once, read by every MCP dispatch outlet. */
|
|
384
|
-
export interface McpRevocationLedger {
|
|
385
|
-
/** Synchronous. `mount` is passed exactly when the server's declaration carries a `fingerprint`. */
|
|
386
|
-
isRevoked(serverName: string, mount?: McpMountIdentity): boolean;
|
|
387
|
-
}
|
|
388
380
|
/**
|
|
389
381
|
* Definition of one A2A (agent-to-agent protocol) PEER to talk to for the duration of one task.
|
|
390
382
|
*
|
|
@@ -407,9 +399,10 @@ export interface A2aServerSpec {
|
|
|
407
399
|
cardUrl?: string;
|
|
408
400
|
/** At most one opaque credential reference, as on an MCP server's transport: the headers a send to this peer carries are
|
|
409
401
|
* answered per send by the deployment's peer seat ({@link RunnerDeps.peerSeat}), never declared (`headers` is retired and
|
|
410
|
-
* refused, `config.credential_in_declaration`). Pieces the seat answers
|
|
411
|
-
*
|
|
412
|
-
*
|
|
402
|
+
* refused, `config.credential_in_declaration`). Pieces the seat answers (and the principal header) travel only over `https:`,
|
|
403
|
+
* or plain `http:` to this machine (`config.protocol_plaintext_credentials` otherwise), and only to the declared origins
|
|
404
|
+
* (`url`, `cardUrl`): a send carrying them to an endpoint on another origin is refused (`config.protocol_endpoint_unbound`),
|
|
405
|
+
* and it follows no redirect. */
|
|
413
406
|
credentials?: CredentialRef;
|
|
414
407
|
/**
|
|
415
408
|
* Per-task **end-user principal** header (design/62), same contract as the MCP side: when set, the
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { SAFETY_AXIS_VOCABULARY } from "./safety-axis-vocab.js";
|
|
2
2
|
import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
|
|
3
|
-
import {
|
|
3
|
+
import { callerText, dataKind } from "./caller-text.js";
|
|
4
4
|
import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
5
5
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
6
6
|
import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
|
|
@@ -41,12 +41,6 @@ const irreversibilityPolesLockstep = true;
|
|
|
41
41
|
void irreversibilityPolesLockstep;
|
|
42
42
|
const toolAxesDeclarationsAreOne = true;
|
|
43
43
|
void toolAxesDeclarationsAreOne;
|
|
44
|
-
export function callerText(value) {
|
|
45
|
-
if (typeof value !== "string")
|
|
46
|
-
return dataKind(value);
|
|
47
|
-
const length = [...value].length;
|
|
48
|
-
return `${REDACTION_MARK} (${length} character${length === 1 ? "" : "s"})`;
|
|
49
|
-
}
|
|
50
44
|
export function declarationPath(path, words, base = "") {
|
|
51
45
|
let rendered = base;
|
|
52
46
|
for (const key of path) {
|
|
@@ -79,9 +73,6 @@ const DECLARATION_ENTRY_MEMBERS = {
|
|
|
79
73
|
allowSkills: true,
|
|
80
74
|
};
|
|
81
75
|
export const DECLARATION_ENTRY_WORDS = new Set(Object.keys(DECLARATION_ENTRY_MEMBERS));
|
|
82
|
-
export function dataKind(value) {
|
|
83
|
-
return value === null ? "null" : value === undefined ? "undefined" : Array.isArray(value) ? "an array" : typeof value === "object" ? "a record" : `a ${typeof value}`;
|
|
84
|
-
}
|
|
85
76
|
const RECEIPT_FAULT_PROBLEMS = {
|
|
86
77
|
proxy: "it is a Proxy, whose traps would run as it is read; copy it into plain data (a spread or a JSON round trip)",
|
|
87
78
|
"not-data": "it is not plain data (a function, a bigint, a symbol, or an object whose prototype is neither Object.prototype nor null: a class instance, " +
|
|
@@ -239,8 +230,9 @@ export function receivePerToolDeclaration(declared, field, unit, words) {
|
|
|
239
230
|
return { ok: false, problem: `${field} is ${dataKind(perTool)}, not an object of per-${unit} ${PER_TOOL_DECLARATIONS[field].singular} declarations` };
|
|
240
231
|
return { ok: true, perTool };
|
|
241
232
|
}
|
|
242
|
-
export function perToolEntryRefusal(field, unit, key, detail) {
|
|
243
|
-
|
|
233
|
+
export function perToolEntryRefusal(field, unit, key, detail, at) {
|
|
234
|
+
const place = at === undefined ? "" : `, entry ${at.index + 1} of ${at.of},`;
|
|
235
|
+
return `the ${PER_TOOL_DECLARATIONS[field].plural} declared for the ${unit} ${callerText(key)}${place} do not fit: ${detail}`;
|
|
244
236
|
}
|
|
245
237
|
export const TOOL_AXIS_WORDS = new Set(TOOL_AXIS_MEMBER_NAMES);
|
|
246
238
|
export function perToolEmptyName(field, unit) {
|
|
@@ -254,7 +246,8 @@ export function readToolAxes(declared, at) {
|
|
|
254
246
|
if (!received.ok)
|
|
255
247
|
return { ok: false, problem: received.problem };
|
|
256
248
|
const entries = [];
|
|
257
|
-
|
|
249
|
+
const declaredEntries = Object.entries(received.perTool);
|
|
250
|
+
for (const [index, [key, raw]] of declaredEntries.entries()) {
|
|
258
251
|
if (key.length === 0)
|
|
259
252
|
return { ok: false, problem: perToolEmptyName("toolAxes", unit) };
|
|
260
253
|
let entry;
|
|
@@ -265,7 +258,7 @@ export function readToolAxes(declared, at) {
|
|
|
265
258
|
entry = "a member threw while it was read";
|
|
266
259
|
}
|
|
267
260
|
if (typeof entry === "string")
|
|
268
|
-
return { ok: false, problem: perToolEntryRefusal("toolAxes", unit, key, entry) };
|
|
261
|
+
return { ok: false, problem: perToolEntryRefusal("toolAxes", unit, key, entry, { index, of: declaredEntries.length }) };
|
|
269
262
|
if (Object.keys(entry).length > 0)
|
|
270
263
|
entries.push([key, entry]);
|
|
271
264
|
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The person-facing half of an MCP server that could not be reached for a leg (`mcp.server_unavailable`, audience `user`). A server that
|
|
3
|
+
* fails to connect or to list its tools is SKIPPED (fail-open: one bad server never bricks the task), and the run completes with the other
|
|
4
|
+
* servers' tools; the operator hears it on `onError` (`{ phase: "mcp" }`), the wiring manifest's row and the materialization's status read
|
|
5
|
+
* `failed`, and this notice is what the session's user hears — where, before it, they heard nothing and found the server's tools missing.
|
|
6
|
+
*
|
|
7
|
+
* It is derived from the SAME warning object the operator lane carries (`MaterializedMcp.warnings`, minted by `asServerWarning` in
|
|
8
|
+
* mcp.ts), where the Runner drains that lane — so the operator's line and the person's notice are one fact, and there is no second source:
|
|
9
|
+
* the server is read off the warning's `server` member, never parsed out of its sentence. A server whose dial failed `unauthorized` is
|
|
10
|
+
* NOT told here: `mcp.authorization_required` already tells the user that fact, with the way to fix it, and says the server's tools are
|
|
11
|
+
* unavailable until then — two notices for one fact would be two readings. Dedup unit: once per (leg, server) — a failed dial yields one
|
|
12
|
+
* warning per materialization, and a later leg that fails again is a new fact; never folded per session (a second server's notice must not
|
|
13
|
+
* be hidden behind the first's).
|
|
14
|
+
*
|
|
15
|
+
* `detail` carries the declared server's name and the leg's session and run — never the failure's text (the server's own words are the
|
|
16
|
+
* operator's) and never a URL, command or path.
|
|
17
|
+
*/
|
|
18
|
+
import type { EngineNotice } from "./engine-notice.js";
|
|
19
|
+
import type { McpServerStatus } from "./mcp.js";
|
|
20
|
+
/** The warning code the materialization mints for a server it skipped, and the notice's own: one word, two faces. */
|
|
21
|
+
export declare const MCP_SERVER_UNAVAILABLE: "mcp.server_unavailable";
|
|
22
|
+
/** What `asServerWarning` mints: the operator warning, carrying the declared server it is about. */
|
|
23
|
+
export type McpServerWarning = Error & {
|
|
24
|
+
code: typeof MCP_SERVER_UNAVAILABLE;
|
|
25
|
+
server: string;
|
|
26
|
+
};
|
|
27
|
+
/** The notice a materialization warning stands for, or `undefined` when it stands for none: a warning of another code, one that names no
|
|
28
|
+
* server, or one about a server whose failure was an authorization (told by `mcp.authorization_required`). */
|
|
29
|
+
export declare function mcpServerUnavailableNotice(warning: Error, statuses: readonly Pick<McpServerStatus, "name" | "authorization">[], leg: {
|
|
30
|
+
sessionId: string;
|
|
31
|
+
runId: string;
|
|
32
|
+
}): EngineNotice | undefined;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
2
|
+
export const MCP_SERVER_UNAVAILABLE = "mcp.server_unavailable";
|
|
3
|
+
export function mcpServerUnavailableNotice(warning, statuses, leg) {
|
|
4
|
+
const { code, server } = warning;
|
|
5
|
+
if (code !== MCP_SERVER_UNAVAILABLE || typeof server !== "string")
|
|
6
|
+
return undefined;
|
|
7
|
+
if (statuses.some((s) => s.name === server && s.authorization !== undefined))
|
|
8
|
+
return undefined;
|
|
9
|
+
return {
|
|
10
|
+
code: "mcp.server_unavailable",
|
|
11
|
+
message: `MCP server "${inlineUntrusted(server, 160)}" could not be reached for this run, so it was skipped — its tools are not available to the assistant ` +
|
|
12
|
+
`in this run, which goes on with the tools of the servers that did connect.`,
|
|
13
|
+
detail: { server, sessionId: leg.sessionId, runId: leg.runId },
|
|
14
|
+
};
|
|
15
|
+
}
|
|
@@ -10,13 +10,16 @@
|
|
|
10
10
|
* knows the session (404), cannot be reached or does not answer within {@link MCP_SESSION_END_WAIT_MS} costs the close that long at most
|
|
11
11
|
* and nothing else — the close runs regardless and aborts a request still in the air.
|
|
12
12
|
*/
|
|
13
|
-
import { StreamableHTTPClientTransport, type Client } from "@modelcontextprotocol/client";
|
|
13
|
+
import { StreamableHTTPClientTransport, type Client, type JSONRPCMessage } from "@modelcontextprotocol/client";
|
|
14
14
|
import type { McpRequestSite } from "./mcp-failure.js";
|
|
15
15
|
/** The longest a close waits for the server to answer the request that ends its session. */
|
|
16
16
|
export declare const MCP_SESSION_END_WAIT_MS = 2000;
|
|
17
|
-
/** The Streamable HTTP transport this engine dials with: closing it ends the server's session first.
|
|
17
|
+
/** The Streamable HTTP transport this engine dials with: closing it ends the server's session first. Each send says what it carries
|
|
18
|
+
* (protocol-revocation.ts `sendingUnder`): a request's own bytes are asked the revocation question the request carries; a notification,
|
|
19
|
+
* an answer to the server's own request and the session end are not. */
|
|
18
20
|
export declare class SessionEndingTransport extends StreamableHTTPClientTransport {
|
|
19
21
|
private closing;
|
|
22
|
+
send(message: JSONRPCMessage | JSONRPCMessage[], options?: Parameters<StreamableHTTPClientTransport["send"]>[1]): Promise<void>;
|
|
20
23
|
/** One close however many ask: a second caller (the SDK closes a transport it rejected, and so does the dial after it) waits for the first's, rather than aborting its DELETE. */
|
|
21
24
|
close(): Promise<void>;
|
|
22
25
|
private endSessionThenClose;
|
|
@@ -1,9 +1,14 @@
|
|
|
1
|
-
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
|
|
1
|
+
import { StreamableHTTPClientTransport, isJSONRPCRequest } from "@modelcontextprotocol/client";
|
|
2
|
+
import { sendingUnder } from "./protocol-revocation.js";
|
|
2
3
|
export const MCP_SESSION_END_WAIT_MS = 2_000;
|
|
3
4
|
export class SessionEndingTransport extends StreamableHTTPClientTransport {
|
|
4
5
|
closing;
|
|
6
|
+
send(message, options) {
|
|
7
|
+
const carriesRequest = Array.isArray(message) ? message.some((m) => isJSONRPCRequest(m)) : isJSONRPCRequest(message);
|
|
8
|
+
return sendingUnder(carriesRequest ? "request" : "other", () => super.send(message, options));
|
|
9
|
+
}
|
|
5
10
|
close() {
|
|
6
|
-
this.closing ??= this.endSessionThenClose();
|
|
11
|
+
this.closing ??= sendingUnder("other", () => this.endSessionThenClose());
|
|
7
12
|
return this.closing;
|
|
8
13
|
}
|
|
9
14
|
async endSessionThenClose() {
|
|
@@ -4,6 +4,12 @@
|
|
|
4
4
|
* (`anthropic/requiresUserInteraction`). Pure readers over the entry's `_meta` — the intake (`mcp.ts`) stamps what they answer
|
|
5
5
|
* on the mounted tool.
|
|
6
6
|
*/
|
|
7
|
+
/**
|
|
8
|
+
* The size of a remote result's text the engine carries when the remote declared none: CC's MCP base declares 1e5 and the first-party floor
|
|
9
|
+
* is 50K, so min(1e5, 50K). One number with two readers — the offload wrapper of a remote-peer mount (a result past it is offloaded) and the
|
|
10
|
+
* host's MCP read ports (a text block past it is cut, `truncated: true`) — so the model's and the host's bound cannot drift apart.
|
|
11
|
+
*/
|
|
12
|
+
export declare const MCP_REMOTE_RESULT_MAX_CHARS = 50000;
|
|
7
13
|
/**
|
|
8
14
|
* F4-② (CC :320015/:320061): resolve a server's self-declared per-tool result-size threshold from its
|
|
9
15
|
* `_meta`. Non-numeric/non-finite/non-positive → undefined (declaration ignored); valid → capped at
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
const MCP_META_RESULT_SIZE_CAP = 500_000;
|
|
2
|
+
export const MCP_REMOTE_RESULT_MAX_CHARS = 50_000;
|
|
2
3
|
export function resolveMcpDeclaredResultSize(meta) {
|
|
3
4
|
const declared = meta?.["anthropic/maxResultSizeChars"];
|
|
4
5
|
if (typeof declared !== "number" || !Number.isFinite(declared) || declared <= 0)
|
package/dist/core/mcp.d.ts
CHANGED
|
@@ -2,12 +2,14 @@ import { type CredentialEchoSite } from "./credential-echo.js";
|
|
|
2
2
|
import { type PeerSeat } from "./peer-seat.js";
|
|
3
3
|
import { type McpInstructionsEntry, type PromptSectionDisposer } from "./prompt-section-seat.js";
|
|
4
4
|
import { McpConnectionPool } from "./mcp-connection-pool.js";
|
|
5
|
+
import { type McpHostReadPorts } from "./mcp-host-read.js";
|
|
5
6
|
import { type McpAuthorization, type McpDelivered, type McpFailureKind, type McpServerLiveness } from "./mcp-failure.js";
|
|
6
7
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
7
|
-
import type { ImageContent, TextContent } from "../internal/llm.js";
|
|
8
|
-
import {
|
|
8
|
+
import type { DocumentContent, ImageContent, TextContent } from "../internal/llm.js";
|
|
9
|
+
import type { ImageDownsampler } from "./image-downsample.js";
|
|
10
|
+
import { type KeptBytes, type ToolResultBytesKeeper, type ToolResultBytesSeat } from "./tool-result-bytes.js";
|
|
9
11
|
import type { McpServerSpec, OnElicit, ToolEffect } from "./types.js";
|
|
10
|
-
import { type
|
|
12
|
+
import { type ProtocolRevocationLedger, type RevocationProbe } from "./protocol-revocation.js";
|
|
11
13
|
import { type McpHostSeat } from "./mcp-host-seat.js";
|
|
12
14
|
import { type HostFloor } from "./host-floor.js";
|
|
13
15
|
import { type ReminderDisclosureCounts } from "./reminder-disclosure.js";
|
|
@@ -94,8 +96,9 @@ export interface McpListingIncomplete {
|
|
|
94
96
|
* rather than reporting a budget that had nothing to do with the stop. */
|
|
95
97
|
budgetMs?: number;
|
|
96
98
|
}
|
|
97
|
-
/** Tools materialized from one or more MCP servers, plus a disposer to disconnect them
|
|
98
|
-
|
|
99
|
+
/** Tools materialized from one or more MCP servers, plus a disposer to disconnect them — and the host's read ports onto each connected
|
|
100
|
+
* server's prompts and resources ({@link McpHostReadPorts}, mcp-host-read.ts: over the connections held here, never a dial). */
|
|
101
|
+
export interface MaterializedMcp extends McpHostReadPorts {
|
|
99
102
|
tools: AgentTool[];
|
|
100
103
|
/**
|
|
101
104
|
* Per-tool safety axes derived from each tool's MCP `annotations` (design/77 §4 / design/70). One entry
|
|
@@ -394,10 +397,10 @@ export declare const MCP_PREFIX: "mcp__";
|
|
|
394
397
|
/**
|
|
395
398
|
* Apply the token gate to a mapped MCP content array (CC `$Mp`/`BMp` shape): text blocks consume a
|
|
396
399
|
* cumulative char budget of `tokens×4`; past the budget they are sliced/dropped head-keep, and the CC
|
|
397
|
-
* guidance note is appended as a final text block. Non-text blocks (images) pass through untouched —
|
|
400
|
+
* guidance note is appended as a final text block. Non-text blocks (images, documents) pass through untouched —
|
|
398
401
|
* same convention as the offload wrapper. Exported for tests.
|
|
399
402
|
*/
|
|
400
|
-
export declare function gateMcpOutput(content: Array<TextContent | ImageContent>, limitTokens?: number): Array<TextContent | ImageContent>;
|
|
403
|
+
export declare function gateMcpOutput(content: Array<TextContent | ImageContent | DocumentContent>, limitTokens?: number): Array<TextContent | ImageContent | DocumentContent>;
|
|
401
404
|
export declare function structuredContentErrorLine(structuredContent: unknown, collectedText: string): string | undefined;
|
|
402
405
|
/** Head+tail bound for MCP error text (exported for tests). */
|
|
403
406
|
export declare function truncateMcpErrorText(s: string): string;
|
|
@@ -496,14 +499,35 @@ interface McpContentItem {
|
|
|
496
499
|
blob?: string;
|
|
497
500
|
};
|
|
498
501
|
}
|
|
502
|
+
/** An MCP result mapped to content: the blocks the model's result is built from, and what became of the server's binary
|
|
503
|
+
* content on the way (an account the run hears once per call). */
|
|
504
|
+
export interface McpMappedContent {
|
|
505
|
+
content: Array<TextContent | ImageContent | DocumentContent>;
|
|
506
|
+
kept: KeptBytes[];
|
|
507
|
+
}
|
|
508
|
+
/** What the run hears of a call whose server sent binary content that is not media the model reads: the server, the call, and
|
|
509
|
+
* each piece's record (the ref it is kept under, or why it is not). */
|
|
510
|
+
export interface McpBinaryKept {
|
|
511
|
+
server: string;
|
|
512
|
+
toolName: string;
|
|
513
|
+
toolCallId: string;
|
|
514
|
+
kept: readonly KeptBytes[];
|
|
515
|
+
}
|
|
516
|
+
/** Where an MCP leg keeps a call's binary content (the run's tool-result store and session — {@link ToolResultBytesSeat}; no store
|
|
517
|
+
* ⇒ nothing is kept and the result says so) and the account it tells once per call (`onKept`). */
|
|
518
|
+
export interface McpBinarySeat extends ToolResultBytesSeat {
|
|
519
|
+
readonly onKept?: (info: McpBinaryKept) => void;
|
|
520
|
+
}
|
|
499
521
|
/**
|
|
500
|
-
* Exported for unit testing (not part of the public package index).
|
|
501
|
-
* image and
|
|
502
|
-
* {@link
|
|
503
|
-
*
|
|
504
|
-
*
|
|
522
|
+
* Exported for unit testing (not part of the public package index). Maps the protocol's blocks and admits nothing: an
|
|
523
|
+
* image block is the server's image, and a resource blob whose claimed type names a media block of the admission's sets
|
|
524
|
+
* ({@link mediaBlockTypeOf}) is that block — the tool-result seat admits both with the run's processor, as it admits
|
|
525
|
+
* every tool's media. Any other binary content (an audio block, a resource blob of another type) is not media the model
|
|
526
|
+
* reads: its bytes are kept in the run's tool-result store (`bytesKeep`: the keeper bound to the seat and the call the ref is minted
|
|
527
|
+
* under) and the model reads the ref ({@link keepBinaryContent}; CC's `persistBlobToTextBlock` gives a path) — or why they were not
|
|
528
|
+
* kept (no `bytesKeep` keeps nothing). `serverName` (when known) labels those lines, as in CC's `transformResultContent(resultContent, serverName)`.
|
|
505
529
|
*/
|
|
506
|
-
export declare function mapContent(content: Array<McpContentItem>, serverName?: string,
|
|
530
|
+
export declare function mapContent(content: Array<McpContentItem>, serverName?: string, bytesKeep?: ToolResultBytesKeeper): Promise<McpMappedContent>;
|
|
507
531
|
/**
|
|
508
532
|
* Connect to each MCP server, list its tools, and wrap them as AgentTools.
|
|
509
533
|
* Tools are namespaced `mcp__<server>__<tool>` (CC parity) to avoid collisions. The model sees each
|
|
@@ -600,22 +624,31 @@ export declare function normalizeMcpToolSchema(schema: unknown): McpSchemaNormal
|
|
|
600
624
|
*/
|
|
601
625
|
export declare function mcpToolSchemaAdvisory(schema: unknown): string | undefined;
|
|
602
626
|
export declare function mcpToolSchemaProblem(schema: unknown): string | undefined;
|
|
603
|
-
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit,
|
|
604
|
-
reminderDisclosure?: {
|
|
627
|
+
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit, _imageProcessor?: ImageDownsampler | false, reminderDisclosure?: {
|
|
605
628
|
reminderMark?: string;
|
|
606
629
|
counts?: ReminderDisclosureCounts;
|
|
607
|
-
},
|
|
630
|
+
}, revocations?: ProtocolRevocationLedger & {
|
|
608
631
|
onProbeFailure?: (error: unknown) => void;
|
|
609
632
|
}, poolOpts?: {
|
|
610
633
|
pool: McpConnectionPool;
|
|
611
634
|
ownsPool?: boolean;
|
|
635
|
+
isolationScope?: string;
|
|
612
636
|
}, promptSections?: PromptSectionDisposer, dialable?: (spec: McpServerSpec) => boolean, signal?: AbortSignal, hostFloor?: HostFloor, peerSeat?: PeerSeat, // `RunnerDeps.peerSeat` (peer-seat.ts): what each request carries; absent ⇒ nothing, and a declared `credentials` refuses that dial
|
|
613
637
|
onAuthorizationRequired?: (server: string, authorization: McpAuthorization) => void, // once per server: what a refusal owes the user (the runner's notice)
|
|
614
638
|
hostSeats?: ReadonlyMap<string, McpHostSeat>, // the leg's host seats by declaration name (mcp-host-seat.ts): a `{ kind: "host" }` server dials through its seat; absent ⇒ such a server is refused at its dial
|
|
615
|
-
onCredentialEchoed?: (server: string, where: CredentialEchoSite) => void
|
|
639
|
+
onCredentialEchoed?: (server: string, where: CredentialEchoSite) => void, // once per server and site: the server echoed this connection's credentials into what it said about itself (the runner's notice)
|
|
640
|
+
binarySeat?: McpBinarySeat): Promise<MaterializedMcp>;
|
|
641
|
+
/** The public entrance's parameters, with the ledger replaced by the leg's probe over it (protocol-revocation.ts `revocationProbe`). */
|
|
642
|
+
type WithLegProbe<T extends readonly unknown[]> = {
|
|
643
|
+
[K in keyof T]: K extends "5" ? RevocationProbe | undefined : T[K];
|
|
644
|
+
};
|
|
645
|
+
type LegMcpArgs = WithLegProbe<Parameters<typeof materializeMcpTools>>;
|
|
616
646
|
/** The runner's materialization of one leg (not index-exported): every minted tool's `tools/call` reads the leg's request-meta seat
|
|
617
|
-
* (`mcp-call-meta.ts`) — the request meta's only source, written only by the `tool.call` station with what its judge passed
|
|
618
|
-
|
|
647
|
+
* (`mcp-call-meta.ts`) — the request meta's only source, written only by the `tool.call` station with what its judge passed — and every
|
|
648
|
+
* request asks the leg's ONE revocation probe, the one its A2A materialization asks too (a broken ledger is told once per leg) — and
|
|
649
|
+
* tells the leg's activity seat (`RunInternals.onSubtreeActivity`) at each progress notification of a call: a server working a long call
|
|
650
|
+
* and reporting it is the leg being active. */
|
|
651
|
+
export declare function materializeLegMcpTools(seat: McpLegMetaReader | undefined, onSubtreeActivity: (() => void) | undefined, ...[specs, principal, onElicit, , reminderDisclosure, revocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired, hostSeats, onCredentialEchoed, binarySeat]: LegMcpArgs): Promise<MaterializedMcp>;
|
|
619
652
|
/**
|
|
620
653
|
* Fold the caller's AUTHORITATIVE per-tool override (design F: caller = trust root) over the server-hint axis.
|
|
621
654
|
* Unlike server hints, the caller may RAISE or LOWER any axis: `effect` sets the repeat-safety class (lower to
|
|
@@ -628,6 +661,8 @@ export declare function applyCallerAxisOverride(name: string, hint: McpToolAxis
|
|
|
628
661
|
egress?: boolean;
|
|
629
662
|
irreversibility?: "always" | "never";
|
|
630
663
|
} | undefined): McpToolAxis | undefined;
|
|
664
|
+
/** The read ports of a leg that declares no MCP server: every name answers `not_declared`. */
|
|
665
|
+
export declare const NO_DECLARED_MCP_READ_PORTS: McpHostReadPorts;
|
|
631
666
|
/** Read a first-page `-32602` message as either meaning (see {@link DIR_READ_NOT_A_DIRECTORY_RE}). Exported
|
|
632
667
|
* for the discrimination nails; the message is SERVER-authored and is only ever classified here, never
|
|
633
668
|
* trusted as instructions. */
|