@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/brain/anthropic.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import {} from "../internal/llm.js";
|
|
2
2
|
import { BrainError } from "./errors.js";
|
|
3
|
+
import { cacheRetentionDefect } from "./cache-retention.js";
|
|
3
4
|
import { startsWithInputTooLongAnchor } from "./input-too-long.js";
|
|
4
5
|
import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
|
|
5
6
|
import { NO_WORD, STREAM_TORN_WARNING, createRepetitionPoll, createStreamEndLedger, droppedFramesNote, endingInNoWord, endingWordOf, memberReader, modelOutputInvalidOf, noteResponseModel, nameMissingCause, parseStreamedToolArgs, placeTurnNotes, truncationCauseClause } from "./stream-shared.js";
|
|
@@ -11,10 +12,24 @@ import { admitRouteRequest, applyRouteCredentialHeaders, assertServableRequestRo
|
|
|
11
12
|
import { requestRouteOf } from "./request-route.js";
|
|
12
13
|
import { NAMES_AS_WRITTEN, judgeInBandError, resolveProviderDialect, endpointToolNames } from "./provider-dialect.js";
|
|
13
14
|
import { applyReasoningToRequest, mergeReasoningHeaders } from "./reasoning-request.js";
|
|
15
|
+
import { reasoningTokensOf } from "./usage-reasoning.js";
|
|
16
|
+
import { usageOfStatement } from "./usage-reading.js";
|
|
14
17
|
import { runStreamingBrain } from "./stream-engine.js";
|
|
15
18
|
import { refuseRetiredTimeoutKnobs } from "./timeout.js";
|
|
16
19
|
import { resolveFetch } from "./transport.js";
|
|
20
|
+
import { projectToolSchema } from "./tool-schema-projection.js";
|
|
17
21
|
const EPHEMERAL = { type: "ephemeral" };
|
|
22
|
+
const CACHE_CONTROL_OF_RETENTION = Object.freeze({
|
|
23
|
+
short: EPHEMERAL,
|
|
24
|
+
long: Object.freeze({ type: "ephemeral", ttl: "1h" }),
|
|
25
|
+
none: undefined,
|
|
26
|
+
});
|
|
27
|
+
function cacheControlFor(cacheBreakpoints, retention) {
|
|
28
|
+
const defect = cacheRetentionDefect(retention, "StreamOptions.cacheRetention");
|
|
29
|
+
if (defect !== undefined)
|
|
30
|
+
throw new BrainError("invalid_request", `config.invalid_argument: ${defect}`);
|
|
31
|
+
return cacheBreakpoints ? CACHE_CONTROL_OF_RETENTION[retention ?? "short"] : undefined;
|
|
32
|
+
}
|
|
18
33
|
const DOCUMENT_OMITTED_NO_VISION = "[PDF document omitted: the serving model does not support document input; extract the text via Bash instead (e.g. `pdftotext`).]";
|
|
19
34
|
function textOf(content) {
|
|
20
35
|
return typeof content === "string"
|
|
@@ -151,15 +166,15 @@ function toAnthropicMessages(ctx, model, toolNames) {
|
|
|
151
166
|
}
|
|
152
167
|
return merged;
|
|
153
168
|
}
|
|
154
|
-
function toAnthropicTools(ctx,
|
|
169
|
+
function toAnthropicTools(ctx, cacheControl, toolNames) {
|
|
155
170
|
if (!ctx.tools || ctx.tools.length === 0) {
|
|
156
171
|
return undefined;
|
|
157
172
|
}
|
|
158
173
|
return ctx.tools.map((t, i) => ({
|
|
159
174
|
name: toolNames.sent(t.name),
|
|
160
175
|
description: t.description,
|
|
161
|
-
input_schema: t.parameters,
|
|
162
|
-
...(
|
|
176
|
+
input_schema: projectToolSchema(t.parameters),
|
|
177
|
+
...(cacheControl !== undefined && i === ctx.tools.length - 1 ? { cache_control: cacheControl } : {}),
|
|
163
178
|
}));
|
|
164
179
|
}
|
|
165
180
|
const NO_CONTENT = "(no content)";
|
|
@@ -185,30 +200,17 @@ function anthropicStreamErrorCode(t) {
|
|
|
185
200
|
return "server";
|
|
186
201
|
}
|
|
187
202
|
}
|
|
188
|
-
function
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
input,
|
|
200
|
-
output,
|
|
201
|
-
cacheRead,
|
|
202
|
-
cacheWrite,
|
|
203
|
-
totalTokens: input + output + cacheRead + cacheWrite,
|
|
204
|
-
cost: {
|
|
205
|
-
input: costInput,
|
|
206
|
-
output: costOutput,
|
|
207
|
-
cacheRead: costCacheRead,
|
|
208
|
-
cacheWrite: costCacheWrite,
|
|
209
|
-
total: costInput + costOutput + costCacheRead + costCacheWrite,
|
|
210
|
-
},
|
|
211
|
-
};
|
|
203
|
+
function reasoningOf(u) {
|
|
204
|
+
return reasoningTokensOf(u.output_tokens ?? 0, u.thinking_tokens);
|
|
205
|
+
}
|
|
206
|
+
function reportedUsageOf(model, u) {
|
|
207
|
+
return usageOfStatement(model, "input-excludes-cached", {
|
|
208
|
+
input: u.input_tokens,
|
|
209
|
+
output: u.output_tokens,
|
|
210
|
+
cacheRead: u.cache_read_input_tokens,
|
|
211
|
+
cacheWrite: u.cache_creation_input_tokens,
|
|
212
|
+
cacheWriteLong: u.ephemeral_1h_input_tokens,
|
|
213
|
+
}, reasoningOf(u));
|
|
212
214
|
}
|
|
213
215
|
function closeToolUseBlock(acc, responseIds, closed) {
|
|
214
216
|
if (acc.closedTc)
|
|
@@ -251,6 +253,8 @@ function readEvent(raw) {
|
|
|
251
253
|
output_tokens: usageSeat.count(u.output_tokens),
|
|
252
254
|
cache_read_input_tokens: usageSeat.count(u.cache_read_input_tokens),
|
|
253
255
|
cache_creation_input_tokens: usageSeat.count(u.cache_creation_input_tokens),
|
|
256
|
+
ephemeral_1h_input_tokens: usageSeat.count(usageSeat.object(u.cache_creation)?.ephemeral_1h_input_tokens),
|
|
257
|
+
thinking_tokens: usageSeat.claimIn(u.output_tokens_details, "thinking_tokens"),
|
|
254
258
|
};
|
|
255
259
|
};
|
|
256
260
|
const done = (event) => ({ event, outOfShape: frame.outOfShape, usageUnreadable: usageSeat.outOfShape });
|
|
@@ -347,14 +351,15 @@ export function createAnthropicBrain(given = {}) {
|
|
|
347
351
|
const routeAdmission = admitRouteRequest(routed, routeCredential, { baseUrl: config.baseUrl, laneDefault: ANTHROPIC_DEFAULT_BASE_URL });
|
|
348
352
|
const apiKey = routeCredential.apiKey;
|
|
349
353
|
const nonEmptyBlocks = context.systemBlocks?.filter((b) => b.text.length > 0);
|
|
354
|
+
const cacheControl = cacheControlFor(cacheBreakpoints, options?.cacheRetention);
|
|
350
355
|
const system = nonEmptyBlocks?.length
|
|
351
356
|
? nonEmptyBlocks.map((b) => ({
|
|
352
357
|
type: "text",
|
|
353
358
|
text: b.text,
|
|
354
|
-
...(
|
|
359
|
+
...(cacheControl !== undefined && b.cacheControlBoundary ? { cache_control: cacheControl } : {}),
|
|
355
360
|
}))
|
|
356
361
|
: context.systemPrompt
|
|
357
|
-
? [{ type: "text", text: context.systemPrompt, ...(
|
|
362
|
+
? [{ type: "text", text: context.systemPrompt, ...(cacheControl !== undefined ? { cache_control: cacheControl } : {}) }]
|
|
358
363
|
: undefined;
|
|
359
364
|
const body = {
|
|
360
365
|
model: model.id,
|
|
@@ -364,7 +369,7 @@ export function createAnthropicBrain(given = {}) {
|
|
|
364
369
|
};
|
|
365
370
|
if (system)
|
|
366
371
|
body.system = system;
|
|
367
|
-
const tools = toAnthropicTools(context,
|
|
372
|
+
const tools = toAnthropicTools(context, cacheControl, builtToolNames);
|
|
368
373
|
if (tools)
|
|
369
374
|
body.tools = tools;
|
|
370
375
|
const anthCompat = (model.compat ?? {});
|
|
@@ -452,11 +457,14 @@ export function createAnthropicBrain(given = {}) {
|
|
|
452
457
|
let messageStopped = false;
|
|
453
458
|
const afterEnd = createStreamEndLedger(ctrl.providerWords);
|
|
454
459
|
const streamEnded = () => stopReason != null || messageStopped;
|
|
460
|
+
const endedWhole = () => streamEnded() && (messageStopped || ![...blocks.values()].some((b) => b.stopped !== true));
|
|
455
461
|
const mergeDeltaUsage = (u) => {
|
|
456
462
|
if (!u)
|
|
457
463
|
return;
|
|
458
464
|
if (u.output_tokens !== undefined)
|
|
459
465
|
usageRaw.output_tokens = u.output_tokens;
|
|
466
|
+
if (u.thinking_tokens !== undefined)
|
|
467
|
+
usageRaw.thinking_tokens = u.thinking_tokens;
|
|
460
468
|
if (u.input_tokens != null && u.input_tokens > 0)
|
|
461
469
|
usageRaw.input_tokens = u.input_tokens;
|
|
462
470
|
if (u.cache_read_input_tokens != null && u.cache_read_input_tokens > 0)
|
|
@@ -464,11 +472,13 @@ export function createAnthropicBrain(given = {}) {
|
|
|
464
472
|
if (u.cache_creation_input_tokens != null && u.cache_creation_input_tokens > 0) {
|
|
465
473
|
usageRaw.cache_creation_input_tokens = u.cache_creation_input_tokens;
|
|
466
474
|
}
|
|
475
|
+
if (u.ephemeral_1h_input_tokens != null && u.ephemeral_1h_input_tokens > 0)
|
|
476
|
+
usageRaw.ephemeral_1h_input_tokens = u.ephemeral_1h_input_tokens;
|
|
477
|
+
};
|
|
478
|
+
const reportedUsage = () => {
|
|
479
|
+
const reading = reportedUsageOf(model, usageRaw);
|
|
480
|
+
return { usage: reading.usage, ...(reading.missing || usageUnreadable ? { usageMissing: true } : {}) };
|
|
467
481
|
};
|
|
468
|
-
const reportedUsage = () => ({
|
|
469
|
-
usage: computeUsage(model, usageRaw),
|
|
470
|
-
...(Object.keys(usageRaw).length === 0 || usageUnreadable ? { usageMissing: true } : {}),
|
|
471
|
-
});
|
|
472
482
|
const wordOf = (v) => (typeof v === "string" && v !== "" ? v : NO_WORD);
|
|
473
483
|
const refuseAfterEnd = ({ event: evt, outOfShape }) => {
|
|
474
484
|
switch (evt.kind) {
|
|
@@ -495,6 +505,9 @@ export function createAnthropicBrain(given = {}) {
|
|
|
495
505
|
case "unreadable":
|
|
496
506
|
afterEnd.note("content", NO_WORD);
|
|
497
507
|
return;
|
|
508
|
+
case "message_stop":
|
|
509
|
+
messageStopped = true;
|
|
510
|
+
return;
|
|
498
511
|
default:
|
|
499
512
|
return;
|
|
500
513
|
}
|
|
@@ -587,6 +600,7 @@ export function createAnthropicBrain(given = {}) {
|
|
|
587
600
|
usageRaw.input_tokens = u.input_tokens;
|
|
588
601
|
usageRaw.cache_read_input_tokens = u.cache_read_input_tokens;
|
|
589
602
|
usageRaw.cache_creation_input_tokens = u.cache_creation_input_tokens;
|
|
603
|
+
usageRaw.ephemeral_1h_input_tokens = u.ephemeral_1h_input_tokens;
|
|
590
604
|
}
|
|
591
605
|
break;
|
|
592
606
|
}
|
|
@@ -813,7 +827,7 @@ export function createAnthropicBrain(given = {}) {
|
|
|
813
827
|
emptyNoFinish ||
|
|
814
828
|
(toolError !== undefined && noUsableContent) ||
|
|
815
829
|
(truncatedEmpty && !dynamicCut && !staticReasoningCut);
|
|
816
|
-
const tornWithContent = !errored && opts?.truncated !== true && !
|
|
830
|
+
const tornWithContent = !errored && opts?.truncated !== true && !endedWhole() && !noUsableContent && !degenerate;
|
|
817
831
|
const errorMessageOut = tornWithContent ? (errorMessage ? `${errorMessage}\n${STREAM_TORN_WARNING}` : STREAM_TORN_WARNING) : errorMessage;
|
|
818
832
|
const errorKind = degenerate
|
|
819
833
|
? "degenerate"
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A Brain's non-streaming face, read the one way every layer that dispatches a request to a Brain reads it — the routing, failover
|
|
3
|
+
* and circuit-breaker decorators and the engine's model lane: the Brain's own `complete` when it has one, called on that Brain and
|
|
4
|
+
* its message returned exactly as it answered (the Brain contract, `core/model-seat.ts`: the summary path's recovery reads
|
|
5
|
+
* `errorKind` off it), else the Brain's `stream` read to its final message — the derivation `brainToRuntime` applies to a Brain
|
|
6
|
+
* with no `complete`. A decorator therefore always has a `complete` face: what a request reaches through it is the face the Brain
|
|
7
|
+
* that serves the request has, decided per request (a router cannot know before it is asked which line serves a model).
|
|
8
|
+
*/
|
|
9
|
+
import type { CompleteSimpleFn } from "../internal/llm.js";
|
|
10
|
+
import type { Brain } from "../core/types.js";
|
|
11
|
+
export declare function completeOf(brain: Brain): CompleteSimpleFn;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export function completeOf(brain) {
|
|
2
|
+
const own = brain.complete;
|
|
3
|
+
if (own !== undefined)
|
|
4
|
+
return (model, context, options) => own.call(brain, model, context, options);
|
|
5
|
+
return async (model, context, options) => (await brain.stream(model, context, options)).result();
|
|
6
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { CACHE_RETENTION_WORDS, isCacheRetention } from "../internal/llm.js";
|
|
2
|
+
import { describeRejectedValue } from "../core/tool-search-setting.js";
|
|
3
|
+
const SHOWN_STRING_MAX = 40;
|
|
4
|
+
export function cacheRetentionDefect(value, field) {
|
|
5
|
+
if (value === undefined || isCacheRetention(value))
|
|
6
|
+
return undefined;
|
|
7
|
+
const shown = typeof value === "string" && value.length > SHOWN_STRING_MAX ? `a string of ${value.length} characters` : describeRejectedValue(value);
|
|
8
|
+
return `${field} must be one of ${CACHE_RETENTION_WORDS.join(" | ")}, or absent (got ${shown}) — a retention value the engine cannot read is refused rather than sent as the default.`;
|
|
9
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { createAssistantMessageEventStream } from "../internal/llm.js";
|
|
2
|
-
import {
|
|
2
|
+
import { completeOf } from "./brain-faces.js";
|
|
3
|
+
import { abortLikeName, brainErrorCodeOf, codedAbortOf, IN_BAND_OUTPUT_CODES, ZERO_USAGE, extractErrorCode } from "./errors.js";
|
|
3
4
|
import { emitBrainStatus, emitBrainTelemetry } from "./status-sink.js";
|
|
4
5
|
import { thrownText } from "../core/thrown-value.js";
|
|
5
6
|
export const CIRCUIT_OPEN_MARKER = "circuit open for ";
|
|
@@ -12,7 +13,7 @@ class InMemoryBreakerState {
|
|
|
12
13
|
this.m.set(k, s);
|
|
13
14
|
}
|
|
14
15
|
}
|
|
15
|
-
function errorAssistantMessage(model, code, detail, stopReason
|
|
16
|
+
function errorAssistantMessage(model, code, detail, stopReason, sent) {
|
|
16
17
|
return {
|
|
17
18
|
role: "assistant",
|
|
18
19
|
content: [{ type: "text", text: "" }],
|
|
@@ -22,6 +23,7 @@ function errorAssistantMessage(model, code, detail, stopReason = "error") {
|
|
|
22
23
|
stopReason,
|
|
23
24
|
errorMessage: `[${code}] ${detail}`,
|
|
24
25
|
usage: ZERO_USAGE,
|
|
26
|
+
...(sent ? { usageMissing: true } : {}),
|
|
25
27
|
timestamp: Date.now(),
|
|
26
28
|
};
|
|
27
29
|
}
|
|
@@ -103,23 +105,42 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
|
|
|
103
105
|
state.set(key, { phase: "closed", failures: 0 });
|
|
104
106
|
}
|
|
105
107
|
};
|
|
108
|
+
const admit = (model, key, options) => {
|
|
109
|
+
const bypass = options?.resilience?.bypassBreaker === true;
|
|
110
|
+
const decision = bypass ? { pass: true } : tryPass(key);
|
|
111
|
+
if (decision.pass)
|
|
112
|
+
return { key, bypass };
|
|
113
|
+
emitBrainStatus({
|
|
114
|
+
phase: "circuit_open",
|
|
115
|
+
detail: "repeated errors, pausing briefly",
|
|
116
|
+
...(decision.retryInMs !== undefined
|
|
117
|
+
? { retryInMs: decision.retryInMs, retryInSec: Math.ceil(decision.retryInMs / 1000) }
|
|
118
|
+
: {}),
|
|
119
|
+
});
|
|
120
|
+
return { refused: errorAssistantMessage(model, "network", `${CIRCUIT_OPEN_MARKER}${key}`, "error", false) };
|
|
121
|
+
};
|
|
122
|
+
const answeredCode = (message, options) => {
|
|
123
|
+
const failed = message.stopReason === "error" && options?.signal?.aborted !== true;
|
|
124
|
+
const rawCode = extractErrorCode(message.errorMessage);
|
|
125
|
+
const breakerCode = rawCode === undefined ? "http" : IN_BAND_OUTPUT_CODES.has(rawCode) && !countCodes.has(rawCode) ? "http" : rawCode;
|
|
126
|
+
return failed ? breakerCode : options?.signal?.aborted ? (codedAbortOf(options.signal) ?? "http") : undefined;
|
|
127
|
+
};
|
|
128
|
+
const thrownAnswer = (model, e, key, bypass, options) => {
|
|
129
|
+
const aborted = options?.signal?.aborted === true || abortLikeName(e) === "AbortError";
|
|
130
|
+
const code = brainErrorCodeOf(e) ?? "network";
|
|
131
|
+
record(key, aborted ? (codedAbortOf(options?.signal) ?? "http") : code, !bypass);
|
|
132
|
+
return errorAssistantMessage(model, code, thrownText(e), aborted ? "aborted" : "error", true);
|
|
133
|
+
};
|
|
106
134
|
const stream = (model, context, options) => {
|
|
107
135
|
const out = createAssistantMessageEventStream();
|
|
108
136
|
const key = keyOf(model);
|
|
109
137
|
void (async () => {
|
|
110
|
-
const
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
emitBrainStatus({
|
|
114
|
-
phase: "circuit_open",
|
|
115
|
-
detail: "repeated errors, pausing briefly",
|
|
116
|
-
...(decision.retryInMs !== undefined
|
|
117
|
-
? { retryInMs: decision.retryInMs, retryInSec: Math.ceil(decision.retryInMs / 1000) }
|
|
118
|
-
: {}),
|
|
119
|
-
});
|
|
120
|
-
out.push({ type: "error", reason: "error", error: errorAssistantMessage(model, "network", `${CIRCUIT_OPEN_MARKER}${key}`) });
|
|
138
|
+
const admitted = admit(model, key, options);
|
|
139
|
+
if ("refused" in admitted) {
|
|
140
|
+
out.push({ type: "error", reason: "error", error: admitted.refused });
|
|
121
141
|
return;
|
|
122
142
|
}
|
|
143
|
+
const { bypass } = admitted;
|
|
123
144
|
try {
|
|
124
145
|
const inner_ = await inner.stream(model, context, options);
|
|
125
146
|
let terminal;
|
|
@@ -131,10 +152,7 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
|
|
|
131
152
|
out.push(ev);
|
|
132
153
|
}
|
|
133
154
|
const message = await inner_.result();
|
|
134
|
-
|
|
135
|
-
const rawCode = extractErrorCode(message.errorMessage);
|
|
136
|
-
const breakerCode = rawCode === undefined ? "http" : IN_BAND_OUTPUT_CODES.has(rawCode) && !countCodes.has(rawCode) ? "http" : rawCode;
|
|
137
|
-
record(key, failed ? breakerCode : options?.signal?.aborted ? "http" : undefined, !bypass);
|
|
155
|
+
record(key, answeredCode(message, options), !bypass);
|
|
138
156
|
try {
|
|
139
157
|
out.push(terminal ?? { type: "done", reason: message.stopReason, message });
|
|
140
158
|
}
|
|
@@ -142,18 +160,25 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
|
|
|
142
160
|
}
|
|
143
161
|
}
|
|
144
162
|
catch (e) {
|
|
145
|
-
const
|
|
146
|
-
|
|
147
|
-
record(key, aborted ? "http" : code, !bypass);
|
|
148
|
-
out.push({
|
|
149
|
-
type: "error",
|
|
150
|
-
reason: aborted ? "aborted" : "error",
|
|
151
|
-
error: errorAssistantMessage(model, code, thrownText(e), aborted ? "aborted" : "error"),
|
|
152
|
-
});
|
|
163
|
+
const message = thrownAnswer(model, e, key, bypass, options);
|
|
164
|
+
out.push({ type: "error", reason: message.stopReason === "aborted" ? "aborted" : "error", error: message });
|
|
153
165
|
}
|
|
154
166
|
})();
|
|
155
167
|
return out;
|
|
156
168
|
};
|
|
169
|
+
const complete = async (model, context, options) => {
|
|
170
|
+
const admitted = admit(model, keyOf(model), options);
|
|
171
|
+
if ("refused" in admitted)
|
|
172
|
+
return admitted.refused;
|
|
173
|
+
try {
|
|
174
|
+
const message = await completeOf(inner)(model, context, options);
|
|
175
|
+
record(admitted.key, answeredCode(message, options), !admitted.bypass);
|
|
176
|
+
return message;
|
|
177
|
+
}
|
|
178
|
+
catch (e) {
|
|
179
|
+
return thrownAnswer(model, e, admitted.key, admitted.bypass, options);
|
|
180
|
+
}
|
|
181
|
+
};
|
|
157
182
|
const adjudicateRoute = (model, perModelAuth) => inner.adjudicateRoute?.(model, perModelAuth);
|
|
158
|
-
return { stream, adjudicateRoute };
|
|
183
|
+
return { stream, complete, adjudicateRoute };
|
|
159
184
|
}
|
package/dist/brain/errors.d.ts
CHANGED
|
@@ -8,7 +8,10 @@
|
|
|
8
8
|
import type { Usage } from "../internal/llm.js";
|
|
9
9
|
import type { ProviderCondition, ProviderConditionSource } from "./provider-dialect.js";
|
|
10
10
|
/** A zeroed `Usage` for synthetic error/short-circuit assistant messages (no tokens spent). Shared by
|
|
11
|
-
* the circuit-breaker, degradation, and routing brains so the empty-usage shape lives in one place.
|
|
11
|
+
* the circuit-breaker, degradation, and routing brains so the empty-usage shape lives in one place.
|
|
12
|
+
* Every member is a KNOWN zero — no request went out, so nothing was read from or written to a cache either (the cache
|
|
13
|
+
* members are present, unlike a usage no frame reported). Where a request may have gone out, the message carries
|
|
14
|
+
* `usageMissing` beside it and every member is then a lower bound. */
|
|
12
15
|
export declare const ZERO_USAGE: Usage;
|
|
13
16
|
/** The single source of truth for brain error codes — the type, the `[code]` parser, and the prefix
|
|
14
17
|
* stripper all derive from this one list, so adding a code can't silently diverge across call sites.
|
|
@@ -77,6 +80,9 @@ export declare class BrainError extends Error {
|
|
|
77
80
|
readonly providerConditionSource?: ProviderConditionSource;
|
|
78
81
|
/** With a `quota_exhausted` condition whose evidence stated it: when the quota lifts, wall-clock epoch ms. */
|
|
79
82
|
readonly providerResetAtMs?: number;
|
|
83
|
+
/** The provider's own sentence for the failure, read off its error envelope and carried through the one pass (`provider-message.ts`). Lifted
|
|
84
|
+
* onto `AssistantMessage.providerMessage`. Absent when the response stated no trusted sentence. */
|
|
85
|
+
readonly providerMessage?: string;
|
|
80
86
|
/** The failed response's body did not end (cut at the read bound, torn, unreadable), so it stated nothing: no
|
|
81
87
|
* verdict, word or context-limit reading came from it, and the prefix quoted in the message is no evidence
|
|
82
88
|
* either. Lifted onto `AssistantMessage.errorBodyIncomplete`. */
|
|
@@ -98,6 +104,7 @@ export declare class BrainError extends Error {
|
|
|
98
104
|
source: ProviderConditionSource;
|
|
99
105
|
resetAtMs?: number;
|
|
100
106
|
};
|
|
107
|
+
providerMessage?: string;
|
|
101
108
|
errorBodyIncomplete?: boolean;
|
|
102
109
|
imageUnprocessable?: boolean;
|
|
103
110
|
toolSchemaRefused?: string;
|
|
@@ -265,6 +272,13 @@ export declare function abortLikeName(err: unknown): "AbortError" | "TimeoutErro
|
|
|
265
272
|
* rather than testing `instanceof BrainError`, which walks a chain a revoked proxy traps — and the one
|
|
266
273
|
* site that did so sits in an async IIFE with no `.catch`. */
|
|
267
274
|
export declare function brainErrorCodeOf(e: unknown): BrainErrorCode | undefined;
|
|
275
|
+
/**
|
|
276
|
+
* What an aborted call's signal says about the failure: the brain code its abort REASON carries, else `undefined`. The one reading
|
|
277
|
+
* of an aborted call at every observation edge (a circuit breaker, the model lane): an abort whose reason is a coded brain failure
|
|
278
|
+
* — the model lane cutting a hop at its first-token deadline aborts with a `network` `BrainError` — is that failure; any other
|
|
279
|
+
* abort (a caller cancelling, which hands no coded reason) is neutral. Not aborted ⇒ `undefined`.
|
|
280
|
+
*/
|
|
281
|
+
export declare function codedAbortOf(signal: AbortSignal | undefined): BrainErrorCode | undefined;
|
|
268
282
|
/** What a thrown brain failure says about itself in machine words: its code, and the structural cause its minter
|
|
269
283
|
* declared (input too long, or ruled out; an image the provider could not process). Empty for a value that carries no
|
|
270
284
|
* brain code. */
|
package/dist/brain/errors.js
CHANGED
|
@@ -22,6 +22,7 @@ export class BrainError extends Error {
|
|
|
22
22
|
providerCondition;
|
|
23
23
|
providerConditionSource;
|
|
24
24
|
providerResetAtMs;
|
|
25
|
+
providerMessage;
|
|
25
26
|
errorBodyIncomplete;
|
|
26
27
|
imageUnprocessable;
|
|
27
28
|
toolSchemaRefused;
|
|
@@ -44,6 +45,8 @@ export class BrainError extends Error {
|
|
|
44
45
|
if (opts.verdict.resetAtMs !== undefined)
|
|
45
46
|
this.providerResetAtMs = opts.verdict.resetAtMs;
|
|
46
47
|
}
|
|
48
|
+
if (typeof opts?.providerMessage === "string")
|
|
49
|
+
this.providerMessage = opts.providerMessage;
|
|
47
50
|
if (opts?.errorBodyIncomplete === true)
|
|
48
51
|
this.errorBodyIncomplete = true;
|
|
49
52
|
if (opts?.imageUnprocessable === true)
|
|
@@ -253,6 +256,11 @@ export function brainErrorCodeOf(e) {
|
|
|
253
256
|
const code = readMember(e, "code");
|
|
254
257
|
return typeof code === "string" && BRAIN_ERROR_CODES.includes(code) ? code : undefined;
|
|
255
258
|
}
|
|
259
|
+
export function codedAbortOf(signal) {
|
|
260
|
+
if (signal === undefined || signal.aborted !== true)
|
|
261
|
+
return undefined;
|
|
262
|
+
return brainErrorCodeOf(signal.reason);
|
|
263
|
+
}
|
|
256
264
|
export function thrownBrainFailure(e) {
|
|
257
265
|
const code = brainErrorCodeOf(e);
|
|
258
266
|
if (code === undefined)
|
package/dist/brain/failover.d.ts
CHANGED
|
@@ -11,6 +11,12 @@ import type { Brain } from "../core/types.js";
|
|
|
11
11
|
* (including a mid-stream error or abort) is propagated rather than restarted, so the consumer never
|
|
12
12
|
* sees duplicate `start`/text events. The last brain's result is always final.
|
|
13
13
|
*
|
|
14
|
+
* The non-streaming face walks the same brains the same way, each through ITS non-streaming face (`completeOf`): a message that
|
|
15
|
+
* carries content is the answer, whatever its outcome.
|
|
16
|
+
*
|
|
17
|
+
* Every gateway moved off is listed on the answer (the model lane's left-behind list: `leftEntriesOf` / `carryLeftBehind`), with the
|
|
18
|
+
* usage its own message reported — what a failed attempt cost is billed, at the request's model.
|
|
19
|
+
*
|
|
14
20
|
* Each underlying brain keeps its own retry policy (e.g. `createOpenAIBrain({ maxRetries })`);
|
|
15
21
|
* failover is the cross-gateway layer on top.
|
|
16
22
|
*/
|
package/dist/brain/failover.js
CHANGED
|
@@ -1,12 +1,23 @@
|
|
|
1
|
-
import { createAssistantMessageEventStream
|
|
1
|
+
import { createAssistantMessageEventStream } from "../internal/llm.js";
|
|
2
2
|
import { abortLikeName, extractErrorCode } from "./errors.js";
|
|
3
3
|
import { emitBrainTelemetry } from "./status-sink.js";
|
|
4
|
-
import { passthroughStream } from "./
|
|
5
|
-
import {
|
|
4
|
+
import { carriesContent, carryLeftBehind, errorMessageOf, gateReadingOf, leftEntriesOf, passthroughStream, terminalMessage, terminalOf, } from "./model-lane.js";
|
|
5
|
+
import { completeOf } from "./brain-faces.js";
|
|
6
|
+
import { GATEWAY_HOP_GATE } from "../core/model-fallbacks.js";
|
|
6
7
|
export function createFailoverBrain(brains) {
|
|
7
8
|
if (brains.length === 0) {
|
|
8
9
|
throw new Error("createFailoverBrain: need at least one brain");
|
|
9
10
|
}
|
|
11
|
+
const reportServed = (i, lastFailedCode) => {
|
|
12
|
+
if (i === 0)
|
|
13
|
+
return;
|
|
14
|
+
emitBrainTelemetry({
|
|
15
|
+
kind: "failover",
|
|
16
|
+
servedIndex: i,
|
|
17
|
+
total: brains.length,
|
|
18
|
+
...(lastFailedCode !== undefined ? { errorCode: lastFailedCode } : {}),
|
|
19
|
+
});
|
|
20
|
+
};
|
|
10
21
|
const stream = (model, context, options) => {
|
|
11
22
|
if (options?.resilience?.allowFailover === false) {
|
|
12
23
|
return passthroughStream(brains[0], model, context, options);
|
|
@@ -14,10 +25,11 @@ export function createFailoverBrain(brains) {
|
|
|
14
25
|
const out = createAssistantMessageEventStream();
|
|
15
26
|
void (async () => {
|
|
16
27
|
let lastFailedCode;
|
|
28
|
+
const left = [];
|
|
17
29
|
try {
|
|
18
|
-
for (
|
|
30
|
+
for (const [i, brain] of brains.entries()) {
|
|
19
31
|
const isLast = i === brains.length - 1;
|
|
20
|
-
const inner = await
|
|
32
|
+
const inner = await brain.stream(model, context, options);
|
|
21
33
|
let sawContent = false;
|
|
22
34
|
let heldStart;
|
|
23
35
|
let terminal;
|
|
@@ -38,52 +50,55 @@ export function createFailoverBrain(brains) {
|
|
|
38
50
|
out.push(ev);
|
|
39
51
|
}
|
|
40
52
|
const message = await inner.result();
|
|
41
|
-
const cleanUpfrontFailure = message
|
|
42
|
-
options?.signal?.aborted !== true &&
|
|
43
|
-
!sawContent &&
|
|
44
|
-
message.errorKind !== "length_empty" &&
|
|
45
|
-
message.errorKind !== "image_unprocessable" &&
|
|
46
|
-
message.errorKind !== "tool_schema_refused";
|
|
53
|
+
const cleanUpfrontFailure = !sawContent && gateReadingOf(message, i, false, options?.signal?.aborted === true, GATEWAY_HOP_GATE) !== undefined;
|
|
47
54
|
if (cleanUpfrontFailure && !isLast) {
|
|
48
55
|
lastFailedCode = extractErrorCode(message.errorMessage);
|
|
56
|
+
left.push(...leftEntriesOf(message, model.id));
|
|
49
57
|
continue;
|
|
50
58
|
}
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
servedIndex: i,
|
|
55
|
-
total: brains.length,
|
|
56
|
-
...(lastFailedCode !== undefined ? { errorCode: lastFailedCode } : {}),
|
|
57
|
-
});
|
|
58
|
-
}
|
|
59
|
+
reportServed(i, lastFailedCode);
|
|
60
|
+
const served = terminal ?? terminalOf(message);
|
|
61
|
+
carryLeftBehind(terminalMessage(served, message), left);
|
|
59
62
|
if (!sawContent && heldStart)
|
|
60
63
|
out.push(heldStart);
|
|
61
|
-
out.push(
|
|
62
|
-
type: "done",
|
|
63
|
-
reason: message.stopReason,
|
|
64
|
-
message,
|
|
65
|
-
});
|
|
64
|
+
out.push(served);
|
|
66
65
|
return;
|
|
67
66
|
}
|
|
68
67
|
}
|
|
69
68
|
catch (e) {
|
|
70
69
|
const aborted = options?.signal?.aborted === true || abortLikeName(e) !== undefined;
|
|
71
|
-
const
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
api: model.api,
|
|
75
|
-
provider: model.provider,
|
|
76
|
-
model: model.id,
|
|
77
|
-
stopReason: aborted ? "aborted" : "error",
|
|
78
|
-
errorMessage: thrownText(e),
|
|
79
|
-
usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
|
|
80
|
-
timestamp: Date.now(),
|
|
81
|
-
};
|
|
82
|
-
out.push({ type: "error", reason: aborted ? "aborted" : "error", error: errorMsg });
|
|
70
|
+
const shell = errorMessageOf(model, e, aborted);
|
|
71
|
+
carryLeftBehind(shell, left);
|
|
72
|
+
out.push({ type: "error", reason: aborted ? "aborted" : "error", error: shell });
|
|
83
73
|
}
|
|
84
74
|
})();
|
|
85
75
|
return out;
|
|
86
76
|
};
|
|
77
|
+
const complete = async (model, context, options) => {
|
|
78
|
+
const span = options?.resilience?.allowFailover === false ? 1 : brains.length;
|
|
79
|
+
let lastFailedCode;
|
|
80
|
+
const left = [];
|
|
81
|
+
for (let i = 0;; i++) {
|
|
82
|
+
let message;
|
|
83
|
+
try {
|
|
84
|
+
message = await completeOf(brains[i])(model, context, options);
|
|
85
|
+
}
|
|
86
|
+
catch (e) {
|
|
87
|
+
const shell = errorMessageOf(model, e, options?.signal?.aborted === true || abortLikeName(e) !== undefined);
|
|
88
|
+
carryLeftBehind(shell, left);
|
|
89
|
+
return shell;
|
|
90
|
+
}
|
|
91
|
+
const cleanUpfrontFailure = !carriesContent(message) && gateReadingOf(message, i, false, options?.signal?.aborted === true, GATEWAY_HOP_GATE) !== undefined;
|
|
92
|
+
if (cleanUpfrontFailure && i < span - 1) {
|
|
93
|
+
lastFailedCode = extractErrorCode(message.errorMessage);
|
|
94
|
+
left.push(...leftEntriesOf(message, model.id));
|
|
95
|
+
continue;
|
|
96
|
+
}
|
|
97
|
+
reportServed(i, lastFailedCode);
|
|
98
|
+
carryLeftBehind(message, left);
|
|
99
|
+
return message;
|
|
100
|
+
}
|
|
101
|
+
};
|
|
87
102
|
const adjudicateRoute = (model, perModelAuth) => {
|
|
88
103
|
let firstRefusal;
|
|
89
104
|
let sawUnjudged = false;
|
|
@@ -99,5 +114,5 @@ export function createFailoverBrain(brains) {
|
|
|
99
114
|
}
|
|
100
115
|
return sawUnjudged ? undefined : firstRefusal;
|
|
101
116
|
};
|
|
102
|
-
return { stream, adjudicateRoute };
|
|
117
|
+
return { stream, complete, adjudicateRoute };
|
|
103
118
|
}
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* sentence that drifts is a string consumers grep for.
|
|
8
8
|
*/
|
|
9
9
|
import type { Model } from "../internal/llm.js";
|
|
10
|
+
import type { RenderedLocale } from "../prompt-assembly/catalog/schema.js";
|
|
10
11
|
import { type CapabilityDeclaration } from "./model-capability.js";
|
|
11
12
|
/** Why a request's images are withheld from the SERVING model: the entry's image declaration, when it is not held
|
|
12
13
|
* (the withheld-capability report's `cause`, `status-sink.ts`). */
|
|
@@ -31,6 +32,10 @@ export declare function reportImagesWithheld(withhold: ImageWithhold, count: num
|
|
|
31
32
|
export declare const IMAGE_OMITTED_NO_VISION = "[image omitted: the serving model does not support image input]";
|
|
32
33
|
/** {@link IMAGE_OMITTED_NO_VISION}, counted — a batch of dropped images states how many were lost. */
|
|
33
34
|
export declare function imagesOmittedNoVisionNote(count: number): string;
|
|
35
|
+
/** The provenance line before a tool's images where a lane carries them in a synthetic user message (the endpoint
|
|
36
|
+
* takes images only on a user message): the catalog's image-prefix message for one image or several, naming the
|
|
37
|
+
* tool calls (`ids`) they came from — in the request's locale (`Context.promptLocale`; absent ⇒ canonical). */
|
|
38
|
+
export declare function toolImagesPrefix(count: number, ids: string, locale?: RenderedLocale): string;
|
|
34
39
|
/** An image content block carrying both wire fields — the only shape any lane can actually send. */
|
|
35
40
|
export interface SendableImage {
|
|
36
41
|
type: "image";
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { engineTextFor } from "../prompt-assembly/engine-text.js";
|
|
1
2
|
import { capabilityHeld, capabilityOf } from "./model-capability.js";
|
|
2
3
|
import { emitBrainTelemetry, reportCapabilityWithheld } from "./status-sink.js";
|
|
3
4
|
export function imageWithholdOf(model) {
|
|
@@ -16,6 +17,9 @@ export const IMAGE_OMITTED_NO_VISION = "[image omitted: the serving model does n
|
|
|
16
17
|
export function imagesOmittedNoVisionNote(count) {
|
|
17
18
|
return count > 1 ? `[${count} images omitted: the serving model does not support image input]` : IMAGE_OMITTED_NO_VISION;
|
|
18
19
|
}
|
|
20
|
+
export function toolImagesPrefix(count, ids, locale) {
|
|
21
|
+
return engineTextFor(locale)(count > 1 ? "core/engine.image-prefix-many" : "core/engine.image-prefix-one", { ids });
|
|
22
|
+
}
|
|
19
23
|
export function sendableImages(blocks) {
|
|
20
24
|
const out = [];
|
|
21
25
|
for (const b of blocks) {
|
|
@@ -21,7 +21,8 @@ export type CapabilityDeclaration = (typeof CAPABILITY_DECLARATIONS)[number];
|
|
|
21
21
|
/**
|
|
22
22
|
* What the engine does with a capability the entry does not declare, per capability — the only place this is said.
|
|
23
23
|
* Image input is used (an entry that never filled in `input` keeps the images it was always sent). Reasoning is not:
|
|
24
|
-
* no thinking
|
|
24
|
+
* no key that turns thinking on goes out for an entry that does not declare `reasoning` (the request is the provider's
|
|
25
|
+
* default); the explicit off is sent to it only where the entry names its wire's dialect (`offSpelling`, brain/reasoning.ts).
|
|
25
26
|
*/
|
|
26
27
|
export declare const UNKNOWN_CAPABILITY_READS: Readonly<Record<ModelCapability, "held" | "not_held">>;
|
|
27
28
|
/** The part of a model this module reads (`id` only names the model in a refusal; the structural readers that take a
|