@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
|
@@ -12,12 +12,14 @@ export type SystemInjectionPriority = "now" | "next" | "later";
|
|
|
12
12
|
* The outcome an injection entry settles with — what the session did with the frame:
|
|
13
13
|
* · `queued` — a live lane took it (it rides that run's next turn boundary; accepted, not yet consumed);
|
|
14
14
|
* · `parked` — no live lane; pended IN PROCESS on {@link PendingSessionNotifications} for the
|
|
15
|
-
* session's next run
|
|
15
|
+
* session's next run on this runner (a process restart loses it);
|
|
16
16
|
* · `parked_durably` — no live lane; appended to the session's DURABLE box
|
|
17
17
|
* ({@link PendingSessionNotifications.admit}) — the next run drains it, in any process;
|
|
18
18
|
* · `dropped_duplicate` — the session already delivered this exact frame;
|
|
19
19
|
* · `refused` — a live lane took it and the session's receiving station did not hand it over: an extension consumed it,
|
|
20
|
-
* or a handler there failed ({@link FrameReceiver})
|
|
20
|
+
* or a handler there failed ({@link FrameReceiver}); or it was addressed to an occupant the session no longer holds
|
|
21
|
+
* (discarded, announced); or the durable box of a session this runner holds no seat for failed it twice (disclosed, and
|
|
22
|
+
* nothing is kept here — no leg of that session reads this runner's park). The model never saw it, and it is not owed again.
|
|
21
23
|
* The park backend is the seat's choice ({@link routeOrParkNotification}), never the producer's.
|
|
22
24
|
*/
|
|
23
25
|
export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate" | "refused";
|
|
@@ -405,6 +407,18 @@ export interface SystemInjection<TPayload = unknown> {
|
|
|
405
407
|
* `seq` (the documented repeat discipline); silently migrating a queued frame between lanes on a
|
|
406
408
|
* repeat, or refusing the repeat typed, would each turn a dedup fold into a delivery mutation. */
|
|
407
409
|
export declare function taskNotificationDedupKey(n: Pick<TaskNotificationPayload, "task_id" | "task_type" | "status" | "seq" | "attempt">): string;
|
|
410
|
+
/**
|
|
411
|
+
* The one set of options a task notification is handed to the model under, on every road it takes — the live lane (a running
|
|
412
|
+
* leg's steer / follow-up) and the turn-open redelivery (a frame parked while the session sat idle): engine-note provenance
|
|
413
|
+
* (visible to the model and to derived views, never the user's speech), the frame itself as the payload sidecar, and its
|
|
414
|
+
* {@link taskNotificationDedupKey} as the durable key on the transcript entry it becomes — the key the entry's
|
|
415
|
+
* `message_committed` frame states as `noteKey`, so a frame and its row join by key whichever road the frame took.
|
|
416
|
+
*/
|
|
417
|
+
export declare function taskNotificationNoteOptions(payload: TaskNotificationPayload): {
|
|
418
|
+
readonly provenance: "engine-note";
|
|
419
|
+
readonly enginePayload: TaskNotificationPayload;
|
|
420
|
+
readonly engineNoteKey: string;
|
|
421
|
+
};
|
|
408
422
|
/**
|
|
409
423
|
* The lane-scoped identity of a task, extracted from {@link taskNotificationDedupKey} so every
|
|
410
424
|
* place that treats "same task" as one bucket applies the SAME lane rule.
|
|
@@ -516,6 +530,10 @@ export interface SessionAddress {
|
|
|
516
530
|
* takes the leg as no admission, drains it nothing, registers no live lane for it, and discards (announced) what is routed
|
|
517
531
|
* to it ({@link PendingSessionNotifications.admit}, {@link PendingSessionNotifications.discardsStale}). */
|
|
518
532
|
readonly unread?: true;
|
|
533
|
+
/** The scope the session's legs mount its durable box in, as the address's minter recorded it (a delegation tree's root
|
|
534
|
+
* anchor carries the one its root leg mounted). Read only where the store holds no seat for the session: the box is then the
|
|
535
|
+
* one {@link PendingSessionNotifications}' unseated box seat judges at this scope. Absent ⇒ no box is judged for it. */
|
|
536
|
+
readonly scope?: string;
|
|
519
537
|
}
|
|
520
538
|
/** A run leg's own session address — the session it prepared and the occupant its acquire read (the one construction). */
|
|
521
539
|
export declare function sessionAddressOf(leg: {
|
|
@@ -565,9 +583,50 @@ export interface SessionBoxBinding {
|
|
|
565
583
|
/** The deployment's engine-frame floor (`RunnerDeps.sessionBoxEngineFrames`): `true` ⇒ an engine
|
|
566
584
|
* frame parks in this box as an `engine_frame` record; otherwise it parks in process. */
|
|
567
585
|
engineFrames?: boolean;
|
|
568
|
-
/** Where an append fault is disclosed
|
|
586
|
+
/** Where an append fault is disclosed. For a session the store holds a seat for, a second fault leaves the frame on the
|
|
587
|
+
* in-process park its next leg on this runner settles with the box; for one it holds none for, the second fault is disclosed
|
|
588
|
+
* here too and nothing is kept — no leg of that session would read it. */
|
|
569
589
|
onError?: (e: unknown) => void;
|
|
570
590
|
}
|
|
591
|
+
/** Why no durable box is judged for a session id at a scope ({@link SessionBoxVerdict}): the deployment wires no mailbox store;
|
|
592
|
+
* the mailbox, or the session store's by-id read, is not safe to share across processes (`reason` = the mount verdict's own
|
|
593
|
+
* sentence); the id is outside the box address grammar. */
|
|
594
|
+
export type SessionBoxRefusal = {
|
|
595
|
+
readonly code: "no_mailbox";
|
|
596
|
+
} | {
|
|
597
|
+
readonly code: "mailbox_unsafe";
|
|
598
|
+
readonly reason: string;
|
|
599
|
+
} | {
|
|
600
|
+
readonly code: "ungrammatical";
|
|
601
|
+
};
|
|
602
|
+
/** The one judgment of a session's durable box at a scope: its binding, or why there is none. */
|
|
603
|
+
export type SessionBoxVerdict = {
|
|
604
|
+
readonly ok: true;
|
|
605
|
+
readonly box: SessionBoxBinding;
|
|
606
|
+
} | {
|
|
607
|
+
readonly ok: false;
|
|
608
|
+
readonly cause: SessionBoxRefusal;
|
|
609
|
+
};
|
|
610
|
+
/** A completion sink: a background producer's frame and its tier, the shape a mount's `notify` takes. */
|
|
611
|
+
export type TaskNotificationSink = (n: TaskNotificationPayload, opts?: {
|
|
612
|
+
priority?: SystemInjectionPriority;
|
|
613
|
+
}) => void;
|
|
614
|
+
/** Why a completion addressed to a session does not take the route ({@link PendingSessionNotifications.completionLaneOf}): the box
|
|
615
|
+
* judgment's refusal ({@link SessionBoxRefusal}); the deployment declares no durable engine frames (`floor_off`); the address names
|
|
616
|
+
* no scope its box lives in (`no_root_scope`). Engine-internal: it picks a sentence, it never rides the wire. */
|
|
617
|
+
export type SessionCompletionLaneCause = SessionBoxRefusal | {
|
|
618
|
+
readonly code: "floor_off";
|
|
619
|
+
} | {
|
|
620
|
+
readonly code: "no_root_scope";
|
|
621
|
+
};
|
|
622
|
+
/** The route's sink for a completion addressed to a session, or why there is none. */
|
|
623
|
+
export type SessionCompletionLane = {
|
|
624
|
+
readonly ok: true;
|
|
625
|
+
readonly sink: TaskNotificationSink;
|
|
626
|
+
} | {
|
|
627
|
+
readonly ok: false;
|
|
628
|
+
readonly cause: SessionCompletionLaneCause;
|
|
629
|
+
};
|
|
571
630
|
/** The hand-back contract's three words (see {@link TaskNotificationPayload.handback}). */
|
|
572
631
|
export declare const HANDBACK_STATES: readonly ["send", "flagged", "withheld"];
|
|
573
632
|
export type HandbackState = (typeof HANDBACK_STATES)[number];
|
|
@@ -897,14 +956,20 @@ export interface SessionBoxDebt {
|
|
|
897
956
|
* another occupant, and an occupant once replaced never stands again. So from an admission on, whatever is addressed to,
|
|
898
957
|
* or kept for, another occupant of that id is discarded — announced `delegation.delivery_discarded` (operator), never
|
|
899
958
|
* delivered and never silent. A session no leg of which was admitted here (or whose seat aged out of the bound) has no
|
|
900
|
-
* current occupant on record: its frames park under their own address and are judged by the leg that drains them
|
|
959
|
+
* current occupant on record: its frames park under their own address and are judged by the leg that drains them — in the
|
|
960
|
+
* durable box the unseated box seat judges for an address that names its box's scope, else in process.
|
|
901
961
|
*/
|
|
902
962
|
export declare class PendingSessionNotifications {
|
|
903
963
|
private readonly sessions;
|
|
904
964
|
/** Where a discard is announced: the deployment's notice sink, read when the discard happens (absent ⇒ the process default seat). */
|
|
905
965
|
private readonly noticeSeat;
|
|
966
|
+
/** The durable box of a session this store holds no seat for, judged by the deployment as it stands when asked (absent ⇒ none). */
|
|
967
|
+
private readonly unseatedBoxSeat;
|
|
906
968
|
constructor(seats?: {
|
|
907
969
|
readonly onNotice?: () => ((notice: EngineNotice) => void) | undefined;
|
|
970
|
+
readonly boxFor?: (address: SessionAddress & {
|
|
971
|
+
readonly scope: string;
|
|
972
|
+
}) => SessionBoxVerdict;
|
|
908
973
|
});
|
|
909
974
|
/**
|
|
910
975
|
* The LIVE half of the same question this store answers. Together they are one seat — "where does a
|
|
@@ -940,8 +1005,21 @@ export declare class PendingSessionNotifications {
|
|
|
940
1005
|
* so a parked record is always judged against the occupant that parked it, never against whichever frame arrives next.
|
|
941
1006
|
*/
|
|
942
1007
|
admit(address: SessionAddress, box: SessionBoxBinding | undefined): void;
|
|
943
|
-
/** The addressed occupant's durable box
|
|
1008
|
+
/** The addressed occupant's durable box. A session a leg of which this store admitted answers by its seat alone: the box that
|
|
1009
|
+
* leg bound, never another occupant's. One it holds no seat for answers by {@link boxVerdictOf} — a judgment, not an
|
|
1010
|
+
* admission: it writes no seat, and the occupant the box's drain hands the record to is judged there. */
|
|
944
1011
|
sessionBoxFor(address: SessionAddress): SessionBoxBinding | undefined;
|
|
1012
|
+
/** Does a leg of the session hold a seat here — so its next leg on this runner reads what this store parks for it? */
|
|
1013
|
+
holdsSeat(sessionId: string): boolean;
|
|
1014
|
+
/** The deployment's judgment of the address's durable box at the scope the address names (the unseated box seat, read now) —
|
|
1015
|
+
* what the route reads for a session no leg of which is seated here; `undefined` when the address names no scope or the
|
|
1016
|
+
* store was handed no seat. */
|
|
1017
|
+
boxVerdictOf(address: SessionAddress): SessionBoxVerdict | undefined;
|
|
1018
|
+
/** A completion addressed to `address` (a delegation tree's root, by a drive with no run lane of its own) through this store's
|
|
1019
|
+
* route ({@link routeOrParkNotification}): its sink while the deployment judges the address a durable box that takes engine
|
|
1020
|
+
* frames ({@link boxVerdictOf}) — the route then reaches its live run here, else its seat here, else that box — or why not.
|
|
1021
|
+
* `unkept` takes a frame the box of a session seated nowhere here failed twice (the route keeps no copy of it). */
|
|
1022
|
+
completionLaneOf(address: SessionAddress, unkept?: TaskNotificationSink): SessionCompletionLane;
|
|
945
1023
|
/**
|
|
946
1024
|
* Is `address` an earlier occupant of a session whose current occupant is another? Then the frame is discarded here —
|
|
947
1025
|
* announced with the seat it would have reached under the current occupant — and the answer is `true`: nothing routes,
|
|
@@ -1041,7 +1119,8 @@ export declare class DurableAppendObligations {
|
|
|
1041
1119
|
}
|
|
1042
1120
|
/**
|
|
1043
1121
|
* WHERE A FRAME ADDRESSED TO ONE SESSION GOES — the single decision, so the two addresses that ask it
|
|
1044
|
-
* (a run's own session, and the delegation tree's root anchor
|
|
1122
|
+
* (a run's own session, and the delegation tree's root anchor — a revived run's lane, a lane-less drive's completion) cannot
|
|
1123
|
+
* drift apart. Three outcomes:
|
|
1045
1124
|
* · the session ALREADY OWNS the key (parked, or routed onto a live lane) ⇒ fold — neither route it
|
|
1046
1125
|
* nor park a second copy; `"parked"` is the word a folded repeat has always been given;
|
|
1047
1126
|
* · a live lane takes it ⇒ it rides that run's next turn boundary. This decision records NOTHING in
|
|
@@ -1051,9 +1130,10 @@ export declare class DurableAppendObligations {
|
|
|
1051
1130
|
* · nothing can take it ⇒ park, carrying the tier, for the session's next run.
|
|
1052
1131
|
* The address names the session's occupant ({@link SessionAddress}): every one of the three is that occupant's — its keys,
|
|
1053
1132
|
* its live lanes, its box, its record — and a frame addressed to an occupant the session no longer holds is discarded
|
|
1054
|
-
* before any of them ({@link PendingSessionNotifications.discardsStale}); its receipt says `"refused"`.
|
|
1133
|
+
* before any of them ({@link PendingSessionNotifications.discardsStale}); its receipt says `"refused"`. `onUnkept` is told,
|
|
1134
|
+
* before that receipt, when the refusal is the one that keeps nothing: the box of a session seated nowhere here failed twice.
|
|
1055
1135
|
*/
|
|
1056
|
-
export declare function routeOrParkNotification(store: PendingSessionNotifications, address: SessionAddress, payload: TaskNotificationPayload, priority: SystemInjectionPriority, onDisposition?: (d: NotificationDisposition) => void): void;
|
|
1136
|
+
export declare function routeOrParkNotification(store: PendingSessionNotifications, address: SessionAddress, payload: TaskNotificationPayload, priority: SystemInjectionPriority, onDisposition?: (d: NotificationDisposition) => void, onUnkept?: () => void): void;
|
|
1057
1137
|
/**
|
|
1058
1138
|
* The durable form of a parked peer-words frame: the SAME `peer_message` record the cross-session lane
|
|
1059
1139
|
* appends (the recipient's drain renders it through the one envelope and judges it through the one
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
2
|
import { escapeEnvelopeTag, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
|
|
3
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
3
4
|
import { egressText } from "./untrusted-egress.js";
|
|
4
5
|
import { redactThenCut } from "../agents/subagent-steps.js";
|
|
5
6
|
import { PEER_MESSAGE_NOTICE } from "../agents/peer-admission.js";
|
|
@@ -18,8 +19,7 @@ export function isSystemInjectionPriority(value) {
|
|
|
18
19
|
function requireSystemInjectionPriority(value) {
|
|
19
20
|
if (isSystemInjectionPriority(value))
|
|
20
21
|
return value;
|
|
21
|
-
const
|
|
22
|
-
const refusal = new Error(`a steer priority must be one of ${SYSTEM_INJECTION_PRIORITIES.join("/")}, got ${shown}`);
|
|
22
|
+
const refusal = new Error(`a steer priority must be one of ${SYSTEM_INJECTION_PRIORITIES.join("/")}, got ${describeRejectedValue(value)}`);
|
|
23
23
|
refusal.code = "steering.invalid_content";
|
|
24
24
|
throw refusal;
|
|
25
25
|
}
|
|
@@ -77,6 +77,9 @@ export function taskNotificationDedupKey(n) {
|
|
|
77
77
|
const attempt = n.attempt !== undefined && Number.isInteger(n.attempt) && n.attempt > 1 ? `:a${n.attempt}` : "";
|
|
78
78
|
return `task_notification:${taskNotificationLaneKey(n)}:${n.status}${n.seq !== undefined ? `:${n.seq}` : ""}${attempt}`;
|
|
79
79
|
}
|
|
80
|
+
export function taskNotificationNoteOptions(payload) {
|
|
81
|
+
return { provenance: "engine-note", enginePayload: payload, engineNoteKey: taskNotificationDedupKey(payload) };
|
|
82
|
+
}
|
|
80
83
|
export function taskNotificationLaneKey(n) {
|
|
81
84
|
return n.task_type === "external" ? `external:${n.task_id}` : n.task_id;
|
|
82
85
|
}
|
|
@@ -286,6 +289,8 @@ function malformedFacet(f) {
|
|
|
286
289
|
return "spawnName outside the spawn-name grammar";
|
|
287
290
|
if (f["handback"] !== undefined && !(typeof f["handback"] === "string" && HANDBACK_STATES.includes(f["handback"])))
|
|
288
291
|
return "handback outside its closed set";
|
|
292
|
+
if (f["completionId"] !== undefined && !(typeof f["completionId"] === "string" && f["completionId"] !== ""))
|
|
293
|
+
return "completionId is not a non-empty string";
|
|
289
294
|
const steps = f["recentSteps"];
|
|
290
295
|
if (steps !== undefined && !(Array.isArray(steps) && steps.every((s) => s !== null && typeof s === "object" && typeof s.tool === "string" && typeof s.target === "string" && typeof s.outcome === "string")))
|
|
291
296
|
return "recentSteps is not a list of steps";
|
|
@@ -521,8 +526,10 @@ function addOccupantKey(held, address, dedupKey) {
|
|
|
521
526
|
export class PendingSessionNotifications {
|
|
522
527
|
sessions = new Map();
|
|
523
528
|
noticeSeat;
|
|
529
|
+
unseatedBoxSeat;
|
|
524
530
|
constructor(seats) {
|
|
525
531
|
this.noticeSeat = seats?.onNotice ?? (() => undefined);
|
|
532
|
+
this.unseatedBoxSeat = seats?.boxFor;
|
|
526
533
|
}
|
|
527
534
|
liveLanes = new SessionLiveNotificationLanes();
|
|
528
535
|
droppedSessions = 0;
|
|
@@ -551,7 +558,26 @@ export class PendingSessionNotifications {
|
|
|
551
558
|
}
|
|
552
559
|
sessionBoxFor(address) {
|
|
553
560
|
const seat = this.seats.get(address.sessionId);
|
|
554
|
-
|
|
561
|
+
if (seat !== undefined)
|
|
562
|
+
return sameOccupant(seat.occupant, address.occupant) ? seat.box : undefined;
|
|
563
|
+
const verdict = this.boxVerdictOf(address);
|
|
564
|
+
return verdict?.ok === true ? verdict.box : undefined;
|
|
565
|
+
}
|
|
566
|
+
holdsSeat(sessionId) {
|
|
567
|
+
return this.seats.has(sessionId);
|
|
568
|
+
}
|
|
569
|
+
boxVerdictOf(address) {
|
|
570
|
+
return address.scope !== undefined ? this.unseatedBoxSeat?.({ ...address, scope: address.scope }) : undefined;
|
|
571
|
+
}
|
|
572
|
+
completionLaneOf(address, unkept) {
|
|
573
|
+
const verdict = this.boxVerdictOf(address);
|
|
574
|
+
if (verdict === undefined)
|
|
575
|
+
return { ok: false, cause: { code: "no_root_scope" } };
|
|
576
|
+
if (!verdict.ok)
|
|
577
|
+
return verdict;
|
|
578
|
+
if (verdict.box.engineFrames !== true)
|
|
579
|
+
return { ok: false, cause: { code: "floor_off" } };
|
|
580
|
+
return { ok: true, sink: (n, o) => routeOrParkNotification(this, address, n, o?.priority ?? "next", undefined, unkept !== undefined ? () => unkept(n, o) : undefined) };
|
|
555
581
|
}
|
|
556
582
|
discardsStale(address, payload) {
|
|
557
583
|
const stale = this.staleAgainst(address);
|
|
@@ -772,7 +798,7 @@ export class DurableAppendObligations {
|
|
|
772
798
|
await Promise.allSettled([...this.inFlight]);
|
|
773
799
|
}
|
|
774
800
|
}
|
|
775
|
-
export function routeOrParkNotification(store, address, payload, priority, onDisposition) {
|
|
801
|
+
export function routeOrParkNotification(store, address, payload, priority, onDisposition, onUnkept) {
|
|
776
802
|
if (store.discardsStale(address, payload)) {
|
|
777
803
|
onDisposition?.("refused");
|
|
778
804
|
return;
|
|
@@ -805,8 +831,22 @@ export function routeOrParkNotification(store, address, payload, priority, onDis
|
|
|
805
831
|
}
|
|
806
832
|
return ask();
|
|
807
833
|
});
|
|
808
|
-
const settled = appended.then(() => onDisposition?.("parked_durably"), () => {
|
|
834
|
+
const settled = appended.then(() => onDisposition?.("parked_durably"), (second) => {
|
|
809
835
|
store.forgetDurablePark(address, dedupKey);
|
|
836
|
+
if (!store.holdsSeat(address.sessionId)) {
|
|
837
|
+
try {
|
|
838
|
+
box.onError?.(new Error(`the ${inlineUntrusted(String(payload.task_type), 40)} frame of task ${inlineUntrusted(String(payload.task_id), 120)} could not be written to session ${inlineUntrusted(address.sessionId, 120)}'s durable box (asked twice), and no leg of that session is seated on this runner to read a copy kept here: it was not kept`, { cause: second }));
|
|
839
|
+
}
|
|
840
|
+
catch {
|
|
841
|
+
}
|
|
842
|
+
try {
|
|
843
|
+
onUnkept?.();
|
|
844
|
+
}
|
|
845
|
+
catch {
|
|
846
|
+
}
|
|
847
|
+
onDisposition?.("refused");
|
|
848
|
+
return;
|
|
849
|
+
}
|
|
810
850
|
const parked = store.pend(address, payload, priority, { box, record });
|
|
811
851
|
onDisposition?.(parked ? "parked" : "refused");
|
|
812
852
|
});
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { type BackgroundAgentRecord, type BackgroundAgentStore } from "./background-agent-store.js";
|
|
2
|
-
import { type StopSource, type TaskAccess, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type BackgroundAgentTaskHandle, type ChildSessionStore, type RegisteredTaskHandle, type DurableAgentCore, type ParkedClaimTicket, type RegisterBackgroundAgentInput, type LandedAgentTerminal } from "./task-registry-shared.js";
|
|
2
|
+
import { type StopSource, type TaskAccess, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type BackgroundAgentTaskHandle, type ChildSessionStore, type RegisteredTaskHandle, type DurableAgentCore, type ParkedClaimTicket, type ParkedClaimRollback, type RegisterBackgroundAgentInput, type LandedAgentTerminal } from "./task-registry-shared.js";
|
|
3
3
|
import type { ExtensionRequester } from "./task-event.js";
|
|
4
4
|
import { type AgentState } from "./agent-state.js";
|
|
5
5
|
import type { CheckpointSeat } from "./checkpoint-seat.js";
|
|
@@ -27,6 +27,15 @@ export interface DelegationOccupant {
|
|
|
27
27
|
/** The rows {@link activeDelegationHandlesLane} counts, with the name each is addressed by — the one selection, read in the same
|
|
28
28
|
* synchronous segment. `caller` is the access the asking leg's own tools hold (`scope` is the pool's); without one no row is reachable. */
|
|
29
29
|
export declare function activeDelegationOccupantsLane(core: DurableAgentCore, scope: string, rootSessionId: string, caller?: TaskAccess): DelegationOccupant[];
|
|
30
|
+
/** Where one active row of a delegation tree lives: its task id and the scope it is registered in. */
|
|
31
|
+
export interface DelegationRowAddress {
|
|
32
|
+
readonly handle: string;
|
|
33
|
+
readonly scope: string;
|
|
34
|
+
}
|
|
35
|
+
/** The ACTIVE (running / pending) rows of one delegation tree in THIS process, in EVERY scope — the live twin of
|
|
36
|
+
* `BackgroundAgentStore.listByRoot`: the same tree reading ({@link delegationRootOf}) and the same root judge
|
|
37
|
+
* ({@link assertDelegationRoot}), each row with the scope a follow-up addresses it in. */
|
|
38
|
+
export declare function activeDelegationHandlesByRootLane(core: DurableAgentCore, rootSessionId: string): DelegationRowAddress[];
|
|
30
39
|
export declare function ensureDurableHeartbeatLane(core: DurableAgentCore): void;
|
|
31
40
|
/** design/151 S1a — enqueue one durable-row write (see {@link DurableAgentLane} for the lane
|
|
32
41
|
* contract). `patch` is captured at CALL time (the settle-site values), applied in chain order.
|
|
@@ -268,7 +277,7 @@ export declare function claimParkedAgentLane(stores: {
|
|
|
268
277
|
export declare function rollbackParkedClaimLane(core: DurableAgentCore, stores: {
|
|
269
278
|
agentStore: import("./background-agent-store.js").BackgroundAgentStore;
|
|
270
279
|
checkpointStore: Pick<import("./checkpoint-store.js").CheckpointStore, "get">;
|
|
271
|
-
}, ticket: ParkedClaimTicket): Promise<
|
|
280
|
+
}, ticket: ParkedClaimTicket): Promise<ParkedClaimRollback>;
|
|
272
281
|
/**
|
|
273
282
|
* design/153 §7.2d (件3c 3c H-1) — the CONSUME FLIP, SERIALIZED THROUGH THE DURABLE LANE:
|
|
274
283
|
* the guarded parked→running store CAS runs INSIDE the lane chain (ordered after every seeded
|
|
@@ -431,9 +440,12 @@ export declare function settleRevivedAgentLane(core: DurableAgentCore, id: strin
|
|
|
431
440
|
* through a two-hour job looked exactly like one whose lane died. This is that signal — the same
|
|
432
441
|
* tool-lifecycle beat the fleet view already samples, recorded on the row.
|
|
433
442
|
*
|
|
434
|
-
* Cheap and idempotent: a timestamp write on a running row, no-op for anything else.
|
|
443
|
+
* Cheap and idempotent: a timestamp write on a running row, no-op for anything else. The row's silence is read on the process-monotonic
|
|
444
|
+
* clock, so the beat records that clock (`atMono`, `performance.now()` milliseconds; default now) beside the wall-clock `updatedAt`. An instant
|
|
445
|
+
* that is no reading of this process's clock (negative, non-finite, or past its now by more than a second) is refused, whatever the row;
|
|
446
|
+
* one earlier than the row's stamp does not take the stamp back ({@link stampActivity}).
|
|
435
447
|
*/
|
|
436
|
-
export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore, id: string,
|
|
448
|
+
export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore, id: string, atMono?: number): void;
|
|
437
449
|
/**
|
|
438
450
|
* design/164 — collect SESSION-SCOPED background agents that have gone SILENT, the replacement for the
|
|
439
451
|
* retired 30-minute wall-clock ceiling on that lane.
|
|
@@ -444,11 +456,16 @@ export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore,
|
|
|
444
456
|
* (`maxAgeMs` / `keep` / `staleRunningMaxAgeMs` are all caller-supplied). Size it well above the child's
|
|
445
457
|
* expected quiet stretches; the durable twin's guidance (≥10× the heartbeat) is the reference point.
|
|
446
458
|
*
|
|
459
|
+
* Silence is measured on the PROCESS-MONOTONIC clock (`lastActivityMono`, `nowMono` = `performance.now()` milliseconds): a wall-clock
|
|
460
|
+
* step — an NTP correction, a manual change — or a machine that slept would otherwise read as silence on one row and hide it on
|
|
461
|
+
* another. `updatedAt` stays the displayed wall instant. The durable sweep (`staleRunningMaxAgeMs`) is a different question — a row
|
|
462
|
+
* another process wrote — and stays on the wall clock, which is the only one two processes share.
|
|
463
|
+
*
|
|
447
464
|
* A collected row is settled `killed` with attribution `"system"` and the SAME wording the durable
|
|
448
465
|
* stale-running sweep writes, so an operator reading either face sees one explanation, and its run is
|
|
449
466
|
* aborted. Returns how many rows were collected.
|
|
450
467
|
*/
|
|
451
|
-
export declare function reapStaleSessionBackgroundAgentsLane(core: DurableAgentCore, staleMs: number,
|
|
468
|
+
export declare function reapStaleSessionBackgroundAgentsLane(core: DurableAgentCore, staleMs: number, nowMono?: number): number;
|
|
452
469
|
/**
|
|
453
470
|
* THE announcement of a background agent's terminal the REGISTRY landed without the cycle's attempt — the session or stale
|
|
454
471
|
* reap of a running cycle (its attempt's unwind would report only once the in-flight tool honored the abort), a TaskStop
|
|
@@ -578,7 +595,7 @@ export declare function serveDurableAgentRowLane(row: BackgroundAgentRecord,
|
|
|
578
595
|
* carried as `details.agentState`. Absent ⇒ neither appears (a serving layer that does not read it). */
|
|
579
596
|
agentState?: AgentState): UnifiedTaskResult;
|
|
580
597
|
export declare function pollBackgroundAgentLane(handle: BackgroundAgentTaskHandle, deadline?: number, signal?: AbortSignal,
|
|
581
|
-
/** The run's checkpoint seat — the store a parked row's
|
|
582
|
-
* ({@link import("./agent-state.js").readAgentState}). Absent ⇒ a parked row reads `
|
|
598
|
+
/** The run's checkpoint seat — the store a parked row's park card is read from
|
|
599
|
+
* ({@link import("./agent-state.js").readAgentState}). Absent ⇒ a parked row reads `park unreadable`. */
|
|
583
600
|
checkpointSeat?: CheckpointSeat): Promise<UnifiedTaskResult>;
|
|
584
601
|
export declare function stopBackgroundAgentLane(core: DurableAgentCore, handle: BackgroundAgentTaskHandle): Promise<UnifiedTaskResult>;
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import { randomBytes } from "node:crypto";
|
|
2
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
3
|
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
|
-
import {
|
|
4
|
-
import { BACKGROUND_AGENT_REAP_KNOBS, canAccessAgentRecord, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
|
|
4
|
+
import { commitCompletionIdIfEmpty, completionIdCandidate, mintCompletionId } from "./completion-id.js";
|
|
5
|
+
import { assertDelegationRoot, BACKGROUND_AGENT_REAP_KNOBS, canAccessAgentRecord, delegationRootOf, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
|
|
5
6
|
import { shutdownDebug } from "./shutdown-debug.js";
|
|
6
7
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
7
8
|
import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
8
|
-
import {
|
|
9
|
+
import { clipTaskOutput, assertOwnership, sleepPollStep, alreadyTerminalStopNote, canAccess, isLiveSessionResidentAgent, normalizeAgentName, engineAgentName, chosenAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, activityStamp, isActivityInstant, monotonicNow, stampActivity, } from "./task-registry-shared.js";
|
|
9
10
|
import { thrownLabel } from "./thrown-value.js";
|
|
10
11
|
import { readExtensionRequester } from "./extension-requester.js";
|
|
11
12
|
import { closestName } from "./closest-name.js";
|
|
@@ -14,20 +15,34 @@ export function activeDelegationHandlesLane(core, scope, rootSessionId) {
|
|
|
14
15
|
return activeDelegationOccupantsLane(core, scope, rootSessionId).map((o) => o.id);
|
|
15
16
|
}
|
|
16
17
|
export function activeDelegationOccupantsLane(core, scope, rootSessionId, caller) {
|
|
18
|
+
const out = [];
|
|
19
|
+
for (const bh of activeDelegationTreeLane(core, rootSessionId)) {
|
|
20
|
+
if (bh.scope !== scope)
|
|
21
|
+
continue;
|
|
22
|
+
const requestedBy = readExtensionRequester(bh.requestedBy);
|
|
23
|
+
out.push({ id: bh.id, name: bh.name, ...(requestedBy !== undefined ? { requestedBy } : {}), reachable: caller !== undefined && canAccess(bh, { ...caller, scope }) });
|
|
24
|
+
}
|
|
25
|
+
return out;
|
|
26
|
+
}
|
|
27
|
+
export function activeDelegationHandlesByRootLane(core, rootSessionId) {
|
|
28
|
+
assertDelegationRoot(rootSessionId);
|
|
29
|
+
const out = [];
|
|
30
|
+
for (const bh of activeDelegationTreeLane(core, rootSessionId)) {
|
|
31
|
+
if (bh.scope !== undefined)
|
|
32
|
+
out.push({ handle: bh.id, scope: bh.scope });
|
|
33
|
+
}
|
|
34
|
+
return out;
|
|
35
|
+
}
|
|
36
|
+
function activeDelegationTreeLane(core, rootSessionId) {
|
|
17
37
|
const out = [];
|
|
18
38
|
for (const h of core.handles.values()) {
|
|
19
39
|
if (h.type !== "background_agent")
|
|
20
40
|
continue;
|
|
21
41
|
if (h.status !== "running" && h.status !== "pending")
|
|
22
42
|
continue;
|
|
23
|
-
if (h.scope !== scope)
|
|
24
|
-
continue;
|
|
25
43
|
const bh = h;
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
continue;
|
|
29
|
-
const requestedBy = readExtensionRequester(bh.requestedBy);
|
|
30
|
-
out.push({ id: h.id, name: bh.name, ...(requestedBy !== undefined ? { requestedBy } : {}), reachable: caller !== undefined && canAccess(h, { ...caller, scope }) });
|
|
44
|
+
if (delegationRootOf(bh) === rootSessionId)
|
|
45
|
+
out.push(bh);
|
|
31
46
|
}
|
|
32
47
|
return out;
|
|
33
48
|
}
|
|
@@ -195,7 +210,7 @@ export async function reapDurableAgentsLane(core, scope, deps, policy) {
|
|
|
195
210
|
}
|
|
196
211
|
if (knobs.maxAgeMs === undefined && knobs.keep === undefined)
|
|
197
212
|
return { rowsReaped: 0, sessionsReleased: 0, skippedNoSessions: 0, orphanPlacedReleased: 0 };
|
|
198
|
-
const terminal = (await deps.store.listByScope(scope)).filter((r) => r.status !== "running" && r.status !== "parked");
|
|
213
|
+
const terminal = (await deps.store.listByScope(scope)).filter((r) => !("rowVerdict" in r) && r.status !== "running" && r.status !== "parked");
|
|
199
214
|
terminal.sort((a, b) => b.spawnedAt - a.spawnedAt);
|
|
200
215
|
const doomed = new Map();
|
|
201
216
|
if (knobs.maxAgeMs !== undefined) {
|
|
@@ -394,7 +409,7 @@ export function registerBackgroundAgentLane(core, input) {
|
|
|
394
409
|
throw new Error(`TaskRegistry: task id already registered: ${id}`);
|
|
395
410
|
const now = input.now ?? Date.now();
|
|
396
411
|
if (input.name !== undefined && (typeof input.name !== "string" || input.name === "")) {
|
|
397
|
-
throw new Error(`TaskRegistry: background-agent name must be a non-empty string (got ${
|
|
412
|
+
throw new Error(`TaskRegistry: background-agent name must be a non-empty string (got ${describeRejectedValue(input.name)}); omit it to take the derived one`);
|
|
398
413
|
}
|
|
399
414
|
const name = input.name ?? engineAgentName(id);
|
|
400
415
|
const requestedBy = readExtensionRequester(input.requestedBy);
|
|
@@ -421,8 +436,9 @@ export function registerBackgroundAgentLane(core, input) {
|
|
|
421
436
|
...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}),
|
|
422
437
|
cycleSeq: input.durableSeed !== undefined ? (input.durableSeed.record.seq ?? 1) : 1,
|
|
423
438
|
createdAt: now,
|
|
424
|
-
|
|
439
|
+
...activityStamp(now),
|
|
425
440
|
abort: input.abort,
|
|
441
|
+
yieldSeat: { lane: input.yieldLane ?? "no_park_lane" },
|
|
426
442
|
});
|
|
427
443
|
if (input.store) {
|
|
428
444
|
const handle = core.handles.get(id);
|
|
@@ -451,6 +467,7 @@ export function registerBackgroundAgentLane(core, input) {
|
|
|
451
467
|
...(input.parentSessionId !== undefined ? { parentSessionId: input.parentSessionId } : {}),
|
|
452
468
|
...(input.rootSessionId !== undefined ? { rootSessionId: input.rootSessionId } : {}),
|
|
453
469
|
...(input.rootSessionId !== undefined && input.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: input.rootSessionIncarnation } : {}),
|
|
470
|
+
...(input.rootSessionId !== undefined && input.rootSessionScope !== undefined ? { rootSessionScope: input.rootSessionScope } : {}),
|
|
454
471
|
...(input.parentTaskId !== undefined ? { parentTaskId: input.parentTaskId } : {}),
|
|
455
472
|
name,
|
|
456
473
|
...(input.agentType !== undefined ? { agentType: input.agentType } : {}),
|
|
@@ -492,7 +509,7 @@ export function parkBackgroundAgentLane(core, id, park) {
|
|
|
492
509
|
for (const r of [...(handle.inFlightDirect ?? [])])
|
|
493
510
|
r({ ok: false, reason: "not_running" });
|
|
494
511
|
handle.inFlightDirect = undefined;
|
|
495
|
-
handle
|
|
512
|
+
stampActivity(handle);
|
|
496
513
|
if (park.seq !== undefined)
|
|
497
514
|
handle.cycleSeq = park.seq;
|
|
498
515
|
core.pokeBgQuiescence(handle.owner);
|
|
@@ -560,7 +577,7 @@ export async function reconcileParkedAgentsLane(core, stores, scope, now, opts)
|
|
|
560
577
|
held.error = error;
|
|
561
578
|
held.parkedCheckpointToken = undefined;
|
|
562
579
|
held.resolveParkedStop = undefined;
|
|
563
|
-
held
|
|
580
|
+
stampActivity(held, now);
|
|
564
581
|
mintCompletionId(held);
|
|
565
582
|
core.pokeBgQuiescence(held.owner);
|
|
566
583
|
announceParkedEnding(core, held, { status: "failed", error });
|
|
@@ -639,7 +656,7 @@ export async function rollbackParkedClaimLane(core, stores, ticket) {
|
|
|
639
656
|
return "retry";
|
|
640
657
|
}
|
|
641
658
|
const now = Date.now();
|
|
642
|
-
const rollbackCompletionIdCandidate =
|
|
659
|
+
const rollbackCompletionIdCandidate = completionIdCandidate();
|
|
643
660
|
const settleLocalParkedHandle = (error) => {
|
|
644
661
|
const h = core.handles.get(ticket.handle);
|
|
645
662
|
if (h !== undefined && h.type === "background_agent" && h.status === "parked") {
|
|
@@ -649,7 +666,7 @@ export async function rollbackParkedClaimLane(core, stores, ticket) {
|
|
|
649
666
|
h.resolveParkedStop = undefined;
|
|
650
667
|
h.parkedCompletionSink = undefined;
|
|
651
668
|
h.terminalNotifier = undefined;
|
|
652
|
-
h
|
|
669
|
+
stampActivity(h, now);
|
|
653
670
|
commitCompletionIdIfEmpty(h, rollbackCompletionIdCandidate);
|
|
654
671
|
core.pokeBgQuiescence(h.owner);
|
|
655
672
|
}
|
|
@@ -803,7 +820,7 @@ export async function consumeParkedFlipLane(core, id, stores, ticket) {
|
|
|
803
820
|
handle.parkedCheckpointToken = undefined;
|
|
804
821
|
handle.resolveParkedStop = undefined;
|
|
805
822
|
handle.parkedCompletionSink = undefined;
|
|
806
|
-
handle
|
|
823
|
+
stampActivity(handle);
|
|
807
824
|
handle.completionId = undefined;
|
|
808
825
|
handle.terminalNotified = undefined;
|
|
809
826
|
if (flipped.seq !== undefined)
|
|
@@ -841,7 +858,7 @@ export function settleBackgroundAgentLane(core, id, outcome) {
|
|
|
841
858
|
backfilled = true;
|
|
842
859
|
}
|
|
843
860
|
if (backfilled) {
|
|
844
|
-
handle
|
|
861
|
+
stampActivity(handle);
|
|
845
862
|
durableAgentWriteLane(handle, {
|
|
846
863
|
...(handle.result !== undefined ? { finalOutput: handle.result } : {}),
|
|
847
864
|
...(handle.resultFull !== undefined ? { finalOutputFull: handle.resultFull } : {}),
|
|
@@ -884,7 +901,7 @@ export function settleBackgroundAgentLane(core, id, outcome) {
|
|
|
884
901
|
if (outcome.retryAfterMs !== undefined)
|
|
885
902
|
handle.errorRetryAfterMs = outcome.retryAfterMs;
|
|
886
903
|
}
|
|
887
|
-
handle
|
|
904
|
+
stampActivity(handle);
|
|
888
905
|
if (outcome.seq !== undefined)
|
|
889
906
|
handle.cycleSeq = outcome.seq;
|
|
890
907
|
core.pokeBgQuiescence(handle.owner);
|
|
@@ -1139,9 +1156,10 @@ export async function reviveBackgroundAgentLane(core, id, access, abort) {
|
|
|
1139
1156
|
handle.stoppedBy = undefined;
|
|
1140
1157
|
handle.completionId = undefined;
|
|
1141
1158
|
handle.terminalNotified = undefined;
|
|
1159
|
+
handle.yieldSeat = { lane: "no_park_lane" };
|
|
1142
1160
|
handle.reviveCycle = (handle.reviveCycle ?? 0) + 1;
|
|
1143
1161
|
handle.cycleSeq = (handle.cycleSeq ?? 1) + 1;
|
|
1144
|
-
handle
|
|
1162
|
+
stampActivity(handle);
|
|
1145
1163
|
if (plainDurableWrite)
|
|
1146
1164
|
durableAgentWriteLane(handle, { status: "running" }, REVIVED_ROW_CLEARED_FIELDS);
|
|
1147
1165
|
return { ok: true, cycle: handle.reviveCycle };
|
|
@@ -1149,21 +1167,26 @@ export async function reviveBackgroundAgentLane(core, id, access, abort) {
|
|
|
1149
1167
|
export function settleRevivedAgentLane(core, id, cycle, outcome) {
|
|
1150
1168
|
return settleBackgroundAgentLane(core, id, { ...outcome, cycle });
|
|
1151
1169
|
}
|
|
1152
|
-
export function noteBackgroundAgentActivityLane(core, id,
|
|
1170
|
+
export function noteBackgroundAgentActivityLane(core, id, atMono = monotonicNow()) {
|
|
1171
|
+
if (!isActivityInstant(atMono))
|
|
1172
|
+
throw new Error(`noteBackgroundAgentActivity: the instant must be a finite monotonic reading in milliseconds, from 0 to this process's clock (got ${String(atMono)})`);
|
|
1153
1173
|
const handle = core.handles.get(id);
|
|
1154
1174
|
if (!handle || handle.type !== "background_agent" || handle.status !== "running")
|
|
1155
1175
|
return;
|
|
1156
|
-
handle.
|
|
1176
|
+
stampActivity(handle, Date.now(), atMono);
|
|
1157
1177
|
}
|
|
1158
|
-
export function reapStaleSessionBackgroundAgentsLane(core, staleMs,
|
|
1178
|
+
export function reapStaleSessionBackgroundAgentsLane(core, staleMs, nowMono = monotonicNow()) {
|
|
1159
1179
|
if (!Number.isFinite(staleMs) || staleMs <= 0) {
|
|
1160
1180
|
throw new Error(`reapStaleSessionBackgroundAgents: staleMs must be a positive finite number of milliseconds (got ${String(staleMs)})`);
|
|
1161
1181
|
}
|
|
1182
|
+
if (!Number.isFinite(nowMono)) {
|
|
1183
|
+
throw new Error(`reapStaleSessionBackgroundAgents: the instant must be a finite monotonic reading in milliseconds (got ${String(nowMono)})`);
|
|
1184
|
+
}
|
|
1162
1185
|
let reaped = 0;
|
|
1163
1186
|
for (const handle of core.handles.values()) {
|
|
1164
|
-
if (handle
|
|
1187
|
+
if (!isLiveSessionResidentAgent(handle))
|
|
1165
1188
|
continue;
|
|
1166
|
-
if (
|
|
1189
|
+
if (nowMono - handle.lastActivityMono <= staleMs)
|
|
1167
1190
|
continue;
|
|
1168
1191
|
core.markStopSource(handle.id, "system");
|
|
1169
1192
|
const reapTerminalNote = handle.terminalNotifier;
|
|
@@ -1496,7 +1519,7 @@ export async function stopBackgroundAgentLane(core, handle) {
|
|
|
1496
1519
|
core.markStopSource(handle.id, "parent");
|
|
1497
1520
|
handle.status = "killed";
|
|
1498
1521
|
handle.stoppedBy = handle.stopSource ?? "parent";
|
|
1499
|
-
handle
|
|
1522
|
+
stampActivity(handle);
|
|
1500
1523
|
mintCompletionId(handle);
|
|
1501
1524
|
handle.parkedCheckpointToken = undefined;
|
|
1502
1525
|
handle.resolveParkedStop = undefined;
|
|
@@ -1561,7 +1584,7 @@ export async function stopBackgroundAgentLane(core, handle) {
|
|
|
1561
1584
|
handle.abort.abort();
|
|
1562
1585
|
handle.status = "killed";
|
|
1563
1586
|
handle.stoppedBy = handle.stopSource ?? "parent";
|
|
1564
|
-
handle
|
|
1587
|
+
stampActivity(handle);
|
|
1565
1588
|
mintCompletionId(handle);
|
|
1566
1589
|
handle.notify = undefined;
|
|
1567
1590
|
for (const [, , qResolve] of handle.preAttachQueue ?? [])
|