@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -0,0 +1,428 @@
|
|
|
1
|
+
import { ProtocolError, ProtocolErrorCode } from "@modelcontextprotocol/client";
|
|
2
|
+
import { types } from "node:util";
|
|
3
|
+
import { callerText } from "./caller-text.js";
|
|
4
|
+
import { erasedEcho, nameEchoes } from "./credential-echo.js";
|
|
5
|
+
import { resolveEnvBudget } from "./env-budget.js";
|
|
6
|
+
import { failureFields, namingLostSession, readMcpFailure } from "./mcp-failure.js";
|
|
7
|
+
import { IDLE_WATCHDOG_ABORT_REASON, armMcpIdleWatchdog, observedFailure } from "./mcp-server-link.js";
|
|
8
|
+
import { requestSite } from "./mcp-session-end.js";
|
|
9
|
+
import { MCP_REMOTE_RESULT_MAX_CHARS } from "./mcp-tool-meta.js";
|
|
10
|
+
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
11
|
+
import { MCP_PROMPT_GET_ALLOW, MCP_PROMPT_LIST_ALLOW, MCP_RESOURCE_LIST_ALLOW, MCP_RESOURCE_READ_ALLOW, MCP_RESOURCE_TEMPLATE_LIST_ALLOW, faceAllowed } from "./mounted-mcp.js";
|
|
12
|
+
import { ProtocolRevokedRefusal } from "./protocol-revocation.js";
|
|
13
|
+
import { keepBytesWith } from "./tool-result-bytes.js";
|
|
14
|
+
import { delimitUntrustedWithClip, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
|
|
15
|
+
const MCP_OUTPUT_TOKENS_DEFAULT = 25_000;
|
|
16
|
+
export const MCP_CHARS_PER_TOKEN = 4;
|
|
17
|
+
export function mcpMaxOutputTokens() {
|
|
18
|
+
return resolveEnvBudget(process.env.MAX_MCP_OUTPUT_TOKENS, { name: "MAX_MCP_OUTPUT_TOKENS", unit: "tokens", default: MCP_OUTPUT_TOKENS_DEFAULT });
|
|
19
|
+
}
|
|
20
|
+
export function notServed(err) {
|
|
21
|
+
return err instanceof ProtocolError && err.code === ProtocolErrorCode.MethodNotFound;
|
|
22
|
+
}
|
|
23
|
+
const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
|
|
24
|
+
const BAD = Symbol("member of the wrong kind");
|
|
25
|
+
function optString(o, key) {
|
|
26
|
+
const v = o[key];
|
|
27
|
+
return v === undefined || v === null ? undefined : typeof v === "string" ? v : BAD;
|
|
28
|
+
}
|
|
29
|
+
const nonEmptyString = (v) => typeof v === "string" && v !== "";
|
|
30
|
+
function display(text, echo) {
|
|
31
|
+
return sanitizeUntrustedText(echo === undefined ? text : erasedEcho(text, echo.echo, echo.where));
|
|
32
|
+
}
|
|
33
|
+
function bounded(text) {
|
|
34
|
+
if (text.length <= MCP_REMOTE_RESULT_MAX_CHARS)
|
|
35
|
+
return { text };
|
|
36
|
+
const cps = [...text];
|
|
37
|
+
return cps.length <= MCP_REMOTE_RESULT_MAX_CHARS ? { text } : { text: cps.slice(0, MCP_REMOTE_RESULT_MAX_CHARS).join(""), truncated: true };
|
|
38
|
+
}
|
|
39
|
+
function promptEntryOf(raw, echo) {
|
|
40
|
+
if (!isRecord(raw) || !nonEmptyString(raw.name))
|
|
41
|
+
return undefined;
|
|
42
|
+
const title = optString(raw, "title");
|
|
43
|
+
const description = optString(raw, "description");
|
|
44
|
+
if (title === BAD || description === BAD)
|
|
45
|
+
return undefined;
|
|
46
|
+
const where = { echo, where: "prompt_listing" };
|
|
47
|
+
let args;
|
|
48
|
+
const declared = raw.arguments;
|
|
49
|
+
if (declared !== undefined && declared !== null) {
|
|
50
|
+
if (!Array.isArray(declared))
|
|
51
|
+
return undefined;
|
|
52
|
+
const list = declared;
|
|
53
|
+
args = [];
|
|
54
|
+
for (const a of list) {
|
|
55
|
+
if (!isRecord(a) || !nonEmptyString(a.name))
|
|
56
|
+
return undefined;
|
|
57
|
+
const at = optString(a, "title");
|
|
58
|
+
const ad = optString(a, "description");
|
|
59
|
+
const required = a.required;
|
|
60
|
+
if (at === BAD || ad === BAD || (required !== undefined && required !== null && typeof required !== "boolean"))
|
|
61
|
+
return undefined;
|
|
62
|
+
if (nameEchoes(a.name, echo, "prompt_listing"))
|
|
63
|
+
return undefined;
|
|
64
|
+
args.push({ name: a.name, ...(at !== undefined ? { title: display(at, where) } : {}), ...(ad !== undefined ? { description: display(ad, where) } : {}), ...(typeof required === "boolean" ? { required } : {}) });
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
if (nameEchoes(raw.name, echo, "prompt_listing"))
|
|
68
|
+
return undefined;
|
|
69
|
+
return { name: raw.name, ...(title !== undefined ? { title: display(title, where) } : {}), ...(description !== undefined ? { description: display(description, where) } : {}), ...(args !== undefined ? { arguments: args } : {}) };
|
|
70
|
+
}
|
|
71
|
+
function resourceEntryOf(raw, echo) {
|
|
72
|
+
if (!isRecord(raw) || !nonEmptyString(raw.uri) || !nonEmptyString(raw.name))
|
|
73
|
+
return undefined;
|
|
74
|
+
const title = optString(raw, "title");
|
|
75
|
+
const description = optString(raw, "description");
|
|
76
|
+
const mimeType = optString(raw, "mimeType");
|
|
77
|
+
const size = raw.size;
|
|
78
|
+
if (title === BAD || description === BAD || mimeType === BAD)
|
|
79
|
+
return undefined;
|
|
80
|
+
if (size !== undefined && size !== null && !(typeof size === "number" && Number.isFinite(size) && size >= 0))
|
|
81
|
+
return undefined;
|
|
82
|
+
if (nameEchoes(raw.uri, echo, "resource_listing") || nameEchoes(raw.name, echo, "resource_listing"))
|
|
83
|
+
return undefined;
|
|
84
|
+
const where = { echo, where: "resource_listing" };
|
|
85
|
+
return { uri: raw.uri, name: raw.name, ...(title !== undefined ? { title: display(title, where) } : {}), ...(description !== undefined ? { description: display(description, where) } : {}), ...(mimeType !== undefined ? { mimeType: display(mimeType, where) } : {}), ...(typeof size === "number" ? { size } : {}) };
|
|
86
|
+
}
|
|
87
|
+
function templateEntryOf(raw, echo) {
|
|
88
|
+
if (!isRecord(raw) || !nonEmptyString(raw.uriTemplate) || !nonEmptyString(raw.name))
|
|
89
|
+
return undefined;
|
|
90
|
+
const title = optString(raw, "title");
|
|
91
|
+
const description = optString(raw, "description");
|
|
92
|
+
const mimeType = optString(raw, "mimeType");
|
|
93
|
+
if (title === BAD || description === BAD || mimeType === BAD)
|
|
94
|
+
return undefined;
|
|
95
|
+
if (nameEchoes(raw.uriTemplate, echo, "resource_listing") || nameEchoes(raw.name, echo, "resource_listing"))
|
|
96
|
+
return undefined;
|
|
97
|
+
const where = { echo, where: "resource_listing" };
|
|
98
|
+
return { uriTemplate: raw.uriTemplate, name: raw.name, ...(title !== undefined ? { title: display(title, where) } : {}), ...(description !== undefined ? { description: display(description, where) } : {}), ...(mimeType !== undefined ? { mimeType: display(mimeType, where) } : {}) };
|
|
99
|
+
}
|
|
100
|
+
function envelopeOf(method, member, data) {
|
|
101
|
+
if (!isRecord(data))
|
|
102
|
+
return `${method} result is not an object`;
|
|
103
|
+
const items = data[member];
|
|
104
|
+
if (!Array.isArray(items))
|
|
105
|
+
return `${method} result.${member} is not an array`;
|
|
106
|
+
const list = items;
|
|
107
|
+
return { answer: data, items: list };
|
|
108
|
+
}
|
|
109
|
+
function envelopeSchema(method, member) {
|
|
110
|
+
return {
|
|
111
|
+
"~standard": {
|
|
112
|
+
version: 1,
|
|
113
|
+
vendor: "sema-core",
|
|
114
|
+
validate: (data) => {
|
|
115
|
+
const read = envelopeOf(method, member, data);
|
|
116
|
+
return typeof read === "string" ? { issues: [{ message: read }] } : { value: data };
|
|
117
|
+
},
|
|
118
|
+
},
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
function readEnvelope(method, member, data) {
|
|
122
|
+
const read = envelopeOf(method, member, data);
|
|
123
|
+
if (typeof read === "string")
|
|
124
|
+
throw new Error(read);
|
|
125
|
+
return read;
|
|
126
|
+
}
|
|
127
|
+
function cursorOf(answer) {
|
|
128
|
+
const next = answer.nextCursor;
|
|
129
|
+
if (typeof next === "string")
|
|
130
|
+
return { nextCursor: next };
|
|
131
|
+
return next === undefined || next === null ? {} : { cursorInvalid: true };
|
|
132
|
+
}
|
|
133
|
+
const LISTINGS = {
|
|
134
|
+
prompts: { method: "prompts/list", member: "prompts", entryOf: promptEntryOf },
|
|
135
|
+
resources: { method: "resources/list", member: "resources", entryOf: resourceEntryOf },
|
|
136
|
+
resourceTemplates: { method: "resources/templates/list", member: "resourceTemplates", entryOf: templateEntryOf },
|
|
137
|
+
};
|
|
138
|
+
const LISTING_SCHEMAS = {
|
|
139
|
+
prompts: envelopeSchema("prompts/list", "prompts"),
|
|
140
|
+
resources: envelopeSchema("resources/list", "resources"),
|
|
141
|
+
resourceTemplates: envelopeSchema("resources/templates/list", "resourceTemplates"),
|
|
142
|
+
};
|
|
143
|
+
export async function readMcpListing(route, kind, watch, idleMs, signal, deps, told) {
|
|
144
|
+
const listing = LISTINGS[kind];
|
|
145
|
+
let walk;
|
|
146
|
+
try {
|
|
147
|
+
walk = await deps.walk(async (cursor, remainingMs) => {
|
|
148
|
+
const request = cursor === undefined ? { method: listing.method } : { method: listing.method, params: { cursor } };
|
|
149
|
+
const answered = await route.through(() => route.client.request(request, LISTING_SCHEMAS[kind], { signal: watch.combinedSignal, timeout: remainingMs })).catch((err) => {
|
|
150
|
+
if (cursor === undefined && notServed(err))
|
|
151
|
+
throw err;
|
|
152
|
+
if (told !== undefined)
|
|
153
|
+
told(err, remainingMs);
|
|
154
|
+
const tripped = watch.idleSignal.reason === IDLE_WATCHDOG_ABORT_REASON;
|
|
155
|
+
if (cursor !== undefined && signal?.aborted !== true) {
|
|
156
|
+
if (tripped)
|
|
157
|
+
route.health.observe?.("timeout");
|
|
158
|
+
else
|
|
159
|
+
observedFailure(err, requestSite(route.client), route.health, true);
|
|
160
|
+
}
|
|
161
|
+
throw tripped ? new Error(deps.idleTripText(idleMs)) : err;
|
|
162
|
+
});
|
|
163
|
+
route.health.observe?.("completed");
|
|
164
|
+
const page = readEnvelope(listing.method, listing.member, answered);
|
|
165
|
+
return { items: [...page.items], ...cursorOf(page.answer) };
|
|
166
|
+
}, { budgetMs: deps.timeoutMs(), onPage: () => watch.rearm(), fingerprintOf: deps.fingerprint, declared: route.declared, ...(signal !== undefined ? { signal } : {}) });
|
|
167
|
+
}
|
|
168
|
+
catch (err) {
|
|
169
|
+
if (!notServed(err))
|
|
170
|
+
throw err;
|
|
171
|
+
observedFailure(err, requestSite(route.client), route.health, false);
|
|
172
|
+
return { entries: [], dropped: 0 };
|
|
173
|
+
}
|
|
174
|
+
const entries = [];
|
|
175
|
+
for (const raw of walk.items) {
|
|
176
|
+
const entry = listing.entryOf(raw, route.echo);
|
|
177
|
+
if (entry !== undefined)
|
|
178
|
+
entries.push(entry);
|
|
179
|
+
}
|
|
180
|
+
return { entries, dropped: walk.items.length - entries.length, ...(walk.incomplete !== undefined ? { incomplete: walk.incomplete } : {}) };
|
|
181
|
+
}
|
|
182
|
+
const FETCH_MEMBERS = { "prompts/get": "messages", "resources/read": "contents" };
|
|
183
|
+
const FETCH_SCHEMAS = {
|
|
184
|
+
"prompts/get": envelopeSchema("prompts/get", FETCH_MEMBERS["prompts/get"]),
|
|
185
|
+
"resources/read": envelopeSchema("resources/read", FETCH_MEMBERS["resources/read"]),
|
|
186
|
+
};
|
|
187
|
+
export function fetchParamsOf(route, params) {
|
|
188
|
+
const _meta = route.meta();
|
|
189
|
+
return { ...params, ...(_meta !== undefined ? { _meta } : {}) };
|
|
190
|
+
}
|
|
191
|
+
export async function fetchMcpAnswer(route, method, params, watch, timeoutMs) {
|
|
192
|
+
const answered = await route.through(() => route.client.request({ method, params: fetchParamsOf(route, params) }, FETCH_SCHEMAS[method], { signal: watch.combinedSignal, timeout: timeoutMs }));
|
|
193
|
+
route.health.observe?.("completed");
|
|
194
|
+
return readEnvelope(method, FETCH_MEMBERS[method], answered);
|
|
195
|
+
}
|
|
196
|
+
const keptOf = async (keep, data, mimeType) => (await keepBytesWith(keep, Buffer.from(data, "base64"), mimeType)).kept;
|
|
197
|
+
async function embeddedOf(raw, keep) {
|
|
198
|
+
if (!isRecord(raw) || !nonEmptyString(raw.uri))
|
|
199
|
+
return undefined;
|
|
200
|
+
const mimeType = optString(raw, "mimeType");
|
|
201
|
+
const text = optString(raw, "text");
|
|
202
|
+
const blob = optString(raw, "blob");
|
|
203
|
+
if (mimeType === BAD || text === BAD || blob === BAD || (text === undefined) === (blob === undefined))
|
|
204
|
+
return undefined;
|
|
205
|
+
const head = { uri: raw.uri, ...(mimeType !== undefined ? { mimeType: display(mimeType) } : {}) };
|
|
206
|
+
return text !== undefined ? { ...head, ...bounded(display(text)) } : { ...head, kept: await keptOf(keep, blob, mimeType) };
|
|
207
|
+
}
|
|
208
|
+
async function blockOf(raw, keep) {
|
|
209
|
+
if (!isRecord(raw))
|
|
210
|
+
return undefined;
|
|
211
|
+
const type = raw.type;
|
|
212
|
+
if (type === "text")
|
|
213
|
+
return typeof raw.text === "string" ? { type, ...bounded(display(raw.text)) } : undefined;
|
|
214
|
+
if (type === "image" || type === "audio") {
|
|
215
|
+
return nonEmptyString(raw.data) && nonEmptyString(raw.mimeType) ? { type, mimeType: display(raw.mimeType), kept: await keptOf(keep, raw.data, raw.mimeType) } : undefined;
|
|
216
|
+
}
|
|
217
|
+
if (type === "resource") {
|
|
218
|
+
const resource = await embeddedOf(raw.resource, keep);
|
|
219
|
+
return resource === undefined ? undefined : { type, resource };
|
|
220
|
+
}
|
|
221
|
+
if (type === "resource_link") {
|
|
222
|
+
if (!nonEmptyString(raw.uri) || !nonEmptyString(raw.name))
|
|
223
|
+
return undefined;
|
|
224
|
+
const title = optString(raw, "title");
|
|
225
|
+
const description = optString(raw, "description");
|
|
226
|
+
const mimeType = optString(raw, "mimeType");
|
|
227
|
+
if (title === BAD || description === BAD || mimeType === BAD)
|
|
228
|
+
return undefined;
|
|
229
|
+
return { type, uri: raw.uri, name: raw.name, ...(title !== undefined ? { title: display(title) } : {}), ...(description !== undefined ? { description: display(description) } : {}), ...(mimeType !== undefined ? { mimeType: display(mimeType) } : {}) };
|
|
230
|
+
}
|
|
231
|
+
return undefined;
|
|
232
|
+
}
|
|
233
|
+
export async function promptAnswerOf(fetched, keep) {
|
|
234
|
+
const messages = [];
|
|
235
|
+
let dropped = 0;
|
|
236
|
+
for (const m of fetched.items) {
|
|
237
|
+
const role = isRecord(m) ? m.role : undefined;
|
|
238
|
+
const content = isRecord(m) && (role === "user" || role === "assistant") ? await blockOf(m.content, keep) : undefined;
|
|
239
|
+
if (content === undefined || (role !== "user" && role !== "assistant"))
|
|
240
|
+
dropped++;
|
|
241
|
+
else
|
|
242
|
+
messages.push({ role, content });
|
|
243
|
+
}
|
|
244
|
+
const description = fetched.answer.description;
|
|
245
|
+
return { ...(typeof description === "string" ? { description: display(description) } : {}), messages, ...(dropped > 0 ? { dropped } : {}) };
|
|
246
|
+
}
|
|
247
|
+
export async function resourceContentsOf(fetched, keep) {
|
|
248
|
+
const contents = [];
|
|
249
|
+
let dropped = 0;
|
|
250
|
+
for (const c of fetched.items) {
|
|
251
|
+
const entry = await embeddedOf(c, keep);
|
|
252
|
+
if (entry === undefined)
|
|
253
|
+
dropped++;
|
|
254
|
+
else
|
|
255
|
+
contents.push(entry);
|
|
256
|
+
}
|
|
257
|
+
return { contents, ...(dropped > 0 ? { dropped } : {}) };
|
|
258
|
+
}
|
|
259
|
+
export function renderMcpPromptForModel(server, prompt, answer) {
|
|
260
|
+
const parts = [];
|
|
261
|
+
let notCarried = 0;
|
|
262
|
+
let cutBlocks = 0;
|
|
263
|
+
for (const m of answer.messages) {
|
|
264
|
+
const c = m.content;
|
|
265
|
+
if (c.type === "text" && typeof c.text === "string") {
|
|
266
|
+
parts.push(c.text);
|
|
267
|
+
if (c.truncated === true)
|
|
268
|
+
cutBlocks++;
|
|
269
|
+
}
|
|
270
|
+
else if (c.type === "resource" && "text" in c.resource && typeof c.resource.text === "string") {
|
|
271
|
+
parts.push(`[resource ${c.resource.uri}]\n${c.resource.text}`);
|
|
272
|
+
if (c.resource.truncated === true)
|
|
273
|
+
cutBlocks++;
|
|
274
|
+
}
|
|
275
|
+
else if (c.type === "resource_link") {
|
|
276
|
+
parts.push(`[resource link: ${c.name}] ${c.uri}${c.description !== undefined ? ` (${c.description})` : ""}`);
|
|
277
|
+
}
|
|
278
|
+
else {
|
|
279
|
+
notCarried++;
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
const cap = mcpMaxOutputTokens() * MCP_CHARS_PER_TOKEN;
|
|
283
|
+
const fence = delimitUntrustedWithClip(`MCP prompt "${prompt}" of server "${server}"`, parts.join("\n\n"), cap);
|
|
284
|
+
const notes = [];
|
|
285
|
+
if (fence.clipped)
|
|
286
|
+
notes.push(`(Truncated by the agent runtime: this prompt exceeded ${cap} characters.)`);
|
|
287
|
+
if (cutBlocks > 0)
|
|
288
|
+
notes.push(`(Truncated by the agent runtime: ${cutBlocks} text block${cutBlocks === 1 ? "" : "s"} of this prompt exceeded ${MCP_REMOTE_RESULT_MAX_CHARS} characters and ${cutBlocks === 1 ? "was" : "were"} cut.)`);
|
|
289
|
+
if (notCarried > 0)
|
|
290
|
+
notes.push(`(${notCarried} non-text block${notCarried === 1 ? "" : "s"} of this prompt ${notCarried === 1 ? "was" : "were"} not carried into the conversation.)`);
|
|
291
|
+
return [fence.text, ...notes].join("\n");
|
|
292
|
+
}
|
|
293
|
+
const invalidArgument = (message) => Object.assign(new Error(message), { code: "config.invalid_argument" });
|
|
294
|
+
const kindOf = (v) => (v === null ? "null" : Array.isArray(v) ? "an array" : typeof v);
|
|
295
|
+
function nonEmptyArg(port, member, v) {
|
|
296
|
+
if (nonEmptyString(v))
|
|
297
|
+
return v;
|
|
298
|
+
throw invalidArgument(`MaterializedMcp.${port}: ${member} must be a non-empty string (got ${typeof v === "string" ? "an empty string" : kindOf(v)})`);
|
|
299
|
+
}
|
|
300
|
+
function signalArg(port, v) {
|
|
301
|
+
if (v === undefined || v instanceof AbortSignal)
|
|
302
|
+
return v;
|
|
303
|
+
throw invalidArgument(`MaterializedMcp.${port}: signal must be an AbortSignal when given (got ${kindOf(v)})`);
|
|
304
|
+
}
|
|
305
|
+
function promptArgs(v) {
|
|
306
|
+
if (v === undefined)
|
|
307
|
+
return undefined;
|
|
308
|
+
if (types.isProxy(v) || !isPlainRecord(v))
|
|
309
|
+
throw invalidArgument(`MaterializedMcp.getPrompt: args must be a plain record of strings (got ${kindOf(v)})`);
|
|
310
|
+
const strings = [];
|
|
311
|
+
for (const [key, value] of Object.entries(v)) {
|
|
312
|
+
if (typeof value !== "string")
|
|
313
|
+
throw invalidArgument(`MaterializedMcp.getPrompt: args.${callerText(key)} must be a string (got ${kindOf(value)}) — a prompt argument is never sent in another form`);
|
|
314
|
+
strings.push([key, value]);
|
|
315
|
+
}
|
|
316
|
+
return Object.fromEntries(strings);
|
|
317
|
+
}
|
|
318
|
+
export function mcpHostReadPorts(seat) {
|
|
319
|
+
const refused = (server, reason, fields = {}) => ({ server, outcome: "refused", reason, ...fields });
|
|
320
|
+
const revokedAnswer = (server, route, refusal) => refused(server, "the server is revoked by the operator — the request was not sent", failureFields(readMcpFailure(refusal, requestSite(route.client)).failure));
|
|
321
|
+
const open = (server, face) => {
|
|
322
|
+
const spec = seat.declaration(server);
|
|
323
|
+
if (spec === undefined)
|
|
324
|
+
return { answer: { server, outcome: "not_declared", reason: `no MCP server named ${callerText(server)} is declared for this materialization` } };
|
|
325
|
+
const stopped = seat.stopped();
|
|
326
|
+
if (stopped !== undefined)
|
|
327
|
+
return { answer: refused(server, `${stopped} — nothing was read`) };
|
|
328
|
+
const route = seat.route(server);
|
|
329
|
+
if (route === undefined)
|
|
330
|
+
return { answer: refused(server, "this materialization holds no connection to the server (it was not dialed, or its dial failed — its status record says which); a read port never dials") };
|
|
331
|
+
if (route.health.dead)
|
|
332
|
+
return { answer: refused(server, "the server is disconnected (its transport closed earlier in this task) — the read was not attempted", { errorCode: "connection_closed", delivered: "no" }) };
|
|
333
|
+
const revoked = seat.revoked(spec);
|
|
334
|
+
if (revoked !== undefined)
|
|
335
|
+
return { answer: revokedAnswer(server, route, revoked) };
|
|
336
|
+
if (!faceAllowed(spec.allowTools, face))
|
|
337
|
+
return { answer: refused(server, `the server's allowTools list does not name "${face}", so that read is closed for this server`) };
|
|
338
|
+
return { route };
|
|
339
|
+
};
|
|
340
|
+
const served = (route, capability) => Boolean(route.client.getServerCapabilities()?.[capability]);
|
|
341
|
+
const run = async (server, route, signal, read) => {
|
|
342
|
+
const idleMs = seat.deps.idleMs(route.transportKind);
|
|
343
|
+
const watch = armMcpIdleWatchdog(route.health, idleMs, signal);
|
|
344
|
+
const site = requestSite(route.client);
|
|
345
|
+
let value;
|
|
346
|
+
try {
|
|
347
|
+
value = await read(watch, idleMs);
|
|
348
|
+
}
|
|
349
|
+
catch (err) {
|
|
350
|
+
if (err instanceof ProtocolRevokedRefusal)
|
|
351
|
+
return revokedAnswer(server, route, err);
|
|
352
|
+
if (signal?.aborted === true)
|
|
353
|
+
throw signal.reason;
|
|
354
|
+
if (watch.idleSignal.reason === IDLE_WATCHDOG_ABORT_REASON) {
|
|
355
|
+
route.health.observe?.("timeout");
|
|
356
|
+
return refused(server, deps().idleTripText(idleMs), { errorCode: "timeout", delivered: "unknown" });
|
|
357
|
+
}
|
|
358
|
+
const failure = observedFailure(err, site, route.health, true);
|
|
359
|
+
return refused(server, inlineUntrusted(namingLostSession(err, site, deps().failureText(err, route.declared)), 240), failureFields(failure));
|
|
360
|
+
}
|
|
361
|
+
finally {
|
|
362
|
+
watch.dispose();
|
|
363
|
+
}
|
|
364
|
+
if (seat.route(server) !== route)
|
|
365
|
+
return refused(server, "the server was re-dialed while this read was in the air — what it read came from the connection the re-dial replaced, so it was discarded");
|
|
366
|
+
return { server, outcome: "read", ...value };
|
|
367
|
+
};
|
|
368
|
+
const deps = () => seat.deps;
|
|
369
|
+
const listing = async (port, serverArg, signalArgument, kind, face, capability) => {
|
|
370
|
+
const server = nonEmptyArg(port, "server", serverArg);
|
|
371
|
+
const signal = signalArg(port, signalArgument);
|
|
372
|
+
const opened = open(server, face);
|
|
373
|
+
if ("answer" in opened)
|
|
374
|
+
return opened.answer;
|
|
375
|
+
if (!served(opened.route, capability))
|
|
376
|
+
return { server, outcome: "read", entries: [] };
|
|
377
|
+
return run(server, opened.route, signal, async (watch, idleMs) => {
|
|
378
|
+
const read = await readMcpListing(opened.route, kind, watch, idleMs, signal, deps());
|
|
379
|
+
const incomplete = read.incomplete;
|
|
380
|
+
const error = incomplete?.error;
|
|
381
|
+
return { entries: read.entries, ...(read.dropped > 0 ? { dropped: read.dropped } : {}), ...(incomplete !== undefined ? { listingIncomplete: error !== undefined ? { ...incomplete, error: inlineUntrusted(error, 240) } : incomplete } : {}) };
|
|
382
|
+
});
|
|
383
|
+
};
|
|
384
|
+
const fetchPort = async (port, server, signal, face, capability, read) => {
|
|
385
|
+
const opened = open(server, face);
|
|
386
|
+
if ("answer" in opened)
|
|
387
|
+
return opened.answer;
|
|
388
|
+
if (!served(opened.route, capability))
|
|
389
|
+
return refused(server, `the server declared no ${capability} capability, so ${port} sent it nothing`);
|
|
390
|
+
return run(server, opened.route, signal, (watch) => read(opened.route, watch));
|
|
391
|
+
};
|
|
392
|
+
return {
|
|
393
|
+
listPrompts: async (server, signal) => {
|
|
394
|
+
const answer = await listing("listPrompts", server, signal, "prompts", MCP_PROMPT_LIST_ALLOW, "prompts");
|
|
395
|
+
if (answer.outcome !== "read")
|
|
396
|
+
return answer;
|
|
397
|
+
const { entries, ...read } = answer;
|
|
398
|
+
return { ...read, prompts: entries };
|
|
399
|
+
},
|
|
400
|
+
listResources: async (server, signal) => {
|
|
401
|
+
const answer = await listing("listResources", server, signal, "resources", MCP_RESOURCE_LIST_ALLOW, "resources");
|
|
402
|
+
if (answer.outcome !== "read")
|
|
403
|
+
return answer;
|
|
404
|
+
const { entries, ...read } = answer;
|
|
405
|
+
return { ...read, resources: entries };
|
|
406
|
+
},
|
|
407
|
+
listResourceTemplates: async (server, signal) => {
|
|
408
|
+
const answer = await listing("listResourceTemplates", server, signal, "resourceTemplates", MCP_RESOURCE_TEMPLATE_LIST_ALLOW, "resources");
|
|
409
|
+
if (answer.outcome !== "read")
|
|
410
|
+
return answer;
|
|
411
|
+
const { entries, ...read } = answer;
|
|
412
|
+
return { ...read, resourceTemplates: entries };
|
|
413
|
+
},
|
|
414
|
+
getPrompt: async (serverArg, nameArg, argsArg, signalArgument) => {
|
|
415
|
+
const server = nonEmptyArg("getPrompt", "server", serverArg);
|
|
416
|
+
const name = nonEmptyArg("getPrompt", "name", nameArg);
|
|
417
|
+
const args = promptArgs(argsArg);
|
|
418
|
+
const signal = signalArg("getPrompt", signalArgument);
|
|
419
|
+
return fetchPort("getPrompt", server, signal, MCP_PROMPT_GET_ALLOW, "prompts", async (route, watch) => promptAnswerOf(await fetchMcpAnswer(route, "prompts/get", { name, ...(args !== undefined ? { arguments: args } : {}) }, watch, deps().timeoutMs()), deps().keep));
|
|
420
|
+
},
|
|
421
|
+
readResource: async (serverArg, uriArg, signalArgument) => {
|
|
422
|
+
const server = nonEmptyArg("readResource", "server", serverArg);
|
|
423
|
+
const uri = nonEmptyArg("readResource", "uri", uriArg);
|
|
424
|
+
const signal = signalArg("readResource", signalArgument);
|
|
425
|
+
return fetchPort("readResource", server, signal, MCP_RESOURCE_READ_ALLOW, "resources", async (route, watch) => resourceContentsOf(await fetchMcpAnswer(route, "resources/read", { uri }, watch, deps().timeoutMs()), deps().keep));
|
|
426
|
+
},
|
|
427
|
+
};
|
|
428
|
+
}
|
|
@@ -14,6 +14,8 @@
|
|
|
14
14
|
*/
|
|
15
15
|
import type { Client, Tool } from "@modelcontextprotocol/client";
|
|
16
16
|
import { type McpAuthorization, type McpExchangeOutcome, type McpFailure, type McpFailureSite } from "./mcp-failure.js";
|
|
17
|
+
import { type ToolAxesSurface } from "./mcp-server-spec.js";
|
|
18
|
+
import { type ProtocolRevokedRefusal } from "./protocol-revocation.js";
|
|
17
19
|
/**
|
|
18
20
|
* One request failure, read once and told to the server's two writers: its reach ({@link ServerHealth.observe}) always, and — when
|
|
19
21
|
* `answer` (this failure is the request's answer: the lane sends nothing again) — the authorization the user owes
|
|
@@ -180,15 +182,35 @@ export declare class Resendable {
|
|
|
180
182
|
* {@link McpListingRefusal} answer only a call that was never sent.
|
|
181
183
|
*/
|
|
182
184
|
export declare function callThroughLink<R extends object>(link: McpServerLink, name: string, gate: string, signal: AbortSignal | undefined, send: (on: McpLiveConnection, resent: boolean) => Promise<R | Resendable>, gone: () => never): Promise<R | McpListingRefusal>;
|
|
183
|
-
/** What judges a call a refusal turned away: the live connection's listing, the operator's revocation list, the declaration a tool was mounted with. */
|
|
184
|
-
export type RefusalJudge = "listing" | "revocation" | "declaration";
|
|
185
|
+
/** What judges a call a refusal turned away: the live connection's listing, the operator's revocation list, the declaration a tool was mounted with, the connection itself (a transport that closed or an endpoint that did not answer). */
|
|
186
|
+
export type RefusalJudge = "listing" | "revocation" | "declaration" | "connection";
|
|
185
187
|
/**
|
|
186
|
-
* THE closing sentence of
|
|
188
|
+
* THE closing sentence of a protocol call refused before it was sent: what the refusal covers (this call) and what judges a later call,
|
|
187
189
|
* never how that call will come out — a host's re-dial, refresh or un-revoke lands between two calls, and the call after it is
|
|
188
|
-
* judged against what it took. The listing's refusal, a revoked server's
|
|
189
|
-
*
|
|
190
|
+
* judged against what it took. The listing's refusal, a revoked server's or peer's outlets ({@link revokedCallResult}), the
|
|
191
|
+
* task-required one and a server's gone or unreachable connection end with it; no site words it again.
|
|
190
192
|
*/
|
|
191
|
-
export declare function refusalScope(judge: RefusalJudge): string;
|
|
193
|
+
export declare function refusalScope(judge: RefusalJudge, at: ToolAxesSurface): string;
|
|
194
|
+
/**
|
|
195
|
+
* THE answer of a call whose request the revocation ledger stopped at the request exit ({@link ProtocolRevokedRefusal}) — one writer for
|
|
196
|
+
* both protocols and every outlet (a tool call, a resource read, a directory listing, an A2A skill call): the refusal record
|
|
197
|
+
* (`isError`; `code` beside `error` — the wire's errorCode lift reads `details.code`; `delivered`, the refusal's own: `no`, or `unknown`
|
|
198
|
+
* for a redirect stopped after the request's first hop was sent; the server or peer). The A2A outlet adds its own card (the A2A card,
|
|
199
|
+
* minted in a2a.ts only). `what` names the call (already neutralized by the caller). `accepted` is an A2A task the peer took on before a later status request was stopped: that
|
|
200
|
+
* call was delivered (`delivered: "yes"`), its outcome is unknown, and no continuation is offered — calling the tool again would send the
|
|
201
|
+
* peer a new message, not ask about the task.
|
|
202
|
+
*/
|
|
203
|
+
export declare function revokedCallResult(refusal: ProtocolRevokedRefusal, what: string, accepted?: {
|
|
204
|
+
readonly taskId: string | undefined;
|
|
205
|
+
}): {
|
|
206
|
+
content: Array<{
|
|
207
|
+
type: "text";
|
|
208
|
+
text: string;
|
|
209
|
+
}>;
|
|
210
|
+
details: Record<string, string>;
|
|
211
|
+
terminate: false;
|
|
212
|
+
isError: true;
|
|
213
|
+
};
|
|
192
214
|
/** The answer to a call {@link reach} refused before it was sent: the pre-send refusal record (`delivered: "no"`; `code` beside `error`, as the revocation refusal's). */
|
|
193
215
|
export declare function listingRefusal(refusal: McpListingRefusal, remoteName: string, server: string): {
|
|
194
216
|
content: Array<{
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
import { readMcpFailure } from "./mcp-failure.js";
|
|
2
2
|
import { UNPROVEN_GATE } from "./mcp-listing-drift.js";
|
|
3
|
+
import { resendUndelivered } from "./peer-seat.js";
|
|
4
|
+
import { declarerWord } from "./mcp-server-spec.js";
|
|
5
|
+
import { revocationTargetName } from "./protocol-revocation.js";
|
|
3
6
|
import { readMember } from "./thrown-value.js";
|
|
4
7
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
5
8
|
export function observedFailure(err, site, health, answer) {
|
|
@@ -101,20 +104,45 @@ export async function callThroughLink(link, name, gate, signal, send, gone) {
|
|
|
101
104
|
const next = reach(link, name, gate);
|
|
102
105
|
if (typeof next === "string" || next === res.on)
|
|
103
106
|
throw res.error;
|
|
104
|
-
const again = await send(next, true)
|
|
107
|
+
const again = await send(next, true).catch((err) => {
|
|
108
|
+
throw resendUndelivered(err) ? res.error : err;
|
|
109
|
+
});
|
|
105
110
|
if (again instanceof Resendable)
|
|
106
111
|
throw again.error;
|
|
107
112
|
return again;
|
|
108
113
|
}
|
|
109
114
|
const REFUSAL_JUDGES = {
|
|
110
|
-
listing: { rule: "each later call to this tool is checked again against the connection's latest listing", standing: "" },
|
|
111
|
-
revocation: { rule:
|
|
112
|
-
declaration: { rule: "each later call to this tool is judged by the declaration of the listing it was mounted from, until a refresh or reconnect of the server mints the tool anew", standing: "" },
|
|
115
|
+
listing: () => ({ rule: "each later call to this tool is checked again against the connection's latest listing", standing: "" }),
|
|
116
|
+
revocation: (declarer) => ({ rule: `each later call to this ${declarer} is checked again against the operator's current revocation list`, standing: `This ${declarer} stays on this run's tool roster. ` }),
|
|
117
|
+
declaration: () => ({ rule: "each later call to this tool is judged by the declaration of the listing it was mounted from, until a refresh or reconnect of the server mints the tool anew", standing: "" }),
|
|
118
|
+
connection: (declarer) => ({ rule: `each later call to this ${declarer} is checked again against its connection at that time`, standing: "" }),
|
|
113
119
|
};
|
|
114
|
-
export function refusalScope(judge) {
|
|
115
|
-
const j = REFUSAL_JUDGES[judge];
|
|
120
|
+
export function refusalScope(judge, at) {
|
|
121
|
+
const j = REFUSAL_JUDGES[judge](declarerWord(at));
|
|
116
122
|
return `${j.standing}This refusal is for this call only: ${j.rule}.`;
|
|
117
123
|
}
|
|
124
|
+
export function revokedCallResult(refusal, what, accepted) {
|
|
125
|
+
const { target, code } = refusal;
|
|
126
|
+
const declarer = declarerWord(target.protocol);
|
|
127
|
+
const name = inlineUntrusted(revocationTargetName(target), 120);
|
|
128
|
+
const text = accepted !== undefined
|
|
129
|
+
? `${what} stopped: ${declarer} "${name}" was revoked by the operator after it accepted ${accepted.taskId !== undefined ? `task ${accepted.taskId}` : "the task"}. No further status request is sent, so the task's outcome is UNKNOWN — it may still complete on the peer's side, and only the operator can check it there.`
|
|
130
|
+
: `${refusal.afterSentHop
|
|
131
|
+
? `${what} stopped: ${declarer} "${name}" was revoked by the operator while the request was being redirected. Its first hop was sent and the redirect was NOT followed, so whether the ${declarer} acted on it is UNKNOWN — only the operator can check it on the ${declarer}'s side.`
|
|
132
|
+
: `${what} was refused: ${declarer} "${name}" was revoked by the operator. The request was NOT sent, so the ${declarer} did not act on it.`} ${refusalScope("revocation", target.protocol)}`;
|
|
133
|
+
return {
|
|
134
|
+
content: [{ type: "text", text }],
|
|
135
|
+
details: {
|
|
136
|
+
error: code,
|
|
137
|
+
code,
|
|
138
|
+
delivered: accepted !== undefined ? "yes" : refusal.details.delivered,
|
|
139
|
+
...(target.protocol === "mcp" ? { server: target.server } : { peer: target.peer }),
|
|
140
|
+
...(accepted?.taskId !== undefined ? { taskId: accepted.taskId } : {}),
|
|
141
|
+
},
|
|
142
|
+
terminate: false,
|
|
143
|
+
isError: true,
|
|
144
|
+
};
|
|
145
|
+
}
|
|
118
146
|
const LISTING_REFUSAL_CODES = {
|
|
119
147
|
changed: "mcp.tool_declaration_changed",
|
|
120
148
|
unreached: "mcp.tool_listing_unreached",
|
|
@@ -130,7 +158,7 @@ export function listingRefusal(refusal, remoteName, server) {
|
|
|
130
158
|
? "no longer declares this tool the way it was mounted (its safety declaration changed, or a complete listing no longer lists it)"
|
|
131
159
|
: refusal === "unreached"
|
|
132
160
|
? "has not listed this tool since it was reconnected (the re-listing stopped before it reached the tool), so whether the server still declares it the way it was mounted is unknown"
|
|
133
|
-
: "lists this tool with an output schema this client cannot compile, so its structured result could not be checked"}. The server did not execute it. ${refusalScope("listing")}`,
|
|
161
|
+
: "lists this tool with an output schema this client cannot compile, so its structured result could not be checked"}. The server did not execute it. ${refusalScope("listing", "mcp")}`,
|
|
134
162
|
},
|
|
135
163
|
],
|
|
136
164
|
details: { error: code, code, delivered: "no", server },
|