@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
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { PROMPT_SCREEN_STATIONS } from "./stations.js";
|
|
2
2
|
import { extensionWords } from "../untrusted-egress.js";
|
|
3
|
+
import { isBlankInput } from "../input-author.js";
|
|
3
4
|
const ARGUMENT = "text";
|
|
4
5
|
export function createPromptSubmitEntry(ref) {
|
|
5
6
|
return async (args, ctx) => {
|
|
@@ -9,7 +10,7 @@ export function createPromptSubmitEntry(ref) {
|
|
|
9
10
|
if (extra !== undefined)
|
|
10
11
|
throw new TypeError(refused(`takes { text }; "${extensionWords(extra, 40)}" is not one`));
|
|
11
12
|
const text = args[ARGUMENT];
|
|
12
|
-
if (typeof text !== "string" || text
|
|
13
|
+
if (typeof text !== "string" || isBlankInput(text))
|
|
13
14
|
throw new TypeError(refused("no { text } (a non-empty string)"));
|
|
14
15
|
const seat = ref?.seat;
|
|
15
16
|
const handlers = ctx.frames.filter((f) => f.kind === "handler");
|
|
@@ -19,6 +20,8 @@ export function createPromptSubmitEntry(ref) {
|
|
|
19
20
|
if (seat === undefined)
|
|
20
21
|
return Object.freeze({ drop: "no running leg takes a prompt here" });
|
|
21
22
|
const answer = await seat.relay("extension", text, { frames: ctx.frames, origin: ctx.origin, extension: by, priority: "later", signal: ctx.signal });
|
|
22
|
-
|
|
23
|
+
if ("entered" in answer)
|
|
24
|
+
return Object.freeze({ text: answer.entered });
|
|
25
|
+
return "replied" in answer ? Object.freeze({ reply: answer.replied }) : Object.freeze({ drop: answer.drop });
|
|
23
26
|
};
|
|
24
27
|
}
|
|
@@ -70,8 +70,8 @@ export declare function doorOf(row: AgentMessage): SessionAppendDoor;
|
|
|
70
70
|
/** `$.session.turns()`: how many prompts a branch holds from its people — its message rows whose door ({@link doorOf}) is
|
|
71
71
|
* `prompt`. A steer is the engine's note on the person's behalf (`provenance: "engine-note"`), so it is not one. */
|
|
72
72
|
export declare function promptCountOf(branch: ReadonlyArray<SessionTreeEntry>): number;
|
|
73
|
-
/** A row's maker, from its typed facts: the model
|
|
74
|
-
* declared), else the engine. */
|
|
73
|
+
/** A row's maker, from its typed facts: the model (or the extension that answered the turn in its place), the tool that
|
|
74
|
+
* answered, the host (a prompt, an attachment the host declared), else the engine. */
|
|
75
75
|
export declare function originOf(row: AgentMessage): SessionAppendOrigin;
|
|
76
76
|
/** What the leg binds the seat to once its bus is admitted. */
|
|
77
77
|
export interface RowSeatBinding {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { answeredWithoutModel } from "../../internal/llm.js";
|
|
1
2
|
import { noteHostRewrite } from "../frame-settlement.js";
|
|
2
3
|
import { describeThrown } from "../tool-policy.js";
|
|
3
4
|
import { extensionWords } from "../untrusted-egress.js";
|
|
@@ -34,7 +35,7 @@ const ENGINE = Object.freeze({ kind: "engine" });
|
|
|
34
35
|
export function originOf(row) {
|
|
35
36
|
switch (row.role) {
|
|
36
37
|
case "assistant":
|
|
37
|
-
return Object.freeze({ kind: "model", model: row.model });
|
|
38
|
+
return answeredWithoutModel(row) ? Object.freeze({ kind: "plugin", name: row.answeredBy }) : Object.freeze({ kind: "model", model: row.model });
|
|
38
39
|
case "toolResult":
|
|
39
40
|
return Object.freeze({ kind: "tool", tool: row.toolName });
|
|
40
41
|
case "user":
|
|
@@ -154,10 +154,10 @@ export function createCompactStation() {
|
|
|
154
154
|
const by = ctx.origin.plugin;
|
|
155
155
|
const w = windows.getStore();
|
|
156
156
|
const direct = ctx.frames.length >= 2 && ctx.frames.at(-1)?.kind === "dollar" && ctx.frames.slice(0, -1).every((f) => f.kind === "handler");
|
|
157
|
+
if (w !== undefined && !w.open)
|
|
158
|
+
return refuseCall(by, "called after the turn.complete dispatch it was made in had ended; the conversation compacts between turns, so call it from turn.complete or later");
|
|
157
159
|
if (w === undefined || !direct)
|
|
158
160
|
return refuseCall(by, "not called from a turn.complete handler; the conversation compacts between turns, so call it from turn.complete or later");
|
|
159
|
-
if (!w.open)
|
|
160
|
-
return refuseCall(by, "called after the turn.complete dispatch it was made in had ended; the conversation compacts between turns, so call it from turn.complete or later");
|
|
161
161
|
if (w.running !== undefined)
|
|
162
162
|
return refuseCall(by, "a compaction is already running at this boundary");
|
|
163
163
|
const running = w.pass({ ...(instructions !== undefined ? { instructions } : {}), requestedBy: Object.freeze({ kind: "extension", name: by }), call: ctx });
|
|
@@ -14,8 +14,9 @@ import { type SourcedOverlay } from "../../prompt-assembly/overlay.js";
|
|
|
14
14
|
import type { BandId } from "../../prompt-assembly/catalog/schema.js";
|
|
15
15
|
import type { ModFrame, ModParticipant } from "./kernel/dispatch.js";
|
|
16
16
|
import type { ModOrigin } from "./kernel/index.js";
|
|
17
|
-
import type
|
|
18
|
-
import
|
|
17
|
+
import { type InputAuthor } from "../input-author.js";
|
|
18
|
+
import type { SystemInjectionPriority } from "../task-notification.js";
|
|
19
|
+
import { type EngineDollar, type ModelCompleteRequest, type ModelCompleteResult, type ModSeatView, type SessionUsage, type SessionVersion, type TurnAbortRef, type TurnAbortVerdict } from "./dollar.js";
|
|
19
20
|
import type { SkillSpec } from "../agent-definition.js";
|
|
20
21
|
import { type SkillScopes } from "./spec-seats.js";
|
|
21
22
|
/**
|
|
@@ -43,10 +44,14 @@ export interface LegEvents {
|
|
|
43
44
|
readonly start?: "classic.SubagentStart";
|
|
44
45
|
/** The event it raises when it would otherwise end. */
|
|
45
46
|
readonly stop: "classic.Stop" | "classic.SubagentStop";
|
|
47
|
+
/** The event it raises on each window of an assistant message it shows — present on a top-level leg only (a delegated leg's
|
|
48
|
+
* stream is its parent's progress view, not a display of its own). */
|
|
49
|
+
readonly display?: "classic.MessageDisplay";
|
|
46
50
|
}
|
|
47
51
|
/**
|
|
48
|
-
* Both ends of a leg, from the delegation fact alone (a child resumed from its checkpoint keeps it): a delegated
|
|
49
|
-
* `classic.SubagentStart
|
|
52
|
+
* Both ends of a leg and its display, from the delegation fact alone (a child resumed from its checkpoint keeps it): a delegated
|
|
53
|
+
* leg opens on `classic.SubagentStart`, ends on `classic.SubagentStop` and shows nothing of its own; any other opens on nothing,
|
|
54
|
+
* ends on `classic.Stop` and raises `classic.MessageDisplay` over what it shows. Not the leg
|
|
50
55
|
* kind (a resumed leg's kind reads `"resume"` whoever it runs as), and not who wrote the objective: whether an input passes
|
|
51
56
|
* the prompt screen is the input's own fact, its author's row (`isScreened`, input-author.ts) — a delegator's words are judged
|
|
52
57
|
* at the delegator's gate (`classic.PreToolUse` on the delegating call), an operator's resume of a child is screened.
|
|
@@ -90,14 +95,19 @@ export declare function chainJudges(bus: LegModBus): boolean;
|
|
|
90
95
|
export type InstallationAskSettlement = (ask: Extract<PermissionResult, {
|
|
91
96
|
action: "ask";
|
|
92
97
|
}>, call: ToolCallRequest, signal: AbortSignal | undefined) => Promise<PermissionResult>;
|
|
98
|
+
/** The question an installation's settlement floated on an EARLIER look at the call, as it stands over a later look that does not ask: a bare allow on rewritten bytes never lifts it, only that installation's approver answering over the bytes in front of it does; undefined when it marked nothing. */
|
|
99
|
+
export type InstallationStandingQuestion = (call: ToolCallRequest) => Extract<PermissionResult, {
|
|
100
|
+
action: "ask";
|
|
101
|
+
}> | undefined;
|
|
93
102
|
/** An inherited installation as a leg's gate raises its judging events on it (`classic.PreToolUse` at phase 1, `tool.check` at the
|
|
94
103
|
* verdict read): the bus that mounted that chain, which of its handlers judge here, the capability face of the environment it was
|
|
95
|
-
* installed against (the `env` of its `classic.PreToolUse` e),
|
|
104
|
+
* installed against (the `env` of its `classic.PreToolUse` e), how its question is settled, and the question it deferred standing. */
|
|
96
105
|
export interface InheritedInstallation {
|
|
97
106
|
readonly bus: LegModBus;
|
|
98
107
|
readonly judges: (p: ModParticipant) => boolean;
|
|
99
108
|
readonly env?: HookEnvCapabilities;
|
|
100
109
|
readonly settle: InstallationAskSettlement;
|
|
110
|
+
readonly standing?: InstallationStandingQuestion;
|
|
101
111
|
}
|
|
102
112
|
/** An inherited chain entry as its installation identity reads it (the installation is absent on a caller-policy entry). */
|
|
103
113
|
export interface InstallationEntry {
|
|
@@ -152,12 +162,12 @@ export declare function chainEntryFault(entries: ReadonlyArray<{
|
|
|
152
162
|
* a handler's answer depends on the chain it sits in (an outer handler may answer without calling `next`, or rule on what an
|
|
153
163
|
* inner one answered), so a registration the leg also mounts in a chain of its own judges again inside the ancestor's chain (a
|
|
154
164
|
* second judgment, never a lost one). Each carries the environment face its installation was installed against (`envOf`) and
|
|
155
|
-
* its entry's settlement of a question (`settleOf
|
|
165
|
+
* its entry's settlement of a question (`settleOf`: an installation's `ask`, on either event, goes to the regime it froze) and the question it deferred on an earlier look (`standingOf`, left standing by a later look that does not ask).
|
|
156
166
|
* Observe handlers never take part. A chain with a malformed entry is refused (`config.mods_invalid`, {@link chainEntryFault}).
|
|
157
167
|
*/
|
|
158
168
|
export declare function inheritedInstallations<E extends InstallationEntry & {
|
|
159
169
|
readonly policy?: object;
|
|
160
|
-
}>(entries: readonly E[], standsIn: (pc: E) => boolean, envOf: (pc: E) => HookEnvCapabilities | undefined, settleOf: (pc: E) => InstallationAskSettlement): readonly InheritedInstallation[];
|
|
170
|
+
}>(entries: readonly E[], standsIn: (pc: E) => boolean, envOf: (pc: E) => HookEnvCapabilities | undefined, settleOf: (pc: E) => InstallationAskSettlement, standingOf?: (pc: E) => InstallationStandingQuestion): readonly InheritedInstallation[];
|
|
161
171
|
/** The members every classic `e` of a leg carries: the identity envelope, the delegated leg's `agentId`, the leg's observed mode. */
|
|
162
172
|
export declare function classicEventBase(identity: HookInvocationIdentity | undefined, permissionMode?: PermissionMode): ClassicEventBase;
|
|
163
173
|
/**
|
|
@@ -192,9 +202,9 @@ export declare function stringMembersOf<M extends string>(answer: unknown, membe
|
|
|
192
202
|
};
|
|
193
203
|
/** The clause a fail-closed station puts in its sentence for the handler that failed it: `crashed (extension "x" threw boom)`
|
|
194
204
|
* — what it did, who it is and the bus's reason. */
|
|
195
|
-
export declare function failedHandlerClause(f: Extract<ModDispatchOutcome, {
|
|
205
|
+
export declare function failedHandlerClause(f: Pick<Extract<ModDispatchOutcome, {
|
|
196
206
|
kind: "failed";
|
|
197
|
-
}>): string;
|
|
207
|
+
}>, "registration" | "cause" | "reason">): string;
|
|
198
208
|
/** The clause without the bus's reason, `crashed (extension "x")`: for a sentence in place of a result the handler saw (its
|
|
199
209
|
* reason may quote that result; the reason is said on the report sink). */
|
|
200
210
|
export declare function failedHandlerName(f: Extract<ModDispatchOutcome, {
|
|
@@ -215,26 +225,36 @@ export declare function observePermissionDenied(input: {
|
|
|
215
225
|
}): Promise<void>;
|
|
216
226
|
/** What a prompt's screen came to, as the four entrances read it: `text` is what the entrance delivers (the prompt as it
|
|
217
227
|
* came, or as `prompt.submit` handed it on — `rewrittenBy` then names who changed it, in the order they did); `block` the
|
|
218
|
-
* refusal (a `prompt.submit` drop, or `classic.UserPromptSubmit`'s block)
|
|
228
|
+
* refusal (a `prompt.submit` drop, or `classic.UserPromptSubmit`'s block); `reply` the answer an extension gave in the
|
|
229
|
+
* model's place where the entrance takes one ({@link PROMPT_ENTRANCES}): `text` enters, its turn answered by `reply`. */
|
|
219
230
|
export type PromptScreen = {
|
|
220
231
|
readonly kind: "answered";
|
|
221
232
|
readonly text: string;
|
|
222
233
|
readonly rewrittenBy?: readonly string[];
|
|
223
234
|
readonly block?: string;
|
|
235
|
+
readonly reply?: {
|
|
236
|
+
readonly text: string;
|
|
237
|
+
readonly by: string;
|
|
238
|
+
};
|
|
224
239
|
readonly additionalContext?: string;
|
|
225
240
|
} | Extract<ModDispatchOutcome, {
|
|
226
241
|
kind: "failed";
|
|
227
242
|
}> | {
|
|
228
243
|
readonly kind: "aborted";
|
|
229
244
|
};
|
|
230
|
-
/**
|
|
245
|
+
/** Why a changed text may not stand, as the sentence the refused handler is told, or `undefined` when it may. */
|
|
246
|
+
export type TextRefusal = (text: string) => string | undefined;
|
|
247
|
+
/** Who changed a text a chain carried, read off the chain as it runs (a station's `checkHandOn` and `checkAnswer` feed it). A
|
|
248
|
+
* station that judges a change passes its `refuse`: a refused change is named by no one and moves nothing, so what the chain
|
|
249
|
+
* carries is still the text the last accepted change left — the retry of a refused text (a `.catch` handing it on again) is a
|
|
250
|
+
* change again, and is refused again. */
|
|
231
251
|
export interface TextChanges {
|
|
232
252
|
/** A handler handed `text` on (down): it changed the text when that differs from what the previous hand-on (or the
|
|
233
|
-
* original) carried. */
|
|
234
|
-
handedOn(by: string, text: string):
|
|
253
|
+
* original) carried. `undefined` — taken (a change or none); a sentence — the change `refuse` refused. */
|
|
254
|
+
handedOn(by: string, text: string, refuse?: TextRefusal): string | undefined;
|
|
235
255
|
/** A handler answered `text` (up): it changed the text when that differs from what its `next` answered (`below`) or, when
|
|
236
|
-
* it answered without one, from the text it was handed. */
|
|
237
|
-
answered(by: string, text: string, handed: string, below: string | undefined):
|
|
256
|
+
* it answered without one, from the text it was handed. `undefined` — taken; a sentence — the change `refuse` refused. */
|
|
257
|
+
answered(by: string, text: string, handed: string, below: string | undefined, refuse?: TextRefusal): string | undefined;
|
|
238
258
|
/** The handlers that changed the text, in the order they did (down before up), each named once. */
|
|
239
259
|
rewrittenBy(): readonly string[];
|
|
240
260
|
}
|
|
@@ -264,9 +284,11 @@ export declare function promptScreenDeclaredBy(registrations: readonly {
|
|
|
264
284
|
readonly events: readonly string[];
|
|
265
285
|
};
|
|
266
286
|
}[]): boolean;
|
|
267
|
-
/** A screened input as the screen raises it: its author as judged,
|
|
287
|
+
/** A screened input as the screen raises it: its author as judged, the tier a steer is taken at (its `priority`, defaulted —
|
|
288
|
+
* what decides whether the steer entrance takes a reply), and for an extension's prompt the caller and its `$` call. */
|
|
268
289
|
export interface PromptScreenInput {
|
|
269
290
|
readonly author: InputAuthor;
|
|
291
|
+
readonly tier?: SystemInjectionPriority;
|
|
270
292
|
readonly extension?: string;
|
|
271
293
|
readonly raisedUnder?: RaisedUnder;
|
|
272
294
|
}
|
|
@@ -365,6 +387,8 @@ export interface LegFacadeSeats {
|
|
|
365
387
|
turns(): Promise<number>;
|
|
366
388
|
usage(): SessionUsage;
|
|
367
389
|
version(): SessionVersion;
|
|
390
|
+
/** `$.turn.abort`'s seat ({@link ModSeatView.turn}). */
|
|
391
|
+
turnAbort(turn: number, by: string): TurnAbortVerdict;
|
|
368
392
|
now(): number;
|
|
369
393
|
tools(): readonly string[];
|
|
370
394
|
agents(): readonly string[];
|
|
@@ -397,6 +421,9 @@ export interface LegMods {
|
|
|
397
421
|
readonly report: (err: Error) => void;
|
|
398
422
|
/** Bind the engine facade once the leg is prepared. Until then a `$` call throws, naming the method. */
|
|
399
423
|
bindFacade(seats: LegFacadeSeats): void;
|
|
424
|
+
/** End the bus's lifetime (the leg stopped): its timers are cancelled and a `$` call made after its handler settled is
|
|
425
|
+
* refused from here. Its owner calls it on every way out of the leg; a second call does nothing. */
|
|
426
|
+
end(): void;
|
|
400
427
|
}
|
|
401
428
|
/**
|
|
402
429
|
* Admit the leg's bus: both seats (`RunnerDeps.mods`, `TaskSpec.mods`), screened and put to `plugin.register`.
|
|
@@ -415,7 +442,7 @@ export declare function admitLegMods(input: {
|
|
|
415
442
|
}): Promise<LegMods>;
|
|
416
443
|
/** What a leg hands {@link legFacadeSeats}: the seats it already has. */
|
|
417
444
|
export interface LegFacadeInput {
|
|
418
|
-
readonly deps: Pick<RunnerDeps, "brain" | "models" | "now">;
|
|
445
|
+
readonly deps: Pick<RunnerDeps, "brain" | "modelFallback" | "cacheRetention" | "models" | "now">;
|
|
419
446
|
readonly spec: Pick<TaskSpec, "getApiKeyAndHeaders">;
|
|
420
447
|
readonly sessionId: string;
|
|
421
448
|
readonly model: Model;
|
|
@@ -435,6 +462,8 @@ export interface LegFacadeInput {
|
|
|
435
462
|
readonly turns: () => Promise<number>;
|
|
436
463
|
/** The leg's measurement seat (`measureSession` writes it at each turn boundary). */
|
|
437
464
|
readonly measure: SessionMeasureSeat;
|
|
465
|
+
/** The leg's `$.turn.abort` seat, filled by the run ({@link TurnAbortRef}). */
|
|
466
|
+
readonly turnAbort: TurnAbortRef;
|
|
438
467
|
readonly activeTools: ReadonlySet<string>;
|
|
439
468
|
readonly agentListing: {
|
|
440
469
|
readonly entries: ReadonlyArray<{
|
|
@@ -473,7 +502,8 @@ export declare function legFacadeSeats(input: LegFacadeInput): LegFacadeSeats;
|
|
|
473
502
|
* A chain admitted outside any leg — what a host rebuilds to re-supply an inherited screening entry on a fresh Runner
|
|
474
503
|
* (a cross-process resume hands back `{ installation: await admitModChain(…), hookEnv, …regime }` over the same
|
|
475
504
|
* registrations). The same admission a leg runs (both seats, `plugin.register`); no leg exists, so its `$` facade is never
|
|
476
|
-
* bound and a `$` call throws
|
|
505
|
+
* bound and a `$` call throws, and its lifetime has ended from the start: a timer is refused, and so is a `$` call made after
|
|
506
|
+
* its handler settled. Handler failures go to `onError` (absent ⇒ unreported). Its chain identity is recorded as a
|
|
477
507
|
* leg's is ({@link chainOfBus}), so an entry carrying it is read by what it mounted.
|
|
478
508
|
*/
|
|
479
509
|
export declare function admitModChain(seats: {
|
|
@@ -9,11 +9,14 @@ import { agentIdOf } from "../leg-identity.js";
|
|
|
9
9
|
import { admitMods, expandOnSide } from "./kernel/index.js";
|
|
10
10
|
import { legBusOf } from "./extension-call.js";
|
|
11
11
|
import { validateOverlay } from "../../prompt-assembly/overlay.js";
|
|
12
|
+
import { isBlankInput, steeringTextDefect, steeringTextDefectClause } from "../input-author.js";
|
|
12
13
|
import { modsInvalid } from "./kernel/registration.js";
|
|
13
14
|
import { isPlainRecord } from "./kernel/receive.js";
|
|
15
|
+
import { NEXT_IN_FLIGHT } from "./kernel/site-rules.js";
|
|
14
16
|
import { engineMethodBottoms } from "./dollar.js";
|
|
15
17
|
import { modSeatsOf, modsReportToOnError, registrationRefusedNotice } from "./host.js";
|
|
16
18
|
import { scopedLegBus, skillScopeRecord, skillSeatsOf, standingBus } from "./spec-seats.js";
|
|
19
|
+
import { modelLaneBrainOf } from "../runner/model-lane-seat.js";
|
|
17
20
|
export const ENGINE_CORE_ANSWER = Object.freeze({});
|
|
18
21
|
export function engineCore() {
|
|
19
22
|
return ENGINE_CORE_ANSWER;
|
|
@@ -24,7 +27,7 @@ export function seatHears(binding, event) {
|
|
|
24
27
|
export function legNoticeTaskId(leg) {
|
|
25
28
|
return { taskId: leg.taskId };
|
|
26
29
|
}
|
|
27
|
-
const TOP_LEVEL_LEG = Object.freeze({ stop: "classic.Stop" });
|
|
30
|
+
const TOP_LEVEL_LEG = Object.freeze({ stop: "classic.Stop", display: "classic.MessageDisplay" });
|
|
28
31
|
const DELEGATED_LEG = Object.freeze({ start: "classic.SubagentStart", stop: "classic.SubagentStop" });
|
|
29
32
|
export function legEventsOf(identity) {
|
|
30
33
|
return identity?.isDelegatedChild === true ? DELEGATED_LEG : TOP_LEVEL_LEG;
|
|
@@ -101,7 +104,7 @@ export function chainEntryFault(entries) {
|
|
|
101
104
|
return undefined;
|
|
102
105
|
}
|
|
103
106
|
const judges = (p) => judgesCall(p);
|
|
104
|
-
export function inheritedInstallations(entries, standsIn, envOf, settleOf) {
|
|
107
|
+
export function inheritedInstallations(entries, standsIn, envOf, settleOf, standingOf) {
|
|
105
108
|
const fault = chainEntryFault(entries);
|
|
106
109
|
if (fault !== undefined)
|
|
107
110
|
throw modsInvalid(fault);
|
|
@@ -111,7 +114,7 @@ export function inheritedInstallations(entries, standsIn, envOf, settleOf) {
|
|
|
111
114
|
if (bus === undefined || standsIn(pc) || !chainJudges(bus))
|
|
112
115
|
continue;
|
|
113
116
|
const env = envOf(pc);
|
|
114
|
-
installations.push(Object.freeze({ bus, judges, ...(env !== undefined ? { env } : {}), settle: settleOf(pc) }));
|
|
117
|
+
installations.push(Object.freeze({ bus, judges, ...(env !== undefined ? { env } : {}), settle: settleOf(pc), ...(standingOf !== undefined ? { standing: standingOf(pc) } : {}) }));
|
|
115
118
|
}
|
|
116
119
|
return Object.freeze(installations);
|
|
117
120
|
}
|
|
@@ -210,14 +213,24 @@ export function textChanges(original) {
|
|
|
210
213
|
};
|
|
211
214
|
let before = original;
|
|
212
215
|
return {
|
|
213
|
-
handedOn: (by, text) => {
|
|
214
|
-
if (text
|
|
215
|
-
|
|
216
|
+
handedOn: (by, text, refuse) => {
|
|
217
|
+
if (text === before)
|
|
218
|
+
return undefined;
|
|
219
|
+
const refusal = refuse?.(text);
|
|
220
|
+
if (refusal !== undefined)
|
|
221
|
+
return refusal;
|
|
222
|
+
note(by);
|
|
216
223
|
before = text;
|
|
224
|
+
return undefined;
|
|
217
225
|
},
|
|
218
|
-
answered: (by, text, handed, below) => {
|
|
219
|
-
if (text
|
|
220
|
-
|
|
226
|
+
answered: (by, text, handed, below, refuse) => {
|
|
227
|
+
if (text === (below ?? handed))
|
|
228
|
+
return undefined;
|
|
229
|
+
const refusal = refuse?.(text);
|
|
230
|
+
if (refusal !== undefined)
|
|
231
|
+
return refusal;
|
|
232
|
+
note(by);
|
|
233
|
+
return undefined;
|
|
221
234
|
},
|
|
222
235
|
rewrittenBy: () => Object.freeze([...changers]),
|
|
223
236
|
};
|
|
@@ -244,7 +257,30 @@ export function promptScreenDeclaredBy(registrations) {
|
|
|
244
257
|
}
|
|
245
258
|
return promptScreenHeard((station) => selected.has(station));
|
|
246
259
|
}
|
|
247
|
-
const
|
|
260
|
+
const PROMPT_ENTRANCES = Object.freeze({
|
|
261
|
+
objective: Object.freeze({ replyable: "always", steering: false }),
|
|
262
|
+
steer: Object.freeze({ replyable: "later", steering: true }),
|
|
263
|
+
resume_message: Object.freeze({ replyable: "never", steering: true }),
|
|
264
|
+
followUp: Object.freeze({ replyable: "never", steering: true }),
|
|
265
|
+
parked_redelivery: Object.freeze({ replyable: "never", steering: true }),
|
|
266
|
+
system: Object.freeze({ replyable: "later", steering: true }),
|
|
267
|
+
});
|
|
268
|
+
function entranceOf(source) {
|
|
269
|
+
return typeof source === "string" && Object.hasOwn(PROMPT_ENTRANCES, source) ? PROMPT_ENTRANCES[source] : undefined;
|
|
270
|
+
}
|
|
271
|
+
function entranceReplyable(source, tier) {
|
|
272
|
+
const row = entranceOf(source)?.replyable;
|
|
273
|
+
return row === "always" || (row === "later" && tier === "later");
|
|
274
|
+
}
|
|
275
|
+
function changedTextClause(source, text) {
|
|
276
|
+
if (entranceOf(source)?.steering !== true)
|
|
277
|
+
return undefined;
|
|
278
|
+
const defect = steeringTextDefect(text);
|
|
279
|
+
if (defect !== undefined)
|
|
280
|
+
return steeringTextDefectClause(defect);
|
|
281
|
+
return isBlankInput(text) ? "says nothing (only whitespace and control characters; answer { drop: <reason> } to refuse an input)" : undefined;
|
|
282
|
+
}
|
|
283
|
+
const PROMPT_SUBMIT_FORM = "prompt.submit takes { text } (a string), { reply } (a non-empty string, where e.replyable is true) or { drop: <reason> }";
|
|
248
284
|
function readSubmitAnswer(a) {
|
|
249
285
|
if (!isPlainRecord(a))
|
|
250
286
|
return { why: PROMPT_SUBMIT_FORM };
|
|
@@ -253,27 +289,41 @@ function readSubmitAnswer(a) {
|
|
|
253
289
|
const r = a["drop"];
|
|
254
290
|
return typeof r === "string" && r.trim() !== "" ? { drop: r } : { why: "a drop that is not a reason (a non-empty string)" };
|
|
255
291
|
}
|
|
292
|
+
if (keys.length === 1 && keys[0] === "reply") {
|
|
293
|
+
const r = a["reply"];
|
|
294
|
+
if (typeof r !== "string" || isBlankInput(r))
|
|
295
|
+
return { why: "a reply that is not a non-empty string" };
|
|
296
|
+
const defect = steeringTextDefect(r);
|
|
297
|
+
return defect === undefined ? { reply: r } : { why: `a reply that ${steeringTextDefectClause(defect)}` };
|
|
298
|
+
}
|
|
256
299
|
if (keys.length === 1 && keys[0] === "text") {
|
|
257
300
|
const t = a["text"];
|
|
258
301
|
return typeof t === "string" ? { text: t } : { why: "a text that is not a string" };
|
|
259
302
|
}
|
|
260
303
|
return { why: PROMPT_SUBMIT_FORM };
|
|
261
304
|
}
|
|
262
|
-
const PROMPT_SUBMIT_RANKS = Object.freeze({
|
|
305
|
+
const PROMPT_SUBMIT_RANKS = Object.freeze({
|
|
306
|
+
of: (a) => (!isPlainRecord(a) ? 0 : Object.hasOwn(a, "drop") ? 2 : Object.hasOwn(a, "reply") ? 1 : 0),
|
|
307
|
+
top: 2,
|
|
308
|
+
});
|
|
263
309
|
const OPERATOR_SCREEN = Object.freeze({ author: "operator" });
|
|
264
310
|
export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN) {
|
|
265
311
|
if (!promptScreenHasHandlers(bus))
|
|
266
312
|
return undefined;
|
|
267
313
|
const { prompt, ...classicFacts } = e;
|
|
268
|
-
const
|
|
314
|
+
const replyable = entranceReplyable(e.source, input.tier);
|
|
315
|
+
const facts = { ...classicFacts, author: input.author, ...(input.extension !== undefined ? { extension: input.extension } : {}), replyable };
|
|
269
316
|
const raisedUnder = input.raisedUnder;
|
|
270
317
|
const changes = textChanges(prompt);
|
|
318
|
+
const refusedWith = (lead) => (text) => {
|
|
319
|
+
const clause = changedTextClause(e.source, text);
|
|
320
|
+
return clause === undefined ? undefined : `${lead} ${clause}`;
|
|
321
|
+
};
|
|
271
322
|
const checkHandOn = (handed, by) => {
|
|
272
323
|
const t = handed["text"];
|
|
273
324
|
if (typeof t !== "string")
|
|
274
325
|
return "next() handed on a text that is not a string";
|
|
275
|
-
changes.handedOn(by.plugin, t);
|
|
276
|
-
return undefined;
|
|
326
|
+
return changes.handedOn(by.plugin, t, refusedWith("next() handed on a text that"));
|
|
277
327
|
};
|
|
278
328
|
const seen = {};
|
|
279
329
|
const bottom = async (handed) => {
|
|
@@ -285,13 +335,25 @@ export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN)
|
|
|
285
335
|
return Object.freeze({ text });
|
|
286
336
|
return Object.freeze({ drop: classic.kind === "answered" ? classic.block : "the classic.UserPromptSubmit screen did not clear the prompt" });
|
|
287
337
|
};
|
|
338
|
+
const replyEnters = new WeakMap();
|
|
288
339
|
const checkAnswer = (a, handed, by, below) => {
|
|
289
340
|
const read = readSubmitAnswer(a);
|
|
290
341
|
if ("why" in read)
|
|
291
342
|
return read.why;
|
|
343
|
+
if ("reply" in read && !replyable)
|
|
344
|
+
return `answered { reply } at the ${e.source} entrance, which takes none (e.replyable is false): answer { text } or { drop }`;
|
|
345
|
+
const last = below.length > 0 ? below[below.length - 1] : undefined;
|
|
346
|
+
if ("reply" in read && below.includes(NEXT_IN_FLIGHT))
|
|
347
|
+
return "answered { reply } while its next(e) still ran — the text the input enters as was not settled";
|
|
348
|
+
const up = last !== undefined ? readSubmitAnswer(last) : undefined;
|
|
292
349
|
if ("text" in read) {
|
|
293
|
-
const
|
|
294
|
-
|
|
350
|
+
const refused = changes.answered(by.plugin, read.text, handed["text"], up !== undefined && "text" in up ? up.text : undefined, refusedWith("a text that"));
|
|
351
|
+
if (refused !== undefined)
|
|
352
|
+
return refused;
|
|
353
|
+
}
|
|
354
|
+
if ("reply" in read && isPlainRecord(a)) {
|
|
355
|
+
const carried = up !== undefined && "reply" in up && isPlainRecord(last) ? replyEnters.get(last) : undefined;
|
|
356
|
+
replyEnters.set(a, carried ?? (up !== undefined && "text" in up ? up.text : handed["text"]));
|
|
295
357
|
}
|
|
296
358
|
return undefined;
|
|
297
359
|
};
|
|
@@ -314,6 +376,12 @@ export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN)
|
|
|
314
376
|
return { kind: "answered", text: prompt, block: read.drop };
|
|
315
377
|
if ("why" in read)
|
|
316
378
|
return { kind: "failed", registration: by, cause: "violation", reason: read.why, skipped: [] };
|
|
379
|
+
if ("reply" in read) {
|
|
380
|
+
const entered = isPlainRecord(outcome.answer) ? replyEnters.get(outcome.answer) : undefined;
|
|
381
|
+
if (entered === undefined)
|
|
382
|
+
return { kind: "failed", registration: "engine", cause: "threw", reason: "a reply the screen did not judge", skipped: [] };
|
|
383
|
+
return { kind: "answered", text: entered, ...(entered !== prompt ? { rewrittenBy: changes.rewrittenBy() } : {}), reply: { text: read.reply, by }, ...context };
|
|
384
|
+
}
|
|
317
385
|
if (read.text === prompt)
|
|
318
386
|
return { kind: "answered", text: prompt, ...context };
|
|
319
387
|
return { kind: "answered", text: read.text, rewrittenBy: changes.rewrittenBy(), ...context };
|
|
@@ -511,6 +579,7 @@ function lateView() {
|
|
|
511
579
|
usage: () => need("session.usage").usage(),
|
|
512
580
|
version: () => need("session.version").version(),
|
|
513
581
|
},
|
|
582
|
+
turn: { abort: (turn, by) => need("turn.abort").turnAbort(turn, by) },
|
|
514
583
|
now: () => need("clock.now").now(),
|
|
515
584
|
tools: () => need("tool.list").tools(),
|
|
516
585
|
agents: () => need("agent.list").agents(),
|
|
@@ -536,7 +605,15 @@ export async function admitLegMods(input) {
|
|
|
536
605
|
const skillSeats = skillSeatsOf(input.skills);
|
|
537
606
|
const admitted = skillSeats.registrations.length === 0 ? seats : { ...seats, task: [...(seats.task ?? []), ...skillSeats.registrations] };
|
|
538
607
|
const report = modsReportToOnError(input.deps.onError, input.sessionId);
|
|
539
|
-
const
|
|
608
|
+
const life = new AbortController();
|
|
609
|
+
let kernelBus;
|
|
610
|
+
try {
|
|
611
|
+
kernelBus = await admitMods({ side: "engine", seats: admitted, bottoms: engineMethodBottoms(late.view), entries: late.entries, report, describeThrown, isProxy: types.isProxy, lifetime: life.signal });
|
|
612
|
+
}
|
|
613
|
+
catch (err) {
|
|
614
|
+
life.abort(new Error("the leg's admission failed"));
|
|
615
|
+
throw err;
|
|
616
|
+
}
|
|
540
617
|
const skillScopes = skillScopeRecord(skillSeats.owners, input.reopenedSkills);
|
|
541
618
|
const bus = legBusOf(scopedLegBus(kernelBus, skillScopes), report);
|
|
542
619
|
const standing = standingBus(bus, skillScopes);
|
|
@@ -547,7 +624,7 @@ export async function admitLegMods(input) {
|
|
|
547
624
|
const chain = recordAdmittedChain(bus, seats);
|
|
548
625
|
if (standing !== bus)
|
|
549
626
|
ADMITTED_CHAINS.set(standing, chain);
|
|
550
|
-
return { bus, standing, chain, skillScopes, report, bindFacade: late.bind };
|
|
627
|
+
return { bus, standing, chain, skillScopes, report, bindFacade: late.bind, end: () => life.abort(new Error("the leg stopped")) };
|
|
551
628
|
}
|
|
552
629
|
async function agentRowsOf(seat, agentId) {
|
|
553
630
|
const refused = (why) => new Error(`session.messages: agent ${agentId}: ${why}`);
|
|
@@ -570,11 +647,12 @@ async function agentRowsOf(seat, agentId) {
|
|
|
570
647
|
}
|
|
571
648
|
return branch.flatMap((e) => (e.type === "message" ? [e.message] : []));
|
|
572
649
|
}
|
|
650
|
+
const NO_REQUEST_RUNNING = Object.freeze({ kind: "none" });
|
|
573
651
|
function replyText(reply) {
|
|
574
652
|
return reply.content.flatMap((c) => (c.type === "text" ? [c.text] : [])).join("");
|
|
575
653
|
}
|
|
576
654
|
export function legFacadeSeats(input) {
|
|
577
|
-
const runtime = brainToRuntime(input.deps
|
|
655
|
+
const runtime = brainToRuntime(modelLaneBrainOf(input.deps));
|
|
578
656
|
const answeredBy = new Map();
|
|
579
657
|
const byUsage = new WeakMap();
|
|
580
658
|
return {
|
|
@@ -610,6 +688,7 @@ export function legFacadeSeats(input) {
|
|
|
610
688
|
turns: () => input.turns(),
|
|
611
689
|
usage: () => Object.freeze(input.measure.context !== undefined ? { context: input.measure.context } : {}),
|
|
612
690
|
version: () => Object.freeze({ version: engineVersion() }),
|
|
691
|
+
turnAbort: (turn, by) => input.turnAbort.seat?.(turn, by) ?? NO_REQUEST_RUNNING,
|
|
613
692
|
now: () => (input.deps.now ?? Date.now)(),
|
|
614
693
|
tools: () => [...input.activeTools],
|
|
615
694
|
agents: () => (input.agentListing?.entries ?? []).map((e) => e.name),
|
|
@@ -635,7 +714,9 @@ export async function admitModChain(seats, onError) {
|
|
|
635
714
|
},
|
|
636
715
|
describeThrown,
|
|
637
716
|
isProxy: types.isProxy,
|
|
717
|
+
lifetime: OUTSIDE_ANY_LEG,
|
|
638
718
|
});
|
|
639
719
|
recordAdmittedChain(bus, seats);
|
|
640
720
|
return bus;
|
|
641
721
|
}
|
|
722
|
+
const OUTSIDE_ANY_LEG = AbortSignal.abort(new Error("admitted outside any leg"));
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The answer of a `classic.Stop` / `classic.SubagentStop` handler, read ONE way wherever it is read: by the engine's stop
|
|
3
|
+
* station when it folds the two seats' answers, and by a handler folding its own answer with what `next` answered in its
|
|
4
|
+
* seat. The members are read as the station's answer check reads them ({@link stringMembersOf}): a string member stands
|
|
5
|
+
* (an empty one included), a member of any other type is absent.
|
|
6
|
+
*/
|
|
7
|
+
import type { StopHookResult } from "../hooks.js";
|
|
8
|
+
/** The members a Stop answer is read for; the station's answer check refuses a non-string one. */
|
|
9
|
+
export declare const STOP_ANSWER_MEMBERS: readonly ["block", "additionalContext", "end"];
|
|
10
|
+
/** A Stop answer's members as the engine reads them. */
|
|
11
|
+
export declare function readStopAnswer(answer: unknown): StopHookResult;
|
|
12
|
+
/**
|
|
13
|
+
* Whether a Stop answer decides its stop point on its own: it asks to end (`end` present, empty or not) or it pushes back
|
|
14
|
+
* with a non-empty `block`. Context alone is advice, never a decision.
|
|
15
|
+
*/
|
|
16
|
+
export declare function stopAnswerDecides(answer: StopHookResult | undefined): boolean;
|
|
17
|
+
/**
|
|
18
|
+
* Fold two Stop answers, `outer` the more trusted one (across seats: the deployment's; within a seat: the handler's own,
|
|
19
|
+
* `inner` what `next` answered). An answer carrying `end` ends the stop point: the fold carries `end` alone, its reason the
|
|
20
|
+
* first one present (`outer`'s, then `inner`'s). Otherwise the fold carries the first non-empty `block` and the non-empty
|
|
21
|
+
* contexts in order, joined by a blank line; an empty fold lets the run end as an empty answer does.
|
|
22
|
+
*/
|
|
23
|
+
export declare function mergeStopAnswers(outer: StopHookResult | undefined, inner: StopHookResult | undefined): StopHookResult;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { stringMembersOf } from "./stations.js";
|
|
2
|
+
export const STOP_ANSWER_MEMBERS = Object.freeze(["block", "additionalContext", "end"]);
|
|
3
|
+
export function readStopAnswer(answer) {
|
|
4
|
+
return stringMembersOf(answer, STOP_ANSWER_MEMBERS);
|
|
5
|
+
}
|
|
6
|
+
const nonEmpty = (s) => s !== undefined && s.length > 0;
|
|
7
|
+
export function stopAnswerDecides(answer) {
|
|
8
|
+
const a = readStopAnswer(answer);
|
|
9
|
+
return a.end !== undefined || nonEmpty(a.block);
|
|
10
|
+
}
|
|
11
|
+
export function mergeStopAnswers(outer, inner) {
|
|
12
|
+
const o = readStopAnswer(outer);
|
|
13
|
+
const i = readStopAnswer(inner);
|
|
14
|
+
const end = o.end ?? i.end;
|
|
15
|
+
if (end !== undefined)
|
|
16
|
+
return { end };
|
|
17
|
+
const block = [o.block, i.block].find(nonEmpty);
|
|
18
|
+
const context = [o.additionalContext, i.additionalContext].filter(nonEmpty).join("\n\n");
|
|
19
|
+
return { ...(block !== undefined ? { block } : {}), ...(context.length > 0 ? { additionalContext: context } : {}) };
|
|
20
|
+
}
|
|
@@ -12,9 +12,27 @@ import type { ToolContentOrigin } from "./tool-spec.js";
|
|
|
12
12
|
import type { McpConnectionPool } from "./mcp-connection-pool.js";
|
|
13
13
|
import type { McpHostSeat } from "./mcp-host-seat.js";
|
|
14
14
|
import type { McpInstructionsEntry } from "./prompt-section-seat.js";
|
|
15
|
-
/**
|
|
15
|
+
/**
|
|
16
|
+
* The reserved names of a server's `allowTools`: each names a FACE of the server — a kind of read the engine makes of it — and never a
|
|
17
|
+
* tool. `list_resources` / `read_resource` open the server to the cross-server resource readers (the model's resource tools and the host's
|
|
18
|
+
* `listResources` / `readResource`), `list_resource_templates` to the host's template listing, `list_prompts` / `get_prompt` to the host's
|
|
19
|
+
* prompt ports. The one law, read by {@link faceAllowed}: no list ⇒ every face open; a list (even `[]`) ⇒ only the faces it names. Every
|
|
20
|
+
* other string in the list is a tool name. A server's own tool listed under one of these names is not mounted (the intake's drop lane says
|
|
21
|
+
* so on both faces), and a `toolAxes` / `toolFaces` declaration keyed by one is refused at the entry's judge: the key could never name a tool.
|
|
22
|
+
*/
|
|
16
23
|
export declare const MCP_RESOURCE_LIST_ALLOW = "list_resources";
|
|
17
24
|
export declare const MCP_RESOURCE_READ_ALLOW = "read_resource";
|
|
25
|
+
export declare const MCP_RESOURCE_TEMPLATE_LIST_ALLOW = "list_resource_templates";
|
|
26
|
+
export declare const MCP_PROMPT_LIST_ALLOW = "list_prompts";
|
|
27
|
+
export declare const MCP_PROMPT_GET_ALLOW = "get_prompt";
|
|
28
|
+
export declare const MCP_FACE_WORDS: readonly ["list_resources", "read_resource", "list_resource_templates", "list_prompts", "get_prompt"];
|
|
29
|
+
export type McpFaceWord = (typeof MCP_FACE_WORDS)[number];
|
|
30
|
+
/** Is `name` one of the reserved face words ({@link MCP_FACE_WORDS})? Such a name is never a tool's. */
|
|
31
|
+
export declare function isMcpFaceWord(name: unknown): name is McpFaceWord;
|
|
32
|
+
/** The one judge of whether a server's `allowTools` opens `face` ({@link MCP_FACE_WORDS}): absent ⇒ open; present ⇒ open iff it names it. */
|
|
33
|
+
export declare function faceAllowed(allowTools: readonly string[] | undefined, face: McpFaceWord): boolean;
|
|
34
|
+
/** The drop reason of a server tool listed under a reserved face word ({@link MCP_FACE_WORDS}). */
|
|
35
|
+
export declare const MCP_FACE_WORD_DROP_REASON = "its name is one of the reserved MCP face words an allowTools list uses for a kind of read (list_resources, read_resource, list_resource_templates, list_prompts, get_prompt), never a tool, so the tool is not mounted";
|
|
18
36
|
/** The canonical names of the resource tools (the trio: list-all / read-one / list-under-a-directory). They belong to no one server: each aggregates the resources of every connected server that advertises them. */
|
|
19
37
|
export declare const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
|
|
20
38
|
export declare const READ_MCP_RESOURCE = "ReadMcpResourceTool";
|
|
@@ -51,16 +69,25 @@ export interface InstructionsLane {
|
|
|
51
69
|
}
|
|
52
70
|
/** Are this server's instructions in the model's context now? */
|
|
53
71
|
export declare function instructionsTold(lane: InstructionsLane, server: string): boolean;
|
|
72
|
+
/**
|
|
73
|
+
* THE judge of the add lane: is this connection's entry the text the model holds, or is about to hold (an unread copy of it is queued)? A server never
|
|
74
|
+
* told, one whose disconnect line is queued (the model is being told the text no longer applies), and one holding or awaiting another text or author
|
|
75
|
+
* are all "no". Every caller that would queue an entry — a re-dial's reconcile and a roster change's settle — asks it through {@link tellInstructions}.
|
|
76
|
+
*/
|
|
77
|
+
export declare function instructionsUnchanged(lane: InstructionsLane, entry: McpInstructionsEntry): boolean;
|
|
54
78
|
/** A dial's default: the server's instructions are taught (a materialization alone takes every entry it returns as taught, until a run states its block). */
|
|
55
|
-
export declare function toldOnDial(lane: InstructionsLane,
|
|
56
|
-
/** The run's start: the stable block is what the model is told. A removal already queued for a server outside the block names instructions the
|
|
57
|
-
* never held, so it is withdrawn; a server inside the block with a removal queued is not
|
|
58
|
-
|
|
59
|
-
|
|
79
|
+
export declare function toldOnDial(lane: InstructionsLane, entry: McpInstructionsEntry): void;
|
|
80
|
+
/** The run's start: the stable block (`taught`) is what the model is told. A removal already queued for a server outside the block names instructions the
|
|
81
|
+
* model never held, so it is withdrawn; a server inside the block with a removal queued is not told (the frame will retract it), the block's text is
|
|
82
|
+
* kept for a re-dial that withdraws the removal. */
|
|
83
|
+
export declare function toldAtStart(lane: InstructionsLane, taught: ReadonlyArray<McpInstructionsEntry>): void;
|
|
84
|
+
/** Take this server's unread adds off the lane; a first copy that never reached the model leaves the ledger with it, a supersede leaves the model the text it holds. */
|
|
60
85
|
export declare function withdrawInstructionAdds(lane: InstructionsLane, server: string): void;
|
|
61
|
-
/** Queue this server's current text (
|
|
86
|
+
/** Queue this server's current text unless the model holds (or is about to hold) exactly it. A different unread copy is superseded: the newest text
|
|
87
|
+
* is the one queued, and when the newest is the text the model already holds, the stale unread copy is simply withdrawn. */
|
|
62
88
|
export declare function tellInstructions(lane: InstructionsLane, entry: McpInstructionsEntry): void;
|
|
63
|
-
/** The server's connection is gone: unread adds are withdrawn, and the model is told its instructions no longer apply only if it holds them
|
|
89
|
+
/** The server's connection is gone: unread adds are withdrawn, and the model is told its instructions no longer apply only if it holds them
|
|
90
|
+
* (the text stays on the ledger until that line is delivered, for a re-dial that withdraws it). */
|
|
64
91
|
export declare function retractInstructions(lane: InstructionsLane, server: string): void;
|
|
65
92
|
/** A re-dial that connected: a retraction still unread never reached the model, so it is withdrawn and the text the model holds stands. */
|
|
66
93
|
export declare function unretractInstructions(lane: InstructionsLane, server: string): void;
|
|
@@ -94,6 +121,19 @@ interface RosterEntry {
|
|
|
94
121
|
* differently. Handed a server's own listing it answers what the server offers, which is not a mount count.
|
|
95
122
|
*/
|
|
96
123
|
export declare function toolNamesOfServer(names: Iterable<string>, serverName: string): string[];
|
|
124
|
+
/**
|
|
125
|
+
* The tool cells of a connected server's manifest row, off ONE read of the roster: `toolCount` is how many names {@link toolNamesOfServer}
|
|
126
|
+
* answers, `toolNames` the first `max` of them that are wire names (in the roster's order) — present iff there is one — and
|
|
127
|
+
* `toolNamesTruncated: true` iff the list is short of the count (over `max`, or a held name that is not listable); never `false`. A wire
|
|
128
|
+
* name is the provider's tool-name charset and length — the fixed point of the mint's own fold ({@link normalizeNameSegment}), so there is
|
|
129
|
+
* no second pattern to keep in step — and a held name outside it is counted and not listed, because a roster is host-fed and a listing is
|
|
130
|
+
* read by a person.
|
|
131
|
+
*/
|
|
132
|
+
export declare function toolFieldsOfServer(rosterNames: Iterable<string>, serverName: string, max: number): {
|
|
133
|
+
toolCount: number;
|
|
134
|
+
toolNames?: string[];
|
|
135
|
+
toolNamesTruncated?: true;
|
|
136
|
+
};
|
|
97
137
|
/**
|
|
98
138
|
* Read the run's MCP surface off its roster. `declared` is the run's frozen server declarations; `aggregateNames` the names of the
|
|
99
139
|
* tools its materialization minted that no server owns. A tool is a server's when its wire name sits under the server's prefix
|