@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { ANNOUNCED_LANGUAGE_MAX_CHARS } from "../../internal/harness.js";
|
|
2
|
+
import { mintSystemReminder } from "../reminder-mint.js";
|
|
3
|
+
import { describeRejectedValue } from "../tool-search-setting.js";
|
|
4
|
+
import { inlineUntrusted } from "../untrusted-text.js";
|
|
5
|
+
import { conversationSegmentOf, restateToldSeat } from "./conversation-segment.js";
|
|
6
|
+
export const LANGUAGE_MAX = ANNOUNCED_LANGUAGE_MAX_CHARS;
|
|
7
|
+
export const LANGUAGE_CLEARED = "The language preference was cleared. Match the user's language.";
|
|
8
|
+
export function renderLanguageInstructions(language) {
|
|
9
|
+
const l = inlineUntrusted(language, LANGUAGE_MAX);
|
|
10
|
+
return `# Language
|
|
11
|
+
Always respond in ${l}. Use ${l} for all explanations, comments, and communications with the user. Technical terms and code identifiers should remain in their original form.
|
|
12
|
+
Maintain full orthographic correctness for ${l}, including all required diacritical marks, accents, and special characters. Never substitute accented characters with their ASCII equivalents (e.g., never write "nao" for "não", "fur" for "für", or "loeschen" for "löschen").`;
|
|
13
|
+
}
|
|
14
|
+
export function screenLanguageSeat(seat) {
|
|
15
|
+
if (seat === undefined)
|
|
16
|
+
return undefined;
|
|
17
|
+
const refuse = (why) => {
|
|
18
|
+
throw Object.assign(new Error(`TaskSpec.language ${why} — refused rather than ignored: a declared reply language the engine did not state would run as none.`), { code: "config.language_invalid" });
|
|
19
|
+
};
|
|
20
|
+
if (typeof seat !== "string" || seat.trim() === "")
|
|
21
|
+
return refuse(`must be a non-empty string (got ${describeRejectedValue(seat)})`);
|
|
22
|
+
if (seat.length > LANGUAGE_MAX)
|
|
23
|
+
return refuse(`is ${seat.length} characters, over the ${LANGUAGE_MAX}-character bound`);
|
|
24
|
+
return seat;
|
|
25
|
+
}
|
|
26
|
+
export function languageFrame(told, declared) {
|
|
27
|
+
if (declared !== undefined)
|
|
28
|
+
return told === declared ? undefined : { body: renderLanguageInstructions(declared), value: declared };
|
|
29
|
+
return typeof told === "string" ? { body: LANGUAGE_CLEARED, value: null } : undefined;
|
|
30
|
+
}
|
|
31
|
+
export async function prepareLanguageSeat(input) {
|
|
32
|
+
if (!input.personAgent || (input.declared === undefined && input.told === undefined))
|
|
33
|
+
return undefined;
|
|
34
|
+
const segment = await input.session.getBranch().then(conversationSegmentOf, () => undefined);
|
|
35
|
+
const told = input.told;
|
|
36
|
+
const inSegment = told !== undefined && (segment === undefined ? input.declared === undefined : told.segment === segment);
|
|
37
|
+
const owed = languageFrame(inSegment ? told.value : undefined, input.declared);
|
|
38
|
+
return owed === undefined && input.declared === undefined ? undefined : { ...(owed !== undefined ? { owed } : {}), segment, declared: input.declared };
|
|
39
|
+
}
|
|
40
|
+
export function languageFrameText(prepared) {
|
|
41
|
+
const owed = prepared.languageSeat?.owed;
|
|
42
|
+
return owed === undefined ? undefined : mintSystemReminder(owed.body, prepared.reminderMark);
|
|
43
|
+
}
|
|
44
|
+
export function registerLanguageReceipt(prepared, text) {
|
|
45
|
+
if (prepared.languageSeat?.owed !== undefined)
|
|
46
|
+
prepared.frameReceipts.pending.push({ source: "language", text, commit: () => settleLanguage(prepared) });
|
|
47
|
+
}
|
|
48
|
+
function settleLanguage(prepared) {
|
|
49
|
+
const seat = prepared.languageSeat;
|
|
50
|
+
const owed = seat?.owed;
|
|
51
|
+
if (seat === undefined || owed === undefined)
|
|
52
|
+
return;
|
|
53
|
+
seat.owed = undefined;
|
|
54
|
+
recordLanguage(prepared.announcedListingsRef, prepared.frameReceipts, owed.value, seat.segment);
|
|
55
|
+
}
|
|
56
|
+
function recordLanguage(ref, ledger, value, segment) {
|
|
57
|
+
if (segment === undefined)
|
|
58
|
+
return;
|
|
59
|
+
ref.language = { value, segment };
|
|
60
|
+
ledger.listingSnapshotOwed = true;
|
|
61
|
+
}
|
|
62
|
+
export function languageRestateOption(prepared) {
|
|
63
|
+
const seat = prepared.languageSeat;
|
|
64
|
+
const declared = seat?.declared;
|
|
65
|
+
if (seat === undefined || declared === undefined)
|
|
66
|
+
return {};
|
|
67
|
+
return {
|
|
68
|
+
languageRestate: () => restateToldSeat(prepared, seat, {
|
|
69
|
+
body: renderLanguageInstructions(declared),
|
|
70
|
+
value: declared,
|
|
71
|
+
what: "the language preference",
|
|
72
|
+
carried: seat.owed !== undefined,
|
|
73
|
+
record: (value, segment) => recordLanguage(prepared.announcedListingsRef, prepared.frameReceipts, value, segment),
|
|
74
|
+
}),
|
|
75
|
+
};
|
|
76
|
+
}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The DRAINED-LEG FRAME SEAT (`RunInternals.onLegFrame`): the one seat a host reads a leg's own frames through when the
|
|
3
|
+
* engine drains that leg's stream itself, the closed set of frames it carries, the address each frame is handed with, and
|
|
4
|
+
* the door both stream entries pass it through.
|
|
5
|
+
*
|
|
6
|
+
* WHICH LEGS. A leg is DRAINED when it was entered through `Runner.runTask` or `Runner.resume`: the engine iterates the
|
|
7
|
+
* leg's stream for the caller, so the caller holds no `TaskStream` and the leg's frames reach it only through this seat
|
|
8
|
+
* (the composition entries — the verify gate, the cascade — dispatch every leg that way). On `Runner.runTaskStream` /
|
|
9
|
+
* `Runner.resumeStream` the caller holds the stream and the same frames ride it, so the seat is REFUSED there
|
|
10
|
+
* (`config.invalid_argument`) rather than delivering every frame twice. The fact "this leg is drained" is the engine's
|
|
11
|
+
* own: the two draining entries mark the exact internals object they hand on, the door takes the mark (once — it is
|
|
12
|
+
* gone after the door reads it), and nothing else in the engine decides it. A copy of the object carries no mark; a
|
|
13
|
+
* bag the engine builds for a child or a workflow leg never carries the seat.
|
|
14
|
+
*
|
|
15
|
+
* WHAT. One frame object per offer, the very object the leg's queue received, shallow-frozen before the push; offered
|
|
16
|
+
* only when the queue accepted it (a closed stream refuses a late frame, and so does the seat). `at` names the leg the
|
|
17
|
+
* frame came from: its task id and the session its rows land in (engine facts), and the composition's label when the
|
|
18
|
+
* dispatcher bound one (`leg`, absent = nobody labelled this leg; the engine never mints one).
|
|
19
|
+
*/
|
|
20
|
+
import type { TaskEvent } from "../types.js";
|
|
21
|
+
/** The frames a drained leg offers to `RunInternals.onLegFrame` — closed: a frame type outside it never reaches the seat. */
|
|
22
|
+
export declare const DRAINED_LEG_FRAME_TYPES: readonly ["status", "wiring_manifest", "message_committed", "workspace_changed"];
|
|
23
|
+
/** One frame the seat receives: a `TaskEvent` of one of {@link DRAINED_LEG_FRAME_TYPES}, the object the leg's stream carries. */
|
|
24
|
+
export type DrainedLegFrame = Readonly<Extract<TaskEvent, {
|
|
25
|
+
type: (typeof DRAINED_LEG_FRAME_TYPES)[number];
|
|
26
|
+
}>>;
|
|
27
|
+
/** The kinds of leg a composition labels: the verify gate's implementation / verifier / fix legs and a cascade's rungs. */
|
|
28
|
+
export declare const LEG_LABEL_KINDS: readonly ["impl", "verifier", "fix", "rung"];
|
|
29
|
+
/**
|
|
30
|
+
* A composition's label for the leg it dispatched. `round` is the gate's verification round for `impl` (0, the round
|
|
31
|
+
* before the first), `verifier` (the round it verifies) and `fix` (the round whose findings it answers); for `rung` it is
|
|
32
|
+
* the rung's place on the ladder, from 0. Minted by the dispatcher, frozen, never by the engine.
|
|
33
|
+
*/
|
|
34
|
+
export interface LegLabel {
|
|
35
|
+
readonly kind: (typeof LEG_LABEL_KINDS)[number];
|
|
36
|
+
readonly round: number;
|
|
37
|
+
}
|
|
38
|
+
/** Where a frame handed to `RunInternals.onLegFrame` came from. */
|
|
39
|
+
export interface LegAt {
|
|
40
|
+
/** The leg's task id (`TaskResult.taskId` of that leg). */
|
|
41
|
+
readonly taskId: string;
|
|
42
|
+
/** The session the leg's rows land in. */
|
|
43
|
+
readonly sessionId: string;
|
|
44
|
+
/** The composition's label for the leg; absent = nobody labelled it. */
|
|
45
|
+
readonly leg?: LegLabel;
|
|
46
|
+
}
|
|
47
|
+
/** The run's one push of a frame of {@link DRAINED_LEG_FRAME_TYPES}: freeze, push, and offer it to the seat when the queue
|
|
48
|
+
* accepted it. Answers whether the queue accepted it. */
|
|
49
|
+
export type LegFrameOffer = (frame: DrainedLegFrame) => boolean;
|
|
50
|
+
/** A draining entry marks the internals object it is about to hand to the stream entry, immediately before the call. */
|
|
51
|
+
export declare function markDrainedLeg(internals: object | undefined): void;
|
|
52
|
+
/** …and clears it when that call returns or throws, so a mark the door did not take never outlives the call. */
|
|
53
|
+
export declare function forgetDrainedLeg(internals: object | undefined): void;
|
|
54
|
+
/** The stream entry a draining entry hands its leg to: the door's `entry` word. */
|
|
55
|
+
export type LegFrameEntry = "runTaskStream" | "resumeStream";
|
|
56
|
+
/**
|
|
57
|
+
* The ONE read of a caller's `RunInternals` bag: a shallow copy of its own enumerable members (an inherited or non-enumerable member is
|
|
58
|
+
* not read; an accessor is read here, once), fenced ({@link fenced}) — a bag whose read throws is refused by name, `config.invalid_argument`.
|
|
59
|
+
* The door reads the bag through it at both stream entries, and the resume's config judge reads a host's question through it, so the bag a
|
|
60
|
+
* question is judged over is the bag the door hands the leg. Module-internal: not a root export.
|
|
61
|
+
*/
|
|
62
|
+
export declare function readLegInternals<T extends object>(internals: T, entry: LegFrameEntry): T;
|
|
63
|
+
/**
|
|
64
|
+
* The seat's refusal when the caller's object answers one the door's copy cannot hold ({@link seatOutsideCopy}): the ONE judgment of a
|
|
65
|
+
* hidden seat, read by the door at both stream entries and by every composition that dispatches its legs through a copy of the caller's
|
|
66
|
+
* bag (the verify gate, the cascade — `withLegIdentity`), so a seat refused by `Runner.runTask` is refused by a composition alike, and
|
|
67
|
+
* the lookup that finds it is fenced once, here.
|
|
68
|
+
*/
|
|
69
|
+
export declare function refuseHiddenLegFrameSeat(bag: object, entry: LegFrameEntry): void;
|
|
70
|
+
/**
|
|
71
|
+
* The door every leg passes at its stream entry (`Runner.runTaskStream` before prepare, `Runner.resumeStream` at the
|
|
72
|
+
* admission's head, before anything is read or claimed). Takes the drained mark off the caller's object — once, whatever
|
|
73
|
+
* follows — and refuses a retired seat by name (`config.deps_retired_key`, read off the caller's object as every
|
|
74
|
+
* retired-key door reads, row by row so a lookup that throws is refused by that row's name). Then it reads the bag ONCE — a
|
|
75
|
+
* shallow copy of its own enumerable members, the copy the leg goes on with — and judges the seat on that copy: a seat that is
|
|
76
|
+
* not a function, a seat the copy cannot hold (a prototype's or a non-enumerable one, {@link refuseHiddenLegFrameSeat}), and
|
|
77
|
+
* the seat on a leg the engine does not drain, are refused (`config.invalid_argument`). Every read of the caller's bag here is
|
|
78
|
+
* fenced ({@link fenced}). Answers the copy, so the seat the door judged is the seat the leg offers its frames to: a member that
|
|
79
|
+
* answers the door one value and the leg another cannot pass unjudged.
|
|
80
|
+
*/
|
|
81
|
+
export declare function admitLegFrameSeat<T extends object>(internals: T | undefined, entry: LegFrameEntry): T | undefined;
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { retiredKeyOf, retiredKeyRefusal } from "../retired-keys.js";
|
|
2
|
+
import { boundedThrownName } from "../thrown-value.js";
|
|
3
|
+
export const DRAINED_LEG_FRAME_TYPES = Object.freeze(["status", "wiring_manifest", "message_committed", "workspace_changed"]);
|
|
4
|
+
export const LEG_LABEL_KINDS = Object.freeze(["impl", "verifier", "fix", "rung"]);
|
|
5
|
+
const drained = new WeakSet();
|
|
6
|
+
export function markDrainedLeg(internals) {
|
|
7
|
+
if (internals !== undefined)
|
|
8
|
+
drained.add(internals);
|
|
9
|
+
}
|
|
10
|
+
export function forgetDrainedLeg(internals) {
|
|
11
|
+
if (internals !== undefined)
|
|
12
|
+
drained.delete(internals);
|
|
13
|
+
}
|
|
14
|
+
const RETIRED_RUN_INTERNALS_KEYS = Object.freeze({
|
|
15
|
+
onStatusEvent: 'a drained leg\'s frames reach one seat now — `RunInternals.onLegFrame(frame, at)`; read `frame.type === "status"` for what this seat was handed (the same frame object)',
|
|
16
|
+
onWiringManifest: 'a drained leg\'s frames reach one seat now — `RunInternals.onLegFrame(frame, at)`; read `frame.type === "wiring_manifest"` and `frame.manifest` for what this seat was handed, `at.leg` for the composition\'s label it took as its second argument',
|
|
17
|
+
});
|
|
18
|
+
function seatOutsideCopy(bag, name) {
|
|
19
|
+
if (Reflect.getOwnPropertyDescriptor(bag, name)?.enumerable === true)
|
|
20
|
+
return false;
|
|
21
|
+
return Reflect.get(bag, name) !== undefined;
|
|
22
|
+
}
|
|
23
|
+
function untouched(entry) {
|
|
24
|
+
return `Nothing was read or started${entry === "resumeStream" ? " (the checkpoint was not read or claimed: it is still pending)" : ""}`;
|
|
25
|
+
}
|
|
26
|
+
function fenced(read, field, what, entry) {
|
|
27
|
+
try {
|
|
28
|
+
return read();
|
|
29
|
+
}
|
|
30
|
+
catch (cause) {
|
|
31
|
+
const thrown = boundedThrownName(cause);
|
|
32
|
+
throw Object.assign(new Error(`${what} could not be read: the read threw ${thrown} — a bag whose read throws is refused rather than ignored or let out as the host's own error. ${untouched(entry)} — hand in a plain bag whose members read without throwing.`), { code: "config.invalid_argument", detail: { field, entry, thrownName: thrown } });
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
export function readLegInternals(internals, entry) {
|
|
36
|
+
return fenced(() => ({ ...internals }), "RunInternals", "RunInternals", entry);
|
|
37
|
+
}
|
|
38
|
+
export function refuseHiddenLegFrameSeat(bag, entry) {
|
|
39
|
+
if (!fenced(() => seatOutsideCopy(bag, "onLegFrame"), "onLegFrame", "RunInternals.onLegFrame", entry))
|
|
40
|
+
return;
|
|
41
|
+
throw Object.assign(new Error(`RunInternals.onLegFrame: seat must be an own enumerable member of the bag you hand in — this bag answers one from its prototype or as a non-enumerable property, and the leg reads its own enumerable members only, so a seat it cannot read would hear nothing; refused rather than ignored. ${untouched(entry)} — write the seat as a plain member of the bag.`), { code: "config.invalid_argument", detail: { field: "onLegFrame", entry } });
|
|
42
|
+
}
|
|
43
|
+
export function admitLegFrameSeat(internals, entry) {
|
|
44
|
+
if (internals === undefined)
|
|
45
|
+
return undefined;
|
|
46
|
+
const isDrained = drained.delete(internals);
|
|
47
|
+
for (const [key, replacement] of Object.entries(RETIRED_RUN_INTERNALS_KEYS)) {
|
|
48
|
+
const hit = fenced(() => retiredKeyOf(internals, { [key]: replacement }), key, `RunInternals.${key}`, entry);
|
|
49
|
+
if (hit !== undefined)
|
|
50
|
+
throw retiredKeyRefusal(hit, "RunInternals");
|
|
51
|
+
}
|
|
52
|
+
const read = readLegInternals(internals, entry);
|
|
53
|
+
const seat = read.onLegFrame;
|
|
54
|
+
if (seat === undefined) {
|
|
55
|
+
refuseHiddenLegFrameSeat(internals, entry);
|
|
56
|
+
return read;
|
|
57
|
+
}
|
|
58
|
+
if (typeof seat !== "function") {
|
|
59
|
+
throw Object.assign(new Error(`RunInternals.onLegFrame must be a function (got ${seat === null ? "null" : typeof seat}) — a seat the engine cannot call is refused rather than ignored`), {
|
|
60
|
+
code: "config.invalid_argument",
|
|
61
|
+
detail: { field: "onLegFrame", entry },
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
if (!isDrained) {
|
|
65
|
+
throw Object.assign(new Error(`RunInternals.onLegFrame is refused on Runner.${entry}: the seat carries the frames of a leg the engine drains itself (Runner.runTask / Runner.resume), and this entry hands you the leg's stream, where the same frames ride. ${untouched(entry)} — drop the seat here and read the stream, or enter through ${entry === "runTaskStream" ? "Runner.runTask" : "Runner.resume"}.`), { code: "config.invalid_argument", detail: { field: "onLegFrame", entry } });
|
|
66
|
+
}
|
|
67
|
+
return read;
|
|
68
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The run's usage account for the MAIN loop's model calls: one function books one call at the model that made it, and the
|
|
3
|
+
* hops a fallback walk left behind are booked through it before the answer. The model calls made beside the main loop book
|
|
4
|
+
* through `side-call-account.ts` instead; both price a bill the same way (`RunState.degrade.priceOf`), and both fold a call's
|
|
5
|
+
* cache members through the one cache account (`cache-hit-account.ts`).
|
|
6
|
+
*/
|
|
7
|
+
import type { Model, Usage } from "../../internal/llm.js";
|
|
8
|
+
import type { ServedReading } from "../../brain/model-lane.js";
|
|
9
|
+
import type { Stats } from "./assemble-result.js";
|
|
10
|
+
import { type CacheMemberMarks } from "./cache-hit-account.js";
|
|
11
|
+
import type { RunState } from "./contracts.js";
|
|
12
|
+
/** One main-loop call as the account booked it. `turnTotal` is the CACHE-INCLUSIVE prompt total (billing + window/budget
|
|
13
|
+
* denominator); `turnUncached` is the protocol-shaped miss count the `promptTokens` / `inputTokens` faces carry; `priced` = the
|
|
14
|
+
* model has a price table (`false` ⇒ the cost is a fabricated 0 and the disclosure faces omit it). */
|
|
15
|
+
export interface BookedCall {
|
|
16
|
+
readonly turnTotal: number;
|
|
17
|
+
readonly turnUncached: number;
|
|
18
|
+
readonly turnCostMicroUsd: number;
|
|
19
|
+
readonly priced: boolean;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Book one main-loop call of `usage` at `model`: re-priced in core from the injected pricing (the brain's own cost total charges
|
|
23
|
+
* cached tokens at full price for OpenAI / DeepSeek), into the leg's stats and the upcoming `turn_end` usage (a turn may make
|
|
24
|
+
* more than one call). Integer micro-USD, summed per call, so a mid-task model or price change is accounted correctly.
|
|
25
|
+
* `usageMissing` = the call's usage is a lower bound (the caller marks the turn and the leg; the cache account leaves the main
|
|
26
|
+
* lane out of the hit rate). A cache member the call did not report marks the turn's frame as it marks the leg's stats.
|
|
27
|
+
*/
|
|
28
|
+
export declare function bookMainCall(rs: RunState, stats: Stats, model: Model, usage: Usage, usageMissing: boolean): BookedCall;
|
|
29
|
+
/** Carry one booking's cache marks onto the upcoming `turn_end` (the harness-handlers lane also calls it for a turn that booked no
|
|
30
|
+
* call at all). */
|
|
31
|
+
export declare function noteTurnCacheMarks(rs: RunState, marks: CacheMemberMarks): void;
|
|
32
|
+
/** Book the requests an answer left behind (the lane's hops, the failover decorator's gateways; none for an answer that lists none): each
|
|
33
|
+
* its own bill at its own model and its own `brain.call` row (latency not modeled, as on a side call); a hop whose usage is a lower bound marks the turn and the leg. */
|
|
34
|
+
export declare function bookLeftHops(rs: RunState, stats: Stats, reading: ServedReading | undefined): void;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { emitTrace } from "../trace.js";
|
|
2
|
+
import { bookCacheOperands, cacheTraceMembersOf } from "./cache-hit-account.js";
|
|
3
|
+
import { usageCostMicroUsd } from "./usage-accounting.js";
|
|
4
|
+
export function bookMainCall(rs, stats, model, usage, usageMissing) {
|
|
5
|
+
const price = rs.degrade.priceOf(model);
|
|
6
|
+
const { totalInputTokens: turnTotal, uncachedInputTokens: turnUncached, costMicroUsd: turnCostMicroUsd } = usageCostMicroUsd(price.cacheFamily, usage, price.pricing);
|
|
7
|
+
if (!price.pricingConfigured)
|
|
8
|
+
rs.telemetry.unpricedSpend = true;
|
|
9
|
+
stats.tokens += usage.totalTokens || 0;
|
|
10
|
+
stats.promptTokens += turnUncached;
|
|
11
|
+
stats.totalInputTokens += turnTotal;
|
|
12
|
+
stats.cachedTokens += usage.cacheRead ?? 0;
|
|
13
|
+
stats.cacheWriteTokens += usage.cacheWrite ?? 0;
|
|
14
|
+
stats.cacheWriteTokensLong += usage.cacheWriteLong ?? 0;
|
|
15
|
+
stats.outputTokens += usage.output || 0;
|
|
16
|
+
stats.costMicroUsd += turnCostMicroUsd;
|
|
17
|
+
const marks = bookCacheOperands(stats, "main", { family: price.cacheFamily, usage }, usageMissing, turnTotal);
|
|
18
|
+
rs.turn.turnUsage ??= { inputTokens: 0, totalInputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, costMicroUsd: 0 };
|
|
19
|
+
rs.turn.turnUsage.inputTokens += turnUncached;
|
|
20
|
+
rs.turn.turnUsage.totalInputTokens += turnTotal;
|
|
21
|
+
rs.turn.turnUsage.outputTokens += usage.output || 0;
|
|
22
|
+
rs.turn.turnUsage.cacheReadTokens += usage.cacheRead ?? 0;
|
|
23
|
+
rs.turn.turnUsage.cacheWriteTokens += usage.cacheWrite ?? 0;
|
|
24
|
+
rs.turn.turnUsage.costMicroUsd += turnCostMicroUsd;
|
|
25
|
+
noteTurnCacheMarks(rs, marks);
|
|
26
|
+
return { turnTotal, turnUncached, turnCostMicroUsd, priced: price.pricingConfigured };
|
|
27
|
+
}
|
|
28
|
+
export function noteTurnCacheMarks(rs, marks) {
|
|
29
|
+
if (marks.readUnreported)
|
|
30
|
+
rs.turn.turnCacheMarks.cacheReadUnreported = true;
|
|
31
|
+
if (marks.writeUnreported)
|
|
32
|
+
rs.turn.turnCacheMarks.cacheWriteUnreported = true;
|
|
33
|
+
if (marks.totalLowerBound)
|
|
34
|
+
rs.turn.turnUsageMissing = true;
|
|
35
|
+
}
|
|
36
|
+
export function bookLeftHops(rs, stats, reading) {
|
|
37
|
+
for (const attempt of reading?.attempts ?? []) {
|
|
38
|
+
if (attempt.usageMissing === true) {
|
|
39
|
+
rs.turn.turnUsageMissing = true;
|
|
40
|
+
stats.usageMissing = true;
|
|
41
|
+
}
|
|
42
|
+
const billed = bookMainCall(rs, stats, attempt.model, attempt.usage, attempt.usageMissing === true);
|
|
43
|
+
emitTrace(rs.telemetry.tracer, () => ({
|
|
44
|
+
kind: "brain.call", version: 1, taskId: rs.telemetry.taskId, model: attempt.model.id, provider: attempt.model.provider, turn: stats.turns + 1,
|
|
45
|
+
promptTokens: billed.turnUncached, totalInputTokens: billed.turnTotal, completionTokens: attempt.usage.output || 0,
|
|
46
|
+
...cacheTraceMembersOf(attempt.usage), latencyMs: 0,
|
|
47
|
+
...(billed.priced ? { costMicroUsd: billed.turnCostMicroUsd } : {}), ts: Date.now(),
|
|
48
|
+
}));
|
|
49
|
+
}
|
|
50
|
+
}
|
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Two faces change a task's MCP roster after prepare has finished — the model's `RefreshMcpTools`
|
|
6
6
|
* tool and the run handle's `reconnectMcpServer` verb — and what they must do to the roster is the
|
|
7
|
-
* same list in the same order: drop the deployment-excluded names, re-fold the safety axes
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* same list in the same order: drop the deployment-excluded names, re-fold the safety axes, replace the
|
|
8
|
+
* server's whole name-prefix domain at its own anchor (a listing the fold or the roster's entry bound
|
|
9
|
+
* refuses withdraws the domain instead), rebuild the harness toolset, and re-mint the roster delta. That list lived inside the
|
|
10
10
|
* refresh tool's execute closure, where the second face could only have copied it; a copy would have
|
|
11
11
|
* been a second answer to "what does a mid-task roster change consist of".
|
|
12
12
|
*
|
|
@@ -75,15 +75,17 @@ export interface McpRosterReading {
|
|
|
75
75
|
/** The names the server listed that the roster did not take (the valve's, the overlay's). */
|
|
76
76
|
excluded: string[];
|
|
77
77
|
}
|
|
78
|
-
/** What one application did, for the caller's receipt. `applied:false` means the axis fold
|
|
79
|
-
*
|
|
78
|
+
/** What one application did, for the caller's receipt. `applied:false` means the listing was REFUSED — the axis fold found a
|
|
79
|
+
* contradiction, or the swap would have put the roster over its entry bound — and the server's domain was withdrawn: the refused
|
|
80
|
+
* listing lands as the empty one (`mounted` is `[]`, `removed` every name the domain held), the reading a failed dial gives.
|
|
81
|
+
* `refusal` is the sentence why. */
|
|
80
82
|
export type McpRosterApplyOutcome = ({
|
|
81
83
|
applied: true;
|
|
82
84
|
} & McpRosterReading) | ({
|
|
83
85
|
applied: false;
|
|
84
|
-
|
|
86
|
+
refusal: string;
|
|
85
87
|
} & McpRosterReading);
|
|
86
|
-
/** What the roster holds of one server with no swap made — the reading of an arm that asserted no roster (a failed refresh, a refused re-dial
|
|
88
|
+
/** What the roster holds of one server with no swap made — the reading of an arm that asserted no roster (a failed refresh, a refused re-dial).
|
|
87
89
|
* A name no server is declared under holds nothing, even when it mints a declared server's prefix. */
|
|
88
90
|
export declare function rosterHolding(input: Pick<McpRosterApplyInput, "roster" | "declared">, serverName: string): McpRosterReading;
|
|
89
91
|
/** A refresh or re-dial result read off the roster instead of the server's own listing: `toolCount` is the tools mounted, `added` /
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { valveLeaves } from "../../agents/tool-filter.js";
|
|
2
|
-
import { instructionsTaught,
|
|
2
|
+
import { instructionsTaught, tellInstructions, toolNamesOfServer, withdrawInstructionAdds } from "../mounted-mcp.js";
|
|
3
3
|
import { deliverEngineNotice } from "../types.js";
|
|
4
4
|
import { thrownText } from "../thrown-value.js";
|
|
5
5
|
export function rosterHolding(input, serverName) {
|
|
@@ -16,7 +16,7 @@ export function settledOnRoster(result, reading, roster) {
|
|
|
16
16
|
function settleInstructions(lane, delta, taught) {
|
|
17
17
|
if (!taught)
|
|
18
18
|
return withdrawInstructionAdds(lane, delta.server);
|
|
19
|
-
if (delta.instructions !== undefined
|
|
19
|
+
if (delta.instructions !== undefined)
|
|
20
20
|
tellInstructions(lane, delta.instructions);
|
|
21
21
|
}
|
|
22
22
|
export function applyMcpRosterDelta(input, delta) {
|
|
@@ -26,35 +26,34 @@ export function applyMcpRosterDelta(input, delta) {
|
|
|
26
26
|
const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
|
|
27
27
|
const pushable = delta.tools.filter(leaves);
|
|
28
28
|
const valveExcluded = delta.tools.filter((t) => !leaves(t)).map((t) => t.name);
|
|
29
|
-
const
|
|
30
|
-
const restoreDomain = (m, snap) => {
|
|
29
|
+
const clearDomain = (m) => {
|
|
31
30
|
for (const name of [...m.keys()])
|
|
32
31
|
if (name.startsWith(delta.prefix))
|
|
33
32
|
m.delete(name);
|
|
34
|
-
for (const [name, v] of snap)
|
|
35
|
-
m.set(name, v);
|
|
36
33
|
};
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
for (const name of priorDomainNegatives.keys())
|
|
42
|
-
axisExplicitNegatives.delete(name);
|
|
34
|
+
clearDomain(toolEffects);
|
|
35
|
+
clearDomain(axisExplicitNegatives);
|
|
36
|
+
const meta = { source: "mcp", mountedBy: "optional", origin: { peer: delta.server } };
|
|
37
|
+
let refusal;
|
|
43
38
|
try {
|
|
44
39
|
foldProtocolAxes(delta.axes.filter((a) => !valveExcluded.includes(a.name)), "MCP");
|
|
40
|
+
roster.replaceDomain(delta.prefix, withFaces(pushable, delta.server).map((t) => remoteToolOffload(t)), meta);
|
|
45
41
|
}
|
|
46
|
-
catch (
|
|
47
|
-
|
|
48
|
-
restoreDomain(axisExplicitNegatives, priorDomainNegatives);
|
|
49
|
-
settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools, delta.tools));
|
|
50
|
-
return { applied: false, foldError: thrownText(foldErr), ...rosterHolding(input, delta.server) };
|
|
42
|
+
catch (refused) {
|
|
43
|
+
refusal = thrownText(refused);
|
|
51
44
|
}
|
|
52
|
-
|
|
45
|
+
if (refusal !== undefined) {
|
|
46
|
+
clearDomain(toolEffects);
|
|
47
|
+
clearDomain(axisExplicitNegatives);
|
|
48
|
+
roster.replaceDomain(delta.prefix, [], meta);
|
|
49
|
+
}
|
|
50
|
+
const listed = refusal === undefined ? delta.tools : [];
|
|
53
51
|
const mounted = domainNow();
|
|
54
52
|
const heldNow = new Set(mounted);
|
|
55
53
|
const heldBefore = new Set(before);
|
|
56
|
-
settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools,
|
|
57
|
-
|
|
54
|
+
settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools, listed));
|
|
55
|
+
const reading = { mounted, added: mounted.filter((n) => !heldBefore.has(n)), removed: before.filter((n) => !heldNow.has(n)), excluded: listed.map((t) => t.name).filter((n) => !heldNow.has(n)) };
|
|
56
|
+
return refusal === undefined ? { applied: true, ...reading } : { applied: false, refusal, ...reading };
|
|
58
57
|
}
|
|
59
58
|
export async function commitMcpRosterChanges(input) {
|
|
60
59
|
await input.rebuildHarnessToolsRef.current?.();
|
|
@@ -71,7 +70,7 @@ export async function redialMcpServer(input, server) {
|
|
|
71
70
|
const outcome = applyMcpRosterDelta(input, { server: listed.server, prefix: listed.prefix, tools: listed.tools, axes: listed.axes ?? [], dropped: listed.dropped ?? [] });
|
|
72
71
|
result = settledOnRoster(listed, outcome, input.roster);
|
|
73
72
|
if (!outcome.applied)
|
|
74
|
-
input.deps.onError?.(Object.assign(new Error(`MCP re-dial of "${server}" connected but its
|
|
73
|
+
input.deps.onError?.(Object.assign(new Error(`MCP re-dial of "${server}" connected but its tool listing was refused, so none of its tools are mounted: ${outcome.refusal}`), { code: "mcp.server_unavailable" }), { phase: "mcp", sessionId: input.sessionId });
|
|
75
74
|
const ungated = await commitMcpRosterChanges(input);
|
|
76
75
|
if (ungated !== undefined)
|
|
77
76
|
input.deps.onError?.(Object.assign(new Error(ungated), { code: "mcp.server_unavailable" }), { phase: "mcp", sessionId: input.sessionId });
|
|
@@ -22,6 +22,8 @@ import type { EngineNotice } from "../engine-notice.js";
|
|
|
22
22
|
/** The slice of `RunnerDeps` this resolver reads (pass the deps object itself). */
|
|
23
23
|
export interface MemoryConsolidationDriverDeps {
|
|
24
24
|
brain: Brain;
|
|
25
|
+
modelFallback?: unknown;
|
|
26
|
+
cacheRetention?: unknown;
|
|
25
27
|
models?: Record<string, Model>;
|
|
26
28
|
tiers?: Record<string, ModelRef>;
|
|
27
29
|
roles?: ModelRoles;
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
+
import { describeRejectedValue } from "../tool-search-setting.js";
|
|
1
2
|
import { brainToRuntime } from "../runtime.js";
|
|
3
|
+
import { modelLaneBrainOf } from "./model-lane-seat.js";
|
|
2
4
|
import { catalogOfDeps, resolveTaskModel, roleModelIfSet, unheldChainRefusal } from "../roles.js";
|
|
3
5
|
import { isAliasModelId, openAiCompatChatSeat } from "../memory-engine/distiller.js";
|
|
4
6
|
import { runMemoryConsolidationDriver } from "../memory-engine/consolidation-driver.js";
|
|
@@ -20,7 +22,7 @@ export function resolveMemoryConsolidationDriver(deps) {
|
|
|
20
22
|
let model;
|
|
21
23
|
if (typeof seat?.chat === "function") {
|
|
22
24
|
if (typeof seat.model !== "string" || seat.model.trim() === "" || isAliasModelId(seat.model)) {
|
|
23
|
-
throw seatRefusal(`memoryConsolidationDriver.chat is a bare function, so memoryConsolidationDriver.model must carry the EXPLICIT model id it serves (got ${
|
|
25
|
+
throw seatRefusal(`memoryConsolidationDriver.chat is a bare function, so memoryConsolidationDriver.model must carry the EXPLICIT model id it serves (got ${describeRejectedValue(seat.model)}).`);
|
|
24
26
|
}
|
|
25
27
|
chat = seat.chat;
|
|
26
28
|
model = seat.model;
|
|
@@ -39,7 +41,7 @@ export function resolveMemoryConsolidationDriver(deps) {
|
|
|
39
41
|
throw seatRefusal(`the resolved consolidation model id ${JSON.stringify(resolved.id)} is an alias spelling — an alias can be re-pointed upstream and would move the run with no trace in the archive; bind an explicit id.`);
|
|
40
42
|
}
|
|
41
43
|
model = resolved.id;
|
|
42
|
-
const runtime = brainToRuntime(deps
|
|
44
|
+
const runtime = brainToRuntime(modelLaneBrainOf(deps));
|
|
43
45
|
chat = async (req) => {
|
|
44
46
|
const auth = await deps.getApiKeyAndHeaders?.(resolved);
|
|
45
47
|
const message = await runtime.completeSimple(resolved, { systemPrompt: req.system, messages: [{ role: "user", content: req.user, timestamp: Date.now() }] }, { temperature: req.temperature, maxTokens: req.maxTokens, reasoning: resolveTaskModel({ model: resolved }, {}).thinking, apiKey: auth?.apiKey, headers: auth?.headers });
|
|
@@ -111,7 +113,7 @@ export function assertAutoConsolidationWirable(deps) {
|
|
|
111
113
|
if (raw === undefined)
|
|
112
114
|
return;
|
|
113
115
|
if (typeof raw !== "boolean") {
|
|
114
|
-
throw autoRunRefusal(`RunnerDeps.autoRunOnRecommendation must be a boolean when present (got ${
|
|
116
|
+
throw autoRunRefusal(`RunnerDeps.autoRunOnRecommendation must be a boolean when present (got ${describeRejectedValue(raw)}) — a non-boolean would silently read as off, arming or disarming whole-library egress by accident.`);
|
|
115
117
|
}
|
|
116
118
|
if (raw !== true)
|
|
117
119
|
return;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "../engine-notice.js";
|
|
2
|
+
export function createMessagesOmittedSeat(ids) {
|
|
3
|
+
let inStretch = false;
|
|
4
|
+
return (omitted) => {
|
|
5
|
+
if (omitted <= 0) {
|
|
6
|
+
inStretch = false;
|
|
7
|
+
return;
|
|
8
|
+
}
|
|
9
|
+
if (inStretch)
|
|
10
|
+
return;
|
|
11
|
+
inStretch = true;
|
|
12
|
+
const what = omitted === 1 ? "1 earlier message was" : `${omitted} earlier messages were`;
|
|
13
|
+
deliverEngineNotice(ids.onNotice, {
|
|
14
|
+
code: "context.messages_omitted",
|
|
15
|
+
message: `This conversation no longer fits what the model can read in one request, and compaction did not make it fit, so ${what} ` +
|
|
16
|
+
`left out of what the model sees (the oldest go first; the model is told that earlier messages were omitted). The session ` +
|
|
17
|
+
`still holds every message. Said once until a request fits again.`,
|
|
18
|
+
detail: { omitted, sessionId: ids.sessionId, runId: ids.runId },
|
|
19
|
+
});
|
|
20
|
+
};
|
|
21
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The leg's announcement of a walked model request — `model.fallback` (audience `user`): the requested model could not serve,
|
|
3
|
+
* and either a fallback model answered (`outcome: "served"`) or none could (`"exhausted"`). Read off the answer at the
|
|
4
|
+
* accounting points that read every answer (the main loop's, and the side-call lanes' book), so the lane that made the call
|
|
5
|
+
* is named: the marker for a walk that tried a hop, and the statement of a walk that sent none (every later hop's route refused
|
|
6
|
+
* before sending — `exhausted` with no hop tried, no `to`). Fires ONCE PER LEG PER (from, to, reason, outcome).
|
|
7
|
+
*/
|
|
8
|
+
import { type EngineNotice } from "../engine-notice.js";
|
|
9
|
+
import type { Model } from "../../internal/llm.js";
|
|
10
|
+
import type { ServedReading } from "../../brain/model-lane.js";
|
|
11
|
+
import type { UsageLane } from "./side-call-account.js";
|
|
12
|
+
/** Which call of the leg the request was: the lane it is booked on. */
|
|
13
|
+
export type ModelFallbackLane = UsageLane;
|
|
14
|
+
export interface ModelFallbackSeat {
|
|
15
|
+
/** Announce a walk on the answer to a request for `requested` on `lane`, unless this leg already announced the same walk. */
|
|
16
|
+
observe(lane: ModelFallbackLane, requested: Model, reading: ServedReading): void;
|
|
17
|
+
}
|
|
18
|
+
/** `alert` is the leg's operational alert for a walk that sent no hop on the main lane (a walk that tried one has its own, with the
|
|
19
|
+
* switch it records): told the announced sentence, once. */
|
|
20
|
+
export declare function createModelFallbackSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
|
|
21
|
+
sessionId: string;
|
|
22
|
+
runId?: string;
|
|
23
|
+
}, alert?: (sentence: string) => void): ModelFallbackSeat;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "../engine-notice.js";
|
|
2
|
+
function windowOf(model) {
|
|
3
|
+
const w = model?.contextWindow;
|
|
4
|
+
return typeof w === "number" && Number.isFinite(w) && w > 0 ? w : undefined;
|
|
5
|
+
}
|
|
6
|
+
const refusedListOf = (skipped) => skipped.map((s) => (s.code !== undefined ? `${s.model} (${s.code})` : s.model)).join(", ");
|
|
7
|
+
export function createModelFallbackSeat(onNotice, ids, alert) {
|
|
8
|
+
const announced = new Set();
|
|
9
|
+
const once = (key) => {
|
|
10
|
+
const k = key.join("\u0000");
|
|
11
|
+
if (announced.has(k))
|
|
12
|
+
return false;
|
|
13
|
+
announced.add(k);
|
|
14
|
+
return true;
|
|
15
|
+
};
|
|
16
|
+
const attribution = { sessionId: ids.sessionId, ...(ids.runId !== undefined ? { runId: ids.runId } : {}) };
|
|
17
|
+
return {
|
|
18
|
+
observe(lane, requested, reading) {
|
|
19
|
+
const fromWindow = windowOf(requested);
|
|
20
|
+
const d = reading.degraded;
|
|
21
|
+
if (d === undefined) {
|
|
22
|
+
const u = reading.unsent;
|
|
23
|
+
if (u === undefined || !once([u.from, "", u.reason, "unsent"]))
|
|
24
|
+
return;
|
|
25
|
+
const message = `${u.from} could not serve this request (${u.reason}); none of its fallbacks was sent — its route was refused before sending: ${refusedListOf(u.skipped)}; the request ended with ${u.from}'s own failure.`;
|
|
26
|
+
deliverEngineNotice(onNotice, {
|
|
27
|
+
code: "model.fallback",
|
|
28
|
+
message,
|
|
29
|
+
detail: { from: u.from, reason: u.reason, outcome: "exhausted", chain: [], skipped: u.skipped.map((s) => ({ ...s })), lane, ...(fromWindow !== undefined ? { fromWindow } : {}), ...attribution },
|
|
30
|
+
});
|
|
31
|
+
if (lane === "main")
|
|
32
|
+
alert?.(message);
|
|
33
|
+
return;
|
|
34
|
+
}
|
|
35
|
+
const outcome = d.outcome ?? "served";
|
|
36
|
+
if (!once([d.from, d.to, d.reason, outcome]))
|
|
37
|
+
return;
|
|
38
|
+
const to = outcome === "served" ? reading.served : undefined;
|
|
39
|
+
const toWindow = windowOf(to);
|
|
40
|
+
const smaller = fromWindow !== undefined && toWindow !== undefined && toWindow < fromWindow ? ` ${d.to} has a smaller context window (${toWindow} tokens; ${d.from} has ${fromWindow}).` : "";
|
|
41
|
+
const skipped = d.skipped ?? [];
|
|
42
|
+
const refused = skipped.length > 0 ? ` Not tried — its route was refused before sending: ${refusedListOf(skipped)}.` : "";
|
|
43
|
+
const message = outcome === "served"
|
|
44
|
+
? `${d.from} could not serve this request (${d.reason}); its fallback ${d.to} answered instead.${smaller}${refused}`
|
|
45
|
+
: `${d.from} could not serve this request (${d.reason}), and none of its fallbacks could (tried ${(d.chain ?? [d.to]).join(", ")}); the request ended with ${d.from}'s own failure.${refused}`;
|
|
46
|
+
deliverEngineNotice(onNotice, {
|
|
47
|
+
code: "model.fallback",
|
|
48
|
+
message,
|
|
49
|
+
detail: {
|
|
50
|
+
from: d.from,
|
|
51
|
+
to: d.to,
|
|
52
|
+
reason: d.reason,
|
|
53
|
+
outcome,
|
|
54
|
+
chain: [...(d.chain ?? [])],
|
|
55
|
+
...(skipped.length > 0 ? { skipped: skipped.map((s) => ({ ...s })) } : {}),
|
|
56
|
+
lane,
|
|
57
|
+
...(fromWindow !== undefined ? { fromWindow } : {}),
|
|
58
|
+
...(toWindow !== undefined ? { toWindow } : {}),
|
|
59
|
+
...attribution,
|
|
60
|
+
},
|
|
61
|
+
});
|
|
62
|
+
},
|
|
63
|
+
};
|
|
64
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { CacheRetention } from "../../internal/llm.js";
|
|
2
|
+
import type { Brain } from "../types.js";
|
|
3
|
+
/** The deployment's retention word as `field` carries it: absent ⇒ `undefined`, a word ⇒ the word, anything else refused
|
|
4
|
+
* (`config.invalid_argument`, `detail.field`) — the construction door's screen and every read of the Brain seat ask here. */
|
|
5
|
+
export declare function receiveCacheRetention(value: unknown, field: string): CacheRetention | undefined;
|
|
6
|
+
/** The model lane over a deps bag's Brain seat and its fallback policy (`RunnerDeps.modelFallback`; absent ⇒ the default gate),
|
|
7
|
+
* writing the bag's retention word (`RunnerDeps.cacheRetention`) on every call when it sets one. */
|
|
8
|
+
export declare function modelLaneBrainOf(deps: {
|
|
9
|
+
readonly brain: Brain;
|
|
10
|
+
readonly modelFallback?: unknown;
|
|
11
|
+
readonly cacheRetention?: unknown;
|
|
12
|
+
}): Brain;
|