@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
|
@@ -107,6 +107,12 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
107
107
|
* the own credentials declared since construction, or `shellEnv` is no grant, and every spawn throws that reason — so
|
|
108
108
|
* a reader sees "the child gets none", never a throw. Composed once: the refusal is the composition's own. */
|
|
109
109
|
private childEnvForRead;
|
|
110
|
+
/** The environment a shell child is started with (exec and the background start alike), or the composition's refusal,
|
|
111
|
+
* thrown for the start's `try`. The allow list was judged and copied at construction, so a refusal of the list itself
|
|
112
|
+
* can only come from a declaration made since: that one is said in this environment's words and, at the first start it
|
|
113
|
+
* refuses, once on `onNotice` (`config.inherit_env_declared_late`, `detail: { index, name }`). A grant's refusal is the
|
|
114
|
+
* composition's own sentence, unchanged. */
|
|
115
|
+
private spawnEnv;
|
|
110
116
|
private shellPath?;
|
|
111
117
|
private shellEnv?;
|
|
112
118
|
private inheritEnv;
|
|
@@ -116,6 +122,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
116
122
|
private readonly retainBackgroundProcesses;
|
|
117
123
|
private readonly onSecretEnvScrub?;
|
|
118
124
|
private readonly onNotice?;
|
|
125
|
+
/** Whether `config.inherit_env_declared_late` has been said: once per environment, at the first start it refuses. */
|
|
126
|
+
private lateDeclarationAnnounced;
|
|
119
127
|
/** design/128 T1-1: the env-owned spool dir (mkdtemp under os tmp — unpredictable, never the cwd). It exists only while
|
|
120
128
|
* {@link spoolPairs} is non-empty: the last pair's release removes it, the next mint makes a fresh one. */
|
|
121
129
|
private bgSpoolDir?;
|
|
@@ -135,7 +143,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
135
143
|
* reason), the same judgment the oracle gate's `inheritEnv` meets. Whatever the policy, the deployment's own
|
|
136
144
|
* credentials (`declareWithheldEnv`: by name, and by a value equal to a declared or engine-held credential value)
|
|
137
145
|
* are withheld from the inherited part; a list naming a declared name throws here when the declaration came
|
|
138
|
-
* first, and every spawn refuses it (`spawn_error` / `spawn_failed`) whenever it came
|
|
146
|
+
* first, and every spawn refuses it (`spawn_error` / `spawn_failed`) whenever it came — a declaration made after
|
|
147
|
+
* construction in this environment's words, said once on `onNotice` (`config.inherit_env_declared_late`). */
|
|
139
148
|
inheritEnv?: "all" | "scrub" | string[];
|
|
140
149
|
/** design/105: inject a resident scheduler daemon backend (the shell daemon). Absent ⇒ scheduling INERT. */
|
|
141
150
|
scheduler?: SchedulerCapability;
|
|
@@ -160,12 +169,14 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
160
169
|
onSecretEnvScrub?: (findings: readonly SecretEnvFinding[]) => void;
|
|
161
170
|
/** #1081 — the structured-notice seat for the SAME withheld-keys disclosure (`EngineNotice`,
|
|
162
171
|
* `code: "config.secret_env_scrubbed"`, `detail.names`); independent of `onSecretEnvScrub` (a raw
|
|
163
|
-
* findings collector) except: that seat wired alone stays console-silent, as before this existed.
|
|
172
|
+
* findings collector) except: that seat wired alone stays console-silent, as before this existed. The same seat hears
|
|
173
|
+
* this environment's own faults: `config.inherit_env_declared_late` (an own-credential declaration made after
|
|
174
|
+
* construction now names an `inheritEnv` entry; once per environment) and `config.read_floor_confinement_unavailable`. */
|
|
164
175
|
onNotice?: (notice: EngineNotice) => void;
|
|
165
176
|
/** Confine every start that carries a byte floor (`ExecutionEnvExecOptions.readFloor`) at the OS: `"os"` = on macOS,
|
|
166
177
|
* when the seatbelt base applies here (probed once, now), each such start runs under `sandbox-exec -p <the floor's
|
|
167
178
|
* profile>` and the environment declares `keepsReadFloor: true`; a floor the profile cannot express, or a profile that
|
|
168
|
-
* does not apply, refuses that start (`
|
|
179
|
+
* does not apply, refuses that start (`sandbox_unavailable`, naming why) — it never runs unconfined. On any
|
|
169
180
|
* other host, or when the probe does not apply, the environment declares `false` and says so once on `onNotice`
|
|
170
181
|
* (`config.read_floor_confinement_unavailable`). Absent = no confinement (`false`). Any other value throws. */
|
|
171
182
|
readFloorConfinement?: "os";
|
|
@@ -188,7 +199,7 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
188
199
|
maxLines?: number;
|
|
189
200
|
abortSignal?: AbortSignal;
|
|
190
201
|
}): Promise<Result<string[], FileError>>;
|
|
191
|
-
readBinaryFile(path: string, abortSignal?: AbortSignal): Promise<Result<Uint8Array, FileError>>;
|
|
202
|
+
readBinaryFile(path: string, abortSignal?: AbortSignal, maxBytes?: number): Promise<Result<Uint8Array, FileError>>;
|
|
192
203
|
/** RB-221: whole-file replace via same-directory staging + fsync + rename.
|
|
193
204
|
* The former single-step `writeFile` was an in-place O_TRUNC: an abort mid-write
|
|
194
205
|
* (Esc during a large Write — ctx.signal reaches here directly), ENOSPC, or a crash left the target as
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { spawn, spawnSync } from "node:child_process";
|
|
2
|
+
import { describeRejectedValue } from "../../core/tool-search-setting.js";
|
|
2
3
|
import { createHash, randomUUID } from "node:crypto";
|
|
3
4
|
import { closeSync, constants, createReadStream, mkdtempSync, openSync, readSync, rmSync, statSync, truncateSync, unlinkSync } from "node:fs";
|
|
4
5
|
import { access, appendFile, lstat, mkdir, mkdtemp, open, readdir, readFile, readlink, rename, rm, stat, unlink, writeFile, } from "node:fs/promises";
|
|
@@ -7,7 +8,7 @@ import { basename, dirname, isAbsolute, join, sep } from "node:path";
|
|
|
7
8
|
import { createInterface } from "node:readline";
|
|
8
9
|
import { ExecutionError, err, FileError, ok, toError, } from "../harness/types.js";
|
|
9
10
|
import { killProcessTree, shutdownDebug } from "./kill-tree.js";
|
|
10
|
-
import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
|
|
11
|
+
import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, declaredInheritEntry, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
|
|
11
12
|
import { deliverEngineNotice } from "../../core/engine-notice.js";
|
|
12
13
|
import { confineShellStart, SANDBOX_EXEC, SEATBELT_PROBE_PROFILE } from "../../core/shell-confinement.js";
|
|
13
14
|
import { physicalPathOfAsync } from "../../core/physical-path.js";
|
|
@@ -26,6 +27,7 @@ const NODE_ENV_CAPABILITIES = Object.freeze({
|
|
|
26
27
|
externalContentTarget: false,
|
|
27
28
|
io: true,
|
|
28
29
|
keepsReadFloor: false,
|
|
30
|
+
commandSandbox: false,
|
|
29
31
|
});
|
|
30
32
|
const NODE_ENV_CONFINED_CAPABILITIES = Object.freeze({ ...NODE_ENV_CAPABILITIES, keepsReadFloor: true });
|
|
31
33
|
function probeReadFloorConfinement() {
|
|
@@ -92,38 +94,61 @@ function fileKindFromStats(stats) {
|
|
|
92
94
|
return undefined;
|
|
93
95
|
}
|
|
94
96
|
const HAS_POSIX_MODE_FACE = posixModeBitsMeaningful();
|
|
95
|
-
async function
|
|
96
|
-
const overCap = (bytes) => new FileError("invalid", `The held file is over the ${max}-byte read cap (${bytes} bytes or more); it was not read`);
|
|
97
|
+
async function readUpTo(handle, size, limit, aborted) {
|
|
97
98
|
const readAt = async (into, offset, length, position) => {
|
|
98
99
|
const { bytesRead } = await handle.read(into, offset, length, position);
|
|
99
100
|
if (aborted())
|
|
100
101
|
throw new FileError("aborted", "Operation aborted");
|
|
101
102
|
return bytesRead;
|
|
102
103
|
};
|
|
103
|
-
const size = Number((await handle.stat()).size);
|
|
104
|
-
if (size > max)
|
|
105
|
-
throw overCap(size);
|
|
106
104
|
if (size > 0) {
|
|
107
|
-
const
|
|
105
|
+
const want = Math.min(size, limit);
|
|
106
|
+
const out = Buffer.allocUnsafe(want);
|
|
108
107
|
let at = 0;
|
|
109
|
-
while (at <
|
|
110
|
-
const bytesRead = await readAt(out, at,
|
|
108
|
+
while (at < want) {
|
|
109
|
+
const bytesRead = await readAt(out, at, want - at, at);
|
|
111
110
|
if (bytesRead === 0)
|
|
112
111
|
break;
|
|
113
112
|
at += bytesRead;
|
|
114
113
|
}
|
|
115
114
|
return out.subarray(0, at);
|
|
116
115
|
}
|
|
117
|
-
const scratch = Buffer.allocUnsafe(Math.min(1 << 16,
|
|
116
|
+
const scratch = Buffer.allocUnsafe(Math.min(1 << 16, limit));
|
|
118
117
|
const chunks = [];
|
|
119
|
-
|
|
120
|
-
|
|
118
|
+
let at = 0;
|
|
119
|
+
while (at < limit) {
|
|
120
|
+
const bytesRead = await readAt(scratch, 0, Math.min(scratch.length, limit - at), at);
|
|
121
121
|
if (bytesRead === 0)
|
|
122
|
-
|
|
123
|
-
at += bytesRead;
|
|
124
|
-
if (at > max)
|
|
125
|
-
throw overCap(at);
|
|
122
|
+
break;
|
|
126
123
|
chunks.push(Buffer.from(scratch.subarray(0, bytesRead)));
|
|
124
|
+
at += bytesRead;
|
|
125
|
+
}
|
|
126
|
+
return Buffer.concat(chunks, at);
|
|
127
|
+
}
|
|
128
|
+
async function readAllFrom(handle, max, aborted) {
|
|
129
|
+
const overCap = (bytes) => new FileError("invalid", `The held file is over the ${max}-byte read cap (${bytes} bytes or more); it was not read`);
|
|
130
|
+
const size = Number((await handle.stat()).size);
|
|
131
|
+
if (size > max)
|
|
132
|
+
throw overCap(size);
|
|
133
|
+
const got = await readUpTo(handle, size, max + 1, aborted);
|
|
134
|
+
if (got.length > max)
|
|
135
|
+
throw overCap(got.length);
|
|
136
|
+
return got;
|
|
137
|
+
}
|
|
138
|
+
async function readFirstBytes(resolved, maxBytes, abortSignal) {
|
|
139
|
+
let handle;
|
|
140
|
+
try {
|
|
141
|
+
handle = await open(resolved, "r");
|
|
142
|
+
const held = await handle.stat();
|
|
143
|
+
if (held.isDirectory())
|
|
144
|
+
return err(new FileError("is_directory", `EISDIR: illegal operation on a directory, read '${resolved}'`, resolved));
|
|
145
|
+
return ok(await readUpTo(handle, Number(held.size), maxBytes, () => abortResult(abortSignal, resolved) !== undefined));
|
|
146
|
+
}
|
|
147
|
+
catch (error) {
|
|
148
|
+
return err(toFileError(error, resolved));
|
|
149
|
+
}
|
|
150
|
+
finally {
|
|
151
|
+
await handle?.close().catch(() => { });
|
|
127
152
|
}
|
|
128
153
|
}
|
|
129
154
|
function fileInfoFromStats(path, stats) {
|
|
@@ -428,6 +453,9 @@ function getShellEnv(inheritEnv, baseEnv, extraEnv, onScrub, onNotice) {
|
|
|
428
453
|
}
|
|
429
454
|
return env;
|
|
430
455
|
}
|
|
456
|
+
function lateDeclarationRefusal(refusal) {
|
|
457
|
+
return `This execution environment (NodeExecutionEnv, its inheritEnv option) was built before the process-level declaration that now names one of its entries, so it refuses every shell child it would start: ${refusal}`;
|
|
458
|
+
}
|
|
431
459
|
const EXIT_SETTLE_DRAIN_MS = 500;
|
|
432
460
|
const EXEC_SPOOL_PUMP_MS = 200;
|
|
433
461
|
const EXEC_SPOOL_ROTATE_BYTES = 8 * 1024 * 1024;
|
|
@@ -493,6 +521,22 @@ export class NodeExecutionEnv {
|
|
|
493
521
|
return undefined;
|
|
494
522
|
}
|
|
495
523
|
}
|
|
524
|
+
spawnEnv(extraEnv) {
|
|
525
|
+
try {
|
|
526
|
+
return getShellEnv(this.inheritEnv, this.shellEnv, extraEnv, this.onSecretEnvScrub, this.onNotice);
|
|
527
|
+
}
|
|
528
|
+
catch (error) {
|
|
529
|
+
const entry = declaredInheritEntry(this.inheritEnv);
|
|
530
|
+
if (entry === undefined)
|
|
531
|
+
throw error;
|
|
532
|
+
const sentence = lateDeclarationRefusal(entry.refusal);
|
|
533
|
+
if (!this.lateDeclarationAnnounced) {
|
|
534
|
+
this.lateDeclarationAnnounced = true;
|
|
535
|
+
deliverEngineNotice(this.onNotice, { code: "config.inherit_env_declared_late", message: sentence, detail: { index: entry.index, name: entry.name } });
|
|
536
|
+
}
|
|
537
|
+
throw new Error(sentence);
|
|
538
|
+
}
|
|
539
|
+
}
|
|
496
540
|
shellPath;
|
|
497
541
|
shellEnv;
|
|
498
542
|
inheritEnv;
|
|
@@ -502,12 +546,13 @@ export class NodeExecutionEnv {
|
|
|
502
546
|
retainBackgroundProcesses;
|
|
503
547
|
onSecretEnvScrub;
|
|
504
548
|
onNotice;
|
|
549
|
+
lateDeclarationAnnounced = false;
|
|
505
550
|
bgSpoolDir;
|
|
506
551
|
spoolPairs = new Set();
|
|
507
552
|
backgroundCapabilities;
|
|
508
553
|
constructor(options) {
|
|
509
554
|
if (options.readFloorConfinement !== undefined && options.readFloorConfinement !== "os") {
|
|
510
|
-
throw new Error(`NodeExecutionEnv: readFloorConfinement must be "os" or absent (got ${
|
|
555
|
+
throw new Error(`NodeExecutionEnv: readFloorConfinement must be "os" or absent (got ${describeRejectedValue(options.readFloorConfinement)}) — a confinement request that cannot be read is no request, so it refuses instead of reading as one side.`);
|
|
511
556
|
}
|
|
512
557
|
this.cwd = options.cwd;
|
|
513
558
|
this.shellPath = options.shellPath;
|
|
@@ -571,13 +616,16 @@ export class NodeExecutionEnv {
|
|
|
571
616
|
const named = parts.map((part, i) => (i === 0 ? part : part.replace(leading, ""))).filter((part) => part !== "");
|
|
572
617
|
return ok(named.length === 0 ? "." : named.reduce((at, part) => anchorAtLinkDir(at, part, sep)));
|
|
573
618
|
}
|
|
574
|
-
async startOf(shell, command,
|
|
619
|
+
async startOf(shell, command, options) {
|
|
620
|
+
if (options?.sandbox !== undefined)
|
|
621
|
+
return { ok: false, refusedBy: "environment", reason: "this environment keeps no command sandbox (capabilities.commandSandbox is false) — the command was not started" };
|
|
622
|
+
const floor = options?.readFloor;
|
|
575
623
|
const start = { command: shell.shell, args: [...shell.args, command] };
|
|
576
624
|
if (!this.confined)
|
|
577
625
|
return { ok: true, ...start };
|
|
578
626
|
const confined = confineShellStart(start, floor);
|
|
579
627
|
if (!confined.ok)
|
|
580
|
-
return { ok: false, reason: `the read-deny row ${JSON.stringify(confined.row)} cannot be kept by this environment's process confinement (${confined.reason}) — the command was not started` };
|
|
628
|
+
return { ok: false, refusedBy: "this_call", reason: `the read-deny row ${JSON.stringify(confined.row)} cannot be kept by this environment's process confinement (${confined.reason}) — the command was not started` };
|
|
581
629
|
if (confined.profile === undefined)
|
|
582
630
|
return { ok: true, ...confined.start };
|
|
583
631
|
let applies = this.profileApplies.get(confined.profile);
|
|
@@ -589,7 +637,7 @@ export class NodeExecutionEnv {
|
|
|
589
637
|
}
|
|
590
638
|
const failed = await applies;
|
|
591
639
|
if (failed !== undefined)
|
|
592
|
-
return { ok: false, reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
|
|
640
|
+
return { ok: false, refusedBy: "environment", reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
|
|
593
641
|
return { ok: true, ...confined.start };
|
|
594
642
|
}
|
|
595
643
|
async exec(command, options) {
|
|
@@ -601,9 +649,9 @@ export class NodeExecutionEnv {
|
|
|
601
649
|
if (!shellConfig.ok) {
|
|
602
650
|
return shellConfig;
|
|
603
651
|
}
|
|
604
|
-
const start = await this.startOf(shellConfig.value, command, options
|
|
652
|
+
const start = await this.startOf(shellConfig.value, command, options);
|
|
605
653
|
if (!start.ok)
|
|
606
|
-
return err(new ExecutionError("
|
|
654
|
+
return err(Object.assign(new ExecutionError("sandbox_unavailable", start.reason), { refusedBy: start.refusedBy }));
|
|
607
655
|
return await new Promise((resolvePromise) => {
|
|
608
656
|
const stdoutTail = new RollingTailBuffer();
|
|
609
657
|
const stderrTail = new RollingTailBuffer();
|
|
@@ -705,7 +753,7 @@ export class NodeExecutionEnv {
|
|
|
705
753
|
child = spawn(start.command, [...start.args], {
|
|
706
754
|
cwd,
|
|
707
755
|
detached: process.platform !== "win32",
|
|
708
|
-
env:
|
|
756
|
+
env: this.spawnEnv(options?.env),
|
|
709
757
|
stdio: execSpoolFds ? ["ignore", execSpoolFds[0], execSpoolFds[1]] : ["ignore", "pipe", "pipe"],
|
|
710
758
|
windowsHide: true,
|
|
711
759
|
});
|
|
@@ -1008,12 +1056,17 @@ export class NodeExecutionEnv {
|
|
|
1008
1056
|
stream?.destroy();
|
|
1009
1057
|
}
|
|
1010
1058
|
}
|
|
1011
|
-
async readBinaryFile(path, abortSignal) {
|
|
1059
|
+
async readBinaryFile(path, abortSignal, maxBytes) {
|
|
1012
1060
|
const resolved = resolvePath(this.cwd, path);
|
|
1061
|
+
if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) {
|
|
1062
|
+
return err(new FileError("invalid", `maxBytes must be a non-negative whole number of bytes (got ${typeof maxBytes === "number" ? String(maxBytes) : typeof maxBytes})`, resolved));
|
|
1063
|
+
}
|
|
1013
1064
|
const aborted = abortResult(abortSignal, resolved);
|
|
1014
1065
|
if (aborted) {
|
|
1015
1066
|
return aborted;
|
|
1016
1067
|
}
|
|
1068
|
+
if (maxBytes !== undefined)
|
|
1069
|
+
return readFirstBytes(resolved, maxBytes, abortSignal);
|
|
1017
1070
|
try {
|
|
1018
1071
|
return ok(await readFile(resolved, { signal: abortSignal }));
|
|
1019
1072
|
}
|
|
@@ -1515,9 +1568,9 @@ export class NodeExecutionEnv {
|
|
|
1515
1568
|
if (!shellConfig.ok) {
|
|
1516
1569
|
return err(new BackgroundShellError("spawn_failed", shellConfig.error.message, shellConfig.error));
|
|
1517
1570
|
}
|
|
1518
|
-
const start = await this.startOf(shellConfig.value, command, options
|
|
1571
|
+
const start = await this.startOf(shellConfig.value, command, options);
|
|
1519
1572
|
if (!start.ok)
|
|
1520
|
-
return err(new BackgroundShellError("
|
|
1573
|
+
return err(Object.assign(new BackgroundShellError("sandbox_unavailable", start.reason), { refusedBy: start.refusedBy }));
|
|
1521
1574
|
let spool;
|
|
1522
1575
|
let spoolFds;
|
|
1523
1576
|
if (this.retainBackgroundProcesses || process.platform !== "win32") {
|
|
@@ -1541,7 +1594,7 @@ export class NodeExecutionEnv {
|
|
|
1541
1594
|
child = spawn(start.command, [...start.args], {
|
|
1542
1595
|
cwd: options?.cwd ? resolvePath(this.cwd, options.cwd) : this.cwd,
|
|
1543
1596
|
detached: process.platform !== "win32",
|
|
1544
|
-
env:
|
|
1597
|
+
env: this.spawnEnv(options?.env),
|
|
1545
1598
|
stdio: spoolFds ? ["ignore", spoolFds[0], spoolFds[1]] : ["ignore", "pipe", "pipe"],
|
|
1546
1599
|
windowsHide: true,
|
|
1547
1600
|
});
|
|
@@ -1,21 +1,32 @@
|
|
|
1
|
-
import type { ActorAssertion, AssistantMessage, ImageContent, Model, TextContent, UserMessage, UserMessageAttachment } from "../llm/index.js";
|
|
2
|
-
import { type ToolTurnRepair } from "../llm/index.js";
|
|
1
|
+
import type { ActorAssertion, AssistantMessage, ImageContent, Message, Model, TextContent, UserMessage, UserMessageAttachment } from "../llm/index.js";
|
|
2
|
+
import { type ChangedFilesNotice, type ToolTurnRepair } from "../llm/index.js";
|
|
3
3
|
import { type RejectedImageRemoval } from "../llm/rejected-images.js";
|
|
4
|
-
import { runToolCall, type ExecutedToolCallOutcome } from "../loop/agent-loop.js";
|
|
4
|
+
import { runToolCall, type ExecutedToolCallOutcome, type GivenAnswer } from "../loop/agent-loop.js";
|
|
5
5
|
import type { HaltRemainingDirective } from "../loop/types.js";
|
|
6
6
|
import type { AgentMessage, AgentTool, AgentToolCall, LoopMalformedToolUseRecovery, LoopThinkingOnlyRecovery, LoopTruncatedOutputRecovery, QueueMode, ThinkingLevel } from "../loop/types.js";
|
|
7
7
|
import { type EngineSegment } from "../../core/untrusted-text.js";
|
|
8
8
|
import { type RunOrigin } from "../../core/run-origin.js";
|
|
9
|
+
import { type BundledAttachment } from "../../core/attachment-source.js";
|
|
9
10
|
import { type InputAuthor } from "../../core/input-author.js";
|
|
10
11
|
import type { CommittedFrameCarrier } from "../../core/frame-settlement.js";
|
|
11
|
-
import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
|
|
12
|
+
import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, BuildContextOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
|
|
12
13
|
/** [c209-C] 收口 C1/C2 — engine-provenance metadata a caller can stamp on the user message it
|
|
13
14
|
* mints (see the field docs on {@link UserMessage}). Threaded from `prompt`/`steer`/`followUp`/
|
|
14
15
|
* `nextTurn` options into the persisted message so derived views (auto-mode window, compaction
|
|
15
16
|
* serializer) work from METADATA, never from reminder-shape guessing. */
|
|
16
|
-
/** Who aborted a turn seat: the bare user halt
|
|
17
|
-
* through the loop's composition listener and stamps nothing. */
|
|
18
|
-
export type SeatCutSource = "halt" | "steer";
|
|
17
|
+
/** Who aborted a turn seat: the bare user halt, the steer-now accelerator, or an extension's `$.turn.abort`. A run-level
|
|
18
|
+
* abort reaches the seat through the loop's composition listener and stamps nothing. */
|
|
19
|
+
export type SeatCutSource = "halt" | "steer" | "extension";
|
|
20
|
+
/** What {@link AgentHarness.cutTurn} found: it cut the running turn; no turn is in flight (no seat — between turns, an
|
|
21
|
+
* answered turn, boundary housekeeping); or the turn is already ending (its seat was cut, or the run is unwinding). */
|
|
22
|
+
export type TurnCutVerdict = "cut" | "none" | "ending";
|
|
23
|
+
/** One seat's cut, as stamped before its abort dispatches: the source and, for an extension's cut, its registration and
|
|
24
|
+
* the turn number it asked to end. */
|
|
25
|
+
export interface SeatCut {
|
|
26
|
+
readonly source: SeatCutSource;
|
|
27
|
+
readonly by?: string;
|
|
28
|
+
readonly turn?: number;
|
|
29
|
+
}
|
|
19
30
|
/** Who asked the clean-stop latch to end the run: the bare user halt, or a soft stop ({@link AgentHarness.requestStopAfterTurn}). */
|
|
20
31
|
export type StopRequestSource = "halt" | "soft";
|
|
21
32
|
/** The harness's STATEMENT of what a run's halt (and its stop siblings) did — the result assembly reads this in
|
|
@@ -23,13 +34,19 @@ export type StopRequestSource = "halt" | "soft";
|
|
|
23
34
|
* Per prompt: every seat is cleared at the next `prompt()`, so a read after the prompt settled describes that run. */
|
|
24
35
|
export interface HaltConsumption {
|
|
25
36
|
/** The loop's interrupt settlement consumed the cut of the LAST-published seat, stamped with its aborter. Absent: no
|
|
26
|
-
* seat cut was consumed on the final turn (never cut / a later
|
|
37
|
+
* seat cut was consumed on the final turn (never cut / a later turn cleared it / a run abort owned the ending / no stamp). */
|
|
27
38
|
readonly turnCut?: SeatCutSource;
|
|
39
|
+
/** The registration that made that cut — present with `turnCut: "extension"`. */
|
|
40
|
+
readonly turnCutBy?: string;
|
|
28
41
|
/** The first boundary consult that stopped a non-unwinding loop, with the latch's sources at that instant. */
|
|
29
42
|
readonly boundaryStop?: {
|
|
30
43
|
readonly face: "pre_turn" | "post_turn";
|
|
31
44
|
readonly sources: ReadonlyArray<StopRequestSource>;
|
|
32
45
|
};
|
|
46
|
+
/** The cuts this run ACCEPTED ({@link AgentHarness.cutTurn} answered `"cut"`) that no settlement took as its turn's
|
|
47
|
+
* cause — the turn had already settled otherwise (its request's end was delivered first), or the run's own ending won.
|
|
48
|
+
* In acceptance order; absent when every accepted cut was consumed. */
|
|
49
|
+
readonly unconsumedCuts?: ReadonlyArray<SeatCut>;
|
|
33
50
|
}
|
|
34
51
|
/** `prompt()` option: settle the transcript's trailing UNANSWERED tool batch through the loop's own batch pipeline
|
|
35
52
|
* BEFORE the prompt is delivered (a resumed run whose suspended batch still holds unanswered calls). `halt` settles
|
|
@@ -58,6 +75,34 @@ export interface PromptTrailing {
|
|
|
58
75
|
export interface PromptEndsAwaitingUser {
|
|
59
76
|
endsAwaitingUser?: true;
|
|
60
77
|
}
|
|
78
|
+
/** `prompt()` option: the prompt's own text is not the turn's input (the engine's frames riding a wake) — the turn opens on the
|
|
79
|
+
* input queued for it, and a blank text under this declaration mints no message at all. Queued input is read once the turn-open
|
|
80
|
+
* hooks have run (they may hand input over): the next-turn, steer and follow-up lanes and what the hooks return. With none, the
|
|
81
|
+
* prompt is refused with {@link NothingQueuedError} before the run starts. A prompt without the declaration is its own message,
|
|
82
|
+
* blank or not. */
|
|
83
|
+
export interface PromptOpensOnQueuedInput {
|
|
84
|
+
opensOnQueuedInput?: true;
|
|
85
|
+
}
|
|
86
|
+
/** `prompt()` / `followUp()` option: the answer to the turn the input opens is already given (an extension's `{ reply }`) —
|
|
87
|
+
* that turn calls no model; see {@link GivenAnswer}. On `followUp`, the frame drains alone at the would-otherwise-stop seat
|
|
88
|
+
* and its turn is the answer. */
|
|
89
|
+
export interface PromptGivenAnswer {
|
|
90
|
+
givenAnswer?: Pick<GivenAnswer, "text" | "by">;
|
|
91
|
+
}
|
|
92
|
+
/** One input whose answer is already given (a parked `later` steer an extension answered before the pause): the frame it
|
|
93
|
+
* enters as (`text` with its `provenance`, whose `parkRecord` is what a later pause parks it as and what the frame's
|
|
94
|
+
* consumption is reported by, {@link AgentHarness.onUserInputConsumed}), and the answer. */
|
|
95
|
+
export interface AnsweredInputSeed {
|
|
96
|
+
readonly text: string;
|
|
97
|
+
readonly provenance: UserMessageProvenance;
|
|
98
|
+
readonly answer: Pick<GivenAnswer, "text" | "by">;
|
|
99
|
+
}
|
|
100
|
+
/** `prompt()` option: inputs whose answers are already given ({@link AnsweredInputSeed}). Each enters the follow-up lane when
|
|
101
|
+
* the prompt's own message commits, as an answered follow-up does ({@link PromptGivenAnswer}): it drains alone at the
|
|
102
|
+
* would-otherwise-stop seat, after the prompt's work, and its turn is the answer. */
|
|
103
|
+
export interface PromptAnsweredInputs {
|
|
104
|
+
answeredInputs?: readonly AnsweredInputSeed[];
|
|
105
|
+
}
|
|
61
106
|
export interface UserMessageProvenance {
|
|
62
107
|
/** Exact char length of the engine-prepended prefix on `text` (first-frame reminders etc.).
|
|
63
108
|
* Sugar for the single segment `[0, chars)` — when `engineSegments` is also supplied, segments win. */
|
|
@@ -69,6 +114,10 @@ export interface UserMessageProvenance {
|
|
|
69
114
|
/** The ENTIRE message is engine-minted guidance (nudges/finalize/attachment bundles), not user speech.
|
|
70
115
|
* [c209-C] R4: mutually exclusive with `provenance` — on a double-stamp, `provenance` wins (see below). */
|
|
71
116
|
engineMinted?: true;
|
|
117
|
+
/** The attachments an engine-minted bundle message carries ({@link UserMessage.attachments}) — meaningful only WITH
|
|
118
|
+
* `engineMinted` (a person's input has no bundle): on any other mint it is dropped, and a list that is not canonical (empty,
|
|
119
|
+
* an unknown source, a length that is not a count) is dropped whole. Threaded as a snapshot copy. */
|
|
120
|
+
attachments?: ReadonlyArray<BundledAttachment>;
|
|
72
121
|
/** [c209-C] R3: engine-injected note whose content must stay VISIBLE in derived views (diagnostics,
|
|
73
122
|
* task notifications, steering, recall) but never under user authority — see UserMessage.provenance. */
|
|
74
123
|
provenance?: "engine-note";
|
|
@@ -84,6 +133,9 @@ export interface UserMessageProvenance {
|
|
|
84
133
|
* ({@link UserMessage.engineNoteKey}) so a reader of the TRANSCRIPT alone can join an entry back
|
|
85
134
|
* to its frame. Rides only WITH `provenance:"engine-note"`. */
|
|
86
135
|
engineNoteKey?: string;
|
|
136
|
+
/** The changed-files notices `text` carries ({@link UserMessage.changedFilesNotices}); persisted only when well formed
|
|
137
|
+
* against `text` (a malformed record is dropped at the mint, so the notices are carried as written). */
|
|
138
|
+
changedFilesNotices?: ReadonlyArray<ChangedFilesNotice>;
|
|
87
139
|
/** RB-30 terminal fix — an OPAQUE payload the engine rides on this queued message (the runner's
|
|
88
140
|
* task-notification frame). Never serialized, never interpreted by the harness: if the message is
|
|
89
141
|
* still undrained at agent_end, the payload is handed back through `onUndrainedEngineNotes` so
|
|
@@ -95,6 +147,14 @@ export interface UserMessageProvenance {
|
|
|
95
147
|
* projection point `projectHumanInput`) BEFORE the frame wrapping — the harness never rewrites
|
|
96
148
|
* text, so annotation stays adjacent to the frame it attributes. */
|
|
97
149
|
actor?: ActorAssertion;
|
|
150
|
+
/** This message carries a person's input — and, when it is the one input a `human_input` frame accounts for, that frame's key
|
|
151
|
+
* (`inputId`; a resume's continuation merging several parked steers is a person's input with no single key). A sidecar entry judged at
|
|
152
|
+
* the mint (a key that is given and hollow is refused), never a message field: it does not reach the transcript or the model. Read back,
|
|
153
|
+
* once the message is committed, by `userRowSourceOf` — which is how the commit frame says what the row is. Absent on every message that
|
|
154
|
+
* is not a person's input (an engine note, an attachment frame). */
|
|
155
|
+
input?: {
|
|
156
|
+
inputId?: string;
|
|
157
|
+
};
|
|
98
158
|
/** What brought the one input this message carries ({@link UserMessage.runOrigin}) — the caller passes it with a message
|
|
99
159
|
* that carries a single input only. Threaded onto the message when it is a member of the closed set; anything else is
|
|
100
160
|
* omitted at the mint. */
|
|
@@ -125,6 +185,15 @@ export interface UserMessageProvenance {
|
|
|
125
185
|
* frames still gets the cap refusal (nothing displaceable). */
|
|
126
186
|
capPreferred?: true;
|
|
127
187
|
}
|
|
188
|
+
/**
|
|
189
|
+
* How a turn's context is built from the session for `model` — the view every request of the turn starts from.
|
|
190
|
+
* Window-aware: declares the model's request window so the session's read-side clamp can re-budget the compaction
|
|
191
|
+
* summary's retained invoked-skills area against it (a session compacted under a large-window model must stay
|
|
192
|
+
* window-safe when THIS model is smaller). Physical request window (`contextTokens ?? contextWindow`) — the same
|
|
193
|
+
* coordinate the request hard-stop guards; an unknown/zero window disarms the clamp (legacy rendering). The one reading:
|
|
194
|
+
* the turn state and a caller that prices the next request before it is built both read the session through it.
|
|
195
|
+
*/
|
|
196
|
+
export declare function turnContextOptions(model: Model): BuildContextOptions;
|
|
128
197
|
/**
|
|
129
198
|
* Harness-level recovery wiring (design/118 ④b/⑤). The loop's prompt-too-long seam wants a
|
|
130
199
|
* replacement TRANSCRIPT; at the harness level the correct policy is a SESSION-persisted reduction
|
|
@@ -198,10 +267,13 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
198
267
|
/** The seat the loop published LAST — retract does not clear it, only the next publish replaces it (a fresh controller
|
|
199
268
|
* per turn, so identity carries the generation); the loop's cut-consumption report is accepted for THIS seat only. */
|
|
200
269
|
private lastPublishedSeat?;
|
|
201
|
-
private readonly
|
|
270
|
+
private readonly seatCuts;
|
|
202
271
|
private endedOnPriorAnswer;
|
|
203
272
|
private promptReceipt?;
|
|
204
273
|
private turnCutConsumed?;
|
|
274
|
+
private turnOpenedAt;
|
|
275
|
+
private acceptedCuts;
|
|
276
|
+
private readonly consumedCuts;
|
|
205
277
|
private readonly committedEntryIds;
|
|
206
278
|
private readonly answerSources;
|
|
207
279
|
/** backlog #389 — one-way latch set by {@link abort}. Read by `drainQueuedMessages`: no boundary may
|
|
@@ -239,6 +311,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
239
311
|
* with every request view that needed one (the transcript is never rewritten, so a broken turn is repaired, and
|
|
240
312
|
* reported, on each request; the sink owns its dedup). Advisory: a throwing sink never breaks the request. */
|
|
241
313
|
onToolTurnRepaired?: (repairs: readonly ToolTurnRepair[]) => void;
|
|
314
|
+
/** Runner-set projection of the request's copies of file contents, applied at the provider boundary after the tool-turn law and before the metadata strip (it reads the frames'
|
|
315
|
+
* delivery records the strip removes). `folds` = the results the law folded and the recorded results each folds. Absent ⇒ the view is sent as the law leaves it. */
|
|
316
|
+
projectRequestCopies?: (messages: Message[], folds: ReadonlyMap<Message, readonly Message[]>) => Message[];
|
|
242
317
|
/** Runner-set sink for the images a provider refused in THIS run ({@link removeRefusedRequestParts}) — a refusal recorded
|
|
243
318
|
* before the run began is not reported. Every request re-reads the transcript, so the sink owns its dedup (by
|
|
244
319
|
* `refusalAt`). Advisory: a throwing sink never breaks the request. */
|
|
@@ -315,6 +390,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
315
390
|
/** The request view of `messages` under the provider's image refusals they hold ({@link removeRefusedRequestParts}), and
|
|
316
391
|
* the removals this run met handed to {@link onImagesRemoved}. */
|
|
317
392
|
private imageRefusalView;
|
|
393
|
+
/** The provider-bound view: the tool-turn law, then the request's copy projection over what the law leaves. */
|
|
318
394
|
private holdToolTurnLaw;
|
|
319
395
|
/** RB-30 R2 belt-and-braces: runner-callable idempotent recovery for exit paths that reach
|
|
320
396
|
* neither agent_end nor abort() (a pre-prompt throw after prepare). Swept entries are removed,
|
|
@@ -359,6 +435,8 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
359
435
|
private systemPrompt;
|
|
360
436
|
/** S4: physical system blocks (static per leg, additive — see AgentHarnessOptions.systemBlocks). */
|
|
361
437
|
private systemBlocks;
|
|
438
|
+
/** The leg's engine-text locale (see AgentHarnessOptions.promptLocale). */
|
|
439
|
+
private readonly promptLocale;
|
|
362
440
|
private streamOptions;
|
|
363
441
|
private getApiKeyAndHeaders?;
|
|
364
442
|
private runtime?;
|
|
@@ -468,19 +546,23 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
468
546
|
private handleAgentEvent;
|
|
469
547
|
private emitRunFailure;
|
|
470
548
|
private executeTurn;
|
|
471
|
-
/** Returns the run's final assistant message — or `undefined`
|
|
472
|
-
* user halt ({@link halt})
|
|
473
|
-
* zero-assistant ending still throws (see the executeTurn tail). */
|
|
549
|
+
/** Returns the run's final assistant message — or `undefined` when the run ended before any assistant output existed
|
|
550
|
+
* for a reason that is not a defect: a bare user halt ({@link halt}), or a turn cut ({@link cutTurn}) that settled the
|
|
551
|
+
* last turn before it said anything. Every other zero-assistant ending still throws (see the executeTurn tail). */
|
|
474
552
|
prompt(text: string, options?: {
|
|
475
553
|
images?: ImageContent[];
|
|
476
554
|
settleUnansweredToolCalls?: TrailingToolBatchOptions;
|
|
477
555
|
onCommitted?: PromptCommittedCallback;
|
|
478
|
-
} & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser): Promise<AssistantMessage | undefined>;
|
|
556
|
+
} & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser & PromptGivenAnswer & PromptAnsweredInputs & PromptOpensOnQueuedInput): Promise<AssistantMessage | undefined>;
|
|
479
557
|
/** R2-③: an empty/whitespace-only injection with no images carries ZERO information — it
|
|
480
558
|
* must not mint a user frame (strict endpoints reject empty user content, and an empty follow-up would
|
|
481
559
|
* pointlessly extend the run by one turn). No-op, not a throw: injection callers are fire-and-
|
|
482
560
|
* forget lanes (wakeups, reminders) and a shell bug upstream must not crash the run. */
|
|
483
561
|
private static emptyInjection;
|
|
562
|
+
/** The one mint of a queued frame: the user message and its sidecars, each judged from the options at the mint (never a
|
|
563
|
+
* message field). Shared by the enqueue below and a prompt's answered inputs, so a frame means the same whichever way it
|
|
564
|
+
* reached a lane. */
|
|
565
|
+
private mintInjection;
|
|
484
566
|
/** REF-B6 — the ONE injection enqueue behind steer/followUp/nextTurn: the R2-③ empty-injection
|
|
485
567
|
* short circuit, the user frame, the RB-30 engine-payload SIDECAR (a WeakMap entry, never a message field —
|
|
486
568
|
* pre-prompt exits recover these too), the queue push, and the broadcast. All three lanes ship in ONE
|
|
@@ -503,9 +585,14 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
503
585
|
steer(text: string, options?: {
|
|
504
586
|
images?: ImageContent[];
|
|
505
587
|
} & UserMessageProvenance): Promise<UserMessage | undefined>;
|
|
588
|
+
/** An engine-minted frame that carries its own delivery record (an attachment frame the engine loads mid-run) on the
|
|
589
|
+
* steer lane: an engine advisory, so it rides the next request the run already owes and never opens one; it is
|
|
590
|
+
* delivered when it is in the transcript, where its record's receipt is reported like a prompt's trailing frame's. */
|
|
591
|
+
steerFrame(seed: TrailingMessageSeed): Promise<UserMessage | undefined>;
|
|
592
|
+
/** `givenAnswer` ({@link PromptGivenAnswer}): the frame's turn is that answer — the frame drains alone, and no model is asked. */
|
|
506
593
|
followUp(text: string, options?: {
|
|
507
594
|
images?: ImageContent[];
|
|
508
|
-
} & UserMessageProvenance): Promise<void>;
|
|
595
|
+
} & UserMessageProvenance & PromptGivenAnswer): Promise<void>;
|
|
509
596
|
/**
|
|
510
597
|
* design/373 §3.4 — force the running turn's boundary FOR a queued immediate-class frame:
|
|
511
598
|
* abort the CURRENT main turn (provider stream + tool batch — never the run, never boundary
|
|
@@ -514,14 +601,14 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
514
601
|
* happened AND none was needed — the frame is already consumed or already rides the imminent
|
|
515
602
|
* boundary — so delivery semantics are exactly the non-interrupting ones either way.
|
|
516
603
|
*
|
|
517
|
-
* Guards
|
|
518
|
-
* -
|
|
519
|
-
* - CONSUMPTION guard (r4/R3-1): the frame must still sit in the steer queue. Drained/consumed ⇒
|
|
604
|
+
* Guards:
|
|
605
|
+
* - CONSUMPTION guard: the frame must still sit in the steer queue. Drained/consumed ⇒
|
|
520
606
|
* it is already part of a turn's input — aborting THAT turn would cut the very delivery this
|
|
521
607
|
* verb exists to speed up. Same-tick check-then-abort (single-threaded: no window);
|
|
522
|
-
* -
|
|
523
|
-
*
|
|
524
|
-
* turn — later immediates join the same
|
|
608
|
+
* - then {@link cutTurn}'s own: an unwinding run owns its ending; no published turn (idle tail /
|
|
609
|
+
* between turns / boundary housekeeping) ⇒ no-op, the frame rides the next boundary; an
|
|
610
|
+
* already-fired seat ⇒ idempotent no-op (one boundary per turn — later immediates join the same
|
|
611
|
+
* boundary batch).
|
|
525
612
|
*/
|
|
526
613
|
interruptTurn(frame: AgentMessage): boolean;
|
|
527
614
|
/**
|
|
@@ -572,11 +659,38 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
572
659
|
turnCut: boolean;
|
|
573
660
|
accepted: boolean;
|
|
574
661
|
};
|
|
575
|
-
/**
|
|
576
|
-
*
|
|
577
|
-
*
|
|
578
|
-
*
|
|
579
|
-
|
|
662
|
+
/**
|
|
663
|
+
* The ONE turn cut: the halt, the steer-now accelerator and an extension's `$.turn.abort` all end the running turn
|
|
664
|
+
* here. What differs between them is the row their cut settles by ({@link TURN_CUT_SETTLEMENTS}) and what each caller
|
|
665
|
+
* does around the cut (the halt's stop latch, the steer's frame guard) — nothing else. Guards: {@link turnSeatState}'s.
|
|
666
|
+
* The aborter is stamped FIRST (a seat is never aborted twice; its first aborter is its source), then the seat aborted.
|
|
667
|
+
* A run abort fired INSIDE this dispatch (a listener on the cut signal tearing the run down) was fired BY the cut — the
|
|
668
|
+
* loop takes the run-terminal path and never reports that settlement, so the consumption is recorded here, the only
|
|
669
|
+
* point that can see the causation (synchronous, single-threaded). A LATER abort is the run's own ending.
|
|
670
|
+
* Every cut answered `"cut"` is ACCEPTED; one that no settlement then takes as its turn's cause is reported by
|
|
671
|
+
* {@link haltConsumption} (`unconsumedCuts`). `extension` names an extension's cut: its registration and the turn it ended.
|
|
672
|
+
*/
|
|
673
|
+
cutTurn(source: SeatCutSource, extension?: {
|
|
674
|
+
readonly by: string;
|
|
675
|
+
readonly turn: number;
|
|
676
|
+
}): TurnCutVerdict;
|
|
677
|
+
/** The cut that settled the last-published seat's turn: the last turn's record, and the run's ledger of consumed cuts. */
|
|
678
|
+
private consumeTurnCut;
|
|
679
|
+
/**
|
|
680
|
+
* What a cut would find now, read without cutting: a turn in flight to cut (`"live"`); none (`"none"` — no published
|
|
681
|
+
* seat: between turns, an answered turn, boundary housekeeping); or one already ending (`"ending"` — an unwinding run
|
|
682
|
+
* owns its ending, and a cut seat has had its one boundary). Synchronous: a {@link cutTurn} in the same synchronous step
|
|
683
|
+
* finds what this found.
|
|
684
|
+
*/
|
|
685
|
+
turnSeatState(): "live" | Exclude<TurnCutVerdict, "cut">;
|
|
686
|
+
/**
|
|
687
|
+
* Does the cut behind `signal` move an armed running command into the background instead of ending it — its source's
|
|
688
|
+
* row ({@link TURN_CUT_SETTLEMENTS})? `signal` is the one a running tool call holds: the seat this harness published
|
|
689
|
+
* last, whose cut is stamped BEFORE its abort dispatches, so an abort listener reads the source of the very cut it is
|
|
690
|
+
* hearing. Any other signal, and a seat no named source cut (a run-level abort reaching it), answer no.
|
|
691
|
+
*/
|
|
692
|
+
cutMovesArmedCommandAside(signal: AbortSignal): boolean;
|
|
693
|
+
private seatToCut;
|
|
580
694
|
/** The entry ids of the committed messages an answer `prompt()` returned was read from, in conversation order: the
|
|
581
695
|
* final assistant message, or every member of the continuation chain merged into it (members never appended — an
|
|
582
696
|
* empty failure — have no id). Bound to the returned object, so a prompt that rejects, or one overlapping another,
|
|
@@ -594,8 +708,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
594
708
|
* signal always wins (the loop's cut arms' rule): an unwinding run ends FOR its abort — the latch's true answer is
|
|
595
709
|
* incidental (the next turn's abort guard would have exited anyway), so the attribution is withheld, not the exit. */
|
|
596
710
|
private consultStopLatch;
|
|
597
|
-
/** The loop's report that a seat's cut settled its turn (the loop-config seam)
|
|
598
|
-
*
|
|
711
|
+
/** The loop's report that a seat's cut settled its turn (the loop-config seam), answered with the row the cut settles
|
|
712
|
+
* by — its source's ({@link TURN_CUT_SETTLEMENTS}); an unstamped cut answers none (the loop's own row). Identity is
|
|
713
|
+
* checked against the LAST-published seat, never the live one (the arms report around retraction); any other seat is
|
|
714
|
+
* refused loudly. */
|
|
599
715
|
private noteTurnCutConsumed;
|
|
600
716
|
/**
|
|
601
717
|
* design/373 §3.3 (the final-commit-point double check) — how many queued injection frames a
|