@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
package/dist/brain/routing.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { createAssistantMessageEventStream, } from "../internal/llm.js";
|
|
2
|
+
import { completeOf } from "./brain-faces.js";
|
|
2
3
|
import { ZERO_USAGE } from "./errors.js";
|
|
3
4
|
function errorMessage(who, text) {
|
|
4
5
|
return {
|
|
@@ -20,7 +21,7 @@ function spelled(word) {
|
|
|
20
21
|
function routeKeyOf(model, by) {
|
|
21
22
|
return by === "api" ? model.api : model.provider;
|
|
22
23
|
}
|
|
23
|
-
function isBrain(value) {
|
|
24
|
+
export function isBrain(value) {
|
|
24
25
|
return value !== null && typeof value === "object" && typeof value.stream === "function";
|
|
25
26
|
}
|
|
26
27
|
export function brainLaneOf(model, routes, by = "provider") {
|
|
@@ -36,17 +37,15 @@ export function createRoutingBrain(routes, opts = {}) {
|
|
|
36
37
|
const routed = routes[lane];
|
|
37
38
|
return isBrain(routed) ? { target: routed } : { broken: `route ${by}="${lane}" is mounted but its value is not a brain` };
|
|
38
39
|
};
|
|
39
|
-
const
|
|
40
|
+
const place = (model) => {
|
|
40
41
|
const reject = (text, named) => {
|
|
41
|
-
const out = createAssistantMessageEventStream();
|
|
42
42
|
try {
|
|
43
43
|
const wordOf = (field) => (field === by && named !== undefined ? named.value : model[field]);
|
|
44
|
-
|
|
44
|
+
return { refused: errorMessage({ api: wordOf("api"), provider: wordOf("provider"), id: wordOf("id") }, text) };
|
|
45
45
|
}
|
|
46
46
|
catch {
|
|
47
|
-
|
|
47
|
+
return { refused: errorMessage(BLANK_IDENTITY, `${text} (the model's own words could not be read either)`) };
|
|
48
48
|
}
|
|
49
|
-
return out;
|
|
50
49
|
};
|
|
51
50
|
let word;
|
|
52
51
|
try {
|
|
@@ -67,11 +66,23 @@ export function createRoutingBrain(routes, opts = {}) {
|
|
|
67
66
|
const target = "target" in resolved ? resolved.target : undefined;
|
|
68
67
|
if (!target)
|
|
69
68
|
return reject("broken" in resolved ? `createRoutingBrain: ${resolved.broken}` : `createRoutingBrain: no brain for ${by}="${spelled(named)}"`, word);
|
|
70
|
-
return target
|
|
69
|
+
return { target };
|
|
70
|
+
};
|
|
71
|
+
const stream = (model, context, options) => {
|
|
72
|
+
const placed = place(model);
|
|
73
|
+
if ("target" in placed)
|
|
74
|
+
return placed.target.stream(model, context, options);
|
|
75
|
+
const out = createAssistantMessageEventStream();
|
|
76
|
+
out.push({ type: "error", reason: "error", error: placed.refused });
|
|
77
|
+
return out;
|
|
78
|
+
};
|
|
79
|
+
const complete = async (model, context, options) => {
|
|
80
|
+
const placed = place(model);
|
|
81
|
+
return "target" in placed ? completeOf(placed.target)(model, context, options) : placed.refused;
|
|
71
82
|
};
|
|
72
83
|
const adjudicateRoute = (model, perModelAuth) => {
|
|
73
84
|
const resolved = resolveTarget(model);
|
|
74
85
|
return "target" in resolved ? resolved.target?.adjudicateRoute?.(model, perModelAuth) : undefined;
|
|
75
86
|
};
|
|
76
|
-
return { stream, adjudicateRoute };
|
|
87
|
+
return { stream, complete, adjudicateRoute };
|
|
77
88
|
}
|
|
@@ -6,11 +6,12 @@ import type { CapabilityDeclaration, ModelCapability } from "./model-capability.
|
|
|
6
6
|
* reaches THIS task's sink and nothing else. */
|
|
7
7
|
export declare function runWithStatusSink<T>(emit: (s: BrainStatus) => void, fn: () => Promise<T>): Promise<T>;
|
|
8
8
|
/**
|
|
9
|
-
* Run `fn` with every liveness frame its brain calls report stamped with `seat` ({@link BrainStatus.seat})
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* Run `fn` with every liveness frame its brain calls report stamped with `seat` ({@link BrainStatus.seat}) and, when the seat's
|
|
10
|
+
* call is about one tool call, that call's id ({@link BrainStatus.toolCallId}): a nested scope over the ACTIVE sink (the frames
|
|
11
|
+
* still reach the task's stream, unlike a derived leg's no-op shield). A frame that names a seat keeps its own seat and call; the
|
|
12
|
+
* stamp is applied at emit time, so a timer-fired frame carries it; outside a sink the call runs unchanged.
|
|
12
13
|
*/
|
|
13
|
-
export declare function withStatusSeat<T>(seat: BrainStatusSeat, fn: () => T): T;
|
|
14
|
+
export declare function withStatusSeat<T>(seat: BrainStatusSeat, fn: () => T, toolCallId?: string): T;
|
|
14
15
|
/**
|
|
15
16
|
* Report a brain-layer liveness status to the active per-task sink, if any. A no-op outside a
|
|
16
17
|
* {@link runWithStatusSink} scope (e.g. compaction's `complete`, or a brain used standalone).
|
|
@@ -3,11 +3,11 @@ const statusSinkStore = new AsyncLocalStorage();
|
|
|
3
3
|
export function runWithStatusSink(emit, fn) {
|
|
4
4
|
return statusSinkStore.run({ emit }, fn);
|
|
5
5
|
}
|
|
6
|
-
export function withStatusSeat(seat, fn) {
|
|
6
|
+
export function withStatusSeat(seat, fn, toolCallId) {
|
|
7
7
|
const outer = statusSinkStore.getStore();
|
|
8
8
|
if (outer === undefined)
|
|
9
9
|
return fn();
|
|
10
|
-
return statusSinkStore.run({ emit: (s) => outer.emit(s.seat === undefined ? { ...s, seat } : s) }, fn);
|
|
10
|
+
return statusSinkStore.run({ emit: (s) => outer.emit(s.seat === undefined ? { ...s, seat, ...(toolCallId !== undefined ? { toolCallId } : {}) } : s) }, fn);
|
|
11
11
|
}
|
|
12
12
|
export function bindBrainStatusEmitter() {
|
|
13
13
|
const sink = statusSinkStore.getStore();
|
|
@@ -10,6 +10,7 @@ import { bindBrainStatusEmitter, emitBrainStatus, emitBrainTelemetry, reportExtr
|
|
|
10
10
|
import { createAttemptController, firstByteWindow, refuseRetiredTimeoutKnobs, resolveFirstByteRetries, resolveWatchdogMs, STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS, STALL_IDLE_MS, } from "./timeout.js";
|
|
11
11
|
import { readMember, thrownText } from "../core/thrown-value.js";
|
|
12
12
|
import { remoteWords } from "../core/protocol-http-auth.js";
|
|
13
|
+
import { admittedProviderMessage, readProviderMessage } from "./provider-message.js";
|
|
13
14
|
const DEFAULT_MAX_RETRIES = 10;
|
|
14
15
|
const MAX_RETRIES_ENV_CEILING = 15;
|
|
15
16
|
const MAX_RETRIES_ENV = "SEMA_MAX_RETRIES";
|
|
@@ -200,8 +201,6 @@ const THINKING_RETRY_BUDGET = 2;
|
|
|
200
201
|
const EMPTY_USAGE = {
|
|
201
202
|
input: 0,
|
|
202
203
|
output: 0,
|
|
203
|
-
cacheRead: 0,
|
|
204
|
-
cacheWrite: 0,
|
|
205
204
|
totalTokens: 0,
|
|
206
205
|
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
|
|
207
206
|
};
|
|
@@ -369,6 +368,9 @@ export function runStreamingBrain(args) {
|
|
|
369
368
|
if (typeof resetAtMs === "number" && Number.isFinite(resetAtMs))
|
|
370
369
|
errorMsg.providerResetAtMs = resetAtMs;
|
|
371
370
|
}
|
|
371
|
+
const providerMessage = admittedProviderMessage(readMember(err, "providerMessage"));
|
|
372
|
+
if (providerMessage !== undefined)
|
|
373
|
+
errorMsg.providerMessage = providerMessage;
|
|
372
374
|
}
|
|
373
375
|
}
|
|
374
376
|
if (kept === undefined || kept.usageMissing === true)
|
|
@@ -632,6 +634,7 @@ export function runStreamingBrain(args) {
|
|
|
632
634
|
errorBody = await readErrorBody(r, signal);
|
|
633
635
|
const judge = () => r !== undefined && namesTheFailure(r.status) ? judgeHttpFailure({ dialect, status: r.status, headers: r.headers, body: errorBody }) : undefined;
|
|
634
636
|
const verdict = judge();
|
|
637
|
+
const retryMessage = verdict !== undefined ? readProviderMessage(errorBody, req.declared) : undefined;
|
|
635
638
|
const retryableByCondition = netErr !== undefined || (verdict !== undefined && PROVIDER_CONDITION_TRAITS[verdict.condition].retryable);
|
|
636
639
|
const retryable = shouldRetryHeaderVerdict(r) ?? retryableByCondition;
|
|
637
640
|
const connectReading = netErr !== undefined ? readConnectFailure(netErr) : undefined;
|
|
@@ -678,6 +681,7 @@ export function runStreamingBrain(args) {
|
|
|
678
681
|
errClass,
|
|
679
682
|
...(retryStatus !== undefined ? { errorStatus: retryStatus } : {}),
|
|
680
683
|
...(verdict !== undefined ? { providerCondition: verdict.condition, providerConditionSource: verdict.source } : {}),
|
|
684
|
+
...(retryMessage !== undefined ? { providerMessage: retryMessage } : {}),
|
|
681
685
|
}));
|
|
682
686
|
attempt++;
|
|
683
687
|
continue;
|
|
@@ -694,6 +698,7 @@ export function runStreamingBrain(args) {
|
|
|
694
698
|
const status = r?.status ?? 0;
|
|
695
699
|
const itl = terminalVerdict?.inputTooLong ?? "no";
|
|
696
700
|
const providerCode = refusedTheRequest(status) ? readProviderErrorCode(errorBody) : undefined;
|
|
701
|
+
const terminalMessage = terminalVerdict !== undefined ? readProviderMessage(errorBody, req.declared) : undefined;
|
|
697
702
|
const refusedTool = terminalVerdict?.toolSchemaAt !== undefined ? req.toolNames?.[terminalVerdict.toolSchemaAt] : undefined;
|
|
698
703
|
throw new BrainError(classifyHttp(status), `${httpLabel} HTTP ${status || "ERR"}: ${detail.slice(0, 500)}${overflowDeclineNote}`, status, {
|
|
699
704
|
apiError: true,
|
|
@@ -702,6 +707,7 @@ export function runStreamingBrain(args) {
|
|
|
702
707
|
...(refusedTool !== undefined ? { toolSchemaRefused: refusedTool } : {}),
|
|
703
708
|
...(providerCode !== undefined ? { providerCode } : {}),
|
|
704
709
|
...(terminalVerdict !== undefined ? { verdict: { condition: terminalVerdict.condition, source: terminalVerdict.source, ...(terminalVerdict.resetAtMs !== undefined ? { resetAtMs: terminalVerdict.resetAtMs } : {}) } } : {}),
|
|
710
|
+
...(terminalMessage !== undefined ? { providerMessage: terminalMessage } : {}),
|
|
705
711
|
...(errorBody !== undefined && !errorBody.endedNormally ? { errorBodyIncomplete: true } : {}),
|
|
706
712
|
});
|
|
707
713
|
}
|
|
@@ -106,6 +106,18 @@ export interface MemberReader {
|
|
|
106
106
|
array(v: unknown): readonly unknown[] | undefined;
|
|
107
107
|
word(v: unknown): string | undefined;
|
|
108
108
|
count(v: unknown): number | undefined;
|
|
109
|
+
/**
|
|
110
|
+
* A member whose own law lives in a reading elsewhere (the reasoning count: `reasoningTokensOf`): absent and `null` state
|
|
111
|
+
* nothing (`undefined`); anything else is a STATEMENT and is handed on as it came — in no count shape included, so that reading
|
|
112
|
+
* can tell "said nothing" from "said something it cannot read". A statement in no count shape is recorded (`outOfShape`) as
|
|
113
|
+
* `count` records one.
|
|
114
|
+
*/
|
|
115
|
+
claim(v: unknown): unknown;
|
|
116
|
+
/**
|
|
117
|
+
* {@link claim} of `container[key]`. A container in no object shape may have held the member: it states something in no count
|
|
118
|
+
* shape (a value that is no count whatever the container was — `5` would otherwise read as a count), recorded — not an absence.
|
|
119
|
+
*/
|
|
120
|
+
claimIn(container: unknown, key: string): unknown;
|
|
109
121
|
/** Did a member this reader read hold a value in no shape? */
|
|
110
122
|
readonly outOfShape: boolean;
|
|
111
123
|
}
|
|
@@ -50,6 +50,7 @@ export function truncationCauseClause(facts) {
|
|
|
50
50
|
}
|
|
51
51
|
const isCount = (v) => typeof v === "number" && Number.isInteger(v) && v >= 0;
|
|
52
52
|
const countOf = (v) => (isCount(v) ? v : undefined);
|
|
53
|
+
const NOT_A_COUNT = Symbol("a container in no object shape");
|
|
53
54
|
export function memberReader() {
|
|
54
55
|
let outOfShape = false;
|
|
55
56
|
const take = (v, inShape) => {
|
|
@@ -60,11 +61,28 @@ export function memberReader() {
|
|
|
60
61
|
outOfShape = true;
|
|
61
62
|
return undefined;
|
|
62
63
|
};
|
|
64
|
+
const claim = (v) => {
|
|
65
|
+
if (v === null || v === undefined)
|
|
66
|
+
return undefined;
|
|
67
|
+
if (!isCount(v))
|
|
68
|
+
outOfShape = true;
|
|
69
|
+
return v;
|
|
70
|
+
};
|
|
63
71
|
return {
|
|
64
72
|
object: (v) => take(v, (x) => typeof x === "object" && !Array.isArray(x)),
|
|
65
73
|
array: (v) => take(v, Array.isArray),
|
|
66
74
|
word: (v) => take(v, (x) => typeof x === "string"),
|
|
67
75
|
count: (v) => take(v, isCount),
|
|
76
|
+
claim,
|
|
77
|
+
claimIn: (container, key) => {
|
|
78
|
+
if (container === null || container === undefined)
|
|
79
|
+
return undefined;
|
|
80
|
+
if (typeof container !== "object" || Array.isArray(container)) {
|
|
81
|
+
outOfShape = true;
|
|
82
|
+
return NOT_A_COUNT;
|
|
83
|
+
}
|
|
84
|
+
return claim(container[key]);
|
|
85
|
+
},
|
|
68
86
|
get outOfShape() {
|
|
69
87
|
return outOfShape;
|
|
70
88
|
},
|
package/dist/brain/timeout.d.ts
CHANGED
|
@@ -268,6 +268,34 @@ export interface BrainCallGuardrailRef {
|
|
|
268
268
|
/** Set once, by the first call the guardrail gave up on. Absent ⇒ the guardrail never fired. */
|
|
269
269
|
timedOut?: BrainCallGuardrailTimeoutError;
|
|
270
270
|
}
|
|
271
|
+
/**
|
|
272
|
+
* A deadline over the await points of ONE brain call — the race primitive the engine-side guardrail and the model lane's per-hop
|
|
273
|
+
* first-token deadline share. On expiry it does the two independent things the guardrail note describes: it aborts the signal it
|
|
274
|
+
* handed the brain WITH the expiry error as the abort's reason (a cooperative brain cuts its own request, and an observer that reads
|
|
275
|
+
* `signal.reason` — a circuit breaker — sees a coded failure, not a cancellation), and it rejects every raced await with that error,
|
|
276
|
+
* whatever the brain does.
|
|
277
|
+
*/
|
|
278
|
+
export interface BrainCallDeadline {
|
|
279
|
+
/** The signal handed to the brain: outer aborts forward into it, and expiry aborts it (leg a). */
|
|
280
|
+
signal: AbortSignal;
|
|
281
|
+
/** Await `p`, but never past the deadline — and once expired, NOTHING from the brain is accepted. */
|
|
282
|
+
race: <T>(p: Promise<T>) => Promise<T>;
|
|
283
|
+
/** Whether the deadline fired. */
|
|
284
|
+
expired: () => boolean;
|
|
285
|
+
/** Stop the clock only: the deadline will not fire, and outer aborts still reach the brain's signal (the call goes on). */
|
|
286
|
+
stopClock: () => void;
|
|
287
|
+
/** Idempotent: stop the timer and drop the outer-abort listener (the call is over). */
|
|
288
|
+
disarm: () => void;
|
|
289
|
+
/** The brain's terminal event passed: its answer is in, so leaving the call now abandons nothing. The timer keeps bounding
|
|
290
|
+
* `result()`. */
|
|
291
|
+
answered: () => void;
|
|
292
|
+
/** The engine leaves the call. Before its answer is in, the brain's signal is aborted first — once the outer-abort listener is
|
|
293
|
+
* dropped nothing else would tell the brain its call is unwanted — then the gate is disarmed; after it, only disarmed. */
|
|
294
|
+
abandon: () => void;
|
|
295
|
+
}
|
|
296
|
+
/** Arm a {@link BrainCallDeadline} of `limitMs` over a call whose caller holds `outerSignal`; `expire` mints the error the expiry
|
|
297
|
+
* aborts the brain's signal with and rejects every raced await with (called once, when the deadline fires). */
|
|
298
|
+
export declare function armBrainCallDeadline(limitMs: number, outerSignal: AbortSignal | undefined, expire: () => Error): BrainCallDeadline;
|
|
271
299
|
/**
|
|
272
300
|
* Wrap a {@link StreamFn} so the ENGINE never waits longer than `limitMs` for one brain call.
|
|
273
301
|
*
|
package/dist/brain/timeout.js
CHANGED
|
@@ -41,8 +41,7 @@ export function resolveFirstByteRetries(value) {
|
|
|
41
41
|
return FIRST_BYTE_RETRY_BUDGET;
|
|
42
42
|
if (value === 0 || value === 1)
|
|
43
43
|
return value;
|
|
44
|
-
const
|
|
45
|
-
const e = new Error(`firstByteRetries must be 0 or 1 (got ${shown}) — 1 re-sends a first-byte stall once at a widened window (the default), 0 ends the call at the first window so the caller's own failover takes it`);
|
|
44
|
+
const e = new Error(`firstByteRetries must be 0 or 1 (got ${describeRejectedValue(value)}) — 1 re-sends a first-byte stall once at a widened window (the default), 0 ends the call at the first window so the caller's own failover takes it`);
|
|
46
45
|
e.code = "config.stall_timeout_invalid";
|
|
47
46
|
throw e;
|
|
48
47
|
}
|
|
@@ -212,6 +211,13 @@ export function resolveBrainCallGuardrailMs(knob) {
|
|
|
212
211
|
return knob;
|
|
213
212
|
}
|
|
214
213
|
function armCallGuardrail(limitMs, outerSignal, ref) {
|
|
214
|
+
return armBrainCallDeadline(limitMs, outerSignal, () => {
|
|
215
|
+
const err = new BrainCallGuardrailTimeoutError(limitMs);
|
|
216
|
+
ref.timedOut ??= err;
|
|
217
|
+
return err;
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
export function armBrainCallDeadline(limitMs, outerSignal, expire) {
|
|
215
221
|
const ac = new AbortController();
|
|
216
222
|
if (outerSignal !== undefined) {
|
|
217
223
|
if (outerSignal.aborted)
|
|
@@ -231,9 +237,8 @@ function armCallGuardrail(limitMs, outerSignal, ref) {
|
|
|
231
237
|
});
|
|
232
238
|
expiry.catch(() => undefined);
|
|
233
239
|
const timer = setTimeout(() => {
|
|
234
|
-
const err =
|
|
240
|
+
const err = expire();
|
|
235
241
|
expired = err;
|
|
236
|
-
ref.timedOut ??= err;
|
|
237
242
|
ac.abort(err);
|
|
238
243
|
rejectExpiry(err);
|
|
239
244
|
}, limitMs);
|
|
@@ -247,6 +252,10 @@ function armCallGuardrail(limitMs, outerSignal, ref) {
|
|
|
247
252
|
throw expired;
|
|
248
253
|
return value;
|
|
249
254
|
},
|
|
255
|
+
expired: () => expired !== undefined,
|
|
256
|
+
stopClock: () => {
|
|
257
|
+
clearTimeout(timer);
|
|
258
|
+
},
|
|
250
259
|
disarm,
|
|
251
260
|
answered: () => {
|
|
252
261
|
over = true;
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { unescape as percentDecoded } from "node:querystring";
|
|
2
|
+
import { JSON_SCHEMA_SUBSCHEMA_SEATS } from "../core/json-schema-seats.js";
|
|
3
|
+
const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
|
|
4
|
+
const REFERENCE_KEYWORDS = ["$ref", "$dynamicRef"];
|
|
5
|
+
const token = (t) => `/${String(t).replace(/~/g, "~0").replace(/\//g, "~1")}`;
|
|
6
|
+
function typeWordOf(value, declared) {
|
|
7
|
+
const own = typeof value === "string" || typeof value === "boolean" ? typeof value : typeof value === "number" && Number.isFinite(value) ? "number" : undefined;
|
|
8
|
+
if (own === undefined)
|
|
9
|
+
return undefined;
|
|
10
|
+
if (declared === undefined || declared === own)
|
|
11
|
+
return own;
|
|
12
|
+
return declared === "integer" && own === "number" && Number.isInteger(value) ? "integer" : undefined;
|
|
13
|
+
}
|
|
14
|
+
function valueSetOf(node) {
|
|
15
|
+
if (!isRecord(node))
|
|
16
|
+
return undefined;
|
|
17
|
+
const keys = Object.keys(node).filter((k) => k !== "type");
|
|
18
|
+
if (keys.length !== 1 || (keys[0] !== "const" && keys[0] !== "enum"))
|
|
19
|
+
return undefined;
|
|
20
|
+
const values = keys[0] === "const" ? [node.const] : node.enum;
|
|
21
|
+
if (!Array.isArray(values) || values.length === 0)
|
|
22
|
+
return undefined;
|
|
23
|
+
const words = new Set(values.map((v) => typeWordOf(v, node.type)));
|
|
24
|
+
const [type] = words;
|
|
25
|
+
return words.size === 1 && type !== undefined ? { type, values: values } : undefined;
|
|
26
|
+
}
|
|
27
|
+
function foldedUnion(node) {
|
|
28
|
+
if (!Array.isArray(node.anyOf) || node.anyOf.length === 0 || Object.hasOwn(node, "enum"))
|
|
29
|
+
return undefined;
|
|
30
|
+
const sets = node.anyOf.map(valueSetOf);
|
|
31
|
+
const type = sets[0]?.type;
|
|
32
|
+
if (type === undefined || !sets.every((s) => s?.type === type))
|
|
33
|
+
return undefined;
|
|
34
|
+
const values = [...new Set(sets.flatMap((s) => s.values))];
|
|
35
|
+
const out = {};
|
|
36
|
+
for (const [k, v] of Object.entries(node)) {
|
|
37
|
+
if (k !== "anyOf")
|
|
38
|
+
out[k] = v;
|
|
39
|
+
else {
|
|
40
|
+
if (!Object.hasOwn(node, "type"))
|
|
41
|
+
out.type = type;
|
|
42
|
+
out.enum = values;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return out;
|
|
46
|
+
}
|
|
47
|
+
function* children(node, pointer) {
|
|
48
|
+
for (const [key, value] of Object.entries(node)) {
|
|
49
|
+
const seat = JSON_SCHEMA_SUBSCHEMA_SEATS.get(key);
|
|
50
|
+
if (seat === undefined)
|
|
51
|
+
continue;
|
|
52
|
+
const at = pointer + token(key);
|
|
53
|
+
if (seat === "schema" && !Array.isArray(value))
|
|
54
|
+
yield [key, undefined, value, at];
|
|
55
|
+
else if (Array.isArray(value))
|
|
56
|
+
for (const [i, sub] of value.entries())
|
|
57
|
+
yield [key, i, sub, at + token(i)];
|
|
58
|
+
else if (isRecord(value))
|
|
59
|
+
for (const [name, sub] of Object.entries(value))
|
|
60
|
+
yield [key, name, sub, at + token(name)];
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
function keptUnions(root) {
|
|
64
|
+
const kept = new Set();
|
|
65
|
+
const seen = new Set();
|
|
66
|
+
const visit = (node) => {
|
|
67
|
+
if (!isRecord(node) || seen.has(node))
|
|
68
|
+
return;
|
|
69
|
+
seen.add(node);
|
|
70
|
+
for (const k of REFERENCE_KEYWORDS) {
|
|
71
|
+
const ref = node[k];
|
|
72
|
+
if (typeof ref !== "string" || !ref.startsWith("#/"))
|
|
73
|
+
continue;
|
|
74
|
+
const tokens = percentDecoded(ref.slice(1)).split("/").slice(1);
|
|
75
|
+
tokens.forEach((t, i) => t === "anyOf" && kept.add(tokens.slice(0, i).map((x) => `/${x}`).join("")));
|
|
76
|
+
}
|
|
77
|
+
for (const [, , sub] of children(node, ""))
|
|
78
|
+
visit(sub);
|
|
79
|
+
};
|
|
80
|
+
visit(root);
|
|
81
|
+
return kept;
|
|
82
|
+
}
|
|
83
|
+
function project(node, pointer, walk) {
|
|
84
|
+
if (!isRecord(node) || walk.ancestors.has(node))
|
|
85
|
+
return node;
|
|
86
|
+
walk.ancestors.add(node);
|
|
87
|
+
let out;
|
|
88
|
+
for (const [key, name, sub, at] of children(node, pointer)) {
|
|
89
|
+
const next = project(sub, at, walk);
|
|
90
|
+
if (next === sub)
|
|
91
|
+
continue;
|
|
92
|
+
out ??= { ...node };
|
|
93
|
+
if (name === undefined)
|
|
94
|
+
out[key] = next;
|
|
95
|
+
else {
|
|
96
|
+
const declared = node[key];
|
|
97
|
+
if (out[key] === declared)
|
|
98
|
+
out[key] = Array.isArray(declared) ? [...declared] : { ...declared };
|
|
99
|
+
out[key][name] = next;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
walk.ancestors.delete(node);
|
|
103
|
+
const current = out ?? node;
|
|
104
|
+
return walk.kept.has(pointer) ? current : (foldedUnion(current) ?? current);
|
|
105
|
+
}
|
|
106
|
+
export function projectToolSchema(schema) {
|
|
107
|
+
return project(schema, "", { ancestors: new Set(), kept: keptUnions(schema) });
|
|
108
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The ONE reading of what a provider's usage frames stated, for the three first-party wire adapters: each adapter merges its own
|
|
3
|
+
* frames and maps its own spellings onto a {@link UsageStatement}; what a statement MEANS is decided here, once.
|
|
4
|
+
*
|
|
5
|
+
* The law, member by member:
|
|
6
|
+
* - a member is STATED when a frame carried a count for it; `undefined` / `null` state nothing. A member that holds something that
|
|
7
|
+
* is no count (a string, a fraction, a negative) is a statement nobody can read: the usage is unknown (`missing`) and the member
|
|
8
|
+
* reads as not stated;
|
|
9
|
+
* - `input` and `output` are the necessary operands of every total: either one not stated makes the usage `missing` (its numbers
|
|
10
|
+
* are then a lower bound, as everywhere a usage is `usageMissing`) and reads as 0 in those numbers;
|
|
11
|
+
* - `cacheRead` and `cacheWrite` are left ABSENT on the {@link Usage} when not stated — absent is "not reported", never 0 (the
|
|
12
|
+
* same law `Usage.reasoning` follows). A stated 0 is a measured 0 and is kept.
|
|
13
|
+
* - `cacheWriteLong` is the part of `cacheWrite` the wire says was written at the one-hour lifetime: a SUBSET of it, absent when
|
|
14
|
+
* the wire did not state the split, and read by the subset law `reasoning` follows — a count beyond the writes it is a part of
|
|
15
|
+
* (or one with no write count beside it, a stated 0 included) is not recorded and the usage is unknown (`missing`). The write count stays the
|
|
16
|
+
* total of both lifetimes; the cost lines price the two parts at their own rates.
|
|
17
|
+
*
|
|
18
|
+
* Merging is the adapter's business, and so is deciding what counts as a statement across frames (the Anthropic closing frame's
|
|
19
|
+
* 0 for an input or a cache count says "unchanged", not "0", so the adapter does not take it). This reading only sees the
|
|
20
|
+
* merged statement.
|
|
21
|
+
*
|
|
22
|
+
* How the wire counts its input against the cache is its {@link CacheFamily}: an `input-excludes-cached` wire (Anthropic) adds the
|
|
23
|
+
* cache counts to its total and prices them at their own rates; an `input-includes-cached` wire (the OpenAI shapes) states its
|
|
24
|
+
* own total when it has one and prices the cached part inside `input` (its cache cost lines are 0).
|
|
25
|
+
*/
|
|
26
|
+
import type { Model, Usage } from "../internal/llm.js";
|
|
27
|
+
import type { CacheFamily } from "../core/runner/usage-accounting.js";
|
|
28
|
+
import { type ReasoningReading } from "./usage-reasoning.js";
|
|
29
|
+
/** What a provider's merged usage frames carried, per member, as it came (`undefined` = the member was not stated). */
|
|
30
|
+
export interface UsageStatement {
|
|
31
|
+
readonly input?: unknown;
|
|
32
|
+
readonly output?: unknown;
|
|
33
|
+
readonly cacheRead?: unknown;
|
|
34
|
+
readonly cacheWrite?: unknown;
|
|
35
|
+
/** The part of `cacheWrite` the wire says was written at the one-hour lifetime; absent ⇒ the wire did not state the split. */
|
|
36
|
+
readonly cacheWriteLong?: unknown;
|
|
37
|
+
/** The wire's own total, on a wire that states one (the OpenAI shapes); absent ⇒ the total is the sum of the stated parts. */
|
|
38
|
+
readonly total?: unknown;
|
|
39
|
+
}
|
|
40
|
+
/** The reading of one statement: the usage to record, and whether it is unknown (`missing` — the adapter's `usageMissing`). */
|
|
41
|
+
export interface UsageReading {
|
|
42
|
+
readonly usage: Usage;
|
|
43
|
+
readonly missing: boolean;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Read `statement` under the wire's cache family, at `model`'s declared price; `reasoning` is the wire's reasoning reading (its
|
|
47
|
+
* `unreadable` makes the usage unknown, as it always has).
|
|
48
|
+
*/
|
|
49
|
+
export declare function usageOfStatement(model: Model, family: CacheFamily, statement: UsageStatement, reasoning: ReasoningReading): UsageReading;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { isExactCount } from "./usage-reasoning.js";
|
|
2
|
+
export function usageOfStatement(model, family, statement, reasoning) {
|
|
3
|
+
let unreadable = false;
|
|
4
|
+
const stated = (v) => {
|
|
5
|
+
if (v === undefined || v === null)
|
|
6
|
+
return undefined;
|
|
7
|
+
if (isExactCount(v))
|
|
8
|
+
return v;
|
|
9
|
+
unreadable = true;
|
|
10
|
+
return undefined;
|
|
11
|
+
};
|
|
12
|
+
const inputStated = stated(statement.input);
|
|
13
|
+
const outputStated = stated(statement.output);
|
|
14
|
+
const cacheRead = stated(statement.cacheRead);
|
|
15
|
+
const cacheWrite = stated(statement.cacheWrite);
|
|
16
|
+
const longStated = stated(statement.cacheWriteLong);
|
|
17
|
+
const subsetBroken = longStated !== undefined && (cacheWrite === undefined || longStated > cacheWrite);
|
|
18
|
+
if (subsetBroken)
|
|
19
|
+
unreadable = true;
|
|
20
|
+
const cacheWriteLong = subsetBroken ? undefined : longStated;
|
|
21
|
+
const totalStated = stated(statement.total);
|
|
22
|
+
const input = inputStated ?? 0;
|
|
23
|
+
const output = outputStated ?? 0;
|
|
24
|
+
const c = model.cost;
|
|
25
|
+
const costInput = (input / 1e6) * (c?.input ?? 0);
|
|
26
|
+
const costOutput = (output / 1e6) * (c?.output ?? 0);
|
|
27
|
+
const excludes = family === "input-excludes-cached";
|
|
28
|
+
const totalTokens = excludes ? input + output + (cacheRead ?? 0) + (cacheWrite ?? 0) : (totalStated ?? input + output);
|
|
29
|
+
const costCacheRead = excludes ? ((cacheRead ?? 0) / 1e6) * (c?.cacheRead ?? 0) : 0;
|
|
30
|
+
const costCacheWrite = excludes
|
|
31
|
+
? (((cacheWrite ?? 0) - (cacheWriteLong ?? 0)) / 1e6) * (c?.cacheWrite ?? 0) + ((cacheWriteLong ?? 0) / 1e6) * (c?.cacheWriteLong ?? c?.cacheWrite ?? 0)
|
|
32
|
+
: 0;
|
|
33
|
+
const usage = {
|
|
34
|
+
input,
|
|
35
|
+
output,
|
|
36
|
+
...(cacheRead !== undefined ? { cacheRead } : {}),
|
|
37
|
+
...(cacheWrite !== undefined ? { cacheWrite } : {}),
|
|
38
|
+
...(cacheWriteLong !== undefined ? { cacheWriteLong } : {}),
|
|
39
|
+
totalTokens,
|
|
40
|
+
...(reasoning.reasoning !== undefined ? { reasoning: reasoning.reasoning } : {}),
|
|
41
|
+
cost: { input: costInput, output: costOutput, cacheRead: costCacheRead, cacheWrite: costCacheWrite, total: costInput + costOutput + costCacheRead + costCacheWrite },
|
|
42
|
+
};
|
|
43
|
+
return { usage, missing: inputStated === undefined || outputStated === undefined || unreadable || reasoning.unreadable };
|
|
44
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How many of a reply's output tokens the provider spent reasoning, read ONE way for every reader of a provider's usage in
|
|
3
|
+
* this tree: the three wire adapters and the failover lane's copy of a message's usage.
|
|
4
|
+
*
|
|
5
|
+
* `Usage.reasoning` is a SUBSET of `Usage.output`: it is never added to the totals and never priced (output already counts it).
|
|
6
|
+
* It is also absent, not zero, when the provider said nothing — a measured zero and "not reported" are different statements.
|
|
7
|
+
*
|
|
8
|
+
* The wire spellings stay each adapter's own (the member is read where its provider names it, in the shape judge that
|
|
9
|
+
* adapter already uses); what lives here is the part that must be the same everywhere:
|
|
10
|
+
* - priority — the first spelling that stated anything is the provider's statement, later ones are not consulted. A spelling that
|
|
11
|
+
* stated something in no count shape (a string, an object, `null` here, a container that could not hold it) STATES: it is the
|
|
12
|
+
* statement, and it is unreadable — it is never skipped for the next spelling's count, so the gates hand a statement on as it
|
|
13
|
+
* came and only an ABSENT spelling is `undefined`;
|
|
14
|
+
* - the count's own law — a whole number from zero that a number states exactly (no more than 2^53 - 1: past it the wire's
|
|
15
|
+
* digits were rounded on the way in, so the value read is not the value sent, and "equal to the output" proves nothing);
|
|
16
|
+
* - the subset law — a count larger than the output it is a part of cannot be that part.
|
|
17
|
+
* A count that breaks either law is not clamped (that would book a number the provider never said) and not kept (the usage
|
|
18
|
+
* would contradict itself): the member is left absent and the reading says `unreadable`, which each caller turns into the
|
|
19
|
+
* usage-unknown mark it already uses for a usage member in no shape.
|
|
20
|
+
*/
|
|
21
|
+
/** The reading of one usage's reasoning count. */
|
|
22
|
+
export interface ReasoningReading {
|
|
23
|
+
/** The count to record: set only when a spelling carried a count that is exact and fits within the output. */
|
|
24
|
+
readonly reasoning?: number;
|
|
25
|
+
/** A spelling carried a count that cannot be recorded: not an exact whole number from zero, or larger than the output it is a part of. */
|
|
26
|
+
readonly unreadable: boolean;
|
|
27
|
+
}
|
|
28
|
+
/** A whole number from zero that a number states exactly: the one count law of every token member a usage reading records. */
|
|
29
|
+
export declare const isExactCount: (v: unknown) => v is number;
|
|
30
|
+
/**
|
|
31
|
+
* @param output the usage's output count (an absent output reads as 0 — a reasoning count with no output beside it is unreadable)
|
|
32
|
+
* @param spellings what the provider's spellings carried, highest priority first; `undefined` = that spelling absent (a wire gate
|
|
33
|
+
* reads an absent member and a `null` as `undefined` and hands every other value on as it came). Anything
|
|
34
|
+
* but an exact count (a string, `null`, an object, a fraction, a negative, a number past 2^53 - 1) is unreadable: the count's own
|
|
35
|
+
* law is judged here whatever shape judge the caller ran first, so a caller whose reader is looser (the wire readers accept any
|
|
36
|
+
* whole number) or has none (the lane copy) is held to the same law.
|
|
37
|
+
*/
|
|
38
|
+
export declare function reasoningTokensOf(output: number | undefined, ...spellings: readonly unknown[]): ReasoningReading;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export const isExactCount = (v) => Number.isSafeInteger(v) && v >= 0;
|
|
2
|
+
export function reasoningTokensOf(output, ...spellings) {
|
|
3
|
+
const claimed = spellings.find((count) => count !== undefined);
|
|
4
|
+
if (claimed === undefined)
|
|
5
|
+
return { unreadable: false };
|
|
6
|
+
if (!isExactCount(claimed) || claimed > (output ?? 0))
|
|
7
|
+
return { unreadable: true };
|
|
8
|
+
return { reasoning: claimed, unreadable: false };
|
|
9
|
+
}
|
package/dist/config/catalog.d.ts
CHANGED
|
@@ -26,6 +26,9 @@ export interface ConfigKnob {
|
|
|
26
26
|
key: string;
|
|
27
27
|
/** The recommended value. `null` = deliberately UNSET (the summary says what unset means). */
|
|
28
28
|
recommended: number | boolean | string | null;
|
|
29
|
+
/** What the engine applies when nothing sets the knob (`null` = no bound): one fixed value, absent where it is derived (the
|
|
30
|
+
* summary says how). A fact about the engine, where {@link recommended} is advice; `config.assembled` reports `default` from here. */
|
|
31
|
+
default?: number | boolean | string | null;
|
|
29
32
|
unit?: "turns" | "seconds" | "ms" | "days" | "usd" | "tokens" | "count";
|
|
30
33
|
/** What kind of knob this is: a runaway safety net, a spend bound, a behavior switch, retention. */
|
|
31
34
|
kind: "safety-net" | "budget" | "behavior" | "retention";
|