@sema-agent/core 7.60.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 +605 -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 +61 -10
- package/dist/agents/cascade.js +60 -20
- 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-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.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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- 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-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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 +49 -18
- 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 +2 -1
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- 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 +2 -1
- 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 +220 -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.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/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- 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 +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/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 +38 -16
- package/dist/core/mods/stations.js +25 -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 +61 -2
- package/dist/core/own-property-receipt.js +42 -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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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 +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 +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- 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/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/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 +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- 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 +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- 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 +56 -28
- 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 +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-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.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- 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 +40 -29
- 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 +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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/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-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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- 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 +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 +2 -0
- package/dist/core/session-store.js +5 -7
- 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.js +1 -1
- 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 +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- 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 +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +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 +2 -3
- 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 +108 -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-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- 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 +41 -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/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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 +16 -3
- package/dist/stores/file/session-store.js +21 -20
- 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/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/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- 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 +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 +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -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
|
@@ -4,7 +4,7 @@ import { type WorkflowRunStore } from "./workflow-run-store.js";
|
|
|
4
4
|
import type { BackgroundAgentRecord, BackgroundAgentStore } from "./background-agent-store.js";
|
|
5
5
|
import type { WorkflowHandle, WorkflowRun } from "../orchestration/workflow.js";
|
|
6
6
|
import type { TaskNotificationPayload } from "./task-notification.js";
|
|
7
|
-
import type { TaskArtifactSeat
|
|
7
|
+
import type { TaskArtifactSeat } from "./tool-result-store.js";
|
|
8
8
|
import type { AssertAllKeysHandled } from "./ask-origin.js";
|
|
9
9
|
export type SemaTaskType = "background_bash" | "workflow" | "background_agent" | "monitor";
|
|
10
10
|
/** design/134 §3.3 (R3): WHO initiated a kill — recorded at the initiation site (first-marker-wins),
|
|
@@ -86,8 +86,8 @@ export interface UnifiedTaskOutput {
|
|
|
86
86
|
* per-task-kind poll/stop arm). `UnifiedTaskOutput` (the `details` face) has no isError channel of its
|
|
87
87
|
* own — it is a REQUIRED-field wire shape consumed by callers beyond these two tools too, so isError is
|
|
88
88
|
* carried as a sibling on the WRAPPER instead (trap avoidance per the E1 sweep: never carry across isError
|
|
89
|
-
* through a narrower helper contract). Optional, absent/false = success — `
|
|
90
|
-
*
|
|
89
|
+
* through a narrower helper contract). Optional, absent/false = success — `createTaskStopTool` forwards it onto
|
|
90
|
+
* the real `ToolReturn` at the tool boundary. Every internal helper
|
|
91
91
|
* keeps constructing `content`/`details` exactly as before; this only adds a place to say "and this one
|
|
92
92
|
* is a genuine failure" where the failure is actually detected.
|
|
93
93
|
*/
|
|
@@ -152,7 +152,7 @@ export interface BackgroundBashTaskHandle extends SemaTaskHandle {
|
|
|
152
152
|
* (`TaskSpec.retainBackgroundProcesses`) or the env capability declares retain, and by a run teardown
|
|
153
153
|
* whose own spec declares it. In-memory only (shell-lane rows are never persisted); a row without the
|
|
154
154
|
* field reads as not marked. The row is the delivered daemon's ONLY management surface — while the process runs it survives the
|
|
155
|
-
* per-run evict (
|
|
155
|
+
* per-run evict (TaskStop and the host poll resolve through this map; the watcher must stay live to mint
|
|
156
156
|
* the natural-exit receipt) and rides every later run's dispose except-list on the same env
|
|
157
157
|
* ({@link TaskRegistry.runningShellIds}). A terminal row evicts normally. Terminals: explicit
|
|
158
158
|
* TaskStop, the process's own exit (watcher settle), or env destruction (watcher env-death settle)
|
|
@@ -166,7 +166,7 @@ export interface BackgroundBashTaskHandle extends SemaTaskHandle {
|
|
|
166
166
|
* launcher did not know the lane (a host tool registering directly): the owning run's teardown supplies it. */
|
|
167
167
|
retainStatedAtLaunch?: true;
|
|
168
168
|
/** design/116 §7 G2b: when a watcher is attached, the registry accumulates the FULL output here (rolling
|
|
169
|
-
* bound) —
|
|
169
|
+
* bound) — the host poll then serves a RE-READABLE snapshot (CC semantics) instead of a consume-once cursor.
|
|
170
170
|
* `timedOut`/`timeoutSec` record a SELF-INFLICTED background-timeout kill (the env's per-shell budget
|
|
171
171
|
* fired), so later re-readable polls keep rendering it distinguishably from an external stop.
|
|
172
172
|
* `mirrorFailed` records that at least one append to the advertised output FILE failed — the terminal
|
|
@@ -225,8 +225,6 @@ export interface WorkflowTaskHandle extends SemaTaskHandle {
|
|
|
225
225
|
* session end — a would-be regression caught by cross-review before this shipped (see docs/
|
|
226
226
|
* REVIEW-BACKLOG.md's "RB-215 复核" entry for the full incident). */
|
|
227
227
|
sessionScoped?: true;
|
|
228
|
-
/** See {@link RegisterWorkflowInput.onServedTerminal}. Cleared after the single fire. */
|
|
229
|
-
onServedTerminal?: () => void;
|
|
230
228
|
/** The bounded return value, captured on the done-hook so the STORE-LESS in-memory lane's
|
|
231
229
|
* terminal poll can hand it over too (the launch note promises it; without a store there was no result). */
|
|
232
230
|
result?: string;
|
|
@@ -344,7 +342,7 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
344
342
|
* skips it; `reapSessionBackground` is its terminal anchor. Explicit flag, never inferred from key values
|
|
345
343
|
* (hostTaskId===sessionId deployments would otherwise be ambiguous). */
|
|
346
344
|
sessionScoped?: true;
|
|
347
|
-
/** Terminal snapshot (bounded, {@link BG_AGENT_RESULT_MAX} in subagent.ts) — served by
|
|
345
|
+
/** Terminal snapshot (bounded, {@link BG_AGENT_RESULT_MAX} in subagent.ts) — served by the host poll
|
|
348
346
|
* once the child finishes. */
|
|
349
347
|
result?: string;
|
|
350
348
|
/** The FULL result (bounded only by the defensive {@link BG_AGENT_RESULT_FULL_MAX} ceiling
|
|
@@ -353,26 +351,6 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
353
351
|
* ~2-4K chars with no disclosure — clipTaskOutput's own file-pointer/offload-friendly design at the
|
|
354
352
|
* poll layer was structurally unreachable because `result` itself could never be long enough to need it. */
|
|
355
353
|
resultFull?: string;
|
|
356
|
-
/** design/158 S1 (RB-205-B 半) — the tool-result-store ref `resultFull`'s full text was spilled to,
|
|
357
|
-
* the FIRST time a poll's `clipTaskOutput` actually cut it (lazy write, not at settle time). Cached
|
|
358
|
-
* here so every LATER poll within the SAME cycle reuses the same ref instead of re-writing (the
|
|
359
|
-
* store's own `put` is write-once too, but re-deriving/re-calling it every poll would still cost a
|
|
360
|
-
* redundant round-trip on a durable backend, and a changing ref across polls would be a needless
|
|
361
|
-
* disclosure churn). {@link reviveBackgroundAgentLane} clears this on revive — the cycle's full text
|
|
362
|
-
* is gone, so a stale ref must not be reused across cycles. Ref format ties in `reviveCycle` (see
|
|
363
|
-
* {@link import("./task-registry-agent.js").spillClippedAgentResult}) precisely so a revived cycle's
|
|
364
|
-
* eventual spill lands under a DIFFERENT ref rather than colliding with (and being silently refused
|
|
365
|
-
* by the write-once store under) cycle 1's. */
|
|
366
|
-
spillRef?: string;
|
|
367
|
-
/** Backlog #169 — the spill `put` for the CURRENT revive cycle threw or rejected. One-time latch,
|
|
368
|
-
* scoped to the cycle ({@link import("./task-registry-agent.js").reviveBackgroundAgentLane} clears
|
|
369
|
-
* it in lockstep with `spillRef`): later polls serve the clipped text with an honest ref-free loss
|
|
370
|
-
* note instead of retrying the write — the ref is minted deterministically, so the known permanent
|
|
371
|
-
* failure class (the store's write-once/provenance conflict) would fail identically on every poll,
|
|
372
|
-
* each retry a guaranteed-failure round trip to a durable backend. The monitor lane's
|
|
373
|
-
* `spillFailed` twin (same degrade discipline, different write shape — that one is fire-and-forget,
|
|
374
|
-
* this one is awaited). */
|
|
375
|
-
spillFailed?: true;
|
|
376
354
|
error?: string;
|
|
377
355
|
/** RB-386② — the machine-readable failure code beside `error`, threaded from the settle
|
|
378
356
|
* mint point (subagent.ts computes it ONCE from the child's TaskResult.errorCode taxonomy /
|
|
@@ -429,7 +407,7 @@ export interface MonitorTimers {
|
|
|
429
407
|
}
|
|
430
408
|
export declare const defaultMonitorTimers: MonitorTimers;
|
|
431
409
|
/** design/135 G2: Monitor watch — background_bash's near kin, but the watcher streams stdout LINES as
|
|
432
|
-
* batched event notifications instead of firing one terminal notify. Spool stays re-readable (
|
|
410
|
+
* batched event notifications instead of firing one terminal notify. Spool stays re-readable (host poll) and the output file holds the full record. */
|
|
433
411
|
export interface MonitorTaskHandle extends SemaTaskHandle {
|
|
434
412
|
type: "monitor";
|
|
435
413
|
env: ExecutionEnv & BackgroundShellCapability;
|
|
@@ -510,40 +488,6 @@ export interface MonitorTaskHandle extends SemaTaskHandle {
|
|
|
510
488
|
/** Terminal-notification once-latch — same discipline as the bash handle (fidelity R1-3). Only the
|
|
511
489
|
* TERMINAL frame is latched; "event" frames are unaffected. */
|
|
512
490
|
terminalNotified?: true;
|
|
513
|
-
/** design/158 S2 (RB-364 半) — the offload store a ROLLED-OFF spool middle spills to, captured at
|
|
514
|
-
* REGISTRATION time (RegisterMonitorInput's additive field), not per-poll like the background_agent
|
|
515
|
-
* lane's `TaskPollOptions.toolResultStore` (S1): the roll happens inside the watcher tick — an async
|
|
516
|
-
* timer callback with no per-call "access" to thread a store through — so registration is the only
|
|
517
|
-
* point that has one to hang on the handle. Absent ⇒ legal degrade: `rollSpoolText`'s `onDrop` hook
|
|
518
|
-
* is simply never wired, byte-identical to pre-S2 rolling (design/158 §2.2). */
|
|
519
|
-
toolResultStore?: ToolResultStore;
|
|
520
|
-
/** design/158 S2 — the session id spilled refs are scoped under (same `TaskAccess.sessionId` role as
|
|
521
|
-
* every other `buildToolResultRef` call site); captured at registration for the same reason as
|
|
522
|
-
* `toolResultStore` above. */
|
|
523
|
-
spillSessionId?: string;
|
|
524
|
-
/** design/158 S2 — next segment index to mint for the STDOUT dropped-middle ref chain (0-based;
|
|
525
|
-
* design/158 §3 "方案 a": a ref PER dropped segment, chained by index, rather than one ref with an
|
|
526
|
-
* append primitive — ToolResultStore's contract is write-once with no append). stdout and stderr get
|
|
527
|
-
* INDEPENDENT counters (this field vs `spillErrSegCount`) so each stream's own segments concatenate
|
|
528
|
-
* back in original byte order without interleaving the other stream's drops between them. */
|
|
529
|
-
spillSegCount?: number;
|
|
530
|
-
/** design/158 S2 — the STDERR twin of {@link spillSegCount}. */
|
|
531
|
-
spillErrSegCount?: number;
|
|
532
|
-
/** design/158 S2 — cumulative chars (UTF-16 code units, `string.length`) handed to `store.put`
|
|
533
|
-
* across every segment this handle has spilled so far (both streams combined) — the per-handle
|
|
534
|
-
* disk-cap accounting ({@link import("./task-registry-monitor.js")} reads `MONITOR_SPILL_CAP_CHARS`
|
|
535
|
-
* against this). The field used to be named `spillBytesUsed` while the ledger counted
|
|
536
|
-
* chars — renamed to the axis it really measures (see the constant's own doc for why chars). */
|
|
537
|
-
spillCharsUsed?: number;
|
|
538
|
-
/** design/158 S2 — the per-handle spill cap (`MONITOR_SPILL_CAP_CHARS`) was reached; further
|
|
539
|
-
* rolled-off middles are no longer spilled (already-written segments stay readable — "earlier
|
|
540
|
-
* segments retained"). One-time latch; the poll disclosure reads it to stop claiming full ref
|
|
541
|
-
* coverage. */
|
|
542
|
-
spillCapped?: true;
|
|
543
|
-
/** design/158 S2 — at least one `store.put` for this handle rejected or threw. One-time latch; the
|
|
544
|
-
* poll disclosure downgrades its wording once this is set (never claims the ref chain is complete —
|
|
545
|
-
* the fire-and-forget write may have silently failed; see task-registry-monitor.ts's spill helper). */
|
|
546
|
-
spillFailed?: true;
|
|
547
491
|
}
|
|
548
492
|
export type RegisteredTaskHandle = BackgroundBashTaskHandle | WorkflowTaskHandle | BackgroundAgentTaskHandle | MonitorTaskHandle;
|
|
549
493
|
export interface RegisterMonitorInput extends TaskAccess {
|
|
@@ -574,9 +518,6 @@ export interface RegisterMonitorInput extends TaskAccess {
|
|
|
574
518
|
/** Burst capacity of the storm bucket (default MONITOR_STORM_BURST = CC's 10). */
|
|
575
519
|
stormBurst?: number;
|
|
576
520
|
now?: number;
|
|
577
|
-
/** design/158 S2 (RB-364 半) — the offload store a rolled-off spool middle spills to (see
|
|
578
|
-
* {@link MonitorTaskHandle.toolResultStore}). Absent ⇒ legal degrade, byte-identical rolling. */
|
|
579
|
-
toolResultStore?: ToolResultStore;
|
|
580
521
|
/** The watch's output file (see {@link MonitorTaskHandle.outputFile}); absent when it could not be created. */
|
|
581
522
|
outputFile?: string;
|
|
582
523
|
/** See {@link MonitorTaskHandle.taskArtifacts}. */
|
|
@@ -595,13 +536,6 @@ export interface RegisterWorkflowInput extends TaskAccess {
|
|
|
595
536
|
* (its completion notification routes to the session) — deliberately unlike a background agent's
|
|
596
537
|
* live handle, whose sibling-turn invisibility is a channel-discipline ruling (§3.1c). */
|
|
597
538
|
originatingSessionId?: string;
|
|
598
|
-
/**
|
|
599
|
-
* Fired AT MOST ONCE when a `pollTask` through THIS registry entry (= the originating
|
|
600
|
-
* session's own lane; cross-session store-fallback polls don't fire it) serves a TERMINAL snapshot.
|
|
601
|
-
* The RunWorkflow tool wires it to {@link import("../orchestration/run-workflow-tool.js").WorkflowCompletionNotifier.ackServed}
|
|
602
|
-
* so the deployment can drop the now-redundant completion-inbox entry. Errors are swallowed.
|
|
603
|
-
*/
|
|
604
|
-
onServedTerminal?: () => void;
|
|
605
539
|
}
|
|
606
540
|
/** T2A-7 (2026-07-05 soak): one blocked-poll step, CLAMPED to the caller's deadline — a small timeoutMs
|
|
607
541
|
* (e.g. 10ms) must not sleep the full 400ms step (~40× overshoot, and the overshoot window even served a
|
|
@@ -655,31 +589,11 @@ export declare function clipTaskOutput(s: string, fullOutputPath?: string): stri
|
|
|
655
589
|
export declare function statusFromBackground(status: string, exitCode?: number): SemaTaskStatus;
|
|
656
590
|
/** Rolling middle-drop bound for the bash spool, shared by the watcher's per-tick accumulate and the
|
|
657
591
|
* teardown settle's terminal flush: keep head+tail halves within `cap`, account the dropped middle in
|
|
658
|
-
* `rolledChars` (the honesty counter the poll face reports as permanently-dropped bytes).
|
|
659
|
-
*
|
|
660
|
-
* design/158 S2 (RB-364 半): `onDrop`, when given, is called SYNCHRONOUSLY (before this function
|
|
661
|
-
* returns) with exactly the middle substring being dropped — the ONE place that substring is ever
|
|
662
|
-
* materialized, so a caller wanting to preserve it (the monitor lane's spill-to-offload-store) does not
|
|
663
|
-
* need to re-derive the same slice arithmetic a second time. Every EXISTING caller (the background_bash
|
|
664
|
-
* lane, task-registry.ts) omits the 4th argument, so their behavior — return value AND `rolledChars`
|
|
665
|
-
* accounting — is untouched byte-for-byte; the callback is a pure side-channel hook. */
|
|
592
|
+
* `rolledChars` (the honesty counter the poll face reports as permanently-dropped bytes). The full record of
|
|
593
|
+
* a background command or a watch is its output file; the spool is the bounded copy. */
|
|
666
594
|
export declare function rollSpoolText(spool: {
|
|
667
595
|
rolledChars: number;
|
|
668
|
-
}, s: string, cap: number
|
|
669
|
-
/** design/158 S2 (RB-364 半) — per-monitor-handle hard cap on cumulative CHARS (UTF-16 code units)
|
|
670
|
-
* spilled to the offload store (design/158 §3's S3 half, pulled forward alongside S2). Once a
|
|
671
|
-
* handle's running total reaches this, further rolled-off middles are simply not spilled —
|
|
672
|
-
* already-written segments stay readable (the poll disclosure says "earlier segments retained"),
|
|
673
|
-
* matching the pre-S2 loss shape for whatever is dropped PAST the cap. Exported so the boundary is a
|
|
674
|
-
* testable contract, not a buried literal.
|
|
675
|
-
*
|
|
676
|
-
* The constant used to be named
|
|
677
|
-
* `..._BYTES` while the ledger added `dropped.length` — chars, up to ~3× fewer than UTF-8 bytes on
|
|
678
|
-
* multibyte content. CHARS is the axis kept (name changed, arithmetic untouched) because it is the
|
|
679
|
-
* offload store family's own coordinate (`InMemoryToolResultStore.maxTotalChars` evicts by
|
|
680
|
-
* `content.length`; `ToolResultSlice.totalChars`) and the spool's `rolledChars` axis — one unit
|
|
681
|
-
* end-to-end; a `Buffer.byteLength` ledger here would sit crosswise to the store's own cap. */
|
|
682
|
-
export declare const MONITOR_SPILL_CAP_CHARS: number;
|
|
596
|
+
}, s: string, cap: number): string;
|
|
683
597
|
/** Fold one poll's env-side-loss disclosure into the spool's account. The env's
|
|
684
598
|
* tail buffer evicts its HEAD under pressure (node-execution-env 8MB bound) — those bytes are gone
|
|
685
599
|
* before any watcher ever saw them, which is a different loss than the registry-side `rolledChars`
|
|
@@ -771,11 +685,10 @@ export interface RenderableSpool {
|
|
|
771
685
|
dropUnknown?: true;
|
|
772
686
|
}
|
|
773
687
|
/** The per-lane inputs {@link renderSpoolBody} cannot derive from the spool itself.
|
|
774
|
-
* `
|
|
775
|
-
*
|
|
776
|
-
*
|
|
777
|
-
*
|
|
778
|
-
* place. Both are "" on a lane that has no such disclosure. */
|
|
688
|
+
* `drainNote` is a PRE-RENDERED STRING, deliberately not a boolean or a lane discriminator: the renderer must stay
|
|
689
|
+
* ignorant of which lane called it, otherwise the monitor-only disclosure (RB-239 stop-time drain failure) comes back
|
|
690
|
+
* as an in-renderer branch on a kind switch — the exact shape that let the two hand-copied renderers drift in the
|
|
691
|
+
* first place. "" on a lane that has no such disclosure. */
|
|
779
692
|
export interface SpoolBodyOptions {
|
|
780
693
|
/** The handle is still running (drives the "running" display status). */
|
|
781
694
|
running: boolean;
|
|
@@ -783,12 +696,10 @@ export interface SpoolBodyOptions {
|
|
|
783
696
|
handleStatus: SemaTaskStatus;
|
|
784
697
|
/** The lane's filter+clip projection, applied to stdout and stderr alike. */
|
|
785
698
|
shape: (text: string) => string;
|
|
786
|
-
/** Appended INSIDE the roll note, before its newline ("" when the lane has no extra clause). */
|
|
787
|
-
rolledExtraClause: string;
|
|
788
699
|
/** A full banner line (own trailing newline) rendered after the drop note, or "". */
|
|
789
700
|
drainNote: string;
|
|
790
701
|
}
|
|
791
|
-
/** The ONE renderer for a re-readable spool's
|
|
702
|
+
/** The ONE renderer for a re-readable spool's host-poll body,
|
|
792
703
|
* shared by the monitor lane (pollMonitorLane) and the bash spool lane (pollBackgroundBash).
|
|
793
704
|
*
|
|
794
705
|
* Both faces were hand-copied twins carrying three real disclosure bugs' worth of wording (env-side
|
|
@@ -910,14 +821,6 @@ export declare const BG_AGENT_REAP_STOP_ERROR = "stopped (parent task ended or T
|
|
|
910
821
|
* as this resolver, or an NFKC-equivalent spelling (fullwidth "main") skips the reserved lane and
|
|
911
822
|
* reaches the description layers. One normalizer, every name face. */
|
|
912
823
|
export declare function normalizeAgentName(s: string): string;
|
|
913
|
-
/** CC `gtr` (fable 复审 F1 — 亲核 @16169850: NOT plain Levenshtein but OSA / restricted
|
|
914
|
-
* Damerau-Levenshtein, WITH the adjacent-transposition term `o[i][s]=min(o[i][s], o[i-2][s-2]+1)`
|
|
915
|
-
* when `e[i-1]===t[s-2] && e[i-2]===t[s-1]`). The transposition matters: a typo like "tset"→"test"
|
|
916
|
-
* is distance 1 (CC has a Did-you-mean), plain Levenshtein would call it 2. */
|
|
917
|
-
export declare function editDistance(a: string, b: string): number;
|
|
918
|
-
/** CC `htr` shape (206:519814-519827): candidates within Levenshtein ≤2 (length-diff ≤2 pre-filter),
|
|
919
|
-
* best-first; the single best is the "Did you mean" suggestion (`htr(e, keys, 1)[0]`, 206:575196). */
|
|
920
|
-
export declare function closestName(query: string, candidates: Iterable<string>): string | undefined;
|
|
921
824
|
/** DEFAULT-DENY on BOTH axes — the old predicate skipped
|
|
922
825
|
* a missing axis (owner-less handle = readable by everyone in scope; scope-less handle = readable
|
|
923
826
|
* across scopes), splitting polarity with `canAccessAgentRecord` and re-opening the session-axis
|
|
@@ -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) => {
|
|
@@ -39,26 +39,13 @@ export function registerWorkflowLane(core, input) {
|
|
|
39
39
|
if (handle.status !== "cancelled")
|
|
40
40
|
handle.status = "failed";
|
|
41
41
|
handle.error = boundedRedactedSummary(thrownText(err), 500);
|
|
42
|
-
const
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
if (rejectedRun?.completionId !== undefined)
|
|
46
|
-
handle.completionId = rejectedRun.completionId;
|
|
42
|
+
const settledRun = settledRunOf(input.handle.done);
|
|
43
|
+
if (settledRun?.completionId !== undefined)
|
|
44
|
+
handle.completionId = settledRun.completionId;
|
|
47
45
|
handle.updatedAt = Date.now();
|
|
48
46
|
});
|
|
49
47
|
return id;
|
|
50
48
|
}
|
|
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
49
|
export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
63
50
|
const store = handle.store;
|
|
64
51
|
if (store) {
|
|
@@ -70,8 +57,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
|
70
57
|
const out = formatWorkflowRun(run);
|
|
71
58
|
if (run.status === "running" && deadline !== undefined && Date.now() >= deadline)
|
|
72
59
|
out.details.retrieval_status = "timeout";
|
|
73
|
-
else if (run.status !== "running")
|
|
74
|
-
fireServedTerminalLane(handle);
|
|
75
60
|
return out;
|
|
76
61
|
}
|
|
77
62
|
await sleepPollStep(deadline, signal);
|
|
@@ -80,8 +65,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
|
|
|
80
65
|
while (handle.status === "running" && deadline !== undefined && Date.now() < deadline && !signal?.aborted) {
|
|
81
66
|
await sleepPollStep(deadline, signal);
|
|
82
67
|
}
|
|
83
|
-
if (handle.status !== "running")
|
|
84
|
-
fireServedTerminalLane(handle);
|
|
85
68
|
return {
|
|
86
69
|
content: JSON.stringify({
|
|
87
70
|
task_id: handle.id,
|
|
@@ -5,7 +5,7 @@ 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";
|
|
@@ -31,11 +31,11 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
|
|
|
31
31
|
sessionScoped?: true;
|
|
32
32
|
/** design/116 §7 G2b: when set, the registry WATCHES the process (1s poll, increments spooled with a
|
|
33
33
|
* 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
|
|
34
|
+
* half of CC's LocalShellTask completion notify. Also flips the host poll to re-readable spool reads. */
|
|
35
35
|
onTerminal?: (notification: TaskNotificationPayload) => void;
|
|
36
36
|
/** The task's OUTPUT FILE — the launch receipt advertises it and the watcher
|
|
37
37
|
* mirrors every polled increment into it (append-only, unbounded — unlike the rolling in-memory
|
|
38
|
-
* spool), so "Read the output file path" is
|
|
38
|
+
* spool), so "Read the output file path" is the model's read of the command's output. Terminal
|
|
39
39
|
* task-notifications carry the same path (`output_file`). Primarily meaningful with `onTerminal`
|
|
40
40
|
* (only the watcher mirrors increments live); a watcher-less row still gets ONE final best-effort
|
|
41
41
|
* append at TaskStop/run-teardown (the tail drain), so the file is written even without a watcher —
|
|
@@ -66,19 +66,13 @@ export interface TaskPollOptions {
|
|
|
66
66
|
* (terminal snapshot / honest cross-instance "running elsewhere"), behind {@link canAccessAgentRecord}. */
|
|
67
67
|
agentStore?: BackgroundAgentStore;
|
|
68
68
|
filter?: string;
|
|
69
|
-
/** design/116 W3
|
|
70
|
-
*
|
|
71
|
-
* defaults this to TRUE (裁定 2026-07-02); registry callers pass it explicitly. */
|
|
69
|
+
/** design/116 W3: wait until the task reaches a terminal state (or `timeoutMs`) instead of returning the
|
|
70
|
+
* instantaneous snapshot. Absent ⇒ the snapshot. */
|
|
72
71
|
block?: boolean;
|
|
73
72
|
/** Max wait for `block` (ms). Default 30s, capped at 600s. */
|
|
74
73
|
timeoutMs?: number;
|
|
75
|
-
/** Abort signal — a blocked wait
|
|
74
|
+
/** Abort signal — a blocked wait stops when the caller cancels. */
|
|
76
75
|
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
76
|
/** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
|
|
83
77
|
* answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
|
|
84
78
|
* `unreadable`; nothing else changes. */
|
|
@@ -93,28 +87,8 @@ export interface TaskStopOptions {
|
|
|
93
87
|
export interface TaskToolOptions extends TaskAccess {
|
|
94
88
|
registry: TaskRegistry;
|
|
95
89
|
workflowStore?: WorkflowRunStore;
|
|
96
|
-
/** design/151 S1a: durable agent ledger — threads into
|
|
90
|
+
/** design/151 S1a: durable agent ledger — threads into the stopTask fallback read. */
|
|
97
91
|
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
92
|
}
|
|
119
93
|
/** One row of {@link TaskRegistry.list} (and {@link TaskRegistry.liveTasks}): the DISPLAY projection of a task
|
|
120
94
|
* the caller reaches — never the internal handle. One name for the list, the live reading and the walk behind both. */
|
|
@@ -377,7 +351,7 @@ export declare class TaskRegistry {
|
|
|
377
351
|
disposition: "queued" | "parked" | "pending";
|
|
378
352
|
} | {
|
|
379
353
|
ok: false;
|
|
380
|
-
reason: "not_found" | "not_running" | "no_channel" | "queue_full";
|
|
354
|
+
reason: "not_found" | "not_running" | "no_channel" | "queue_full" | "refused";
|
|
381
355
|
}>;
|
|
382
356
|
runningBackgroundAgentLabels(access: TaskAccess): string[];
|
|
383
357
|
private pollBackgroundAgent;
|
|
@@ -422,7 +396,7 @@ export declare class TaskRegistry {
|
|
|
422
396
|
private commandRecordSink;
|
|
423
397
|
/** Background output-file read exemption: true iff `canonicalPath` is EXACTLY the registered output
|
|
424
398
|
* file of a background bash or monitor row that (a) the caller can access (same owner/scope/session visibility as
|
|
425
|
-
* a
|
|
399
|
+
* a task poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
|
|
426
400
|
* `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
401
|
* namespace: on a shared registry, a row minted on env A must never exempt a same-named outside-root
|
|
428
402
|
* file in env B's namespace (same session or not), so instance equality — never a string proxy — is
|
|
@@ -461,25 +435,9 @@ export declare class TaskRegistry {
|
|
|
461
435
|
* must not be marked, or the next reader would be told a live process had been killed.
|
|
462
436
|
*
|
|
463
437
|
* 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
|
|
438
|
+
* env, which is why there is no access guard.
|
|
465
439
|
*/
|
|
466
440
|
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
441
|
/** design/134 §3.3: narrow terminal read for consumers (subagent sinkEmit/notify) — only a KILLED row
|
|
484
442
|
* has an attribution; "system" is the defensive floor for a row that went killed without a landed
|
|
485
443
|
* stoppedBy (e.g. env-direct flips). Returns undefined for running/completed/failed/evicted rows. */
|
|
@@ -491,10 +449,12 @@ export declare class TaskRegistry {
|
|
|
491
449
|
* every registered task kind, workflow included, carries it the same way. Undefined until the task's
|
|
492
450
|
* own settle point has run ({@link mintCompletionId}), or for an id this registry never held. */
|
|
493
451
|
getCompletionId(id: string): string | undefined;
|
|
494
|
-
/** Record the ref a task's
|
|
495
|
-
*
|
|
496
|
-
*
|
|
497
|
-
|
|
452
|
+
/** Record the ref a task's result was stored under (`persistTaskArtifact` landed it) — the read handle a later list of
|
|
453
|
+
* tasks names for it. `completionId` = the settle the result belongs to ({@link getCompletionId}, read in that settle's own
|
|
454
|
+
* synchronous step — every terminal frame carries it): the write records only while the row still holds that settle. A row revived
|
|
455
|
+
* since (a new cycle clears the id and mints its own), replaced under the same id (a revival in another registration),
|
|
456
|
+
* or gone (terminal GC) records nothing — and so does a write that names no settle. */
|
|
457
|
+
recordArtifactRef(id: string, ref: string, completionId: string | undefined): void;
|
|
498
458
|
/** The legs a page-back of `ref` travels (ReadToolResult's per-call reading): a ref holding a background task's result —
|
|
499
459
|
* its origin is part of the ref ({@link taskArtifactOriginOf}), so no row eviction, restart or other store forgets it —
|
|
500
460
|
* travels what a poll of that task travels ({@link boundaryLegsOf}, `"output"` — another tree's agent, a workflow run, a
|
|
@@ -588,7 +548,7 @@ export declare class TaskRegistry {
|
|
|
588
548
|
* `originatingSessionId` — see {@link reapSessionBackground}'s own workflow arm for why) — and runs
|
|
589
549
|
* the per-session reap on each pair; retained rows are left alone (row and process), exactly like the
|
|
590
550
|
* per-session anchor. Timing discipline: call at the hardShutdown TERMINUS, never at drain start — an
|
|
591
|
-
* in-flight turn may still be
|
|
551
|
+
* in-flight turn may still be following a bg process. Returns total rows reaped.
|
|
592
552
|
*
|
|
593
553
|
* Its kills go through each env's `killBackground` (possibly a TERM-then-timer ladder), and it reaches
|
|
594
554
|
* session-resident rows only: every exit terminus calls {@link killAllBackgroundShellsNow} after it. */
|
|
@@ -654,7 +614,7 @@ export declare class TaskRegistry {
|
|
|
654
614
|
* watcher tick that passed its status gate before the settle landed) emits exactly ONE terminal notice.
|
|
655
615
|
* The latch stays set even if the sink throws — a faulty sink must not re-arm it. */
|
|
656
616
|
private notifyTerminalOnce;
|
|
657
|
-
/** G2b watcher (design/116 §7): 1s poll loop that spools increments (rolling bound) and fires ONE
|
|
617
|
+
/** G2b watcher (design/116 §7): 1s poll loop (its first beat at registration) that spools increments (rolling bound) and fires ONE
|
|
658
618
|
* completion notification at the terminal state. `unref()`d — a watcher never keeps the process alive.
|
|
659
619
|
* Stops itself on terminal, on a vanished shell (env disposed), or when the handle is evicted. */
|
|
660
620
|
private startBashWatcher;
|
|
@@ -671,7 +631,7 @@ export declare class TaskRegistry {
|
|
|
671
631
|
* one terminal notification (exit code / timeout / auto-stop / env-side kill). */
|
|
672
632
|
registerMonitor(input: RegisterMonitorInput): string;
|
|
673
633
|
registerWorkflow(input: RegisterWorkflowInput): string;
|
|
674
|
-
/** The legs one
|
|
634
|
+
/** 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
635
|
* 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
636
|
* reaches that one); an agent handle that recorded the calling tree's own token moves nothing across the boundary; any other handle — an
|
|
677
637
|
* agent of another tree, a workflow run, an id no live handle answers (a durable row read back) — is content from beyond the
|
|
@@ -715,5 +675,4 @@ export declare class TaskRegistry {
|
|
|
715
675
|
private stopWorkflow;
|
|
716
676
|
}
|
|
717
677
|
export declare const defaultTaskRegistry: TaskRegistry;
|
|
718
|
-
export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
|
|
719
678
|
export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;
|