@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -4,6 +4,18 @@ import { delimitUntrusted } from "./untrusted-text.js";
|
|
|
4
4
|
import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
5
5
|
import { clipWithFilePointer, OUTPUT_BUDGET_MIN_CHARS } from "./tool-errors.js";
|
|
6
6
|
import { resolveEnvBudget } from "./env-budget.js";
|
|
7
|
+
export function taskReadHandleText(h) {
|
|
8
|
+
const file = namedHandle(h.outputFile);
|
|
9
|
+
if (file !== undefined)
|
|
10
|
+
return `output: Read ${file}`;
|
|
11
|
+
const ref = namedHandle(h.artifactRef);
|
|
12
|
+
if (ref !== undefined)
|
|
13
|
+
return `result: ReadToolResult (ref "${ref}")`;
|
|
14
|
+
return undefined;
|
|
15
|
+
}
|
|
16
|
+
function namedHandle(value) {
|
|
17
|
+
return value !== undefined && value.trim() !== "" ? value : undefined;
|
|
18
|
+
}
|
|
7
19
|
export function mintCompletionId(target) {
|
|
8
20
|
if (target.completionId === undefined)
|
|
9
21
|
target.completionId = uuidv7();
|
|
@@ -77,16 +89,13 @@ export function statusFromBackground(status, exitCode) {
|
|
|
77
89
|
return exitCode === 0 ? "completed" : "failed";
|
|
78
90
|
return "failed";
|
|
79
91
|
}
|
|
80
|
-
export function rollSpoolText(spool, s, cap
|
|
92
|
+
export function rollSpoolText(spool, s, cap) {
|
|
81
93
|
if (s.length <= cap)
|
|
82
94
|
return s;
|
|
83
95
|
const half = Math.floor(cap / 2);
|
|
84
|
-
|
|
85
|
-
spool.rolledChars += dropped.length;
|
|
86
|
-
onDrop?.(dropped);
|
|
96
|
+
spool.rolledChars += s.length - 2 * half;
|
|
87
97
|
return s.slice(0, half) + s.slice(s.length - half);
|
|
88
98
|
}
|
|
89
|
-
export const MONITOR_SPILL_CAP_CHARS = 64 * 1024 * 1024;
|
|
90
99
|
export function accountDroppedBytes(spool, poll) {
|
|
91
100
|
const d = poll.bytesDroppedBeforeCursor ?? 0;
|
|
92
101
|
if (d > 0)
|
|
@@ -115,7 +124,7 @@ export function stdoutHeadingOf(replay, gapDisclosed) {
|
|
|
115
124
|
export function renderSpoolBody(spool, opts) {
|
|
116
125
|
const timedOutClause = spool.timedOut === true ? ` (timed out after ${spool.timeoutSec !== undefined ? `${spool.timeoutSec}s` : "its background time budget"})` : "";
|
|
117
126
|
const displayStatus = (spool.exitCode !== undefined ? `exited(code ${spool.exitCode})` : opts.running ? "running" : opts.handleStatus) + timedOutClause;
|
|
118
|
-
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` : "";
|
|
119
128
|
const droppedNote = spoolDropNote(spool);
|
|
120
129
|
const stdoutHeading = stdoutHeadingOf(SPOOL_REPLAY, droppedNote !== "" || opts.drainNote !== "");
|
|
121
130
|
return (`status: ${displayStatus}\n${rolledNote}${droppedNote}${opts.drainNote}--- ${stdoutHeading} ---\n${opts.shape(spool.stdout) || "(none)"}\n` +
|
|
@@ -137,7 +146,7 @@ export function firstDropNote(spool) {
|
|
|
137
146
|
return note;
|
|
138
147
|
}
|
|
139
148
|
export function alreadyTerminalStopNote(id, status) {
|
|
140
|
-
return `${id} already ${status} — nothing to stop;
|
|
149
|
+
return `${id} already ${status} — nothing to stop; its completion notification carries its final state.`;
|
|
141
150
|
}
|
|
142
151
|
export function assertOwnership(input, site) {
|
|
143
152
|
if (input.owner === undefined || input.scope === undefined) {
|
|
@@ -155,6 +164,8 @@ export function canAccessWorkflowRun(run, access) {
|
|
|
155
164
|
}
|
|
156
165
|
const WORKFLOW_PARTIAL_RESULTS_MAX = 5;
|
|
157
166
|
const WORKFLOW_AGENT_ROWS_MAX = 60;
|
|
167
|
+
const WORKFLOW_POLL_BOUNDS = Object.freeze({ rows: WORKFLOW_AGENT_ROWS_MAX, partialResults: WORKFLOW_PARTIAL_RESULTS_MAX });
|
|
168
|
+
export const WORKFLOW_RECORD_WHOLE = Object.freeze({ rows: Number.POSITIVE_INFINITY, partialResults: Number.POSITIVE_INFINITY });
|
|
158
169
|
function workflowAgentRow(a, ordinal) {
|
|
159
170
|
return {
|
|
160
171
|
ordinal,
|
|
@@ -195,16 +206,16 @@ function timeoutInterruptionNote(interruption) {
|
|
|
195
206
|
` Raising the timeout only helps if that approval gets answered.`
|
|
196
207
|
: ""));
|
|
197
208
|
}
|
|
198
|
-
export function formatWorkflowRun(run) {
|
|
209
|
+
export function formatWorkflowRun(run, bounds = WORKFLOW_POLL_BOUNDS) {
|
|
199
210
|
const summary = summarizeWorkflowRun(run);
|
|
200
211
|
const done = run.agents.filter((a) => a.status === "completed" || a.status === "failed").length;
|
|
201
212
|
const failed = run.agents.filter((a) => a.status === "failed").length;
|
|
202
213
|
const allRows = run.agents.map((a, i) => ({ a, i }));
|
|
203
|
-
const overCap = allRows.length >
|
|
214
|
+
const overCap = allRows.length > bounds.rows;
|
|
204
215
|
const keptRows = overCap
|
|
205
216
|
? (() => {
|
|
206
217
|
const urgent = allRows.filter((r) => r.a.status !== "completed");
|
|
207
|
-
const budget = Math.max(0,
|
|
218
|
+
const budget = Math.max(0, bounds.rows - urgent.length);
|
|
208
219
|
const fill = allRows.filter((r) => r.a.status === "completed").slice(0, budget);
|
|
209
220
|
return [...urgent, ...fill].sort((x, y) => x.i - y.i);
|
|
210
221
|
})()
|
|
@@ -245,12 +256,12 @@ export function formatWorkflowRun(run) {
|
|
|
245
256
|
: {}),
|
|
246
257
|
...(finishedAgents.length > 0
|
|
247
258
|
? {
|
|
248
|
-
partial_results: finishedAgents.slice(0,
|
|
259
|
+
partial_results: finishedAgents.slice(0, bounds.partialResults).map((a) => ({
|
|
249
260
|
agent: a.label,
|
|
250
261
|
output: delimitUntrusted(`workflow agent ${a.label} output`, a.output),
|
|
251
262
|
})),
|
|
252
|
-
...(finishedAgents.length >
|
|
253
|
-
? { partial_results_note: `showing ${
|
|
263
|
+
...(finishedAgents.length > bounds.partialResults
|
|
264
|
+
? { partial_results_note: `showing ${bounds.partialResults} of ${finishedAgents.length} completed agent outputs; the full set remains retrievable from the workflow run record (getWorkflowRun / the workflow journal).` }
|
|
254
265
|
: {}),
|
|
255
266
|
}
|
|
256
267
|
: {}),
|
|
@@ -299,41 +310,6 @@ export function normalizeAgentName(s) {
|
|
|
299
310
|
.toLowerCase()
|
|
300
311
|
.replace(/\s+/g, "-");
|
|
301
312
|
}
|
|
302
|
-
export function editDistance(a, b) {
|
|
303
|
-
if (a === b)
|
|
304
|
-
return 0;
|
|
305
|
-
const m = a.length;
|
|
306
|
-
const n = b.length;
|
|
307
|
-
const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
|
|
308
|
-
for (let i = 1; i <= m; i++) {
|
|
309
|
-
for (let j = 1; j <= n; j++) {
|
|
310
|
-
const cost = a[i - 1] === b[j - 1] ? 0 : 1;
|
|
311
|
-
d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
|
|
312
|
-
if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
|
|
313
|
-
d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
|
|
314
|
-
}
|
|
315
|
-
}
|
|
316
|
-
}
|
|
317
|
-
return d[m][n];
|
|
318
|
-
}
|
|
319
|
-
export function closestName(query, candidates) {
|
|
320
|
-
let best;
|
|
321
|
-
let bestDist = 3;
|
|
322
|
-
const seen = new Set();
|
|
323
|
-
for (const c of candidates) {
|
|
324
|
-
if (seen.has(c))
|
|
325
|
-
continue;
|
|
326
|
-
seen.add(c);
|
|
327
|
-
if (Math.abs(c.length - query.length) > 2)
|
|
328
|
-
continue;
|
|
329
|
-
const dist = editDistance(query, c);
|
|
330
|
-
if (dist <= 2 && dist < bestDist) {
|
|
331
|
-
bestDist = dist;
|
|
332
|
-
best = c;
|
|
333
|
-
}
|
|
334
|
-
}
|
|
335
|
-
return best;
|
|
336
|
-
}
|
|
337
313
|
export function canAccess(handle, access) {
|
|
338
314
|
if (handle.scope === undefined || access.scope === undefined || access.scope !== handle.scope)
|
|
339
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,
|
|
@@ -122,7 +105,7 @@ export async function stopWorkflowLane(handle) {
|
|
|
122
105
|
type: "workflow",
|
|
123
106
|
status: handle.status,
|
|
124
107
|
stopped: false,
|
|
125
|
-
note: `workflow already ${handle.status} — nothing to stop;
|
|
108
|
+
note: `workflow already ${handle.status} — nothing to stop; its completion notification carries its final state.`,
|
|
126
109
|
}),
|
|
127
110
|
details: { task_id: handle.id, type: "workflow", status: handle.status, retrieval_status: "success" },
|
|
128
111
|
};
|
|
@@ -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
|
|
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 —
|
|
@@ -48,6 +48,8 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
|
|
|
48
48
|
* STATES the lane: a later run teardown does not re-judge the row. Absent = the launcher does not know the
|
|
49
49
|
* lane; the owning run's teardown supplies it. */
|
|
50
50
|
retainBackgroundProcesses?: boolean;
|
|
51
|
+
/** See {@link BackgroundBashTaskHandle.taskArtifacts}. */
|
|
52
|
+
taskArtifacts?: TaskArtifactSeat;
|
|
51
53
|
}
|
|
52
54
|
/** One row's receipt from {@link TaskRegistry.killAllBackgroundShellsNow} (closed `outcome` set; `retained`
|
|
53
55
|
* present when the row was retained, whatever the outcome). */
|
|
@@ -64,23 +66,13 @@ export interface TaskPollOptions {
|
|
|
64
66
|
* (terminal snapshot / honest cross-instance "running elsewhere"), behind {@link canAccessAgentRecord}. */
|
|
65
67
|
agentStore?: BackgroundAgentStore;
|
|
66
68
|
filter?: string;
|
|
67
|
-
/** design/116 W3
|
|
68
|
-
*
|
|
69
|
-
* 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. */
|
|
70
71
|
block?: boolean;
|
|
71
72
|
/** Max wait for `block` (ms). Default 30s, capped at 600s. */
|
|
72
73
|
timeoutMs?: number;
|
|
73
|
-
/** Abort signal — a blocked wait
|
|
74
|
+
/** Abort signal — a blocked wait stops when the caller cancels. */
|
|
74
75
|
signal?: AbortSignal;
|
|
75
|
-
/** Mirrors {@link import("./types.js").TaskSpec.oneShot} (see {@link TaskToolOptions.oneShot}
|
|
76
|
-
* for the full contract): forwarded to the background_agent lane's still-running poll body so it
|
|
77
|
-
* does not teach "you will be notified" when this run has no later turn to receive one. */
|
|
78
|
-
oneShot?: boolean;
|
|
79
|
-
/** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
|
|
80
|
-
* spills to — the disclosure gains a `ReadToolResult` ref instead of the middle staying gone for
|
|
81
|
-
* good (see {@link import("./task-registry-agent.js").spillClippedAgentResult}). Absent (a
|
|
82
|
-
* deployment that never wired a tool-result store) ⇒ legal degrade, byte-identical to pre-S1 output. */
|
|
83
|
-
toolResultStore?: ToolResultStore;
|
|
84
76
|
/** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
|
|
85
77
|
* answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
|
|
86
78
|
* `unreadable`; nothing else changes. */
|
|
@@ -95,37 +87,35 @@ export interface TaskStopOptions {
|
|
|
95
87
|
export interface TaskToolOptions extends TaskAccess {
|
|
96
88
|
registry: TaskRegistry;
|
|
97
89
|
workflowStore?: WorkflowRunStore;
|
|
98
|
-
/** design/151 S1a: durable agent ledger — threads into
|
|
90
|
+
/** design/151 S1a: durable agent ledger — threads into the stopTask fallback read. */
|
|
99
91
|
agentStore?: BackgroundAgentStore;
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
/** design/
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
*
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
*
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
*
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
* `pollTask`). The first-party mount passes the same seat the Agent tool parks children into. */
|
|
128
|
-
checkpointSeat?: CheckpointSeat;
|
|
92
|
+
}
|
|
93
|
+
/** One row of {@link TaskRegistry.list} (and {@link TaskRegistry.liveTasks}): the DISPLAY projection of a task
|
|
94
|
+
* the caller reaches — never the internal handle. One name for the list, the live reading and the walk behind both. */
|
|
95
|
+
export interface TaskListRow {
|
|
96
|
+
task_id: string;
|
|
97
|
+
type: SemaTaskType;
|
|
98
|
+
status: SemaTaskStatus;
|
|
99
|
+
/** design/129 lifetime flag, surfaced for observability — on resume-leg deployments the
|
|
100
|
+
* canonical taskId==sessionId, so task- and session-scoped rows share an owner KEY VALUE and only this
|
|
101
|
+
* explicit flag tells them apart. Bulk attribution should use {@link TaskRegistry.markStopSourceForOwner}, not a
|
|
102
|
+
* list()-driven loop (the 500-row cap). */
|
|
103
|
+
sessionScoped: boolean;
|
|
104
|
+
/** Present on a shell-lane row (`background_bash` / `monitor`) that THE retain predicate keeps alive
|
|
105
|
+
* past the automatic reaps — the "keeps running" half of an exit listing: the controlled-exit reap and
|
|
106
|
+
* the hard face under `includeRetained: false` leave it running; every other running shell row stops. */
|
|
107
|
+
retained?: true;
|
|
108
|
+
description?: string;
|
|
109
|
+
toolUseId?: string;
|
|
110
|
+
/** The child session a `background_agent` row is anchored to — absent in the startup window before the
|
|
111
|
+
* bind (right after registration, once the child's session id is fixed), present from the bind until a
|
|
112
|
+
* successful release of that session (a terminal row keeps it until that release or the terminal GC),
|
|
113
|
+
* absent on every other task type. Present means "the registry has not released the anchor", not "the
|
|
114
|
+
* session store still holds the session" — the session store answers that. Only this process's
|
|
115
|
+
* handles are listed: a row known only to the durable store of another process is not here. */
|
|
116
|
+
sessionId?: string;
|
|
117
|
+
createdAt: number;
|
|
118
|
+
updatedAt: number;
|
|
129
119
|
}
|
|
130
120
|
/**
|
|
131
121
|
* RB-49 B-3 (2026-07-25): the row-metadata projection `getAccessibleTask` returns. Was spelled out as a
|
|
@@ -225,7 +215,9 @@ export declare class TaskRegistry {
|
|
|
225
215
|
skippedNoSessions: number;
|
|
226
216
|
orphanPlacedReleased: number;
|
|
227
217
|
}>;
|
|
228
|
-
|
|
218
|
+
/** The successful release of child session `sessionId` ends row `id`'s anchor on it — handle and durable
|
|
219
|
+
* record together, and only while the row still names that session (see {@link releaseDurableTranscriptAnchorLane}). */
|
|
220
|
+
releaseDurableTranscriptAnchor(id: string, sessionId: string): void;
|
|
229
221
|
bindBackgroundAgentSession(id: string, sessionId: string): void;
|
|
230
222
|
registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
|
|
231
223
|
/** #22 — persist this leg's org-memory admission verdict on the durable row (the cross-process
|
|
@@ -359,7 +351,7 @@ export declare class TaskRegistry {
|
|
|
359
351
|
disposition: "queued" | "parked" | "pending";
|
|
360
352
|
} | {
|
|
361
353
|
ok: false;
|
|
362
|
-
reason: "not_found" | "not_running" | "no_channel" | "queue_full";
|
|
354
|
+
reason: "not_found" | "not_running" | "no_channel" | "queue_full" | "refused";
|
|
363
355
|
}>;
|
|
364
356
|
runningBackgroundAgentLabels(access: TaskAccess): string[];
|
|
365
357
|
private pollBackgroundAgent;
|
|
@@ -400,9 +392,11 @@ export declare class TaskRegistry {
|
|
|
400
392
|
private durableHeartbeatTimer;
|
|
401
393
|
mintTaskId(type: SemaTaskType): string;
|
|
402
394
|
registerBackgroundBash(input: RegisterBackgroundBashInput): string;
|
|
395
|
+
/** {@link commandRecordSink} over this registry's rows, ref book and guarded send. */
|
|
396
|
+
private commandRecordSink;
|
|
403
397
|
/** Background output-file read exemption: true iff `canonicalPath` is EXACTLY the registered output
|
|
404
|
-
* file of a background bash row that (a) the caller can access (same owner/scope/session visibility as
|
|
405
|
-
* a
|
|
398
|
+
* file of a background bash or monitor row that (a) the caller can access (same owner/scope/session visibility as
|
|
399
|
+
* a task poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
|
|
406
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
|
|
407
401
|
* namespace: on a shared registry, a row minted on env A must never exempt a same-named outside-root
|
|
408
402
|
* file in env B's namespace (same session or not), so instance equality — never a string proxy — is
|
|
@@ -441,25 +435,9 @@ export declare class TaskRegistry {
|
|
|
441
435
|
* must not be marked, or the next reader would be told a live process had been killed.
|
|
442
436
|
*
|
|
443
437
|
* Attribution only: it never kills anything. The caller has already demonstrated kill capability on the
|
|
444
|
-
* env, which is why there is no access guard
|
|
438
|
+
* env, which is why there is no access guard.
|
|
445
439
|
*/
|
|
446
440
|
markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
|
|
447
|
-
/** design/134 KNOWN-ISSUES close-out (env-direct TaskStop): the stop-source annotation face
|
|
448
|
-
* addressed by the ENV-level shellId — for a kill initiator that holds only the env handle (the
|
|
449
|
-
* registry-less TaskStop band) and is about to `env.killBackground` directly, i.e. without going
|
|
450
|
-
* through {@link stopTask}. Resolves the shellId → unified task id and delegates to
|
|
451
|
-
* {@link markStopSource}, so the running-only + first-marker-wins guards hold unchanged.
|
|
452
|
-
* ⚠️ `env` is REQUIRED for any effect (RB-479-A②, 5.0.0): a shellId without its env is ambiguous
|
|
453
|
-
* by construction on a shared registry, so an env-less call is a NO-OP — this marker is
|
|
454
|
-
* best-effort attribution, not data. No access guard — attribution only (never kills); the
|
|
455
|
-
* caller already demonstrated kill capability on the env. */
|
|
456
|
-
markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
|
|
457
|
-
/** Withdraw a pending stop-source marker after the kill it announced FAILED (小优化批 2026-07-13):
|
|
458
|
-
* a marker left by a failed env-direct kill would win first-marker-wins against the NEXT, real stopper
|
|
459
|
-
* (e.g. a later user TaskStop reads "parent"). Clears ONLY the exact still-pending marker the caller
|
|
460
|
-
* minted — same (shellId, env) resolution as {@link markStopSourceByShellId}; a row already settled,
|
|
461
|
-
* or carrying a different source, is left alone. */
|
|
462
|
-
clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
|
|
463
441
|
/** design/134 §3.3: narrow terminal read for consumers (subagent sinkEmit/notify) — only a KILLED row
|
|
464
442
|
* has an attribution; "system" is the defensive floor for a row that went killed without a landed
|
|
465
443
|
* stoppedBy (e.g. env-direct flips). Returns undefined for running/completed/failed/evicted rows. */
|
|
@@ -471,6 +449,20 @@ export declare class TaskRegistry {
|
|
|
471
449
|
* every registered task kind, workflow included, carries it the same way. Undefined until the task's
|
|
472
450
|
* own settle point has run ({@link mintCompletionId}), or for an id this registry never held. */
|
|
473
451
|
getCompletionId(id: string): string | undefined;
|
|
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;
|
|
458
|
+
/** The legs a page-back of `ref` travels (ReadToolResult's per-call reading): a ref holding a background task's result —
|
|
459
|
+
* its origin is part of the ref ({@link taskArtifactOriginOf}), so no row eviction, restart or other store forgets it —
|
|
460
|
+
* travels what a poll of that task travels ({@link boundaryLegsOf}, `"output"` — another tree's agent, a workflow run, a
|
|
461
|
+
* row gone or out of reach are off-target reads); any other ref (offloaded tool output) stays inside the engine. */
|
|
462
|
+
artifactBoundaryLegs(ref: string, access: TaskAccess, tree: object): BoundaryLegsGiven;
|
|
463
|
+
/** The read handle ({@link taskReadHandleText}) of a task `access` reaches — `undefined` for an unknown or unreachable
|
|
464
|
+
* id (the same info-hiding a poll gives) and for a task with nothing to read beyond its notification. */
|
|
465
|
+
readHandleOf(id: string, access: TaskAccess): string | undefined;
|
|
474
466
|
/** Bulk stop-source attribution for one owner — the registry-side primitive that
|
|
475
467
|
* replaces the service's `list()+markStopSource` per-row loop, which had TWO holes: ① `list()` didn't
|
|
476
468
|
* expose `sessionScoped`, so on the resume leg (canonical taskId==sessionId, rebuilt taskConfig without
|
|
@@ -556,7 +548,7 @@ export declare class TaskRegistry {
|
|
|
556
548
|
* `originatingSessionId` — see {@link reapSessionBackground}'s own workflow arm for why) — and runs
|
|
557
549
|
* the per-session reap on each pair; retained rows are left alone (row and process), exactly like the
|
|
558
550
|
* per-session anchor. Timing discipline: call at the hardShutdown TERMINUS, never at drain start — an
|
|
559
|
-
* in-flight turn may still be
|
|
551
|
+
* in-flight turn may still be following a bg process. Returns total rows reaped.
|
|
560
552
|
*
|
|
561
553
|
* Its kills go through each env's `killBackground` (possibly a TERM-then-timer ladder), and it reaches
|
|
562
554
|
* session-resident rows only: every exit terminus calls {@link killAllBackgroundShellsNow} after it. */
|
|
@@ -622,7 +614,7 @@ export declare class TaskRegistry {
|
|
|
622
614
|
* watcher tick that passed its status gate before the settle landed) emits exactly ONE terminal notice.
|
|
623
615
|
* The latch stays set even if the sink throws — a faulty sink must not re-arm it. */
|
|
624
616
|
private notifyTerminalOnce;
|
|
625
|
-
/** 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
|
|
626
618
|
* completion notification at the terminal state. `unref()`d — a watcher never keeps the process alive.
|
|
627
619
|
* Stops itself on terminal, on a vanished shell (env disposed), or when the handle is evicted. */
|
|
628
620
|
private startBashWatcher;
|
|
@@ -639,7 +631,7 @@ export declare class TaskRegistry {
|
|
|
639
631
|
* one terminal notification (exit code / timeout / auto-stop / env-side kill). */
|
|
640
632
|
registerMonitor(input: RegisterMonitorInput): string;
|
|
641
633
|
registerWorkflow(input: RegisterWorkflowInput): string;
|
|
642
|
-
/** 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
|
|
643
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
|
|
644
636
|
* reaches that one); an agent handle that recorded the calling tree's own token moves nothing across the boundary; any other handle — an
|
|
645
637
|
* agent of another tree, a workflow run, an id no live handle answers (a durable row read back) — is content from beyond the
|
|
@@ -662,28 +654,11 @@ export declare class TaskRegistry {
|
|
|
662
654
|
*/
|
|
663
655
|
list(access: TaskAccess, opts?: {
|
|
664
656
|
limit?: number;
|
|
665
|
-
}):
|
|
666
|
-
task_id: string;
|
|
667
|
-
type: SemaTaskType;
|
|
668
|
-
status: SemaTaskStatus;
|
|
669
|
-
/** design/129 lifetime flag, surfaced for observability — on resume-leg deployments the
|
|
670
|
-
* canonical taskId==sessionId, so task- and session-scoped rows share an owner KEY VALUE and only this
|
|
671
|
-
* explicit flag tells them apart. Bulk attribution should use {@link markStopSourceForOwner}, not a
|
|
672
|
-
* list()-driven loop (the 500-row cap). */
|
|
673
|
-
sessionScoped: boolean;
|
|
674
|
-
/** Present on a shell-lane row (`background_bash` / `monitor`) that THE retain predicate keeps alive
|
|
675
|
-
* past the automatic reaps — the "keeps running" half of an exit listing: the controlled-exit reap and
|
|
676
|
-
* the hard face under `includeRetained: false` leave it running; every other running shell row stops. */
|
|
677
|
-
retained?: true;
|
|
678
|
-
description?: string;
|
|
679
|
-
toolUseId?: string;
|
|
680
|
-
createdAt: number;
|
|
681
|
-
updatedAt: number;
|
|
682
|
-
}>;
|
|
657
|
+
}): TaskListRow[];
|
|
683
658
|
/** The tasks `access` reaches that have not finished (`pending`, `running` or `parked`), newest first — EVERY one, with no display
|
|
684
659
|
* cap ({@link list}'s): the one reading of a leg's live background tasks (its end's {@link owedDeliveries}, the post-compaction
|
|
685
660
|
* listing and the resume's orphan diff, the suspend's snapshot), each consumer projecting its own columns from it. */
|
|
686
|
-
liveTasks(access: TaskAccess):
|
|
661
|
+
liveTasks(access: TaskAccess): TaskListRow[];
|
|
687
662
|
/** Every row `access` reaches, newest first, in {@link list}'s projection — the one walk both readings take. */
|
|
688
663
|
private rowsUnder;
|
|
689
664
|
/** Throttled {@link gc} for hot-path callers (design/115 review B5): prepare-task runs once per task,
|
|
@@ -700,5 +675,4 @@ export declare class TaskRegistry {
|
|
|
700
675
|
private stopWorkflow;
|
|
701
676
|
}
|
|
702
677
|
export declare const defaultTaskRegistry: TaskRegistry;
|
|
703
|
-
export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
|
|
704
678
|
export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;
|