@sema-agent/core 7.59.0 → 7.61.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -6,12 +6,13 @@ import { canAccessAgentRecord, } from "./background-agent-store.js";
|
|
|
6
6
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
7
7
|
import { createSafeNotifier } from "./safe-notify.js";
|
|
8
8
|
import { stripCwdSentinel } from "../tools/fs/fs-shared.js";
|
|
9
|
+
import { persistTaskArtifact, taskArtifactOriginOf } from "./tool-result-store.js";
|
|
9
10
|
import { registerMonitorLane, pollMonitorLane, stopMonitorLane } from "./task-registry-monitor.js";
|
|
10
11
|
import { registerWorkflowLane, pollWorkflowLane, stopWorkflowLane } from "./task-registry-workflow.js";
|
|
11
|
-
import { mintCompletionId, canAccessWorkflowRun, formatWorkflowRun, clipTaskOutput, assertOwnership, sleepPollStep, statusFromBackground, rollSpoolText, accountDroppedBytes, renderSpoolBody, stdoutHeadingOf, REPLAY_FACE, SPOOL_REPLAY, INCREMENT_REPLAY, spoolDropNote, droppedGapNote, alreadyTerminalStopNote, terminalTaskSummary, TASK_OUTPUT_MAX_CHARS, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccess, DURABLE_AGENT_HANDLE_RE, } from "./task-registry-shared.js";
|
|
12
|
+
import { mintCompletionId, taskReadHandleText, canAccessWorkflowRun, formatWorkflowRun, clipTaskOutput, assertOwnership, sleepPollStep, statusFromBackground, rollSpoolText, accountDroppedBytes, renderSpoolBody, stdoutHeadingOf, REPLAY_FACE, SPOOL_REPLAY, INCREMENT_REPLAY, spoolDropNote, droppedGapNote, alreadyTerminalStopNote, terminalTaskSummary, TASK_OUTPUT_MAX_CHARS, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccess, DURABLE_AGENT_HANDLE_RE, } from "./task-registry-shared.js";
|
|
12
13
|
export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
|
|
13
|
-
import {
|
|
14
|
-
import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
|
|
14
|
+
import { TASK_STOP_TOOL_NAME, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, TASK_STOP_DESCRIPTION, resolveTaskIdArg } from "./task-tool-shape.js";
|
|
15
|
+
import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, childSessionAnchorOf, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
|
|
15
16
|
import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
|
|
16
17
|
import { thrownText } from "./thrown-value.js";
|
|
17
18
|
import { agentStateSourceOfHandle, agentStateSourceOfRecord, agentStateSummary, readAgentState } from "./agent-state.js";
|
|
@@ -25,7 +26,6 @@ function blockDeadline(timeoutMs, now) {
|
|
|
25
26
|
const t = Math.min(BLOCK_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeoutMs ?? BLOCK_DEFAULT_TIMEOUT_MS)));
|
|
26
27
|
return now + t;
|
|
27
28
|
}
|
|
28
|
-
const BLOCK_WAIT_WRITEOUT_RESERVE_MS = 5_000;
|
|
29
29
|
const TASK_PREFIX = {
|
|
30
30
|
background_bash: "b",
|
|
31
31
|
workflow: "w",
|
|
@@ -81,10 +81,29 @@ async function drainBashTailBestEffort(handle) {
|
|
|
81
81
|
catch {
|
|
82
82
|
}
|
|
83
83
|
}
|
|
84
|
-
function
|
|
85
|
-
return
|
|
86
|
-
|
|
87
|
-
|
|
84
|
+
function commandRecordSink(rowOf, record, guarded, sink) {
|
|
85
|
+
return (n) => {
|
|
86
|
+
const row = rowOf(n.task_id);
|
|
87
|
+
if ((row?.type !== "background_bash" && row?.type !== "monitor") || n.status === "event")
|
|
88
|
+
return sink(n);
|
|
89
|
+
const gap = row.outputFile === undefined ? "missing" : row.spool?.mirrorFailed === true ? "incomplete" : undefined;
|
|
90
|
+
if (gap === undefined)
|
|
91
|
+
return sink(n);
|
|
92
|
+
const retained = row.spool !== undefined && row.spool.stdout.length + row.spool.stderr.length > 0 ? row.spool : undefined;
|
|
93
|
+
if (row.taskArtifacts === undefined || retained === undefined)
|
|
94
|
+
return sink(gap === "incomplete" ? { ...n, summary: n.summary + commandRecordGapNote(row, gap, undefined) } : n);
|
|
95
|
+
const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, drainNote: "" });
|
|
96
|
+
void persistTaskArtifact(row.taskArtifacts, row.id, body).then((artifact) => {
|
|
97
|
+
const ref = artifact.kind === "stored" ? artifact.ref : undefined;
|
|
98
|
+
if (ref !== undefined)
|
|
99
|
+
record(row.id, ref, n.completionId);
|
|
100
|
+
guarded(() => sink(ref === undefined && gap === "missing" ? n : { ...n, summary: n.summary + commandRecordGapNote(row, gap, ref) }));
|
|
101
|
+
});
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
function commandRecordGapNote(row, gap, ref) {
|
|
105
|
+
const head = gap === "incomplete" ? ` [!] Its output file ${row.outputFile} is incomplete (an append failed) — do not read it as the whole output` : " [!] No output file holds its output (the file could not be created)";
|
|
106
|
+
return ref === undefined ? `${head}.` : `${head}; what the engine retained (its head and tail, any gap stated) is stored: read it with ReadToolResult (ref "${ref}").`;
|
|
88
107
|
}
|
|
89
108
|
function explicitStopBashTerminalNote(handle, alreadyGone) {
|
|
90
109
|
const resultText = handle.spool !== undefined ? bashTerminalResult(handle.spool) : "";
|
|
@@ -98,7 +117,7 @@ function explicitStopBashTerminalNote(handle, alreadyGone) {
|
|
|
98
117
|
...(handle.outputFile !== undefined ? { output_file: handle.outputFile } : {}),
|
|
99
118
|
status: "killed",
|
|
100
119
|
...(handle.stoppedBy !== undefined ? { stoppedBy: handle.stoppedBy } : {}),
|
|
101
|
-
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "killed")} — ${detail}${
|
|
120
|
+
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "killed")} — ${detail}${handle.spool !== undefined ? droppedGapNote(handle.spool) : ""}`,
|
|
102
121
|
...(resultText.length > 0 ? { result: resultText, partial: true } : {}),
|
|
103
122
|
...(handle.completionId !== undefined ? { completionId: handle.completionId } : {}),
|
|
104
123
|
});
|
|
@@ -146,8 +165,8 @@ export class TaskRegistry {
|
|
|
146
165
|
async reapDurableAgents(scope, deps, policy) {
|
|
147
166
|
return reapDurableAgentsLane(this.core, scope, deps, policy);
|
|
148
167
|
}
|
|
149
|
-
releaseDurableTranscriptAnchor(id) {
|
|
150
|
-
return releaseDurableTranscriptAnchorLane(this.core, id);
|
|
168
|
+
releaseDurableTranscriptAnchor(id, sessionId) {
|
|
169
|
+
return releaseDurableTranscriptAnchorLane(this.core, id, sessionId);
|
|
151
170
|
}
|
|
152
171
|
bindBackgroundAgentSession(id, sessionId) {
|
|
153
172
|
return bindBackgroundAgentSessionLane(this.core, id, sessionId);
|
|
@@ -247,8 +266,8 @@ export class TaskRegistry {
|
|
|
247
266
|
runningBackgroundAgentLabels(access) {
|
|
248
267
|
return runningBackgroundAgentLabelsLane(this.core, access);
|
|
249
268
|
}
|
|
250
|
-
async pollBackgroundAgent(handle, deadline, signal,
|
|
251
|
-
return pollBackgroundAgentLane(handle, deadline, signal,
|
|
269
|
+
async pollBackgroundAgent(handle, deadline, signal, checkpointSeat) {
|
|
270
|
+
return pollBackgroundAgentLane(handle, deadline, signal, checkpointSeat);
|
|
252
271
|
}
|
|
253
272
|
async stopBackgroundAgent(handle) {
|
|
254
273
|
return stopBackgroundAgentLane(this.core, handle);
|
|
@@ -273,6 +292,7 @@ export class TaskRegistry {
|
|
|
273
292
|
if (this.handles.has(id))
|
|
274
293
|
throw new Error(`TaskRegistry: task id already registered: ${id}`);
|
|
275
294
|
const now = input.now ?? Date.now();
|
|
295
|
+
const onTerminal = input.onTerminal !== undefined ? this.commandRecordSink(input.onTerminal) : undefined;
|
|
276
296
|
this.handles.set(id, {
|
|
277
297
|
id,
|
|
278
298
|
type: "background_bash",
|
|
@@ -286,18 +306,22 @@ export class TaskRegistry {
|
|
|
286
306
|
updatedAt: now,
|
|
287
307
|
env: input.env,
|
|
288
308
|
shellId: input.shellId,
|
|
289
|
-
...(
|
|
309
|
+
...(onTerminal !== undefined ? { onTerminal } : {}),
|
|
290
310
|
...(input.outputFile !== undefined ? { outputFile: input.outputFile } : {}),
|
|
311
|
+
...(input.taskArtifacts !== undefined ? { taskArtifacts: input.taskArtifacts } : {}),
|
|
291
312
|
...(retainsBackgroundProcesses({ env: envDeclaresRetain(input.env), task: input.retainBackgroundProcesses === true }) ? { retained: true } : {}),
|
|
292
313
|
...(input.retainBackgroundProcesses !== undefined ? { retainStatedAtLaunch: true } : {}),
|
|
293
314
|
});
|
|
294
|
-
if (
|
|
295
|
-
this.startBashWatcher(id,
|
|
315
|
+
if (onTerminal)
|
|
316
|
+
this.startBashWatcher(id, onTerminal);
|
|
296
317
|
return id;
|
|
297
318
|
}
|
|
319
|
+
commandRecordSink(sink) {
|
|
320
|
+
return commandRecordSink((id) => this.handles.get(id), (id, ref, completionId) => this.recordArtifactRef(id, ref, completionId), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
|
|
321
|
+
}
|
|
298
322
|
isBackgroundOutputFile(canonicalPath, access, env) {
|
|
299
323
|
for (const handle of this.handles.values()) {
|
|
300
|
-
if (handle.type !== "background_bash" || handle.outputFile === undefined)
|
|
324
|
+
if ((handle.type !== "background_bash" && handle.type !== "monitor") || handle.outputFile === undefined)
|
|
301
325
|
continue;
|
|
302
326
|
if (handle.env !== env)
|
|
303
327
|
continue;
|
|
@@ -355,39 +379,6 @@ export class TaskRegistry {
|
|
|
355
379
|
}
|
|
356
380
|
return marked;
|
|
357
381
|
}
|
|
358
|
-
markStopSourceByShellId(shellId, source, env) {
|
|
359
|
-
if (env === undefined)
|
|
360
|
-
return;
|
|
361
|
-
const sid = String(shellId);
|
|
362
|
-
for (const [id, handle] of this.handles) {
|
|
363
|
-
if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
|
|
364
|
-
this.markStopSource(id, source);
|
|
365
|
-
return;
|
|
366
|
-
}
|
|
367
|
-
}
|
|
368
|
-
}
|
|
369
|
-
clearPendingStopSourceByShellId(shellId, source, env) {
|
|
370
|
-
const sid = String(shellId);
|
|
371
|
-
const clear = (id) => {
|
|
372
|
-
const handle = this.handles.get(id);
|
|
373
|
-
if (!handle || handle.type !== "background_bash")
|
|
374
|
-
return false;
|
|
375
|
-
if (env !== undefined && handle.env !== env)
|
|
376
|
-
return false;
|
|
377
|
-
if (handle.status === "running" && handle.stopSource === source && handle.stoppedBy === undefined) {
|
|
378
|
-
handle.stopSource = undefined;
|
|
379
|
-
}
|
|
380
|
-
return true;
|
|
381
|
-
};
|
|
382
|
-
if (env === undefined)
|
|
383
|
-
return;
|
|
384
|
-
for (const [id, handle] of this.handles) {
|
|
385
|
-
if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
|
|
386
|
-
clear(id);
|
|
387
|
-
return;
|
|
388
|
-
}
|
|
389
|
-
}
|
|
390
|
-
}
|
|
391
382
|
getStopAttribution(id) {
|
|
392
383
|
const handle = this.handles.get(id);
|
|
393
384
|
if (!handle || (handle.type !== "background_agent" && handle.type !== "background_bash" && handle.type !== "monitor"))
|
|
@@ -399,6 +390,20 @@ export class TaskRegistry {
|
|
|
399
390
|
getCompletionId(id) {
|
|
400
391
|
return this.handles.get(id)?.completionId;
|
|
401
392
|
}
|
|
393
|
+
recordArtifactRef(id, ref, completionId) {
|
|
394
|
+
const h = this.handles.get(id);
|
|
395
|
+
if (h === undefined || completionId === undefined || h.completionId !== completionId)
|
|
396
|
+
return;
|
|
397
|
+
h.artifactRef = ref;
|
|
398
|
+
}
|
|
399
|
+
artifactBoundaryLegs(ref, access, tree) {
|
|
400
|
+
const id = taskArtifactOriginOf(ref);
|
|
401
|
+
return id === undefined ? { legs: [] } : this.boundaryLegsOf(id, access, "output", tree);
|
|
402
|
+
}
|
|
403
|
+
readHandleOf(id, access) {
|
|
404
|
+
const h = this.handles.get(id);
|
|
405
|
+
return h !== undefined && canAccess(h, access) ? taskReadHandleText(h) : undefined;
|
|
406
|
+
}
|
|
402
407
|
markStopSourceForOwner(access, source, opts) {
|
|
403
408
|
let marked = 0;
|
|
404
409
|
for (const handle of this.handles.values()) {
|
|
@@ -470,7 +475,7 @@ export class TaskRegistry {
|
|
|
470
475
|
...(handle.outputFile !== undefined ? { output_file: handle.outputFile } : {}),
|
|
471
476
|
status: "killed",
|
|
472
477
|
stoppedBy: handle.stoppedBy,
|
|
473
|
-
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "killed")} — killed before completion (${clause(handle.stoppedBy)})${killFailed ? ` — kill attempt reported ${kill.ok ? "" : kill.error.code}: the process may still be terminating; the environment teardown retries` : ""}
|
|
478
|
+
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "killed")} — killed before completion (${clause(handle.stoppedBy)})${killFailed ? ` — kill attempt reported ${kill.ok ? "" : kill.error.code}: the process may still be terminating; the environment teardown retries` : ""}`,
|
|
474
479
|
...(resultText.length > 0 ? { result: resultText, partial: true } : {}),
|
|
475
480
|
...(handle.completionId !== undefined ? { completionId: handle.completionId } : {}),
|
|
476
481
|
}));
|
|
@@ -765,7 +770,7 @@ export class TaskRegistry {
|
|
|
765
770
|
...(handle.toolUseId !== undefined ? { toolUseId: handle.toolUseId } : {}),
|
|
766
771
|
...(handle.outputFile !== undefined ? { output_file: handle.outputFile } : {}),
|
|
767
772
|
status: "failed",
|
|
768
|
-
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (${r.error.message}); no further output will arrive
|
|
773
|
+
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (${r.error.message}); no further output will arrive.`,
|
|
769
774
|
...(lostResult.length > 0 ? { result: lostResult } : {}),
|
|
770
775
|
...(handle.completionId !== undefined ? { completionId: handle.completionId } : {}),
|
|
771
776
|
}));
|
|
@@ -781,6 +786,8 @@ export class TaskRegistry {
|
|
|
781
786
|
if (!ap.ok)
|
|
782
787
|
spool.mirrorFailed = true;
|
|
783
788
|
}
|
|
789
|
+
if (this.handles.get(id) !== handle || handle.status !== "running")
|
|
790
|
+
return stop();
|
|
784
791
|
handle.status = statusFromBackground(r.value.status, r.value.exitCode);
|
|
785
792
|
if (handle.status === "killed" && handle.stoppedBy === undefined) {
|
|
786
793
|
handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
|
|
@@ -813,7 +820,6 @@ export class TaskRegistry {
|
|
|
813
820
|
? `${terminalTaskSummary("bash", desc, "killed")} — timed out after ${r.value.timeoutSec}s (its own background time budget); the process was killed`
|
|
814
821
|
: `${terminalTaskSummary("bash", desc, "killed")} — timed out (its own background time budget); the process was killed`
|
|
815
822
|
: `${terminalTaskSummary("bash", desc, handle.status === "completed" ? "completed" : handle.status === "killed" ? "killed" : "failed")} — ${r.value.status}`) +
|
|
816
|
-
bashMirrorGapNote(handle) +
|
|
817
823
|
droppedGapNote(spool),
|
|
818
824
|
...(resultText.length > 0 ? { result: resultText } : {}),
|
|
819
825
|
...(handle.status === "killed" && resultText.length > 0 ? { partial: true } : {}),
|
|
@@ -837,7 +843,7 @@ export class TaskRegistry {
|
|
|
837
843
|
...(handle.toolUseId !== undefined ? { toolUseId: handle.toolUseId } : {}),
|
|
838
844
|
...(handle.outputFile !== undefined ? { output_file: handle.outputFile } : {}),
|
|
839
845
|
status: "failed",
|
|
840
|
-
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (poll failed: ${thrownText(e)}); no further output will arrive
|
|
846
|
+
summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (poll failed: ${thrownText(e)}); no further output will arrive.`,
|
|
841
847
|
...(crashedResult.length > 0 ? { result: crashedResult } : {}),
|
|
842
848
|
...(handle.completionId !== undefined ? { completionId: handle.completionId } : {}),
|
|
843
849
|
}));
|
|
@@ -848,6 +854,7 @@ export class TaskRegistry {
|
|
|
848
854
|
};
|
|
849
855
|
handle.watcher = setInterval(() => void tick(), 1_000);
|
|
850
856
|
handle.watcher.unref?.();
|
|
857
|
+
void tick();
|
|
851
858
|
}
|
|
852
859
|
runningShellIds(env) {
|
|
853
860
|
const out = [];
|
|
@@ -859,7 +866,7 @@ export class TaskRegistry {
|
|
|
859
866
|
return out;
|
|
860
867
|
}
|
|
861
868
|
registerMonitor(input) {
|
|
862
|
-
return registerMonitorLane(this.core, input);
|
|
869
|
+
return registerMonitorLane(this.core, input.onEvent !== undefined ? { ...input, onEvent: this.commandRecordSink(input.onEvent) } : input);
|
|
863
870
|
}
|
|
864
871
|
registerWorkflow(input) {
|
|
865
872
|
return registerWorkflowLane(this.core, input);
|
|
@@ -883,7 +890,7 @@ export class TaskRegistry {
|
|
|
883
890
|
if (handle.type === "background_bash")
|
|
884
891
|
return this.pollBackgroundBash(handle, taskId, access, opts.filter, deadline, opts.signal);
|
|
885
892
|
if (handle.type === "background_agent")
|
|
886
|
-
return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.
|
|
893
|
+
return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.checkpointSeat);
|
|
887
894
|
if (handle.type === "monitor")
|
|
888
895
|
return this.pollMonitor(handle, opts.filter, deadline, opts.signal);
|
|
889
896
|
return this.pollWorkflow(handle, access, deadline, opts.signal);
|
|
@@ -924,7 +931,7 @@ export class TaskRegistry {
|
|
|
924
931
|
state: ${agentStateSummary(agentState)}
|
|
925
932
|
The durable record is still marked running (last update ${new Date(row.updatedAt).toISOString()}), but this engine instance is not executing it — the outcome is unknown here. If its host process is gone, a retention sweep (staleRunningMaxAgeMs) settles the record as interrupted.`;
|
|
926
933
|
return {
|
|
927
|
-
content: delimitUntrusted(`
|
|
934
|
+
content: delimitUntrusted(`task ${row.handle}`, body),
|
|
928
935
|
isError: true,
|
|
929
936
|
details: {
|
|
930
937
|
task_id: row.handle,
|
|
@@ -1031,6 +1038,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1031
1038
|
for (const h of this.handles.values()) {
|
|
1032
1039
|
if (!canAccess(h, access))
|
|
1033
1040
|
continue;
|
|
1041
|
+
const childSession = childSessionAnchorOf(h);
|
|
1034
1042
|
out.push({
|
|
1035
1043
|
task_id: h.id,
|
|
1036
1044
|
type: h.type,
|
|
@@ -1039,6 +1047,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1039
1047
|
...((h.type === "background_bash" || h.type === "monitor") && shellRowRetained(h) ? { retained: true } : {}),
|
|
1040
1048
|
...(h.description !== undefined ? { description: h.description } : {}),
|
|
1041
1049
|
...(h.toolUseId !== undefined ? { toolUseId: h.toolUseId } : {}),
|
|
1050
|
+
...(childSession !== undefined ? { sessionId: childSession } : {}),
|
|
1042
1051
|
createdAt: h.createdAt,
|
|
1043
1052
|
updatedAt: h.updatedAt,
|
|
1044
1053
|
});
|
|
@@ -1122,7 +1131,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1122
1131
|
}
|
|
1123
1132
|
catch {
|
|
1124
1133
|
return {
|
|
1125
|
-
content: `Error (
|
|
1134
|
+
content: `Error (task poll): invalid filter regex: ${filter}`,
|
|
1126
1135
|
details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status: "not_ready" },
|
|
1127
1136
|
isError: true,
|
|
1128
1137
|
};
|
|
@@ -1138,9 +1147,9 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1138
1147
|
const shape = (text) => clipTaskOutput(rx ? text.split(/\r?\n/).filter((l) => rx.test(l)).join("\n") : text, handle.outputFile);
|
|
1139
1148
|
const running = handle.status === "running";
|
|
1140
1149
|
const retrieval = running && deadline !== undefined && Date.now() >= deadline ? "timeout" : "success";
|
|
1141
|
-
const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape,
|
|
1150
|
+
const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, drainNote: "" });
|
|
1142
1151
|
return {
|
|
1143
|
-
content: delimitUntrusted(`
|
|
1152
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
1144
1153
|
details: {
|
|
1145
1154
|
task_id: handle.id,
|
|
1146
1155
|
type: "background_bash",
|
|
@@ -1181,7 +1190,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1181
1190
|
? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}`
|
|
1182
1191
|
: "";
|
|
1183
1192
|
return {
|
|
1184
|
-
content: `Error (
|
|
1193
|
+
content: `Error (task poll): ${r.error.message}${salvaged}`,
|
|
1185
1194
|
details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput ? { details: { replay: INCREMENT_REPLAY } } : {}), error: r.error.code },
|
|
1186
1195
|
isError: true,
|
|
1187
1196
|
};
|
|
@@ -1206,7 +1215,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1206
1215
|
const body = `status: ${displayStatus}\n${droppedNote}--- ${stdoutHeadingOf(INCREMENT_REPLAY, droppedNote !== "")} ---\n${shape(stdout) || "(none)"}\n` +
|
|
1207
1216
|
`--- ${REPLAY_FACE[INCREMENT_REPLAY].stderr} ---\n${shape(stderr) || "(none)"}`;
|
|
1208
1217
|
return {
|
|
1209
|
-
content: delimitUntrusted(`
|
|
1218
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
1210
1219
|
details: {
|
|
1211
1220
|
task_id: handle.id,
|
|
1212
1221
|
type: "background_bash",
|
|
@@ -1277,7 +1286,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1277
1286
|
const retrieval_status = r.error.code === "timeout" ? "timeout" : "not_ready";
|
|
1278
1287
|
return {
|
|
1279
1288
|
content: `Error (TaskStop): ${r.error.message} — the kill did not land; the process may still be running.` +
|
|
1280
|
-
(restored ? " Its watcher keeps running:
|
|
1289
|
+
(restored ? " Its watcher keeps running: its output file keeps filling and the completion notification will still fire." : " It has no watcher, so no completion notification will follow."),
|
|
1281
1290
|
details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, error: r.error.code },
|
|
1282
1291
|
isError: true,
|
|
1283
1292
|
};
|
|
@@ -1312,67 +1321,12 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1312
1321
|
}
|
|
1313
1322
|
}
|
|
1314
1323
|
export const defaultTaskRegistry = new TaskRegistry();
|
|
1315
|
-
export function createTaskOutputTool(opts) {
|
|
1316
|
-
const caps = { ...REGISTRY_TASK_TOOL_CAPS, notification: opts.notificationWired !== false };
|
|
1317
|
-
return defineTool({
|
|
1318
|
-
name: TASK_OUTPUT_TOOL_NAME,
|
|
1319
|
-
...toolFace("task-output"),
|
|
1320
|
-
ruleFace: mountRuleFace("task-output"),
|
|
1321
|
-
description: composeTaskOutputDescription(caps),
|
|
1322
|
-
parameters: composeTaskOutputParams(caps),
|
|
1323
|
-
boundaryLegsFor: (rawArgs, at) => {
|
|
1324
|
-
const id = resolveTaskIdArg(rawArgs?.task_id);
|
|
1325
|
-
return id ? opts.registry.boundaryLegsOf(id, { owner: opts.owner, scope: opts.scope, ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}) }, "output", at.tree) : { legs: [] };
|
|
1326
|
-
},
|
|
1327
|
-
execute: async (rawArgs, ctx) => {
|
|
1328
|
-
const args = rawArgs;
|
|
1329
|
-
const id = resolveTaskIdArg(args.task_id);
|
|
1330
|
-
if (!id)
|
|
1331
|
-
return errorResult(TASK_OUTPUT_MISSING_ID_MESSAGE);
|
|
1332
|
-
const requestedMs = typeof args.timeout === "number" ? args.timeout : undefined;
|
|
1333
|
-
let effectiveTimeoutMs = requestedMs;
|
|
1334
|
-
let waitClampNote = "";
|
|
1335
|
-
const wall = opts.deadlineMs?.();
|
|
1336
|
-
const requestedWaitMs = Math.max(1, Math.floor(requestedMs ?? BLOCK_DEFAULT_TIMEOUT_MS));
|
|
1337
|
-
if (args.block !== false && wall !== undefined) {
|
|
1338
|
-
const remainMs = wall - Date.now() - BLOCK_WAIT_WRITEOUT_RESERVE_MS;
|
|
1339
|
-
const wantMs = Math.min(BLOCK_MAX_TIMEOUT_MS, requestedWaitMs);
|
|
1340
|
-
if (remainMs <= 0) {
|
|
1341
|
-
effectiveTimeoutMs = 1;
|
|
1342
|
-
waitClampNote =
|
|
1343
|
-
"\n\nNOTE: wait skipped — the task's wall-clock deadline has been reached. Do NOT wait on this background task again; write out your results now (an unfinished answer beats a hard timeout).";
|
|
1344
|
-
}
|
|
1345
|
-
else if (remainMs < wantMs) {
|
|
1346
|
-
effectiveTimeoutMs = remainMs;
|
|
1347
|
-
waitClampNote = `\n\nNOTE: wait clamped to ${Math.round(remainMs / 1000)}s (requested ${Math.round(requestedWaitMs / 1000)}s) — the task's wall-clock deadline is near. If the task is still running after this wait, do NOT re-wait: proceed with other work or write out your results now.`;
|
|
1348
|
-
}
|
|
1349
|
-
}
|
|
1350
|
-
const r = await opts.registry.pollTask(id, { owner: ctx.taskId ?? opts.owner, scope: ctx.principal ?? opts.scope, ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}) }, {
|
|
1351
|
-
workflowStore: opts.workflowStore,
|
|
1352
|
-
agentStore: opts.agentStore,
|
|
1353
|
-
filter: typeof args.filter === "string" ? args.filter : undefined,
|
|
1354
|
-
block: args.block !== false,
|
|
1355
|
-
timeoutMs: effectiveTimeoutMs,
|
|
1356
|
-
signal: ctx.signal,
|
|
1357
|
-
oneShot: opts.oneShot,
|
|
1358
|
-
toolResultStore: opts.toolResultStore,
|
|
1359
|
-
checkpointSeat: opts.checkpointSeat,
|
|
1360
|
-
});
|
|
1361
|
-
const { type: taskType, ...rest } = r.details;
|
|
1362
|
-
return {
|
|
1363
|
-
content: r.content + waitClampNote,
|
|
1364
|
-
details: { type: "task-output", ...(taskType !== undefined ? { taskType } : {}), ...(waitClampNote !== "" ? { waitClamped: true } : {}), ...rest },
|
|
1365
|
-
...(r.isError ? { isError: true } : {}),
|
|
1366
|
-
};
|
|
1367
|
-
},
|
|
1368
|
-
});
|
|
1369
|
-
}
|
|
1370
1324
|
export function createTaskStopTool(opts) {
|
|
1371
1325
|
return defineTool({
|
|
1372
1326
|
name: TASK_STOP_TOOL_NAME,
|
|
1373
1327
|
...toolFace("task-stop"),
|
|
1374
1328
|
ruleFace: mountRuleFace("task-stop"),
|
|
1375
|
-
description:
|
|
1329
|
+
description: TASK_STOP_DESCRIPTION,
|
|
1376
1330
|
parameters: TASK_STOP_PARAMS,
|
|
1377
1331
|
boundaryLegsFor: (rawArgs, at) => {
|
|
1378
1332
|
const a = rawArgs;
|
|
@@ -164,8 +164,9 @@ export interface TaskResult {
|
|
|
164
164
|
/**
|
|
165
165
|
* The ENGINE-minted identity of THIS run (uuidv7), minted once at the top of prepare and
|
|
166
166
|
* never rewritten. The third id of the trio, and the only one the engine owns:
|
|
167
|
-
* - {@link taskId} — the
|
|
168
|
-
*
|
|
167
|
+
* - {@link taskId} — the leg's task identity: a background sub-agent's registry task id, else the
|
|
168
|
+
* HOST's task identity, else (when the host named none) the session id — so it answers the SAME
|
|
169
|
+
* value for every run of one session (or of one background row);
|
|
169
170
|
* - {@link sessionId} — the conversation, shared by every run that continues it;
|
|
170
171
|
* - `runId` — this call. Two runs of one session ALWAYS differ here; a host-supplied `taskId` does
|
|
171
172
|
* not change it (the host's handle and the engine's run are different questions).
|
|
@@ -185,8 +186,22 @@ export interface TaskResult {
|
|
|
185
186
|
* never the `"unknown"` sentinel `taskId`/`sessionId` fall back to on that path.
|
|
186
187
|
*/
|
|
187
188
|
runId?: string;
|
|
188
|
-
/**
|
|
189
|
+
/**
|
|
190
|
+
* Use this to continue the same conversation on the next call. On a parked result — a `paused` terminal, or a `failed` one
|
|
191
|
+
* carrying `nestedPause` — it is the session of the leg that parked, which is the parked row's own `Checkpoint.sessionId`.
|
|
192
|
+
* A composition entry's legs (a cascade's rungs, a verification gate's verifier) do not run in the caller's session, so a
|
|
193
|
+
* host links such a row to its run by the row's `CheckpointState.compositionLeg.hostSessionId`, never by assuming the row
|
|
194
|
+
* sits in the session it submitted.
|
|
195
|
+
*/
|
|
189
196
|
sessionId: string;
|
|
197
|
+
/**
|
|
198
|
+
* The leg's placement fixed point: the one value its prepare resolved for the tree's placement root (the caller's explicit
|
|
199
|
+
* `RunInternals.placementRoot`, else the delegation root, else the leg's own session — on a resume, the parked row's recorded
|
|
200
|
+
* root), the same value its env factory was minted with and its parks record. A composition entry places every later leg at
|
|
201
|
+
* its first leg's `placementRoot`. **In-presence condition**: present on every terminal of a run whose prepare resolved it;
|
|
202
|
+
* absent on a result a run did not assemble (a host's own stub, a composition's synthetic terminal).
|
|
203
|
+
*/
|
|
204
|
+
placementRoot?: string;
|
|
190
205
|
/**
|
|
191
206
|
* WHY the run ended — the ONE tagged cause ({@link TerminalCause}), and the ONLY terminal record on this
|
|
192
207
|
* result: there is no `status` word and no `errorCode`/`errorMessage`/`blockedReason`/`checkpointToken`/
|
|
@@ -419,7 +434,7 @@ export interface TaskResult {
|
|
|
419
434
|
* of silence. Present only when at least one applies (absent = nothing to disclose), so a consumer that
|
|
420
435
|
* ignores the field is unchanged. A rewind that could NOT be delivered as asked is NOT a note — it is a
|
|
421
436
|
* terminal failure (`rewind_snapshot.unresolvable` / `rewind.store_unconfigured` /
|
|
422
|
-
* `rewind.restore_failed` / `rewind.invalid_spec` /
|
|
437
|
+
* `rewind.restore_failed` / `rewind.invalid_spec` /
|
|
423
438
|
* `rewind.conflicting_targets` / `rewind.child_scope_unsupported` / `rewind.capture_disabled`).
|
|
424
439
|
*
|
|
425
440
|
* - `conversation_only` — {@link TaskSpec.resumeAt} branched the transcript WITHOUT
|
|
@@ -495,10 +510,12 @@ export interface TaskResult {
|
|
|
495
510
|
editedFiles?: import("../agents/subagent-steps.js").SubagentEditedFile[];
|
|
496
511
|
/**
|
|
497
512
|
* Present (`true`) exactly when the run's FINAL turn was halted by a person's BARE rejection of a
|
|
498
|
-
* tool call — the parent-thread control-flow boundary: the rejected
|
|
499
|
-
* that had not started were settled un-executed (each an error result
|
|
500
|
-
* and the engine deliberately did NOT re-invoke the model, so the run ends
|
|
501
|
-
* direction.
|
|
513
|
+
* tool call, or of the plan a plan pause held — the parent-thread control-flow boundary: the rejected
|
|
514
|
+
* call's same-message siblings that had not started were settled un-executed (each an error result
|
|
515
|
+
* coded `gate.batch_halted`), and the engine deliberately did NOT re-invoke the model, so the run ends
|
|
516
|
+
* awaiting the user's direction. A resumed leg that redeems such a rejection records the decision and
|
|
517
|
+
* makes no model request at all (its `result` is the transcript's last assistant message — the plan
|
|
518
|
+
* request, or the parked call's message; empty when the transcript has no answer yet). On this path `status` is still `"completed"` (nothing failed, nothing is suspended,
|
|
502
519
|
* the session is continuable as ever) — this field is what tells such an end apart from a natural
|
|
503
520
|
* finish: `result` text is whatever the model had produced BEFORE the rejection (often empty), and
|
|
504
521
|
* a consumer surface should read the state as "stopped by the user, awaiting their direction",
|
|
@@ -776,11 +793,8 @@ export interface TaskResult {
|
|
|
776
793
|
* mechanism engaged this leg; absent = none did (byte-compatible).
|
|
777
794
|
*/
|
|
778
795
|
mechanisms?: {
|
|
779
|
-
/** design/132:
|
|
780
|
-
|
|
781
|
-
/** oracle-grounding gate (opus LOW 复审, additive): HOW MANY final-verification injections
|
|
782
|
-
* fired this run — 1 = the R9 one-shot only, 2 = R9 + the grounding re-entry (hard cap).
|
|
783
|
-
* Present iff `finalVerifyInjected` is (the boolean stays for compatibility, RL-1336-finalverify-bool). */
|
|
796
|
+
/** design/132: HOW MANY natural-end final-verification injections fired this run — 1 = the R9 one-shot
|
|
797
|
+
* only, 2 = R9 + the oracle-grounding re-entry (hard cap). Present iff at least one fired. */
|
|
784
798
|
finalVerifyInjections?: number;
|
|
785
799
|
/** design/133: number of attachment blocks injected this run — turn-boundary bundles
|
|
786
800
|
* (todo/task reminders, changed-files notes, plan-mode re-reminders, listing drift frames;
|
|
@@ -874,8 +888,6 @@ export interface TaskResult {
|
|
|
874
888
|
* subagent cost (it lands in `nested`, see assemble-result.ts), so `nestedSubagentMicroUsd` sits
|
|
875
889
|
* OUTSIDE the costMicroUsd identity, not inside it (measured correction: the previous wording
|
|
876
890
|
* `llmRoot + nested + compaction === costMicroUsd` only held when nested was 0).
|
|
877
|
-
* (`memoryConsolidationMicroUsd` is a separate, budget-excluded line, permanently 0 since the
|
|
878
|
-
* runner-integrated consolidation pass was retired — design/157 B19 — and NOT part of any identity).
|
|
879
891
|
* Present whenever stats are assembled, EXCEPT when `costMicroUsd` is absent for unpriced spend
|
|
880
892
|
* (RB-368) — the taxonomy would partition a fabricated total, so it is omitted together with it.
|
|
881
893
|
*/
|
|
@@ -889,10 +901,6 @@ export interface TaskResult {
|
|
|
889
901
|
llmRootMicroUsd: number;
|
|
890
902
|
/** Delegated sub-agent (nested) LLM cost (micro-USD) = `nested?.costMicroUsd ?? 0`. */
|
|
891
903
|
nestedSubagentMicroUsd: number;
|
|
892
|
-
/** Post-task memory-consolidation LLM cost (micro-USD). Permanently 0 since design/157 B19 retired
|
|
893
|
-
* the runner-integrated consolidation pass (kept: public stats contract; an engine-plane re-mount —
|
|
894
|
-
* design/138 §7 — would fill it). A separate, budget-excluded line. */
|
|
895
|
-
memoryConsolidationMicroUsd: number;
|
|
896
904
|
/** design/100 §E12 — prompt-suggestion pass LLM cost (micro-USD) = `suggestions?.costMicroUsd ?? 0`; filled
|
|
897
905
|
* asynchronously after the (post-completion) pass (0 until then). A separate, budget-excluded line. */
|
|
898
906
|
suggestionsMicroUsd?: number;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The one reading of a caller's {@link TaskSpec}. A spec is the caller's own object: a literal, a class instance, a bag with
|
|
3
|
+
* accessors, a Proxy. The run takes it through here once, at its entrance, and every reader after that — the session lock, the
|
|
4
|
+
* config doors, prepare, the leg, the backstop terminal — reads the snapshot this returns, never the caller's object again.
|
|
5
|
+
*
|
|
6
|
+
* Each member is read once, by name, through an ordinary property lookup (an inherited, non-enumerable, accessor-backed or
|
|
7
|
+
* Proxy-answered member included — the presence law the retired-key door states, `retired-keys.ts`), and a defined value lands
|
|
8
|
+
* as an own enumerable data member of a new plain frozen object: the snapshot reads exactly like an object literal spec, so any
|
|
9
|
+
* later copy (a spread included) keeps every member, and a getter's value is the one value the whole run sees. Values are taken
|
|
10
|
+
* by reference (a member's own contents — the tool roster's entries, a policy, a signal — are their own readers' to snapshot).
|
|
11
|
+
*
|
|
12
|
+
* Three refusals, each by name and recorded on the read (thrown where the run's prepare refuses, so a failed read ends the run
|
|
13
|
+
* as any prepare refusal does): a member whose lookup throws (`config.spec_member_unreadable`); a retired key the lookup answers
|
|
14
|
+
* (`config.spec_retired_key`, the retired-key door judged over the values just read); an own key (enumerable or not, string or
|
|
15
|
+
* symbol) that is neither a member nor a retired name — the engine's one name judgment, on the spec as given; an inherited key is
|
|
16
|
+
* no own key, so it is neither read as a stray nor refused — (`config.spec_unknown_key` — a key the engine never reads is refused,
|
|
17
|
+
* not carried silently).
|
|
18
|
+
*
|
|
19
|
+
* The one re-read the engine keeps is the tool roster's identity check (`refuseLateRosterChanges`, against the caller's own
|
|
20
|
+
* object): it compares objects, it does not take a value.
|
|
21
|
+
*/
|
|
22
|
+
import type { TaskSpec } from "./task-spec.js";
|
|
23
|
+
/** Every {@link TaskSpec} member, by name — the type's own key set, fenced both ways (a member added to `TaskSpec` and not
|
|
24
|
+
* listed here, or a name here that `TaskSpec` does not declare, is a compile error; the value is a placeholder). */
|
|
25
|
+
export declare const TASK_SPEC_MEMBERS: readonly string[];
|
|
26
|
+
/** What one read of a caller's spec answered: the snapshot every reader reads, the caller's own object (for the roster's identity
|
|
27
|
+
* check only), and the refusal the read met (thrown at prepare's door), if any. */
|
|
28
|
+
export interface CallerSpecRead<S extends Partial<TaskSpec> = TaskSpec> {
|
|
29
|
+
readonly spec: S;
|
|
30
|
+
readonly caller: S;
|
|
31
|
+
readonly refusal: (Error & {
|
|
32
|
+
code: string;
|
|
33
|
+
}) | undefined;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Read the caller's spec once (see the module note). Never throws for a spec that is an object: a refusal is recorded on the read
|
|
37
|
+
* and thrown at prepare's door; a spec that is no object at all is a `TypeError`, as any member read of it would be.
|
|
38
|
+
*/
|
|
39
|
+
export declare function readCallerSpec<S extends Partial<TaskSpec>>(spec: S): CallerSpecRead<S>;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { RETIRED_TASK_SPEC_KEYS, retiredKeyOf, retiredKeyRefusal } from "./retired-keys.js";
|
|
2
|
+
import { thrownText } from "./thrown-value.js";
|
|
3
|
+
import { strayMembersOf } from "./own-property-receipt.js";
|
|
4
|
+
export const TASK_SPEC_MEMBERS = Object.keys({
|
|
5
|
+
taskId: 0, objective: 0, principal: 0, actor: 0, runOrigin: 0, interactionPosture: 0, approvalReach: 0, interactiveQuestionFallback: 0,
|
|
6
|
+
images: 0, userAttachments: 0, sessionId: 0, projectId: 0, requireExistingSession: 0, oneShot: 0, clientContext: 0, resumeAt: 0,
|
|
7
|
+
resumeAtMode: 0, model: 0, modelRole: 0, roles: 0, compactionModel: 0, advisorModel: 0, thinking: 0, systemPrompt: 0,
|
|
8
|
+
promptRole: 0, promptForm: 0, promptBinding: 0, appendSystemPrompt: 0, outputStyle: 0, memory: 0, suggestNextPrompts: 0, fileHistory: 0,
|
|
9
|
+
projectMemory: 0, restoreFiles: 0, acceptPartialRestore: 0, rewindFilesTo: 0, tools: 0, allowTools: 0, excludeTools: 0, excludeAllTools: 0,
|
|
10
|
+
deferTools: 0, toolMaterializeStrategy: 0, alwaysLoadTools: 0, restoreGatedTools: 0, deferSelfResolve: 0, promptLean: 0, agents: 0, toolPolicy: 0,
|
|
11
|
+
basePolicyForResumeEdit: 0, onAsk: 0, onQuestion: 0, lspManager: 0, lspDiagnostics: 0, mods: 0, peerPresence: 0, durableApproval: 0,
|
|
12
|
+
resourceSuspend: 0, preemptSignal: 0, resilience: 0, finalVerification: 0, maxSuspends: 0, checkpointStore: 0, handsReadOnly: 0, memoryPersistenceCapable: 0,
|
|
13
|
+
additionalDirectories: 0, additionalReadDirectories: 0, readDenyPatterns: 0, writeProtectedAdditions: 0, complianceAdditionalDenies: 0, readFace: 0, writeFace: 0, enablePlanMode: 0,
|
|
14
|
+
planFile: 0, interactiveTools: 0, enableFork: 0, shellGate: 0, permissionMode: 0, classifyAllShell: 0, mcp: 0, a2a: 0,
|
|
15
|
+
skills: 0, userInvokedSkills: 0, allowedTools: 0, skillListingBudgetFraction: 0, skillListingMaxDescChars: 0, backgroundScope: 0, envFacts: 0, limits: 0,
|
|
16
|
+
configOverrides: 0, forwardSubagentEvents: 0, retainSubagentSessions: 0, retainBackgroundProcesses: 0, streamingToolExecution: 0, outputSchema: 0, outputRetries: 0, tracer: 0,
|
|
17
|
+
toolResultThresholdChars: 0, compaction: 0, attachments: 0, enableBlockedReport: 0, selfOrchestration: 0, getApiKeyAndHeaders: 0, signal: 0,
|
|
18
|
+
});
|
|
19
|
+
const MEMBERS = new Set(TASK_SPEC_MEMBERS);
|
|
20
|
+
const RETIRED_NAMES = [...new Set(Object.keys(RETIRED_TASK_SPEC_KEYS).map((key) => key.split(".")[0].replace(/\[\]$/, "")))];
|
|
21
|
+
const READ_NAMES = [...TASK_SPEC_MEMBERS, ...RETIRED_NAMES.filter((name) => !MEMBERS.has(name))];
|
|
22
|
+
const READS = new WeakMap();
|
|
23
|
+
function specRefusal(code, message, detail) {
|
|
24
|
+
const e = new Error(message);
|
|
25
|
+
e.code = code;
|
|
26
|
+
e.detail = detail;
|
|
27
|
+
return e;
|
|
28
|
+
}
|
|
29
|
+
function unreadable(member, cause) {
|
|
30
|
+
const why = thrownText(cause);
|
|
31
|
+
return specRefusal("config.spec_member_unreadable", `TaskSpec.${member} could not be read (${why}) — a run reads each member of its spec once, at its start; a member whose read throws is refused rather than read as absent. Pass the value as a plain data member.`, { member });
|
|
32
|
+
}
|
|
33
|
+
function unknownKeys(keys) {
|
|
34
|
+
return specRefusal("config.spec_unknown_key", `TaskSpec carries ${keys.length === 1 ? "a key" : "keys"} this engine does not read: ${keys.map((k) => JSON.stringify(k)).join(", ")}. Refused rather than ignored: a key that is silently dropped reads to the caller as configured. Drop ${keys.length === 1 ? "it" : "them"}, or spell the member the engine declares.`, { keys: [...keys] });
|
|
35
|
+
}
|
|
36
|
+
export function readCallerSpec(spec) {
|
|
37
|
+
const known = READS.get(spec);
|
|
38
|
+
if (known !== undefined)
|
|
39
|
+
return known;
|
|
40
|
+
if (spec === null || (typeof spec !== "object" && typeof spec !== "function")) {
|
|
41
|
+
throw new TypeError(`TaskSpec must be an object (got ${spec === null ? "null" : typeof spec})`);
|
|
42
|
+
}
|
|
43
|
+
let own;
|
|
44
|
+
try {
|
|
45
|
+
own = { stray: strayMembersOf(spec, { subject: "TaskSpec", unit: "member", moment: "when the run reads its spec" }, READ_NAMES) };
|
|
46
|
+
}
|
|
47
|
+
catch (cause) {
|
|
48
|
+
own = { cause };
|
|
49
|
+
}
|
|
50
|
+
const values = Object.create(null);
|
|
51
|
+
let refusal;
|
|
52
|
+
for (const name of READ_NAMES) {
|
|
53
|
+
let value;
|
|
54
|
+
try {
|
|
55
|
+
value = Reflect.get(spec, name);
|
|
56
|
+
}
|
|
57
|
+
catch (cause) {
|
|
58
|
+
refusal ??= unreadable(name, cause);
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
if (value !== undefined)
|
|
62
|
+
values[name] = value;
|
|
63
|
+
}
|
|
64
|
+
for (const [key, replacement] of refusal === undefined ? Object.entries(RETIRED_TASK_SPEC_KEYS) : []) {
|
|
65
|
+
let hit;
|
|
66
|
+
try {
|
|
67
|
+
hit = retiredKeyOf(values, { [key]: replacement });
|
|
68
|
+
}
|
|
69
|
+
catch (cause) {
|
|
70
|
+
refusal = unreadable(key, cause);
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
if (hit !== undefined) {
|
|
74
|
+
refusal = retiredKeyRefusal(hit, "TaskSpec");
|
|
75
|
+
break;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (refusal === undefined) {
|
|
79
|
+
if ("cause" in own)
|
|
80
|
+
refusal = unreadable("[own keys]", own.cause);
|
|
81
|
+
else if (own.stray !== undefined)
|
|
82
|
+
refusal = unknownKeys(own.stray.names.map((name) => String(name)));
|
|
83
|
+
}
|
|
84
|
+
const members = {};
|
|
85
|
+
for (const name of TASK_SPEC_MEMBERS)
|
|
86
|
+
if (name in values)
|
|
87
|
+
members[name] = values[name];
|
|
88
|
+
const snapshot = Object.freeze(members);
|
|
89
|
+
const read = Object.freeze({ spec: snapshot, caller: spec, refusal });
|
|
90
|
+
READS.set(snapshot, read);
|
|
91
|
+
return read;
|
|
92
|
+
}
|