@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,5 +1,6 @@
|
|
|
1
1
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
2
2
|
import type { ToolPolicy } from "./tool-policy.js";
|
|
3
|
+
import type { AssertAllKeysHandled } from "./ask-origin.js";
|
|
3
4
|
/** The reserved tool name for AskUserQuestion — shared so the durable-resume path (runtask) can recognize it
|
|
4
5
|
* as a content-ask whose SHOWN questions must not be rewritten by an operator `updatedInput` (design/80 D-F).
|
|
5
6
|
*
|
|
@@ -33,7 +34,7 @@ export declare const isEngineQuestionFace: (face: {
|
|
|
33
34
|
* input) is wrapped in an untrusted-DATA fence so it can never be read as instructions. Abort while waiting is
|
|
34
35
|
* handled by the §9 interrupt path (the pending call is closed). Mounting (CC non-interactive `isEnabled`
|
|
35
36
|
* parity): only when a delivery face exists — a live `onQuestion`, or a durable park consumer (`checkpointStore`
|
|
36
|
-
* + `durableApproval
|
|
37
|
+
* + `durableApproval`, or `forceDurableGate` on a root leg), or an explicit `TaskSpec.interactiveTools: true` — see that knob.
|
|
37
38
|
*/
|
|
38
39
|
export interface AskQuestionOption {
|
|
39
40
|
/** The choice text the user picks. */
|
|
@@ -142,10 +143,25 @@ export interface QuestionUnavailable {
|
|
|
142
143
|
* · a THROW — delivery was attempted and failed. Never collapse a throw into `unavailable`.
|
|
143
144
|
*/
|
|
144
145
|
export type OnQuestionOutcome = QuestionAnswer | QuestionUnavailable;
|
|
145
|
-
/**
|
|
146
|
-
*
|
|
147
|
-
*
|
|
148
|
-
*
|
|
146
|
+
/** The four ways an outcome reads as neither an answer nor "nobody was reachable", the word each reading carries:
|
|
147
|
+
* · `unreadable` — a member of the value threw when it was read (a throwing getter);
|
|
148
|
+
* · `both_arms` — the `unavailable` discriminant alongside an `answers` array (structural typing permits it, and the
|
|
149
|
+
* outcome is deployment-supplied and may cross a wire);
|
|
150
|
+
* · `neither_arm` — no discriminant and no `answers` array (a failed decode must not read as "the user selected nothing");
|
|
151
|
+
* · `not_capturable` — an `answers` array that is not plain data the engine can keep (a hole, a named member, a cycle). */
|
|
152
|
+
export declare const QUESTION_OUTCOME_FAULTS: readonly ["unreadable", "both_arms", "neither_arm", "not_capturable"];
|
|
153
|
+
export type QuestionOutcomeFault = (typeof QUESTION_OUTCOME_FAULTS)[number];
|
|
154
|
+
/** The clause per fault — the disposition table over {@link QUESTION_OUTCOME_FAULTS}, quoted by the one sentence
|
|
155
|
+
* {@link QuestionOutcomeUnreadableError} says. */
|
|
156
|
+
export declare const QUESTION_OUTCOME_FAULT_TEXT: {
|
|
157
|
+
readonly unreadable: "a member of the value threw when it was read";
|
|
158
|
+
readonly both_arms: "the value claims an answer and \"unavailable\" at once";
|
|
159
|
+
readonly neither_arm: "the value claims neither an answer nor \"unavailable\"";
|
|
160
|
+
readonly not_capturable: "its answers are not plain data the engine can keep";
|
|
161
|
+
};
|
|
162
|
+
export type FaultTextCoversEveryFault = AssertAllKeysHandled<Exclude<QuestionOutcomeFault, keyof typeof QUESTION_OUTCOME_FAULT_TEXT>>;
|
|
163
|
+
/** How an {@link OnQuestionOutcome} reads. `"contradictory"` covers a value that is neither of the two arms the seam
|
|
164
|
+
* allows — it takes the channel-failure exit, never a resolution — and says which of the four ways ({@link QuestionOutcomeFault}). */
|
|
149
165
|
export type QuestionOutcomeReading =
|
|
150
166
|
/** The answer, already narrowed AND captured as an inert, density-validated clone — a caller
|
|
151
167
|
* neither re-reads the caller's value to get at it nor needs a `structuredClone` of its own. */
|
|
@@ -156,7 +172,15 @@ export type QuestionOutcomeReading =
|
|
|
156
172
|
readonly shape: "unavailable";
|
|
157
173
|
} | {
|
|
158
174
|
readonly shape: "contradictory";
|
|
175
|
+
readonly fault: QuestionOutcomeFault;
|
|
159
176
|
};
|
|
177
|
+
/** The failure a channel's unreadable outcome is — the ONE sentence for it, said by the tool, the engine's routing lane and the
|
|
178
|
+
* headless exit alike. It is a channel failure that names its cause: the model is never told that nobody is available when a
|
|
179
|
+
* human may have answered in a shape the engine cannot read. */
|
|
180
|
+
export declare class QuestionOutcomeUnreadableError extends Error {
|
|
181
|
+
readonly fault: QuestionOutcomeFault;
|
|
182
|
+
constructor(fault: QuestionOutcomeFault);
|
|
183
|
+
}
|
|
160
184
|
/**
|
|
161
185
|
* THE reader for a question outcome, and the only place its fields are touched. Total by construction:
|
|
162
186
|
* every way the value can misbehave — a throwing getter, both arms at once — lands on
|
|
@@ -185,9 +209,13 @@ export declare function isQuestionUnavailable(outcome: OnQuestionOutcome): outco
|
|
|
185
209
|
* an unanswered question is released at the deadline (it does not hang the worker).
|
|
186
210
|
*
|
|
187
211
|
* **Single-winner obligation (the deployment's half).** A face that races a deadline against a real UI
|
|
188
|
-
* owns the atomicity
|
|
189
|
-
*
|
|
190
|
-
*
|
|
212
|
+
* owns the atomicity, and the race covers only the stretch BEFORE the question reached a human: a deadline
|
|
213
|
+
* or abort that elapses while nothing has been shown ends in {@link QuestionUnavailable}, whose contract is
|
|
214
|
+
* zero interaction; once the card is shown, an elapsed deadline or an abort ends in a THROW, which is what
|
|
215
|
+
* {@link QuestionUnavailable} says of a face that showed the question and then failed. Either way the face
|
|
216
|
+
* CLOSES the open request first, so a submission arriving one tick later is refused rather than applied:
|
|
217
|
+
* the single winner is guaranteed by the close, not by the value the face hands back. A signal race alone
|
|
218
|
+
* is not enough — two independent resolutions of one question is the shape this seam exists to prevent. Key the registry
|
|
191
219
|
* on {@link AskQuestionRequest.deliveryId} (scoped by tenant) — NOT on the call id or the argument hash,
|
|
192
220
|
* neither of which is unique per delivery. The engine consumes exactly one outcome per call id
|
|
193
221
|
* and never asks the same call twice, so honoring this contract makes the whole path single-winner; core
|
|
@@ -4,9 +4,24 @@ import { boundInputHashOf, capturedJsonOf } from "./canonical-json.js";
|
|
|
4
4
|
import { defineTool, errorResult } from "./tools.js";
|
|
5
5
|
import { delimitUntrusted, inlineUntrusted } from "./untrusted-text.js";
|
|
6
6
|
import { engineMountedAs, mountRuleFace, toolFace } from "./tool-catalog-entries.js";
|
|
7
|
-
import { thrownText } from "./thrown-value.js";
|
|
7
|
+
import { thrownIs, thrownText } from "./thrown-value.js";
|
|
8
8
|
export const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
|
|
9
9
|
export const isEngineQuestionFace = engineMountedAs(["ask-user-question"]);
|
|
10
|
+
export const QUESTION_OUTCOME_FAULTS = Object.freeze(["unreadable", "both_arms", "neither_arm", "not_capturable"]);
|
|
11
|
+
export const QUESTION_OUTCOME_FAULT_TEXT = {
|
|
12
|
+
unreadable: "a member of the value threw when it was read",
|
|
13
|
+
both_arms: 'the value claims an answer and "unavailable" at once',
|
|
14
|
+
neither_arm: 'the value claims neither an answer nor "unavailable"',
|
|
15
|
+
not_capturable: "its answers are not plain data the engine can keep",
|
|
16
|
+
};
|
|
17
|
+
export class QuestionOutcomeUnreadableError extends Error {
|
|
18
|
+
fault;
|
|
19
|
+
constructor(fault) {
|
|
20
|
+
super(`the answer the question channel returned could not be read (${fault}: ${QUESTION_OUTCOME_FAULT_TEXT[fault]})`);
|
|
21
|
+
this.name = "QuestionOutcomeUnreadableError";
|
|
22
|
+
this.fault = fault;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
10
25
|
export function classifyQuestionOutcome(outcome) {
|
|
11
26
|
let unavailable;
|
|
12
27
|
let answers;
|
|
@@ -16,25 +31,25 @@ export function classifyQuestionOutcome(outcome) {
|
|
|
16
31
|
answers = o?.answers;
|
|
17
32
|
}
|
|
18
33
|
catch {
|
|
19
|
-
return { shape: "contradictory" };
|
|
34
|
+
return { shape: "contradictory", fault: "unreadable" };
|
|
20
35
|
}
|
|
21
36
|
const carriesAnswers = Array.isArray(answers);
|
|
22
37
|
if (unavailable && carriesAnswers)
|
|
23
|
-
return { shape: "contradictory" };
|
|
38
|
+
return { shape: "contradictory", fault: "both_arms" };
|
|
24
39
|
if (unavailable)
|
|
25
40
|
return { shape: "unavailable" };
|
|
26
41
|
if (!carriesAnswers)
|
|
27
|
-
return { shape: "contradictory" };
|
|
42
|
+
return { shape: "contradictory", fault: "neither_arm" };
|
|
28
43
|
const captured = capturedJsonOf(answers, "list");
|
|
29
44
|
if (!captured.ok)
|
|
30
|
-
return { shape: "contradictory" };
|
|
45
|
+
return { shape: "contradictory", fault: "not_capturable" };
|
|
31
46
|
return { shape: "answered", answer: { answers: captured.value } };
|
|
32
47
|
}
|
|
33
48
|
export function isQuestionUnavailable(outcome) {
|
|
34
49
|
return classifyQuestionOutcome(outcome).shape === "unavailable";
|
|
35
50
|
}
|
|
36
|
-
const
|
|
37
|
-
|
|
51
|
+
const PROCEED_ON_JUDGMENT = "Proceed with your best judgment: pick the most reasonable option, state the assumption you made, and continue.";
|
|
52
|
+
const NO_HUMAN = `No human is available to answer right now. ${PROCEED_ON_JUDGMENT}`;
|
|
38
53
|
export function askQuestionContinuationCard(questionId, continuationSource, reason) {
|
|
39
54
|
return {
|
|
40
55
|
type: "ask-question",
|
|
@@ -203,7 +218,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
|
|
|
203
218
|
}, ctx.signal);
|
|
204
219
|
const reading = classifyQuestionOutcome(outcome);
|
|
205
220
|
if (reading.shape === "contradictory") {
|
|
206
|
-
throw new
|
|
221
|
+
throw new QuestionOutcomeUnreadableError(reading.fault);
|
|
207
222
|
}
|
|
208
223
|
if (reading.shape === "unavailable") {
|
|
209
224
|
if (redeemsApproval) {
|
|
@@ -254,7 +269,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
|
|
|
254
269
|
}
|
|
255
270
|
discloseSyntheticContinuation(ctx.toolCallId, "callback_failed");
|
|
256
271
|
return {
|
|
257
|
-
content: `${NO_HUMAN} (no answer was obtained: ${thrownText(e)})`,
|
|
272
|
+
content: thrownIs(e, QuestionOutcomeUnreadableError) ? `${e.message}, so no answer was obtained. ${PROCEED_ON_JUDGMENT}` : `${NO_HUMAN} (no answer was obtained: ${thrownText(e)})`,
|
|
258
273
|
details: continuationCard(ctx.toolCallId, "synthetic_self_answer_instruction", "callback_failed"),
|
|
259
274
|
};
|
|
260
275
|
}
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
*
|
|
22
22
|
* Audience `"user"`: the refused work is the user's own (their run, or a delegation their run made), and
|
|
23
23
|
* the recovery — a checkpoint store with a durable approval opt-in so such asks can wait for a person, or
|
|
24
|
-
* a live approver reachable for delegated
|
|
24
|
+
* a live approver reachable for delegated agents — is a deployment posture the operator hears through
|
|
25
25
|
* the sink like every other code; the row only adds the session-stream projection so the person whose
|
|
26
26
|
* call was refused sees WHY it did not run. `sessionId` is therefore REQUIRED at the mint (the routing
|
|
27
27
|
* half of a user row). On a delegated leg it is the delegation tree's root — the session a person
|
|
@@ -70,7 +70,8 @@ export interface AskUnresolvableFacts {
|
|
|
70
70
|
* the rule, and it is total over the closed set (a cause with no row is a red build: {@link CauseRemedySeatCoversEveryCause}).
|
|
71
71
|
* The two causes that say NOBODY COULD BE ASKED take it — no approver is wired (`absent`: the clause says to wire one), or the
|
|
72
72
|
* wired approver reported nobody reachable (`unavailable`: the clause says to make a person reachable through it, never to
|
|
73
|
-
* wire what is wired
|
|
73
|
+
* wire what is wired — and the deny exit reads it as the `policy` clause when the wired approver is the deployment's approval
|
|
74
|
+
* policy, which is no person to make reachable): one fact, one sentence about the way out, whichever way nobody was there. The inherited-mandate cause
|
|
74
75
|
* takes none (`undefined`): its recovery is a park facility on this leg, which neither a permission mode nor an `onAsk` here
|
|
75
76
|
* supplies, so the remedy's arms would name a change that does not release the call. (The settlement-axis table
|
|
76
77
|
* `SETTLEMENT_NOBODY_JUDGED` keeps `approver_unavailable` false because there a park route may still take the ask; this table is
|
|
@@ -5,6 +5,7 @@ const ASK_UNRESOLVABLE_CAUSE_SET = new Set(ASK_UNRESOLVABLE_CAUSES);
|
|
|
5
5
|
export function isAskUnresolvableCause(v) {
|
|
6
6
|
return ASK_UNRESOLVABLE_CAUSE_SET.has(v);
|
|
7
7
|
}
|
|
8
|
+
const DELEGATED = "delegated agent";
|
|
8
9
|
const CAUSE_CLAUSE = {
|
|
9
10
|
approver_unavailable: "the approver reported that nobody is reachable for this ask",
|
|
10
11
|
no_approver_wired: "nobody in this run can be asked to answer it — the headless posture",
|
|
@@ -55,9 +56,9 @@ export function askUnresolvableNotice(facts) {
|
|
|
55
56
|
const park = parkLaneExisted ? "the durable approval park did not take it" : "no durable approval park is armed for this run";
|
|
56
57
|
return {
|
|
57
58
|
code: "delegation.ask_unresolvable",
|
|
58
|
-
message: `approval for "${toolName}"${delegated ?
|
|
59
|
+
message: `approval for "${toolName}"${delegated ? ` (a ${DELEGATED}'s call)` : ""} could not be resolved: ${CAUSE_CLAUSE[cause]} and ${park} — ` +
|
|
59
60
|
`the call was denied fail-closed and did not run. ${typeof remedy === "string" && remedy.length > 0 ? `To let it run: ${remedy}. ` : ""}To let such approvals wait for a person, run with a checkpoint store and a ` +
|
|
60
|
-
`durable approval opt-in (or a live approver reachable for
|
|
61
|
+
`durable approval opt-in (or a live approver reachable for ${DELEGATED}s).`,
|
|
61
62
|
detail: { sessionId, ...(delegated ? { sourceSessionId } : {}), ...(agentId !== undefined ? { agentId } : {}), toolName, toolCallId, cause, parkLaneExisted: parkLaneExisted === true, ...(typeof remedy === "string" && remedy.length > 0 ? { remedy } : {}), ...(remedyList !== undefined ? { remedies: remedyList } : {}) },
|
|
62
63
|
};
|
|
63
64
|
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where a turn-boundary attachment comes from — one word of a closed set, the producer of one `<system-reminder>` block the
|
|
3
|
+
* runner delivers to the model at a turn boundary (a todo nudge, a changed-files notice, a listing, a delta …). The set is the
|
|
4
|
+
* attachment lane's vocabulary: the lane's delivery-class table (`ATTACHMENT_DELIVERY_CLASS`, in `runner/turn-attachments.ts`)
|
|
5
|
+
* is total over it, a frame receipt names one of its words, and the transcript row of a bundle message names the words of the
|
|
6
|
+
* attachments it carries ({@link BundledAttachment}). The `steering_injected` echo's `source` reads this set by name and spells,
|
|
7
|
+
* beside it, only the words no attachment-lane producer owns — so a word added here reaches the echo with no second edit, and a
|
|
8
|
+
* word is a member of this set or one of those, never both.
|
|
9
|
+
*/
|
|
10
|
+
export declare const ATTACHMENT_SOURCES: readonly ["todo_reminder", "task_reminder", "tool_search_usage_reminder", "changed_files", "output_style", "date_change", "workflow_size_guideline_change", "budget_usd", "total_tokens_reminder", "background_tasks", "tools_delta", "mcp_unavailable", "agent_listing", "skills_listing", "mcp_instructions", "mcp_dropped_tools"];
|
|
11
|
+
export type AttachmentSource = (typeof ATTACHMENT_SOURCES)[number];
|
|
12
|
+
/** Membership test for {@link AttachmentSource}. */
|
|
13
|
+
export declare function isAttachmentSource(v: unknown): v is AttachmentSource;
|
|
14
|
+
/**
|
|
15
|
+
* One attachment of a bundle message, as its transcript row states it (`UserMessage.attachments`): the attachment's
|
|
16
|
+
* {@link AttachmentSource} and the length — in UTF-16 code units, the `.length` of the message text — of its framed block, the
|
|
17
|
+
* `<system-reminder>` block the message text holds for it (shell tags and body). The blocks sit in the text in the order of the
|
|
18
|
+
* list, one `"\n"` between neighbours and the first at offset 0, so a reader attributes any span of the text to a source by
|
|
19
|
+
* these lengths alone; whatever follows the last block (the post-tool-batch context block, when that rode the same message)
|
|
20
|
+
* belongs to none of them.
|
|
21
|
+
*/
|
|
22
|
+
export interface BundledAttachment {
|
|
23
|
+
readonly source: AttachmentSource;
|
|
24
|
+
readonly chars: number;
|
|
25
|
+
}
|
|
26
|
+
/** The string that joins two framed blocks in a bundle message's text. */
|
|
27
|
+
export declare const BUNDLE_BLOCK_SEPARATOR = "\n";
|
|
28
|
+
/**
|
|
29
|
+
* THE composition of a bundle message: the framed blocks in order → the text they make and, per block, its source and its
|
|
30
|
+
* length in that text. The text and the lengths come from this one function, so a length can never describe a text it was not
|
|
31
|
+
* measured in. A reader of the lengths ({@link readBundledAttachments}) and a writer of the text agree on the separator
|
|
32
|
+
* through {@link BUNDLE_BLOCK_SEPARATOR}.
|
|
33
|
+
*/
|
|
34
|
+
export declare function composeBundle(blocks: ReadonlyArray<{
|
|
35
|
+
readonly source: AttachmentSource;
|
|
36
|
+
readonly block: string;
|
|
37
|
+
}>): {
|
|
38
|
+
readonly text: string;
|
|
39
|
+
readonly attachments: readonly BundledAttachment[];
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* The one reading of a bundle message's `attachments` member (the mint and the session import door both call it): a non-empty
|
|
43
|
+
* list whose every entry names a member of {@link ATTACHMENT_SOURCES} and a non-negative integer length comes back as a fresh
|
|
44
|
+
* canonical copy (extra keys never enter a log); anything else — wrong type, an empty list, an unknown word, a length that is
|
|
45
|
+
* not a count, blocks that with their separators do not fit in the text (`textLength`, the length of the one text the message
|
|
46
|
+
* holds) — is `undefined`, the whole member is refused rather than half-kept. The relation it can check is the one the text
|
|
47
|
+
* leaves room for: the blocks start at offset 0 and sit one separator apart, so they take `Σ chars + (n − 1)` of the text and
|
|
48
|
+
* anything after the last block (a post-tool-batch context block) is the rest.
|
|
49
|
+
*/
|
|
50
|
+
export declare function readBundledAttachments(raw: unknown, textLength: number): readonly BundledAttachment[] | undefined;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
export const ATTACHMENT_SOURCES = Object.freeze([
|
|
2
|
+
"todo_reminder",
|
|
3
|
+
"task_reminder",
|
|
4
|
+
"tool_search_usage_reminder",
|
|
5
|
+
"changed_files",
|
|
6
|
+
"output_style",
|
|
7
|
+
"date_change",
|
|
8
|
+
"workflow_size_guideline_change",
|
|
9
|
+
"budget_usd",
|
|
10
|
+
"total_tokens_reminder",
|
|
11
|
+
"background_tasks",
|
|
12
|
+
"tools_delta",
|
|
13
|
+
"mcp_unavailable",
|
|
14
|
+
"agent_listing",
|
|
15
|
+
"skills_listing",
|
|
16
|
+
"mcp_instructions",
|
|
17
|
+
"mcp_dropped_tools",
|
|
18
|
+
]);
|
|
19
|
+
const ATTACHMENT_SOURCE_SET = new Set(ATTACHMENT_SOURCES);
|
|
20
|
+
export function isAttachmentSource(v) {
|
|
21
|
+
return ATTACHMENT_SOURCE_SET.has(v);
|
|
22
|
+
}
|
|
23
|
+
export const BUNDLE_BLOCK_SEPARATOR = "\n";
|
|
24
|
+
export function composeBundle(blocks) {
|
|
25
|
+
return {
|
|
26
|
+
text: blocks.map((b) => b.block).join(BUNDLE_BLOCK_SEPARATOR),
|
|
27
|
+
attachments: blocks.map((b) => ({ source: b.source, chars: b.block.length })),
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export function readBundledAttachments(raw, textLength) {
|
|
31
|
+
if (!Array.isArray(raw) || raw.length === 0)
|
|
32
|
+
return undefined;
|
|
33
|
+
const list = raw;
|
|
34
|
+
const out = [];
|
|
35
|
+
let spanned = (list.length - 1) * BUNDLE_BLOCK_SEPARATOR.length;
|
|
36
|
+
for (const item of list) {
|
|
37
|
+
if (item === null || typeof item !== "object")
|
|
38
|
+
return undefined;
|
|
39
|
+
const e = item;
|
|
40
|
+
if (!isAttachmentSource(e.source) || typeof e.chars !== "number" || !Number.isSafeInteger(e.chars) || e.chars < 0)
|
|
41
|
+
return undefined;
|
|
42
|
+
out.push({ source: e.source, chars: e.chars });
|
|
43
|
+
spanned += e.chars;
|
|
44
|
+
}
|
|
45
|
+
return spanned <= textLength ? out : undefined;
|
|
46
|
+
}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import { type AgentMessage, type CompactionSettings, type Session, type ThinkingLevel } from "../internal/harness.js";
|
|
2
|
-
import { type Message, type Model, type Tool } from "../internal/llm.js";
|
|
1
|
+
import { type AgentMessage, type CompactionSettings, type Session, type SessionRowExpectation, type ThinkingLevel } from "../internal/harness.js";
|
|
2
|
+
import { type Context, type Message, type Model, type Tool } from "../internal/llm.js";
|
|
3
3
|
import type { ContextWindowOverlay } from "./context-settings.js";
|
|
4
4
|
import type { PostCompactContext, PreCompactContext, PreCompactResult } from "./hooks.js";
|
|
5
5
|
import type { TraceEvent } from "./trace.js";
|
|
6
6
|
import type { Brain, ModelRef, TaskSpec } from "./types.js";
|
|
7
|
-
import type { CompactOutcome, TaskEvent, TaskEventIdentity } from "./task-event.js";
|
|
7
|
+
import type { CompactOutcome, HumanInputAttachment, TaskEvent, TaskEventIdentity } from "./task-event.js";
|
|
8
8
|
import type { CompactionEffect } from "./frame-settlement.js";
|
|
9
|
-
import type
|
|
9
|
+
import { type MintedAttachmentFrame } from "./user-attachment.js";
|
|
10
10
|
/**
|
|
11
11
|
* Default summarization focus, applied when a task does not provide `compaction.instructions`.
|
|
12
12
|
* Addresses the common fidelity failure where summaries drop specific facts.
|
|
@@ -51,6 +51,20 @@ export declare function isCompactionManualCancel(err: unknown): boolean;
|
|
|
51
51
|
* the prompt-too-long recovery) for its trace frame and its `compaction_outcome{failed}` event: the thrown value's words through the
|
|
52
52
|
* same-principal tier, THEN bounded — minted before the cut, so the cut can leave no part of a value. */
|
|
53
53
|
export declare function compactionFailureReason(err: unknown): string;
|
|
54
|
+
/** The machine causes a failed pass's `compaction_outcome{failed}` frame names (its `cause`), as a value. Root-exported.
|
|
55
|
+
* `leaf_moved`: another writer moved the session's leaf while the pass ran, so the session's own leaf compare-and-set refused
|
|
56
|
+
* the summary record and nothing landed — the pass may be asked for again, over the branch as it is now. A failure with no
|
|
57
|
+
* word here carries no `cause` (its `reason` is the whole account).
|
|
58
|
+
*
|
|
59
|
+
* @contract compaction.failure_cause.capability — this set is the one fact a host reads to learn whether the engine it loaded
|
|
60
|
+
* names a failure cause: `COMPACTION_FAILURE_CAUSES.includes(word)`, read from the loaded package the way its version is
|
|
61
|
+
* read from `CONTRACT_KIT_ENGINE_VERSION`; there is no second version word, and a word the set lacks is never on a frame. */
|
|
62
|
+
export declare const COMPACTION_FAILURE_CAUSES: readonly ["leaf_moved"];
|
|
63
|
+
/** A word of {@link COMPACTION_FAILURE_CAUSES}. */
|
|
64
|
+
export type CompactionFailureCause = (typeof COMPACTION_FAILURE_CAUSES)[number];
|
|
65
|
+
/** The ONE reading of a failed pass's machine cause, beside its {@link compactionFailureReason} and read at the same sites: the session's
|
|
66
|
+
* leaf compare-and-set refusing a write of the pass is `leaf_moved`; anything else names no cause. */
|
|
67
|
+
export declare function compactionFailureCause(err: unknown): CompactionFailureCause | undefined;
|
|
54
68
|
/**
|
|
55
69
|
* design/145 §1/§3 — the window-safety decision surfaced to the caller BEFORE the summary call
|
|
56
70
|
* (same pre-call posture as `onInputTruncated`: the disclosure must survive a later summary
|
|
@@ -106,6 +120,9 @@ export interface CompactionForkContext {
|
|
|
106
120
|
/** The model id that served the recorded request — part of the provider cache key; the fork
|
|
107
121
|
* eligibility gate refuses a snapshot from a different model (see the engine-side twin's doc). */
|
|
108
122
|
modelId?: string;
|
|
123
|
+
/** The recorded request's locale of the engine's own texts (`Context.promptLocale`): a request built from the record
|
|
124
|
+
* (the fork, the advisor) carries it on. */
|
|
125
|
+
promptLocale?: Context["promptLocale"];
|
|
109
126
|
}
|
|
110
127
|
/**
|
|
111
128
|
* What a compaction pass reports at the moment it commits ({@link MaybeCompactOptions.onStarted}) — and the
|
|
@@ -130,9 +147,57 @@ export interface CompactionRestoreAsk {
|
|
|
130
147
|
readonly perFileChars: number;
|
|
131
148
|
readonly totalChars: number;
|
|
132
149
|
readonly charsPerToken: number;
|
|
133
|
-
/** The reads the context the summary leaves still shows (canonical keys) — the restore dedups against them. */
|
|
134
|
-
readonly preserveKeys: readonly string[];
|
|
135
150
|
}
|
|
151
|
+
/** Which of the three autocompact-window fields the `??` precedence selected (see `resolveTriggerWindow`). */
|
|
152
|
+
export type TriggerWindowField = "autoCompactTokens" | "contextTokens" | "contextWindow";
|
|
153
|
+
/**
|
|
154
|
+
* A pass's report that its window is unusable: the size it DID manage to estimate, the field that decided
|
|
155
|
+
* the window, and that field's unusable value when it carried one.
|
|
156
|
+
*/
|
|
157
|
+
export interface UnevaluableWindow {
|
|
158
|
+
estTokens: number;
|
|
159
|
+
/** WHICH of the three window fields the `??` precedence actually selected. A defined-but-unusable
|
|
160
|
+
* higher-precedence field (`autoCompactTokens: 0`) shadows a healthy lower one, so "no window is
|
|
161
|
+
* declared" is the wrong story on that path — the caller reports THIS field, not all three. */
|
|
162
|
+
windowField: TriggerWindowField;
|
|
163
|
+
/** The unusable value that field carried, when it carried one at all (absent = nothing declared). */
|
|
164
|
+
windowValue?: number;
|
|
165
|
+
modelId?: string;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* How full the context is, and against what threshold. One pure measurement with three readers: the
|
|
169
|
+
* auto-compaction trigger, the `contextUsage` every `maybeCompact` return carries (the `context_usage`
|
|
170
|
+
* frame is built from it), and the per-turn read room (`runner/context-room.ts`). Same messages, model,
|
|
171
|
+
* overlay, settings and overhead ⇒ the same record. It never reads `settings.enabled`: a leg with
|
|
172
|
+
* compaction switched off still has a compaction point to measure against.
|
|
173
|
+
*/
|
|
174
|
+
export interface ContextMeasure {
|
|
175
|
+
/** `shouldCompact`'s first argument: usage-anchored when the anchor is fresh, structural + overhead otherwise. */
|
|
176
|
+
readonly tokens: number;
|
|
177
|
+
/** The AUTOCOMPACT window (may be the unknown sentinel: non-finite or ≤ 0). */
|
|
178
|
+
readonly window: number;
|
|
179
|
+
readonly windowKnown: boolean;
|
|
180
|
+
readonly windowField: TriggerWindowField;
|
|
181
|
+
/** The settings repaired for this window (`sanitizeCompactionSettings`). */
|
|
182
|
+
readonly settings: CompactionSettings;
|
|
183
|
+
/** The structural coefficient every quantity here lives in. */
|
|
184
|
+
readonly charsPerToken: number;
|
|
185
|
+
/** Present exactly when the window is known: `usedTokens > compactAtTokens` is the trigger predicate. */
|
|
186
|
+
readonly contextUsage?: {
|
|
187
|
+
usedTokens: number;
|
|
188
|
+
windowTokens: number;
|
|
189
|
+
compactAtTokens: number;
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
export declare function measureContext(input: {
|
|
193
|
+
readonly messages: AgentMessage[];
|
|
194
|
+
readonly model: Model;
|
|
195
|
+
readonly contextOverlay?: ContextWindowOverlay;
|
|
196
|
+
readonly settings: CompactionSettings;
|
|
197
|
+
readonly overheadTokens?: number;
|
|
198
|
+
}): ContextMeasure;
|
|
199
|
+
/** The unevaluable-window record of a measurement whose window is unknown (`undefined` when it is known). */
|
|
200
|
+
export declare function unevaluableWindowOf(measure: ContextMeasure, model: Model): UnevaluableWindow | undefined;
|
|
136
201
|
export interface MaybeCompactOptions {
|
|
137
202
|
/** Disclosure channel for CONTAINED host-callback failures in this scope (the RB-463
|
|
138
203
|
* isolation primitive's bounded first-failure per site). Absent ⇒ failures are counted only. */
|
|
@@ -312,11 +377,13 @@ export interface MaybeCompactOptions {
|
|
|
312
377
|
* (`CompactionDetails.modifiedFilesByRecency`), else the alphabetical `modifiedFiles` of older details.
|
|
313
378
|
*/
|
|
314
379
|
workingFileAttachments?: {
|
|
315
|
-
/** Re-read the candidates and mint their frames — the engine's one read of a file for the model,
|
|
316
|
-
*
|
|
380
|
+
/** Re-read the candidates and mint their frames — the engine's one read of a file for the model, into the context the
|
|
381
|
+
* summary leaves (each frame carries the file's contents; a request sends them by its own copy projection). Side-effect free: each frame
|
|
317
382
|
* carries the commit its delivery owes, run here once the frame is in the transcript. Wired by the Runner. */
|
|
318
383
|
restore: (ask: CompactionRestoreAsk) => Promise<ReadonlyArray<MintedAttachmentFrame>>;
|
|
319
|
-
/** A
|
|
384
|
+
/** A fault that kept a file from the transcript — the restore threw (every candidate it was asked for), or the transcript
|
|
385
|
+
* would not take a minted frame (not delivered, nothing committed) — with its cause: the operator's line. What became of
|
|
386
|
+
* each frame, refusals included, is its record on `restoreOutcomes`; this hears only the faults. */
|
|
320
387
|
undelivered?: (label: string, reason: string) => void;
|
|
321
388
|
/** Max files to restore. Default 3. */
|
|
322
389
|
maxFiles?: number;
|
|
@@ -331,13 +398,13 @@ export interface MaybeCompactOptions {
|
|
|
331
398
|
*/
|
|
332
399
|
recentlyReadFiles?: () => string[];
|
|
333
400
|
/**
|
|
334
|
-
* RB-197② (CC `compact.ts:1415-1463` `shouldExcludeFromPostCompactRestore` parity): paths
|
|
335
|
-
* re-
|
|
336
|
-
* `
|
|
337
|
-
*
|
|
338
|
-
*
|
|
339
|
-
*
|
|
340
|
-
*
|
|
401
|
+
* RB-197② (CC `compact.ts:1415-1463` `shouldExcludeFromPostCompactRestore` parity): paths a caller
|
|
402
|
+
* re-states through a DIFFERENT channel (e.g. its own instruction files) are excluded from the
|
|
403
|
+
* `recentlyReadFiles`/fallback candidate set — re-attaching them here would duplicate content that
|
|
404
|
+
* channel carries — and their read-state entries survive the clear. A plain path list, not a
|
|
405
|
+
* hardcoded filename. The Runner itself supplies none: its `restore` leaves its instruction-file lane's
|
|
406
|
+
* members out of whatever candidates it is handed (their entries retire with the summary and the lane
|
|
407
|
+
* states them again), so this seat is a library caller's.
|
|
341
408
|
*/
|
|
342
409
|
instructionSourcePaths?: ReadonlyArray<string>;
|
|
343
410
|
/**
|
|
@@ -355,18 +422,6 @@ export interface MaybeCompactOptions {
|
|
|
355
422
|
* ALREADY in the same raw coordinate, so the fallback exact-string comparison is already correct.
|
|
356
423
|
*/
|
|
357
424
|
normalizePath?: (raw: string) => Promise<string>;
|
|
358
|
-
/**
|
|
359
|
-
* A kept-tail Read tool-CALL's mere presence does not prove the
|
|
360
|
-
* file's real content is visible there: its toolRESULT may be a dedup stub ("unchanged since you
|
|
361
|
-
* last read it…") whose ORIGINAL full transmission sits in the summarized prefix THIS compaction is
|
|
362
|
-
* about to cut away — preserving read-state for such a path would leave both the kept tail and the
|
|
363
|
-
* next read pointing at content that is nowhere in context (RB-197①'s failure, reintroduced one hop
|
|
364
|
-
* removed). Optional predicate (present exactly when the caller's Read tool actually emits a
|
|
365
|
-
* recognizable stub marker) so `maybeCompact` can require at least one SUBSTANTIVE kept-tail Read
|
|
366
|
-
* result before trusting a path as genuinely visible; absent ⇒ every non-error kept-tail Read is
|
|
367
|
-
* trusted (the pre-this-fix behavior — still safe when the caller has no stub concept at all).
|
|
368
|
-
*/
|
|
369
|
-
isDedupStubResult?: (resultText: string) => boolean;
|
|
370
425
|
};
|
|
371
426
|
/**
|
|
372
427
|
* Fires ONCE per LANDED compaction (after `appendCompaction` committed the new baseline and the restore frames were
|
|
@@ -421,6 +476,10 @@ export interface MaybeCompactOptions {
|
|
|
421
476
|
};
|
|
422
477
|
land: () => Promise<void>;
|
|
423
478
|
};
|
|
479
|
+
/** The instruction files' post-compaction restatement (the runner's `compactionRestateOptions`): runs right after
|
|
480
|
+
* `gitRestate.land`, under the same belt — the landed compaction retired the entries of the instruction frames it
|
|
481
|
+
* summarized away, and the task root's own (owed on every load) must be in context for the next request. */
|
|
482
|
+
instructionsRestate?: () => Promise<void>;
|
|
424
483
|
/** The approval-posture directive's post-compaction restatement (the runner's `compactionRestateOptions`):
|
|
425
484
|
* runs right after `gitRestate.land`, under the same belt and for the same reason — the compacted
|
|
426
485
|
* context may have lost an engine frame the run still needs, and every reader of the new baseline
|
|
@@ -433,6 +492,9 @@ export interface MaybeCompactOptions {
|
|
|
433
492
|
/** The advisor tool's instructions' post-compaction restatement on a leg that mounts the tool (the runner's
|
|
434
493
|
* `compactionRestateOptions`): runs right after `postureRestate`, under the same belt, for the same reason. */
|
|
435
494
|
advisorRestate?: () => Promise<void>;
|
|
495
|
+
/** The declared reply language's post-compaction restatement (`languageRestateOption`, the runner's `compactionRestateOptions`):
|
|
496
|
+
* runs right after `advisorRestate`, under the same belt, for the same reason. */
|
|
497
|
+
languageRestate?: () => Promise<void>;
|
|
436
498
|
/**
|
|
437
499
|
* Fixed per-request prompt overhead (system prompt + tool schemas, in tokens), applied ONLY in the
|
|
438
500
|
* anchor-less regime (design/64 §26.7, search [91] fourth candidate): when no assistant in the
|
|
@@ -440,8 +502,22 @@ export interface MaybeCompactOptions {
|
|
|
440
502
|
* chars/4 fallback counts MESSAGES only and is blind to this overhead — the threshold would compare
|
|
441
503
|
* apples to oranges and under-trigger. When usage-anchored, the anchor IS the provider-billed input
|
|
442
504
|
* (system+tools included), so the overhead is already in and this is not added.
|
|
505
|
+
* In every regime it is also the prefix size the pass judges before anything else: a prefix at or past the
|
|
506
|
+
* line makes a non-`force` pass return `windowBelowOverhead` without compacting. Absent ⇒ 0 (never judged so).
|
|
443
507
|
*/
|
|
444
508
|
overheadTokens?: number;
|
|
509
|
+
/**
|
|
510
|
+
* The engine frames every landing states again (the runner's `compactionRestateOptions`): the texts a landing writes again
|
|
511
|
+
* (`protectedTexts` — the permission posture's text; `restatedTexts` — the git frame), with the task root's instruction
|
|
512
|
+
* frames the context holds, counted whole (`restatedFramesTokens`).
|
|
513
|
+
* The "window below overhead" judgment reads them as a floor beside {@link overheadTokens}: a landing posts them again, so
|
|
514
|
+
* a prefix plus these frames at or past the line cannot be compacted under it. `overheadTokens` keeps its meaning — the
|
|
515
|
+
* anchor-less trigger estimate never adds this floor (the frames are messages the estimate already counts). Absent ⇒ no floor.
|
|
516
|
+
*/
|
|
517
|
+
restatedFrames?: {
|
|
518
|
+
readonly protectedTexts: readonly string[];
|
|
519
|
+
readonly restatedTexts: readonly string[];
|
|
520
|
+
};
|
|
445
521
|
/**
|
|
446
522
|
* design/84 Seam C — compact-boundary COST optimization (data-gated). Fidelity is already achieved by
|
|
447
523
|
* the iterative-merge UPDATE_SUMMARY path (compaction.ts); the only remaining cost is one LLM call per
|
|
@@ -557,6 +633,29 @@ export interface MaybeCompactOptions {
|
|
|
557
633
|
*/
|
|
558
634
|
activeTools?: ReadonlyArray<string>;
|
|
559
635
|
}
|
|
636
|
+
/**
|
|
637
|
+
* The fixed request prefix (system prompt + tool schemas), with the engine frames every landing states again, is at or
|
|
638
|
+
* past the compaction line, so no summary can bring a request back under it: compaction shrinks conversation history and
|
|
639
|
+
* nothing else, and every landing would post over the line again. The numbers the judgment read, in the trigger's own
|
|
640
|
+
* coordinate (`compactAtTokens = windowTokens - reserveTokens`); `restatedTokens` (present when non-zero) is the frames'
|
|
641
|
+
* share of the floor.
|
|
642
|
+
*/
|
|
643
|
+
export interface WindowBelowOverhead {
|
|
644
|
+
overheadTokens: number;
|
|
645
|
+
restatedTokens?: number;
|
|
646
|
+
compactAtTokens: number;
|
|
647
|
+
windowTokens: number;
|
|
648
|
+
reserveTokens: number;
|
|
649
|
+
}
|
|
650
|
+
/**
|
|
651
|
+
* The one judgment of "even a full compaction cannot get below the line": the window is known and the floor — the fixed
|
|
652
|
+
* overhead plus the frames every landing states again — meets or exceeds `window - reserve`. Undefined when the window is
|
|
653
|
+
* unknown (that state has its own report, `unevaluableWindow`) or when history still has room to shrink into.
|
|
654
|
+
*/
|
|
655
|
+
export declare function windowBelowOverheadOf(overheadTokens: number, windowTokens: number, reserveTokens: number, restatedTokens?: number): WindowBelowOverhead | undefined;
|
|
656
|
+
/** The `compaction_outcome{outcome:"disabled"}` reason for {@link WindowBelowOverhead}: the word, then both numbers
|
|
657
|
+
* and the smallest window that would let compaction work with this floor and reserve. */
|
|
658
|
+
export declare function windowBelowOverheadReason(w: WindowBelowOverhead): string;
|
|
560
659
|
/**
|
|
561
660
|
* Compact the session in place when context usage exceeds the threshold.
|
|
562
661
|
*
|
|
@@ -618,6 +717,9 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
|
|
|
618
717
|
chars: number;
|
|
619
718
|
truncated: boolean;
|
|
620
719
|
}>;
|
|
720
|
+
/** What became of each restore frame, frame order — its attachment record (`human_input.attachments`' own projection); a
|
|
721
|
+
* frame the transcript did not take is `not_attached`. Set only when `compacted` is true and the restore minted a frame. */
|
|
722
|
+
restoreOutcomes?: HumanInputAttachment[];
|
|
621
723
|
/** design/123 D4: true when the NATURAL gate fired (est ≥ max(threshold, minTokens) — no force was
|
|
622
724
|
* needed); false on a forced landing (`force`/`forceUnderThreshold`). Set only when `compacted`. */
|
|
623
725
|
naturalTrigger?: boolean;
|
|
@@ -650,6 +752,12 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
|
|
|
650
752
|
estTokens: number;
|
|
651
753
|
floor: number;
|
|
652
754
|
};
|
|
755
|
+
/** Set (with `compacted:false`, no summary call made) when a pass that was not `force` met a fixed prefix at or past
|
|
756
|
+
* its line ({@link windowBelowOverheadOf}): the pass is not attempted, at this boundary or any later one, while the
|
|
757
|
+
* prefix stays that large. `force` passes (manual, the prompt-too-long recovery, the in-turn guard compaction)
|
|
758
|
+
* are not judged here — they answer an overflow, not the line. The caller bridges this to one
|
|
759
|
+
* `compaction_outcome{outcome:"disabled"}` per task. */
|
|
760
|
+
windowBelowOverhead?: WindowBelowOverhead;
|
|
653
761
|
/**
|
|
654
762
|
* Set (with `compacted:false`) when the trigger predicate could not be EVALUATED at all: the model
|
|
655
763
|
* declares no usable autocompact window (non-finite or <= 0), so `shouldCompact` refuses on the
|
|
@@ -666,16 +774,7 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
|
|
|
666
774
|
* usage anchor is available), so the disclosure can say how big the context already is even though
|
|
667
775
|
* it cannot say how big the window is.
|
|
668
776
|
*/
|
|
669
|
-
unevaluableWindow?:
|
|
670
|
-
estTokens: number;
|
|
671
|
-
/** WHICH of the three window fields the `??` precedence actually selected. A defined-but-unusable
|
|
672
|
-
* higher-precedence field (`autoCompactTokens: 0`) shadows a healthy lower one, so "no window is
|
|
673
|
-
* declared" is the wrong story on that path — the caller reports THIS field, not all three. */
|
|
674
|
-
windowField: "autoCompactTokens" | "contextTokens" | "contextWindow";
|
|
675
|
-
/** The unusable value that field carried, when it carried one at all (absent = nothing declared). */
|
|
676
|
-
windowValue?: number;
|
|
677
|
-
modelId?: string;
|
|
678
|
-
};
|
|
777
|
+
unevaluableWindow?: UnevaluableWindow;
|
|
679
778
|
/**
|
|
680
779
|
* The trigger inputs THIS pass used, reported on
|
|
681
780
|
* EVERY return path — including the ordinary "nothing to do" one. A consumer rendering "how full is the
|
|
@@ -707,8 +806,8 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
|
|
|
707
806
|
* ordinary truncation (disclosed, not silent). */
|
|
708
807
|
clampReason?: "budget" | "tolerance";
|
|
709
808
|
}>;
|
|
710
|
-
/** What a landed compaction hands the wire frame. Structural, so
|
|
711
|
-
*
|
|
809
|
+
/** What a landed compaction hands the wire frame. Structural, so the full `maybeCompact` result satisfies it; the settle
|
|
810
|
+
* lane's `EndOfTaskCompaction` is this type itself (plus `compacted`). */
|
|
712
811
|
export interface CompactedFrameSource {
|
|
713
812
|
/** The pass this landing concludes (see {@link MaybeCompactOptions.onStarted}). */
|
|
714
813
|
pass?: string;
|
|
@@ -724,6 +823,7 @@ export interface CompactedFrameSource {
|
|
|
724
823
|
chars: number;
|
|
725
824
|
truncated: boolean;
|
|
726
825
|
}>;
|
|
826
|
+
restoreOutcomes?: HumanInputAttachment[];
|
|
727
827
|
modelFallback?: true;
|
|
728
828
|
fallbackReason?: "window";
|
|
729
829
|
clampedRatio?: number;
|
|
@@ -765,9 +865,20 @@ export interface CompactSessionRequest {
|
|
|
765
865
|
compactionModel?: ModelRef;
|
|
766
866
|
/** Per-model credentials (`TaskSpec.getApiKeyAndHeaders`). */
|
|
767
867
|
getApiKeyAndHeaders?: TaskSpec["getApiKeyAndHeaders"];
|
|
868
|
+
/** The checkpoint store the session's runs park in, when a run named its own (`TaskSpec.checkpointStore`): the same three-valued
|
|
869
|
+
* seat, read by the same one resolver — a store wins, absent falls through to the deployment's `RunnerDeps.checkpointStore`, and
|
|
870
|
+
* `"disabled"` says the session has no store (no durable park to ask about). The pass's park check asks the store this names. */
|
|
871
|
+
checkpointStore?: TaskSpec["checkpointStore"];
|
|
768
872
|
/** Withdraws the pass: aborted before the session's lock is taken, the answer is `"mooted"` with nothing done; while the pass
|
|
769
873
|
* runs the summary call and the credential wait read it (store reads and appends, and the pre-flight's own 5 s timer, do not); a pass that already persisted is not undone. */
|
|
770
874
|
signal?: AbortSignal;
|
|
875
|
+
/** The occupant the caller read the session as: `{ row: { owner, incarnation } }` (a `SessionHead` serves as `row`). The
|
|
876
|
+
* session the store holds under `sessionId` must still be that row — the same owner and occupant cell, judged by
|
|
877
|
+
* `sessionRowMatches` on the acquired session — or nothing is compacted and the answer is `resume.session_not_found`
|
|
878
|
+
* (it is not the session the caller meant: deleted and created again under the id, or another owner's). Only the row:
|
|
879
|
+
* `row: null` and `log` are refused at the request door (`compact.invalid_request`) — the session exists, and the pass
|
|
880
|
+
* binds its own leaf. Absent ⇒ any session under the id. */
|
|
881
|
+
expect?: SessionRowExpectation;
|
|
771
882
|
}
|
|
772
883
|
/** `Runner.compactSession`'s answer. */
|
|
773
884
|
export interface CompactSessionResult {
|