@sema-agent/core 7.66.1 → 7.67.1
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 +3518 -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 +169 -0
- package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
- package/dist/core/roles.js +148 -21
- 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 +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
- package/dist/index.js +45 -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 +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -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,7 +1,9 @@
|
|
|
1
1
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
2
2
|
import { envDeclaresRetain, retainsBackgroundProcesses } from "./background-shell.js";
|
|
3
|
-
import {
|
|
3
|
+
import { mintCompletionId } from "./completion-id.js";
|
|
4
|
+
import { assertOwnership, defaultMonitorTimers, MONITOR_MAX_TIMEOUT_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_BATCH_WINDOW_MS, MONITOR_MAX_BATCHES_PER_MINUTE, MONITOR_STORM_BURST, MONITOR_STORM_KILL_AFTER_MS, MONITOR_LINE_BUF_CAP, TASK_OUTPUT_MAX_CHARS, clipMonitorEvent, clipMonitorLine, terminalTaskSummary, accountDroppedBytes, dropFactsOf, renderSpoolBody, SPOOL_REPLAY, rollSpoolText, statusFromBackground, droppedGapNote, firstDropNote, alreadyTerminalStopNote, clipTaskOutput, sleepPollStep, activityStamp, stampActivity, } from "./task-registry-shared.js";
|
|
4
5
|
import { thrownText } from "./thrown-value.js";
|
|
6
|
+
import { envErrorDetail } from "../tools/fs/env-error-detail.js";
|
|
5
7
|
export function registerMonitorLane(core, input) {
|
|
6
8
|
assertOwnership(input, "registerMonitor");
|
|
7
9
|
const id = core.mintTaskId("monitor");
|
|
@@ -24,7 +26,7 @@ export function registerMonitorLane(core, input) {
|
|
|
24
26
|
...(persistent ? { persistent: true } : {}),
|
|
25
27
|
...(input.sessionScoped ? { sessionScoped: true } : {}),
|
|
26
28
|
createdAt: now,
|
|
27
|
-
|
|
29
|
+
...activityStamp(now),
|
|
28
30
|
env: input.env,
|
|
29
31
|
shellId: input.shellId,
|
|
30
32
|
spool: { stdout: "", stderr: "", rolledChars: 0 },
|
|
@@ -119,7 +121,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
119
121
|
};
|
|
120
122
|
const pendingSuppressionNote = () => consumePendingSuppressionNote(handle);
|
|
121
123
|
const terminal = (status, detail, finalLines, exitCode) => {
|
|
122
|
-
handle
|
|
124
|
+
stampActivity(handle);
|
|
123
125
|
mintCompletionId(handle);
|
|
124
126
|
stop();
|
|
125
127
|
core.notifyTerminalOnce(handle, () => emit({
|
|
@@ -151,7 +153,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
151
153
|
if ((r.error.code === "timeout" || r.error.code === "io") && ++pollFailures <= MAX_RETRYABLE_POLL_FAILURES)
|
|
152
154
|
return;
|
|
153
155
|
handle.status = "failed";
|
|
154
|
-
return terminal("failed", `monitor lost its process (${r.error.message}); watch ended.${pendingSuppressionNote()}`, pendingFinalLines([]));
|
|
156
|
+
return terminal("failed", `monitor lost its process (${envErrorDetail(r.error.message)}); watch ended.${pendingSuppressionNote()}`, pendingFinalLines([]));
|
|
155
157
|
}
|
|
156
158
|
pollFailures = 0;
|
|
157
159
|
const mirrored = mirrorMonitorPollLane(handle, r.value);
|
|
@@ -187,7 +189,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
187
189
|
return stop();
|
|
188
190
|
if (!k.ok && k.error.code !== "not_found") {
|
|
189
191
|
handle.status = "failed";
|
|
190
|
-
return terminal("failed", `timed out after ${handle.timeoutMs}ms, but the kill failed (${k.error.message}); the process may still be running. Watch ended.${pendingSuppressionNote()}`, pendingFinalLines(lines));
|
|
192
|
+
return terminal("failed", `timed out after ${handle.timeoutMs}ms, but the kill failed (${envErrorDetail(k.error.message)}); the process may still be running. Watch ended.${pendingSuppressionNote()}`, pendingFinalLines(lines));
|
|
191
193
|
}
|
|
192
194
|
handle.status = "killed";
|
|
193
195
|
handle.stoppedBy = handle.stopSource ?? "timeout";
|
|
@@ -195,7 +197,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
195
197
|
}
|
|
196
198
|
if (lines.length === 0) {
|
|
197
199
|
if (r.value.stdout.length > 0 || r.value.stderr.length > 0)
|
|
198
|
-
handle
|
|
200
|
+
stampActivity(handle);
|
|
199
201
|
return;
|
|
200
202
|
}
|
|
201
203
|
if (!consumeStormToken(handle, now)) {
|
|
@@ -208,7 +210,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
208
210
|
else {
|
|
209
211
|
handle.overloadSince ??= now;
|
|
210
212
|
}
|
|
211
|
-
handle
|
|
213
|
+
stampActivity(handle);
|
|
212
214
|
if (now - handle.overloadSince <= MONITOR_STORM_KILL_AFTER_MS)
|
|
213
215
|
return;
|
|
214
216
|
const suppressed = handle.suppressedBatches;
|
|
@@ -219,7 +221,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
219
221
|
return stop();
|
|
220
222
|
if (!k.ok && k.error.code !== "not_found") {
|
|
221
223
|
handle.status = "failed";
|
|
222
|
-
return terminal("failed", `auto-stop triggered (${suppressed} event batch(es) suppressed over ${overloadSecs}s of sustained overload), but the kill failed (${k.error.message}); the process may still be running. Watch ended.`, pendingFinalLines(lines));
|
|
224
|
+
return terminal("failed", `auto-stop triggered (${suppressed} event batch(es) suppressed over ${overloadSecs}s of sustained overload), but the kill failed (${envErrorDetail(k.error.message)}); the process may still be running. Watch ended.`, pendingFinalLines(lines));
|
|
223
225
|
}
|
|
224
226
|
handle.status = "killed";
|
|
225
227
|
handle.stoppedBy = handle.stopSource ?? "system";
|
|
@@ -244,7 +246,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
244
246
|
});
|
|
245
247
|
}
|
|
246
248
|
handle.seq += 1;
|
|
247
|
-
handle
|
|
249
|
+
stampActivity(handle);
|
|
248
250
|
const shown = lines.map(clipMonitorLine);
|
|
249
251
|
emit({
|
|
250
252
|
task_id: id,
|
|
@@ -312,7 +314,7 @@ export async function pollMonitorLane(handle, filter, deadline, signal) {
|
|
|
312
314
|
status: running ? "running" : handle.status,
|
|
313
315
|
exitCode: spool.exitCode,
|
|
314
316
|
replay: SPOOL_REPLAY,
|
|
315
|
-
...(spool
|
|
317
|
+
...dropFactsOf(spool),
|
|
316
318
|
...(spool.timedOut === true ? { timedOut: true, ...(spool.timeoutSec !== undefined ? { timeoutSec: spool.timeoutSec } : {}) } : {}),
|
|
317
319
|
},
|
|
318
320
|
},
|
|
@@ -365,7 +367,7 @@ export async function stopMonitorLane(core, handle) {
|
|
|
365
367
|
handle.lineBuf = "";
|
|
366
368
|
if (finalLines.length > 0 && handle.status === "running") {
|
|
367
369
|
handle.seq += 1;
|
|
368
|
-
handle
|
|
370
|
+
stampActivity(handle);
|
|
369
371
|
emitMonitorEventLane(handle, {
|
|
370
372
|
task_id: handle.id,
|
|
371
373
|
task_type: "monitor",
|
|
@@ -410,7 +412,7 @@ export async function stopMonitorLane(core, handle) {
|
|
|
410
412
|
if (handle.stoppedBy === undefined)
|
|
411
413
|
handle.stoppedBy = handle.stopSource ?? "parent";
|
|
412
414
|
handle.status = "killed";
|
|
413
|
-
handle
|
|
415
|
+
stampActivity(handle);
|
|
414
416
|
mintCompletionId(handle);
|
|
415
417
|
core.notifyTerminalOnce(handle, () => explicitStopTerminalNote(handle, true));
|
|
416
418
|
return {
|
|
@@ -429,7 +431,7 @@ export async function stopMonitorLane(core, handle) {
|
|
|
429
431
|
startMonitorWatcherLane(core, handle.id);
|
|
430
432
|
const retrieval_status = r.error.code === "timeout" ? "timeout" : "not_ready";
|
|
431
433
|
return {
|
|
432
|
-
content: `Error (TaskStop): ${r.error.message} — the kill did not land; the process may still be running. The watch keeps running: events and the terminal notification still fire.`,
|
|
434
|
+
content: `Error (TaskStop): ${envErrorDetail(r.error.message)} — the kill did not land; the process may still be running. The watch keeps running: events and the terminal notification still fire.`,
|
|
433
435
|
isError: true,
|
|
434
436
|
details: { task_id: handle.id, type: "monitor", status: handle.status, retrieval_status, error: r.error.code },
|
|
435
437
|
};
|
|
@@ -438,7 +440,7 @@ export async function stopMonitorLane(core, handle) {
|
|
|
438
440
|
if (handle.stoppedBy === undefined)
|
|
439
441
|
handle.stoppedBy = handle.stopSource ?? "parent";
|
|
440
442
|
handle.status = "killed";
|
|
441
|
-
handle
|
|
443
|
+
stampActivity(handle);
|
|
442
444
|
mintCompletionId(handle);
|
|
443
445
|
core.notifyTerminalOnce(handle, () => explicitStopTerminalNote(handle, false));
|
|
444
446
|
}
|
|
@@ -17,7 +17,8 @@ export type SemaTaskType = "background_bash" | "workflow" | "background_agent" |
|
|
|
17
17
|
* task-notification.ts `TaskNotificationPayload.stoppedBy`. */
|
|
18
18
|
export type StopSource = "user" | "parent" | "system" | (string & {});
|
|
19
19
|
/** design/153 §7.1: `"parked"` (background agents only today) = durably suspended on a pending
|
|
20
|
-
*
|
|
20
|
+
* checkpoint (any gate — a person's approval, or a resource limit such as a scheduler's yield; the gate is the
|
|
21
|
+
* checkpoint's, never the row's) — neither live nor terminal. Every `=== "running"` liveness check treats it
|
|
21
22
|
* as not-running (correct: no process exists); it exits poll waits, refuses settles, and is
|
|
22
23
|
* reap-exempt. Downstream switches over this union gain an arm (announced). */
|
|
23
24
|
export type SemaTaskStatus = "pending" | "running" | "parked" | "completed" | "failed" | "killed" | "cancelled";
|
|
@@ -68,12 +69,13 @@ export interface UnifiedTaskOutput {
|
|
|
68
69
|
* this poll projection) — a consumer today has to reconstruct "are these the same completion?" from
|
|
69
70
|
* weaker signals (task_id + status + timing). Minted ONCE per completion, fill-once (first writer
|
|
70
71
|
* wins) on the handle/record the completion is settled onto, so every read face — this poll
|
|
71
|
-
* projection, the notification payload, and
|
|
72
|
-
* fallback row — serves the exact same
|
|
72
|
+
* projection, the notification payload, both registry listings (`TaskListRow`, and for background_agent the
|
|
73
|
+
* durable `BackgroundAgentRowSummary`), and the cross-restart durable fallback row — serves the exact same
|
|
74
|
+
* value. Open-shape `string` (a uuidv7 in this implementation,
|
|
73
75
|
* not contractually required to stay one); absent when the underlying task hasn't reached a terminal
|
|
74
76
|
* settle yet, or on a pre-P1-3 core build that never minted one. */
|
|
75
77
|
completionId?: string;
|
|
76
|
-
/** A background agent's current state (status word, last activity, the
|
|
78
|
+
/** A background agent's current state (status word, last activity, the park card a parked row
|
|
77
79
|
* waits on) — {@link import("./agent-state.js").readAgentState}, the one reading AgentTranscript and
|
|
78
80
|
* ListAgents render too. Present on every background_agent POLL answer that resolved a row (live,
|
|
79
81
|
* durable terminal, durable parked, durable still-running); absent on other lanes, on not-found, and on
|
|
@@ -97,6 +99,27 @@ export type UnifiedTaskResult = {
|
|
|
97
99
|
details: UnifiedTaskOutput;
|
|
98
100
|
isError?: boolean;
|
|
99
101
|
};
|
|
102
|
+
/** The process-monotonic clock a row's activity is measured on (`performance.now()`, milliseconds): it never steps back and does not
|
|
103
|
+
* jump with the wall clock. The one reading of it for the task rows — a stamp, a silence test and a test's injected instant all
|
|
104
|
+
* name this clock. */
|
|
105
|
+
export declare function monotonicNow(): number;
|
|
106
|
+
/** How far past this process's monotonic clock an injected activity instant may read. A beat is stamped at the instant its caller
|
|
107
|
+
* read the clock, which is never after the reader's own read; the slack is the one tolerance a reading is allowed. */
|
|
108
|
+
export declare const ACTIVITY_INSTANT_SLACK_MS = 1000;
|
|
109
|
+
/** Is `at` a reading of this process's monotonic clock a beat may carry: a finite number of milliseconds from 0 to the clock's
|
|
110
|
+
* own now (plus {@link ACTIVITY_INSTANT_SLACK_MS}). The one judge of an injected activity instant — a negative or a far-future
|
|
111
|
+
* value would otherwise be written as the row's stamp (a future one is never past the silence threshold again). */
|
|
112
|
+
export declare function isActivityInstant(at: unknown, now?: number): at is number;
|
|
113
|
+
/** The two activity facts of a row as a pair, for a row being BORN (an object literal cannot call {@link stampActivity}): the wall
|
|
114
|
+
* instant given (default now) and the monotonic one now. */
|
|
115
|
+
export declare function activityStamp(wall?: number): {
|
|
116
|
+
readonly updatedAt: number;
|
|
117
|
+
readonly lastActivityMono: number;
|
|
118
|
+
};
|
|
119
|
+
/** THE bump of a row's activity: `updatedAt` and `lastActivityMono` move together, here and nowhere else (both are `readonly` on the
|
|
120
|
+
* handle, so a direct write is a compile error). The monotonic fact never goes back: it is the later of what the row holds and
|
|
121
|
+
* the instant given. */
|
|
122
|
+
export declare function stampActivity(handle: SemaTaskHandle, wall?: number, mono?: number): void;
|
|
100
123
|
export interface SemaTaskHandle {
|
|
101
124
|
id: string;
|
|
102
125
|
type: SemaTaskType;
|
|
@@ -106,13 +129,19 @@ export interface SemaTaskHandle {
|
|
|
106
129
|
scope?: string;
|
|
107
130
|
toolUseId?: string;
|
|
108
131
|
createdAt: number;
|
|
109
|
-
|
|
132
|
+
/** The wall-clock instant of the row's last activity — a DISPLAY / audit fact (a clock that jumps, or a machine that slept, moves it
|
|
133
|
+
* with it). Written only by {@link stampActivity} / {@link activityStamp}, beside {@link SemaTaskHandle.lastActivityMono}. */
|
|
134
|
+
readonly updatedAt: number;
|
|
135
|
+
/** The SAME instant on the process-monotonic clock ({@link monotonicNow}): how long a row has been silent is measured here, so a
|
|
136
|
+
* wall-clock step or a sleep does not read as silence (or hide it). Meaningful only against this process's `monotonicNow()`;
|
|
137
|
+
* never persisted, never compared across processes. Written only beside `updatedAt`, by the one stamp. */
|
|
138
|
+
readonly lastActivityMono: number;
|
|
110
139
|
outputFile?: string;
|
|
111
140
|
/** The ref a background agent's or workflow's full result was stored under when its completion frame cut it
|
|
112
141
|
* (`persistTaskArtifact`, recorded by {@link import("./task-registry.js").TaskRegistry.recordArtifactRef}). */
|
|
113
142
|
artifactRef?: string;
|
|
114
143
|
/** P1-3 — see {@link UnifiedTaskOutput.completionId}. Minted fill-once at this task's own settle
|
|
115
|
-
* point ({@link mintCompletionId}); absent until the task reaches a terminal status. */
|
|
144
|
+
* point ({@link import("./completion-id.js").mintCompletionId}); absent until the task reaches a terminal status. */
|
|
116
145
|
completionId?: string;
|
|
117
146
|
}
|
|
118
147
|
/** THE read handle of one background task, as every model-facing list of tasks names it: a command's output file
|
|
@@ -120,17 +149,6 @@ export interface SemaTaskHandle {
|
|
|
120
149
|
* notification carried. One reading — the post-compaction table and a dropped-notification line both call it. A
|
|
121
150
|
* blank path or ref (empty or all whitespace) names nothing, so it reads as no handle. */
|
|
122
151
|
export declare function taskReadHandleText(h: Pick<SemaTaskHandle, "outputFile" | "artifactRef">): string | undefined;
|
|
123
|
-
/** Mint a cross-channel completion correlation id ONCE per
|
|
124
|
-
* handle/record, fill-once (first writer wins): every settle/direct-terminal-flip site calls this
|
|
125
|
-
* instead of writing `completionId` directly, so no matter how many terminal-transition sites a lane
|
|
126
|
-
* has (settle / TaskStop circumvention / backfill), the value is minted exactly once and every later caller
|
|
127
|
-
* (including an idempotent re-call from a circumvention path that already ran) gets back the SAME id. `string`
|
|
128
|
-
* is intentionally loose (any object with an optional `completionId` field) so the same helper serves
|
|
129
|
-
* both a `RegisteredTaskHandle` and a `WorkflowRun` (orchestration/workflow.ts — a different module,
|
|
130
|
-
* no shared base type, same fill-once shape). */
|
|
131
|
-
export declare function mintCompletionId(target: {
|
|
132
|
-
completionId?: string;
|
|
133
|
-
}): string;
|
|
134
152
|
export interface TaskAccess {
|
|
135
153
|
owner?: string;
|
|
136
154
|
scope?: string;
|
|
@@ -226,6 +244,8 @@ export interface WorkflowTaskHandle extends SemaTaskHandle {
|
|
|
226
244
|
* session end — a would-be regression caught by cross-review before this shipped (see docs/
|
|
227
245
|
* REVIEW-BACKLOG.md's "RB-215 复核" entry for the full incident). */
|
|
228
246
|
sessionScoped?: true;
|
|
247
|
+
/** The run's yield intent — see {@link RegisterWorkflowInput.yieldIntent}. Absent ⇒ the run cannot park its legs. */
|
|
248
|
+
yieldIntent?: AbortController;
|
|
229
249
|
/** The bounded return value, captured on the done-hook so the STORE-LESS in-memory lane's
|
|
230
250
|
* terminal poll can hand it over too (the launch note promises it; without a store there was no result). */
|
|
231
251
|
result?: string;
|
|
@@ -307,7 +327,22 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
307
327
|
* revive cycles identically whichever arm answered. Re-aligned to the settle's authoritative
|
|
308
328
|
* `outcome.seq` at settle time (the ledger's cycleSeq is the mint; this is its projection). */
|
|
309
329
|
cycleSeq?: number;
|
|
310
|
-
/**
|
|
330
|
+
/** The yield seat (see {@link RegisterBackgroundAgentInput.yieldLane} and {@link TaskRegistry.yieldBackground}): what the
|
|
331
|
+
* spawner can park (`lane`), the RUNNING leg's own yield controller and its readiness as its prepare reported them (`leg`,
|
|
332
|
+
* replaced by every leg — a revival or a parked-resume drive reports its own), and the one intent bit (`requested`, with
|
|
333
|
+
* what the requester does to work that cannot yield). The intent outlives a leg: a leg that reports after it was set is
|
|
334
|
+
* handed the yield at that report. */
|
|
335
|
+
yieldSeat: {
|
|
336
|
+
readonly lane: BackgroundYieldLane;
|
|
337
|
+
leg?: {
|
|
338
|
+
readonly controller: AbortController;
|
|
339
|
+
readonly ready: boolean;
|
|
340
|
+
};
|
|
341
|
+
requested?: {
|
|
342
|
+
readonly stopUnyieldable?: StopSource;
|
|
343
|
+
};
|
|
344
|
+
};
|
|
345
|
+
/** The checkpoint this handle is parked on (`status:"parked"` only; any gate). */
|
|
311
346
|
parkedCheckpointToken?: string;
|
|
312
347
|
/** design/153 §7.1 — in-process TaskStop arbitration closure, minted by the parking watcher
|
|
313
348
|
* (captures the checkpoint store + token; the registry itself holds no durable stores — r4 F-06).
|
|
@@ -561,6 +596,11 @@ export interface RegisterWorkflowInput extends TaskAccess {
|
|
|
561
596
|
* (its completion notification routes to the session) — deliberately unlike a background agent's
|
|
562
597
|
* live handle, whose sibling-turn invisibility is a channel-discipline ruling (§3.1c). */
|
|
563
598
|
originatingSessionId?: string;
|
|
599
|
+
/** The run's yield intent: the controller whose signal the run was started with as its
|
|
600
|
+
* `RunWorkflowOptions.preemptSignal` — present exactly when the run can park its legs (its park lane is armed). A
|
|
601
|
+
* whole-registry {@link TaskRegistry.yieldBackground} aborts it: each leg in flight parks at its own next clean
|
|
602
|
+
* boundary and the run suspends on its parks. ABSENT ⇒ the run cannot yield (`no_park_lane`). */
|
|
603
|
+
yieldIntent?: AbortController;
|
|
564
604
|
}
|
|
565
605
|
/** T2A-7 (2026-07-05 soak): one blocked-poll step, CLAMPED to the caller's deadline — a small timeoutMs
|
|
566
606
|
* (e.g. 10ms) must not sleep the full 400ms step (~40× overshoot, and the overshoot window even served a
|
|
@@ -638,11 +678,27 @@ export declare function accountDroppedBytes(spool: {
|
|
|
638
678
|
truncated?: boolean;
|
|
639
679
|
bytesDroppedBeforeCursor?: number;
|
|
640
680
|
}): void;
|
|
681
|
+
/** The machine-face reading of a drop account — the ONE place that decides which loss facts exist, read by every
|
|
682
|
+
* face that tells it: the `details` members, the poll banner ({@link spoolDropNote}) and the event-frame suffix
|
|
683
|
+
* ({@link droppedGapNote}). Two independent facts, because the account holds two independent things:
|
|
684
|
+
* - `bytesDroppedBeforeCursor` — bytes the env COUNTED as evicted (a lower bound when `dropUnknown` is also set);
|
|
685
|
+
* - `dropUnknown: true` — an eviction the env disclosed WITHOUT a figure: an amount nobody can count was lost.
|
|
686
|
+
* A run can hold both (a counted poll, then one that said only `truncated`), which is why this is two members and
|
|
687
|
+
* not one value: `number | "unknown"` cannot say "at least N, and more". Absence of a member is a fact: no
|
|
688
|
+
* counted loss / nothing uncounted. */
|
|
689
|
+
export declare function dropFactsOf(acct: {
|
|
690
|
+
droppedBytes?: number;
|
|
691
|
+
dropUnknown?: true;
|
|
692
|
+
}): {
|
|
693
|
+
bytesDroppedBeforeCursor?: number;
|
|
694
|
+
dropUnknown?: true;
|
|
695
|
+
};
|
|
641
696
|
/** The POLL-FACE wording for env-side loss (the terminal/event-frame wording is
|
|
642
|
-
* {@link droppedGapNote}'s; the two faces differ by design and always have). One function so the
|
|
643
|
-
* quantified/unquantified branches cannot drift between the
|
|
644
|
-
* re-readable spool, the bash re-readable spool, and the bash blocked wait
|
|
645
|
-
* (it is a banner LINE above the stdout heading); "" when nothing was
|
|
697
|
+
* {@link droppedGapNote}'s; the two faces differ by design and always have). One function so the
|
|
698
|
+
* quantified/unquantified/both branches cannot drift between the legs that render it: the monitor
|
|
699
|
+
* re-readable spool, the bash re-readable spool, and the bash blocked wait (including its poll-error
|
|
700
|
+
* salvage). Trailing newline included (it is a banner LINE above the stdout heading); "" when nothing was
|
|
701
|
+
* dropped. Reads {@link dropFactsOf}, the same facts the `details` members come from. */
|
|
646
702
|
export declare function spoolDropNote(acct: {
|
|
647
703
|
droppedBytes?: number;
|
|
648
704
|
dropUnknown?: true;
|
|
@@ -796,6 +852,8 @@ export interface RegistryCore {
|
|
|
796
852
|
markStopSource(id: string, source: StopSource): void;
|
|
797
853
|
notifyTerminalOnce(handle: BackgroundBashTaskHandle | MonitorTaskHandle | BackgroundAgentTaskHandle, send: () => void): void;
|
|
798
854
|
pokeBgQuiescence(owner: string | undefined): void;
|
|
855
|
+
/** Re-run every pending yield `drained()` check (a transition that is not an agent's — a workflow run's end). */
|
|
856
|
+
pokeYieldDrains(): void;
|
|
799
857
|
}
|
|
800
858
|
/** writer-lease renewal period for armed durable rows (see ensureDurableHeartbeat).
|
|
801
859
|
* Exported so deployments size `staleRunningMaxAgeMs` against it (recommend ≥10× this). */
|
|
@@ -852,6 +910,16 @@ export declare function normalizeAgentName(s: string): string;
|
|
|
852
910
|
* class cli/server just swept. Registration now REQUIRES both axes ({@link assertOwnership}), so a
|
|
853
911
|
* missing axis here is a broken invariant, answered with denial, never a pass. */
|
|
854
912
|
export declare function canAccess(handle: SemaTaskHandle, access: TaskAccess): boolean;
|
|
913
|
+
/** THE row judgement of "a session-scoped background agent whose child run is in flight": a `background_agent` row that is
|
|
914
|
+
* `running` and carries the explicit `sessionScoped` flag (never inferred from an owner key's shape). Three readers walk it — the
|
|
915
|
+
* session-release reap, the stall reap and the count of such rows — so none of them can differ from the others about which
|
|
916
|
+
* rows are session-resident agents. `parked` is a wait on a person, not a run in flight, and a settled row holds no run. No
|
|
917
|
+
* writer gives an agent row another live word (a registration is born `running`, or `parked` for a parked-resume handoff), so
|
|
918
|
+
* `pending` is not part of the reading. Reads three of the registry's own row fields: it cannot throw. */
|
|
919
|
+
export declare function isLiveSessionResidentAgent(handle: RegisteredTaskHandle): handle is BackgroundAgentTaskHandle & {
|
|
920
|
+
status: "running";
|
|
921
|
+
sessionScoped: true;
|
|
922
|
+
};
|
|
855
923
|
/** design/157 B13 二期(B13 档预调研 §4.2/§4.3 定稿)— the durable-agent lane's widened core seam.
|
|
856
924
|
* Extends {@link RegistryCore} with the extra members the AGENT lane's `this.*` census reached
|
|
857
925
|
* (73 处/9 成员,扣车道内互调后落在 5 个上,见 B13 档「二期细察补充」;`reapedHandles` 是后加的
|
|
@@ -887,19 +955,85 @@ export interface ParkedClaimTicket {
|
|
|
887
955
|
reservedRev: number;
|
|
888
956
|
row: import("./background-agent-store.js").BackgroundAgentRecord;
|
|
889
957
|
}
|
|
890
|
-
/**
|
|
891
|
-
*
|
|
892
|
-
*
|
|
893
|
-
*
|
|
894
|
-
*
|
|
895
|
-
*
|
|
896
|
-
*
|
|
897
|
-
*
|
|
898
|
-
*
|
|
899
|
-
*
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
958
|
+
/**
|
|
959
|
+
* How a parked-resume reservation ENDED when its drive did not run to a result — the word
|
|
960
|
+
* {@link TaskRegistry.rollbackParkedClaim} answers and the one a drive reports. One word, one meaning:
|
|
961
|
+
*
|
|
962
|
+
* `rolled_back` = the reservation was cleared while the checkpoint read pending, and the park stands: the same approval
|
|
963
|
+
* may be redeemed again (a check read after the clear that fails keeps this word; see KNOWN-LIMITS). `failed` = the
|
|
964
|
+
* cycle ended on this attempt: the approval is no longer redeemable (its checkpoint expired or is gone, or it was
|
|
965
|
+
* resolved), and this attempt carries the cycle's terminal. `lost` = another transition owns the row (a newer claim,
|
|
966
|
+
* an earlier rollback, a stop or the stale-claim sweep): that transition, not this attempt, speaks for the cycle.
|
|
967
|
+
* `retry` = the rollback could not complete against the stores (a read failed, or a write's outcome is unknown): the
|
|
968
|
+
* ending is not known, and a reservation that still stands is cleared by the stale-claim sweep.
|
|
969
|
+
*
|
|
970
|
+
* A drive that already resolved the approval's checkpoint reports `failed` whatever the registry or its own row flip
|
|
971
|
+
* answered: past the resolve, the registry's `lost` names the drive's own resolve, not another owner.
|
|
972
|
+
*/
|
|
973
|
+
export declare const PARKED_CLAIM_ROLLBACKS: readonly ["rolled_back", "failed", "lost", "retry"];
|
|
974
|
+
export type ParkedClaimRollback = (typeof PARKED_CLAIM_ROLLBACKS)[number];
|
|
975
|
+
/**
|
|
976
|
+
* The ONE table a drive's ending is read through: whether the attempt carries the cycle's terminal (frame and
|
|
977
|
+
* completion) and the sentence the attempt's failure opens with. A row per ending; the drive branches on no word
|
|
978
|
+
* outside it.
|
|
979
|
+
*/
|
|
980
|
+
export declare const PARKED_CLAIM_ROLLBACK_FACE: {
|
|
981
|
+
readonly rolled_back: {
|
|
982
|
+
readonly carriesTerminal: false;
|
|
983
|
+
readonly lead: "parked resume rolled back — the approval is still pending (retryable)";
|
|
984
|
+
};
|
|
985
|
+
readonly failed: {
|
|
986
|
+
readonly carriesTerminal: true;
|
|
987
|
+
readonly lead: "parked resume failed — the approval is no longer redeemable";
|
|
988
|
+
};
|
|
989
|
+
readonly lost: {
|
|
990
|
+
readonly carriesTerminal: false;
|
|
991
|
+
readonly lead: "parked resume did not proceed — another transition owns this row and speaks for its cycle";
|
|
992
|
+
};
|
|
993
|
+
readonly retry: {
|
|
994
|
+
readonly carriesTerminal: false;
|
|
995
|
+
readonly lead: "parked resume did not proceed — its rollback could not complete against the stores (a reservation that still stands is cleared by the stale-claim sweep)";
|
|
996
|
+
};
|
|
997
|
+
};
|
|
998
|
+
export type ParkedClaimRollbackFaceCoversEveryEnding = AssertAllKeysHandled<Exclude<ParkedClaimRollback, keyof typeof PARKED_CLAIM_ROLLBACK_FACE>>;
|
|
999
|
+
/**
|
|
1000
|
+
* Why a yield cannot park a background agent or a workflow run: the spawner cannot hold its park (`no_park_lane` — no durable
|
|
1001
|
+
* row store, checkpoint store or session-durability capability; for a workflow run, no run store and checkpoint store;
|
|
1002
|
+
* `fork_child` — a fork child never parks), or the running leg
|
|
1003
|
+
* reported that it cannot suspend durably (`leg_not_ready` — its manifest's `suspendLane` is not ready).
|
|
1004
|
+
*/
|
|
1005
|
+
export type BackgroundUnyieldableReason = "no_park_lane" | "fork_child" | "leg_not_ready";
|
|
1006
|
+
/** What a spawner can do with a yield of its agent, known at spawn ({@link RegisterBackgroundAgentInput.yieldLane}). */
|
|
1007
|
+
export type BackgroundYieldLane = "parkable" | "no_park_lane" | "fork_child";
|
|
1008
|
+
/** How a {@link TaskRegistry.yieldBackground} request treats the work it covers. */
|
|
1009
|
+
export interface BackgroundYieldOptions {
|
|
1010
|
+
/** Skip session-scoped agents (they outlive the request's owner — a parked leg's own end never reaches them). */
|
|
1011
|
+
readonly skipSessionScoped?: boolean;
|
|
1012
|
+
/** Stop the work that cannot yield, recorded as stopped by this source, instead of leaving it running — now, or when its
|
|
1013
|
+
* leg reports later that it cannot suspend. Absent ⇒ such work keeps running (a yield is a request, not a stop) and its
|
|
1014
|
+
* own leg says why, once, when it reaches a boundary. */
|
|
1015
|
+
readonly stopUnyieldable?: StopSource;
|
|
1016
|
+
}
|
|
1017
|
+
/** The receipt of one yield request: what it handed a yield, what it could not, and when it is over. */
|
|
1018
|
+
export interface BackgroundYieldReport {
|
|
1019
|
+
/** The running agents and workflow runs handed the yield: each agent parks at its own next clean turn boundary, each
|
|
1020
|
+
* run's legs at theirs (the run then suspends on its parks). */
|
|
1021
|
+
readonly yielding: readonly string[];
|
|
1022
|
+
/** The running agents and workflow runs that cannot yield, each with why (stopped when the request said so, else still
|
|
1023
|
+
* running; a workflow run's only reason is `no_park_lane`). */
|
|
1024
|
+
readonly notYieldable: ReadonlyArray<{
|
|
1025
|
+
readonly id: string;
|
|
1026
|
+
readonly reason: BackgroundUnyieldableReason;
|
|
1027
|
+
}>;
|
|
1028
|
+
/** Resolves once EVERY agent and workflow run the request covered — both lists, plus any that joined a whole-registry
|
|
1029
|
+
* request before this resolves — has left `running` AND its queued durable row writes have settled (a parked row with
|
|
1030
|
+
* its token, or a terminal row; a workflow run leaves `running` when it ends, after its terminal record write). `unpersisted` names the agents whose latest write did not land (the store refused it through every
|
|
1031
|
+
* retry; the heartbeat keeps re-driving it): until it lands their rows read their previous state, so a process that
|
|
1032
|
+
* exits now leaves those behind. Empty ⇔ every covered row is written. Never rejects. */
|
|
1033
|
+
drained(): Promise<{
|
|
1034
|
+
readonly unpersisted: readonly string[];
|
|
1035
|
+
}>;
|
|
1036
|
+
}
|
|
903
1037
|
export interface RegisterBackgroundAgentInput extends TaskAccess {
|
|
904
1038
|
/** The spawning tree's cross-boundary token (`RunInternals.crossBoundaryTree`, the tree the child joins): a poll of this handle
|
|
905
1039
|
* from a leg of the SAME tree moves nothing across the device boundary — the child's bits are already in that tree. */
|
|
@@ -952,6 +1086,9 @@ export interface RegisterBackgroundAgentInput extends TaskAccess {
|
|
|
952
1086
|
* persisted on the durable row beside the anchor (`BackgroundAgentRecord.rootSessionIncarnation`), so a revival addresses
|
|
953
1087
|
* its subtree's escalations to the occupant the tree was born under. Written only together with {@link rootSessionId}. */
|
|
954
1088
|
rootSessionIncarnation?: string;
|
|
1089
|
+
/** The scope the root's durable box mounts in (the spawner's `ctx.rootSessionScope`), persisted beside the anchor
|
|
1090
|
+
* (`BackgroundAgentRecord.rootSessionScope`). Written only together with {@link rootSessionId}. */
|
|
1091
|
+
rootSessionScope?: string;
|
|
955
1092
|
/** design/151 S3b — the revival lookup key (CC meta-sidecar shape): the model RECORD KEY,
|
|
956
1093
|
* persisted on the durable row so a tier-3 revival rebuilds the spec the way a fresh
|
|
957
1094
|
* named-teammate spawn would. A lookup key only, never a serialized spec. `model` is NOT the
|
|
@@ -968,6 +1105,11 @@ export interface RegisterBackgroundAgentInput extends TaskAccess {
|
|
|
968
1105
|
toolUseId?: string;
|
|
969
1106
|
abort: AbortController;
|
|
970
1107
|
now?: number;
|
|
1108
|
+
/** Whether a yield ({@link TaskRegistry.yieldBackground}) can park this agent's legs — the SPAWNER's answer, known at
|
|
1109
|
+
* spawn: `"parkable"` when it can hold the agent's park (a durable row store, a checkpoint store, the session-durability
|
|
1110
|
+
* capability) and hands every leg a yield signal; otherwise why not. ABSENT reads as `"no_park_lane"`: a registration
|
|
1111
|
+
* that does not say it can park a leg never had one handed to it. */
|
|
1112
|
+
yieldLane?: BackgroundYieldLane;
|
|
971
1113
|
/** design/129: register as session-scoped (owner MUST be the sessionId; see the handle flag). */
|
|
972
1114
|
sessionScoped?: true;
|
|
973
1115
|
/** design/151 S1a (LOW-12): caller-supplied handle — the tier-3 revival leg (S3) re-registers the
|
|
@@ -1,9 +1,21 @@
|
|
|
1
|
-
import { uuidv7 } from "../internal/harness.js";
|
|
2
1
|
import { summarizeWorkflowRun } from "./workflow-run-store.js";
|
|
3
2
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
4
3
|
import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
5
4
|
import { clipWithFilePointer, OUTPUT_BUDGET_MIN_CHARS } from "./tool-errors.js";
|
|
6
5
|
import { resolveEnvBudget } from "./env-budget.js";
|
|
6
|
+
export function monotonicNow() {
|
|
7
|
+
return performance.now();
|
|
8
|
+
}
|
|
9
|
+
export const ACTIVITY_INSTANT_SLACK_MS = 1_000;
|
|
10
|
+
export function isActivityInstant(at, now = monotonicNow()) {
|
|
11
|
+
return typeof at === "number" && Number.isFinite(at) && at >= 0 && at <= now + ACTIVITY_INSTANT_SLACK_MS;
|
|
12
|
+
}
|
|
13
|
+
export function activityStamp(wall = Date.now()) {
|
|
14
|
+
return { updatedAt: wall, lastActivityMono: monotonicNow() };
|
|
15
|
+
}
|
|
16
|
+
export function stampActivity(handle, wall = Date.now(), mono = monotonicNow()) {
|
|
17
|
+
Object.assign(handle, { updatedAt: wall, lastActivityMono: Math.max(handle.lastActivityMono, mono) });
|
|
18
|
+
}
|
|
7
19
|
export function taskReadHandleText(h) {
|
|
8
20
|
const file = namedHandle(h.outputFile);
|
|
9
21
|
if (file !== undefined)
|
|
@@ -16,11 +28,6 @@ export function taskReadHandleText(h) {
|
|
|
16
28
|
function namedHandle(value) {
|
|
17
29
|
return value !== undefined && value.trim() !== "" ? value : undefined;
|
|
18
30
|
}
|
|
19
|
-
export function mintCompletionId(target) {
|
|
20
|
-
if (target.completionId === undefined)
|
|
21
|
-
target.completionId = uuidv7();
|
|
22
|
-
return target.completionId;
|
|
23
|
-
}
|
|
24
31
|
export const defaultMonitorTimers = {
|
|
25
32
|
setInterval: (fn, ms) => {
|
|
26
33
|
const h = setInterval(() => void fn(), ms);
|
|
@@ -103,10 +110,20 @@ export function accountDroppedBytes(spool, poll) {
|
|
|
103
110
|
else if (poll.truncated === true)
|
|
104
111
|
spool.dropUnknown = true;
|
|
105
112
|
}
|
|
113
|
+
export function dropFactsOf(acct) {
|
|
114
|
+
return {
|
|
115
|
+
...((acct.droppedBytes ?? 0) > 0 ? { bytesDroppedBeforeCursor: acct.droppedBytes } : {}),
|
|
116
|
+
...(acct.dropUnknown === true ? { dropUnknown: true } : {}),
|
|
117
|
+
};
|
|
118
|
+
}
|
|
106
119
|
export function spoolDropNote(acct) {
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
if (
|
|
120
|
+
const facts = dropFactsOf(acct);
|
|
121
|
+
const n = facts.bytesDroppedBeforeCursor;
|
|
122
|
+
if (n !== undefined && facts.dropUnknown === true)
|
|
123
|
+
return `[!] at least ${n} earlier byte(s) permanently dropped before this window, and an unknown further amount (8MB buffer evicted)\n`;
|
|
124
|
+
if (n !== undefined)
|
|
125
|
+
return `[!] ${n} earlier byte(s) permanently dropped before this window (8MB buffer evicted)\n`;
|
|
126
|
+
if (facts.dropUnknown === true)
|
|
110
127
|
return "[!] an unknown amount of earlier output was permanently dropped before this window (buffer evicted)\n";
|
|
111
128
|
return "";
|
|
112
129
|
}
|
|
@@ -131,10 +148,15 @@ export function renderSpoolBody(spool, opts) {
|
|
|
131
148
|
`--- ${REPLAY_FACE[SPOOL_REPLAY].stderr} ---\n${opts.shape(spool.stderr) || "(none)"}`);
|
|
132
149
|
}
|
|
133
150
|
export function droppedGapNote(spool) {
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
151
|
+
const facts = dropFactsOf(spool);
|
|
152
|
+
const n = facts.bytesDroppedBeforeCursor;
|
|
153
|
+
const tail = "(execution-environment tail buffer evicted) — the event stream and this spool are INCOMPLETE.";
|
|
154
|
+
if (n !== undefined && facts.dropUnknown === true)
|
|
155
|
+
return ` [!] At least ${n} earlier byte(s) of output were permanently dropped before this window, and an unknown further amount ${tail}`;
|
|
156
|
+
if (n !== undefined)
|
|
157
|
+
return ` [!] ${n} earlier byte(s) of output were permanently dropped before this window ${tail}`;
|
|
158
|
+
if (facts.dropUnknown === true)
|
|
159
|
+
return ` [!] An unknown amount of earlier output was permanently dropped before this window ${tail}`;
|
|
138
160
|
return "";
|
|
139
161
|
}
|
|
140
162
|
export function firstDropNote(spool) {
|
|
@@ -325,8 +347,13 @@ export function canAccess(handle, access) {
|
|
|
325
347
|
return true;
|
|
326
348
|
return false;
|
|
327
349
|
}
|
|
328
|
-
export function
|
|
329
|
-
|
|
330
|
-
target.completionId = value;
|
|
331
|
-
return target.completionId;
|
|
350
|
+
export function isLiveSessionResidentAgent(handle) {
|
|
351
|
+
return handle.type === "background_agent" && handle.status === "running" && handle.sessionScoped === true;
|
|
332
352
|
}
|
|
353
|
+
export const PARKED_CLAIM_ROLLBACKS = Object.freeze(["rolled_back", "failed", "lost", "retry"]);
|
|
354
|
+
export const PARKED_CLAIM_ROLLBACK_FACE = {
|
|
355
|
+
rolled_back: { carriesTerminal: false, lead: "parked resume rolled back — the approval is still pending (retryable)" },
|
|
356
|
+
failed: { carriesTerminal: true, lead: "parked resume failed — the approval is no longer redeemable" },
|
|
357
|
+
lost: { carriesTerminal: false, lead: "parked resume did not proceed — another transition owns this row and speaks for its cycle" },
|
|
358
|
+
retry: { carriesTerminal: false, lead: "parked resume did not proceed — its rollback could not complete against the stores (a reservation that still stands is cleared by the stale-claim sweep)" },
|
|
359
|
+
};
|
|
@@ -2,7 +2,7 @@ import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
|
2
2
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
3
3
|
import { thrownText } from "./thrown-value.js";
|
|
4
4
|
import { settledRunOf } from "./workflow-settled-run.js";
|
|
5
|
-
import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, } from "./task-registry-shared.js";
|
|
5
|
+
import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, activityStamp, stampActivity, } from "./task-registry-shared.js";
|
|
6
6
|
export function registerWorkflowLane(core, input) {
|
|
7
7
|
assertOwnership(input, "registerWorkflow");
|
|
8
8
|
const id = input.runId;
|
|
@@ -19,11 +19,12 @@ export function registerWorkflowLane(core, input) {
|
|
|
19
19
|
...(input.scope !== undefined ? { scope: input.scope } : {}),
|
|
20
20
|
...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}),
|
|
21
21
|
createdAt: now,
|
|
22
|
-
|
|
22
|
+
...activityStamp(now),
|
|
23
23
|
runId: id,
|
|
24
24
|
handle: input.handle,
|
|
25
25
|
...(input.store !== undefined ? { store: input.store } : {}),
|
|
26
26
|
...(originatingSessionId !== undefined ? { originatingSessionId, sessionScoped: true } : {}),
|
|
27
|
+
...(input.yieldIntent !== undefined ? { yieldIntent: input.yieldIntent } : {}),
|
|
27
28
|
};
|
|
28
29
|
core.handles.set(id, handle);
|
|
29
30
|
void input.handle.done.then((res) => {
|
|
@@ -34,7 +35,8 @@ export function registerWorkflowLane(core, input) {
|
|
|
34
35
|
handle.result = r;
|
|
35
36
|
if (run?.completionId !== undefined)
|
|
36
37
|
handle.completionId = run.completionId;
|
|
37
|
-
handle
|
|
38
|
+
stampActivity(handle);
|
|
39
|
+
core.pokeYieldDrains();
|
|
38
40
|
}, (err) => {
|
|
39
41
|
if (handle.status !== "cancelled")
|
|
40
42
|
handle.status = "failed";
|
|
@@ -43,7 +45,8 @@ export function registerWorkflowLane(core, input) {
|
|
|
43
45
|
handle.error = boundedRedactedSummary(thrownText(err), 500);
|
|
44
46
|
if (settleId !== undefined)
|
|
45
47
|
handle.completionId = settleId;
|
|
46
|
-
handle
|
|
48
|
+
stampActivity(handle);
|
|
49
|
+
core.pokeYieldDrains();
|
|
47
50
|
});
|
|
48
51
|
return id;
|
|
49
52
|
}
|
|
@@ -112,7 +115,7 @@ export async function stopWorkflowLane(handle) {
|
|
|
112
115
|
};
|
|
113
116
|
}
|
|
114
117
|
handle.status = "cancelled";
|
|
115
|
-
handle
|
|
118
|
+
stampActivity(handle);
|
|
116
119
|
handle.handle.cancel("TaskStop requested");
|
|
117
120
|
return {
|
|
118
121
|
content: JSON.stringify({
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { BackgroundAgentTaskHandle, BackgroundUnyieldableReason, BackgroundYieldOptions, DurableAgentCore, RegisteredTaskHandle, TaskAccess, WorkflowTaskHandle } from "./task-registry-shared.js";
|
|
2
|
+
/** The handles a yield reaches: background agents and workflow runs. */
|
|
3
|
+
export type YieldableHandle = BackgroundAgentTaskHandle | WorkflowTaskHandle;
|
|
4
|
+
/**
|
|
5
|
+
* Hand ONE running agent or workflow run the yield. Answers why it cannot yield, or undefined when it was handed it (its
|
|
6
|
+
* leg parks at its own next clean boundary; a leg that has not reported yet is handed it at its report — a workflow run
|
|
7
|
+
* hands it to each of its legs the same way).
|
|
8
|
+
*/
|
|
9
|
+
export declare function requestYieldLane(core: DurableAgentCore, handle: YieldableHandle, opts: BackgroundYieldOptions): BackgroundUnyieldableReason | undefined;
|
|
10
|
+
/** Whether a request already reached this handle (a whole-registry request covers a late joiner once). */
|
|
11
|
+
export declare function yieldRequested(handle: YieldableHandle): boolean;
|
|
12
|
+
/**
|
|
13
|
+
* A leg's prepare report: the leg's own yield controller and whether it can suspend durably. Replaces the previous leg's
|
|
14
|
+
* (every leg reports its own); an intent already set is handed to this leg now.
|
|
15
|
+
*/
|
|
16
|
+
export declare function attachYieldLegLane(core: DurableAgentCore, id: string, controller: AbortController, ready: boolean): void;
|
|
17
|
+
/** Whether a request covers this handle — the ONE reading the request's first population and every late joiner of a
|
|
18
|
+
* whole-registry request share. A running background agent the request's `access` reaches (every one when absent); a
|
|
19
|
+
* running workflow run only for the whole registry (a run is never its launching leg's to decide: it outlives that leg,
|
|
20
|
+
* whose end does not reap it either); session-scoped work skipped when asked. */
|
|
21
|
+
export declare function yieldCovers(handle: RegisteredTaskHandle, access: TaskAccess | undefined, opts: BackgroundYieldOptions): handle is YieldableHandle;
|
|
22
|
+
/** The running work a request covers (see {@link yieldCovers}). */
|
|
23
|
+
export declare function yieldPopulationLane(core: DurableAgentCore, access: TaskAccess | undefined, opts: BackgroundYieldOptions): YieldableHandle[];
|
|
24
|
+
/** Whether every handle in `ids` has left `running` (a vanished handle has); the durable writes are awaited separately. A
|
|
25
|
+
* workflow run leaves `running` when it ends, after its terminal record write. */
|
|
26
|
+
export declare function yieldPopulationLeftRunning(core: DurableAgentCore, ids: ReadonlySet<string>): boolean;
|
|
27
|
+
/** Settle the durable writes queued for `ids` so far, and answer the agents whose latest write did NOT land — the store
|
|
28
|
+
* refused it through every retry (the heartbeat keeps re-driving it), so the row still reads its previous state. An agent's
|
|
29
|
+
* writes are its row chain (a park's or a settle's write is queued in the same synchronous stretch as the transition, so it
|
|
30
|
+
* is in the chain by the time the transition's poke is observed); a workflow run's are its run's end (`done` settles after
|
|
31
|
+
* its terminal record is written — a stopped run reads `cancelled` before that). Never rejects. */
|
|
32
|
+
export declare function yieldPopulationWrites(core: DurableAgentCore, ids: ReadonlySet<string>): Promise<string[]>;
|