@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/core/mcp-failure.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { ProtocolError, SdkError, SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
|
|
2
2
|
import { proxyTunnelRefusedSentence, readConnectFailure } from "../brain/errors.js";
|
|
3
3
|
import { PeerAuthorizationRefused, PeerSeatFailure } from "./peer-seat.js";
|
|
4
|
+
import { ProtocolRevokedRefusal } from "./protocol-revocation.js";
|
|
4
5
|
import { hostSeatVerdictOf } from "./mcp-host-seat.js";
|
|
5
6
|
export const MCP_FAILURE_KINDS = Object.freeze([
|
|
6
7
|
"connect_refused",
|
|
@@ -15,6 +16,7 @@ export const MCP_FAILURE_KINDS = Object.freeze([
|
|
|
15
16
|
"invalid_config",
|
|
16
17
|
"credential_unavailable",
|
|
17
18
|
"host_refused",
|
|
19
|
+
"revoked",
|
|
18
20
|
"unknown",
|
|
19
21
|
]);
|
|
20
22
|
export const MCP_AUTHORIZATION_REASONS = Object.freeze(["rejected", "scope", "none"]);
|
|
@@ -32,6 +34,7 @@ export const DELIVERED_BY_KIND = {
|
|
|
32
34
|
invalid_config: "no",
|
|
33
35
|
credential_unavailable: "no",
|
|
34
36
|
host_refused: "no",
|
|
37
|
+
revoked: "unknown",
|
|
35
38
|
unknown: "unknown",
|
|
36
39
|
};
|
|
37
40
|
export const MCP_LIVENESS_STATES = Object.freeze(["reachable", "unreachable", "unknown"]);
|
|
@@ -48,6 +51,7 @@ export const LIVENESS_BY_FAILURE_KIND = {
|
|
|
48
51
|
invalid_config: undefined,
|
|
49
52
|
credential_unavailable: undefined,
|
|
50
53
|
host_refused: undefined,
|
|
54
|
+
revoked: undefined,
|
|
51
55
|
unknown: "unknown",
|
|
52
56
|
};
|
|
53
57
|
export function livenessOf(outcome, observedAt) {
|
|
@@ -135,6 +139,11 @@ function sdkErrorClass(err) {
|
|
|
135
139
|
return { kind: reading.kind, ...(reading.unsent === true ? { unsent: true } : {}) };
|
|
136
140
|
}
|
|
137
141
|
export const FAILURE_CLASSIFIER = [
|
|
142
|
+
{
|
|
143
|
+
name: "revocation ledger withdrew the declaration",
|
|
144
|
+
when: (err) => err instanceof ProtocolRevokedRefusal,
|
|
145
|
+
reads: (err) => ({ kind: "revoked", ...(err.afterSentHop ? {} : { unsent: true }) }),
|
|
146
|
+
},
|
|
138
147
|
{
|
|
139
148
|
name: "peer seat answered the principal is not authorized",
|
|
140
149
|
when: (err) => err instanceof PeerSeatFailure && err.reason === "unauthorized",
|
|
@@ -285,6 +294,7 @@ export function describeHttpTransportFailure(err, at = { phase: "request" }) {
|
|
|
285
294
|
case "invalid_config":
|
|
286
295
|
case "credential_unavailable":
|
|
287
296
|
case "host_refused":
|
|
297
|
+
case "revoked":
|
|
288
298
|
case "unknown":
|
|
289
299
|
return undefined;
|
|
290
300
|
}
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The host's read ports onto one connected MCP server — its prompts and its resources — and the ONE reader each of those methods has in
|
|
3
|
+
* the engine. The model's resource tools (mcp.ts `buildResourceTools`) and the host's ports below call the same readers over the same
|
|
4
|
+
* route: the same door (the revocation ledger asked as the request leaves), the same `_meta`, the same per-call timeout, the same idle
|
|
5
|
+
* watchdog, the same liveness writer and the same lenient page read. What differs is only the rendering: the model's tools fence what
|
|
6
|
+
* they read into a tool result; the host's ports hand back core's own projection of it.
|
|
7
|
+
*
|
|
8
|
+
* THE PROJECTION. A port never hands out an SDK type or a server's `_meta`: every listed entry, prompt message and resource content is
|
|
9
|
+
* read member by member into a closed shape of core's own, and an element that does not fit — a member of the wrong kind, an unknown
|
|
10
|
+
* content type, a role outside `user` / `assistant`, text and a blob both present or both absent — is dropped and COUNTED (`dropped`).
|
|
11
|
+
* Every string member is one of two kinds. A NAME the host hands back to the server (a prompt's and its arguments', a resource's uri and
|
|
12
|
+
* name, a template's) is kept verbatim, and on a listing one holding a credential the connection's requests carried refuses its entry.
|
|
13
|
+
* Everything else — a title, a description, a mime type, a page failure's words — is DISPLAY text: erased in place on a listing
|
|
14
|
+
* (credential-echo.ts, sites `prompt_listing` / `resource_listing`) and neutralized everywhere (`sanitizeUntrustedText`; a failure's words
|
|
15
|
+
* inlined as the refusal's are); a prompt's text goes into a model turn only through {@link renderMcpPromptForModel}, which fences it. A text block is cut at the remote result bound
|
|
16
|
+
* ({@link MCP_REMOTE_RESULT_MAX_CHARS}, `truncated: true`); a binary block is never inlined — its bytes go to the one byte keeper a
|
|
17
|
+
* tool result's bytes go to (the run's tool-result store, `McpReadDeps.keep`) and come back as `kept` ({@link KeptBytes}: the ref they
|
|
18
|
+
* are kept under, or why they are not).
|
|
19
|
+
*
|
|
20
|
+
* THE ANSWER. Every port answers {@link McpHostRead}: `read`, `refused` (with the failure record's fields, spread flat, exactly when the one
|
|
21
|
+
* classifier read the failure), or `not_declared`. The judgment runs in one order, the first row that holds answers: no declaration ⇒
|
|
22
|
+
* `not_declared`; the materialization stopped ⇒ `refused`; no live connection (never dialed, its dial failed) ⇒ `refused` (a port never
|
|
23
|
+
* dials); the transport already closed ⇒ `refused` (`connection_closed` / `no`); the ledger revoked the server ⇒ `refused` (`revoked` /
|
|
24
|
+
* `no`), asked before anything else is judged; the server's `allowTools` list does not name the port's face word ⇒ `refused`; the server
|
|
25
|
+
* declared no capability for it ⇒ a listing reads `[]` and a fetch is `refused`, nothing sent; a first listing page answered
|
|
26
|
+
* `MethodNotFound` ⇒ `[]` (a tool listing is NOT judged by this rule: its failure still fails the server's dial); any other failure ⇒
|
|
27
|
+
* `refused` with the classifier's reading; a continuation page that failed (or the walk's other stops) ⇒ `read` with what was read and
|
|
28
|
+
* `listingIncomplete`; and a read whose server was re-dialed while it was in the air ⇒ `refused` (what it read came from the replaced
|
|
29
|
+
* connection). A caller's abort rejects with the signal's own reason; a malformed argument throws `config.invalid_argument`.
|
|
30
|
+
*/
|
|
31
|
+
import { type Client } from "@modelcontextprotocol/client";
|
|
32
|
+
import { type CredentialEcho } from "./credential-echo.js";
|
|
33
|
+
import { type McpFailureFields } from "./mcp-failure.js";
|
|
34
|
+
import { type ServerHealth } from "./mcp-server-link.js";
|
|
35
|
+
import { ProtocolRevokedRefusal } from "./protocol-revocation.js";
|
|
36
|
+
import { type KeptBytes, type ToolResultBytesKeeper } from "./tool-result-bytes.js";
|
|
37
|
+
import type { McpListingIncomplete, listEntryFingerprint, walkMcpListPages } from "./mcp.js";
|
|
38
|
+
import type { McpServerSpec } from "./mcp-server-spec.js";
|
|
39
|
+
/** One prompt a server lists (`prompts/list`), as core projects it. */
|
|
40
|
+
export interface McpPromptEntry {
|
|
41
|
+
name: string;
|
|
42
|
+
title?: string;
|
|
43
|
+
description?: string;
|
|
44
|
+
arguments?: Array<{
|
|
45
|
+
name: string;
|
|
46
|
+
title?: string;
|
|
47
|
+
description?: string;
|
|
48
|
+
required?: boolean;
|
|
49
|
+
}>;
|
|
50
|
+
}
|
|
51
|
+
/** One resource a server lists (`resources/list`), as core projects it. */
|
|
52
|
+
export interface McpResourceEntry {
|
|
53
|
+
uri: string;
|
|
54
|
+
name: string;
|
|
55
|
+
title?: string;
|
|
56
|
+
description?: string;
|
|
57
|
+
mimeType?: string;
|
|
58
|
+
size?: number;
|
|
59
|
+
}
|
|
60
|
+
/** One resource template a server lists (`resources/templates/list`), as core projects it. */
|
|
61
|
+
export interface McpResourceTemplateEntry {
|
|
62
|
+
uriTemplate: string;
|
|
63
|
+
name: string;
|
|
64
|
+
title?: string;
|
|
65
|
+
description?: string;
|
|
66
|
+
mimeType?: string;
|
|
67
|
+
}
|
|
68
|
+
/** One content block of a prompt message, as core projects it: text (cut at the remote result bound), a binary block as its kept
|
|
69
|
+
* bytes, an embedded resource (its text, or its blob's kept bytes), or a link to a resource. */
|
|
70
|
+
export type McpContentBlock = {
|
|
71
|
+
type: "text";
|
|
72
|
+
text: string;
|
|
73
|
+
truncated?: true;
|
|
74
|
+
} | {
|
|
75
|
+
type: "image" | "audio";
|
|
76
|
+
mimeType: string;
|
|
77
|
+
kept: KeptBytes;
|
|
78
|
+
} | {
|
|
79
|
+
type: "resource";
|
|
80
|
+
resource: {
|
|
81
|
+
uri: string;
|
|
82
|
+
mimeType?: string;
|
|
83
|
+
text: string;
|
|
84
|
+
truncated?: true;
|
|
85
|
+
} | {
|
|
86
|
+
uri: string;
|
|
87
|
+
mimeType?: string;
|
|
88
|
+
kept: KeptBytes;
|
|
89
|
+
};
|
|
90
|
+
} | {
|
|
91
|
+
type: "resource_link";
|
|
92
|
+
uri: string;
|
|
93
|
+
name: string;
|
|
94
|
+
title?: string;
|
|
95
|
+
description?: string;
|
|
96
|
+
mimeType?: string;
|
|
97
|
+
};
|
|
98
|
+
/** A prompt as a server answers `prompts/get`, projected. The text in it is for DISPLAY; into a model turn it goes through {@link renderMcpPromptForModel}. */
|
|
99
|
+
export interface McpPromptAnswer {
|
|
100
|
+
description?: string;
|
|
101
|
+
messages: Array<{
|
|
102
|
+
role: "user" | "assistant";
|
|
103
|
+
content: McpContentBlock;
|
|
104
|
+
}>;
|
|
105
|
+
}
|
|
106
|
+
/** A resource as a server answers `resources/read`, projected. */
|
|
107
|
+
export interface McpResourceContents {
|
|
108
|
+
contents: Array<{
|
|
109
|
+
uri: string;
|
|
110
|
+
mimeType?: string;
|
|
111
|
+
text: string;
|
|
112
|
+
truncated?: true;
|
|
113
|
+
} | {
|
|
114
|
+
uri: string;
|
|
115
|
+
mimeType?: string;
|
|
116
|
+
kept: KeptBytes;
|
|
117
|
+
}>;
|
|
118
|
+
}
|
|
119
|
+
type McpHostRefused = {
|
|
120
|
+
server: string;
|
|
121
|
+
outcome: "refused";
|
|
122
|
+
reason: string;
|
|
123
|
+
} & Partial<McpFailureFields>;
|
|
124
|
+
type McpHostNotDeclared = {
|
|
125
|
+
server: string;
|
|
126
|
+
outcome: "not_declared";
|
|
127
|
+
reason: string;
|
|
128
|
+
};
|
|
129
|
+
/**
|
|
130
|
+
* What a host read port answers — three words, the shape `McpReconnectResult.outcome` already taught every consumer: `read` (the
|
|
131
|
+
* projection, `dropped` when elements were dropped, `listingIncomplete` when a listing's walk did not reach its end), `refused` (`reason`,
|
|
132
|
+
* plus the failure record's fields spread flat when — and only when — the one classifier read the failure), `not_declared`.
|
|
133
|
+
*/
|
|
134
|
+
export type McpHostRead<T> = ({
|
|
135
|
+
server: string;
|
|
136
|
+
outcome: "read";
|
|
137
|
+
dropped?: number;
|
|
138
|
+
listingIncomplete?: McpListingIncomplete;
|
|
139
|
+
} & T) | McpHostRefused | McpHostNotDeclared;
|
|
140
|
+
/**
|
|
141
|
+
* The host's five read ports on a materialization (`MaterializedMcp` carries them). Each reads ONE named server over the connection this
|
|
142
|
+
* materialization already holds — it never dials and never re-dials — and judges in the order the module note gives. The faces they
|
|
143
|
+
* open are the server's `allowTools` face words (mounted-mcp.ts): `list_prompts`, `get_prompt`, `list_resources`,
|
|
144
|
+
* `list_resource_templates`, `read_resource`. A host reading several servers may call them concurrently; each spends at most the
|
|
145
|
+
* per-call MCP timeout, bounded further by `signal`.
|
|
146
|
+
*/
|
|
147
|
+
export interface McpHostReadPorts {
|
|
148
|
+
listPrompts(server: string, signal?: AbortSignal): Promise<McpHostRead<{
|
|
149
|
+
prompts: McpPromptEntry[];
|
|
150
|
+
}>>;
|
|
151
|
+
/** `args` is a plain record of strings (the prompt's arguments as the server declared them); a required argument left out is the
|
|
152
|
+
* server's to refuse (its `-32602` answers `refused`, `protocol` / `yes`). The answer's text is for display — a host puts the prompt
|
|
153
|
+
* into a model turn ONLY through {@link renderMcpPromptForModel}. */
|
|
154
|
+
getPrompt(server: string, name: string, args?: Readonly<Record<string, string>>, signal?: AbortSignal): Promise<McpHostRead<McpPromptAnswer>>;
|
|
155
|
+
listResources(server: string, signal?: AbortSignal): Promise<McpHostRead<{
|
|
156
|
+
resources: McpResourceEntry[];
|
|
157
|
+
}>>;
|
|
158
|
+
listResourceTemplates(server: string, signal?: AbortSignal): Promise<McpHostRead<{
|
|
159
|
+
resourceTemplates: McpResourceTemplateEntry[];
|
|
160
|
+
}>>;
|
|
161
|
+
readResource(server: string, uri: string, signal?: AbortSignal): Promise<McpHostRead<McpResourceContents>>;
|
|
162
|
+
}
|
|
163
|
+
/** The request door of a connection ({@link McpReadRoute.through}): every request leaves through it, the revocation ledger asked as it does. */
|
|
164
|
+
export type McpRequestDoor = <T>(send: () => Promise<T>) => Promise<T>;
|
|
165
|
+
/** One connected server as its reads reach it — minted once per connection, where the dial took it, and read by every face. */
|
|
166
|
+
export interface McpReadRoute {
|
|
167
|
+
readonly server: string;
|
|
168
|
+
readonly client: Client;
|
|
169
|
+
/** The leg's door to this server: every request leaves through it. */
|
|
170
|
+
readonly through: McpRequestDoor;
|
|
171
|
+
/** Liveness flag flipped by the transport-close hook, and the liveness writer each exchange reports to. */
|
|
172
|
+
readonly health: ServerHealth;
|
|
173
|
+
/** Which idle-watchdog default applies: list, read and fetch carry no progress channel, so the watchdog is their only bound below the per-call timeout. */
|
|
174
|
+
readonly transportKind: "stdio" | "http";
|
|
175
|
+
/** The header values this server's requests carry: its failure texts are read without them. */
|
|
176
|
+
readonly declared: readonly string[];
|
|
177
|
+
/** The `_meta` a fetch (`resources/read`, `prompts/get`) carries — the one mint's: the leg's session id under the declared key, or none. */
|
|
178
|
+
readonly meta: () => Record<string, unknown> | undefined;
|
|
179
|
+
/** How this connection's account of itself is read: without its credentials, a site that held one announced. */
|
|
180
|
+
readonly echo: CredentialEcho;
|
|
181
|
+
}
|
|
182
|
+
/** What the readers take from the module that owns the connections (mcp.ts) — passed in, so this module never imports it back. */
|
|
183
|
+
export interface McpReadDeps {
|
|
184
|
+
readonly walk: typeof walkMcpListPages;
|
|
185
|
+
readonly fingerprint: typeof listEntryFingerprint;
|
|
186
|
+
/** The byte keeper a binary block's decoded bytes go to — the one a tool result's bytes go to (the run's tool-result store); absent ⇒
|
|
187
|
+
* nothing is kept (`notKept: "no_byte_store"`). */
|
|
188
|
+
readonly keep?: ToolResultBytesKeeper;
|
|
189
|
+
readonly timeoutMs: () => number;
|
|
190
|
+
readonly idleMs: (kind: "stdio" | "http") => number;
|
|
191
|
+
readonly idleTripText: (idleMs: number) => string;
|
|
192
|
+
/** A failure's text as every MCP face mints it: the remote's words without the request's credentials, a protocol-range condition named. */
|
|
193
|
+
readonly failureText: (err: unknown, declared: readonly string[]) => string;
|
|
194
|
+
}
|
|
195
|
+
/** The idle watchdog a read runs under ({@link armMcpIdleWatchdog}). */
|
|
196
|
+
export interface McpReadWatch {
|
|
197
|
+
readonly combinedSignal: AbortSignal;
|
|
198
|
+
readonly idleSignal: AbortSignal;
|
|
199
|
+
readonly rearm: () => void;
|
|
200
|
+
}
|
|
201
|
+
export declare const MCP_CHARS_PER_TOKEN = 4;
|
|
202
|
+
export declare function mcpMaxOutputTokens(): number;
|
|
203
|
+
/**
|
|
204
|
+
* Did the server answer that it does not serve the method (`MethodNotFound`, `-32601`)? The one reading of that fact: a standard
|
|
205
|
+
* listing of prompts, resources or templates reads it as an empty listing; the directory-read extension as "fall back to the prefix
|
|
206
|
+
* filter". The consequence is the method's, the reading is this one.
|
|
207
|
+
*/
|
|
208
|
+
export declare function notServed(err: unknown): boolean;
|
|
209
|
+
type Raw = Record<string, unknown>;
|
|
210
|
+
/** The three standard listings: the method, the result member that carries the page's entries, and the projection of one entry. */
|
|
211
|
+
interface ListingEntries {
|
|
212
|
+
prompts: McpPromptEntry;
|
|
213
|
+
resources: McpResourceEntry;
|
|
214
|
+
resourceTemplates: McpResourceTemplateEntry;
|
|
215
|
+
}
|
|
216
|
+
export type McpListingKind = keyof ListingEntries;
|
|
217
|
+
/**
|
|
218
|
+
* One answer read as an ENVELOPE only: an object whose `member` is an array (a listing page's `prompts` / `resources` /
|
|
219
|
+
* `resourceTemplates`, a fetch's `messages` / `contents`). Each element is judged afterwards on its own, so one that does not fit costs
|
|
220
|
+
* itself, never the answer — the lenient tool listing's contract. The check runs twice by construction: as the `~standard` result schema
|
|
221
|
+
* the SDK runs inside `request()` (an envelope that does not fit fails the request there, classified like any invalid result), and again
|
|
222
|
+
* where the answer is read ({@link envelopeOf}), which is what reads it.
|
|
223
|
+
*/
|
|
224
|
+
interface Envelope {
|
|
225
|
+
readonly answer: Raw;
|
|
226
|
+
readonly items: readonly unknown[];
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* THE reader of a standard listing (`prompts/list`, `resources/list`, `resources/templates/list`) over one route — the model's resource
|
|
230
|
+
* tools and the host's ports alike. Walked to the end by the one walker (one per-call timeout for the whole walk, its page cap, its cursor
|
|
231
|
+
* guards), each page sent through the door with page one carrying no params (the uncursored request, as the SDK's own list verb spells
|
|
232
|
+
* it) and a continuation the server's cursor alone — through `request()` a page at a time, never that list verb (called without a
|
|
233
|
+
* cursor it walks every page itself and caches the aggregate, so the walk's budget and its truncation disclosure would never see a page)
|
|
234
|
+
* — each page received rearming the watchdog and recorded as a completed exchange, a continuation that failed recorded as the exchange it
|
|
235
|
+
* was (the caller's own abort is none). A first page answered `MethodNotFound` is an empty
|
|
236
|
+
* listing; any other first-page failure, and the door's refusal of any page, is thrown — the caller's face decides what it owes. A page's
|
|
237
|
+
* failure is thrown as it arrived (an idle-watchdog trip as its own sentence), or through `told` when the face tells a failed request in
|
|
238
|
+
* its own words: `told` gets the page's own deadline, so a continuation that times out names the wait that happened, and what it throws is
|
|
239
|
+
* what an incomplete listing then carries. Not asked here: whether the server declared the capability (each face asks that before it reads).
|
|
240
|
+
*/
|
|
241
|
+
export declare function readMcpListing<K extends McpListingKind>(route: McpReadRoute, kind: K, watch: McpReadWatch, idleMs: number, signal: AbortSignal | undefined, deps: McpReadDeps, told?: (err: unknown, remainingMs: number) => never): Promise<{
|
|
242
|
+
entries: Array<ListingEntries[K]>;
|
|
243
|
+
dropped: number;
|
|
244
|
+
incomplete?: McpListingIncomplete;
|
|
245
|
+
}>;
|
|
246
|
+
/** A fetch's answer read as an envelope: the answer itself, and the array its list member carries (`messages`, `contents`). */
|
|
247
|
+
export type McpFetched = Envelope;
|
|
248
|
+
declare const FETCH_MEMBERS: {
|
|
249
|
+
readonly "prompts/get": "messages";
|
|
250
|
+
readonly "resources/read": "contents";
|
|
251
|
+
};
|
|
252
|
+
/** A fetch's params: what the caller names, plus the route's `_meta` when the one mint answers one. */
|
|
253
|
+
export declare function fetchParamsOf(route: McpReadRoute, params: Raw): Raw;
|
|
254
|
+
/**
|
|
255
|
+
* THE reader of a fetch (`resources/read`, `prompts/get`) over one route: one request through the door, under the per-call timeout and
|
|
256
|
+
* the watchdog's signal, recorded as a completed exchange when it answers. The answer is checked as an envelope only (an object whose
|
|
257
|
+
* `contents` / `messages` is an array); a failure is thrown as it arrived.
|
|
258
|
+
*/
|
|
259
|
+
export declare function fetchMcpAnswer(route: McpReadRoute, method: keyof typeof FETCH_MEMBERS, params: Raw, watch: McpReadWatch, timeoutMs: number): Promise<McpFetched>;
|
|
260
|
+
type Keep = ToolResultBytesKeeper | undefined;
|
|
261
|
+
/** A `prompts/get` answer projected: its messages in order (a message whose role is not `user` / `assistant`, or whose block does not fit,
|
|
262
|
+
* dropped and counted), its description when it is a string. Like a tool result, fetched content is not read for the connection's credentials. */
|
|
263
|
+
export declare function promptAnswerOf(fetched: McpFetched, keep: Keep): Promise<McpPromptAnswer & {
|
|
264
|
+
dropped?: number;
|
|
265
|
+
}>;
|
|
266
|
+
/** A `resources/read` answer projected: each content entry's text (cut at the bound) or its blob kept; an entry that does not fit dropped and counted. */
|
|
267
|
+
export declare function resourceContentsOf(fetched: McpFetched, keep: Keep): Promise<McpResourceContents & {
|
|
268
|
+
dropped?: number;
|
|
269
|
+
}>;
|
|
270
|
+
/**
|
|
271
|
+
* THE way a prompt a host fetched ({@link McpHostReadPorts.getPrompt}) goes into a model turn — the instructions' posture (turn-attachments.ts
|
|
272
|
+
* `fenceMcpServerInstructions`): the messages' text, an embedded resource's text and a resource link's line, in order and without roles,
|
|
273
|
+
* inside ONE untrusted fence (which neutralizes the whole authority-envelope family, not only the reminder tag the projection's
|
|
274
|
+
* `sanitizeUntrustedText` defuses), bounded by the MCP result budget ({@link mcpMaxOutputTokens} × {@link MCP_CHARS_PER_TOKEN}) — the bound a
|
|
275
|
+
* tool result has, not the 4096 of a standing system-prompt section. Each cut is said on a trusted line outside the fence: the fence's own,
|
|
276
|
+
* a text block the projection already cut, and the binary blocks (images, audio, blobs) that are not carried into the turn.
|
|
277
|
+
*/
|
|
278
|
+
export declare function renderMcpPromptForModel(server: string, prompt: string, answer: McpPromptAnswer): string;
|
|
279
|
+
/** What the ports read of the materialization that holds the connections. */
|
|
280
|
+
export interface McpHostReadSeat {
|
|
281
|
+
/** The declared entry named `server` (a declaration whose dial was refused included), or `undefined`. */
|
|
282
|
+
readonly declaration: (server: string) => McpServerSpec | undefined;
|
|
283
|
+
/** Why this materialization reads nothing any more (disposed, its run aborted), or `undefined`. */
|
|
284
|
+
readonly stopped: () => string | undefined;
|
|
285
|
+
/** The route of the connection this materialization holds for `server` right now, or `undefined`. */
|
|
286
|
+
readonly route: (server: string) => McpReadRoute | undefined;
|
|
287
|
+
/** The revocation ledger's answer for the declaration, asked now. */
|
|
288
|
+
readonly revoked: (spec: McpServerSpec) => ProtocolRevokedRefusal | undefined;
|
|
289
|
+
readonly deps: McpReadDeps;
|
|
290
|
+
}
|
|
291
|
+
/** The host's five read ports over `seat` — the judgment order of the module note, once, for all five. */
|
|
292
|
+
export declare function mcpHostReadPorts(seat: McpHostReadSeat): McpHostReadPorts;
|
|
293
|
+
export {};
|