@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
package/dist/agents/subagent.js
CHANGED
|
@@ -2,6 +2,7 @@ import { Type } from "typebox";
|
|
|
2
2
|
import { isAbsolute } from "node:path";
|
|
3
3
|
import { backgroundChildTerminal } from "../core/delegation-frames.js";
|
|
4
4
|
import { bindDelegationName } from "../core/delegation-name.js";
|
|
5
|
+
import { authoredSteerOf } from "../core/input-author.js";
|
|
5
6
|
import { principalNameOf } from "../core/principal-name.js";
|
|
6
7
|
import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-startup-cause.js";
|
|
7
8
|
import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
|
|
@@ -21,8 +22,9 @@ import { childModelSeat, childThinkingSeat, deploymentStatesSubagentModel, deplo
|
|
|
21
22
|
export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
|
|
22
23
|
import { REPORT_BLOCKED_TOOL_NAME } from "../core/runner/synthetic-tools.js";
|
|
23
24
|
import { TOOL_SEARCH_NAME } from "../core/runner/tool-disclosure.js";
|
|
24
|
-
import { OFFLOAD_TOOL_NAME } from "../core/tool-result-store.js";
|
|
25
|
-
import { compileToolSelector, delegationListWhere, namesEveryTool,
|
|
25
|
+
import { OFFLOAD_TOOL_NAME, persistTaskArtifact } from "../core/tool-result-store.js";
|
|
26
|
+
import { compileToolSelector, delegationListWhere, namesEveryTool, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
|
|
27
|
+
import { snapshotDefinitionLists } from "./agent-definition.js";
|
|
26
28
|
import { readToolNameList, snapshotToolNameList } from "../core/tool-name-list.js";
|
|
27
29
|
import { EXTRA_TOOL_NAMES_CODE, delegationPoolFace, extraToolNamesError, firstUndeclaredExtraTool, readExtraToolNames } from "./extra-tool-names.js";
|
|
28
30
|
import { builtinAgentDefinitions } from "./builtin-agents.js";
|
|
@@ -34,6 +36,7 @@ import { hasSessionFork } from "../core/session.js";
|
|
|
34
36
|
import { isDurablePause, pauseFamily } from "./suspend-guard.js";
|
|
35
37
|
import { childRejection, childTerminalFace, childThrownText } from "./child-failure.js";
|
|
36
38
|
import { forwardSafely } from "../core/runner/forward-sink.js";
|
|
39
|
+
import { legTaskIdOf } from "../core/leg-identity.js";
|
|
37
40
|
import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
|
|
38
41
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
39
42
|
import { boundedRedactedSummary } from "../core/untrusted-egress.js";
|
|
@@ -44,7 +47,7 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
|
|
|
44
47
|
import { readDurableOrgAdmission } from "../core/memory-admission.js";
|
|
45
48
|
import { governanceRetryClass } from "../core/governance-codes.js";
|
|
46
49
|
import { readSkillGrantCapture } from "../core/skill-grant.js";
|
|
47
|
-
import {
|
|
50
|
+
import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
|
|
48
51
|
import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX, RUNNING_AGENT_OBSERVE_EVERY_BEATS, DELEGATION_MAX_CONCURRENT_DEFAULT, DELEGATION_MAX_PER_SESSION_DEFAULT } from "../config/defaults.js";
|
|
49
52
|
function rollupDelegatedCost(stats, nested) {
|
|
50
53
|
if (stats.costMicroUsd === undefined)
|
|
@@ -71,15 +74,16 @@ function providerFaultField(child) {
|
|
|
71
74
|
};
|
|
72
75
|
}
|
|
73
76
|
export { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX };
|
|
74
|
-
import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, } from "./retain-ledger.js";
|
|
77
|
+
import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, holdChildDeclarations, } from "./retain-ledger.js";
|
|
75
78
|
import { createPeerInboundChainRef, createPeerSelfRef } from "./peer-admission.js";
|
|
76
79
|
import { recordRosterSpawn } from "./roster-store.js";
|
|
77
80
|
import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./launch-receipt-contract.js";
|
|
78
81
|
import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
|
|
79
|
-
import { SubagentStepRecorder } from "./subagent-steps.js";
|
|
82
|
+
import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
|
|
83
|
+
import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
|
|
80
84
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
81
85
|
import { canonicalNameValue } from "../core/permission-rule-model.js";
|
|
82
|
-
import { inheritedChildPool, inheritedMcpDeclarations } from "./inherited-tool-pool.js";
|
|
86
|
+
import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
|
|
83
87
|
import { readMember, thrownText } from "../core/thrown-value.js";
|
|
84
88
|
const BG_AGENT_RESULT_MAX = 4_000;
|
|
85
89
|
const BG_AGENT_RESULT_FULL_MAX = 200_000;
|
|
@@ -288,11 +292,12 @@ const isolationUnavailable = (content) => notStartedResult({
|
|
|
288
292
|
content,
|
|
289
293
|
details: { error: "isolation.unavailable" },
|
|
290
294
|
});
|
|
291
|
-
export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
|
|
295
|
+
export function createSubagentWorktreeHelper(baseEnv, repoRoot, parentFloor) {
|
|
292
296
|
const handles = new Map();
|
|
297
|
+
const readFloorNow = () => { const readFloor = parentFloor(); return readFloor !== undefined ? { readFloor } : {}; };
|
|
293
298
|
return {
|
|
294
299
|
async mint(childId) {
|
|
295
|
-
const probe = await baseEnv.exec("git rev-parse --is-inside-work-tree", { cwd: repoRoot });
|
|
300
|
+
const probe = await baseEnv.exec("git rev-parse --is-inside-work-tree", { cwd: repoRoot, ...readFloorNow() });
|
|
296
301
|
if (!probe.ok || probe.value.exitCode !== 0) {
|
|
297
302
|
const detail = probe.ok ? (probe.value.stderr || probe.value.stdout).trim().split("\n")[0] : thrownText(probe.error);
|
|
298
303
|
throw Object.assign(new Error(`the working directory ${repoRoot} is not a git repository${detail ? ` (${detail})` : ""}`), { code: WORKTREE_NOT_A_REPOSITORY });
|
|
@@ -300,13 +305,14 @@ export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
|
|
|
300
305
|
const { env, worktreeDir } = await addWorktree(baseEnv, {
|
|
301
306
|
repoRoot,
|
|
302
307
|
sessionId: childId,
|
|
308
|
+
readFloor: parentFloor,
|
|
303
309
|
rootEnvAt: (dir) => Object.create(baseEnv, {
|
|
304
310
|
cwd: { value: dir, configurable: true },
|
|
305
311
|
destroy: { value: undefined, writable: true, configurable: true },
|
|
306
312
|
}),
|
|
307
313
|
});
|
|
308
|
-
const baseSha = await
|
|
309
|
-
.exec("git rev-parse HEAD", { cwd: worktreeDir })
|
|
314
|
+
const baseSha = await Promise.resolve()
|
|
315
|
+
.then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
|
|
310
316
|
.then((r) => (r.ok && r.value.exitCode === 0 ? r.value.stdout.trim() : undefined))
|
|
311
317
|
.catch(() => undefined);
|
|
312
318
|
handles.set(worktreeDir, { destroy: () => env.destroy(), baseSha });
|
|
@@ -316,13 +322,18 @@ export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
|
|
|
316
322
|
const handle = handles.get(worktreeDir);
|
|
317
323
|
handles.delete(worktreeDir);
|
|
318
324
|
let changed = true;
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
325
|
+
try {
|
|
326
|
+
const status = await baseEnv.exec("git status --porcelain", { cwd: worktreeDir, ...readFloorNow() });
|
|
327
|
+
if (status.ok && status.value.exitCode === 0 && handle?.baseSha !== undefined) {
|
|
328
|
+
const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
|
|
329
|
+
const ahead = await baseEnv.exec(`git rev-list --count ${shellQuote(`${handle.baseSha}..HEAD`)}`, { cwd: worktreeDir, ...readFloorNow() });
|
|
330
|
+
const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
|
|
331
|
+
if (commits >= 0)
|
|
332
|
+
changed = dirtyFiles > 0 || commits > 0;
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
catch {
|
|
336
|
+
return "kept";
|
|
326
337
|
}
|
|
327
338
|
if (changed)
|
|
328
339
|
return "kept";
|
|
@@ -343,6 +354,7 @@ const ccElapsedTag = (ms) => {
|
|
|
343
354
|
};
|
|
344
355
|
const ccCompletionText = (desc, settled, rawStatus, elapsedMs) => `Agent "${desc}" ${settled === "killed" ? "stopped" : settled === "completed" ? "finished" : rawStatus}${ccElapsedTag(elapsedMs)}`;
|
|
345
356
|
const SYNC_ESCAPE_SENTENCE = "Pass `run_in_background: false` for a synchronous run when you need the result before continuing (a named agent always runs in the background).";
|
|
357
|
+
export const AGENT_RAN_SYNC_NO_CHANNEL_NOTE = "note: this agent ran synchronously — no completion would come back from a background agent on this mount, so the background lane is not used here.";
|
|
346
358
|
function continuationSentence(toolName, durableRevival, forkOffered) {
|
|
347
359
|
return (`Where the SendMessage tool is mounted, use it with the agent's ID or name to message a RUNNING agent, or — when session retention${durableRevival ? " or durable named-agent revival" : ""} is enabled — ` +
|
|
348
360
|
`to continue a COMPLETED one with its context intact; a new ${toolName} call starts fresh${forkOffered ? ` (except subagent_type: "${FORK_SUBAGENT_TYPE}", which inherits your context)` : ""}.`);
|
|
@@ -485,6 +497,9 @@ function createBgActivityBeat(parentToolCallId, emitTick, noteActivity) {
|
|
|
485
497
|
emitTick(starts);
|
|
486
498
|
};
|
|
487
499
|
}
|
|
500
|
+
function backgroundLegFacts(taskId, cycleSeq) {
|
|
501
|
+
return { delegationTaskType: "background_agent", rowTaskId: taskId, ...(cycleSeq !== undefined ? { cycleSeq } : {}) };
|
|
502
|
+
}
|
|
488
503
|
export function markerFragment() {
|
|
489
504
|
return uuidv7().replace(/-/g, "").slice(-12);
|
|
490
505
|
}
|
|
@@ -516,7 +531,7 @@ export function createSubagentResume(deps) {
|
|
|
516
531
|
assertNoRetiredKeys(deps, RETIRED_RESUME_CLAMP_KEYS, "createSubagentResume");
|
|
517
532
|
assertClampRecord(deps.currentClamps, "createSubagentResume currentClamps");
|
|
518
533
|
const notifier = createSafeNotifier(deps.onNotifyError !== undefined ? { onError: deps.onNotifyError } : undefined);
|
|
519
|
-
const resumeAs = (
|
|
534
|
+
const resumeAs = (by) => async (content) => {
|
|
520
535
|
const ledger = deps.ledger;
|
|
521
536
|
if (!ledger) {
|
|
522
537
|
throw configError("resume unavailable: the parent run did not enable TaskSpec.retainSubagentSessions.", "resume.retain_off");
|
|
@@ -541,8 +556,9 @@ export function createSubagentResume(deps) {
|
|
|
541
556
|
entry.running = true;
|
|
542
557
|
const abort = new AbortController();
|
|
543
558
|
entry.activeAbort = abort;
|
|
559
|
+
const wakeTaskId = legTaskIdOf(entry.specSnapshot, entry.internalsSnapshot, entry.childSessionId);
|
|
544
560
|
const resumeStepRecorder = new SubagentStepRecorder(deps.parentToolCallId);
|
|
545
|
-
resumeStepRecorder.lockTo(
|
|
561
|
+
resumeStepRecorder.lockTo(wakeTaskId);
|
|
546
562
|
const resumeResidual = () => {
|
|
547
563
|
const recentSteps = resumeStepRecorder.recentSteps();
|
|
548
564
|
const editedFiles = resumeStepRecorder.editedFiles();
|
|
@@ -552,6 +568,7 @@ export function createSubagentResume(deps) {
|
|
|
552
568
|
let stream;
|
|
553
569
|
let reviveCycle;
|
|
554
570
|
let reviveEmit;
|
|
571
|
+
let releaseCycleSlot = noopRelease;
|
|
555
572
|
let marker;
|
|
556
573
|
let reviveStartedAt = Date.now();
|
|
557
574
|
try {
|
|
@@ -576,7 +593,7 @@ export function createSubagentResume(deps) {
|
|
|
576
593
|
const wakeClamps = foldClampSources(entry.specSnapshot, deps.currentClamps);
|
|
577
594
|
const resumeSpec = applyClampSeats({
|
|
578
595
|
...entry.specSnapshot,
|
|
579
|
-
objective: createResumePrompt(marker, content,
|
|
596
|
+
objective: createResumePrompt(marker, content, by.author),
|
|
580
597
|
sessionId: entry.childSessionId,
|
|
581
598
|
requireExistingSession: true,
|
|
582
599
|
...(deps.currentOnQuestion !== undefined ? { onQuestion: deps.currentOnQuestion } : {}),
|
|
@@ -644,15 +661,18 @@ export function createSubagentResume(deps) {
|
|
|
644
661
|
sessionId: entry.childSessionId,
|
|
645
662
|
...(deps.parentToolCallId !== undefined ? { parentToolCallId: deps.parentToolCallId } : {}),
|
|
646
663
|
seq: entry.cycleSeq,
|
|
647
|
-
progressTaskId:
|
|
664
|
+
progressTaskId: wakeTaskId,
|
|
648
665
|
...(currentAction !== undefined ? { currentAction } : {}),
|
|
649
666
|
...(currentTool !== undefined ? { currentTool } : {}),
|
|
650
667
|
usage: { toolUses: toolStarts },
|
|
651
668
|
});
|
|
652
669
|
}, deps.registry !== undefined && deps.taskId !== undefined ? () => deps.registry.noteBackgroundAgentActivity(deps.taskId) : undefined);
|
|
670
|
+
releaseCycleSlot = deps.entryGate?.occupy(reviveCycle !== undefined ? "registered" : "local") ?? noopRelease;
|
|
653
671
|
stream = childRunner.runTaskStream(resumeSpec, undefined, {
|
|
654
672
|
...entry.internalsSnapshot,
|
|
655
|
-
...(
|
|
673
|
+
...inheritedHostSeats(deps.currentMcpHostSeats, resumeSpec.mcp ?? []),
|
|
674
|
+
...(deps.currentPlacementTarget !== undefined ? { placementTarget: deps.currentPlacementTarget } : {}),
|
|
675
|
+
objectiveAuthor: by.author,
|
|
656
676
|
cycleSeq: entry.cycleSeq,
|
|
657
677
|
parentInteractionPosture: postureUnderClamps(entry.internalsSnapshot.parentInteractionPosture, { interactiveTools: resumeSpec.interactiveTools, approvalReach: resumeSpec.approvalReach }),
|
|
658
678
|
...(true
|
|
@@ -683,7 +703,7 @@ export function createSubagentResume(deps) {
|
|
|
683
703
|
...(deps.currentParentNotify !== undefined
|
|
684
704
|
? { parentNotify: deps.currentParentNotify, parentPeerRef: deps.currentParentPeerRef }
|
|
685
705
|
: {}),
|
|
686
|
-
peerInboundChainRef: createPeerInboundChainRef(
|
|
706
|
+
peerInboundChainRef: createPeerInboundChainRef(by.author === "peer" ? by.hopChain : undefined),
|
|
687
707
|
...(reviveCycle !== undefined
|
|
688
708
|
? {
|
|
689
709
|
onNotifyInjectorReady: (inject) => {
|
|
@@ -707,12 +727,15 @@ export function createSubagentResume(deps) {
|
|
|
707
727
|
catch (err) {
|
|
708
728
|
entry.running = false;
|
|
709
729
|
entry.activeAbort = undefined;
|
|
730
|
+
releaseCycleSlot();
|
|
710
731
|
throw err;
|
|
711
732
|
}
|
|
712
733
|
if (entry.deferredNotify !== undefined) {
|
|
713
|
-
entry.deferredNotify
|
|
734
|
+
const parked = entry.deferredNotify;
|
|
714
735
|
entry.deferredNotify = undefined;
|
|
736
|
+
notifier.notify(() => parked.cancel(), "subagent.resume.park_cancel");
|
|
715
737
|
}
|
|
738
|
+
oweTerminalDelivery(deps.notify, { task_id: wakeTaskId, task_type: "background_agent" });
|
|
716
739
|
let settleResolve;
|
|
717
740
|
const settled = new Promise((r) => {
|
|
718
741
|
settleResolve = r;
|
|
@@ -737,6 +760,7 @@ export function createSubagentResume(deps) {
|
|
|
737
760
|
const resumeHandbackResult = withHandbackWarning(resumeHandbackWarning, child.result);
|
|
738
761
|
const errCodeRevive = status === "failed" ? childFace.errorCode : undefined;
|
|
739
762
|
const errClassRevive = status === "failed" ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
|
|
763
|
+
let completionIdRevive;
|
|
740
764
|
if (reviveCycle !== undefined && deps.registry !== undefined && deps.taskId !== undefined) {
|
|
741
765
|
try {
|
|
742
766
|
const winner = deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
|
|
@@ -746,14 +770,15 @@ export function createSubagentResume(deps) {
|
|
|
746
770
|
...(errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
|
|
747
771
|
...(errClassRevive !== undefined ? { retryable: errClassRevive.retryable, errorKind: errClassRevive.errorKind } : {}),
|
|
748
772
|
});
|
|
749
|
-
if (winner !== undefined)
|
|
773
|
+
if (winner !== undefined) {
|
|
750
774
|
status = winner;
|
|
775
|
+
completionIdRevive = deps.registry.getCompletionId(deps.taskId);
|
|
776
|
+
}
|
|
751
777
|
}
|
|
752
778
|
catch {
|
|
753
779
|
}
|
|
754
780
|
}
|
|
755
781
|
const stoppedByRevive = status === "killed" ? deps.registry?.getStopAttribution(deps.taskId ?? "") ?? "system" : undefined;
|
|
756
|
-
const completionIdRevive = deps.registry?.getCompletionId(deps.taskId ?? "");
|
|
757
782
|
const reviveName = deps.rowDescription ?? `sub-agent ${marker}`;
|
|
758
783
|
const failReasonRevive = status === "failed" ? childFace.errorMessage : undefined;
|
|
759
784
|
const reviveElapsedMs = Date.now() - reviveStartedAt;
|
|
@@ -771,8 +796,12 @@ export function createSubagentResume(deps) {
|
|
|
771
796
|
named: deps.rowName !== undefined,
|
|
772
797
|
});
|
|
773
798
|
const ownsTerminalFacesRevive = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
|
|
799
|
+
const resumeResultField = await completionResultField(resumeHandbackResult, (report) => persistTaskArtifact(deps.currentTaskArtifacts, wakeTaskId, report), (ref) => {
|
|
800
|
+
if (deps.taskId !== undefined)
|
|
801
|
+
deps.registry?.recordArtifactRef(deps.taskId, ref, completionIdRevive);
|
|
802
|
+
}, notifier);
|
|
774
803
|
const resumeFrame = {
|
|
775
|
-
task_id:
|
|
804
|
+
task_id: wakeTaskId,
|
|
776
805
|
...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
|
|
777
806
|
task_type: "background_agent",
|
|
778
807
|
toolUseId: deps.parentToolCallId,
|
|
@@ -784,7 +813,7 @@ export function createSubagentResume(deps) {
|
|
|
784
813
|
...(failReasonRevive !== undefined ? { error: failReasonRevive.slice(0, REPORT_FIELD_MAX) } : {}),
|
|
785
814
|
...(status === "failed" && errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
|
|
786
815
|
...providerFaultField(child),
|
|
787
|
-
...(
|
|
816
|
+
...(resumeResultField !== undefined ? { result: resumeResultField.text } : {}),
|
|
788
817
|
...(status === "killed" && child.result ? { partial: true } : {}),
|
|
789
818
|
...resumeResidual(),
|
|
790
819
|
resumable: resumableRevive,
|
|
@@ -793,15 +822,15 @@ export function createSubagentResume(deps) {
|
|
|
793
822
|
};
|
|
794
823
|
if (ownsTerminalFacesRevive)
|
|
795
824
|
reviveEmit?.(backgroundChildTerminal(resumeFrame, { taskId: deps.taskId, sessionScoped: deps.sessionScoped === true, sessionId: entry.childSessionId, transcriptId: entry.childSessionId, ...(deps.parentToolCallId !== undefined ? { parentToolCallId: deps.parentToolCallId } : {}) }));
|
|
796
|
-
const
|
|
797
|
-
? entry.childSessionId
|
|
798
|
-
:
|
|
799
|
-
const aliveBgCount =
|
|
800
|
-
if (
|
|
825
|
+
const gateOwners = ownsTerminalFacesRevive && status === "completed" && deps.notify !== undefined && deps.registry !== undefined && ledger.get(deps.parentToolCallId) === entry
|
|
826
|
+
? childOwnerKeys(child.taskId, entry.childSessionId)
|
|
827
|
+
: [];
|
|
828
|
+
const aliveBgCount = deps.registry !== undefined ? runningBackgroundUnder(deps.registry, gateOwners) : 0;
|
|
829
|
+
if (aliveBgCount > 0) {
|
|
801
830
|
parkCompletionNotify({
|
|
802
831
|
registry: deps.registry,
|
|
803
832
|
entry,
|
|
804
|
-
|
|
833
|
+
owners: gateOwners,
|
|
805
834
|
pendingCount: aliveBgCount,
|
|
806
835
|
payload: resumeFrame,
|
|
807
836
|
notify: deps.notify,
|
|
@@ -819,24 +848,26 @@ export function createSubagentResume(deps) {
|
|
|
819
848
|
const msgRevive = childThrownText(e);
|
|
820
849
|
const errCodeReviveReject = abort.signal.aborted ? undefined : thrownErrorCode(e);
|
|
821
850
|
const errClassReviveReject = abort.signal.aborted ? undefined : classifySubagentError({ kind: "failed", ...(errCodeReviveReject !== undefined ? { code: errCodeReviveReject } : {}) });
|
|
851
|
+
let completionIdRejectRevive;
|
|
822
852
|
if (reviveCycle !== undefined && deps.registry !== undefined && deps.taskId !== undefined) {
|
|
823
853
|
try {
|
|
824
|
-
deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
|
|
854
|
+
const winnerReject = deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
|
|
825
855
|
status: abort.signal.aborted ? "killed" : "failed",
|
|
826
856
|
error: msgRevive.slice(0, 500),
|
|
827
857
|
...(errCodeReviveReject !== undefined ? { errorCode: errCodeReviveReject } : {}),
|
|
828
858
|
...(errClassReviveReject !== undefined ? { retryable: errClassReviveReject.retryable, errorKind: errClassReviveReject.errorKind } : {}),
|
|
829
859
|
});
|
|
860
|
+
if (winnerReject !== undefined)
|
|
861
|
+
completionIdRejectRevive = deps.registry.getCompletionId(deps.taskId);
|
|
830
862
|
}
|
|
831
863
|
catch {
|
|
832
864
|
}
|
|
833
865
|
}
|
|
834
866
|
const stoppedByReject = abort.signal.aborted ? deps.registry?.getStopAttribution(deps.taskId ?? "") ?? "system" : undefined;
|
|
835
|
-
const completionIdRejectRevive = deps.registry?.getCompletionId(deps.taskId ?? "");
|
|
836
867
|
const rejectName = deps.rowDescription ?? `sub-agent ${marker}`;
|
|
837
868
|
const ownsTerminalFacesReviveReject = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
|
|
838
869
|
const reviveRejectFrame = {
|
|
839
|
-
task_id:
|
|
870
|
+
task_id: wakeTaskId,
|
|
840
871
|
...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
|
|
841
872
|
task_type: "background_agent",
|
|
842
873
|
toolUseId: deps.parentToolCallId,
|
|
@@ -860,6 +891,7 @@ export function createSubagentResume(deps) {
|
|
|
860
891
|
finally {
|
|
861
892
|
entry.running = false;
|
|
862
893
|
entry.activeAbort = undefined;
|
|
894
|
+
releaseCycleSlot();
|
|
863
895
|
entry.settledAt = Date.now();
|
|
864
896
|
ledger.markSettled(deps.parentToolCallId);
|
|
865
897
|
settleResolve();
|
|
@@ -867,38 +899,8 @@ export function createSubagentResume(deps) {
|
|
|
867
899
|
})();
|
|
868
900
|
return marker;
|
|
869
901
|
};
|
|
870
|
-
const operatorResume = resumeAs(
|
|
871
|
-
return deps.peerOrigin === undefined ? operatorResume : resumeAs(deps.peerOrigin);
|
|
872
|
-
}
|
|
873
|
-
function parkCompletionNotify(deps) {
|
|
874
|
-
const { registry, entry, owner, pendingCount, payload, notify } = deps;
|
|
875
|
-
let done = false;
|
|
876
|
-
const deliver = (decorated) => {
|
|
877
|
-
if (done)
|
|
878
|
-
return;
|
|
879
|
-
done = true;
|
|
880
|
-
unsubscribe();
|
|
881
|
-
if (entry.deferredNotify?.cancel === cancel)
|
|
882
|
-
entry.deferredNotify = undefined;
|
|
883
|
-
try {
|
|
884
|
-
notify(decorated
|
|
885
|
-
? {
|
|
886
|
-
...payload,
|
|
887
|
-
summary: `${payload.summary} (delivered after ${pendingCount} background ${pendingCount === 1 ? "child" : "children"} settled)`,
|
|
888
|
-
}
|
|
889
|
-
: payload, { priority: "next" });
|
|
890
|
-
}
|
|
891
|
-
catch {
|
|
892
|
-
}
|
|
893
|
-
};
|
|
894
|
-
const unsubscribe = registry.onBackgroundQuiescence(owner, (reason) => deliver(reason === "quiescent"));
|
|
895
|
-
const cancel = () => {
|
|
896
|
-
if (done)
|
|
897
|
-
return;
|
|
898
|
-
done = true;
|
|
899
|
-
unsubscribe();
|
|
900
|
-
};
|
|
901
|
-
entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
|
|
902
|
+
const operatorResume = resumeAs({ author: "operator" });
|
|
903
|
+
return deps.peerOrigin === undefined ? operatorResume : resumeAs({ author: "peer", hopChain: deps.peerOrigin.hopChain });
|
|
902
904
|
}
|
|
903
905
|
export function resolveDelegationEntryCaps(caps) {
|
|
904
906
|
const bad = (member, value) => {
|
|
@@ -1109,15 +1111,24 @@ async function untilAbort(p, signal) {
|
|
|
1109
1111
|
signal.removeEventListener("abort", onAbort);
|
|
1110
1112
|
}
|
|
1111
1113
|
}
|
|
1114
|
+
const delegationPoolKey = (scope, root) => JSON.stringify([scope, root]);
|
|
1115
|
+
function delegationEntryPool(seat) {
|
|
1116
|
+
if (seat.root === undefined)
|
|
1117
|
+
return { key: undefined, occupy: () => noopRelease };
|
|
1118
|
+
const key = delegationPoolKey(seat.scope ?? DELEGATION_POOL_DEFAULT_SCOPE, seat.root);
|
|
1119
|
+
return { key, occupy: (kind) => (kind === "local" ? chargeLocalDelegationInFlight(seat.poolAnchor, key) : noopRelease) };
|
|
1120
|
+
}
|
|
1112
1121
|
async function openDelegationEntryGate(input) {
|
|
1113
|
-
const { poolAnchor, registry, store, root, caps,
|
|
1122
|
+
const { poolAnchor, registry, store, root, caps, signal } = input;
|
|
1123
|
+
const pool = delegationEntryPool(input);
|
|
1114
1124
|
if (root === undefined)
|
|
1115
|
-
return {
|
|
1125
|
+
return { ...pool, admit: () => ({ admitted: true, release: noopRelease }) };
|
|
1116
1126
|
const scope = input.scope ?? DELEGATION_POOL_DEFAULT_SCOPE;
|
|
1117
|
-
const key =
|
|
1127
|
+
const key = delegationPoolKey(scope, root);
|
|
1128
|
+
const { occupy } = pool;
|
|
1118
1129
|
let storedHandles = [];
|
|
1119
1130
|
let storedEnumerationOk = false;
|
|
1120
|
-
if (store !== undefined
|
|
1131
|
+
if (store !== undefined) {
|
|
1121
1132
|
try {
|
|
1122
1133
|
storedHandles = (await untilAbort(store.listBySession(scope, root), signal)).map((r) => r.handle);
|
|
1123
1134
|
storedEnumerationOk = true;
|
|
@@ -1140,42 +1151,40 @@ async function openDelegationEntryGate(input) {
|
|
|
1140
1151
|
},
|
|
1141
1152
|
};
|
|
1142
1153
|
}
|
|
1143
|
-
|
|
1144
|
-
|
|
1145
|
-
|
|
1146
|
-
|
|
1147
|
-
|
|
1148
|
-
|
|
1149
|
-
|
|
1150
|
-
|
|
1151
|
-
|
|
1152
|
-
retained = new Set([...storedHandles, ...ledger]).size;
|
|
1153
|
-
}
|
|
1154
|
-
else {
|
|
1155
|
-
const survivors = new Set(storedHandles);
|
|
1156
|
-
for (const h of ledger)
|
|
1157
|
-
if (keep.has(h))
|
|
1158
|
-
survivors.add(h);
|
|
1159
|
-
retained = survivors.size;
|
|
1160
|
-
}
|
|
1154
|
+
const ledger = delegationEntryLedger(poolAnchor, key);
|
|
1155
|
+
let retained;
|
|
1156
|
+
if (store !== undefined && storedEnumerationOk) {
|
|
1157
|
+
const keep = new Set([...storedHandles, ...active]);
|
|
1158
|
+
if (kind === "registered") {
|
|
1159
|
+
for (const h of [...ledger])
|
|
1160
|
+
if (!keep.has(h))
|
|
1161
|
+
ledger.delete(h);
|
|
1162
|
+
retained = new Set([...storedHandles, ...ledger]).size;
|
|
1161
1163
|
}
|
|
1162
1164
|
else {
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
|
|
1167
|
-
|
|
1168
|
-
admitted: false,
|
|
1169
|
-
refusal: {
|
|
1170
|
-
code: "delegation.session_cap",
|
|
1171
|
-
text: `this session tree has already launched ${cumulative} agents in its retained window — the cumulative cap (${caps.maxCumulativePerSession}; RunnerDeps.delegationEntryCaps.maxCumulativePerSession) refuses more. Continue an existing agent (SendMessage) instead of launching new ones.`,
|
|
1172
|
-
},
|
|
1173
|
-
};
|
|
1165
|
+
const survivors = new Set(storedHandles);
|
|
1166
|
+
for (const h of ledger)
|
|
1167
|
+
if (keep.has(h))
|
|
1168
|
+
survivors.add(h);
|
|
1169
|
+
retained = survivors.size;
|
|
1174
1170
|
}
|
|
1175
1171
|
}
|
|
1176
|
-
|
|
1172
|
+
else {
|
|
1173
|
+
retained = ledger.size;
|
|
1174
|
+
}
|
|
1175
|
+
const cumulative = retained + local;
|
|
1176
|
+
if (cumulative >= caps.maxCumulativePerSession) {
|
|
1177
|
+
return {
|
|
1178
|
+
admitted: false,
|
|
1179
|
+
refusal: {
|
|
1180
|
+
code: "delegation.session_cap",
|
|
1181
|
+
text: `this session tree has already launched ${cumulative} agents in its retained window — the cumulative cap (${caps.maxCumulativePerSession}; RunnerDeps.delegationEntryCaps.maxCumulativePerSession) refuses more. Continue an existing agent (SendMessage) instead of launching new ones.`,
|
|
1182
|
+
},
|
|
1183
|
+
};
|
|
1184
|
+
}
|
|
1185
|
+
return { admitted: true, release: occupy(kind) };
|
|
1177
1186
|
};
|
|
1178
|
-
return { key, admit };
|
|
1187
|
+
return { key, admit, occupy };
|
|
1179
1188
|
}
|
|
1180
1189
|
function chargeDelegationEntryHandle(registry, key, store, handle) {
|
|
1181
1190
|
if (handle !== undefined)
|
|
@@ -1184,6 +1193,16 @@ function chargeDelegationEntryHandle(registry, key, store, handle) {
|
|
|
1184
1193
|
armDelegationLedgerLifecycle(registry);
|
|
1185
1194
|
sweepDelegationLedgerRound(registry, 3);
|
|
1186
1195
|
}
|
|
1196
|
+
async function releaseBoundChildSession(bound, sessionId, release) {
|
|
1197
|
+
try {
|
|
1198
|
+
await release();
|
|
1199
|
+
}
|
|
1200
|
+
catch {
|
|
1201
|
+
return false;
|
|
1202
|
+
}
|
|
1203
|
+
bound?.registry.releaseDurableTranscriptAnchor(bound.taskId, sessionId);
|
|
1204
|
+
return true;
|
|
1205
|
+
}
|
|
1187
1206
|
export { normalizeSubagentType } from "../core/permission-rule-model.js";
|
|
1188
1207
|
function canonicalSubagentTypeArgs(args, accepted, generalPurposeShadowed) {
|
|
1189
1208
|
if (args === null || typeof args !== "object" || Array.isArray(args))
|
|
@@ -1246,20 +1265,11 @@ export function forkWorktreeTranslationNote(parentCwd, worktreeDir) {
|
|
|
1246
1265
|
}
|
|
1247
1266
|
export function asyncLaunchedReceipt(p) {
|
|
1248
1267
|
const noteLines = (p.notes ?? []).filter((n) => n !== undefined && n !== "");
|
|
1249
|
-
const oneShotBlocked = p.notify && p.oneShot === true;
|
|
1250
1268
|
return (`Async agent launched successfully. (${launchReceiptNoQuoteClause(", including the task_id below,")})\n` +
|
|
1251
1269
|
`task_id: ${p.taskId} (internal ID - do not mention to user. ${launchContinuationSentence(p.taskId)})\n` +
|
|
1252
|
-
|
|
1253
|
-
? `${p.workingLine} This is a ONE-SHOT submission — there is no later turn for a background notification to land in, so do NOT end your turn expecting one. Actively wait instead: TaskOutput(task_id: "${p.taskId}", block: true). If it is still running after the wait, wait again (bounded) rather than ending the turn, or write out your best available answer now if you are near your own time budget.\n`
|
|
1254
|
-
: p.notify
|
|
1255
|
-
? `${p.workingLine} You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.\n`
|
|
1256
|
-
: `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
|
|
1270
|
+
`${p.workingLine} You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.\n` +
|
|
1257
1271
|
noteLines.map((n) => `${n}\n`).join("") +
|
|
1258
|
-
|
|
1259
|
-
? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Do not assume a later message will deliver the result: this submission ends after this turn, so retrieve it now with the blocking TaskOutput wait above before writing your final answer.`
|
|
1260
|
-
: p.notify
|
|
1261
|
-
? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Agent results will arrive in a subsequent message. If the user asks for progress, say the agent is still running.`
|
|
1262
|
-
: `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} The result will NOT arrive on its own — retrieve it with TaskOutput(task_id) where mounted before relying on it.`));
|
|
1272
|
+
`${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Agent results will arrive in a subsequent message. If the user asks for progress, say the agent is still running.`);
|
|
1263
1273
|
}
|
|
1264
1274
|
function runnerModelCatalog(runner) {
|
|
1265
1275
|
try {
|
|
@@ -1387,10 +1397,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1387
1397
|
const depthPermitsNesting = depth + 1 < maxDepth;
|
|
1388
1398
|
const agentToolFaces = [
|
|
1389
1399
|
...(generalPurposeShadowed ? [] : [{ name: GENERAL_PURPOSE_SUBAGENT_TYPE, ...(depthPermitsNesting ? { canRedelegate: true } : {}) }]),
|
|
1390
|
-
...available.map((a) => ({
|
|
1400
|
+
...available.map((a) => ({ a, allow: definitionAllowTools(a) })).map(({ a, allow }) => ({
|
|
1391
1401
|
name: a.name,
|
|
1392
|
-
...(
|
|
1402
|
+
...(allow !== undefined ? { allowTools: allow } : {}),
|
|
1393
1403
|
...(a.denyTools !== undefined ? { denyTools: a.denyTools } : {}),
|
|
1404
|
+
...(a.mcp !== undefined && a.mcp.length > 0 ? { servers: a.mcp.map((s) => ({ name: s.name, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) })) } : {}),
|
|
1394
1405
|
...(depthPermitsNesting && toolNameAllowed(delegationToolName, a.allowTools, a.denyTools) ? { canRedelegate: true } : {}),
|
|
1395
1406
|
...(depth === 0 && !builtins.includes(a) ? { authored: true } : {}),
|
|
1396
1407
|
})),
|
|
@@ -1428,7 +1439,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1428
1439
|
: `- Each agent type's model, thinking level, and tools come from its agent definition.\n`) +
|
|
1429
1440
|
`- \`isolation: "worktree"\` gives the agent its own git worktree (auto-cleaned if unchanged).` +
|
|
1430
1441
|
(opts.background
|
|
1431
|
-
? `\n- Subagents run in the background by default
|
|
1442
|
+
? `\n- Subagents run in the background by default; you'll be notified when one completes. ${SYNC_ESCAPE_SENTENCE} Never fabricate or predict a pending agent's results — the notification is never something you write yourself; if the user asks before it arrives, say it's still running.\n` +
|
|
1432
1443
|
`- ${continuationSentence(opts.name ?? DEFAULT_SUBAGENT_TOOL_NAME, opts.background.agentStore !== undefined, forkOffered)}`
|
|
1433
1444
|
: `\n- \`run_in_background\` is unavailable here — only synchronous subagents.`),
|
|
1434
1445
|
descriptionVariants: [{ id: "classic", traits: { noneOf: ["lean_prompt"] }, text: `Launch a new agent. Delegate a self-contained subtask to an isolated sub-agent and get back a single report. ` +
|
|
@@ -1457,11 +1468,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1457
1468
|
`\nSet isolation: "worktree" to give the agent its own detached git worktree (auto-removed if it made no changes; kept for you to inspect/merge when it did).` +
|
|
1458
1469
|
(opts.background
|
|
1459
1470
|
?
|
|
1460
|
-
|
|
1461
|
-
? `\n\nAgents run in the background by default. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead. ${SYNC_ESCAPE_SENTENCE}`
|
|
1462
|
-
: `\n\nAgents run in the background by default. A background agent's result is not pushed automatically — the launch receipt's task_id retrieves progress and results via the TaskOutput tool where mounted. ${SYNC_ESCAPE_SENTENCE}`) +
|
|
1471
|
+
`\n\nAgents run in the background by default. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead. ${SYNC_ESCAPE_SENTENCE}` +
|
|
1463
1472
|
` ${continuationSentence(opts.name ?? DEFAULT_SUBAGENT_TOOL_NAME, opts.background.agentStore !== undefined, forkOffered)}` +
|
|
1464
|
-
`\n\n**Don't race.** After launching, you know nothing about what the agent found. Never fabricate or predict agent results in any format — not as prose, summary, or structured output.
|
|
1473
|
+
`\n\n**Don't race.** After launching, you know nothing about what the agent found. Never fabricate or predict agent results in any format — not as prose, summary, or structured output. The notification arrives as a user-role message in a later turn; it is never something you write yourself.`
|
|
1465
1474
|
: `\n\nThe run_in_background parameter is not available in this context. Only synchronous subagents are supported.`) }],
|
|
1466
1475
|
parameters: Type.Object({
|
|
1467
1476
|
subagent_type: Type.Optional(Type.String({ description: "The type of specialized agent to use for this task" })),
|
|
@@ -1488,9 +1497,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1488
1497
|
...(opts.background
|
|
1489
1498
|
? {
|
|
1490
1499
|
run_in_background: Type.Optional(Type.Boolean({
|
|
1491
|
-
description:
|
|
1492
|
-
? "Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background)."
|
|
1493
|
-
: "Agents run in the background by default; the launch receipt's task_id retrieves progress and results via the TaskOutput tool where mounted. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background).",
|
|
1500
|
+
description: "Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background).",
|
|
1494
1501
|
})),
|
|
1495
1502
|
}
|
|
1496
1503
|
: {}),
|
|
@@ -1504,10 +1511,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1504
1511
|
const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
|
|
1505
1512
|
const parentSpecSeat = parentSpecSeatOfCtx(ctx);
|
|
1506
1513
|
const reviveClaim = ctx.reviveClaim;
|
|
1507
|
-
|
|
1514
|
+
const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification, opts.background.notify) : undefined;
|
|
1515
|
+
const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
|
|
1516
|
+
if (reviveClaim !== undefined && !backgroundLane) {
|
|
1508
1517
|
return notStartedResult({
|
|
1509
1518
|
isError: true,
|
|
1510
|
-
content: "Sub-agent not revived: this delegation tool has no background surface
|
|
1519
|
+
content: "Sub-agent not revived: no background lane is available here (this delegation tool has no background surface, or no completion would come back from a background agent on this mount), and a revival is a background run by definition.",
|
|
1511
1520
|
details: { error: "revive.no_background" },
|
|
1512
1521
|
});
|
|
1513
1522
|
}
|
|
@@ -1565,7 +1574,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1565
1574
|
});
|
|
1566
1575
|
}
|
|
1567
1576
|
}
|
|
1568
|
-
const
|
|
1577
|
+
const backgroundAsked = opts.background !== undefined && (a.run_in_background !== false || def?.background === true || agentName !== undefined);
|
|
1578
|
+
const wantsBackground = backgroundLane && backgroundAsked;
|
|
1579
|
+
const ranSyncNote = backgroundAsked && !backgroundLane ? AGENT_RAN_SYNC_NO_CHANNEL_NOTE : undefined;
|
|
1580
|
+
const stations = reviveClaim === undefined ? ctx.agentStations : undefined;
|
|
1581
|
+
const extensionSpawn = stations?.extensionSpawn(ctx.toolCallId);
|
|
1582
|
+
if (extensionSpawn !== undefined && !wantsBackground) {
|
|
1583
|
+
return notStartedResult({ isError: true, content: `Sub-agent not started: an extension's spawn runs in the background, and this one would hold the foreground (${backgroundLane ? "the call as it was let go asks to run in the foreground" : "this delegation tool has no background lane here"}).`, details: { error: "mods.spawn_foreground" } });
|
|
1584
|
+
}
|
|
1569
1585
|
if (a.cwd !== undefined && typeof a.cwd !== "string") {
|
|
1570
1586
|
return notStartedResult({ isError: true, content: "Sub-agent not started: cwd must be an absolute path string.", details: { error: "cwd.relative" } });
|
|
1571
1587
|
}
|
|
@@ -1726,6 +1742,29 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1726
1742
|
details: { error: "skill_grants.unreadable" },
|
|
1727
1743
|
});
|
|
1728
1744
|
}
|
|
1745
|
+
if (extensionSpawn === undefined && stations?.listens("agent.offer") === true) {
|
|
1746
|
+
const listed = agentListing.find((entry) => entry.name === spawnAgentType);
|
|
1747
|
+
const offered = await stations.offered([{ name: spawnAgentType, description: listed?.description ?? "" }], ctx.signal);
|
|
1748
|
+
if (offered.length === 0) {
|
|
1749
|
+
return notStartedResult({ isError: true, content: `Sub-agent not started: subagent_type "${inlineUntrusted(spawnAgentType, 80)}" is not offered here. Available subagent_type values are the ones the agent listing names.`, details: { error: "unknown subagent_type" } });
|
|
1750
|
+
}
|
|
1751
|
+
}
|
|
1752
|
+
if (stations?.listens("agent.spawn") === true) {
|
|
1753
|
+
const verdict = await stations.spawn({
|
|
1754
|
+
toolCallId: ctx.toolCallId,
|
|
1755
|
+
prompt,
|
|
1756
|
+
description: typeof a.description === "string" ? a.description : "",
|
|
1757
|
+
subagentType: spawnAgentType,
|
|
1758
|
+
...(spawnModel !== undefined ? { model: spawnModel } : {}),
|
|
1759
|
+
...(ctx.model?.id !== undefined ? { parentModel: ctx.model.id } : {}),
|
|
1760
|
+
background: wantsBackground,
|
|
1761
|
+
fork: wantsFork,
|
|
1762
|
+
...(agentName !== undefined ? { name: agentName } : {}),
|
|
1763
|
+
...(childCwd !== undefined ? { cwd: childCwd } : {}),
|
|
1764
|
+
}, ctx.signal);
|
|
1765
|
+
if (!verdict.go)
|
|
1766
|
+
return notStartedResult({ isError: true, content: `Sub-agent not started: ${verdict.reason.slice(0, 600)}`, details: { error: "mods.spawn_refused", refusedBy: verdict.by } });
|
|
1767
|
+
}
|
|
1729
1768
|
let worktreeDir;
|
|
1730
1769
|
if (reviveClaim === undefined && (a.isolation ?? def?.isolation) === "worktree") {
|
|
1731
1770
|
const iso = ctx.worktreeIsolation;
|
|
@@ -1848,13 +1887,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1848
1887
|
}
|
|
1849
1888
|
childPool = [...(opts.tools ?? inherited.filter((t) => ![t.name, ...(t.aliases ?? [])].some((n) => taken.has(n)))), ...accepted];
|
|
1850
1889
|
}
|
|
1851
|
-
const governingLists = def !== undefined ? { allow: def
|
|
1890
|
+
const governingLists = def !== undefined ? { allow: definitionAllowTools(def), deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
|
|
1852
1891
|
const childOwnLayer = Object.freeze({ ...(governingLists.allow != null ? { allow: Object.freeze([...governingLists.allow]) } : {}), deny: Object.freeze([...(governingLists.deny ?? [])]) });
|
|
1853
1892
|
const childListsDigest = toolListsDigest(childOwnLayer.allow, childOwnLayer.deny);
|
|
1854
1893
|
const childListsJudged = agentToolPool !== undefined ? childListsDigest : undefined;
|
|
1855
1894
|
const childCeiling = ctx.toolSelector?.layers ?? [];
|
|
1856
|
-
const
|
|
1857
|
-
const
|
|
1895
|
+
const mountedMcpNow = ctx.mountedMcp?.();
|
|
1896
|
+
const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? mountedMcpNow : undefined;
|
|
1897
|
+
const childMcp = withDefinitionServers(parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined, def?.mcp);
|
|
1858
1898
|
const childTools = [...childPool];
|
|
1859
1899
|
const childRoleBase = roleBaseOf([def !== undefined ? { systemPrompt: def.systemPrompt } : undefined, { promptRole: opts.promptRole, systemPrompt: opts.systemPrompt }]);
|
|
1860
1900
|
const childSystemPrompt = childRoleBase?.systemPrompt;
|
|
@@ -1903,13 +1943,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1903
1943
|
pendingTrigger = [];
|
|
1904
1944
|
return joined;
|
|
1905
1945
|
};
|
|
1906
|
-
const injectObservedRequest = async (text,
|
|
1946
|
+
const injectObservedRequest = async (text, author) => {
|
|
1907
1947
|
const steer = observedSteerRef.steer;
|
|
1908
1948
|
if (!steer)
|
|
1909
1949
|
throw new Error("observed child has no steer lane (report undeliverable)");
|
|
1910
|
-
if (
|
|
1950
|
+
if (author !== "observer")
|
|
1911
1951
|
pendingTrigger.push(text);
|
|
1912
|
-
await steer(text);
|
|
1952
|
+
await steer(author, text);
|
|
1913
1953
|
};
|
|
1914
1954
|
if (observerArm) {
|
|
1915
1955
|
pendingTrigger.push(prompt);
|
|
@@ -1960,7 +2000,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1960
2000
|
...(parentGate.shellGate !== undefined ? { shellGate: parentGate.shellGate } : {}),
|
|
1961
2001
|
admittedOrgScopes: parentGate.admittedOrgScopes,
|
|
1962
2002
|
};
|
|
1963
|
-
const observerInternals = { ...(ctx.interactionPosture !== undefined ? { parentInteractionPosture: ctx.interactionPosture } : {}), ...(pickedRef !== undefined ? { inheritedModelRef: pickedRef } : {}), ...(observerGate !== undefined ? { inheritedGate: observerGate } : {}), toolCeiling: [...childCeiling, childOwnLayer], observerLeg: true };
|
|
2003
|
+
const observerInternals = { ...(ctx.interactionPosture !== undefined ? { parentInteractionPosture: ctx.interactionPosture } : {}), ...(pickedRef !== undefined ? { inheritedModelRef: pickedRef } : {}), ...(observerGate !== undefined ? { inheritedGate: observerGate } : {}), toolCeiling: [...childCeiling, childOwnLayer], observerLeg: true, objectiveAuthor: "observer" };
|
|
1964
2004
|
const r = await opts.runner.runTask(spec, observerInternals);
|
|
1965
2005
|
if (r.terminal.kind !== "completed") {
|
|
1966
2006
|
const endedFace = childTerminalFace(r.terminal);
|
|
@@ -2102,16 +2142,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2102
2142
|
const entryCapRoot = reviveClaim !== undefined
|
|
2103
2143
|
? (reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId ?? (reviveClaim.row.sessionScoped ? reviveClaim.row.owner : undefined))
|
|
2104
2144
|
: (ctx.rootSessionId ?? ctx.sessionId);
|
|
2105
|
-
const
|
|
2106
|
-
|
|
2107
|
-
registry: opts.background?.registry,
|
|
2108
|
-
store: opts.background?.agentStore,
|
|
2109
|
-
scope: treeScope,
|
|
2110
|
-
root: entryCapRoot,
|
|
2111
|
-
caps: entryCaps,
|
|
2112
|
-
revival: reviveClaim !== undefined,
|
|
2113
|
-
signal: ctx.signal,
|
|
2114
|
-
});
|
|
2145
|
+
const entryPoolSeat = { poolAnchor: entryCapPoolAnchor, scope: treeScope, root: entryCapRoot };
|
|
2146
|
+
const openEntryGate = () => openDelegationEntryGate({ ...entryPoolSeat, registry: opts.background?.registry, store: opts.background?.agentStore, caps: entryCaps, signal: ctx.signal });
|
|
2115
2147
|
const provenanceRequest = ctx.delegationProvenanceForChildren?.();
|
|
2116
2148
|
const childProvenanceRef = provenanceRequest !== undefined ? { current: newDelegationProvenanceAggregate() } : undefined;
|
|
2117
2149
|
const childAttestation = (completed) => childProvenanceRef !== undefined ? reduceDelegationAttestation(childProvenanceRef.current, { completed }) : undefined;
|
|
@@ -2123,7 +2155,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2123
2155
|
const childInternals = {
|
|
2124
2156
|
...(ctx.toolSelector !== undefined ? { toolCeiling: childCeiling, ...(childListsJudged !== undefined ? { toolListsJudged: childListsJudged } : {}) } : {}),
|
|
2125
2157
|
...(childListsDigest !== undefined ? { ownToolLists: { toolName, ...(def !== undefined ? { definition: def.name } : {}), lists: childListsDigest } } : {}),
|
|
2126
|
-
...(
|
|
2158
|
+
...(mountedMcpNow?.pool !== undefined && childMcp.length > 0 ? { mcpPool: mountedMcpNow.pool } : {}),
|
|
2159
|
+
...inheritedHostSeats(mountedMcpNow?.hostSeats, childMcp),
|
|
2127
2160
|
...(childPick.modelRef !== undefined ? { inheritedModelRef: childPick.modelRef } : {}),
|
|
2128
2161
|
...(inheritedSkillGrants.length > 0 ? { inheritedSkillGrants } : {}),
|
|
2129
2162
|
...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
|
|
@@ -2143,6 +2176,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2143
2176
|
peerInboundChainRef: createPeerInboundChainRef(reviveClaim?.peerSeed?.hopChain),
|
|
2144
2177
|
...(childDefaultPersona !== undefined ? { defaultSystemPrompt: childDefaultPersona } : {}),
|
|
2145
2178
|
isDelegatedChild: true,
|
|
2179
|
+
objectiveAuthor: reviveClaim !== undefined ? "peer" : "parent_model",
|
|
2146
2180
|
...(childPosture !== undefined ? { parentInteractionPosture: childPosture } : {}),
|
|
2147
2181
|
...(reviveClaim === undefined
|
|
2148
2182
|
? {
|
|
@@ -2187,6 +2221,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2187
2221
|
...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
|
|
2188
2222
|
onForwardEvent: recordingForward,
|
|
2189
2223
|
...(ctx.parentCwd !== undefined ? { callerRoot: ctx.parentCwd } : {}),
|
|
2224
|
+
...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
|
|
2190
2225
|
...(worktreeDir !== undefined
|
|
2191
2226
|
? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
|
|
2192
2227
|
: childCwd !== undefined
|
|
@@ -2215,7 +2250,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2215
2250
|
...childSeat,
|
|
2216
2251
|
...childThinking,
|
|
2217
2252
|
tools: childTools,
|
|
2218
|
-
...(childMcp
|
|
2253
|
+
...(childMcp.length > 0 ? { mcp: childMcp } : {}),
|
|
2219
2254
|
systemPrompt: childSystemPrompt,
|
|
2220
2255
|
...(childRoleBase?.promptRole !== undefined ? { promptRole: childRoleBase.promptRole } : {}),
|
|
2221
2256
|
...(def?.memory ? { memory: def.memory } : {}),
|
|
@@ -2236,14 +2271,27 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2236
2271
|
signal,
|
|
2237
2272
|
}, parentSpecSeat));
|
|
2238
2273
|
const spawnPolicyFloor = () => clampSeatsOf(buildChildSpec(undefined));
|
|
2239
|
-
const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe,
|
|
2274
|
+
const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, bound, internalsExtra) => {
|
|
2240
2275
|
if (!ledger)
|
|
2241
2276
|
return undefined;
|
|
2242
2277
|
const childSessionId = preMintedSessionId ?? uuidv7();
|
|
2243
2278
|
const retainStrip = stripSpawnTurnQuestionFace(buildChildSpec(undefined));
|
|
2244
2279
|
const { signal: _spawnSignal, ...plainSpec } = retainStrip.spec;
|
|
2280
|
+
const launchesOnThisId = preMintedSessionId !== undefined;
|
|
2281
|
+
let releasing;
|
|
2282
|
+
const releaseEntry = () => (releasing ??= (async () => {
|
|
2283
|
+
try {
|
|
2284
|
+
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2285
|
+
}
|
|
2286
|
+
catch {
|
|
2287
|
+
}
|
|
2288
|
+
if (durableProbe && (await durableProbe().catch(() => false)))
|
|
2289
|
+
return;
|
|
2290
|
+
await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
|
|
2291
|
+
})());
|
|
2245
2292
|
let entry = ledger.register(ctx.toolCallId, {
|
|
2246
2293
|
childSessionId,
|
|
2294
|
+
declarations: holdChildDeclarations(opts.runner, plainSpec),
|
|
2247
2295
|
runner: opts.runner,
|
|
2248
2296
|
...(entryTtlMs !== undefined ? { ttlMs: entryTtlMs } : {}),
|
|
2249
2297
|
...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
|
|
@@ -2260,22 +2308,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2260
2308
|
...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
|
|
2261
2309
|
...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
|
|
2262
2310
|
}),
|
|
2263
|
-
internalsSnapshot: { ...childInternals, ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
|
|
2264
|
-
release:
|
|
2265
|
-
try {
|
|
2266
|
-
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2267
|
-
}
|
|
2268
|
-
catch {
|
|
2269
|
-
}
|
|
2270
|
-
if (durableProbe && (await durableProbe().catch(() => false)))
|
|
2271
|
-
return;
|
|
2272
|
-
try {
|
|
2273
|
-
await opts.runner.sessions.release(childSessionId);
|
|
2274
|
-
releaseAnchor?.();
|
|
2275
|
-
}
|
|
2276
|
-
catch {
|
|
2277
|
-
}
|
|
2278
|
-
},
|
|
2311
|
+
internalsSnapshot: { ...withoutWakerSeats(childInternals), ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
|
|
2312
|
+
release: releaseEntry,
|
|
2279
2313
|
});
|
|
2280
2314
|
if (entry) {
|
|
2281
2315
|
try {
|
|
@@ -2283,21 +2317,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2283
2317
|
}
|
|
2284
2318
|
catch {
|
|
2285
2319
|
await ledger.evict(ctx.toolCallId);
|
|
2320
|
+
if (launchesOnThisId)
|
|
2321
|
+
await releaseEntry();
|
|
2286
2322
|
entry = undefined;
|
|
2287
2323
|
}
|
|
2288
2324
|
if (entry !== undefined && (ledger.disposed || ledger.get(ctx.toolCallId) !== entry)) {
|
|
2325
|
+
if (launchesOnThisId)
|
|
2326
|
+
await releaseEntry();
|
|
2289
2327
|
try {
|
|
2290
2328
|
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2291
2329
|
}
|
|
2292
2330
|
catch {
|
|
2293
2331
|
}
|
|
2294
2332
|
if (!(durableProbe && (await durableProbe().catch(() => false)))) {
|
|
2295
|
-
|
|
2296
|
-
await opts.runner.sessions.release(childSessionId);
|
|
2297
|
-
releaseAnchor?.();
|
|
2298
|
-
}
|
|
2299
|
-
catch {
|
|
2300
|
-
}
|
|
2333
|
+
await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
|
|
2301
2334
|
}
|
|
2302
2335
|
entry = undefined;
|
|
2303
2336
|
}
|
|
@@ -2327,6 +2360,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2327
2360
|
const { signal: _spawnSignal, ...plainSpec } = failedRetainStrip.spec;
|
|
2328
2361
|
const entry = ledger.register(ctx.toolCallId, {
|
|
2329
2362
|
childSessionId,
|
|
2363
|
+
declarations: holdChildDeclarations(opts.runner, plainSpec),
|
|
2330
2364
|
runner: opts.runner,
|
|
2331
2365
|
ttlMs: FAILED_SESSION_RETAIN_TTL_MS,
|
|
2332
2366
|
...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
|
|
@@ -2343,7 +2377,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2343
2377
|
...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
|
|
2344
2378
|
...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
|
|
2345
2379
|
}),
|
|
2346
|
-
internalsSnapshot: { ...childInternals, ...failedRetainStrip.internalsFlag },
|
|
2380
|
+
internalsSnapshot: { ...withoutWakerSeats(childInternals), ...failedRetainStrip.internalsFlag },
|
|
2347
2381
|
release: releaseChild,
|
|
2348
2382
|
});
|
|
2349
2383
|
if (entry) {
|
|
@@ -2445,7 +2479,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2445
2479
|
const forkObjective = `${FORK_DIRECTIVE_FRAME}${prompt}${forkWorktreeNote !== undefined ? `\n\n${forkWorktreeNote}` : ""}${parentSpecSeat?.advisorModel !== undefined ? `\n\n${ADVISOR_FORK_SENTENCE}` : ""}`;
|
|
2446
2480
|
if (wantsBackground) {
|
|
2447
2481
|
const bg = opts.background;
|
|
2448
|
-
const notify =
|
|
2482
|
+
const notify = backgroundSink;
|
|
2449
2483
|
const abort = new AbortController();
|
|
2450
2484
|
const sessionScopedBg = ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
|
|
2451
2485
|
const onHostAbort = () => abort.abort();
|
|
@@ -2456,7 +2490,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2456
2490
|
else if (!sessionScopedBg)
|
|
2457
2491
|
ctx.signal.addEventListener("abort", onHostAbort, { once: true });
|
|
2458
2492
|
}
|
|
2459
|
-
const shortDesc = `fork: ${(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt
|
|
2493
|
+
const shortDesc = `fork: ${redactThenCut(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt, 180)}`;
|
|
2460
2494
|
const bgOwner = sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
|
|
2461
2495
|
const bgScope = treeScope;
|
|
2462
2496
|
const forkEntryGate = await openEntryGate();
|
|
@@ -2557,8 +2591,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2557
2591
|
}
|
|
2558
2592
|
if (forkEntryGate.key !== undefined)
|
|
2559
2593
|
chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
|
|
2594
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
2560
2595
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
2561
2596
|
bg.registry.bindBackgroundAgentSession(taskId, forkedId);
|
|
2597
|
+
stepRecorder.lockTo(taskId);
|
|
2562
2598
|
const forkBgHangAt = Date.now();
|
|
2563
2599
|
bg.registry.attachAgentTerminalNotifier(taskId, () => {
|
|
2564
2600
|
const stoppedByReap = bg.registry.getStopAttribution(taskId) ?? "system";
|
|
@@ -2576,7 +2612,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2576
2612
|
...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
|
|
2577
2613
|
};
|
|
2578
2614
|
sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkedId, transcriptId: forkedId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
|
|
2579
|
-
notifier.notify(() => notify
|
|
2615
|
+
notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
|
|
2580
2616
|
});
|
|
2581
2617
|
if (agentName !== undefined) {
|
|
2582
2618
|
recordRosterSpawn(ctx.roster, { name: agentName, agentId: taskId, sessionId: forkedId, toolUseId: ctx.toolCallId, owner: bgOwner, scope: bgScope, ...(rowModelKey !== undefined ? { model: rowModelKey } : {}), ...(modelFallback !== undefined ? { modelFallback } : {}), ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}), ...(sessionScopedBg ? { sessionScoped: true } : {}), createdAt: Date.now() }, (err) => opts.onObserverError?.(err, { site: "roster.recordSpawn" }));
|
|
@@ -2626,7 +2662,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2626
2662
|
transcriptId: forkedId,
|
|
2627
2663
|
sessionId: forkedId,
|
|
2628
2664
|
parentToolCallId: ctx.toolCallId,
|
|
2629
|
-
progressTaskId:
|
|
2665
|
+
progressTaskId: taskId,
|
|
2630
2666
|
agentType: spawnAgentType,
|
|
2631
2667
|
...(spawnModel !== undefined ? { model: spawnModel } : {}),
|
|
2632
2668
|
...(bgForkCycleSeq !== undefined ? { seq: bgForkCycleSeq } : {}),
|
|
@@ -2640,8 +2676,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2640
2676
|
...forkInternals,
|
|
2641
2677
|
...(forkQuestionStrip !== undefined ? forkQuestionStrip.internalsFlag : {}),
|
|
2642
2678
|
onNotifyInjectorReady: s2ForkNotifyReady,
|
|
2643
|
-
|
|
2644
|
-
...(bgForkCycleSeq !== undefined ? { cycleSeq: bgForkCycleSeq } : {}),
|
|
2679
|
+
...backgroundLegFacts(taskId, bgForkCycleSeq),
|
|
2645
2680
|
onForwardEvent: (e) => {
|
|
2646
2681
|
try {
|
|
2647
2682
|
recordingForward(e, { bgAgentId: taskId });
|
|
@@ -2676,8 +2711,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2676
2711
|
...forkInternals,
|
|
2677
2712
|
...(forkQuestionStrip !== undefined ? forkQuestionStrip.internalsFlag : {}),
|
|
2678
2713
|
onNotifyInjectorReady: s2ForkNotifyReady,
|
|
2679
|
-
|
|
2680
|
-
...(bgForkCycleSeq !== undefined ? { cycleSeq: bgForkCycleSeq } : {}),
|
|
2714
|
+
...backgroundLegFacts(taskId, bgForkCycleSeq),
|
|
2681
2715
|
onForwardEvent: (e) => {
|
|
2682
2716
|
try {
|
|
2683
2717
|
recordingForward(e, { bgAgentId: taskId });
|
|
@@ -2687,8 +2721,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2687
2721
|
bgForkActivityBeat(e);
|
|
2688
2722
|
},
|
|
2689
2723
|
};
|
|
2690
|
-
|
|
2691
|
-
|
|
2724
|
+
const bgForkChild = opts.runner.runTask(bgForkSpec, bgForkInternals);
|
|
2725
|
+
extensionSpawn?.launched(taskId, spawnModel);
|
|
2726
|
+
void bgForkChild
|
|
2692
2727
|
.then(async (child) => {
|
|
2693
2728
|
const childFace = childTerminalFace(child.terminal);
|
|
2694
2729
|
settleForkRow(child.terminal);
|
|
@@ -2719,23 +2754,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2719
2754
|
const failedFork = !okBg && !reapedBg;
|
|
2720
2755
|
const errCodeFork = failedFork ? childFace.errorCode : undefined;
|
|
2721
2756
|
const errClassFork = failedFork ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
|
|
2722
|
-
const
|
|
2757
|
+
const settleWinnerFork = bg.registry.settleBackgroundAgent(taskId, {
|
|
2723
2758
|
cycle: 0,
|
|
2724
2759
|
status: okBg ? "completed" : reapedBg ? "killed" : "failed",
|
|
2725
2760
|
...resultSettleFields(forkBgResult),
|
|
2726
2761
|
...(!okBg ? { error: reapedBg ? (collateralBg ? BG_AGENT_COLLATERAL_REAP_REASON : BG_AGENT_REAP_STOP_ERROR) : childFace.errorMessage ?? childFace.status } : {}),
|
|
2727
2762
|
...(errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
|
|
2728
2763
|
...(errClassFork !== undefined ? { retryable: errClassFork.retryable, errorKind: errClassFork.errorKind } : {}),
|
|
2729
|
-
})
|
|
2764
|
+
});
|
|
2765
|
+
const completionIdFork = settleWinnerFork !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
|
|
2766
|
+
const settledBg = settleWinnerFork ?? (abort.signal.aborted ? "killed" : okBg ? "completed" : "failed");
|
|
2730
2767
|
const stoppedByBg = settledBg === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
2731
|
-
const completionIdFork = bg.registry.getCompletionId(taskId);
|
|
2732
2768
|
const stillbornFork = child.terminal.kind === "failed" && child.terminal.code === "resume.session_not_found";
|
|
2733
2769
|
if (stillbornFork) {
|
|
2734
|
-
|
|
2735
|
-
await (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId));
|
|
2736
|
-
}
|
|
2737
|
-
catch {
|
|
2738
|
-
}
|
|
2770
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, forkedId, () => (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId)));
|
|
2739
2771
|
}
|
|
2740
2772
|
const residualFork = residualFields();
|
|
2741
2773
|
const resumableFork = false;
|
|
@@ -2746,6 +2778,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2746
2778
|
? `Agent "${shortDesc}" failed: ${failReasonFork}${ccElapsedTag(forkElapsedMs)}`.slice(0, 300) + errorKindClause(errClassFork)
|
|
2747
2779
|
: `${ccCompletionText(shortDesc, settledBg, childFace.status, forkElapsedMs)}`;
|
|
2748
2780
|
const ownsTerminalFacesFork = bg.registry.claimAgentTerminalNotify(taskId);
|
|
2781
|
+
const forkResultField = await completionResultField(forkBgResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdFork), notifier);
|
|
2749
2782
|
const forkFrame = {
|
|
2750
2783
|
task_id: taskId,
|
|
2751
2784
|
task_type: "background_agent",
|
|
@@ -2758,7 +2791,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2758
2791
|
...(settledBg === "failed" && errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
|
|
2759
2792
|
...providerFaultField(child),
|
|
2760
2793
|
...(child.sessionId ? { sessionId: child.sessionId } : {}),
|
|
2761
|
-
...(
|
|
2794
|
+
...(forkResultField !== undefined ? { result: forkResultField.text } : {}),
|
|
2762
2795
|
...(settledBg === "killed" && child.result ? { partial: true } : {}),
|
|
2763
2796
|
...residualFork,
|
|
2764
2797
|
resumable: resumableFork,
|
|
@@ -2769,7 +2802,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2769
2802
|
sinkEmit(backgroundChildTerminal(forkFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkTranscriptId, ...(stillbornFork ? {} : { transcriptId: forkTranscriptId }), parentToolCallId: ctx.toolCallId, ...(bgForkCycleSeq !== undefined ? { generation: bgForkCycleSeq } : {}) }));
|
|
2770
2803
|
try {
|
|
2771
2804
|
if (ownsTerminalFacesFork)
|
|
2772
|
-
notify
|
|
2805
|
+
notify(forkFrame, { priority: "next" });
|
|
2773
2806
|
}
|
|
2774
2807
|
catch {
|
|
2775
2808
|
}
|
|
@@ -2782,15 +2815,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2782
2815
|
const msgFork = childThrownText(e);
|
|
2783
2816
|
const errCodeForkReject = killed ? undefined : thrownErrorCode(e);
|
|
2784
2817
|
const errClassForkReject = killed ? undefined : classifySubagentError({ kind: "failed", ...(errCodeForkReject !== undefined ? { code: errCodeForkReject } : {}) });
|
|
2785
|
-
const
|
|
2818
|
+
const settleWinnerForkReject = bg.registry.settleBackgroundAgent(taskId, {
|
|
2786
2819
|
cycle: 0,
|
|
2787
2820
|
status: killed ? "killed" : "failed",
|
|
2788
2821
|
error: killed ? BG_AGENT_REAP_STOP_ERROR : msgFork,
|
|
2789
2822
|
...(errCodeForkReject !== undefined ? { errorCode: errCodeForkReject } : {}),
|
|
2790
2823
|
...(errClassForkReject !== undefined ? { retryable: errClassForkReject.retryable, errorKind: errClassForkReject.errorKind } : {}),
|
|
2791
|
-
})
|
|
2824
|
+
});
|
|
2825
|
+
const completionIdForkReject = settleWinnerForkReject !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
|
|
2826
|
+
const settledBg = settleWinnerForkReject ?? (killed ? "killed" : "failed");
|
|
2792
2827
|
const stoppedByBg = settledBg === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
2793
|
-
const completionIdForkReject = bg.registry.getCompletionId(taskId);
|
|
2794
2828
|
const summaryBg = `${shortDesc} — ${settledBg === "failed" ? `failed: ${msgFork}` : settledBg}`.slice(0, 300) + (settledBg === "failed" ? errorKindClause(errClassForkReject) : "");
|
|
2795
2829
|
const ownsTerminalFacesForkReject = bg.registry.claimAgentTerminalNotify(taskId);
|
|
2796
2830
|
const forkRejectFrame = {
|
|
@@ -2810,7 +2844,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2810
2844
|
sinkEmit(backgroundChildTerminal(forkRejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkedId, transcriptId: forkedId, parentToolCallId: ctx.toolCallId, ...(bgForkCycleSeq !== undefined ? { generation: bgForkCycleSeq } : {}) }));
|
|
2811
2845
|
try {
|
|
2812
2846
|
if (ownsTerminalFacesForkReject)
|
|
2813
|
-
notify
|
|
2847
|
+
notify(forkRejectFrame, { priority: "next" });
|
|
2814
2848
|
}
|
|
2815
2849
|
catch {
|
|
2816
2850
|
}
|
|
@@ -2819,8 +2853,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2819
2853
|
content: asyncLaunchedReceipt({
|
|
2820
2854
|
taskId,
|
|
2821
2855
|
workingLine: `The forked agent inherits your full current context and works on its prompt in the background.`,
|
|
2822
|
-
notify: Boolean(notify),
|
|
2823
|
-
oneShot: ctx.oneShot === true,
|
|
2824
2856
|
notes: [
|
|
2825
2857
|
modelNote,
|
|
2826
2858
|
extraToolsNote,
|
|
@@ -2835,9 +2867,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2835
2867
|
details: { type: "agent", subagent_type: FORK_SUBAGENT_TYPE, status: "async_launched", isAsync: true, task_id: taskId, description: shortDesc, prompt, ...(forkSettleId !== undefined ? { settle_id: forkSettleId } : {}) },
|
|
2836
2868
|
};
|
|
2837
2869
|
}
|
|
2838
|
-
const bgIgnoredNote =
|
|
2839
|
-
|
|
2840
|
-
|
|
2870
|
+
const bgIgnoredNote = ranSyncNote ??
|
|
2871
|
+
(a.run_in_background === true
|
|
2872
|
+
? `note: run_in_background was ignored for subagent_type "${FORK_SUBAGENT_TYPE}" — the fork ran synchronously (this delegation tool has no background surface configured).`
|
|
2873
|
+
: undefined);
|
|
2841
2874
|
const syncForkEntryGate = await openEntryGate();
|
|
2842
2875
|
if (ctx.signal?.aborted) {
|
|
2843
2876
|
try {
|
|
@@ -2944,7 +2977,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2944
2977
|
if (ctx.checkpointStoreForChildren !== undefined && ctx.checkpointStoreForChildren !== "disabled" && bg.checkpointStore !== undefined && bg.checkpointStore !== ctx.checkpointStoreForChildren)
|
|
2945
2978
|
throw configError("background.checkpointStore is not the store this run's children park in (the host's resolved checkpoint seat, TaskSpec/RunnerDeps.checkpointStore) — wire the one store, or leave the option unset and let the seat ride.", "config.invalid_checkpoint_store");
|
|
2946
2979
|
const childParkStore = ctx.checkpointStoreForChildren === undefined ? bg.checkpointStore : ctx.checkpointStoreForChildren === "disabled" ? undefined : ctx.checkpointStoreForChildren;
|
|
2947
|
-
const notify =
|
|
2980
|
+
const notify = backgroundSink;
|
|
2948
2981
|
const abort = new AbortController();
|
|
2949
2982
|
const reviveRow = reviveClaim?.row;
|
|
2950
2983
|
const parkedResume = reviveClaim?.parkedResume;
|
|
@@ -2961,10 +2994,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2961
2994
|
const shortDesc = reviveRow?.description ?? String(a.description ?? "sub-agent").slice(0, 200);
|
|
2962
2995
|
const bgOwner = reviveRow !== undefined ? reviveRow.owner : sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
|
|
2963
2996
|
const bgScope = treeScope;
|
|
2964
|
-
const
|
|
2965
|
-
const capLedgerKey =
|
|
2966
|
-
{
|
|
2967
|
-
|
|
2997
|
+
const bgEntryPool = delegationEntryPool(entryPoolSeat);
|
|
2998
|
+
const capLedgerKey = bgEntryPool.key;
|
|
2999
|
+
if (reviveRow !== undefined) {
|
|
3000
|
+
bgEntryPool.occupy("registered");
|
|
3001
|
+
}
|
|
3002
|
+
else {
|
|
3003
|
+
const admission = (await openEntryGate()).admit("registered");
|
|
2968
3004
|
if (!admission.admitted) {
|
|
2969
3005
|
dropHostAbortListener();
|
|
2970
3006
|
await cancelObserver();
|
|
@@ -3087,6 +3123,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3087
3123
|
}
|
|
3088
3124
|
if (capLedgerKey !== undefined)
|
|
3089
3125
|
chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
|
|
3126
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
3090
3127
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
3091
3128
|
if (agentName !== undefined) {
|
|
3092
3129
|
recordRosterSpawn(ctx.roster, { name: agentName, agentId: taskId, toolUseId: ctx.toolCallId, owner: bgOwner, scope: bgScope, ...(reviveRow !== undefined ? (reviveRow.model !== undefined ? { model: reviveRow.model } : {}) : rowModelKey !== undefined ? { model: rowModelKey } : {}), ...(modelFallback !== undefined ? { modelFallback } : {}), ...(reviveRow !== undefined ? ((reviveRow.rootSessionId ?? reviveRow.parentSessionId) !== undefined ? { rootSessionId: reviveRow.rootSessionId ?? reviveRow.parentSessionId } : {}) : (ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}), ...(sessionScopedBg ? { sessionScoped: true } : {}), createdAt: reviveRow?.spawnedAt ?? Date.now() }, (err) => opts.onObserverError?.(err, { site: "roster.recordSpawn" }));
|
|
@@ -3101,7 +3138,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3101
3138
|
};
|
|
3102
3139
|
const bgChildSessionId = reviveRow?.sessionId ?? uuidv7();
|
|
3103
3140
|
const bgStartedAt = Date.now();
|
|
3104
|
-
stepRecorder.lockTo(
|
|
3141
|
+
stepRecorder.lockTo(taskId);
|
|
3105
3142
|
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
|
|
3106
3143
|
const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
|
|
3107
3144
|
bg.registry.attachAgentTerminalNotifier(taskId, () => {
|
|
@@ -3121,7 +3158,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3121
3158
|
...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
|
|
3122
3159
|
};
|
|
3123
3160
|
sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
|
|
3124
|
-
notifier.notify(() => notify
|
|
3161
|
+
notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
|
|
3125
3162
|
});
|
|
3126
3163
|
const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
|
|
3127
3164
|
const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
|
|
@@ -3161,9 +3198,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3161
3198
|
: ctx.subagentRetain;
|
|
3162
3199
|
if (sessionScopedBg && bgRetainLedger)
|
|
3163
3200
|
ensureSessionReapHook(bg.registry);
|
|
3164
|
-
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe,
|
|
3165
|
-
delegationTaskType: "background_agent",
|
|
3166
|
-
});
|
|
3201
|
+
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
|
|
3167
3202
|
if (bgRetain) {
|
|
3168
3203
|
bg.registry.markRetainedContinuation(taskId);
|
|
3169
3204
|
const origRelease = bgRetain.release;
|
|
@@ -3172,6 +3207,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3172
3207
|
await origRelease();
|
|
3173
3208
|
};
|
|
3174
3209
|
}
|
|
3210
|
+
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
|
|
3175
3211
|
const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
|
|
3176
3212
|
bg.agentStore !== undefined &&
|
|
3177
3213
|
childParkStore !== undefined &&
|
|
@@ -3205,7 +3241,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3205
3241
|
transcriptId: bgChildSessionId,
|
|
3206
3242
|
sessionId: bgChildSessionId,
|
|
3207
3243
|
parentToolCallId: ctx.toolCallId,
|
|
3208
|
-
progressTaskId:
|
|
3244
|
+
progressTaskId: taskId,
|
|
3209
3245
|
agentType: spawnAgentType,
|
|
3210
3246
|
...(spawnModel !== undefined ? { model: spawnModel } : {}),
|
|
3211
3247
|
...(bgCycleSeq !== undefined ? { seq: bgCycleSeq } : {}),
|
|
@@ -3231,8 +3267,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3231
3267
|
...(bgQuestionStrip !== undefined ? bgQuestionStrip.internalsFlag : {}),
|
|
3232
3268
|
...(bgPlacement !== undefined ? { sessionPlacement: bgPlacement } : {}),
|
|
3233
3269
|
onNotifyInjectorReady: s2NotifyReady,
|
|
3234
|
-
|
|
3235
|
-
...(bgCycleSeq !== undefined ? { cycleSeq: bgCycleSeq } : {}),
|
|
3270
|
+
...backgroundLegFacts(taskId, bgCycleSeq),
|
|
3236
3271
|
onForwardEvent: (e) => {
|
|
3237
3272
|
try {
|
|
3238
3273
|
recordingForward(e, { bgAgentId: taskId });
|
|
@@ -3268,8 +3303,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3268
3303
|
...(bgQuestionStrip !== undefined ? bgQuestionStrip.internalsFlag : {}),
|
|
3269
3304
|
...(bgPlacement !== undefined ? { sessionPlacement: bgPlacement } : {}),
|
|
3270
3305
|
onNotifyInjectorReady: s2NotifyReady,
|
|
3271
|
-
|
|
3272
|
-
...(bgCycleSeq !== undefined ? { cycleSeq: bgCycleSeq } : {}),
|
|
3306
|
+
...backgroundLegFacts(taskId, bgCycleSeq),
|
|
3273
3307
|
onForwardEvent: (e) => {
|
|
3274
3308
|
try {
|
|
3275
3309
|
recordingForward(e, { bgAgentId: taskId });
|
|
@@ -3375,7 +3409,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3375
3409
|
...(pr.inheritedGate !== undefined ? { inheritedGate: pr.inheritedGate } : {}),
|
|
3376
3410
|
afterCheckpointResolve,
|
|
3377
3411
|
});
|
|
3378
|
-
observedSteerRef.steer = (
|
|
3412
|
+
observedSteerRef.steer = authoredSteerOf(bgStream);
|
|
3379
3413
|
for await (const ev of bgStream)
|
|
3380
3414
|
observerTap?.record(ev);
|
|
3381
3415
|
childResult = await bgStream.result();
|
|
@@ -3413,7 +3447,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3413
3447
|
: observerPairing
|
|
3414
3448
|
? (() => {
|
|
3415
3449
|
const bgStream = opts.runner.runTaskStream(bgSpec, undefined, bgInternals);
|
|
3416
|
-
observedSteerRef.steer = (
|
|
3450
|
+
observedSteerRef.steer = authoredSteerOf(bgStream);
|
|
3417
3451
|
return (async () => {
|
|
3418
3452
|
for await (const ev of bgStream)
|
|
3419
3453
|
observerTap?.record(ev);
|
|
@@ -3421,6 +3455,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3421
3455
|
})();
|
|
3422
3456
|
})()
|
|
3423
3457
|
: opts.runner.runTask(bgSpec, bgInternals);
|
|
3458
|
+
extensionSpawn?.launched(taskId, spawnModel);
|
|
3424
3459
|
void bgChildPromise
|
|
3425
3460
|
.then(async (child) => {
|
|
3426
3461
|
const childFace = childTerminalFace(child.terminal);
|
|
@@ -3526,7 +3561,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3526
3561
|
: childFace.errorCode
|
|
3527
3562
|
: undefined;
|
|
3528
3563
|
const errClassBg = failedBg ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
|
|
3529
|
-
const
|
|
3564
|
+
const settleWinnerBg = bg.registry.settleBackgroundAgent(taskId, {
|
|
3530
3565
|
cycle: 0,
|
|
3531
3566
|
status: ok ? "completed" : reaped ? "killed" : "failed",
|
|
3532
3567
|
seq: seqAtSettle ?? 1,
|
|
@@ -3535,18 +3570,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3535
3570
|
...(errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
|
|
3536
3571
|
...(errClassBg !== undefined ? { retryable: errClassBg.retryable, errorKind: errClassBg.errorKind } : {}),
|
|
3537
3572
|
...(failedBg && child.retryAfterMs !== undefined ? { retryAfterMs: child.retryAfterMs } : {}),
|
|
3538
|
-
})
|
|
3573
|
+
});
|
|
3574
|
+
const completionIdBg = settleWinnerBg !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
|
|
3575
|
+
const settled = settleWinnerBg ??
|
|
3539
3576
|
(abort.signal.aborted ? "killed" : ok ? "completed" : "failed");
|
|
3540
3577
|
if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
|
|
3541
|
-
|
|
3542
|
-
await opts.runner.sessions.release(child.sessionId);
|
|
3543
|
-
bg.registry.releaseDurableTranscriptAnchor(taskId);
|
|
3544
|
-
}
|
|
3545
|
-
catch {
|
|
3546
|
-
}
|
|
3578
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, child.sessionId, () => opts.runner.sessions.release(child.sessionId));
|
|
3547
3579
|
}
|
|
3548
3580
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3549
|
-
const completionIdBg = bg.registry.getCompletionId(taskId);
|
|
3550
3581
|
const observerNote = observerNoteFor(await startBoundedObserverDrain());
|
|
3551
3582
|
const residual = residualFields();
|
|
3552
3583
|
const bgDurableRow = await bgRowConfirmed();
|
|
@@ -3564,6 +3595,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3564
3595
|
? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
|
|
3565
3596
|
: `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
|
|
3566
3597
|
const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
|
|
3598
|
+
const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
|
|
3567
3599
|
const completionFrame = {
|
|
3568
3600
|
task_id: taskId,
|
|
3569
3601
|
task_type: "background_agent",
|
|
@@ -3577,7 +3609,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3577
3609
|
...(settled === "failed" && errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
|
|
3578
3610
|
...providerFaultField(child),
|
|
3579
3611
|
...(child.sessionId ? { sessionId: child.sessionId } : {}),
|
|
3580
|
-
...(
|
|
3612
|
+
...(bgResultField !== undefined ? { result: bgResultField.text } : {}),
|
|
3581
3613
|
...(settled === "killed" && child.result ? { partial: true } : {}),
|
|
3582
3614
|
...residual,
|
|
3583
3615
|
resumable: resumableBg,
|
|
@@ -3586,21 +3618,21 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3586
3618
|
};
|
|
3587
3619
|
if (ownsTerminalFaces)
|
|
3588
3620
|
sinkEmit(backgroundChildTerminal(completionFrame, { taskId, sessionScoped: sessionScopedBg === true, ...(child.sessionId ? { sessionId: child.sessionId, transcriptId: child.sessionId } : {}), parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
|
|
3589
|
-
const
|
|
3590
|
-
const aliveBgCount =
|
|
3591
|
-
if (
|
|
3621
|
+
const gateOwners = ownsTerminalFaces && settled === "completed" && bgRetain !== undefined ? childOwnerKeys(child.taskId, bgRetain.childSessionId) : [];
|
|
3622
|
+
const aliveBgCount = runningBackgroundUnder(bg.registry, gateOwners);
|
|
3623
|
+
if (bgRetain !== undefined && aliveBgCount > 0) {
|
|
3592
3624
|
parkCompletionNotify({
|
|
3593
3625
|
registry: bg.registry,
|
|
3594
3626
|
entry: bgRetain,
|
|
3595
|
-
|
|
3627
|
+
owners: gateOwners,
|
|
3596
3628
|
pendingCount: aliveBgCount,
|
|
3597
3629
|
payload: completionFrame,
|
|
3598
|
-
notify
|
|
3630
|
+
notify,
|
|
3599
3631
|
});
|
|
3600
3632
|
}
|
|
3601
3633
|
else if (ownsTerminalFaces) {
|
|
3602
3634
|
try {
|
|
3603
|
-
notify
|
|
3635
|
+
notify(completionFrame, { priority: "next" });
|
|
3604
3636
|
}
|
|
3605
3637
|
catch {
|
|
3606
3638
|
}
|
|
@@ -3622,24 +3654,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3622
3654
|
const msg = childThrownText(e);
|
|
3623
3655
|
const errCodeBgReject = killed ? undefined : thrownErrorCode(e);
|
|
3624
3656
|
const errClassBgReject = killed ? undefined : classifySubagentError({ kind: "failed", ...(errCodeBgReject !== undefined ? { code: errCodeBgReject } : {}) });
|
|
3625
|
-
const
|
|
3657
|
+
const settleWinnerBgReject = bg.registry.settleBackgroundAgent(taskId, {
|
|
3626
3658
|
cycle: 0,
|
|
3627
3659
|
status: killed ? "killed" : "failed",
|
|
3628
3660
|
error: msg,
|
|
3629
3661
|
seq: seqAtSettle ?? 1,
|
|
3630
3662
|
...(errCodeBgReject !== undefined ? { errorCode: errCodeBgReject } : {}),
|
|
3631
3663
|
...(errClassBgReject !== undefined ? { retryable: errClassBgReject.retryable, errorKind: errClassBgReject.errorKind } : {}),
|
|
3632
|
-
})
|
|
3664
|
+
});
|
|
3665
|
+
const completionIdBgReject = settleWinnerBgReject !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
|
|
3666
|
+
const settled = settleWinnerBgReject ?? (killed ? "killed" : "failed");
|
|
3633
3667
|
if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
|
|
3634
|
-
|
|
3635
|
-
await opts.runner.sessions.release(bgChildSessionId);
|
|
3636
|
-
bg.registry.releaseDurableTranscriptAnchor(taskId);
|
|
3637
|
-
}
|
|
3638
|
-
catch {
|
|
3639
|
-
}
|
|
3668
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, bgChildSessionId, () => opts.runner.sessions.release(bgChildSessionId));
|
|
3640
3669
|
}
|
|
3641
3670
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3642
|
-
const completionIdBgReject = bg.registry.getCompletionId(taskId);
|
|
3643
3671
|
const observerNote = observerNoteFor(await startBoundedObserverDrain());
|
|
3644
3672
|
const ownsTerminalFacesReject = bg.registry.claimAgentTerminalNotify(taskId);
|
|
3645
3673
|
const rejectFrame = {
|
|
@@ -3660,7 +3688,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3660
3688
|
sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
|
|
3661
3689
|
try {
|
|
3662
3690
|
if (ownsTerminalFacesReject)
|
|
3663
|
-
notify
|
|
3691
|
+
notify(rejectFrame, { priority: "next" });
|
|
3664
3692
|
}
|
|
3665
3693
|
catch {
|
|
3666
3694
|
}
|
|
@@ -3695,8 +3723,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3695
3723
|
content: asyncLaunchedReceipt({
|
|
3696
3724
|
taskId,
|
|
3697
3725
|
workingLine: `The agent is working in the background.`,
|
|
3698
|
-
notify: Boolean(notify),
|
|
3699
|
-
oneShot: ctx.oneShot === true,
|
|
3700
3726
|
notes: [
|
|
3701
3727
|
modelNote,
|
|
3702
3728
|
extraToolsNote,
|
|
@@ -3732,7 +3758,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3732
3758
|
if (retainEntry)
|
|
3733
3759
|
stepRecorder.lockTo(retainEntry.childSessionId);
|
|
3734
3760
|
const stream = opts.runner.runTaskStream({ ...buildChildSpec(ctx.signal), ...(retainEntry ? { sessionId: retainEntry.childSessionId } : {}) }, undefined, childInternals);
|
|
3735
|
-
observedSteerRef.steer = (
|
|
3761
|
+
observedSteerRef.steer = authoredSteerOf(stream);
|
|
3736
3762
|
let settleResolve;
|
|
3737
3763
|
const settled = new Promise((r) => { settleResolve = r; });
|
|
3738
3764
|
if (ctx.onSubagentSpawn) {
|
|
@@ -3743,9 +3769,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3743
3769
|
...(opts.background?.notify ? { notify: opts.background.notify } : {}),
|
|
3744
3770
|
sink: ctx.onSubagentSpawn,
|
|
3745
3771
|
...(opts.background ? { registry: opts.background.registry } : {}),
|
|
3772
|
+
entryGate: syncEntryGate,
|
|
3746
3773
|
...(opts.onObserverError !== undefined ? { onNotifyError: (f) => opts.onObserverError?.(f.error, { site: f.site }) } : {}),
|
|
3747
3774
|
...(ctx.onQuestion !== undefined ? { currentOnQuestion: ctx.onQuestion } : {}),
|
|
3748
3775
|
...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
|
|
3776
|
+
currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
|
|
3777
|
+
currentPlacementTarget: ctx.placementTarget,
|
|
3749
3778
|
});
|
|
3750
3779
|
notifier.notify(() => ctx.onSubagentSpawn?.(createSteerHandle(stream, ctx.toolCallId, childAgentName, settled, {
|
|
3751
3780
|
resume,
|
|
@@ -3827,6 +3856,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3827
3856
|
`status: ${childFace.status}`,
|
|
3828
3857
|
modelNote ?? "",
|
|
3829
3858
|
extraToolsNote ?? "",
|
|
3859
|
+
ranSyncNote ?? "",
|
|
3830
3860
|
worktreeLine ?? "",
|
|
3831
3861
|
childFace.blockedReason ? `blocked_reason: ${inlineUntrusted(childFace.blockedReason, REPORT_FIELD_MAX)}` : "",
|
|
3832
3862
|
childFace.errorMessage ? `error: ${inlineUntrusted(childFace.errorMessage, REPORT_FIELD_MAX)}` : "",
|