@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
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import type { PromptEpochDescriptor } from "../../prompt-assembly/epoch.js";
|
|
2
|
-
import type { DocumentContent, ImageContent, Model, SimpleStreamOptions, TextContent, Transport } from "../llm/index.js";
|
|
2
|
+
import type { AssistantMessage, DocumentContent, ImageContent, Model, SimpleStreamOptions, TextContent, Transport } from "../llm/index.js";
|
|
3
3
|
import type { AfterToolCallResult, AgentEvent, AgentMessage, AgentTool, BeforeToolCallResult, QueueMode, ThinkingLevel } from "../loop/types.js";
|
|
4
4
|
import type { AgentCoreRuntimeDeps } from "../loop/runtime-deps.js";
|
|
5
5
|
import type { SecretEnvFinding } from "../../core/secret-env.js";
|
|
6
|
+
import type { CommandSandboxInstruction, ConfinementRefusal } from "../../core/command-sandbox.js";
|
|
7
|
+
import type { SessionRepoRowCells } from "../session/row-cells.js";
|
|
6
8
|
/** Result of a fallible operation. Expected failures are returned as `ok: false` instead of thrown. */
|
|
7
9
|
export type Result<TValue, TError> = {
|
|
8
10
|
ok: true;
|
|
@@ -71,8 +73,6 @@ export interface AgentHarnessStreamOptions {
|
|
|
71
73
|
headers?: Record<string, string>;
|
|
72
74
|
/** Provider metadata forwarded with requests. */
|
|
73
75
|
metadata?: SimpleStreamOptions["metadata"];
|
|
74
|
-
/** Provider cache retention hint. */
|
|
75
|
-
cacheRetention?: SimpleStreamOptions["cacheRetention"];
|
|
76
76
|
}
|
|
77
77
|
/** Per-request stream option patch returned by provider hooks. */
|
|
78
78
|
export interface AgentHarnessStreamOptionsPatch extends Omit<Partial<AgentHarnessStreamOptions>, "headers" | "metadata"> {
|
|
@@ -196,7 +196,22 @@ export type ExecutionErrorCode = "aborted" | "timeout"
|
|
|
196
196
|
* 2026-07-13 contract above; the Bash dead-cwd diagnosis hangs off it) and `suspended` claims a paused
|
|
197
197
|
* workspace this arm does not have. Spelling note: landed per design/380's arm (b); the device lane's
|
|
198
198
|
* wire-word mapping may re-spell at the server's wire freeze. */
|
|
199
|
-
| "target_unavailable"
|
|
199
|
+
| "target_unavailable"
|
|
200
|
+
/** The target judged the command by its OWN policy before starting it and said no (a path, argument or permission verdict a device
|
|
201
|
+
* adapter reads off the target's answer: already exists, invalid, is a directory, permission denied, precondition failed): the
|
|
202
|
+
* command NEVER STARTED, nothing ran and no effect landed, and — the verdict being a function of the command and the working
|
|
203
|
+
* directory, not of time — the same command from the same directory is refused the same way. The honest word for an explicit
|
|
204
|
+
* refusal that would otherwise fold into `"unknown"`, whose model-visible sentence says the outcome could not be determined and
|
|
205
|
+
* to verify effects (so the model issues a check that cannot help, and a run in an asking mode shows the person a card for it).
|
|
206
|
+
* Not `target_unavailable` (the target is gone; a retry is safe once it is back), not `spawn_error` (the OS-level spawn failed:
|
|
207
|
+
* dead cwd, missing binary), not `suspended` (a paused workspace). A refusal that is really about the working directory
|
|
208
|
+
* (gone, or no longer a directory) still ends at the Bash tool's dead-cwd diagnosis. */
|
|
209
|
+
| "refused"
|
|
210
|
+
/** The start's confinement could not be had, so the command NEVER STARTED: an entry of its sandbox boundary
|
|
211
|
+
* ({@link ExecutionEnvExecOptions.sandbox}) or a row of its byte floor ({@link ExecutionEnvExecOptions.readFloor}) the
|
|
212
|
+
* environment cannot keep, or a sandbox that cannot start at all — {@link ExecutionError.refusedBy} says which. The ONE word
|
|
213
|
+
* for "refused rather than run with less confinement than the start carries"; not `spawn_error` (the OS-level spawn failed). */
|
|
214
|
+
| "sandbox_unavailable" | "unknown";
|
|
200
215
|
/** Error returned by {@link ExecutionEnv.exec}. */
|
|
201
216
|
export declare class ExecutionError extends Error {
|
|
202
217
|
/** Backend-independent error code. */
|
|
@@ -215,6 +230,10 @@ export declare class ExecutionError extends Error {
|
|
|
215
230
|
partialStderr?: string;
|
|
216
231
|
/** `liveness_no_output` only: the silence window (whole seconds) that cut the command — the env's bound, never the requested budget; absent = not stated. */
|
|
217
232
|
noOutputSec?: number;
|
|
233
|
+
/** `sandbox_unavailable` only: `"this_call"` — an entry of THIS start's confinement cannot be kept (a start with another
|
|
234
|
+
* boundary or floor may still run); `"environment"` — the sandbox itself cannot start, so no start can. Absent ⇒ read as
|
|
235
|
+
* `"environment"` (a refusal that cannot tell reads the stricter way). */
|
|
236
|
+
refusedBy?: ConfinementRefusal;
|
|
218
237
|
constructor(code: ExecutionErrorCode, message: string, cause?: Error, partial?: {
|
|
219
238
|
stdout?: string;
|
|
220
239
|
stderr?: string;
|
|
@@ -243,6 +262,11 @@ export declare class AgentHarnessError extends Error {
|
|
|
243
262
|
code: AgentHarnessErrorCode;
|
|
244
263
|
constructor(code: AgentHarnessErrorCode, message: string, cause?: Error);
|
|
245
264
|
}
|
|
265
|
+
/** A prompt that opens its turn on the input queued for it found none queued once the turn-open hooks had run. Refused before
|
|
266
|
+
* the run starts: no message is written and no model request is made. */
|
|
267
|
+
export declare class NothingQueuedError extends AgentHarnessError {
|
|
268
|
+
constructor();
|
|
269
|
+
}
|
|
246
270
|
/**
|
|
247
271
|
* The PERSISTED placement tuple of a session created into a placement partition (subagent
|
|
248
272
|
* transcript persistence — the durable half of the delegation continuation contract). Written ONCE
|
|
@@ -349,6 +373,11 @@ export interface ExecutionEnvExecOptions {
|
|
|
349
373
|
/** VENDORED EDIT (the byte floor) — the read-deny table this start judges with ({@link ReadFloor}): a call's own pinned table, else the run's; every start a run makes carries it, whether or not its output reaches the model.
|
|
350
374
|
* What its processes OPEN is the environment's to keep ({@link ExecutionEnvCapabilities.keepsReadFloor}). Absent ⇔ the table holds no row, or the start is no run's (`runExecGate`, the oracle's isolation probe). */
|
|
351
375
|
readFloor?: ReadFloor;
|
|
376
|
+
/** The OS sandbox this start runs in ({@link CommandSandboxInstruction}): the start runs with every entry of its boundary
|
|
377
|
+
* kept — beside every row of `readFloor` — or does not start (`sandbox_unavailable`); never kept in part, never started
|
|
378
|
+
* without it. Carried only to an environment that declares {@link ExecutionEnvCapabilities.commandSandbox}, only by a start
|
|
379
|
+
* a model-written command makes in a run that requires the sandbox. Absent ⇒ the start runs as it always did. */
|
|
380
|
+
sandbox?: CommandSandboxInstruction;
|
|
352
381
|
}
|
|
353
382
|
/** The read-deny table one command start carries ({@link ExecutionEnvExecOptions.readFloor}); what an environment keeps of it is INTEGRATION-CORE §11.1.
|
|
354
383
|
* Path semantics: a path is judged as spelled, never resolved (a hard link is another path; a symbolic link is resolved where the environment opens it). Pinned at the start: a floor with an `id` judges with that start's table for its processes' life. Exec is no read: a `#!` line's bytes, a self-printing binary (KNOWN-LIMITS KL-3190-a). */
|
|
@@ -392,8 +421,12 @@ export interface FileSystem {
|
|
|
392
421
|
maxLines?: number;
|
|
393
422
|
abortSignal?: AbortSignal;
|
|
394
423
|
}): Promise<Result<string[], FileError>>;
|
|
395
|
-
/** Read a binary file.
|
|
396
|
-
|
|
424
|
+
/** Read a binary file. `maxBytes` (optional, a non-negative whole number): the read stops at that many bytes — a longer file is
|
|
425
|
+
* answered as its first `maxBytes` bytes and no more is read or held, so a caller that must know a file is past a cap asks for the
|
|
426
|
+
* cap plus one and judges the length it was answered. Absent ⇒ the whole file (the answer before the parameter existed). Any other
|
|
427
|
+
* value (negative, `NaN`, not whole, not a number) is refused (`invalid`), never read as "no limit". An environment that does not
|
|
428
|
+
* read the parameter answers the whole file: a caller judges the length it was answered, never the parameter it passed. */
|
|
429
|
+
readBinaryFile(path: string, abortSignal?: AbortSignal, maxBytes?: number): Promise<Result<Uint8Array, FileError>>;
|
|
397
430
|
/** Create or overwrite a file, creating parent directories when supported. Implementation note
|
|
398
431
|
* (RB-221): the Node env replaces the file as a WHOLE (same-directory staging + fsync +
|
|
399
432
|
* rename; `aborted` ⇒ target untouched), falling back to an in-place rewrite where rename cannot
|
|
@@ -517,7 +550,7 @@ export interface Shell {
|
|
|
517
550
|
*
|
|
518
551
|
* Every key is REQUIRED and has no default reading: for each one, either answer an absent value could be given is
|
|
519
552
|
* wrong for some environment, so an adapter states it. A value that is absent, not a boolean, or cannot be received (a
|
|
520
|
-
* throwing getter, a Proxy — a JS adapter's block) — and a member outside the
|
|
553
|
+
* throwing getter, a Proxy — a JS adapter's block) — and a member outside the nine keys — is announced once per run at
|
|
521
554
|
* the admission point (`config.execution_env_capability_invalid`, `detail.key` naming it, or `capabilities` for a block
|
|
522
555
|
* that is no object or cannot be received), and each reader takes that key's SAFE side, written beside the readers
|
|
523
556
|
* (`UNDECLARED_CAPABILITY_READING`, `src/core/remote-env.ts`). Every key is read through its one reader there.
|
|
@@ -614,6 +647,14 @@ export interface ExecutionEnvCapabilities {
|
|
|
614
647
|
* at prepare when the deployment sets `RunnerDeps.readDenyFloorRequired`. `StubExecutionEnv` declares `true`:
|
|
615
648
|
* it refuses every start, so no byte can be read through it. Undeclared ⇒ `false`. Read through `keepsReadFloor`. */
|
|
616
649
|
readonly keepsReadFloor: boolean;
|
|
650
|
+
/** True iff this environment keeps a command start inside the OS sandbox the start carries
|
|
651
|
+
* ({@link ExecutionEnvExecOptions.sandbox}): every entry of its boundary, its byte floor's rows beside them, kept for every
|
|
652
|
+
* program the command runs — or the start is refused (`sandbox_unavailable`, naming the entry), never run with fewer. A run
|
|
653
|
+
* that requires the sandbox (`TaskSpec.sandbox.enabled`) runs its model-written commands in it only here; elsewhere it is
|
|
654
|
+
* refused at prepare, or — when the task sets `failIfUnavailable: false` — announced (`config.command_sandbox_unavailable`)
|
|
655
|
+
* and run unsandboxed. `false` for an environment that has no such sandbox (`NodeExecutionEnv`, an SSH host, a device).
|
|
656
|
+
* `StubExecutionEnv` declares `true`: it refuses every start. Undeclared ⇒ `false`. Read through `providesCommandSandbox`. */
|
|
657
|
+
readonly commandSandbox: boolean;
|
|
617
658
|
}
|
|
618
659
|
/** Filesystem and process execution environment used by the harness. */
|
|
619
660
|
export interface ExecutionEnv extends FileSystem, Shell {
|
|
@@ -785,7 +826,16 @@ export interface AnnouncedListingSnapshot {
|
|
|
785
826
|
mcpFailed?: AnnouncedMcpFailure[];
|
|
786
827
|
advisories?: string[];
|
|
787
828
|
advisor?: AnnouncedAdvisorState;
|
|
829
|
+
language?: AnnouncedLanguageState;
|
|
830
|
+
}
|
|
831
|
+
/** What the model was told about the reply language (`TaskSpec.language`), and in which SEGMENT (the advisor arm's reading):
|
|
832
|
+
* `value` is the language stated, `null` the cleared preference. A record from another segment reads as nothing told. */
|
|
833
|
+
export interface AnnouncedLanguageState {
|
|
834
|
+
value: string | null;
|
|
835
|
+
segment: string | null;
|
|
788
836
|
}
|
|
837
|
+
/** The language seat's bound — the reference's own (`string().max(256)`) — and the record's, so a stated language is recordable. */
|
|
838
|
+
export declare const ANNOUNCED_LANGUAGE_MAX_CHARS = 256;
|
|
789
839
|
/** What the model was told about the advisor tool, and in which SEGMENT of the conversation — the id of the branch's
|
|
790
840
|
* latest compaction entry when the telling was delivered, `null` before any. A record from another segment reads as
|
|
791
841
|
* nothing told: a compaction summarized the telling away. */
|
|
@@ -801,6 +851,7 @@ export interface AnnouncedListingSnapshotInput {
|
|
|
801
851
|
mcpFailed?: ReadonlyArray<AnnouncedMcpFailure>;
|
|
802
852
|
advisories?: readonly string[];
|
|
803
853
|
advisor?: Readonly<AnnouncedAdvisorState>;
|
|
854
|
+
language?: Readonly<AnnouncedLanguageState>;
|
|
804
855
|
}
|
|
805
856
|
/**
|
|
806
857
|
* REF-D3/D4 merge target: the active EnterWorktree session (M22 live-CC anchor —
|
|
@@ -1114,10 +1165,12 @@ export interface SessionMetadata {
|
|
|
1114
1165
|
export type SessionRow<TMetadata extends SessionMetadata = SessionMetadata> = TMetadata & {
|
|
1115
1166
|
readonly lastActiveAt?: number;
|
|
1116
1167
|
};
|
|
1117
|
-
/** One row's owner, occupant (
|
|
1168
|
+
/** One row's owner, occupant (absent = unknown) and active leaf (`null` = none), read in ONE read so the three answer for one row generation.
|
|
1169
|
+
* A head the bundled repos build names no `incarnation` key when the row's occupant is unknown (a host-held row, a row that predates the
|
|
1170
|
+
* cell): the key is present only with a token, so "present" and "defined" are one reading. */
|
|
1118
1171
|
export interface SessionHead {
|
|
1119
1172
|
readonly owner: string | null;
|
|
1120
|
-
readonly incarnation
|
|
1173
|
+
readonly incarnation?: string | undefined;
|
|
1121
1174
|
readonly leafId: string | null;
|
|
1122
1175
|
}
|
|
1123
1176
|
/** Where a log stood when read: its entry count and last entry id (`null` = empty). Every append adds an id the log never held, so an
|
|
@@ -1129,11 +1182,13 @@ export interface SessionLogMark {
|
|
|
1129
1182
|
/** What a conditional write of a session row expects of the row, judged by the repo INSIDE the write's own step (`sessionRowMatches`); a
|
|
1130
1183
|
* miss is refused `SessionError("conflict")` with nothing written, as the leaf CAS refuses a stale append. It is the row as a read of it
|
|
1131
1184
|
* answered: `row` = that read's owner and occupant cell (a {@link SessionHead} serves; `null` = no row), `log` (when the log binds) = the
|
|
1132
|
-
* log's mark as read — a replacement judged against the log binds it, a deletion owed to the occupant does not.
|
|
1185
|
+
* log's mark as read — a replacement judged against the log binds it, a deletion owed to the occupant does not. A repo whose host holds
|
|
1186
|
+
* the occupant cells ({@link SessionRepoRowCells} `"host"`) judges the owner and the log, and refuses an expectation naming an
|
|
1187
|
+
* occupant (a `TypeError`): its host's store judges that one. */
|
|
1133
1188
|
export interface SessionRowExpectation {
|
|
1134
1189
|
readonly row: {
|
|
1135
1190
|
readonly owner: string | null;
|
|
1136
|
-
readonly incarnation
|
|
1191
|
+
readonly incarnation?: string | undefined;
|
|
1137
1192
|
} | null;
|
|
1138
1193
|
readonly log?: SessionLogMark;
|
|
1139
1194
|
}
|
|
@@ -1307,6 +1362,9 @@ export interface SessionForkOptions {
|
|
|
1307
1362
|
id?: string;
|
|
1308
1363
|
}
|
|
1309
1364
|
export interface SessionRepo<TMetadata extends SessionMetadata = SessionMetadata, TCreateOptions extends SessionCreateOptions = SessionCreateOptions, TListOptions = void> {
|
|
1365
|
+
/** Who holds this repo's rows' occupant cells ({@link SessionRepoRowCells}); absent reads as `"engine"` — the repo does. A repo whose
|
|
1366
|
+
* host holds them (`"host"`) writes and hands out neither cell, and `TtlSessionStore` refuses it (that layer has no occupant source). */
|
|
1367
|
+
readonly rowCells?: SessionRepoRowCells;
|
|
1310
1368
|
create(options: TCreateOptions): Promise<Session<TMetadata>>;
|
|
1311
1369
|
open(metadata: TMetadata): Promise<Session<TMetadata>>;
|
|
1312
1370
|
/** Every ordinary row (placed rows are not listed), each with the newest write the repo holds for it ({@link SessionRow}), in no
|
|
@@ -1319,6 +1377,12 @@ export interface SessionRepo<TMetadata extends SessionMetadata = SessionMetadata
|
|
|
1319
1377
|
* removal's own step and on a miss — no row, another generation, or (when the log binds) another log — removes nothing and refuses
|
|
1320
1378
|
* `SessionError("conflict")` ({@link readRow}: which repos judge it). */
|
|
1321
1379
|
delete(metadata: TMetadata, expect?: SessionRowExpectation): Promise<void>;
|
|
1380
|
+
/** Remove the row only while its head cannot be read: in the removal's own step the repo reads the head, and only a read refused
|
|
1381
|
+
* `SessionError("corrupt_session")` removes the row and its whole log and answers `true`; a readable row or no row removes nothing and
|
|
1382
|
+
* answers `false`; any other fault of that read rejects with it, nothing removed. It reads neither owner nor occupant (an unreadable
|
|
1383
|
+
* row has none to name). Optional: a repo whose rows cannot be unreadable has none, and `TtlSessionStore` then offers no
|
|
1384
|
+
* `deleteUnreadable`. */
|
|
1385
|
+
deleteUnreadable?(sessionId: string): Promise<boolean>;
|
|
1322
1386
|
/** A fork is a NEW row: `options.id` equal to the source's id is refused (`invalid_fork_target`) — onto its source it would mint a new occupant over the source's own transcript. */
|
|
1323
1387
|
fork(source: TMetadata, options: SessionForkOptions & TCreateOptions): Promise<Session<TMetadata>>;
|
|
1324
1388
|
/**
|
|
@@ -1431,6 +1495,8 @@ export interface TurnBoundaryEvent {
|
|
|
1431
1495
|
model: Model;
|
|
1432
1496
|
/** The loop's continuation fact, as defined at {@link import("../loop/types.js").PrepareNextTurnContext.continues}. */
|
|
1433
1497
|
continues: boolean;
|
|
1498
|
+
/** The assistant message that completed the turn just ended (the loop's `PrepareNextTurnContext.message`). */
|
|
1499
|
+
message: AssistantMessage;
|
|
1434
1500
|
}
|
|
1435
1501
|
export interface BeforeProviderRequestEvent {
|
|
1436
1502
|
type: "before_provider_request";
|
|
@@ -1678,6 +1744,9 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
|
|
|
1678
1744
|
text: string;
|
|
1679
1745
|
cacheControlBoundary: boolean;
|
|
1680
1746
|
}>;
|
|
1747
|
+
/** The locale of the engine's own texts this leg sends (`TaskSpec.promptLocale`; absent ⇒ canonical). Static per leg;
|
|
1748
|
+
* every context the harness builds carries it (`AgentContext.promptLocale`). */
|
|
1749
|
+
promptLocale?: import("../../prompt-assembly/catalog/schema.js").RenderedLocale;
|
|
1681
1750
|
getApiKeyAndHeaders?: (model: Model) => Promise<{
|
|
1682
1751
|
apiKey: string;
|
|
1683
1752
|
headers?: Record<string, string>;
|
|
@@ -1732,10 +1801,12 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
|
|
|
1732
1801
|
imageProcessor?: import("../loop/types.js").AgentLoopConfig["imageProcessor"];
|
|
1733
1802
|
/** Loop-config pass-through — see `AgentLoopConfig.onImageUnprocessed` (an image that goes on unprocessed over the soft target). */
|
|
1734
1803
|
onImageUnprocessed?: import("../loop/types.js").AgentLoopConfig["onImageUnprocessed"];
|
|
1804
|
+
/** Loop-config pass-through — see `AgentLoopConfig.toolResultBytes` (where the tool-result seat keeps bytes it refused for their size). */
|
|
1805
|
+
toolResultBytes?: import("../loop/types.js").AgentLoopConfig["toolResultBytes"];
|
|
1735
1806
|
/**
|
|
1736
1807
|
* design/131 (拍): per-task resilience intent flags, forwarded to every provider
|
|
1737
|
-
* call (`StreamOptions.resilience`) so the
|
|
1738
|
-
* breaker) can stand aside for this task. Absent ⇒ today's behavior.
|
|
1808
|
+
* call (`StreamOptions.resilience`) so the engine's model lane and the deployment's decorator stack
|
|
1809
|
+
* (failover / breaker) can stand aside for this task. Absent ⇒ today's behavior.
|
|
1739
1810
|
*/
|
|
1740
1811
|
resilience?: import("../llm/types.js").ResilienceOptions;
|
|
1741
1812
|
/** design/120 P1: parallel-batch tool concurrency cap forwarded to the loop (default 10). */
|
|
@@ -34,6 +34,7 @@ export class ExecutionError extends Error {
|
|
|
34
34
|
partialStdout;
|
|
35
35
|
partialStderr;
|
|
36
36
|
noOutputSec;
|
|
37
|
+
refusedBy;
|
|
37
38
|
constructor(code, message, cause, partial, noOutputSec) {
|
|
38
39
|
super(message, cause === undefined ? undefined : { cause });
|
|
39
40
|
this.name = "ExecutionError";
|
|
@@ -73,6 +74,13 @@ export class AgentHarnessError extends Error {
|
|
|
73
74
|
this.code = code;
|
|
74
75
|
}
|
|
75
76
|
}
|
|
77
|
+
export class NothingQueuedError extends AgentHarnessError {
|
|
78
|
+
constructor() {
|
|
79
|
+
super("invalid_state", "the prompt opens its turn on the input queued for it, and none was queued");
|
|
80
|
+
this.name = "NothingQueuedError";
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
export const ANNOUNCED_LANGUAGE_MAX_CHARS = 256;
|
|
76
84
|
export const REMINDER_MARK_MAX_CHARS = 64;
|
|
77
85
|
export function normalizeReminderMark(v) {
|
|
78
86
|
if (typeof v !== "object" || v === null)
|
|
@@ -334,7 +342,18 @@ export function normalizeAnnouncedListing(v) {
|
|
|
334
342
|
return (state === "announced" || state === "withdrawn") && segmentOk ? { state, segment: segment } : null;
|
|
335
343
|
};
|
|
336
344
|
const advisor = advisorArm(src.advisor);
|
|
337
|
-
|
|
345
|
+
const languageArm = (a) => {
|
|
346
|
+
if (a === undefined)
|
|
347
|
+
return undefined;
|
|
348
|
+
if (typeof a !== "object" || a === null)
|
|
349
|
+
return null;
|
|
350
|
+
const { value, segment } = a;
|
|
351
|
+
const valueOk = value === null || (typeof value === "string" && value.length > 0 && value.length <= ANNOUNCED_LANGUAGE_MAX_CHARS);
|
|
352
|
+
const segmentOk = segment === null || (typeof segment === "string" && segment.length <= ANNOUNCED_LISTING_MAX_NAME_CHARS);
|
|
353
|
+
return valueOk && segmentOk ? { value: value, segment: segment } : null;
|
|
354
|
+
};
|
|
355
|
+
const language = languageArm(src.language);
|
|
356
|
+
if (agents === null || skills === null || models === null || mcpFailed === null || advisories === null || advisor === null || language === null)
|
|
338
357
|
return undefined;
|
|
339
358
|
return {
|
|
340
359
|
...(agents !== undefined ? { agents } : {}),
|
|
@@ -343,5 +362,6 @@ export function normalizeAnnouncedListing(v) {
|
|
|
343
362
|
...(mcpFailed !== undefined ? { mcpFailed } : {}),
|
|
344
363
|
...(advisories !== undefined ? { advisories } : {}),
|
|
345
364
|
...(advisor !== undefined ? { advisor } : {}),
|
|
365
|
+
...(language !== undefined ? { language } : {}),
|
|
346
366
|
};
|
|
347
367
|
}
|
|
@@ -116,6 +116,10 @@ export interface ToolTurnView {
|
|
|
116
116
|
/** The request view — the input array itself when {@link repairs} is empty. */
|
|
117
117
|
readonly messages: Message[];
|
|
118
118
|
readonly repairs: readonly ToolTurnRepair[];
|
|
119
|
+
/** Each result of {@link messages} that folds two or more recorded results into one, and the results it folds, in
|
|
120
|
+
* order — a reader that judges a recorded result by its own record (its `details`, which the fold keeps only for the
|
|
121
|
+
* first) reads the parts here; their contents stand in the fold in this order, joined by {@link SECOND_RESULT_SEPARATOR}. */
|
|
122
|
+
readonly folds: ReadonlyMap<Message, readonly Message[]>;
|
|
119
123
|
}
|
|
120
124
|
/** The text standing between two results recorded for one call when the view folds them into one. */
|
|
121
125
|
export declare const SECOND_RESULT_SEPARATOR = "[another result was recorded for this same call:]";
|
|
@@ -82,6 +82,7 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
|
|
|
82
82
|
});
|
|
83
83
|
const repairs = [];
|
|
84
84
|
const out = [];
|
|
85
|
+
const folds = new Map();
|
|
85
86
|
messages.forEach((m, i) => {
|
|
86
87
|
if (ownerOf.has(i) || orphans.has(i))
|
|
87
88
|
return;
|
|
@@ -118,7 +119,11 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
|
|
|
118
119
|
for (const [id, at] of recorded) {
|
|
119
120
|
const real = at.filter((r) => !isInterruptedClose(messages[r]));
|
|
120
121
|
const chosen = real.length > 0 ? real : at.slice(0, 1);
|
|
121
|
-
|
|
122
|
+
const parts = chosen.map((r) => messages[r]);
|
|
123
|
+
const folded = parts.reduce(foldResults);
|
|
124
|
+
if (parts.length > 1)
|
|
125
|
+
folds.set(folded, parts);
|
|
126
|
+
sent.set(id, folded);
|
|
122
127
|
if (anchor[chosen[0]] !== i)
|
|
123
128
|
late.push(id);
|
|
124
129
|
if (at.length > 1)
|
|
@@ -139,7 +144,7 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
|
|
|
139
144
|
});
|
|
140
145
|
if (orphans.size > 0)
|
|
141
146
|
repairs.push({ form: "orphan_result", toolCallIds: [...new Set([...orphans].map((i) => messages[i].toolCallId))] });
|
|
142
|
-
return repairs.length === 0 ? { messages, repairs } : { messages: out, repairs };
|
|
147
|
+
return repairs.length === 0 ? { messages, repairs, folds } : { messages: out, repairs, folds };
|
|
143
148
|
}
|
|
144
149
|
function foldResults(first, second) {
|
|
145
150
|
return { ...first, content: [...first.content, { type: "text", text: SECOND_RESULT_SEPARATOR }, ...second.content], isError: first.isError && second.isError };
|
|
@@ -5,7 +5,7 @@ import type { ProviderCondition, ProviderConditionSource } from "../../brain/pro
|
|
|
5
5
|
import type { RequestRoute, RouteCarrierBag, RouteCredentialSource } from "../../brain/request-route.js";
|
|
6
6
|
export type { RouteCredentialSource } from "../../brain/request-route.js";
|
|
7
7
|
import type { ModelOutputInvalidCause } from "./tool-turns.js";
|
|
8
|
-
import type { PromptTraitName, TraitCondition } from "../../prompt-assembly/catalog/schema.js";
|
|
8
|
+
import type { PromptTraitName, RenderedLocale, TraitCondition } from "../../prompt-assembly/catalog/schema.js";
|
|
9
9
|
export type KnownApi = "openai-completions" | "mistral-conversations" | "openai-responses" | "azure-openai-responses" | "openai-chatgpt-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "google-vertex";
|
|
10
10
|
export type Api = KnownApi | (string & {});
|
|
11
11
|
export type KnownImagesApi = "openrouter-images";
|
|
@@ -23,7 +23,12 @@ export type ImagesProvider = string;
|
|
|
23
23
|
export type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
|
|
24
24
|
export type ModelThinkingLevel = "off" | ThinkingLevel;
|
|
25
25
|
export type ThinkingLevelMap = Partial<Record<ModelThinkingLevel, string | null>>;
|
|
26
|
-
|
|
26
|
+
/** The prompt-cache retention words, the one list the deployment seat (`RunnerDeps.cacheRetention`) and the Anthropic mint judge
|
|
27
|
+
* by: `short` = the provider's default cache lifetime, `long` = its extended one, `none` = no prompt-cache breakpoint. */
|
|
28
|
+
export declare const CACHE_RETENTION_WORDS: readonly ["none", "short", "long"];
|
|
29
|
+
export type CacheRetention = (typeof CACHE_RETENTION_WORDS)[number];
|
|
30
|
+
/** Whether a value is one of the retention words. */
|
|
31
|
+
export declare function isCacheRetention(value: unknown): value is CacheRetention;
|
|
27
32
|
export type Transport = "sse" | "websocket" | "websocket-cached" | "auto";
|
|
28
33
|
export type MaybePromise<T> = T | Promise<T>;
|
|
29
34
|
export interface ProviderResponse {
|
|
@@ -73,8 +78,10 @@ export interface StreamOptions {
|
|
|
73
78
|
*/
|
|
74
79
|
transport?: Transport;
|
|
75
80
|
/**
|
|
76
|
-
* Prompt cache retention
|
|
77
|
-
*
|
|
81
|
+
* Prompt cache retention ({@link CACHE_RETENTION_WORDS}); absent ⇒ `"short"`. Only the Anthropic brain maps it — `short`: its
|
|
82
|
+
* breakpoints as today (`{type:"ephemeral"}`); `long`: `ttl:"1h"` (a cache write billed 2×, not 1.25×); `none`: no breakpoint;
|
|
83
|
+
* any other value is refused (`config.invalid_argument`). The OpenAI and Open Responses brains send no retention parameter. A
|
|
84
|
+
* Runner writes a set `RunnerDeps.cacheRetention` here on every call of its Brain seat, over the call's own value; nothing else does.
|
|
78
85
|
*/
|
|
79
86
|
cacheRetention?: CacheRetention;
|
|
80
87
|
/**
|
|
@@ -259,9 +266,15 @@ export interface ToolCall {
|
|
|
259
266
|
export interface Usage {
|
|
260
267
|
input: number;
|
|
261
268
|
output: number;
|
|
262
|
-
|
|
263
|
-
|
|
269
|
+
/** Prompt tokens served from the provider's prefix cache; absent — not 0 — when unreported (a reported 0 is a measured 0). */
|
|
270
|
+
cacheRead?: number;
|
|
271
|
+
/** Prompt tokens written to the provider's prefix cache, at either lifetime; absent — not 0 — when unreported (the OpenAI shapes never report it). */
|
|
272
|
+
cacheWrite?: number;
|
|
273
|
+
/** A SUBSET of `cacheWrite` written at the one-hour lifetime; absent — not 0 — when the provider did not state the split, never added to the writes. */
|
|
274
|
+
cacheWriteLong?: number;
|
|
264
275
|
totalTokens: number;
|
|
276
|
+
/** A SUBSET of `output` the provider spent reasoning (not in `totalTokens`, not priced); absent — not 0 — when unreported; a count beyond `output` is not recorded and the turn is `usageMissing`. */
|
|
277
|
+
reasoning?: number;
|
|
265
278
|
cost: {
|
|
266
279
|
input: number;
|
|
267
280
|
output: number;
|
|
@@ -358,6 +371,13 @@ export interface UserMessage {
|
|
|
358
371
|
engineMinted?: true;
|
|
359
372
|
/** #1036 — this frame's injection-queue dedup key, with `provenance:"engine-note"`; OPAQUE (equality only), the DURABLE half of frame identity. */
|
|
360
373
|
engineNoteKey?: string;
|
|
374
|
+
/**
|
|
375
|
+
* The changed-files notices this message carries ({@link ChangedFilesNotice}): a request carries each listed
|
|
376
|
+
* (path, modification time) once — the earliest notice of it in the request's view — and leaves out a notice whose every
|
|
377
|
+
* file an earlier one in the view lists. Absent = no notice, or one written before the record existed (sent as written).
|
|
378
|
+
* Read through {@link changedFilesNoticesOf} only. Same additive / never-on-the-wire posture as the fields above.
|
|
379
|
+
*/
|
|
380
|
+
changedFilesNotices?: ReadonlyArray<ChangedFilesNotice>;
|
|
361
381
|
/**
|
|
362
382
|
* [c209-C] R3 收口 — the "visible but not the user" THIRD state. This message is an
|
|
363
383
|
* ENGINE-INJECTED note whose CONTENT the model must read (LSP `<new-diagnostics>` blocks,
|
|
@@ -399,14 +419,16 @@ export interface UserMessage {
|
|
|
399
419
|
runOrigin?: import("../../core/run-origin.js").RunOrigin;
|
|
400
420
|
/**
|
|
401
421
|
* The DELIVERY RECORD of a user-attachment frame: this message is the engine-minted frame carrying one attachment
|
|
402
|
-
* the user declared on the human message it follows,
|
|
403
|
-
*
|
|
404
|
-
* source of "what was delivered": read-state commit and rebuild, the `human_input` projection, the receipt, the
|
|
422
|
+
* the user declared on the human message it follows, one file a landed compaction re-read (`origin: "compaction_restore"`,
|
|
423
|
+
* after the compaction entry) or one instruction file (`origin`) — it always rides with `provenance:"engine-note"`. The
|
|
424
|
+
* one source of "what was delivered": read-state commit and rebuild, the `human_input` projection, the receipt, the
|
|
405
425
|
* derived views, compaction cut points and `resumeAt` read this record, never the frame's text. Metadata only —
|
|
406
426
|
* never sent to a provider (brains rebuild wire messages field by field; {@link stripEngineMetadata} strips it for a
|
|
407
427
|
* custom Brain); the session import door strips it (an imported frame is an ordinary engine note).
|
|
408
428
|
*/
|
|
409
429
|
attachment?: UserMessageAttachment;
|
|
430
|
+
/** The attachments an engine-minted turn-boundary bundle message carries, in text order: per attachment its `source` and `chars` ({@link import("../../core/attachment-source.js").BundledAttachment}); present iff the message is `engineMinted` and bundled at least one; metadata only (never sent to a provider), kept by the import door in its canonical shape only; NOT {@link UserMessage.attachment}. */
|
|
431
|
+
attachments?: ReadonlyArray<import("../../core/attachment-source.js").BundledAttachment>;
|
|
410
432
|
/** {@link RowRewrittenBy} */
|
|
411
433
|
rewrittenBy?: RowRewrittenBy;
|
|
412
434
|
}
|
|
@@ -420,8 +442,11 @@ export type RowRewrittenBy = readonly string[];
|
|
|
420
442
|
export type UserAttachmentKind = "text" | "notebook" | "image" | "pdf" | "directory" | "client_text" | "client_image";
|
|
421
443
|
/** Who held the bytes: the engine read a path in its workspace, or the host supplied text / an image. */
|
|
422
444
|
export type UserAttachmentSupply = "path" | "content_text" | "content_image";
|
|
423
|
-
/** What
|
|
424
|
-
|
|
445
|
+
/** What the engine delivered of the attachment's contents (the Read layer's outcome words). `attached` = the frame holds
|
|
446
|
+
* them: a request carries them as the frame's data, or — when it already carries the same contents earlier — as the
|
|
447
|
+
* sentence that they are not repeated beside that earlier copy, or — when its core cannot hold them — as the sentence
|
|
448
|
+
* that they are not included. */
|
|
449
|
+
export type UserAttachmentOutcome = "attached" | "partial" | "not_attached";
|
|
425
450
|
/** The read-state entry a path attachment's delivery committed (the Read layer's observation, verbatim). */
|
|
426
451
|
export interface UserAttachmentObservation {
|
|
427
452
|
readonly key: string;
|
|
@@ -435,6 +460,7 @@ export interface UserAttachmentObservation {
|
|
|
435
460
|
readonly end: number;
|
|
436
461
|
};
|
|
437
462
|
};
|
|
463
|
+
readonly stampedAt?: number;
|
|
438
464
|
}
|
|
439
465
|
/** See {@link UserMessage.attachment}. */
|
|
440
466
|
export interface UserMessageAttachment {
|
|
@@ -442,8 +468,9 @@ export interface UserMessageAttachment {
|
|
|
442
468
|
* ({@link origin}), the id of the one compaction restore it belongs to. */
|
|
443
469
|
readonly inputId: string;
|
|
444
470
|
/** `compaction_restore`: the engine minted this frame itself after a compaction landed, re-reading a file the
|
|
445
|
-
* conversation had read (`ordinal` / `count` among the files that restore re-read)
|
|
446
|
-
|
|
471
|
+
* conversation had read (`ordinal` / `count` among the files that restore re-read); `project_instructions` / `nested_memory`:
|
|
472
|
+
* an instruction file of the task root / of an accessed directory or a deployment's rule (among one load's). Absent: the user's. */
|
|
473
|
+
readonly origin?: "compaction_restore" | "nested_memory" | "project_instructions";
|
|
447
474
|
/** 1-based position among that input's declared attachments, and how many it declared. */
|
|
448
475
|
readonly ordinal: number;
|
|
449
476
|
readonly count: number;
|
|
@@ -455,6 +482,9 @@ export interface UserMessageAttachment {
|
|
|
455
482
|
readonly label: string;
|
|
456
483
|
/** Present on a path attachment whose delivery recorded read state. */
|
|
457
484
|
readonly observation?: UserAttachmentObservation;
|
|
485
|
+
/** An instruction frame that withdraws a file delivered earlier (removed, or holding nothing now): the file's canonical key.
|
|
486
|
+
* No data; its delivery and a replay delete that key's read-state entry while an instruction frame recorded it. */
|
|
487
|
+
readonly withdraws?: string;
|
|
458
488
|
/** `[start, end)` indices into the message's `content` of the data the attachment delivered (the file's own blocks,
|
|
459
489
|
* or the engine's refusal sentence); the engine's marked sentences and the label line sit outside it. */
|
|
460
490
|
readonly dataBlocks: {
|
|
@@ -570,6 +600,8 @@ export interface AssistantMessage {
|
|
|
570
600
|
providerConditionSource?: ProviderConditionSource;
|
|
571
601
|
/** With `quota_exhausted` whose evidence stated it: when the quota lifts (wall-clock epoch ms). */
|
|
572
602
|
providerResetAtMs?: number;
|
|
603
|
+
/** The provider's own sentence for the failure ({@link BrainStatus.providerMessage}); on a 4xx also `terminal.detail.providerMessage`. Absent for a plain-text, torn, unended or empty body and for an in-band frame. */
|
|
604
|
+
providerMessage?: string;
|
|
573
605
|
/** The failing request's route as its brain stated it ({@link RequestRoute}; never a key value or a URL); on a 4xx also
|
|
574
606
|
* `terminal.detail.route`. PRESENCE: beside {@link isApiErrorMessage} on an engine-minted provider failure whose
|
|
575
607
|
* committed request stated one; absent on success, an abort, a refusal minted before any request was built. */
|
|
@@ -687,10 +719,27 @@ export interface AssistantMessage {
|
|
|
687
719
|
* the 2-downgrade stop-loss. Additive — absent everywhere else (incl. the dynamicCut shape).
|
|
688
720
|
*/
|
|
689
721
|
staticReasoningCut?: true;
|
|
722
|
+
/**
|
|
723
|
+
* The extension that answered this turn in the model's place (a `prompt.submit` handler's `{ reply }`): the row is
|
|
724
|
+
* that answer — no model was called for it, so it carries no model account (its `usage` is a known zero, never
|
|
725
|
+
* flagged missing) and `model` / `provider` / `api` name the leg's model, not who wrote it. PRESENCE: set only on a
|
|
726
|
+
* row the engine minted from such an answer; absent on every row a model wrote. Kept on the stored row; never on a
|
|
727
|
+
* provider payload ({@link stripEngineMetadata}).
|
|
728
|
+
*/
|
|
729
|
+
answeredBy?: string;
|
|
690
730
|
/** {@link RowRewrittenBy} */
|
|
691
731
|
rewrittenBy?: RowRewrittenBy;
|
|
692
732
|
timestamp: number;
|
|
693
733
|
}
|
|
734
|
+
/** Whether a row is an answer an extension gave in the model's place ({@link AssistantMessage.answeredBy}) — the one
|
|
735
|
+
* reading every account keyed on "did this turn call a model" reads. */
|
|
736
|
+
export declare function answeredWithoutModel<M extends {
|
|
737
|
+
readonly role: string;
|
|
738
|
+
readonly answeredBy?: unknown;
|
|
739
|
+
}>(m: M): m is M & {
|
|
740
|
+
readonly role: "assistant";
|
|
741
|
+
readonly answeredBy: string;
|
|
742
|
+
};
|
|
694
743
|
export interface ToolResultMessage<TDetails = unknown> {
|
|
695
744
|
role: "toolResult";
|
|
696
745
|
toolCallId: string;
|
|
@@ -703,13 +752,37 @@ export interface ToolResultMessage<TDetails = unknown> {
|
|
|
703
752
|
timestamp: number;
|
|
704
753
|
}
|
|
705
754
|
export type Message = UserMessage | AssistantMessage | ToolResultMessage;
|
|
755
|
+
/** One changed-files notice block on a user-lane message, in the coordinate of {@link UserMessage.engineSegments}
|
|
756
|
+
* (`[start, end)` UTF-16 offsets into the message's flattened text content): the block, and each file it lists — the
|
|
757
|
+
* (path, modification time) the model is told about — with the range of its list line (its leading line break included,
|
|
758
|
+
* so cutting the range leaves the list well formed). */
|
|
759
|
+
export interface ChangedFilesNotice {
|
|
760
|
+
readonly start: number;
|
|
761
|
+
readonly end: number;
|
|
762
|
+
readonly files: ReadonlyArray<{
|
|
763
|
+
readonly path: string;
|
|
764
|
+
readonly mtimeMs: number;
|
|
765
|
+
readonly start: number;
|
|
766
|
+
readonly end: number;
|
|
767
|
+
}>;
|
|
768
|
+
}
|
|
769
|
+
/** The message's flattened text (its text blocks in order) — the coordinate engine ranges index. */
|
|
770
|
+
export declare function flattenedUserText(content: UserMessage["content"]): string;
|
|
771
|
+
/**
|
|
772
|
+
* The well-formed changed-files notices of a user-lane message, or `undefined` — the one reader of
|
|
773
|
+
* {@link UserMessage.changedFilesNotices}. Every range must lie in the flattened text, notices ascending and disjoint, each
|
|
774
|
+
* file's line inside its notice, ascending and disjoint; one malformed entry voids the whole field (the notices are then
|
|
775
|
+
* carried as written — the conservative direction, as for {@link UserMessage.engineSegments}).
|
|
776
|
+
*/
|
|
777
|
+
export declare function changedFilesNoticesOf(m: unknown): ReadonlyArray<ChangedFilesNotice> | undefined;
|
|
706
778
|
/**
|
|
707
779
|
* RB-3 (stage S4 carry): strip the engine-provenance metadata fields from user messages before
|
|
708
|
-
* serializing a Context to an external wire. The
|
|
709
|
-
* `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`runOrigin`) are INTERNAL coordination
|
|
710
|
-
* minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
|
|
711
|
-
* multiplayer attribution, attachment delivery, run attribution) — they must never reach a
|
|
712
|
-
*
|
|
780
|
+
* serializing a Context to an external wire. The ten fields (`enginePrefixChars`/`engineSegments`/
|
|
781
|
+
* `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`attachments`/`runOrigin`/`changedFilesNotices`) are INTERNAL coordination
|
|
782
|
+
* between the engine's minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
|
|
783
|
+
* multiplayer attribution, attachment delivery, run attribution, the request's notice projection) — they must never reach a
|
|
784
|
+
* provider payload; so is
|
|
785
|
+
* {@link RowRewrittenBy}, on every role, and {@link AssistantMessage.answeredBy}. The built-in brains construct
|
|
713
786
|
* their own wire shapes and are immune; a CUSTOM Brain that whole-object-serializes messages
|
|
714
787
|
* (`JSON.stringify(context.messages)`) would leak them — run the array through this projection first.
|
|
715
788
|
*/
|
|
@@ -771,6 +844,8 @@ export interface Context {
|
|
|
771
844
|
}>;
|
|
772
845
|
messages: Message[];
|
|
773
846
|
tools?: Tool[];
|
|
847
|
+
/** The locale an adapter renders its own texts in (an image provenance line); `TaskSpec.promptLocale`, absent ⇒ canonical. */
|
|
848
|
+
promptLocale?: RenderedLocale;
|
|
774
849
|
}
|
|
775
850
|
/**
|
|
776
851
|
* Event protocol for AssistantMessageEventStream.
|
|
@@ -886,7 +961,7 @@ export interface AssistantMessageEventStreamLike extends AsyncIterable<Assistant
|
|
|
886
961
|
* {@link OpenAIResponsesCompat}, and now gated by `gate:field-liveness`).
|
|
887
962
|
*/
|
|
888
963
|
export interface OpenAICompletionsCompat {
|
|
889
|
-
/** Whether the provider supports `reasoning_effort`.
|
|
964
|
+
/** Whether the provider supports `reasoning_effort`. Absent = supported; only an explicit `false` sends no effort value. */
|
|
890
965
|
supportsReasoningEffort?: boolean;
|
|
891
966
|
/**
|
|
892
967
|
* Which `reasoning_effort` tiers this endpoint accepts. Absent → the conservative default
|
|
@@ -901,7 +976,7 @@ export interface OpenAICompletionsCompat {
|
|
|
901
976
|
* OpenAI-compatible endpoints accept. Declare explicitly to override the inference
|
|
902
977
|
* (design/119 #3; see `inferMaxTokensField` in brain/openai). */
|
|
903
978
|
maxTokensField?: "max_completion_tokens" | "max_tokens";
|
|
904
|
-
/** Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled.
|
|
979
|
+
/** Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled. Absent = not required; only an explicit `true` adds the field. */
|
|
905
980
|
requiresReasoningContentOnAssistantMessages?: boolean;
|
|
906
981
|
/** Format for reasoning/thinking parameter. "openai" uses reasoning_effort, "openrouter" uses reasoning: { effort }, "deepseek" uses thinking: { type } plus reasoning_effort, "together" uses reasoning: { enabled } plus reasoning_effort when supported, "zai" uses top-level enable_thinking: boolean, "qwen" uses top-level enable_thinking: boolean, and "qwen-chat-template" uses chat_template_kwargs.enable_thinking. Default: "openai". */
|
|
907
982
|
thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
|
|
@@ -997,10 +1072,19 @@ export interface Model<TApi extends Api = Api> {
|
|
|
997
1072
|
*
|
|
998
1073
|
* It is the REQUESTED tier, read exactly as a request's own: the per-endpoint clamp (`resolveReasoning` /
|
|
999
1074
|
* `reasoningEffortLevels`) still bounds it — a stock-OpenAI endpoint clamps `max`→`high` — and a model that does
|
|
1000
|
-
* not hold `reasoning` carries
|
|
1075
|
+
* not hold `reasoning` carries no enabling tier. A value that is not one of the seven tiers is refused where the model
|
|
1001
1076
|
* is received (the model door, `config.unknown_role` / `not_a_model_ref`), never read as absence.
|
|
1002
1077
|
*/
|
|
1003
1078
|
defaultThinking?: ModelThinkingLevel;
|
|
1079
|
+
/**
|
|
1080
|
+
* The catalog words (≤ 3, in order) a request for this model falls back to when it fails before its first content for a
|
|
1081
|
+
* reason the deployment's gate admits (`RunnerDeps.modelFallback`); each hop is served by the deployment's own Brain, and
|
|
1082
|
+
* once content has streamed that stream is the answer. A CATALOG member: the catalog door (`new Runner` / `swapDeps`)
|
|
1083
|
+
* refuses a word the catalog does not hold, a word naming this entry (object or `id`), a repeat and a fourth word, and the
|
|
1084
|
+
* model door refuses the member on any other Model object — both `config.model_fallback_invalid`; the chain is flat (a
|
|
1085
|
+
* hop's own `fallbacks` are not walked). An element that is not a non-empty string is `config.unknown_role` / `not_a_model_ref`.
|
|
1086
|
+
*/
|
|
1087
|
+
fallbacks?: readonly string[];
|
|
1004
1088
|
/**
|
|
1005
1089
|
* Maps OpenClaw thinking levels to provider/model-specific values.
|
|
1006
1090
|
* Missing keys use provider defaults. null marks a level as unsupported.
|
|
@@ -1013,6 +1097,7 @@ export interface Model<TApi extends Api = Api> {
|
|
|
1013
1097
|
output: number;
|
|
1014
1098
|
cacheRead: number;
|
|
1015
1099
|
cacheWrite: number;
|
|
1100
|
+
cacheWriteLong?: number;
|
|
1016
1101
|
};
|
|
1017
1102
|
contextWindow: number;
|
|
1018
1103
|
/**
|
|
@@ -1070,7 +1155,7 @@ export interface Model<TApi extends Api = Api> {
|
|
|
1070
1155
|
* `["lean_prompt"]`. A name that is none of these refuses the task (`config.prompt_trait_unknown`).
|
|
1071
1156
|
*/
|
|
1072
1157
|
promptTraits?: readonly PromptTraitName[];
|
|
1073
|
-
/** Compatibility overrides for OpenAI-compatible APIs.
|
|
1158
|
+
/** Compatibility overrides for OpenAI-compatible APIs. A member left unset takes its own default; nothing is read off `baseUrl`. */
|
|
1074
1159
|
compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
|
|
1075
1160
|
}
|
|
1076
1161
|
export interface ImagesModel<TApi extends ImagesApi = ImagesApi> extends Omit<Model, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
|
|
@@ -1109,8 +1194,10 @@ export interface RoutePairingConfig {
|
|
|
1109
1194
|
* - `"paired"` — deployment credential on the deployment's own root (declared, or the lane default).
|
|
1110
1195
|
* - `"keyless"` — no credential anywhere; nothing to protect. */
|
|
1111
1196
|
export type RoutePairingPosture = "per-model" | "paired" | "keyless";
|
|
1112
|
-
/** Machine codes an adjudication refusal carries (minted here, forwarded verbatim by consumers).
|
|
1113
|
-
|
|
1197
|
+
/** Machine codes an adjudication refusal carries (minted here, forwarded verbatim by consumers). `config.protocol_plaintext_credentials`
|
|
1198
|
+
* is the one word shared with the protocol chains: a request carrying a credential to an endpoint it would reach in the clear across
|
|
1199
|
+
* a network (`crossesNetworkInClear`) — the same question and the same code wherever a credential is sent. */
|
|
1200
|
+
export type RouteRefusalCode = "route.credential_mismatch" | "route.credential_missing" | "route.credential_origin_mismatch" | "route.credential_answer_conflict" | "config.protocol_plaintext_credentials";
|
|
1114
1201
|
/** The structured account of a refusal — the two halves and the fix, every URL a DISPLAY spelling. */
|
|
1115
1202
|
export interface RouteRefusalDetail {
|
|
1116
1203
|
modelId: string;
|