@sema-agent/core 7.66.1 → 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 +3483 -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 +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +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.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -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,23 +1,18 @@
|
|
|
1
|
+
import { unfitFeedbackOf, writtenFeedback } from "../approval-words.js";
|
|
1
2
|
import { CheckpointError } from "../checkpoint-store.js";
|
|
2
|
-
import {
|
|
3
|
-
|
|
4
|
-
const trimmed = feedback?.trim();
|
|
5
|
-
return trimmed === undefined || trimmed === "" ? undefined : trimmed;
|
|
6
|
-
}
|
|
3
|
+
import { asThrownError } from "../thrown-value.js";
|
|
4
|
+
import { sentinelTagRefusal } from "../untrusted-text.js";
|
|
7
5
|
export function refuseUnfitFeedback(twin) {
|
|
8
|
-
const
|
|
9
|
-
if (
|
|
6
|
+
const unfit = unfitFeedbackOf(writtenFeedback(twin.feedback), { allowed: twin.decision === "allow", byPerson: twin.hostDecision.decidedBy === "person" });
|
|
7
|
+
if (unfit === undefined)
|
|
10
8
|
return;
|
|
11
|
-
if (
|
|
9
|
+
if (unfit === "on_a_deny") {
|
|
12
10
|
throw feedbackRefusal("resume carried `feedback` on a `deny` — feedback is the approving person's words on an `allow` (a denial's words are `reason`); refusing rather than dropping it silently, the checkpoint stays pending");
|
|
13
11
|
}
|
|
14
|
-
|
|
15
|
-
if (!byPerson) {
|
|
12
|
+
if (unfit === "by_a_machine") {
|
|
16
13
|
throw feedbackRefusal(`resume carried \`feedback\` on a decide made by "${twin.hostDecision.decidedBy}" — feedback is delivered to the model as the user's own words, which only a person's decide can be; refusing rather than attributing a machine's text to the user, the checkpoint stays pending`);
|
|
17
14
|
}
|
|
18
|
-
|
|
19
|
-
throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
|
|
20
|
-
}
|
|
15
|
+
throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
|
|
21
16
|
}
|
|
22
17
|
function feedbackRefusal(message) {
|
|
23
18
|
return new CheckpointError("checkpoint.invalid_outcome", message, { field: "feedback" });
|
|
@@ -31,6 +26,16 @@ export function withApprovalWords(continuation, engineSegments, words) {
|
|
|
31
26
|
engineSegments.push({ start: glueStart, end: withGlue.length });
|
|
32
27
|
return withGlue + words;
|
|
33
28
|
}
|
|
29
|
+
export function approvalWordsSeat(harness, report) {
|
|
30
|
+
return async (words) => {
|
|
31
|
+
try {
|
|
32
|
+
await harness.steer(words);
|
|
33
|
+
}
|
|
34
|
+
catch (err) {
|
|
35
|
+
report(new Error(`the approving person's words could not be queued for the model: ${asThrownError(err).message}`));
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
}
|
|
34
39
|
const APPROVAL_WORDS_FRAMES = new WeakSet();
|
|
35
40
|
export function owedApprovalWords(words, inputId) {
|
|
36
41
|
if (words === undefined)
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { ApproverDefect } from "../tool-policy.js";
|
|
2
|
+
/**
|
|
3
|
+
* The announcer `resolveAskFor` is handed at every station that puts an ask to an approver (`approval.approver_defect`): the approver
|
|
4
|
+
* threw, or answered outside its contract, and the call it was asked about is denied fail-closed. The denial is the model's and the
|
|
5
|
+
* run's — it reads as any refusal; this is the deployment's, who wired a seat that does not keep its contract. Once per denied ask. The
|
|
6
|
+
* detail names how it failed and what kind of seat it was, and never the thrown text or the answer (the denial the model reads names
|
|
7
|
+
* them).
|
|
8
|
+
*/
|
|
9
|
+
export declare function approverDefectAnnouncer(args: {
|
|
10
|
+
toolName: string;
|
|
11
|
+
toolCallId: string;
|
|
12
|
+
sessionId: string;
|
|
13
|
+
runId: string;
|
|
14
|
+
/** The leg's own task id (`Prepared.taskId`), always present. */
|
|
15
|
+
taskId: string;
|
|
16
|
+
onNotice: import("../types.js").RunnerDeps["onNotice"];
|
|
17
|
+
}): (defect: ApproverDefect) => void;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
2
|
+
import { deliverEngineNotice } from "../types.js";
|
|
3
|
+
export function approverDefectAnnouncer(args) {
|
|
4
|
+
return (defect) => {
|
|
5
|
+
const how = defect.cause === "threw" ? "threw" : 'answered outside its contract (an answer that is not true, false, "unavailable" or the {allow} object, or an object the seam refuses)';
|
|
6
|
+
const which = defect.seat === "policy" ? "approval policy (asPolicyApprover)" : "approver";
|
|
7
|
+
deliverEngineNotice(args.onNotice, {
|
|
8
|
+
code: "approval.approver_defect",
|
|
9
|
+
message: `the deployment's ${which} ${how} on the ask for "${args.toolName}" — the call was denied fail-closed and the tool did not run. ` +
|
|
10
|
+
"Every ask this seat fails to answer in contract is refused the same way; the model reads the denial as an ordinary one.",
|
|
11
|
+
detail: {
|
|
12
|
+
toolName: args.toolName,
|
|
13
|
+
toolCallId: args.toolCallId,
|
|
14
|
+
cause: defect.cause,
|
|
15
|
+
seat: defect.seat,
|
|
16
|
+
sessionId: args.sessionId,
|
|
17
|
+
runId: args.runId,
|
|
18
|
+
...legNoticeTaskId(args),
|
|
19
|
+
},
|
|
20
|
+
});
|
|
21
|
+
};
|
|
22
|
+
}
|
|
@@ -16,7 +16,13 @@ export interface Stats {
|
|
|
16
16
|
cacheWriteTokensLong: number;
|
|
17
17
|
outputTokens: number;
|
|
18
18
|
cacheHitRate?: number;
|
|
19
|
-
/**
|
|
19
|
+
/** The cache account's marks, exclusions and per-lane operands (`./cache-hit-account.ts`; the public faces are documented on
|
|
20
|
+
* `TaskResult.stats`). `cacheLanes` is run-loop internal, stripped at assembly. */
|
|
21
|
+
cacheReadUnreported?: true;
|
|
22
|
+
cacheWriteUnreported?: true;
|
|
23
|
+
cacheHitRateExcludes?: import("./cache-hit-account.js").CacheHitExclusion[];
|
|
24
|
+
cacheLanes?: import("./cache-hit-account.js").CacheLanes;
|
|
25
|
+
/** Cache-INCLUSIVE prompt total (`promptTokens + cachedTokens + cacheWriteTokens`; the one-hour writes are a part of the last) — the
|
|
20
26
|
* billing/window/hit-rate denominator. Required (not derived) so a new accumulation site that forgets
|
|
21
27
|
* it fails the type check instead of silently reporting a total short by its own leg. */
|
|
22
28
|
totalInputTokens: number;
|
|
@@ -38,7 +44,8 @@ export interface Stats {
|
|
|
38
44
|
* `gate.kind`, accumulated across resume legs. Set by the run loop from the per-task human-review
|
|
39
45
|
* accumulator (synchronous `resolveAsk` timing + durable resume latency). **NOT an LLM cost** — never
|
|
40
46
|
* folded into `costMicroUsd`/`costBreakdown`/the budget gate (same budget-excluded treatment as `memory`).
|
|
41
|
-
* Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread
|
|
47
|
+
* Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread (`TaskResult.stats.humanReview`
|
|
48
|
+
* says when it is present). */
|
|
42
49
|
humanReview?: {
|
|
43
50
|
count: number;
|
|
44
51
|
totalWaitMs: number;
|
|
@@ -136,14 +143,21 @@ export interface ResultFlags {
|
|
|
136
143
|
* one — the model did not finish; the person stopped it and the run awaits their direction). */
|
|
137
144
|
haltedOnUserRejection?: boolean;
|
|
138
145
|
/** the harness's STATEMENT of what the run's halt did (see `HaltConsumption`):
|
|
139
|
-
* the loop's report that the halt's cut settled the final turn, and/or the boundary consult that
|
|
140
|
-
* stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser`
|
|
141
|
-
* (
|
|
146
|
+
* the loop's report that the halt's (or an extension's) cut settled the final turn, and/or the boundary consult that
|
|
147
|
+
* stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser` / `turnAbortedBy`
|
|
148
|
+
* (halt-attribution.ts) and to slot 9.7 — the assembly never infers causation from the
|
|
142
149
|
* final's shape or from the verb's acceptance. A halt that was accepted but consumed nothing (the run
|
|
143
150
|
* ended for its own reason first) leaves this empty: the original terminal stands and the seat is
|
|
144
151
|
* NOT signed (the settle lane mints `task.halt_unconsumed` for it). */
|
|
145
152
|
haltConsumption?: HaltConsumption;
|
|
146
153
|
answerEntryIds?: readonly string[];
|
|
154
|
+
intake?: TaskResult["intake"];
|
|
155
|
+
/** What the leg's display showed of those messages, when a `classic.MessageDisplay` handler changed it (the display's own
|
|
156
|
+
* reading, `MessageDisplay.displayedOf`): `result` is then that text, through the same projection, and `resultDisplayedBy` names who. */
|
|
157
|
+
displayed?: {
|
|
158
|
+
readonly text: string;
|
|
159
|
+
readonly by: readonly string[];
|
|
160
|
+
};
|
|
147
161
|
/** Call ids of answered-but-never-collected questions, echoed on
|
|
148
162
|
* `TaskResult.strandedHumanAnswers`. Pure pass-through; empty/absent ⇒ the field is omitted. The
|
|
149
163
|
* optional `onError` alert is NOT the disclosure — this mandatory result face is. */
|
|
@@ -202,9 +216,9 @@ export interface ResultFlags {
|
|
|
202
216
|
blockedReason?: string;
|
|
203
217
|
blockedDetail?: TerminalBlockedDetail;
|
|
204
218
|
conflict?: boolean;
|
|
205
|
-
/**
|
|
206
|
-
*
|
|
207
|
-
|
|
219
|
+
/** The request-build guard threw the irreducible-core terminal this run (the trim's core or the git frame's) — the loop
|
|
220
|
+
* folded it into a text-only failure message, so the typed code rides this flag. */
|
|
221
|
+
coreOverBudget?: boolean;
|
|
208
222
|
outputInvalid?: boolean;
|
|
209
223
|
/** The word the loop's last exit named (`Prepared.loopTerminalRef`), read through `loopExitFailureOf`; absent = the loop never exited. */
|
|
210
224
|
loopTerminal?: LoopTerminalReason;
|
|
@@ -270,8 +284,8 @@ export interface ResultFlags {
|
|
|
270
284
|
* landed on work or on the tail. Evaluated ONCE per leg (the terminal-adoption lane, where both facts
|
|
271
285
|
* are in hand) and handed on as a value — {@link ResultFlags.answerSettled} — so the arbitration, the
|
|
272
286
|
* marker gate, the hook-seat grace, the teardown attribution and the notice read the same verdict.
|
|
273
|
-
* (A
|
|
274
|
-
*
|
|
287
|
+
* (A budget ceiling crossed by the last turn's own spend reads the same verdict at its own slot, above
|
|
288
|
+
* slot 9: an answered turn owes no further request, so the ceiling is a fact on `stats`, not a failure.)
|
|
275
289
|
*/
|
|
276
290
|
export declare function answerSettled(final: AssistantMessage | undefined, continuationCut?: boolean): boolean;
|
|
277
291
|
export declare function terminalCauseOf(final: AssistantMessage | undefined, stats: Pick<Stats, "humanReview">, flags: ResultFlags): {
|
|
@@ -286,7 +300,7 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
|
|
|
286
300
|
* 2. degenerate → `"output.degenerate"` + `salvagedOutput` (wins over budget/timeout)
|
|
287
301
|
* 3. `budgetHit` → `"limits.max_tokens_exceeded"` | `"limits.max_cost_exceeded"` (by `budgetAxis`;
|
|
288
302
|
* the pre-call estimate rejection and the after-spend crossing share the code — the distinction
|
|
289
|
-
* lives in `errorMessage`, not in a second code)
|
|
303
|
+
* lives in `errorMessage`, not in a second code), EXCEPT when `answerSettled` (the answering turn's own spend crossed it → 12)
|
|
290
304
|
* 3.5 `suspendLoop` → `"suspend.loop"` (the re-suspend cap; deterministic root
|
|
291
305
|
* cause, above `threw` because it owns the abort)
|
|
292
306
|
* 4. `threw` + walltime → `"limits.max_walltime_exceeded"`
|
|
@@ -301,15 +315,16 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
|
|
|
301
315
|
* 9. `abortedLive` | stopReason aborted → `"limits.max_walltime_exceeded"` | `"limits.max_turns_exceeded"` | undefined
|
|
302
316
|
* (audit A-1: hoisted ABOVE no-final — the loop exits cleanly on abort, so `final` may be a
|
|
303
317
|
* normal message or absent; a plain user interrupt carries NO errorCode — switch on `status`),
|
|
304
|
-
* EXCEPT when the aborted `final` is
|
|
305
|
-
* loop reported the halt's cut settled the final turn — never shape inference),
|
|
318
|
+
* EXCEPT when the aborted `final` is an ending cut's OWN artifact (`cutOwnsAbortedFinal`: the
|
|
319
|
+
* loop reported the halt's, or an extension's `$.turn.abort`, cut settled the final turn — never shape inference),
|
|
306
320
|
* and EXCEPT when the answer had already settled (`answerSettled`: a clean `"stop"` final, not
|
|
307
321
|
* partial) — a stop landing on the run's tail cuts no work, so the run falls through to 12
|
|
308
322
|
* (`completed`, the answer as `result`, no `limits.*` code for the axis; three axes, one law)
|
|
309
323
|
* 9.7 halt CONSUMED (`haltConsumed(flags.haltConsumption)`) + (no `final` | the halt's own aborted
|
|
310
324
|
* `final`) → status `"completed"` (a bare user halt — the verb working, not a defect; below the
|
|
311
325
|
* aborts on purpose, a real abort/limit that also fired owns the terminal and the halt rides as
|
|
312
|
-
* the pass-through seat; an accepted-but-unconsumed halt never reaches this slot)
|
|
326
|
+
* the pass-through seat; an accepted-but-unconsumed halt never reaches this slot); an extension's
|
|
327
|
+
* `$.turn.abort` that ended the final turn reaches it the same way (`endingCutConsumed`, `turnAbortedBy`)
|
|
313
328
|
* 10. no `final` → status `"failed"`
|
|
314
329
|
* 11. stopReason error → brain `[code]` prefix (or `"conflict"` from the storage-layer flag)
|
|
315
330
|
* 11.5 the loop exited on a spent recovery budget (`loopTerminal`, read through `loopExitFailureOf`) →
|
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
|
|
2
2
|
import { extractErrorCode, isProviderEchoShape, refusedTheRequest, stripErrorCodePrefix } from "../../brain/errors.js";
|
|
3
|
-
import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
|
|
3
|
+
import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerSentenceOf, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
|
|
4
4
|
import { terminalProjection } from "./terminal-projection.js";
|
|
5
|
-
import { haltConsumed } from "./halt-attribution.js";
|
|
5
|
+
import { endingCutConsumed, haltConsumed, turnAbortedByOf } from "./halt-attribution.js";
|
|
6
6
|
import { providerReportedModel } from "../message-utils.js";
|
|
7
|
-
import {
|
|
8
|
-
import { describeRejectedValue } from "../tool-search-setting.js";
|
|
7
|
+
import { readMember, thrownText } from "../thrown-value.js";
|
|
9
8
|
const SALVAGE_ELIGIBLE_TERMINALS = new Set([
|
|
10
9
|
"output.degenerate",
|
|
11
10
|
"limits.max_tokens_exceeded",
|
|
@@ -15,14 +14,6 @@ const SALVAGE_ELIGIBLE_TERMINALS = new Set([
|
|
|
15
14
|
"env.lifetime_expired",
|
|
16
15
|
"usage.window_exhausted",
|
|
17
16
|
]);
|
|
18
|
-
function thrownMessage(threw) {
|
|
19
|
-
if (isErrorLike(threw)) {
|
|
20
|
-
const m = readMember(threw, "message");
|
|
21
|
-
if (typeof m === "string")
|
|
22
|
-
return m;
|
|
23
|
-
}
|
|
24
|
-
return describeRejectedValue(threw);
|
|
25
|
-
}
|
|
26
17
|
function stripThinkTags(text) {
|
|
27
18
|
let t = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
|
|
28
19
|
const lower = t.toLowerCase();
|
|
@@ -45,7 +36,7 @@ export function answerSettled(final, continuationCut = false) {
|
|
|
45
36
|
export function terminalCauseOf(final, stats, flags) {
|
|
46
37
|
let terminal;
|
|
47
38
|
let apiFailure;
|
|
48
|
-
const
|
|
39
|
+
const cutOwnsAbortedFinal = endingCutConsumed(flags.haltConsumption) &&
|
|
49
40
|
final?.stopReason === "aborted" &&
|
|
50
41
|
!flags.abortedLive &&
|
|
51
42
|
flags.abortedForTimeout !== true &&
|
|
@@ -59,7 +50,7 @@ export function terminalCauseOf(final, stats, flags) {
|
|
|
59
50
|
else if (isDegenerate) {
|
|
60
51
|
terminal = { kind: "failed", code: "output.degenerate", ...(final?.errorMessage !== undefined ? { message: final.errorMessage } : {}) };
|
|
61
52
|
}
|
|
62
|
-
else if (flags.budgetHit) {
|
|
53
|
+
else if (flags.budgetHit && flags.answerSettled !== true) {
|
|
63
54
|
const axisName = flags.budgetAxis === "tokens" ? "limits.maxTokens" : "limits.maxCostUsd";
|
|
64
55
|
terminal = {
|
|
65
56
|
kind: "failed",
|
|
@@ -83,7 +74,7 @@ export function terminalCauseOf(final, stats, flags) {
|
|
|
83
74
|
terminal = { kind: "failed", code: "suspend.loop", message };
|
|
84
75
|
}
|
|
85
76
|
else if (flags.threw) {
|
|
86
|
-
const thrown = thrownFailureOf(flags.threw,
|
|
77
|
+
const thrown = thrownFailureOf(flags.threw, thrownText(flags.threw));
|
|
87
78
|
const axisCode = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : flags.conflict ? "conflict" : undefined;
|
|
88
79
|
const code = axisCode ?? thrown.code;
|
|
89
80
|
const detail = axisCode === undefined ? thrown.detail : undefined;
|
|
@@ -95,11 +86,11 @@ export function terminalCauseOf(final, stats, flags) {
|
|
|
95
86
|
else if (flags.paused) {
|
|
96
87
|
terminal = flags.paused;
|
|
97
88
|
}
|
|
98
|
-
else if ((flags.abortedLive || final?.stopReason === "aborted") && !
|
|
89
|
+
else if ((flags.abortedLive || final?.stopReason === "aborted") && !cutOwnsAbortedFinal && flags.answerSettled !== true) {
|
|
99
90
|
const code = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : undefined;
|
|
100
91
|
terminal = { kind: "failed", ...(code !== undefined ? { code } : {}), message: final?.errorMessage ?? (flags.abortedForTurns ? "max turns exceeded" : "run aborted") };
|
|
101
92
|
}
|
|
102
|
-
else if ((haltConsumed(flags.haltConsumption) && (!final ||
|
|
93
|
+
else if (((haltConsumed(flags.haltConsumption) || endingCutConsumed(flags.haltConsumption)) && (!final || cutOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
|
|
103
94
|
terminal = { kind: "completed" };
|
|
104
95
|
}
|
|
105
96
|
else if (!final) {
|
|
@@ -124,7 +115,7 @@ export function terminalCauseOf(final, stats, flags) {
|
|
|
124
115
|
code = lifted;
|
|
125
116
|
message = stripErrorCodePrefix(message);
|
|
126
117
|
}
|
|
127
|
-
else if (flags.
|
|
118
|
+
else if (flags.coreOverBudget) {
|
|
128
119
|
code = "irreducible_core_over_budget";
|
|
129
120
|
messageNamed = false;
|
|
130
121
|
}
|
|
@@ -139,7 +130,7 @@ export function terminalCauseOf(final, stats, flags) {
|
|
|
139
130
|
let detail;
|
|
140
131
|
if (messageNamed && apiError && typeof apiStatus === "number" && refusedTheRequest(apiStatus)) {
|
|
141
132
|
const route = requestRouteOfMessage(final);
|
|
142
|
-
detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
|
|
133
|
+
detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...providerSentenceOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
|
|
143
134
|
}
|
|
144
135
|
else if (messageNamed && outputInvalid !== undefined) {
|
|
145
136
|
detail = { kind: "model_output_invalid", ...outputInvalid };
|
|
@@ -168,19 +159,19 @@ export function assembleResult(leg, final, stats, flags) {
|
|
|
168
159
|
...(stats.sideCallMicroUsd !== undefined ? { sideCallMicroUsd: stats.sideCallMicroUsd } : {}),
|
|
169
160
|
};
|
|
170
161
|
}
|
|
171
|
-
const result = text;
|
|
162
|
+
const result = flags.displayed !== undefined ? stripThinkTags(flags.displayed.text) : text;
|
|
172
163
|
let salvagedOutput;
|
|
173
164
|
const { terminal, apiFailure } = terminalCauseOf(final, stats, flags);
|
|
174
165
|
const { errorCode } = terminalProjection(terminal);
|
|
175
166
|
if (errorCode !== undefined && SALVAGE_ELIGIBLE_TERMINALS.has(errorCode)) {
|
|
176
|
-
salvagedOutput =
|
|
167
|
+
salvagedOutput = result.trim() || undefined;
|
|
177
168
|
}
|
|
178
169
|
const retryAfterMs = errorCode === "usage.window_exhausted" || errorCode === "memory.admission_required" ? flags.retryAfterMs : undefined;
|
|
179
|
-
const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, ...publicStats } = stats;
|
|
180
|
-
void _internalCompaction;
|
|
181
|
-
void _internalSideCall;
|
|
170
|
+
const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, cacheLanes: _internalCacheLanes, ...publicStats } = stats;
|
|
171
|
+
void [_internalCompaction, _internalSideCall, _internalCacheLanes];
|
|
182
172
|
if (flags.unpricedSpend)
|
|
183
173
|
delete publicStats.costMicroUsd;
|
|
184
174
|
const stampHaltedByUser = haltConsumed(flags.haltConsumption);
|
|
185
|
-
|
|
175
|
+
const turnAbortedBy = turnAbortedByOf(flags.haltConsumption);
|
|
176
|
+
return { taskId, ...(flags.runId !== undefined ? { runId: flags.runId } : {}), sessionId, terminal, ...(flags.model !== undefined ? { model: flags.model } : {}), ...(responseModel !== undefined ? { responseModel } : {}), result: result.trim(), ...(flags.answerEntryIds !== undefined ? { resultEntryIds: [...flags.answerEntryIds] } : {}), ...(flags.intake !== undefined ? { intake: flags.intake } : {}), ...(flags.displayed !== undefined ? { resultDisplayedBy: [...flags.displayed.by] } : {}), salvagedOutput, ...(apiFailure !== undefined ? { apiFailure } : {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.editedFiles !== undefined && flags.editedFiles.length > 0 ? { editedFiles: flags.editedFiles } : {}), ...(flags.haltedOnUserRejection === true ? { haltedOnUserRejection: true } : {}), ...(stampHaltedByUser ? { haltedByUser: true } : {}), ...(turnAbortedBy !== undefined ? { turnAbortedBy } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: [...flags.remoteEnvFailures] } : {}), ...(flags.strandedHumanAnswers !== undefined && flags.strandedHumanAnswers.length > 0 ? { strandedHumanAnswers: flags.strandedHumanAnswers } : {}), ...(flags.effectiveReadFace !== undefined ? { effectiveReadFace: flags.effectiveReadFace } : {}), ...(flags.effectiveWriteFace !== undefined ? { effectiveWriteFace: flags.effectiveWriteFace } : {}), ...(flags.effectiveReadDenyPatterns !== undefined && flags.effectiveReadDenyPatterns.length > 0 ? { effectiveReadDenyPatterns: flags.effectiveReadDenyPatterns } : {}), ...(flags.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: flags.effectiveMemoryScopes } : {}), ...(flags.placementRoot !== undefined ? { placementRoot: flags.placementRoot } : {}), ...(flags.effectiveReasoning !== undefined ? { effectiveReasoning: flags.effectiveReasoning } : {}), ...(flags.compaction !== undefined ? { compaction: flags.compaction } : {}), stats: publicStats };
|
|
186
177
|
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The run's cache-hit account: the ONE fold of a booked call's cache members onto the aggregate faces, and the ONE derivation of
|
|
3
|
+
* the leg's cache-hit rate from it. Both usage accounts (`main-call-account.ts`, `side-call-account.ts`) book every call through
|
|
4
|
+
* {@link bookCacheOperands}; nothing else reads a usage's cache members for the aggregates.
|
|
5
|
+
*
|
|
6
|
+
* Two layers, one reading each:
|
|
7
|
+
* - a single call's `Usage` says "not reported" by leaving `cacheRead` / `cacheWrite` ABSENT (a reported 0 is a measured 0);
|
|
8
|
+
* - an aggregate keeps its numbers (the counted sum, absent members adding nothing) and says what they are with marks:
|
|
9
|
+
* `cacheReadUnreported` / `cacheWriteUnreported` — some call did not report that member, so the sum is not a measurement of it;
|
|
10
|
+
* and, on a family whose input EXCLUDES the cached parts (the total is input + reads + writes), a missing cache member also
|
|
11
|
+
* leaves the total a lower bound, which is the existing `usageMissing` mark.
|
|
12
|
+
*
|
|
13
|
+
* The hit rate is judged per LANE (the main loop, each side-call lane): a lane is complete while every call on it stated what the
|
|
14
|
+
* ratio needs — a known usage (not `usageMissing`), the cache reads, and on an input-excludes-cached family the cache writes too
|
|
15
|
+
* (they are part of the denominator). An incomplete lane is left out of the rate whole, so one lane that does not report (a
|
|
16
|
+
* classifier on a gateway without the cache counts) does not erase another lane's rate, and a lane that reports only some of
|
|
17
|
+
* its calls (a gateway that omits a zero) is never read off its reporting calls alone. The one identity:
|
|
18
|
+
* `rate = (cachedTokens − Σ excluded.cachedTokens) / (totalInputTokens − Σ excluded.totalInputTokens)`.
|
|
19
|
+
*/
|
|
20
|
+
import type { Usage } from "../../internal/llm.js";
|
|
21
|
+
import type { Stats } from "./assemble-result.js";
|
|
22
|
+
import type { UsageLane } from "./side-call-account.js";
|
|
23
|
+
import type { CacheFamily } from "./usage-accounting.js";
|
|
24
|
+
/** One lane's ratio operands as the account counted them, and whether every call on it stated them. */
|
|
25
|
+
export interface CacheLaneOperands {
|
|
26
|
+
cachedTokens: number;
|
|
27
|
+
totalInputTokens: number;
|
|
28
|
+
complete: boolean;
|
|
29
|
+
}
|
|
30
|
+
/** The lanes a leg booked calls on, keyed by lane, in the order each lane first booked one. */
|
|
31
|
+
export type CacheLanes = Partial<Record<UsageLane, CacheLaneOperands>>;
|
|
32
|
+
/** A lane left out of the cache-hit rate, with what it contributed to the aggregate numbers. */
|
|
33
|
+
export interface CacheHitExclusion {
|
|
34
|
+
readonly lane: UsageLane;
|
|
35
|
+
readonly cachedTokens: number;
|
|
36
|
+
readonly totalInputTokens: number;
|
|
37
|
+
}
|
|
38
|
+
/** What one booked call's usage says about its cache members. */
|
|
39
|
+
export interface CacheMemberMarks {
|
|
40
|
+
/** The call did not report its cache reads. */
|
|
41
|
+
readonly readUnreported: boolean;
|
|
42
|
+
/** The call did not report its cache writes. */
|
|
43
|
+
readonly writeUnreported: boolean;
|
|
44
|
+
/** A member the call's total is made of was not reported (input-excludes-cached family): the total is a lower bound. */
|
|
45
|
+
readonly totalLowerBound: boolean;
|
|
46
|
+
}
|
|
47
|
+
/** A usage a call reported, under the cache family of the model that made it. */
|
|
48
|
+
export interface ReportedUsage {
|
|
49
|
+
readonly family: CacheFamily;
|
|
50
|
+
readonly usage: Usage;
|
|
51
|
+
}
|
|
52
|
+
/** The marks of one call's usage (absent ⇒ the call reported nothing: every member is unreported and its total a lower bound). */
|
|
53
|
+
export declare function cacheMemberMarksOf(reported: ReportedUsage | undefined): CacheMemberMarks;
|
|
54
|
+
/**
|
|
55
|
+
* Book one call on `lane`: its cache marks onto the leg's stats, its ratio operands onto the lane. `reported` absent ⇒ the call —
|
|
56
|
+
* or a main-loop turn that booked no call — reported nothing; `usageMissing` ⇒ the call's usage is a lower bound; either way the
|
|
57
|
+
* lane is incomplete. `totalInputTokens` is the call's cache-inclusive input total as the account counted it. Returns the
|
|
58
|
+
* call's marks, for the turn's frame.
|
|
59
|
+
*/
|
|
60
|
+
export declare function bookCacheOperands(stats: Stats, lane: UsageLane, reported: ReportedUsage | undefined, usageMissing: boolean, totalInputTokens: number): CacheMemberMarks;
|
|
61
|
+
/** A call's cache members as its `brain.call` trace row carries them: each one present only when the call reported it. */
|
|
62
|
+
export declare function cacheTraceMembersOf(usage: Usage): {
|
|
63
|
+
cacheRead?: number;
|
|
64
|
+
cacheWrite?: number;
|
|
65
|
+
};
|
|
66
|
+
/** The lanes left out of the rate: every incomplete lane, with its counted operands. */
|
|
67
|
+
export declare function cacheHitExclusionsOf(lanes: CacheLanes | undefined): CacheHitExclusion[];
|
|
68
|
+
/** The rate's operands by the one identity: the aggregate numbers minus what the excluded lanes contributed. */
|
|
69
|
+
export declare function cacheHitOperandsOf(totals: {
|
|
70
|
+
readonly cachedTokens: number;
|
|
71
|
+
readonly totalInputTokens: number;
|
|
72
|
+
}, excludes: readonly CacheHitExclusion[]): {
|
|
73
|
+
cachedTokens: number;
|
|
74
|
+
totalInputTokens: number;
|
|
75
|
+
};
|
|
76
|
+
/** Is the main loop's lane complete? (No main-loop call booked ⇒ there is nothing on it to judge: not complete.) */
|
|
77
|
+
export declare function mainCacheLaneComplete(lanes: CacheLanes | undefined): boolean;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
export function cacheMemberMarksOf(reported) {
|
|
2
|
+
if (reported === undefined)
|
|
3
|
+
return { readUnreported: true, writeUnreported: true, totalLowerBound: true };
|
|
4
|
+
const readUnreported = reported.usage.cacheRead === undefined;
|
|
5
|
+
const writeUnreported = reported.usage.cacheWrite === undefined;
|
|
6
|
+
return { readUnreported, writeUnreported, totalLowerBound: reported.family === "input-excludes-cached" && (readUnreported || writeUnreported) };
|
|
7
|
+
}
|
|
8
|
+
export function bookCacheOperands(stats, lane, reported, usageMissing, totalInputTokens) {
|
|
9
|
+
const marks = cacheMemberMarksOf(reported);
|
|
10
|
+
if (marks.readUnreported)
|
|
11
|
+
stats.cacheReadUnreported = true;
|
|
12
|
+
if (marks.writeUnreported)
|
|
13
|
+
stats.cacheWriteUnreported = true;
|
|
14
|
+
if (marks.totalLowerBound)
|
|
15
|
+
stats.usageMissing = true;
|
|
16
|
+
const lanes = (stats.cacheLanes ??= {});
|
|
17
|
+
const operands = (lanes[lane] ??= { cachedTokens: 0, totalInputTokens: 0, complete: true });
|
|
18
|
+
operands.cachedTokens += reported?.usage.cacheRead ?? 0;
|
|
19
|
+
operands.totalInputTokens += totalInputTokens;
|
|
20
|
+
if (usageMissing || marks.readUnreported || marks.totalLowerBound)
|
|
21
|
+
operands.complete = false;
|
|
22
|
+
return marks;
|
|
23
|
+
}
|
|
24
|
+
export function cacheTraceMembersOf(usage) {
|
|
25
|
+
return { ...(usage.cacheRead !== undefined ? { cacheRead: usage.cacheRead } : {}), ...(usage.cacheWrite !== undefined ? { cacheWrite: usage.cacheWrite } : {}) };
|
|
26
|
+
}
|
|
27
|
+
export function cacheHitExclusionsOf(lanes) {
|
|
28
|
+
const out = [];
|
|
29
|
+
for (const [lane, operands] of Object.entries(lanes ?? {})) {
|
|
30
|
+
if (!operands.complete)
|
|
31
|
+
out.push({ lane, cachedTokens: operands.cachedTokens, totalInputTokens: operands.totalInputTokens });
|
|
32
|
+
}
|
|
33
|
+
return out;
|
|
34
|
+
}
|
|
35
|
+
export function cacheHitOperandsOf(totals, excludes) {
|
|
36
|
+
let cachedTokens = totals.cachedTokens;
|
|
37
|
+
let totalInputTokens = totals.totalInputTokens;
|
|
38
|
+
for (const e of excludes) {
|
|
39
|
+
cachedTokens -= e.cachedTokens;
|
|
40
|
+
totalInputTokens -= e.totalInputTokens;
|
|
41
|
+
}
|
|
42
|
+
return { cachedTokens, totalInputTokens };
|
|
43
|
+
}
|
|
44
|
+
export function mainCacheLaneComplete(lanes) {
|
|
45
|
+
return lanes?.main?.complete === true;
|
|
46
|
+
}
|
|
@@ -94,8 +94,9 @@ export interface ApprovedCallScreenInput {
|
|
|
94
94
|
* The approved call's PreToolUse screening — the gate's own screening, its answer FOLDED UNDER THE DECIDE that approved
|
|
95
95
|
* the call (the decide is the upper bound; the screen can only narrow): a deny, a failed or cancelled screening, or a
|
|
96
96
|
* refused answer refuses the call in the live gate's own sentences; an ask is the question the decide already answered —
|
|
97
|
-
* unless it demands a person and
|
|
98
|
-
*
|
|
97
|
+
* unless it demands a person and no person answered a question carrying the hook's class (`answered`, the classes of the
|
|
98
|
+
* question a person answered on the row: the one reading every resume station holds an earlier answer against); context
|
|
99
|
+
* rides the result. Its three outlets are those — a refusal, an ask, the context: a rewrite is not
|
|
99
100
|
* one. The bytes that run are the bytes the decide approved (the person's edit, or the call as shown), so an `updatedInput`
|
|
100
101
|
* here is not adopted — the reference's form, where a parked answer's own input stands over the hook's. Undefined when no
|
|
101
102
|
* handler hangs on `classic.PreToolUse`.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { createPreToolUseScreening, formatHookFeedback } from "../hooks.js";
|
|
2
2
|
import { classicEventBase, dispatchClassic, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
|
|
3
|
-
import {
|
|
3
|
+
import { beltUnanswered } from "../real-approval.js";
|
|
4
4
|
import { decisionText } from "../tool-policy.js";
|
|
5
5
|
import { rosterToolName } from "../tool-roster.js";
|
|
6
6
|
import { wireOf } from "../tool-name-readings.js";
|
|
@@ -99,11 +99,12 @@ export function createToolResultStation(input) {
|
|
|
99
99
|
}
|
|
100
100
|
return undefined;
|
|
101
101
|
}
|
|
102
|
+
const HOOK_CLASSES = Object.freeze(["hook"]);
|
|
102
103
|
export function createApprovedCallScreen(input) {
|
|
103
104
|
const { modBus, permissionMode, abortController, handsCwdRef, hookEnvFace, hookIdentity, preToolContexts } = input;
|
|
104
105
|
if (!modBus.hasHandlers("classic.PreToolUse"))
|
|
105
106
|
return undefined;
|
|
106
|
-
return async ({ toolCallId, toolName, args,
|
|
107
|
+
return async ({ toolCallId, toolName, args, answered }) => {
|
|
107
108
|
const screening = createPreToolUseScreening({
|
|
108
109
|
event: { toolCallId, toolName, input: {} },
|
|
109
110
|
modBus,
|
|
@@ -124,8 +125,8 @@ export function createApprovedCallScreen(input) {
|
|
|
124
125
|
const r = screened.answer;
|
|
125
126
|
if (r?.action === "deny")
|
|
126
127
|
return { refused: screening.deniedReason(r), ...(screened.answeredBy !== undefined ? { extension: screened.answeredBy } : {}) };
|
|
127
|
-
if (r !== undefined &&
|
|
128
|
-
return { refused: `a PreToolUse hook requires a person's approval for ${subject}, and
|
|
128
|
+
if (r !== undefined && beltUnanswered(r, HOOK_CLASSES, answered))
|
|
129
|
+
return { refused: `a PreToolUse hook requires a person's approval for ${subject}, and the approval this call had was not given to a question the hook asked — not executed; send the call again to have it asked` };
|
|
129
130
|
const contexts = screened.contexts;
|
|
130
131
|
return { admit: () => {
|
|
131
132
|
if (contexts.length > 0)
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The changed-files scan: the ONE reading of "which files this session read have moved on disk since" that every request
|
|
3
|
+
* the engine owes a frame to asks — the turn boundary's bundle collection and a leg's first request (a fresh run's
|
|
4
|
+
* first message, a resumed leg's continuation). One door, one scanner, one frame ({@link collectChangedFilesAttachment}):
|
|
5
|
+
* the stations differ only in WHERE the frame rides, never in what is scanned. Whether the model was already told is asked
|
|
6
|
+
* of the request's own view (the notice's record on its message, `request-copy-projection.ts`), never of a table here.
|
|
7
|
+
*/
|
|
8
|
+
import type { TaskSpec } from "../types.js";
|
|
9
|
+
import type { Prepared } from "./contracts.js";
|
|
10
|
+
/** One path the scan found moved on disk, with the modification time it was found at. */
|
|
11
|
+
export type ChangedFile = {
|
|
12
|
+
path: string;
|
|
13
|
+
mtimeMs: number;
|
|
14
|
+
};
|
|
15
|
+
export interface ChangedFilesScanInput {
|
|
16
|
+
/** The run's `spec.attachments` — the opt-in and the `maxFiles` knob. */
|
|
17
|
+
cfg: TaskSpec["attachments"];
|
|
18
|
+
/** The leg's scanner (`Prepared.detectExternalChanges`); absent without hands. */
|
|
19
|
+
detect: Prepared["detectExternalChanges"];
|
|
20
|
+
/** The leg's frame-receipt ledger: a changed-files frame already on its way to the next request (`frameCarried`) is not scanned for again. */
|
|
21
|
+
ledger: Prepared["frameReceipts"];
|
|
22
|
+
/** A request a settlement boundary precedes — a resumed leg with calls of its suspended batch still to run — is scanned for THERE, after
|
|
23
|
+
* those calls ran, and answers true here: the request then owes no scan of its own, which would also hold the boundary's scan back as a frame
|
|
24
|
+
* already on its way. Asked only when a scan is owed. */
|
|
25
|
+
settlesFirst?: () => Promise<boolean>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* The scan this request owes, or `undefined` when it owes none: the opt-in is off, a frame is already on its way, or the leg
|
|
29
|
+
* has no scanner. The answer is synchronous so a request that owes nothing costs no await and, above all, ZERO fileInfo calls
|
|
30
|
+
* — OFF means literally nothing is stat'ed. Truthiness (not `!== undefined`): the type says `true | {maxFiles}`, but a JS
|
|
31
|
+
* caller passing `false` must read as OFF, never as opted-in. The array (possibly empty) is every file found changed and not
|
|
32
|
+
* read again — {@link collectChangedFilesAttachment} lists them all.
|
|
33
|
+
*/
|
|
34
|
+
export declare function scanChangedFiles(input: ChangedFilesScanInput): Promise<ChangedFile[]> | undefined;
|
|
35
|
+
/**
|
|
36
|
+
* The receipt step of a changed-files notice, once its message is in the session: `announce` (the notice's `steering_injected`
|
|
37
|
+
* echo and its injected count) runs only when the request tells the model something with it — the request projection's
|
|
38
|
+
* own answer ({@link lastNoticeCarried}) over the session's context with the notice's message last. A scan that finds the
|
|
39
|
+
* same file changed and unread at every boundary mints a notice each time; the view carries each (path, modification time)
|
|
40
|
+
* once, and so do the shell's display and the event store. A view that cannot be read announces (the notice was minted
|
|
41
|
+
* to be told; the display saying more than the request is the safe side).
|
|
42
|
+
*/
|
|
43
|
+
export declare function announceWhenCarried(prepared: Pick<Prepared, "session" | "harness">, announce: () => void): () => Promise<void>;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { turnContextOptions } from "../../internal/harness.js";
|
|
2
|
+
import { lastNoticeCarried } from "../request-copy-projection.js";
|
|
3
|
+
import { frameCarried } from "./compaction-restate.js";
|
|
4
|
+
import { CHANGED_FILES_MAX } from "./turn-attachments.js";
|
|
5
|
+
const SCAN_CEILING_MS = 2_000;
|
|
6
|
+
export function scanChangedFiles(input) {
|
|
7
|
+
const { cfg, detect, ledger, settlesFirst } = input;
|
|
8
|
+
if (!Boolean(cfg?.changedFiles) || frameCarried(ledger, "changed_files") || detect === undefined)
|
|
9
|
+
return undefined;
|
|
10
|
+
const maxFiles = typeof cfg?.changedFiles === "object" ? (cfg.changedFiles.maxFiles ?? CHANGED_FILES_MAX) : CHANGED_FILES_MAX;
|
|
11
|
+
return settlesFirst === undefined ? runScan(detect, maxFiles) : settlesFirst().then((later) => (later ? [] : runScan(detect, maxFiles)));
|
|
12
|
+
}
|
|
13
|
+
export function announceWhenCarried(prepared, announce) {
|
|
14
|
+
return async () => {
|
|
15
|
+
let carried = true;
|
|
16
|
+
try {
|
|
17
|
+
carried = lastNoticeCarried((await prepared.session.buildContext(turnContextOptions(prepared.harness.getModel()))).messages);
|
|
18
|
+
}
|
|
19
|
+
catch {
|
|
20
|
+
}
|
|
21
|
+
if (carried)
|
|
22
|
+
announce();
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
async function runScan(detect, maxFiles) {
|
|
26
|
+
let ceiling;
|
|
27
|
+
const scan = await Promise.race([
|
|
28
|
+
detect(maxFiles),
|
|
29
|
+
new Promise((resolve) => {
|
|
30
|
+
ceiling = setTimeout(() => resolve({ changed: [] }), SCAN_CEILING_MS);
|
|
31
|
+
}),
|
|
32
|
+
]).finally(() => clearTimeout(ceiling));
|
|
33
|
+
return scan.changed;
|
|
34
|
+
}
|