@sema-agent/core 7.59.0 → 7.61.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,8 +1,22 @@
|
|
|
1
1
|
import { SAFETY_AXIS_VOCABULARY } from "./safety-axis-vocab.js";
|
|
2
2
|
import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
|
|
3
|
+
import { REDACTION_MARK } from "./redaction-marks.js";
|
|
3
4
|
import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
4
5
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
5
6
|
import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
|
|
7
|
+
export const MCP_TRANSPORT_KINDS = Object.freeze(["stdio", "http", "host"]);
|
|
8
|
+
const transportKindsLockstep = true;
|
|
9
|
+
void transportKindsLockstep;
|
|
10
|
+
export function transportKindOf(spec) {
|
|
11
|
+
try {
|
|
12
|
+
const transport = spec.transport;
|
|
13
|
+
const kind = (typeof transport === "object" && transport !== null) || typeof transport === "function" ? Reflect.get(transport, "kind") : undefined;
|
|
14
|
+
return MCP_TRANSPORT_KINDS.find((known) => known === kind);
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return undefined;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
6
20
|
const TOOL_AXES_SURFACES = {
|
|
7
21
|
mcp: { key: "tool", declarer: "MCP server" },
|
|
8
22
|
a2a: { key: "skill", declarer: "A2A peer" },
|
|
@@ -27,25 +41,44 @@ const irreversibilityPolesLockstep = true;
|
|
|
27
41
|
void irreversibilityPolesLockstep;
|
|
28
42
|
const toolAxesDeclarationsAreOne = true;
|
|
29
43
|
void toolAxesDeclarationsAreOne;
|
|
30
|
-
export function
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
function memberNames(path) {
|
|
41
|
-
let rendered = "";
|
|
42
|
-
for (const [index, name] of path.entries()) {
|
|
43
|
-
if (rendered.length > 120)
|
|
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
|
+
export function declarationPath(path, words, base = "") {
|
|
51
|
+
let rendered = base;
|
|
52
|
+
for (const key of path) {
|
|
53
|
+
if (rendered.length > 120 + base.length)
|
|
44
54
|
return `${rendered}${INLINE_TRUNCATION_MARK}`;
|
|
45
|
-
|
|
55
|
+
const name = typeof key === "number" ? `[${key}]` : words.has(key) ? key : callerText(key);
|
|
56
|
+
rendered += typeof key === "number" || rendered === "" ? name : `.${name}`;
|
|
46
57
|
}
|
|
47
58
|
return rendered;
|
|
48
59
|
}
|
|
60
|
+
const DECLARATION_ENTRY_MEMBERS = {
|
|
61
|
+
name: true,
|
|
62
|
+
source: true,
|
|
63
|
+
transport: true,
|
|
64
|
+
allowTools: true,
|
|
65
|
+
elicitation: true,
|
|
66
|
+
toolAxes: true,
|
|
67
|
+
toolFaces: true,
|
|
68
|
+
contentOrigin: true,
|
|
69
|
+
fingerprint: true,
|
|
70
|
+
startupTimeoutMs: true,
|
|
71
|
+
sessionMetaKey: true,
|
|
72
|
+
kind: true,
|
|
73
|
+
command: true,
|
|
74
|
+
args: true,
|
|
75
|
+
url: true,
|
|
76
|
+
credentials: true,
|
|
77
|
+
principalHeader: true,
|
|
78
|
+
cardUrl: true,
|
|
79
|
+
allowSkills: true,
|
|
80
|
+
};
|
|
81
|
+
export const DECLARATION_ENTRY_WORDS = new Set(Object.keys(DECLARATION_ENTRY_MEMBERS));
|
|
49
82
|
export function dataKind(value) {
|
|
50
83
|
return value === null ? "null" : value === undefined ? "undefined" : Array.isArray(value) ? "an array" : typeof value === "object" ? "a record" : `a ${typeof value}`;
|
|
51
84
|
}
|
|
@@ -162,12 +195,12 @@ function readToolAxisEntry(raw) {
|
|
|
162
195
|
const listed = Object.keys(raw);
|
|
163
196
|
const unknown = listed.find((member) => !TOOL_AXIS_MEMBER_NAMES.includes(member));
|
|
164
197
|
if (unknown !== undefined)
|
|
165
|
-
return `unknown member ${
|
|
198
|
+
return `an unknown member ${callerText(unknown)} (the members are ${TOOL_AXIS_MEMBER_NAMES.join(", ")})`;
|
|
166
199
|
const declared = Object.create(null);
|
|
167
200
|
for (const member of TOOL_AXIS_MEMBER_NAMES) {
|
|
168
201
|
const value = raw[member];
|
|
169
202
|
if (value !== undefined && !listed.includes(member))
|
|
170
|
-
return `member ${
|
|
203
|
+
return `member "${member}" is a hidden member: its name answers a value the declaration does not list as its own`;
|
|
171
204
|
declared[member] = value;
|
|
172
205
|
}
|
|
173
206
|
const { effect, egress, irreversibility, boundaryFlow } = declared;
|
|
@@ -192,13 +225,13 @@ const PER_TOOL_DECLARATIONS = {
|
|
|
192
225
|
toolAxes: { plural: "axes", singular: "axis" },
|
|
193
226
|
toolFaces: { plural: "faces", singular: "face" },
|
|
194
227
|
};
|
|
195
|
-
export function receivePerToolDeclaration(declared, field, unit) {
|
|
228
|
+
export function receivePerToolDeclaration(declared, field, unit, words) {
|
|
196
229
|
const received = receiveDeclaration(declared, NO_DECLARATION_PATH_RULES);
|
|
197
230
|
if (!received.ok) {
|
|
198
231
|
const [key, ...member] = received.fault.path;
|
|
199
232
|
if (key === undefined)
|
|
200
233
|
return { ok: false, problem: `${field} cannot be read: ${received.fault.problem}` };
|
|
201
|
-
const where = member.length > 0 ? `member ${
|
|
234
|
+
const where = member.length > 0 ? `member ${declarationPath(member, words)}: ` : "";
|
|
202
235
|
return { ok: false, problem: perToolEntryRefusal(field, unit, String(key), `${where}${received.fault.problem}`) };
|
|
203
236
|
}
|
|
204
237
|
const perTool = received.value;
|
|
@@ -207,8 +240,9 @@ export function receivePerToolDeclaration(declared, field, unit) {
|
|
|
207
240
|
return { ok: true, perTool };
|
|
208
241
|
}
|
|
209
242
|
export function perToolEntryRefusal(field, unit, key, detail) {
|
|
210
|
-
return `the ${PER_TOOL_DECLARATIONS[field].plural} declared for ${unit} ${
|
|
243
|
+
return `the ${PER_TOOL_DECLARATIONS[field].plural} declared for the ${unit} ${callerText(key)} do not fit: ${detail}`;
|
|
211
244
|
}
|
|
245
|
+
export const TOOL_AXIS_WORDS = new Set(TOOL_AXIS_MEMBER_NAMES);
|
|
212
246
|
export function perToolEmptyName(field, unit) {
|
|
213
247
|
return `${field} has an empty ${unit} name`;
|
|
214
248
|
}
|
|
@@ -216,7 +250,7 @@ export function readToolAxes(declared, at) {
|
|
|
216
250
|
const unit = toolAxesSurfaceOf(at).key;
|
|
217
251
|
if (declared === undefined)
|
|
218
252
|
return { ok: true };
|
|
219
|
-
const received = receivePerToolDeclaration(declared, "toolAxes", unit);
|
|
253
|
+
const received = receivePerToolDeclaration(declared, "toolAxes", unit, TOOL_AXIS_WORDS);
|
|
220
254
|
if (!received.ok)
|
|
221
255
|
return { ok: false, problem: received.problem };
|
|
222
256
|
const entries = [];
|
|
@@ -10,8 +10,7 @@
|
|
|
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 type
|
|
14
|
-
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
|
|
13
|
+
import { StreamableHTTPClientTransport, type Client } from "@modelcontextprotocol/client";
|
|
15
14
|
import type { McpRequestSite } from "./mcp-failure.js";
|
|
16
15
|
/** The longest a close waits for the server to answer the request that ends its session. */
|
|
17
16
|
export declare const MCP_SESSION_END_WAIT_MS = 2000;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/
|
|
1
|
+
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
|
|
2
2
|
export const MCP_SESSION_END_WAIT_MS = 2_000;
|
|
3
3
|
export class SessionEndingTransport extends StreamableHTTPClientTransport {
|
|
4
4
|
closing;
|
package/dist/core/mcp.d.ts
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
|
+
import { type CredentialEchoSite } from "./credential-echo.js";
|
|
1
2
|
import { type PeerSeat } from "./peer-seat.js";
|
|
2
3
|
import { type McpInstructionsEntry, type PromptSectionDisposer } from "./prompt-section-seat.js";
|
|
3
4
|
import { McpConnectionPool } from "./mcp-connection-pool.js";
|
|
4
5
|
import { type McpAuthorization, type McpDelivered, type McpFailureKind, type McpServerLiveness } from "./mcp-failure.js";
|
|
5
6
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
6
7
|
import type { ImageContent, TextContent } from "../internal/llm.js";
|
|
7
|
-
import { type
|
|
8
|
+
import { type ImageDownsampler } from "./image-downsample.js";
|
|
8
9
|
import type { McpServerSpec, OnElicit, ToolEffect } from "./types.js";
|
|
9
|
-
import type
|
|
10
|
+
import { type McpRevocationLedger } from "./mcp-server-spec.js";
|
|
11
|
+
import { type McpHostSeat } from "./mcp-host-seat.js";
|
|
10
12
|
import { type HostFloor } from "./host-floor.js";
|
|
11
13
|
import { type ReminderDisclosureCounts } from "./reminder-disclosure.js";
|
|
12
14
|
import { type McpLegMetaReader } from "./mcp-call-meta.js";
|
|
@@ -79,7 +81,7 @@ export interface McpDroppedTool {
|
|
|
79
81
|
* ({@link walkMcpListPages}'s `budgetMs`) had too little left to fund another request
|
|
80
82
|
* ({@link MIN_MCP_PAGE_BUDGET_MS}), so none was sent. Distinct from `page_error` on purpose — the
|
|
81
83
|
* server neither failed nor was asked. Issuing that request anyway would hand the SDK a
|
|
82
|
-
* near-zero timeout, and its
|
|
84
|
+
* near-zero timeout, and its `RequestTimeout` would arrive here wearing the server's failure clothes.
|
|
83
85
|
* `error` is SERVER-authored text — neutralize it before it rides any model/operator face.
|
|
84
86
|
*/
|
|
85
87
|
export interface McpListingIncomplete {
|
|
@@ -401,7 +403,7 @@ export declare function structuredContentErrorLine(structuredContent: unknown, c
|
|
|
401
403
|
export declare function truncateMcpErrorText(s: string): string;
|
|
402
404
|
/**
|
|
403
405
|
* Default per-call MCP tool timeout. The SDK's own default (60s) silently kills any long-running MCP tool
|
|
404
|
-
* with a
|
|
406
|
+
* with a `RequestTimeout` and offers the deployment no knob; a very large default (matching the behavior of the
|
|
405
407
|
* reference agent client) lets the task-level budget/abort govern instead, while `MCP_TOOL_TIMEOUT` (ms)
|
|
406
408
|
* remains available to tighten it per deployment.
|
|
407
409
|
*/
|
|
@@ -430,11 +432,11 @@ export declare function mcpToolTimeoutMs(): number;
|
|
|
430
432
|
* per-call timeout). The SDK's `resetTimeoutOnProgress` only re-arms the SDK's OWN per-call timer
|
|
431
433
|
* (`mcpToolTimeoutMs()` above — a different mechanism from {@link armMcpIdleWatchdog}'s idle watchdog
|
|
432
434
|
* below, despite the name-adjacent terms; disambiguated here on purpose, see that function's docstring
|
|
433
|
-
* for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (protocol
|
|
434
|
-
* `_resetTimeout`), so without this a
|
|
435
|
+
* for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (the protocol
|
|
436
|
+
* layer's `_resetTimeout`), so without this a
|
|
435
437
|
* misbehaving/stuck server emitting periodic progress notifications could extend a call forever. Defaulting
|
|
436
438
|
* the ceiling to the per-call timeout means progress can keep an active call alive only within the same
|
|
437
|
-
* window the deployment already accepted; the resulting failure is the same
|
|
439
|
+
* window the deployment already accepted; the resulting failure is the same `RequestTimeout` frame. Env
|
|
438
440
|
* parsing follows the `MCP_TOOL_TIMEOUT` discipline (unset/unparseable/non-positive → default). Exported
|
|
439
441
|
* for tests.
|
|
440
442
|
*/
|
|
@@ -446,7 +448,7 @@ export declare function mcpToolTotalTimeoutMs(perCallMs: number): number;
|
|
|
446
448
|
* from its total ceiling (`j7u` @345484: stdio 30min / http-sse 5min).
|
|
447
449
|
*
|
|
448
450
|
* Narrower than the audit's original framing: a CLOSED transport is already handled correctly by the SDK
|
|
449
|
-
* itself — `Protocol._onclose`
|
|
451
|
+
* itself — `Protocol._onclose` rejects every in-flight response handler immediately
|
|
450
452
|
* with `ConnectionClosed` the moment `onclose` fires, so this watchdog exists for the SILENT-but-open case
|
|
451
453
|
* only, not as a substitute for connection-close handling.
|
|
452
454
|
*/
|
|
@@ -468,15 +470,6 @@ export declare function mcpStartupTimeoutMs(server?: Pick<McpServerSpec, "name"
|
|
|
468
470
|
/** The protocol-range condition name for a JSON-RPC error code, or `undefined` for every other code
|
|
469
471
|
* (see {@link MCP_SPEC_ERROR_CODE_NAMES}). */
|
|
470
472
|
export declare function describeMcpSpecErrorCode(code: unknown): string | undefined;
|
|
471
|
-
/**
|
|
472
|
-
* The SDK stamps `MCP error <code>: ` onto an McpError's message IN ITS CONSTRUCTOR, and it
|
|
473
|
-
* does so at BOTH ends of the wire: a server built on an MCP SDK throws an McpError, its already-stamped
|
|
474
|
-
* `.message` goes out as the JSON-RPC `error.message`, and the client constructs its own McpError over
|
|
475
|
-
* that string — so the failure reaches the model as `MCP error -32602: MCP error -32602: …`. Collapse a
|
|
476
|
-
* repeat of the SAME code (a leading stamp carrying a DIFFERENT code is server data, not a duplicate of
|
|
477
|
-
* ours, and is left alone). Exported for unit testing; not part of the package index.
|
|
478
|
-
*/
|
|
479
|
-
export declare function collapseMcpErrorPrefix(message: string): string;
|
|
480
473
|
export { normalizeNameSegment as normalizeMcpName, clampNameSegment } from "./protocol-naming.js";
|
|
481
474
|
export * from "./image-downsample.js";
|
|
482
475
|
/**
|
|
@@ -503,7 +496,14 @@ interface McpContentItem {
|
|
|
503
496
|
blob?: string;
|
|
504
497
|
};
|
|
505
498
|
}
|
|
506
|
-
|
|
499
|
+
/**
|
|
500
|
+
* Exported for unit testing (not part of the public package index). ASYNC since design/116 W5: an oversized
|
|
501
|
+
* image and any audio/binary blob are now spilled to disk (see {@link blobToTextBlock} /
|
|
502
|
+
* {@link boundedImageBlock}) instead of being inlined or dropped. `serverName` (when known) attributes the
|
|
503
|
+
* spilled files + labels, mirroring CC's `transformResultContent(resultContent, serverName)`. `imageProcessor` is the run's
|
|
504
|
+
* one processor seat (`RunnerDeps.imageProcessor`), read through `resolveImageProcessor`.
|
|
505
|
+
*/
|
|
506
|
+
export declare function mapContent(content: Array<McpContentItem>, serverName?: string, imageProcessor?: ImageDownsampler | false): Promise<Array<TextContent | ImageContent>>;
|
|
507
507
|
/**
|
|
508
508
|
* Connect to each MCP server, list its tools, and wrap them as AgentTools.
|
|
509
509
|
* Tools are namespaced `mcp__<server>__<tool>` (CC parity) to avoid collisions. The model sees each
|
|
@@ -600,7 +600,7 @@ export declare function normalizeMcpToolSchema(schema: unknown): McpSchemaNormal
|
|
|
600
600
|
*/
|
|
601
601
|
export declare function mcpToolSchemaAdvisory(schema: unknown): string | undefined;
|
|
602
602
|
export declare function mcpToolSchemaProblem(schema: unknown): string | undefined;
|
|
603
|
-
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit,
|
|
603
|
+
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit, imageProcessor?: ImageDownsampler | false, // the one image processor seat (`RunnerDeps.imageProcessor`): a processor, `false` (none), absent = auto-detected sharp
|
|
604
604
|
reminderDisclosure?: {
|
|
605
605
|
reminderMark?: string;
|
|
606
606
|
counts?: ReminderDisclosureCounts;
|
|
@@ -610,10 +610,12 @@ reminderDisclosure?: {
|
|
|
610
610
|
pool: McpConnectionPool;
|
|
611
611
|
ownsPool?: boolean;
|
|
612
612
|
}, 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
|
-
onAuthorizationRequired?: (server: string, authorization: McpAuthorization) => void
|
|
613
|
+
onAuthorizationRequired?: (server: string, authorization: McpAuthorization) => void, // once per server: what a refusal owes the user (the runner's notice)
|
|
614
|
+
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): Promise<MaterializedMcp>;
|
|
614
616
|
/** The runner's materialization of one leg (not index-exported): every minted tool's `tools/call` reads the leg's request-meta seat
|
|
615
617
|
* (`mcp-call-meta.ts`) — the request meta's only source, written only by the `tool.call` station with what its judge passed. */
|
|
616
|
-
export declare function materializeLegMcpTools(seat: McpLegMetaReader | undefined, ...[specs, principal, onElicit,
|
|
618
|
+
export declare function materializeLegMcpTools(seat: McpLegMetaReader | undefined, ...[specs, principal, onElicit, imageProcessor, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired, hostSeats, onCredentialEchoed]: Parameters<typeof materializeMcpTools>): Promise<MaterializedMcp>;
|
|
617
619
|
/**
|
|
618
620
|
* Fold the caller's AUTHORITATIVE per-tool override (design F: caller = trust root) over the server-hint axis.
|
|
619
621
|
* Unlike server hints, the caller may RAISE or LOWER any axis: `effect` sets the repeat-safety class (lower to
|
|
@@ -724,37 +726,3 @@ export declare function walkMcpListPages<T>(fetchPage: (cursor: string | undefin
|
|
|
724
726
|
items: T[];
|
|
725
727
|
incomplete?: McpListingIncomplete;
|
|
726
728
|
}>;
|
|
727
|
-
/**
|
|
728
|
-
* RB-408 G12 — `tools/call` result parse that accepts the MCP `2026-07-28` widening of
|
|
729
|
-
* `structuredContent` from "a JSON object" to ANY JSON value (the same revision that relaxes
|
|
730
|
-
* `inputSchema`/`outputSchema` to the full JSON Schema 2020-12 keyword set).
|
|
731
|
-
*
|
|
732
|
-
* SDK 1.30.0's `CallToolResultSchema` still types the field as a record, so a spec-legal array / string /
|
|
733
|
-
* number / boolean / null fails validation for the WHOLE result — and the failure takes the `content`
|
|
734
|
-
* blocks down with it: a server returning perfectly usable text plus a scalar `structuredContent`
|
|
735
|
-
* produced nothing but `Invalid tools/call result: expected record, received number`. That is a silent
|
|
736
|
-
* capability loss dressed as a protocol error, and it gets WORSE as servers adopt the revision.
|
|
737
|
-
*
|
|
738
|
-
* The widening is deliberately surgical: `structuredContent` is lifted out, the SDK's own strict schema
|
|
739
|
-
* runs over the remainder (so content-block validation, the `content` default and the loose passthrough
|
|
740
|
-
* of unknown top-level keys are byte-for-byte what they were), and the lifted value is re-attached
|
|
741
|
-
* VERBATIM — same reference, no rebuild. An object-valued `structuredContent` therefore behaves exactly
|
|
742
|
-
* as before, and a malformed `content` array is still rejected: this must not become a validation bypass.
|
|
743
|
-
* Same duck-typing posture as {@link LenientListToolsResultSchema} (no direct `zod` dependency — the SDK's
|
|
744
|
-
* `zod-compat` shim calls `.safeParse(data)` on any object lacking a Zod-4 `_zod` marker).
|
|
745
|
-
*
|
|
746
|
-
* RESIDUAL, SDK-side and deliberately not widened here: `Client.callTool` guards its `outputSchema`
|
|
747
|
-
* validation with a TRUTHINESS test on `result.structuredContent`, so a tool that declares an
|
|
748
|
-
* `outputSchema` and returns a falsy scalar (`0`, `""`, `false`, `null`) is still rejected by the SDK with
|
|
749
|
-
* "has an output schema but did not return structured content". That path is LOUD (never a silent drop),
|
|
750
|
-
* is bounded to outputSchema-declaring tools, and widening it means replacing `callTool` itself — which
|
|
751
|
-
* would mean re-implementing the two guards it exists for (the output validator and the
|
|
752
|
-
* `taskSupport:"required"` refusal, both keyed off SDK-private caches).
|
|
753
|
-
*/
|
|
754
|
-
export declare function parseCallToolResultLenient(data: unknown): {
|
|
755
|
-
success: true;
|
|
756
|
-
data: unknown;
|
|
757
|
-
} | {
|
|
758
|
-
success: false;
|
|
759
|
-
error: unknown;
|
|
760
|
-
};
|