@sema-agent/core 7.60.0 → 7.62.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 +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- 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 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- 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 +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- 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 +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- 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/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- 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.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- 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/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- 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 +68 -21
- package/dist/core/engine-notice.js +9 -2
- 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 +10 -0
- package/dist/core/frame-settlement.js +6 -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 +4 -3
- package/dist/core/gate-lanes.js +7 -4
- 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 +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -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 +4 -3
- package/dist/core/locked-config.js +5 -3
- 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-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- 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 +2 -1
- 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 +6 -49
- package/dist/core/mcp.js +115 -111
- 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-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- 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/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/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- 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 +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- 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 +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -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 +138 -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 +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- 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 +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- 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/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- 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/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -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 -3
- package/dist/core/runner/assemble-result.js +12 -7
- 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/compact-session.js +18 -3
- 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 +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- 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/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- 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/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- 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 +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- 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 +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- 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-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -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 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- 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-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- 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 +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- 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 +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- 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 +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- 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/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- 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 +16 -7
- 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 -2
- 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.js +2 -0
- 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-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- 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 +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -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/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- 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 +11 -11
- 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 +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- 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.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- 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 +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- 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 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- 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 +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- 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 +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- 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.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- 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.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -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/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- 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 +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- 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/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -89,16 +89,13 @@ export function statusFromBackground(status, exitCode) {
|
|
|
89
89
|
return exitCode === 0 ? "completed" : "failed";
|
|
90
90
|
return "failed";
|
|
91
91
|
}
|
|
92
|
-
export function rollSpoolText(spool, s, cap
|
|
92
|
+
export function rollSpoolText(spool, s, cap) {
|
|
93
93
|
if (s.length <= cap)
|
|
94
94
|
return s;
|
|
95
95
|
const half = Math.floor(cap / 2);
|
|
96
|
-
|
|
97
|
-
spool.rolledChars += dropped.length;
|
|
98
|
-
onDrop?.(dropped);
|
|
96
|
+
spool.rolledChars += s.length - 2 * half;
|
|
99
97
|
return s.slice(0, half) + s.slice(s.length - half);
|
|
100
98
|
}
|
|
101
|
-
export const MONITOR_SPILL_CAP_CHARS = 64 * 1024 * 1024;
|
|
102
99
|
export function accountDroppedBytes(spool, poll) {
|
|
103
100
|
const d = poll.bytesDroppedBeforeCursor ?? 0;
|
|
104
101
|
if (d > 0)
|
|
@@ -127,7 +124,7 @@ export function stdoutHeadingOf(replay, gapDisclosed) {
|
|
|
127
124
|
export function renderSpoolBody(spool, opts) {
|
|
128
125
|
const timedOutClause = spool.timedOut === true ? ` (timed out after ${spool.timeoutSec !== undefined ? `${spool.timeoutSec}s` : "its background time budget"})` : "";
|
|
129
126
|
const displayStatus = (spool.exitCode !== undefined ? `exited(code ${spool.exitCode})` : opts.running ? "running" : opts.handleStatus) + timedOutClause;
|
|
130
|
-
const rolledNote = spool.rolledChars > 0 ? `[!] ${spool.rolledChars} earlier char(s) dropped from the spool (memory bound)
|
|
127
|
+
const rolledNote = spool.rolledChars > 0 ? `[!] ${spool.rolledChars} earlier char(s) dropped from the spool (memory bound)\n` : "";
|
|
131
128
|
const droppedNote = spoolDropNote(spool);
|
|
132
129
|
const stdoutHeading = stdoutHeadingOf(SPOOL_REPLAY, droppedNote !== "" || opts.drainNote !== "");
|
|
133
130
|
return (`status: ${displayStatus}\n${rolledNote}${droppedNote}${opts.drainNote}--- ${stdoutHeading} ---\n${opts.shape(spool.stdout) || "(none)"}\n` +
|
|
@@ -313,41 +310,6 @@ export function normalizeAgentName(s) {
|
|
|
313
310
|
.toLowerCase()
|
|
314
311
|
.replace(/\s+/g, "-");
|
|
315
312
|
}
|
|
316
|
-
export function editDistance(a, b) {
|
|
317
|
-
if (a === b)
|
|
318
|
-
return 0;
|
|
319
|
-
const m = a.length;
|
|
320
|
-
const n = b.length;
|
|
321
|
-
const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
|
|
322
|
-
for (let i = 1; i <= m; i++) {
|
|
323
|
-
for (let j = 1; j <= n; j++) {
|
|
324
|
-
const cost = a[i - 1] === b[j - 1] ? 0 : 1;
|
|
325
|
-
d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
|
|
326
|
-
if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
|
|
327
|
-
d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
|
|
328
|
-
}
|
|
329
|
-
}
|
|
330
|
-
}
|
|
331
|
-
return d[m][n];
|
|
332
|
-
}
|
|
333
|
-
export function closestName(query, candidates) {
|
|
334
|
-
let best;
|
|
335
|
-
let bestDist = 3;
|
|
336
|
-
const seen = new Set();
|
|
337
|
-
for (const c of candidates) {
|
|
338
|
-
if (seen.has(c))
|
|
339
|
-
continue;
|
|
340
|
-
seen.add(c);
|
|
341
|
-
if (Math.abs(c.length - query.length) > 2)
|
|
342
|
-
continue;
|
|
343
|
-
const dist = editDistance(query, c);
|
|
344
|
-
if (dist <= 2 && dist < bestDist) {
|
|
345
|
-
bestDist = dist;
|
|
346
|
-
best = c;
|
|
347
|
-
}
|
|
348
|
-
}
|
|
349
|
-
return best;
|
|
350
|
-
}
|
|
351
313
|
export function canAccess(handle, access) {
|
|
352
314
|
if (handle.scope === undefined || access.scope === undefined || access.scope !== handle.scope)
|
|
353
315
|
return false;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
2
2
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
3
3
|
import { thrownText } from "./thrown-value.js";
|
|
4
|
+
import { settledRunOf } from "./workflow-settled-run.js";
|
|
4
5
|
import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, } from "./task-registry-shared.js";
|
|
5
6
|
export function registerWorkflowLane(core, input) {
|
|
6
7
|
assertOwnership(input, "registerWorkflow");
|
|
@@ -23,7 +24,6 @@ export function registerWorkflowLane(core, input) {
|
|
|
23
24
|
handle: input.handle,
|
|
24
25
|
...(input.store !== undefined ? { store: input.store } : {}),
|
|
25
26
|
...(originatingSessionId !== undefined ? { originatingSessionId, sessionScoped: true } : {}),
|
|
26
|
-
...(input.onServedTerminal !== undefined ? { onServedTerminal: input.onServedTerminal } : {}),
|
|
27
27
|
};
|
|
28
28
|
core.handles.set(id, handle);
|
|
29
29
|
void input.handle.done.then((res) => {
|
|
@@ -38,27 +38,15 @@ export function registerWorkflowLane(core, input) {
|
|
|
38
38
|
}, (err) => {
|
|
39
39
|
if (handle.status !== "cancelled")
|
|
40
40
|
handle.status = "failed";
|
|
41
|
+
const settledRun = settledRunOf(input.handle.done);
|
|
42
|
+
const settleId = settledRun?.completionId;
|
|
41
43
|
handle.error = boundedRedactedSummary(thrownText(err), 500);
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
: undefined;
|
|
45
|
-
if (rejectedRun?.completionId !== undefined)
|
|
46
|
-
handle.completionId = rejectedRun.completionId;
|
|
44
|
+
if (settleId !== undefined)
|
|
45
|
+
handle.completionId = settleId;
|
|
47
46
|
handle.updatedAt = Date.now();
|
|
48
47
|
});
|
|
49
48
|
return id;
|
|
50
49
|
}
|
|
51
|
-
function fireServedTerminalLane(handle) {
|
|
52
|
-
const cb = handle.onServedTerminal;
|
|
53
|
-
if (!cb)
|
|
54
|
-
return;
|
|
55
|
-
handle.onServedTerminal = undefined;
|
|
56
|
-
try {
|
|
57
|
-
cb();
|
|
58
|
-
}
|
|
59
|
-
catch {
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
50
|
export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
63
51
|
const store = handle.store;
|
|
64
52
|
if (store) {
|
|
@@ -70,8 +58,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
|
70
58
|
const out = formatWorkflowRun(run);
|
|
71
59
|
if (run.status === "running" && deadline !== undefined && Date.now() >= deadline)
|
|
72
60
|
out.details.retrieval_status = "timeout";
|
|
73
|
-
else if (run.status !== "running")
|
|
74
|
-
fireServedTerminalLane(handle);
|
|
75
61
|
return out;
|
|
76
62
|
}
|
|
77
63
|
await sleepPollStep(deadline, signal);
|
|
@@ -80,8 +66,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
|
80
66
|
while (handle.status === "running" && deadline !== undefined && Date.now() < deadline && !signal?.aborted) {
|
|
81
67
|
await sleepPollStep(deadline, signal);
|
|
82
68
|
}
|
|
83
|
-
if (handle.status !== "running")
|
|
84
|
-
fireServedTerminalLane(handle);
|
|
85
69
|
return {
|
|
86
70
|
content: JSON.stringify({
|
|
87
71
|
task_id: handle.id,
|
|
@@ -5,11 +5,13 @@ import type { BoundaryLegsGiven } from "./cross-boundary-taint.js";
|
|
|
5
5
|
import type { WorkflowRunStore } from "./workflow-run-store.js";
|
|
6
6
|
import { type BackgroundAgentStore } from "./background-agent-store.js";
|
|
7
7
|
import type { TaskNotificationPayload } from "./task-notification.js";
|
|
8
|
-
import { type TaskArtifactSeat
|
|
8
|
+
import { type TaskArtifactSeat } from "./tool-result-store.js";
|
|
9
9
|
import { type SemaTaskType, type StopSource, type SemaTaskStatus, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type SemaTaskHandle, type TaskAccess, type BackgroundAgentTaskHandle, type MonitorTimers, type RegisterMonitorInput, type RegisterWorkflowInput, canAccessWorkflowRun, clipTaskOutput, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE } from "./task-registry-shared.js";
|
|
10
10
|
export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
|
|
11
11
|
export type { ParkedClaimTicket, RegisterBackgroundAgentInput } from "./task-registry-shared.js";
|
|
12
|
-
import type { RegisterBackgroundAgentInput, ParkedClaimTicket } from "./task-registry-shared.js";
|
|
12
|
+
import type { RegisterBackgroundAgentInput, ParkedClaimTicket, ChildSessionStore } from "./task-registry-shared.js";
|
|
13
|
+
import type { ChildSessionAnchor } from "./task-registry-agent.js";
|
|
14
|
+
import { type DelegationOccupant } from "./task-registry-agent.js";
|
|
13
15
|
import { type AgentStateSource } from "./agent-state.js";
|
|
14
16
|
import type { CheckpointSeat } from "./checkpoint-seat.js";
|
|
15
17
|
export type { SemaTaskType, StopSource, SemaTaskStatus, TaskRetrievalStatus, UnifiedTaskOutput, SemaTaskHandle, TaskAccess, MonitorTimers, RegisterMonitorInput, RegisterWorkflowInput, };
|
|
@@ -31,11 +33,11 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
|
|
|
31
33
|
sessionScoped?: true;
|
|
32
34
|
/** design/116 §7 G2b: when set, the registry WATCHES the process (1s poll, increments spooled with a
|
|
33
35
|
* rolling bound) and fires ONE completion task-notification at the terminal state — the background-bash
|
|
34
|
-
* half of CC's LocalShellTask completion notify. Also flips
|
|
36
|
+
* half of CC's LocalShellTask completion notify. Also flips the host poll to re-readable spool reads. */
|
|
35
37
|
onTerminal?: (notification: TaskNotificationPayload) => void;
|
|
36
38
|
/** The task's OUTPUT FILE — the launch receipt advertises it and the watcher
|
|
37
39
|
* mirrors every polled increment into it (append-only, unbounded — unlike the rolling in-memory
|
|
38
|
-
* spool), so "Read the output file path" is
|
|
40
|
+
* spool), so "Read the output file path" is the model's read of the command's output. Terminal
|
|
39
41
|
* task-notifications carry the same path (`output_file`). Primarily meaningful with `onTerminal`
|
|
40
42
|
* (only the watcher mirrors increments live); a watcher-less row still gets ONE final best-effort
|
|
41
43
|
* append at TaskStop/run-teardown (the tail drain), so the file is written even without a watcher —
|
|
@@ -66,19 +68,13 @@ export interface TaskPollOptions {
|
|
|
66
68
|
* (terminal snapshot / honest cross-instance "running elsewhere"), behind {@link canAccessAgentRecord}. */
|
|
67
69
|
agentStore?: BackgroundAgentStore;
|
|
68
70
|
filter?: string;
|
|
69
|
-
/** design/116 W3
|
|
70
|
-
*
|
|
71
|
-
* defaults this to TRUE (裁定 2026-07-02); registry callers pass it explicitly. */
|
|
71
|
+
/** design/116 W3: wait until the task reaches a terminal state (or `timeoutMs`) instead of returning the
|
|
72
|
+
* instantaneous snapshot. Absent ⇒ the snapshot. */
|
|
72
73
|
block?: boolean;
|
|
73
74
|
/** Max wait for `block` (ms). Default 30s, capped at 600s. */
|
|
74
75
|
timeoutMs?: number;
|
|
75
|
-
/** Abort signal — a blocked wait
|
|
76
|
+
/** Abort signal — a blocked wait stops when the caller cancels. */
|
|
76
77
|
signal?: AbortSignal;
|
|
77
|
-
/** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
|
|
78
|
-
* spills to — the disclosure gains a `ReadToolResult` ref instead of the middle staying gone for
|
|
79
|
-
* good (see {@link import("./task-registry-agent.js").spillClippedAgentResult}). Absent (a
|
|
80
|
-
* deployment that never wired a tool-result store) ⇒ legal degrade, byte-identical to pre-S1 output. */
|
|
81
|
-
toolResultStore?: ToolResultStore;
|
|
82
78
|
/** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
|
|
83
79
|
* answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
|
|
84
80
|
* `unreadable`; nothing else changes. */
|
|
@@ -93,28 +89,8 @@ export interface TaskStopOptions {
|
|
|
93
89
|
export interface TaskToolOptions extends TaskAccess {
|
|
94
90
|
registry: TaskRegistry;
|
|
95
91
|
workflowStore?: WorkflowRunStore;
|
|
96
|
-
/** design/151 S1a: durable agent ledger — threads into
|
|
92
|
+
/** design/151 S1a: durable agent ledger — threads into the stopTask fallback read. */
|
|
97
93
|
agentStore?: BackgroundAgentStore;
|
|
98
|
-
/** the task's soft wall-clock deadline (absolute ms epoch), same source as the Bash
|
|
99
|
-
* foreground clamp (design/130 P2b). When present, a BLOCKING TaskOutput wait is clamped so it
|
|
100
|
-
* cannot eat the write-out window: the model gets an honest, visible clamp note instead of a
|
|
101
|
-
* silent 10-minute blind wait into the finalize wall (TB rs**: 9.1min poll = the exact tax).
|
|
102
|
-
* CC posture note: CC classifies WIND-DOWN waits, and its
|
|
103
|
-
* block cap rides per-query budgets — a deadline-aware wait is the sema equivalent on the tool face. */
|
|
104
|
-
deadlineMs?: () => number | undefined;
|
|
105
|
-
/** design/157 B17 S2 (fable 终判 D4) — whether a terminal <task-notification> is actually wired for
|
|
106
|
-
* this mount. Drives the composed description's notification sentence: the pre-S2 literal advertised
|
|
107
|
-
* the notification unconditionally, which was a false promise on deployments that never wired
|
|
108
|
-
* `taskNotification` (B17 方案查出的既有假广告). Default true (a direct public-API consumer keeps the
|
|
109
|
-
* historical wording); prepare-task passes the real wiring state. */
|
|
110
|
-
notificationWired?: boolean;
|
|
111
|
-
/** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
|
|
112
|
-
* spills to — see {@link TaskPollOptions.toolResultStore} (forwarded verbatim into `pollTask`).
|
|
113
|
-
* Absent ⇒ legal degrade, byte-identical to pre-S1 output. */
|
|
114
|
-
toolResultStore?: ToolResultStore;
|
|
115
|
-
/** The run's checkpoint seat — see {@link TaskPollOptions.checkpointSeat} (forwarded verbatim into
|
|
116
|
-
* `pollTask`). The first-party mount passes the same seat the Agent tool parks children into. */
|
|
117
|
-
checkpointSeat?: CheckpointSeat;
|
|
118
94
|
}
|
|
119
95
|
/** One row of {@link TaskRegistry.list} (and {@link TaskRegistry.liveTasks}): the DISPLAY projection of a task
|
|
120
96
|
* the caller reaches — never the internal handle. One name for the list, the live reading and the walk behind both. */
|
|
@@ -244,7 +220,9 @@ export declare class TaskRegistry {
|
|
|
244
220
|
/** The successful release of child session `sessionId` ends row `id`'s anchor on it — handle and durable
|
|
245
221
|
* record together, and only while the row still names that session (see {@link releaseDurableTranscriptAnchorLane}). */
|
|
246
222
|
releaseDurableTranscriptAnchor(id: string, sessionId: string): void;
|
|
247
|
-
|
|
223
|
+
/** Anchor row `id` to its child session `sessionId`, held through `store` — the store the child's run creates or resumes that
|
|
224
|
+
* session in (see {@link bindBackgroundAgentSessionLane}). */
|
|
225
|
+
bindBackgroundAgentSession(id: string, sessionId: string, store: ChildSessionStore): void;
|
|
248
226
|
registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
|
|
249
227
|
/** #22 — persist this leg's org-memory admission verdict on the durable row (the cross-process
|
|
250
228
|
* revival's only carrier). See {@link recordBackgroundAgentOrgAdmissionLane}. */
|
|
@@ -338,6 +316,9 @@ export declare class TaskRegistry {
|
|
|
338
316
|
* contract (the caps check and the registration form one atomic segment). See
|
|
339
317
|
* {@link activeDelegationHandlesLane}. */
|
|
340
318
|
activeDelegationHandles(scope: string, rootSessionId: string): string[];
|
|
319
|
+
/** The same rows as {@link activeDelegationHandles}, each with its addressing name and whether `caller` reaches it — what a refusal
|
|
320
|
+
* of one more child may tell its caller about who holds the tree's slots. See {@link activeDelegationOccupantsLane}. */
|
|
321
|
+
activeDelegationOccupants(scope: string, rootSessionId: string, caller?: TaskAccess): DelegationOccupant[];
|
|
341
322
|
/** ASYNC (revive arbitration) — the durable half is a guarded ownership claim on the row (awaited before the
|
|
342
323
|
* in-memory flip), so this leg and a cross-process claim arbitrate in one domain instead of both
|
|
343
324
|
* believing they own the cycle. See {@link reviveBackgroundAgentLane}. */
|
|
@@ -377,7 +358,7 @@ export declare class TaskRegistry {
|
|
|
377
358
|
disposition: "queued" | "parked" | "pending";
|
|
378
359
|
} | {
|
|
379
360
|
ok: false;
|
|
380
|
-
reason: "not_found" | "not_running" | "no_channel" | "queue_full";
|
|
361
|
+
reason: "not_found" | "not_running" | "no_channel" | "queue_full" | "refused";
|
|
381
362
|
}>;
|
|
382
363
|
runningBackgroundAgentLabels(access: TaskAccess): string[];
|
|
383
364
|
private pollBackgroundAgent;
|
|
@@ -422,7 +403,7 @@ export declare class TaskRegistry {
|
|
|
422
403
|
private commandRecordSink;
|
|
423
404
|
/** Background output-file read exemption: true iff `canonicalPath` is EXACTLY the registered output
|
|
424
405
|
* file of a background bash or monitor row that (a) the caller can access (same owner/scope/session visibility as
|
|
425
|
-
* a
|
|
406
|
+
* a task poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
|
|
426
407
|
* `env` identity is part of the match, same discipline as {@link runningShellIds}. A canonical path only names a file within ONE env's filesystem
|
|
427
408
|
* namespace: on a shared registry, a row minted on env A must never exempt a same-named outside-root
|
|
428
409
|
* file in env B's namespace (same session or not), so instance equality — never a string proxy — is
|
|
@@ -461,25 +442,9 @@ export declare class TaskRegistry {
|
|
|
461
442
|
* must not be marked, or the next reader would be told a live process had been killed.
|
|
462
443
|
*
|
|
463
444
|
* Attribution only: it never kills anything. The caller has already demonstrated kill capability on the
|
|
464
|
-
* env, which is why there is no access guard
|
|
445
|
+
* env, which is why there is no access guard.
|
|
465
446
|
*/
|
|
466
447
|
markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
|
|
467
|
-
/** design/134 KNOWN-ISSUES close-out (env-direct TaskStop): the stop-source annotation face
|
|
468
|
-
* addressed by the ENV-level shellId — for a kill initiator that holds only the env handle (the
|
|
469
|
-
* registry-less TaskStop band) and is about to `env.killBackground` directly, i.e. without going
|
|
470
|
-
* through {@link stopTask}. Resolves the shellId → unified task id and delegates to
|
|
471
|
-
* {@link markStopSource}, so the running-only + first-marker-wins guards hold unchanged.
|
|
472
|
-
* ⚠️ `env` is REQUIRED for any effect (RB-479-A②, 5.0.0): a shellId without its env is ambiguous
|
|
473
|
-
* by construction on a shared registry, so an env-less call is a NO-OP — this marker is
|
|
474
|
-
* best-effort attribution, not data. No access guard — attribution only (never kills); the
|
|
475
|
-
* caller already demonstrated kill capability on the env. */
|
|
476
|
-
markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
|
|
477
|
-
/** Withdraw a pending stop-source marker after the kill it announced FAILED (小优化批 2026-07-13):
|
|
478
|
-
* a marker left by a failed env-direct kill would win first-marker-wins against the NEXT, real stopper
|
|
479
|
-
* (e.g. a later user TaskStop reads "parent"). Clears ONLY the exact still-pending marker the caller
|
|
480
|
-
* minted — same (shellId, env) resolution as {@link markStopSourceByShellId}; a row already settled,
|
|
481
|
-
* or carrying a different source, is left alone. */
|
|
482
|
-
clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
|
|
483
448
|
/** design/134 §3.3: narrow terminal read for consumers (subagent sinkEmit/notify) — only a KILLED row
|
|
484
449
|
* has an attribution; "system" is the defensive floor for a row that went killed without a landed
|
|
485
450
|
* stoppedBy (e.g. env-direct flips). Returns undefined for running/completed/failed/evicted rows. */
|
|
@@ -491,10 +456,12 @@ export declare class TaskRegistry {
|
|
|
491
456
|
* every registered task kind, workflow included, carries it the same way. Undefined until the task's
|
|
492
457
|
* own settle point has run ({@link mintCompletionId}), or for an id this registry never held. */
|
|
493
458
|
getCompletionId(id: string): string | undefined;
|
|
494
|
-
/** Record the ref a task's
|
|
495
|
-
*
|
|
496
|
-
*
|
|
497
|
-
|
|
459
|
+
/** Record the ref a task's result was stored under (`persistTaskArtifact` landed it) — the read handle a later list of
|
|
460
|
+
* tasks names for it. `completionId` = the settle the result belongs to ({@link getCompletionId}, read in that settle's own
|
|
461
|
+
* synchronous step — every terminal frame carries it): the write records only while the row still holds that settle. A row revived
|
|
462
|
+
* since (a new cycle clears the id and mints its own), replaced under the same id (a revival in another registration),
|
|
463
|
+
* or gone (terminal GC) records nothing — and so does a write that names no settle. */
|
|
464
|
+
recordArtifactRef(id: string, ref: string, completionId: string | undefined): void;
|
|
498
465
|
/** The legs a page-back of `ref` travels (ReadToolResult's per-call reading): a ref holding a background task's result —
|
|
499
466
|
* its origin is part of the ref ({@link taskArtifactOriginOf}), so no row eviction, restart or other store forgets it —
|
|
500
467
|
* travels what a poll of that task travels ({@link boundaryLegsOf}, `"output"` — another tree's agent, a workflow run, a
|
|
@@ -588,7 +555,7 @@ export declare class TaskRegistry {
|
|
|
588
555
|
* `originatingSessionId` — see {@link reapSessionBackground}'s own workflow arm for why) — and runs
|
|
589
556
|
* the per-session reap on each pair; retained rows are left alone (row and process), exactly like the
|
|
590
557
|
* per-session anchor. Timing discipline: call at the hardShutdown TERMINUS, never at drain start — an
|
|
591
|
-
* in-flight turn may still be
|
|
558
|
+
* in-flight turn may still be following a bg process. Returns total rows reaped.
|
|
592
559
|
*
|
|
593
560
|
* Its kills go through each env's `killBackground` (possibly a TERM-then-timer ladder), and it reaches
|
|
594
561
|
* session-resident rows only: every exit terminus calls {@link killAllBackgroundShellsNow} after it. */
|
|
@@ -654,7 +621,7 @@ export declare class TaskRegistry {
|
|
|
654
621
|
* watcher tick that passed its status gate before the settle landed) emits exactly ONE terminal notice.
|
|
655
622
|
* The latch stays set even if the sink throws — a faulty sink must not re-arm it. */
|
|
656
623
|
private notifyTerminalOnce;
|
|
657
|
-
/** G2b watcher (design/116 §7): 1s poll loop that spools increments (rolling bound) and fires ONE
|
|
624
|
+
/** G2b watcher (design/116 §7): 1s poll loop (its first beat at registration) that spools increments (rolling bound) and fires ONE
|
|
658
625
|
* completion notification at the terminal state. `unref()`d — a watcher never keeps the process alive.
|
|
659
626
|
* Stops itself on terminal, on a vanished shell (env disposed), or when the handle is evicted. */
|
|
660
627
|
private startBashWatcher;
|
|
@@ -671,7 +638,7 @@ export declare class TaskRegistry {
|
|
|
671
638
|
* one terminal notification (exit code / timeout / auto-stop / env-side kill). */
|
|
672
639
|
registerMonitor(input: RegisterMonitorInput): string;
|
|
673
640
|
registerWorkflow(input: RegisterWorkflowInput): string;
|
|
674
|
-
/** The legs one
|
|
641
|
+
/** The legs one read of a task's output (`"output"`: a stored artifact read back by ref) or TaskStop (`"stop"`) call travels, read off the handle the call dispatches to by the same
|
|
675
642
|
* resolution the poll and the stop take: a background shell's or a monitor's process lives in its own environment (the `env` leg
|
|
676
643
|
* reaches that one); an agent handle that recorded the calling tree's own token moves nothing across the boundary; any other handle — an
|
|
677
644
|
* agent of another tree, a workflow run, an id no live handle answers (a durable row read back) — is content from beyond the
|
|
@@ -699,6 +666,10 @@ export declare class TaskRegistry {
|
|
|
699
666
|
* cap ({@link list}'s): the one reading of a leg's live background tasks (its end's {@link owedDeliveries}, the post-compaction
|
|
700
667
|
* listing and the resume's orphan diff, the suspend's snapshot), each consumer projecting its own columns from it. */
|
|
701
668
|
liveTasks(access: TaskAccess): TaskListRow[];
|
|
669
|
+
/** The child session task `taskId`'s row is anchored to — its id and the store the child's run holds it through — when
|
|
670
|
+
* `access` reaches the row (the reach {@link list} reads with): `undefined` for an unknown or out-of-reach id, `null` for a
|
|
671
|
+
* reached row with no anchor (no background agent's row, not bound yet, or released). */
|
|
672
|
+
anchoredSession(taskId: string, access: TaskAccess): ChildSessionAnchor | null | undefined;
|
|
702
673
|
/** Every row `access` reaches, newest first, in {@link list}'s projection — the one walk both readings take. */
|
|
703
674
|
private rowsUnder;
|
|
704
675
|
/** Throttled {@link gc} for hot-path callers (design/115 review B5): prepare-task runs once per task,
|
|
@@ -715,5 +686,4 @@ export declare class TaskRegistry {
|
|
|
715
686
|
private stopWorkflow;
|
|
716
687
|
}
|
|
717
688
|
export declare const defaultTaskRegistry: TaskRegistry;
|
|
718
|
-
export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
|
|
719
689
|
export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;
|
|
@@ -11,8 +11,8 @@ import { registerMonitorLane, pollMonitorLane, stopMonitorLane } from "./task-re
|
|
|
11
11
|
import { registerWorkflowLane, pollWorkflowLane, stopWorkflowLane } from "./task-registry-workflow.js";
|
|
12
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";
|
|
13
13
|
export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
|
|
14
|
-
import {
|
|
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";
|
|
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, activeDelegationOccupantsLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
|
|
16
16
|
import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
|
|
17
17
|
import { thrownText } from "./thrown-value.js";
|
|
18
18
|
import { agentStateSourceOfHandle, agentStateSourceOfRecord, agentStateSummary, readAgentState } from "./agent-state.js";
|
|
@@ -26,7 +26,6 @@ function blockDeadline(timeoutMs, now) {
|
|
|
26
26
|
const t = Math.min(BLOCK_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeoutMs ?? BLOCK_DEFAULT_TIMEOUT_MS)));
|
|
27
27
|
return now + t;
|
|
28
28
|
}
|
|
29
|
-
const BLOCK_WAIT_WRITEOUT_RESERVE_MS = 5_000;
|
|
30
29
|
const TASK_PREFIX = {
|
|
31
30
|
background_bash: "b",
|
|
32
31
|
workflow: "w",
|
|
@@ -93,11 +92,11 @@ function commandRecordSink(rowOf, record, guarded, sink) {
|
|
|
93
92
|
const retained = row.spool !== undefined && row.spool.stdout.length + row.spool.stderr.length > 0 ? row.spool : undefined;
|
|
94
93
|
if (row.taskArtifacts === undefined || retained === undefined)
|
|
95
94
|
return sink(gap === "incomplete" ? { ...n, summary: n.summary + commandRecordGapNote(row, gap, undefined) } : n);
|
|
96
|
-
const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text,
|
|
95
|
+
const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, drainNote: "" });
|
|
97
96
|
void persistTaskArtifact(row.taskArtifacts, row.id, body).then((artifact) => {
|
|
98
97
|
const ref = artifact.kind === "stored" ? artifact.ref : undefined;
|
|
99
98
|
if (ref !== undefined)
|
|
100
|
-
record(row.id, ref);
|
|
99
|
+
record(row.id, ref, n.completionId);
|
|
101
100
|
guarded(() => sink(ref === undefined && gap === "missing" ? n : { ...n, summary: n.summary + commandRecordGapNote(row, gap, ref) }));
|
|
102
101
|
});
|
|
103
102
|
};
|
|
@@ -169,8 +168,8 @@ export class TaskRegistry {
|
|
|
169
168
|
releaseDurableTranscriptAnchor(id, sessionId) {
|
|
170
169
|
return releaseDurableTranscriptAnchorLane(this.core, id, sessionId);
|
|
171
170
|
}
|
|
172
|
-
bindBackgroundAgentSession(id, sessionId) {
|
|
173
|
-
return bindBackgroundAgentSessionLane(this.core, id, sessionId);
|
|
171
|
+
bindBackgroundAgentSession(id, sessionId, store) {
|
|
172
|
+
return bindBackgroundAgentSessionLane(this.core, id, sessionId, store);
|
|
174
173
|
}
|
|
175
174
|
registerBackgroundAgent(input) {
|
|
176
175
|
return registerBackgroundAgentLane(this.core, input);
|
|
@@ -232,6 +231,9 @@ export class TaskRegistry {
|
|
|
232
231
|
activeDelegationHandles(scope, rootSessionId) {
|
|
233
232
|
return activeDelegationHandlesLane(this.core, scope, rootSessionId);
|
|
234
233
|
}
|
|
234
|
+
activeDelegationOccupants(scope, rootSessionId, caller) {
|
|
235
|
+
return activeDelegationOccupantsLane(this.core, scope, rootSessionId, caller);
|
|
236
|
+
}
|
|
235
237
|
reviveBackgroundAgent(id, access, abort) {
|
|
236
238
|
return reviveBackgroundAgentLane(this.core, id, access, abort);
|
|
237
239
|
}
|
|
@@ -267,8 +269,8 @@ export class TaskRegistry {
|
|
|
267
269
|
runningBackgroundAgentLabels(access) {
|
|
268
270
|
return runningBackgroundAgentLabelsLane(this.core, access);
|
|
269
271
|
}
|
|
270
|
-
async pollBackgroundAgent(handle, deadline, signal,
|
|
271
|
-
return pollBackgroundAgentLane(handle, deadline, signal,
|
|
272
|
+
async pollBackgroundAgent(handle, deadline, signal, checkpointSeat) {
|
|
273
|
+
return pollBackgroundAgentLane(handle, deadline, signal, checkpointSeat);
|
|
272
274
|
}
|
|
273
275
|
async stopBackgroundAgent(handle) {
|
|
274
276
|
return stopBackgroundAgentLane(this.core, handle);
|
|
@@ -318,7 +320,7 @@ export class TaskRegistry {
|
|
|
318
320
|
return id;
|
|
319
321
|
}
|
|
320
322
|
commandRecordSink(sink) {
|
|
321
|
-
return commandRecordSink((id) => this.handles.get(id), (id, ref) => this.recordArtifactRef(id, ref,
|
|
323
|
+
return commandRecordSink((id) => this.handles.get(id), (id, ref, completionId) => this.recordArtifactRef(id, ref, completionId), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
|
|
322
324
|
}
|
|
323
325
|
isBackgroundOutputFile(canonicalPath, access, env) {
|
|
324
326
|
for (const handle of this.handles.values()) {
|
|
@@ -380,39 +382,6 @@ export class TaskRegistry {
|
|
|
380
382
|
}
|
|
381
383
|
return marked;
|
|
382
384
|
}
|
|
383
|
-
markStopSourceByShellId(shellId, source, env) {
|
|
384
|
-
if (env === undefined)
|
|
385
|
-
return;
|
|
386
|
-
const sid = String(shellId);
|
|
387
|
-
for (const [id, handle] of this.handles) {
|
|
388
|
-
if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
|
|
389
|
-
this.markStopSource(id, source);
|
|
390
|
-
return;
|
|
391
|
-
}
|
|
392
|
-
}
|
|
393
|
-
}
|
|
394
|
-
clearPendingStopSourceByShellId(shellId, source, env) {
|
|
395
|
-
const sid = String(shellId);
|
|
396
|
-
const clear = (id) => {
|
|
397
|
-
const handle = this.handles.get(id);
|
|
398
|
-
if (!handle || handle.type !== "background_bash")
|
|
399
|
-
return false;
|
|
400
|
-
if (env !== undefined && handle.env !== env)
|
|
401
|
-
return false;
|
|
402
|
-
if (handle.status === "running" && handle.stopSource === source && handle.stoppedBy === undefined) {
|
|
403
|
-
handle.stopSource = undefined;
|
|
404
|
-
}
|
|
405
|
-
return true;
|
|
406
|
-
};
|
|
407
|
-
if (env === undefined)
|
|
408
|
-
return;
|
|
409
|
-
for (const [id, handle] of this.handles) {
|
|
410
|
-
if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
|
|
411
|
-
clear(id);
|
|
412
|
-
return;
|
|
413
|
-
}
|
|
414
|
-
}
|
|
415
|
-
}
|
|
416
385
|
getStopAttribution(id) {
|
|
417
386
|
const handle = this.handles.get(id);
|
|
418
387
|
if (!handle || (handle.type !== "background_agent" && handle.type !== "background_bash" && handle.type !== "monitor"))
|
|
@@ -424,11 +393,9 @@ export class TaskRegistry {
|
|
|
424
393
|
getCompletionId(id) {
|
|
425
394
|
return this.handles.get(id)?.completionId;
|
|
426
395
|
}
|
|
427
|
-
recordArtifactRef(id, ref,
|
|
396
|
+
recordArtifactRef(id, ref, completionId) {
|
|
428
397
|
const h = this.handles.get(id);
|
|
429
|
-
if (h === undefined)
|
|
430
|
-
return;
|
|
431
|
-
if ((h.type === "background_agent" ? (h.reviveCycle ?? 0) : 0) !== cycle)
|
|
398
|
+
if (h === undefined || completionId === undefined || h.completionId !== completionId)
|
|
432
399
|
return;
|
|
433
400
|
h.artifactRef = ref;
|
|
434
401
|
}
|
|
@@ -822,6 +789,8 @@ export class TaskRegistry {
|
|
|
822
789
|
if (!ap.ok)
|
|
823
790
|
spool.mirrorFailed = true;
|
|
824
791
|
}
|
|
792
|
+
if (this.handles.get(id) !== handle || handle.status !== "running")
|
|
793
|
+
return stop();
|
|
825
794
|
handle.status = statusFromBackground(r.value.status, r.value.exitCode);
|
|
826
795
|
if (handle.status === "killed" && handle.stoppedBy === undefined) {
|
|
827
796
|
handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
|
|
@@ -888,6 +857,7 @@ export class TaskRegistry {
|
|
|
888
857
|
};
|
|
889
858
|
handle.watcher = setInterval(() => void tick(), 1_000);
|
|
890
859
|
handle.watcher.unref?.();
|
|
860
|
+
void tick();
|
|
891
861
|
}
|
|
892
862
|
runningShellIds(env) {
|
|
893
863
|
const out = [];
|
|
@@ -923,7 +893,7 @@ export class TaskRegistry {
|
|
|
923
893
|
if (handle.type === "background_bash")
|
|
924
894
|
return this.pollBackgroundBash(handle, taskId, access, opts.filter, deadline, opts.signal);
|
|
925
895
|
if (handle.type === "background_agent")
|
|
926
|
-
return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.
|
|
896
|
+
return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.checkpointSeat);
|
|
927
897
|
if (handle.type === "monitor")
|
|
928
898
|
return this.pollMonitor(handle, opts.filter, deadline, opts.signal);
|
|
929
899
|
return this.pollWorkflow(handle, access, deadline, opts.signal);
|
|
@@ -964,7 +934,7 @@ export class TaskRegistry {
|
|
|
964
934
|
state: ${agentStateSummary(agentState)}
|
|
965
935
|
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.`;
|
|
966
936
|
return {
|
|
967
|
-
content: delimitUntrusted(`
|
|
937
|
+
content: delimitUntrusted(`task ${row.handle}`, body),
|
|
968
938
|
isError: true,
|
|
969
939
|
details: {
|
|
970
940
|
task_id: row.handle,
|
|
@@ -1066,6 +1036,10 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1066
1036
|
liveTasks(access) {
|
|
1067
1037
|
return this.rowsUnder(access).filter((t) => t.status === "pending" || t.status === "running" || t.status === "parked");
|
|
1068
1038
|
}
|
|
1039
|
+
anchoredSession(taskId, access) {
|
|
1040
|
+
const h = this.handles.get(taskId);
|
|
1041
|
+
return h !== undefined && canAccess(h, access) ? (childSessionAnchorOf(h) ?? null) : undefined;
|
|
1042
|
+
}
|
|
1069
1043
|
rowsUnder(access) {
|
|
1070
1044
|
const out = [];
|
|
1071
1045
|
for (const h of this.handles.values()) {
|
|
@@ -1080,7 +1054,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1080
1054
|
...((h.type === "background_bash" || h.type === "monitor") && shellRowRetained(h) ? { retained: true } : {}),
|
|
1081
1055
|
...(h.description !== undefined ? { description: h.description } : {}),
|
|
1082
1056
|
...(h.toolUseId !== undefined ? { toolUseId: h.toolUseId } : {}),
|
|
1083
|
-
...(childSession !== undefined ? { sessionId: childSession } : {}),
|
|
1057
|
+
...(childSession !== undefined ? { sessionId: childSession.sessionId } : {}),
|
|
1084
1058
|
createdAt: h.createdAt,
|
|
1085
1059
|
updatedAt: h.updatedAt,
|
|
1086
1060
|
});
|
|
@@ -1164,7 +1138,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1164
1138
|
}
|
|
1165
1139
|
catch {
|
|
1166
1140
|
return {
|
|
1167
|
-
content: `Error (
|
|
1141
|
+
content: `Error (task poll): invalid filter regex: ${filter}`,
|
|
1168
1142
|
details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status: "not_ready" },
|
|
1169
1143
|
isError: true,
|
|
1170
1144
|
};
|
|
@@ -1180,9 +1154,9 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1180
1154
|
const shape = (text) => clipTaskOutput(rx ? text.split(/\r?\n/).filter((l) => rx.test(l)).join("\n") : text, handle.outputFile);
|
|
1181
1155
|
const running = handle.status === "running";
|
|
1182
1156
|
const retrieval = running && deadline !== undefined && Date.now() >= deadline ? "timeout" : "success";
|
|
1183
|
-
const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape,
|
|
1157
|
+
const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, drainNote: "" });
|
|
1184
1158
|
return {
|
|
1185
|
-
content: delimitUntrusted(`
|
|
1159
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
1186
1160
|
details: {
|
|
1187
1161
|
task_id: handle.id,
|
|
1188
1162
|
type: "background_bash",
|
|
@@ -1223,7 +1197,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1223
1197
|
? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}`
|
|
1224
1198
|
: "";
|
|
1225
1199
|
return {
|
|
1226
|
-
content: `Error (
|
|
1200
|
+
content: `Error (task poll): ${r.error.message}${salvaged}`,
|
|
1227
1201
|
details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput ? { details: { replay: INCREMENT_REPLAY } } : {}), error: r.error.code },
|
|
1228
1202
|
isError: true,
|
|
1229
1203
|
};
|
|
@@ -1248,7 +1222,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1248
1222
|
const body = `status: ${displayStatus}\n${droppedNote}--- ${stdoutHeadingOf(INCREMENT_REPLAY, droppedNote !== "")} ---\n${shape(stdout) || "(none)"}\n` +
|
|
1249
1223
|
`--- ${REPLAY_FACE[INCREMENT_REPLAY].stderr} ---\n${shape(stderr) || "(none)"}`;
|
|
1250
1224
|
return {
|
|
1251
|
-
content: delimitUntrusted(`
|
|
1225
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
1252
1226
|
details: {
|
|
1253
1227
|
task_id: handle.id,
|
|
1254
1228
|
type: "background_bash",
|
|
@@ -1354,66 +1328,12 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
|
|
|
1354
1328
|
}
|
|
1355
1329
|
}
|
|
1356
1330
|
export const defaultTaskRegistry = new TaskRegistry();
|
|
1357
|
-
export function createTaskOutputTool(opts) {
|
|
1358
|
-
const caps = { ...REGISTRY_TASK_TOOL_CAPS, notification: opts.notificationWired !== false };
|
|
1359
|
-
return defineTool({
|
|
1360
|
-
name: TASK_OUTPUT_TOOL_NAME,
|
|
1361
|
-
...toolFace("task-output"),
|
|
1362
|
-
ruleFace: mountRuleFace("task-output"),
|
|
1363
|
-
description: composeTaskOutputDescription(caps),
|
|
1364
|
-
parameters: composeTaskOutputParams(caps),
|
|
1365
|
-
boundaryLegsFor: (rawArgs, at) => {
|
|
1366
|
-
const id = resolveTaskIdArg(rawArgs?.task_id);
|
|
1367
|
-
return id ? opts.registry.boundaryLegsOf(id, { owner: opts.owner, scope: opts.scope, ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}) }, "output", at.tree) : { legs: [] };
|
|
1368
|
-
},
|
|
1369
|
-
execute: async (rawArgs, ctx) => {
|
|
1370
|
-
const args = rawArgs;
|
|
1371
|
-
const id = resolveTaskIdArg(args.task_id);
|
|
1372
|
-
if (!id)
|
|
1373
|
-
return errorResult(TASK_OUTPUT_MISSING_ID_MESSAGE);
|
|
1374
|
-
const requestedMs = typeof args.timeout === "number" ? args.timeout : undefined;
|
|
1375
|
-
let effectiveTimeoutMs = requestedMs;
|
|
1376
|
-
let waitClampNote = "";
|
|
1377
|
-
const wall = opts.deadlineMs?.();
|
|
1378
|
-
const requestedWaitMs = Math.max(1, Math.floor(requestedMs ?? BLOCK_DEFAULT_TIMEOUT_MS));
|
|
1379
|
-
if (args.block !== false && wall !== undefined) {
|
|
1380
|
-
const remainMs = wall - Date.now() - BLOCK_WAIT_WRITEOUT_RESERVE_MS;
|
|
1381
|
-
const wantMs = Math.min(BLOCK_MAX_TIMEOUT_MS, requestedWaitMs);
|
|
1382
|
-
if (remainMs <= 0) {
|
|
1383
|
-
effectiveTimeoutMs = 1;
|
|
1384
|
-
waitClampNote =
|
|
1385
|
-
"\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).";
|
|
1386
|
-
}
|
|
1387
|
-
else if (remainMs < wantMs) {
|
|
1388
|
-
effectiveTimeoutMs = remainMs;
|
|
1389
|
-
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.`;
|
|
1390
|
-
}
|
|
1391
|
-
}
|
|
1392
|
-
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 } : {}) }, {
|
|
1393
|
-
workflowStore: opts.workflowStore,
|
|
1394
|
-
agentStore: opts.agentStore,
|
|
1395
|
-
filter: typeof args.filter === "string" ? args.filter : undefined,
|
|
1396
|
-
block: args.block !== false,
|
|
1397
|
-
timeoutMs: effectiveTimeoutMs,
|
|
1398
|
-
signal: ctx.signal,
|
|
1399
|
-
toolResultStore: opts.toolResultStore,
|
|
1400
|
-
checkpointSeat: opts.checkpointSeat,
|
|
1401
|
-
});
|
|
1402
|
-
const { type: taskType, ...rest } = r.details;
|
|
1403
|
-
return {
|
|
1404
|
-
content: r.content + waitClampNote,
|
|
1405
|
-
details: { type: "task-output", ...(taskType !== undefined ? { taskType } : {}), ...(waitClampNote !== "" ? { waitClamped: true } : {}), ...rest },
|
|
1406
|
-
...(r.isError ? { isError: true } : {}),
|
|
1407
|
-
};
|
|
1408
|
-
},
|
|
1409
|
-
});
|
|
1410
|
-
}
|
|
1411
1331
|
export function createTaskStopTool(opts) {
|
|
1412
1332
|
return defineTool({
|
|
1413
1333
|
name: TASK_STOP_TOOL_NAME,
|
|
1414
1334
|
...toolFace("task-stop"),
|
|
1415
1335
|
ruleFace: mountRuleFace("task-stop"),
|
|
1416
|
-
description:
|
|
1336
|
+
description: TASK_STOP_DESCRIPTION,
|
|
1417
1337
|
parameters: TASK_STOP_PARAMS,
|
|
1418
1338
|
boundaryLegsFor: (rawArgs, at) => {
|
|
1419
1339
|
const a = rawArgs;
|