@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,10 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The durable-suspend checkpoint ROW-IDENTITY vocabulary — the default isolation scope, the ONE derivation of a row's
|
|
3
|
-
* scope, and the ONE reading of the placement fields' empty string — moved whole out of the orchestrator so the
|
|
4
|
-
* park-lane phases (the suspend stamp), the driver (the leg's scope, derived once and handed to every mint lane; the
|
|
5
|
-
* restore fold) and runtask (the resume rung) reach DOWN for the same names. Pure: a constant, two string functions, the
|
|
6
|
-
* composition-leg record's reading (with its entry's closed set) and comparison, and the row id's restore.
|
|
7
|
-
*/
|
|
8
1
|
import type { CompositionLeg, RunInternals } from "./contracts.js";
|
|
9
2
|
/** The multi-tenant scope used when a durable suspend fires for an IRREVERSIBLE tool in an
|
|
10
3
|
* unattended deployment that did NOT opt into `durableApproval` (so there is no caller-supplied scope). The
|
|
@@ -27,21 +20,52 @@ export declare const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
|
|
|
27
20
|
* realistic source — is the absence of an isolation key wearing its clothes. Kept as a literal `""` it would be
|
|
28
21
|
* one bucket for every tenant that hit it: `listByScope("")` reads all their pending approvals (with each
|
|
29
22
|
* summary's `toolInput` preview) and `reap("")` / `resolve(token, "")` act across all of them.
|
|
23
|
+
*
|
|
24
|
+
* The last identity rung is the task's ISOLATION SCOPE ({@link isolationScopeOf}: its `isolationScope`, else its principal): a parked
|
|
25
|
+
* row is working state of one scope of a person's work, so two scopes of one person never share a bucket. A task that sets an
|
|
26
|
+
* isolation scope may only declare a `durableApproval.scope` equal to it (the config door), so the rung above it cannot split them.
|
|
27
|
+
* A `durableApproval` that is there names its scope ({@link declaredCheckpointScope}: the task door refuses one that does not), so the
|
|
28
|
+
* second rung is a value a task declared, never an omission this ladder fills in.
|
|
30
29
|
*/
|
|
31
30
|
export declare function checkpointScopeOf(spec: {
|
|
32
31
|
durableApproval?: {
|
|
33
32
|
scope?: string;
|
|
34
33
|
};
|
|
35
34
|
principal?: string;
|
|
35
|
+
isolationScope?: string;
|
|
36
36
|
}, seat?: string): string;
|
|
37
|
+
/** What an opt-in names: its scope, or why it names none — a clause for a refusal sentence. */
|
|
38
|
+
export type DeclaredScopeReading = {
|
|
39
|
+
readonly kind: "scope";
|
|
40
|
+
readonly scope: string;
|
|
41
|
+
} | {
|
|
42
|
+
readonly kind: "none";
|
|
43
|
+
readonly fault: string;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
* The ONE reading of "this opt-in names its scope": a `durableApproval` — the task's own, or the record a parked row keeps of it — names
|
|
47
|
+
* the scope its approvals are filed under as the plain-data record's own `scope` member, a string that is a NAME: the engine's one name
|
|
48
|
+
* rule (`principalNameOf`, the rule `TaskSpec.isolationScope` is judged by), so the key every durable approval is filed under is one a
|
|
49
|
+
* principal could have — visible content, no control, separator or format character — and `isolationScopeOf`'s fall-through never
|
|
50
|
+
* reads it as another quantity. The opt-in is read as data ({@link DECLARED_SCOPE_DATA}): nothing of the host's runs in the look.
|
|
51
|
+
* Answers the scope, or why there is none (not an object, not plain data, no such member, a non-string, not a name). The task door
|
|
52
|
+
* (`assertDurableApprovalDeclaresScope`) refuses an opt-in this reads no scope in, and the revival of a delegated child from its row
|
|
53
|
+
* (`subagent.ts`) re-derives the opt-in only from a record this reads a scope in, through {@link declaredCheckpointScope} — so the two
|
|
54
|
+
* read "an opt-in without a scope" the same way: it is not one. A row filed by a host before the door judged the name (or one a store
|
|
55
|
+
* hands back as something other than data) reads, on revival, as no opt-in (the conservative side: a second plain ask headless-denies
|
|
56
|
+
* instead of parking again).
|
|
57
|
+
*/
|
|
58
|
+
export declare function readDeclaredCheckpointScope(declared: unknown): DeclaredScopeReading;
|
|
59
|
+
/** The scope an opt-in names ({@link readDeclaredCheckpointScope}), or `undefined` when it names none. */
|
|
60
|
+
export declare function declaredCheckpointScope(declared: unknown): string | undefined;
|
|
37
61
|
/**
|
|
38
62
|
* The ONE spelling of the placement fields' empty-string discipline: `""` is absence
|
|
39
63
|
* wearing clothes (the resume entry's principal-rung posture), and every placement read that must
|
|
40
64
|
* treat it so — the resume rung's two sides (runtask), the restore fold's seed and the suspend
|
|
41
65
|
* stamp — goes through THIS helper, so three sites cannot drift into three readings. Deliberately
|
|
42
66
|
* NOT applied to the live `internals.placementRoot`/`rootSessionId` reads of the RESOLUTION fold:
|
|
43
|
-
* an empty supplied claim there is an assembly error the
|
|
44
|
-
*
|
|
67
|
+
* an empty supplied claim there is an assembly error `readRootOccupant` refuses the run for, on every path, and normalizing it
|
|
68
|
+
* away would silently repair what should be loud.
|
|
45
69
|
*/
|
|
46
70
|
export declare function placementValueOrAbsent(value: string | undefined): string | undefined;
|
|
47
71
|
/**
|
|
@@ -1,6 +1,32 @@
|
|
|
1
|
+
import { types } from "node:util";
|
|
2
|
+
import { isolationScopeOf } from "../isolation-scope.js";
|
|
3
|
+
import { describeFault, isPlainRecord, receive } from "../mods/kernel/receive.js";
|
|
4
|
+
import { principalNameFault, principalNameOf } from "../principal-name.js";
|
|
1
5
|
export const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
|
|
2
6
|
export function checkpointScopeOf(spec, seat) {
|
|
3
|
-
return seat || spec.durableApproval?.scope || spec
|
|
7
|
+
return seat || spec.durableApproval?.scope || isolationScopeOf(spec) || DEFAULT_IRREVERSIBLE_SCOPE;
|
|
8
|
+
}
|
|
9
|
+
const DECLARED_SCOPE_DATA = Object.freeze({ accessors: "refuse", depth: 1, others: "refuse", isProxy: (v) => types.isProxy(v) });
|
|
10
|
+
export function readDeclaredCheckpointScope(declared) {
|
|
11
|
+
if (typeof declared !== "object" || declared === null)
|
|
12
|
+
return { kind: "none", fault: declared === null ? "null, not an object" : `a ${typeof declared}, not an object` };
|
|
13
|
+
const data = receive(declared, DECLARED_SCOPE_DATA);
|
|
14
|
+
if (!data.ok)
|
|
15
|
+
return { kind: "none", fault: `not plain data — ${describeFault(data.fault)}` };
|
|
16
|
+
const record = data.value;
|
|
17
|
+
if (!isPlainRecord(record))
|
|
18
|
+
return { kind: "none", fault: "a list, not a record" };
|
|
19
|
+
if (!Object.hasOwn(record, "scope"))
|
|
20
|
+
return { kind: "none", fault: "no `scope` member" };
|
|
21
|
+
const scope = record.scope;
|
|
22
|
+
if (typeof scope !== "string")
|
|
23
|
+
return { kind: "none", fault: `a \`scope\` that is ${scope === null ? "null" : typeof scope}` };
|
|
24
|
+
const name = principalNameOf(scope);
|
|
25
|
+
return name !== undefined ? { kind: "scope", scope: name } : { kind: "none", fault: `a \`scope\` that is ${principalNameFault(scope)}` };
|
|
26
|
+
}
|
|
27
|
+
export function declaredCheckpointScope(declared) {
|
|
28
|
+
const reading = readDeclaredCheckpointScope(declared);
|
|
29
|
+
return reading.kind === "scope" ? reading.scope : undefined;
|
|
4
30
|
}
|
|
5
31
|
export function placementValueOrAbsent(value) {
|
|
6
32
|
return value || undefined;
|
|
@@ -140,8 +140,8 @@ export declare function announceClassifierRoleDefaulted(args: {
|
|
|
140
140
|
* The `classifier.unavailable` notice — a classification that could not RULE (the classifier leg failed, its per-level
|
|
141
141
|
* budget ran out, or it replied with no verdict — `parse_error`; the code name predates that third cause) and where the
|
|
142
142
|
* call went, read off the station's ONE route word (`ApprovalRoute`): `live_approver` = on to the live approver now,
|
|
143
|
-
* `
|
|
144
|
-
* then commits) —
|
|
143
|
+
* `policy_seat` = on to the deployment's approval policy now, `durable_park` = on to the durable park (the notice is minted
|
|
144
|
+
* at the fork: it states the route, never whether the park then commits) — all three are `disposition: "asked"` (the handed-on ask carries
|
|
145
145
|
* `requiresRealApproval` and `classifierNoRuling`, so no automatic lane answers it), `none` = `"denied"`, refused — no
|
|
146
146
|
* approver and no park facility (a reply with no verdict is then also counted on the denial limit). The sentence names the
|
|
147
147
|
* route; the detail carries its projection (`disposition`), and the route itself is the run's published seat word
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { sameRouteIdentity } from "../../brain/route-adjudicator.js";
|
|
2
2
|
import { lowestReasoningSeat } from "../../brain/reasoning-request.js";
|
|
3
|
+
import { offSpelling } from "../../brain/reasoning.js";
|
|
3
4
|
import { AUTO_MODE_CLASSIFIER_CONTRACT_BROKEN_AFTER, AUTO_MODE_CLASSIFIER_LOW_REASONING_BUDGET_TOKENS, AUTO_MODE_CLASSIFIER_MAX_TOKENS, AUTO_MODE_CLASSIFIER_THINK_BUDGET_TOKENS } from "../auto-mode-defaults.js";
|
|
4
5
|
import { AUTO_MODE_RUNG_RATE_LIMITED_CODE, autoModeClassifierFallbackOf, parseAutoModeResponse } from "../auto-mode.js";
|
|
5
6
|
import { classifierUnavailableDispositionOf } from "../classifier-unavailable-arm.js";
|
|
@@ -85,20 +86,26 @@ function tierBelowMain(deps, main) {
|
|
|
85
86
|
}
|
|
86
87
|
return { model: main, defaulted: "main_only" };
|
|
87
88
|
}
|
|
89
|
+
const OFF_SPELLING_REMEDY = Object.freeze({
|
|
90
|
+
"compat.thinkingFormat": "Name a `classifier` role, or declare the model's thinking format (`compat.thinkingFormat`) so the seat can spell off.",
|
|
91
|
+
"thinkingLevelMap.off": "Name a `classifier` role, or declare the value this endpoint takes for off (`thinkingLevelMap.off`) so the seat can spell off.",
|
|
92
|
+
none: "No declaration on this model spells off; name a `classifier` role whose model's thinking can be turned off.",
|
|
93
|
+
});
|
|
88
94
|
export function announceClassifierRoleDefaulted(args) {
|
|
89
95
|
const { seat } = args;
|
|
90
96
|
if (seat.defaulted === undefined)
|
|
91
97
|
return;
|
|
92
|
-
const
|
|
98
|
+
const off = offSpelling(seat.model);
|
|
93
99
|
deliverEngineNotice(args.onNotice, {
|
|
94
100
|
code: "classifier.role_defaulted",
|
|
95
101
|
message: `no classifier role names a model — "${seat.model.id}" classifies this run (${seat.defaulted}); ` +
|
|
96
|
-
(
|
|
97
|
-
|
|
102
|
+
(off.spelled
|
|
103
|
+
? "its wire can turn thinking off for the verdict. Name a `classifier` role to classify on another model."
|
|
104
|
+
: `its wire cannot turn thinking off, so each classification carries a thinking allowance. ${OFF_SPELLING_REMEDY[off.missing]}`),
|
|
98
105
|
detail: {
|
|
99
106
|
model: seat.model.id,
|
|
100
107
|
reason: seat.defaulted,
|
|
101
|
-
thinkingOffSpelled: spelled,
|
|
108
|
+
thinkingOffSpelled: off.spelled,
|
|
102
109
|
...(args.sessionId !== undefined ? { sessionId: args.sessionId } : {}),
|
|
103
110
|
...(args.runId !== undefined ? { runId: args.runId } : {}),
|
|
104
111
|
},
|
|
@@ -115,11 +122,13 @@ export function classifierUnavailableNotice(args) {
|
|
|
115
122
|
const seatOwner = args.station === "ancestor" ? "that layer's" : "this run's";
|
|
116
123
|
const next = args.route === "live_approver"
|
|
117
124
|
? `so the call was handed on to ${seatOwner} live approver rather than refused by the classifier.`
|
|
118
|
-
: args.route === "
|
|
119
|
-
? `so the call was handed on to ${seatOwner}
|
|
120
|
-
:
|
|
121
|
-
|
|
122
|
-
(args.
|
|
125
|
+
: args.route === "policy_seat"
|
|
126
|
+
? `so the call was handed on to ${seatOwner} approval policy rather than refused by the classifier.`
|
|
127
|
+
: args.route === "durable_park"
|
|
128
|
+
? `so the call was handed on to ${seatOwner} durable approval park, for a person to answer later, rather than refused by the classifier.`
|
|
129
|
+
: (args.station === "ancestor" ? "and that layer has no live approver" : "and this run has no approver and no park facility") +
|
|
130
|
+
", so the call was refused and did not run." +
|
|
131
|
+
(args.cause === "timeout" ? " A deployment on a slow gateway raises the budget." : "");
|
|
123
132
|
return {
|
|
124
133
|
code: "classifier.unavailable",
|
|
125
134
|
message: `auto mode could not judge "${args.toolName}": ${why}, ${next}`,
|
|
@@ -14,9 +14,10 @@
|
|
|
14
14
|
* wears a family prefix.
|
|
15
15
|
*/
|
|
16
16
|
import { type AgentHarness } from "../../internal/harness.js";
|
|
17
|
+
import { type WindowBelowOverhead } from "../auto-compaction.js";
|
|
17
18
|
import type { PlatformLimitReason } from "../checkpoint-store.js";
|
|
18
19
|
import type { TaskSpec } from "../types.js";
|
|
19
|
-
import type { Prepared } from "./contracts.js";
|
|
20
|
+
import type { Prepared, RunState } from "./contracts.js";
|
|
20
21
|
/**
|
|
21
22
|
* The LIMIT-APPROACH frames, the successor to the retired deadline-nudge family. Two facts
|
|
22
23
|
* make them a different mechanism, not a rename:
|
|
@@ -28,10 +29,12 @@ import type { Prepared } from "./contracts.js";
|
|
|
28
29
|
* `limit_approach_converge` / `limit_approach_deliver`.
|
|
29
30
|
*/
|
|
30
31
|
export declare const LIMIT_APPROACH_DEFAULT_THRESHOLDS: readonly [number, number];
|
|
32
|
+
/** The shortest declared turn cap the turn axis takes part in: below it the run is over before converging means anything. */
|
|
33
|
+
export declare const LIMIT_APPROACH_MIN_TURNS = 4;
|
|
31
34
|
/** The output-token figure the pre-call worst-case assumes when the model declares no cap of its own.
|
|
32
35
|
* Shared by the $ and token arms so the two gates cannot disagree about the same hypothetical call. */
|
|
33
36
|
export declare const DEFAULT_PRECALL_OUTPUT_TOKENS = 4096;
|
|
34
|
-
/** The two
|
|
37
|
+
/** The two sentence bodies, indexed by the threshold crossed (0 → converge, 1 → deliver now). */
|
|
35
38
|
export declare function limitApproachFrames(index: 0 | 1, axis: string, percent: number, mark: string | undefined): string;
|
|
36
39
|
/**
|
|
37
40
|
* Resolve the effective turn cap. `undefined` = no turn cap; `0` (explicit) = unbounded.
|
|
@@ -44,6 +47,10 @@ export declare function limitApproachFrames(index: 0 | 1, axis: string, percent:
|
|
|
44
47
|
export declare function resolveMaxTurns(limits?: {
|
|
45
48
|
maxTurns?: number;
|
|
46
49
|
}): number | undefined;
|
|
50
|
+
/** Is a TASK axis crossed — the turn cap or a token / cost ceiling (flagged at turn end), or the walltime window passed on the
|
|
51
|
+
* monotonic clock? The one reading the boundary's resource-slice park and the stop gate's "is the run ending" share: past a
|
|
52
|
+
* crossed axis a run parks only while it owes a request, and no hook or verification may manufacture another one. */
|
|
53
|
+
export declare function taskAxisCrossed(limits: Pick<RunState["limits"], "turnsExceeded" | "budgetHit">, walltimeMonotonicDeadline: number | undefined): boolean;
|
|
47
54
|
/**
|
|
48
55
|
* How long past the environment's suspend deadline the turn-boundary lane will keep waiting for the
|
|
49
56
|
* usage ledger's READ.
|
|
@@ -92,9 +99,9 @@ export declare function raceUntilDeadline<T>(p: Promise<T>, deadline: number): P
|
|
|
92
99
|
* Carried on `rs.limits.platformTerminal` and adopted as the run's `threw`, so the caller reads the cause
|
|
93
100
|
* on `TaskResult.errorCode` (`errorCodeOf` lifts `.code`) instead of the anonymous error an abort produces.
|
|
94
101
|
* `retryAfterMs` rides the error object because a wait hint has no `TaskResult` seat — a host reads it from
|
|
95
|
-
* the `RunnerDeps.onError` sink this is also delivered to.
|
|
102
|
+
* the `RunnerDeps.onError` sink this is also delivered to. A yield (`preempt`) has none: its fallback is to keep running.
|
|
96
103
|
*/
|
|
97
|
-
export declare function platformLimitTerminal(reason: PlatformLimitReason, retryAfterMs: number | undefined, moment?: "entry" | "turn_boundary" | "resume"): Error & {
|
|
104
|
+
export declare function platformLimitTerminal(reason: Exclude<PlatformLimitReason, "preempt">, retryAfterMs: number | undefined, moment?: "entry" | "turn_boundary" | "resume"): Error & {
|
|
98
105
|
code: string;
|
|
99
106
|
retryAfterMs?: number;
|
|
100
107
|
};
|
|
@@ -107,6 +114,10 @@ export declare function discloseUnevaluableWindow(u: {
|
|
|
107
114
|
phase: "config";
|
|
108
115
|
sessionId: string;
|
|
109
116
|
}) => void) | undefined): void;
|
|
117
|
+
export declare function discloseWindowBelowOverhead(w: WindowBelowOverhead, prepared: Prepared, onError: ((err: unknown, context: {
|
|
118
|
+
phase: "config";
|
|
119
|
+
sessionId: string;
|
|
120
|
+
}) => void) | undefined, emit: (reason: string) => void): void;
|
|
110
121
|
/** 1.296 件2a — report the hard-abort timer's lateness on `task.end` only above this bar: sub-5s
|
|
111
122
|
* jitter is ordinary scheduling noise (GC pauses, sync work) and would only add trace lint. */
|
|
112
123
|
export declare const TIMER_LATENESS_REPORT_MS = 5000;
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import {} from "../../internal/harness.js";
|
|
2
|
+
import { windowBelowOverheadReason } from "../auto-compaction.js";
|
|
2
3
|
import { openSystemReminder } from "../reminder-mint.js";
|
|
3
4
|
import { emitTrace } from "../trace.js";
|
|
4
5
|
export const LIMIT_APPROACH_DEFAULT_THRESHOLDS = [0.8, 0.95];
|
|
6
|
+
export const LIMIT_APPROACH_MIN_TURNS = 4;
|
|
5
7
|
export const DEFAULT_PRECALL_OUTPUT_TOKENS = 4096;
|
|
6
8
|
export function limitApproachFrames(index, axis, percent, mark) {
|
|
7
9
|
return index === 0
|
|
@@ -15,6 +17,9 @@ export function limitApproachFrames(index, axis, percent, mark) {
|
|
|
15
17
|
export function resolveMaxTurns(limits) {
|
|
16
18
|
return limits?.maxTurns;
|
|
17
19
|
}
|
|
20
|
+
export function taskAxisCrossed(limits, walltimeMonotonicDeadline) {
|
|
21
|
+
return limits.turnsExceeded || limits.budgetHit !== undefined || (walltimeMonotonicDeadline !== undefined && performance.now() >= walltimeMonotonicDeadline);
|
|
22
|
+
}
|
|
18
23
|
export const ENV_DUE_GOVERNANCE_READ_BUDGET_MS = 5_000;
|
|
19
24
|
const MAX_TIMER_DELAY_MS = 2_147_483_647;
|
|
20
25
|
const DEADLINE_TICK = Symbol("deadline-tick");
|
|
@@ -78,7 +83,20 @@ export function discloseUnevaluableWindow(u, prepared, tracer, taskId, onError)
|
|
|
78
83
|
: `it declares no context window at all (\`autoCompactTokens\` / \`contextTokens\` / \`contextWindow\` are all absent) — declare one to restore the threshold`;
|
|
79
84
|
try {
|
|
80
85
|
onError?.(new Error(`auto-compaction cannot run for model${modelClause}: ${cause}. Until then there is no threshold to compare against, so the ` +
|
|
81
|
-
`context will grow until the provider refuses the request. The conversation is already about ${u.estTokens} estimated tokens.`), { phase: "config", sessionId: prepared.sessionId });
|
|
86
|
+
`context will grow until the provider refuses the request, and Read's \`allow_large\` cannot raise a read either. The conversation is already about ${u.estTokens} estimated tokens.`), { phase: "config", sessionId: prepared.sessionId });
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
const disclosedWindowBelowOverhead = new WeakSet();
|
|
92
|
+
export function discloseWindowBelowOverhead(w, prepared, onError, emit) {
|
|
93
|
+
if (disclosedWindowBelowOverhead.has(prepared))
|
|
94
|
+
return;
|
|
95
|
+
disclosedWindowBelowOverhead.add(prepared);
|
|
96
|
+
const reason = windowBelowOverheadReason(w);
|
|
97
|
+
emit(reason);
|
|
98
|
+
try {
|
|
99
|
+
onError?.(new Error(`compaction cannot help — ${reason}`), { phase: "config", sessionId: prepared.sessionId });
|
|
82
100
|
}
|
|
83
101
|
catch {
|
|
84
102
|
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import { convertToLlm, uuidv7 } from "../../internal/harness.js";
|
|
2
|
-
import {
|
|
1
|
+
import { convertToLlm, leafIdAfterEntry, uuidv7 } from "../../internal/harness.js";
|
|
2
|
+
import { resolveCheckpointStore } from "../checkpoint-store.js";
|
|
3
|
+
import { compactionFailureCause, compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
|
|
3
4
|
import { compactionSeatsDefect, contextOverlayFor } from "../context-settings.js";
|
|
4
5
|
import { RETIRED_COMPACTION_SEAT_KEYS } from "../retired-keys.js";
|
|
5
6
|
import { createRowSeat, promptCountOf } from "../mods/session-append.js";
|
|
@@ -10,33 +11,63 @@ import { resolveTaskModel } from "../roles.js";
|
|
|
10
11
|
import { StoredSession } from "../session.js";
|
|
11
12
|
import { emitTrace } from "../trace.js";
|
|
12
13
|
import { egressThrownText } from "../untrusted-egress.js";
|
|
14
|
+
import { readElements, readMember } from "../thrown-value.js";
|
|
15
|
+
import { inlineUntrusted } from "../untrusted-text.js";
|
|
13
16
|
import { emitInputTruncated, legCompactionSettings } from "./compaction-call-options.js";
|
|
14
17
|
import { compactionHookOptions, summaryProviderOptions } from "./compaction-seams.js";
|
|
15
18
|
import { compactionSummaryFallback, compactionSummaryIsDerived } from "./derived-route-fallback.js";
|
|
16
19
|
import { resolveCompactionModel } from "./prepare-config-doors.js";
|
|
17
20
|
import { compactionActivationSnapshot } from "./prepare-tool-disclosure-mount.js";
|
|
18
21
|
import { derivedLegBrain, sideCallBookOf } from "./side-call-account.js";
|
|
19
|
-
import {
|
|
22
|
+
import { createModelFallbackSeat } from "./model-fallback-seat.js";
|
|
23
|
+
import { modelLaneBrainOf } from "./model-lane-seat.js";
|
|
24
|
+
import { projectRequestCopies } from "../request-copy-projection.js";
|
|
25
|
+
import { acquireExistingSession, claimIdleSession, readOccupantExpectation, readPlainRequest, shownValue } from "./session-verb-doors.js";
|
|
20
26
|
const VERB = "Runner.compactSession";
|
|
21
|
-
const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "signal"]);
|
|
27
|
+
const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "checkpointStore", "signal", "expect"]);
|
|
22
28
|
const SETTINGS_KEYS = new Set(["manualCompact", "reserveTokens", "keepRecentTokens", "instructions", "clampTolerance", ...Object.keys(RETIRED_COMPACTION_SEAT_KEYS)]);
|
|
23
29
|
export async function compactIdleSession(seats, request) {
|
|
24
30
|
const req = screenCompactSessionRequest(request);
|
|
25
31
|
const { deps } = seats;
|
|
26
32
|
const resolved = resolveTaskModel({ model: req.model }, deps);
|
|
27
33
|
const named = resolveCompactionModel(req.compactionModel !== undefined ? { compactionModel: req.compactionModel } : {}, deps, "compactSession.compactionModel");
|
|
34
|
+
const store = resolveCheckpointStore(req.checkpointStore !== undefined ? { checkpointStore: req.checkpointStore } : {}, deps);
|
|
28
35
|
if (req.signal?.aborted === true)
|
|
29
36
|
return { outcome: "mooted", events: [] };
|
|
30
37
|
const release = await claimIdleSession(seats, req.sessionId, () => sessionBusyRefusal(req.sessionId));
|
|
38
|
+
let legMods;
|
|
31
39
|
try {
|
|
32
|
-
const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted");
|
|
33
|
-
|
|
34
|
-
|
|
40
|
+
const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted", req.expect);
|
|
41
|
+
await refuseParkedSession(store, req.sessionId, req.checkpointStore !== undefined ? "the request's" : "the deployment's");
|
|
42
|
+
legMods = await admitLegMods({ spec: {}, deps, sessionId: req.sessionId });
|
|
43
|
+
return await compactOnSession(req, deps, new StoredSession(pinnedToLeaf(acquired.session.getStorage())), resolved, named, legMods);
|
|
35
44
|
}
|
|
36
45
|
finally {
|
|
46
|
+
legMods?.end();
|
|
37
47
|
release();
|
|
38
48
|
}
|
|
39
49
|
}
|
|
50
|
+
function pinnedToLeaf(storage) {
|
|
51
|
+
let pinned;
|
|
52
|
+
return new Proxy(storage, {
|
|
53
|
+
get(target, prop, receiver) {
|
|
54
|
+
if (prop === "getLeafId")
|
|
55
|
+
return () => (pinned ??= target.getLeafId());
|
|
56
|
+
if (prop === "appendEntry")
|
|
57
|
+
return async (entry, opts) => {
|
|
58
|
+
await target.appendEntry(entry, opts);
|
|
59
|
+
pinned = Promise.resolve(leafIdAfterEntry(entry));
|
|
60
|
+
};
|
|
61
|
+
if (prop === "setLeafId")
|
|
62
|
+
return async (leafId, opts) => {
|
|
63
|
+
await target.setLeafId(leafId, opts);
|
|
64
|
+
pinned = Promise.resolve(leafId);
|
|
65
|
+
};
|
|
66
|
+
const value = Reflect.get(target, prop, receiver);
|
|
67
|
+
return typeof value === "function" ? value.bind(target) : value;
|
|
68
|
+
},
|
|
69
|
+
});
|
|
70
|
+
}
|
|
40
71
|
async function compactOnSession(req, deps, session, resolved, named, legMods) {
|
|
41
72
|
const { sessionId } = req;
|
|
42
73
|
const events = [];
|
|
@@ -44,7 +75,8 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
|
|
|
44
75
|
const passReport = compactionPassReport({ push: (e) => events.push(e) }, ident);
|
|
45
76
|
const stats = { turns: 0, tokens: 0, toolCalls: 0, promptTokens: 0, totalInputTokens: 0, cachedTokens: 0, cacheWriteTokens: 0, cacheWriteTokensLong: 0, outputTokens: 0, costMicroUsd: 0 };
|
|
46
77
|
const telemetry = { unpricedSpend: false, tracer: deps.tracer, taskId: sessionId };
|
|
47
|
-
const
|
|
78
|
+
const fallbackSeat = createModelFallbackSeat(deps.onNotice, { sessionId });
|
|
79
|
+
const accountBook = sideCallBookOf(stats, { telemetry, pricing: () => deps.pricing, noteUnevaluablePriceTable: (p) => void (malformedPricingField(p) !== undefined && (telemetry.unpricedSpend = true)), noteFallback: (lane, requested, reading) => fallbackSeat.observe(lane, requested, reading) });
|
|
48
80
|
let calls = 0;
|
|
49
81
|
const book = (lane, model, reply) => {
|
|
50
82
|
calls += 1;
|
|
@@ -71,9 +103,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
|
|
|
71
103
|
});
|
|
72
104
|
const trace = deps.tracer;
|
|
73
105
|
try {
|
|
74
|
-
const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: deps
|
|
106
|
+
const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: modelLaneBrainOf(deps), getApiKeyAndHeaders: req.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId }) : named;
|
|
75
107
|
const branch = await session.getBranch();
|
|
76
|
-
const contextMessages = convertToLlm((await session.buildContext()).messages);
|
|
108
|
+
const contextMessages = projectRequestCopies(convertToLlm((await session.buildContext()).messages));
|
|
77
109
|
bindSessionFacade(legMods, { deps, req, model: resolved.model, messages: contextMessages, book, turns: async () => promptCountOf(await session.getBranch()) });
|
|
78
110
|
const rowSeat = createRowSeat();
|
|
79
111
|
rowSeat.bind({ bus: legMods.bus, identity: undefined, report: legMods.report });
|
|
@@ -88,7 +120,7 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
|
|
|
88
120
|
model: resolved.model,
|
|
89
121
|
...(overlay !== undefined ? { contextOverlay: overlay } : {}),
|
|
90
122
|
...(compactionModel !== undefined ? { compactionModel } : {}),
|
|
91
|
-
brain: derivedLegBrain(() => deps
|
|
123
|
+
brain: derivedLegBrain(() => modelLaneBrainOf(deps), "compaction", book),
|
|
92
124
|
...(req.getApiKeyAndHeaders !== undefined ? { getApiKeyAndHeaders: req.getApiKeyAndHeaders } : {}),
|
|
93
125
|
...(thinking !== undefined ? { thinking } : {}),
|
|
94
126
|
settings: legCompactionSettings(req.compaction !== undefined ? { compaction: req.compaction } : {}, overlay, "manualCompact"),
|
|
@@ -124,8 +156,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
|
|
|
124
156
|
}
|
|
125
157
|
deps.onError?.(asError(err), { phase: "compaction", sessionId });
|
|
126
158
|
const reason = compactionFailureReason(err);
|
|
159
|
+
const cause = compactionFailureCause(err);
|
|
127
160
|
emitTrace(trace, () => ({ kind: "compaction.failed", version: 1, taskId: sessionId, trigger: "manual", reason, ts: Date.now() }));
|
|
128
|
-
events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...passReport.end, ...ident() });
|
|
161
|
+
events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...(cause !== undefined ? { cause } : {}), ...passReport.end, ...ident() });
|
|
129
162
|
return answer("failed");
|
|
130
163
|
}
|
|
131
164
|
}
|
|
@@ -146,6 +179,7 @@ function bindSessionFacade(legMods, input) {
|
|
|
146
179
|
agentSessions: undefined,
|
|
147
180
|
turns: input.turns,
|
|
148
181
|
measure: {},
|
|
182
|
+
turnAbort: {},
|
|
149
183
|
activeTools: new Set(),
|
|
150
184
|
agentListing: undefined,
|
|
151
185
|
book: (answeredBy, reply) => input.book("mod", answeredBy, reply),
|
|
@@ -162,6 +196,7 @@ function bindSessionFacade(legMods, input) {
|
|
|
162
196
|
root: () => unavailable("session.root"),
|
|
163
197
|
tools: () => unavailable("tool.list"),
|
|
164
198
|
agents: () => unavailable("agent.list"),
|
|
199
|
+
turnAbort: () => unavailable("turn.abort"),
|
|
165
200
|
});
|
|
166
201
|
}
|
|
167
202
|
function asError(err) {
|
|
@@ -169,11 +204,11 @@ function asError(err) {
|
|
|
169
204
|
}
|
|
170
205
|
function screenCompactSessionRequest(request) {
|
|
171
206
|
const bad = (what) => {
|
|
172
|
-
const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, signal? }.`);
|
|
207
|
+
const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, checkpointStore?, signal?, expect? }.`);
|
|
173
208
|
e.code = "compact.invalid_request";
|
|
174
209
|
throw e;
|
|
175
210
|
};
|
|
176
|
-
const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, signal } = readPlainRequest(request, REQUEST_KEYS, bad);
|
|
211
|
+
const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, checkpointStore, signal, expect } = readPlainRequest(request, REQUEST_KEYS, bad);
|
|
177
212
|
if (typeof sessionId !== "string" || sessionId === "")
|
|
178
213
|
return bad(`sessionId must be a non-empty string, got ${shownValue(sessionId)}`);
|
|
179
214
|
if (model === undefined)
|
|
@@ -191,7 +226,9 @@ function screenCompactSessionRequest(request) {
|
|
|
191
226
|
compaction: compaction === undefined ? undefined : screenSettings(compaction, bad),
|
|
192
227
|
compactionModel: compactionModel,
|
|
193
228
|
getApiKeyAndHeaders: getApiKeyAndHeaders,
|
|
229
|
+
checkpointStore: checkpointStore,
|
|
194
230
|
signal,
|
|
231
|
+
expect: readOccupantExpectation(expect, bad),
|
|
195
232
|
};
|
|
196
233
|
}
|
|
197
234
|
function screenSettings(raw, bad) {
|
|
@@ -214,6 +251,39 @@ function screenSettings(raw, bad) {
|
|
|
214
251
|
...(clampTolerance !== undefined ? { clampTolerance: clampTolerance } : {}),
|
|
215
252
|
};
|
|
216
253
|
}
|
|
254
|
+
async function refuseParkedSession(store, sessionId, whose) {
|
|
255
|
+
if (store === undefined)
|
|
256
|
+
return;
|
|
257
|
+
const parked = (why, cause) => {
|
|
258
|
+
const e = new Error(`${VERB}: ${why} — a parked session's resume rewinds its branch to the checkpoint's leaf, where a summary written now would not be read, so nothing was compacted; decide the checkpoint (resume it) or expire it, then compact`, cause !== undefined ? { cause } : undefined);
|
|
259
|
+
e.code = "compact.session_parked";
|
|
260
|
+
throw e;
|
|
261
|
+
};
|
|
262
|
+
if (typeof store.listBySession !== "function")
|
|
263
|
+
return parked(`${whose} checkpoint store has no listBySession, so it cannot say whether session "${sessionId}" is parked at a checkpoint`);
|
|
264
|
+
let answer;
|
|
265
|
+
try {
|
|
266
|
+
answer = await store.listBySession({ sessionId, status: "pending", limit: 1 });
|
|
267
|
+
}
|
|
268
|
+
catch (err) {
|
|
269
|
+
return parked(`${whose} checkpoint store could not say whether session "${sessionId}" is parked at a checkpoint (listBySession failed: ${egressThrownText("same-principal", err)})`, err);
|
|
270
|
+
}
|
|
271
|
+
const unanswered = (what) => parked(`${whose} checkpoint store answered ${what}, so it cannot say whether session "${sessionId}" is parked at a checkpoint`, new Error(`listBySession answered ${what}`));
|
|
272
|
+
const rows = readElements(readMember(answer, "rows"));
|
|
273
|
+
if (rows === undefined)
|
|
274
|
+
return unanswered("without a list of rows");
|
|
275
|
+
if (rows.length === 0)
|
|
276
|
+
return;
|
|
277
|
+
const row = rows[0];
|
|
278
|
+
const kind = readMember(row, "kind");
|
|
279
|
+
const checkpoint = kind === "row" ? readMember(row, "checkpoint") : undefined;
|
|
280
|
+
const token = kind === "row" ? readMember(checkpoint, "token") : kind === "unreadable" ? readMember(row, "token") : undefined;
|
|
281
|
+
if (typeof token !== "string" || token === "")
|
|
282
|
+
return unanswered("a first row that is no checkpoint row with a token");
|
|
283
|
+
const id = readMember(checkpoint, "checkpointId");
|
|
284
|
+
const named = typeof id === "string" && id.trim() !== "" ? `checkpoint "${inlineUntrusted(id, 64)}"` : "a checkpoint";
|
|
285
|
+
return parked(`session "${sessionId}" is parked at ${named}, which is pending`);
|
|
286
|
+
}
|
|
217
287
|
function sessionBusyRefusal(sessionId) {
|
|
218
288
|
const e = new Error(`${VERB}: a task is running or queued on session "${sessionId}" in this Runner, or a write one of its tasks issued has not settled — compacting it now would rewrite the transcript under that work, so nothing was compacted; a running task takes the request through its own stream (TaskStream.compact), otherwise retry once it has ended and its writes have settled`);
|
|
219
289
|
e.code = "compact.session_busy";
|
|
@@ -32,35 +32,6 @@ import { type CompactionSettings } from "../../internal/harness.js";
|
|
|
32
32
|
* task has no hands (no `compactionRestore` ⇒ nothing can be re-read).
|
|
33
33
|
*/
|
|
34
34
|
export declare function buildWorkingFileAttachments(spec: TaskSpec, prepared: Prepared): MaybeCompactOptions["workingFileAttachments"];
|
|
35
|
-
/**
|
|
36
|
-
* `MaybeCompactOptions.contextInstructionFiles`: the deployment's instruction-file content (the CLAUDE.md
|
|
37
|
-
* family) delivered to the SUMMARIZER, assembled once here and spread on all three lanes — the compaction
|
|
38
|
-
* boundary is where the summary REPLACES the transcript that carried those instructions.
|
|
39
|
-
*
|
|
40
|
-
* Contract:
|
|
41
|
-
* - Bytes = `Prepared.projectInstructionContent`, the RAW loader text captured under the same non-blank
|
|
42
|
-
* predicate that composes the project layer. Not the assembled `memoryBlock` (model-authored in-band
|
|
43
|
-
* bytes would gain an instructing envelope), not the COMPOSED project block (`contextInstructionFilesSection`
|
|
44
|
-
* neutralizes the whole authority family, `user_memory`/`scope` included), not `instructionSources`
|
|
45
|
-
* (path + hash only). Raw text in, one fence at the mint.
|
|
46
|
-
* - Provenance: REPOSITORY-CONTROLLED text delivered through a host callback — delivery is not authorship;
|
|
47
|
-
* the mint's neutralization stops tag breakout, not a sentence asking for an omission. Two no-code exits
|
|
48
|
-
* for a deployment that does not want it: do not wire the loader, or return vouched content. A separate
|
|
49
|
-
* deployment-vouched summarization-instructions seat is an open design candidate, not built here.
|
|
50
|
-
* - Both summary forms, no per-form split: fork eligibility is decided per pass inside maybeCompact, and the
|
|
51
|
-
* form NOT covered by a `compModel`-gated split is exactly the fork that degrades mid-pass to the
|
|
52
|
-
* independent form; the section rides the APPENDED instruction message, never the cached prefix.
|
|
53
|
-
* - No new size knob: the bound is `fitContextInstructionFilesSection` (independent form only). Its three
|
|
54
|
-
* known limits are accepted knowingly: a token-dense payload can pass a chars-domain fit and still overflow;
|
|
55
|
-
* an unknown `contextWindow` leaves the section unbounded; the FORK form cannot fit and degrades ONCE. When
|
|
56
|
-
* a limit bites the boundary FAILS (the section is a fixed request part the retry loop cannot drop) — the
|
|
57
|
-
* task loses that compaction rather than sending a shorter one; making the section participate in the
|
|
58
|
-
* retry loop is a library-face contract change, tracked there.
|
|
59
|
-
* - Cost: instruction-file content + exactly 716 chars of framing on every summarization request, both
|
|
60
|
-
* forms, once per pass (pinned in the REF-A2 suite). Deployments that never wired the loader pay nothing:
|
|
61
|
-
* the key is ABSENT, so their requests are byte-identical to the pre-wiring shape.
|
|
62
|
-
*/
|
|
63
|
-
export declare function contextInstructionFilesOption(prepared: Prepared): Partial<Pick<MaybeCompactOptions, "contextInstructionFiles">>;
|
|
64
35
|
/**
|
|
65
36
|
* The CC-form fork seam, assembled identically on all three lanes (REF-A2): the
|
|
66
37
|
* summary request forks the main lane's latest real request (recorded by prepare-task's provider
|
|
@@ -164,5 +135,7 @@ export declare function legContextOverlayOption(prepared: Prepared, runner: Runn
|
|
|
164
135
|
* for the boundary's own pass, the recovery pass and the end-of-task summary, `manualCompact` for a requested one —
|
|
165
136
|
* keeps "who decides whether this pass runs" a single expression ({@link compactionEnabled}: the request authored the
|
|
166
137
|
* seat > the deployment declared it > on). The two seats themselves do not ride the settings: the pass reads its gate.
|
|
138
|
+
* The reserve follows the same law ({@link compactionReserve}: the request's value > the overlay's for the leg's model > the
|
|
139
|
+
* engine default), and the disclosures that estimate the threshold read it through this function too.
|
|
167
140
|
*/
|
|
168
141
|
export declare function legCompactionSettings(spec: Pick<TaskSpec, "compaction">, overlay: ContextWindowOverlay | undefined, seat: CompactionSeat): CompactionSettings;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { emitTrace } from "../trace.js";
|
|
2
2
|
import { buildToolResultRef, OFFLOAD_TOOL_NAME, PERSISTED_OUTPUT_PREFIX, toolResultContentSegment, toolResultProvenanceOf, } from "../tool-result-store.js";
|
|
3
|
-
import { compactionEnabled, contextOverlayFor } from "../context-settings.js";
|
|
3
|
+
import { compactionEnabled, compactionReserve, contextOverlayFor } from "../context-settings.js";
|
|
4
4
|
import { DEFAULT_COMPACTION_SETTINGS } from "../../internal/harness.js";
|
|
5
5
|
export function buildWorkingFileAttachments(spec, prepared) {
|
|
6
6
|
if (spec.compaction?.attachWorkingFiles === false || !prepared.compactionRestore)
|
|
@@ -9,16 +9,9 @@ export function buildWorkingFileAttachments(spec, prepared) {
|
|
|
9
9
|
...prepared.compactionRestore,
|
|
10
10
|
...(prepared.recentlyReadFiles ? { recentlyReadFiles: prepared.recentlyReadFiles } : {}),
|
|
11
11
|
...(prepared.normalizeAttachmentPath ? { normalizePath: prepared.normalizeAttachmentPath } : {}),
|
|
12
|
-
...(prepared.isDedupStubResult ? { isDedupStubResult: prepared.isDedupStubResult } : {}),
|
|
13
|
-
...(prepared.instructionSources
|
|
14
|
-
? { instructionSourcePaths: prepared.instructionSources.filter((s) => s.contentHash !== null).map((s) => s.path) }
|
|
15
|
-
: {}),
|
|
16
12
|
...(typeof spec.compaction?.attachWorkingFiles === "object" ? spec.compaction.attachWorkingFiles : undefined),
|
|
17
13
|
};
|
|
18
14
|
}
|
|
19
|
-
export function contextInstructionFilesOption(prepared) {
|
|
20
|
-
return prepared.projectInstructionContent !== undefined ? { contextInstructionFiles: prepared.projectInstructionContent } : {};
|
|
21
|
-
}
|
|
22
15
|
export function forkContextOption(prepared, disable) {
|
|
23
16
|
return disable ? {} : { forkContext: prepared.lastBrainContext };
|
|
24
17
|
}
|
|
@@ -123,5 +116,5 @@ export function legContextOverlayOption(prepared, runner) {
|
|
|
123
116
|
}
|
|
124
117
|
export function legCompactionSettings(spec, overlay, seat) {
|
|
125
118
|
const { autoCompact: _auto, manualCompact: _manual, ...members } = spec.compaction ?? {};
|
|
126
|
-
return { ...DEFAULT_COMPACTION_SETTINGS, ...members, enabled: compactionEnabled(seat, spec.compaction, overlay) };
|
|
119
|
+
return { ...DEFAULT_COMPACTION_SETTINGS, ...members, reserveTokens: compactionReserve(members.reserveTokens, overlay) ?? DEFAULT_COMPACTION_SETTINGS.reserveTokens, enabled: compactionEnabled(seat, spec.compaction, overlay) };
|
|
127
120
|
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { MaybeCompactOptions } from "../auto-compaction.js";
|
|
2
2
|
import { type PostureFacts } from "../auto-mode-directive.js";
|
|
3
3
|
import type { Prepared } from "./contracts.js";
|
|
4
|
+
import { type InstructionEcho } from "./nested-memory-lane.js";
|
|
4
5
|
/**
|
|
5
6
|
* The facts the posture composition reads, as the leg IS now: the live effective mode and ask answer, the plan-exit
|
|
6
7
|
* tool's presence on the minted roster, the minted delegation identity, and the session plan file the run admitted. The one place a leg's facts are assembled —
|
|
@@ -42,6 +43,13 @@ export declare function mintOutputStyleReminder(prepared: Pick<Prepared, "output
|
|
|
42
43
|
/** Is a frame of this source already on its way to the next request (a pending receipt)? The one reading, for every
|
|
43
44
|
* collector that could state it again: the boundary bundle, the direct-write style lane and the posture writer. */
|
|
44
45
|
export declare function frameCarried(ledger: Prepared["frameReceipts"], source: Prepared["frameReceipts"]["pending"][number]["source"]): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* Settle the receipts a landed message carries, in receipt order. A step that must read the session first (a changed-files notice's
|
|
48
|
+
* announcement) returns a promise: the steps behind it wait for it, and the one promise is handed back to the `message_end` handler
|
|
49
|
+
* (the harness awaits its listeners), so every announcement lands before the next listener reads the event. `undefined` when every
|
|
50
|
+
* step was synchronous.
|
|
51
|
+
*/
|
|
52
|
+
export declare function settleFrameReceipts(settled: ReadonlyArray<Prepared["frameReceipts"]["pending"][number]>, entryId: string): Promise<void> | undefined;
|
|
45
53
|
/**
|
|
46
54
|
* The turn boundary's direct writes, for a boundary a request can follow: the owed posture, and the output style when
|
|
47
55
|
* the turn's tool results do not go back as the next request (`turnOwesRequest` false) and queued input already
|
|
@@ -59,5 +67,13 @@ export declare function appendBoundaryFrames(prepared: Pick<Prepared, "approvalP
|
|
|
59
67
|
* and never fails the landed compaction.
|
|
60
68
|
*/
|
|
61
69
|
export declare function planFileRestateOption(prepared: Prepared): Pick<MaybeCompactOptions, "planFileRestate">;
|
|
62
|
-
/**
|
|
63
|
-
|
|
70
|
+
/** The instruction files' compaction arm (`restateInstructionFiles`): a leg with the instruction-file lane writes what the
|
|
71
|
+
* compacted context owes — the task root's members first — before any reader of the new baseline. It keeps the posture's
|
|
72
|
+
* halt rule (a person's bare rejection halted the batch: nothing the engine says enters the transcript ahead of that
|
|
73
|
+
* person's next words; the next load owes the files again). */
|
|
74
|
+
export declare function instructionsRestateOption(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "instructionsRestate">;
|
|
75
|
+
/** Every post-compaction restatement the three compaction routes register, at one spread site, and the frames those
|
|
76
|
+
* restatements post again (`restatedFrames`: the floor the trigger's "window below overhead" judgment reads beside the
|
|
77
|
+
* prefix — the request core's engine frames, the one set the guard trim holds); `echo` is the run's echo of a restated
|
|
78
|
+
* instruction frame. */
|
|
79
|
+
export declare function compactionRestateOptions(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "gitRestate" | "instructionsRestate" | "postureRestate" | "planFileRestate" | "advisorRestate" | "languageRestate" | "restatedFrames">;
|