@sema-agent/core 7.58.0 → 7.60.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 +1340 -0
- package/README.md +6 -4
- 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 +2 -1
- package/dist/agents/agent-transcript-tool.js +3 -1
- package/dist/agents/cc-peer-directory.js +8 -8
- package/dist/agents/child-model-seat.d.ts +4 -2
- package/dist/agents/child-model-seat.js +9 -4
- package/dist/agents/cumulative-stats.js +0 -1
- package/dist/agents/inherited-tool-pool.d.ts +26 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/peer-directory.d.ts +9 -0
- package/dist/agents/peer-directory.js +6 -2
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +13 -2
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +3 -1
- package/dist/agents/send-message-tool.d.ts +8 -19
- package/dist/agents/send-message-tool.js +32 -50
- package/dist/agents/subagent.d.ts +51 -17
- package/dist/agents/subagent.js +150 -112
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +161 -45
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +9 -3
- package/dist/brain/errors.js +7 -1
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +3 -3
- package/dist/brain/openai.js +103 -53
- package/dist/brain/provider-dialect.d.ts +11 -0
- package/dist/brain/provider-dialect.js +5 -2
- package/dist/brain/reasoning-request.js +5 -4
- package/dist/brain/reasoning.d.ts +19 -0
- package/dist/brain/reasoning.js +17 -2
- package/dist/brain/request-route.d.ts +4 -1
- package/dist/brain/request-route.js +4 -1
- package/dist/brain/route-adjudicator.d.ts +84 -18
- package/dist/brain/route-adjudicator.js +90 -22
- package/dist/brain/route-conformance.js +1 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.js +84 -49
- package/dist/brain/stream-shared.d.ts +30 -0
- package/dist/brain/stream-shared.js +34 -1
- package/dist/brain/timeout.d.ts +65 -6
- package/dist/brain/timeout.js +111 -11
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/account-row.d.ts +61 -0
- package/dist/core/account-row.js +51 -0
- package/dist/core/advisor-verdict.d.ts +2 -1
- package/dist/core/advisor-verdict.js +1 -1
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/allow-entry.d.ts +20 -6
- package/dist/core/allow-entry.js +17 -7
- package/dist/core/approval-object.d.ts +29 -15
- package/dist/core/approval-object.js +47 -19
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/auto-compaction.js +1 -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 +63 -12
- package/dist/core/background-agent-store.d.ts +26 -4
- package/dist/core/background-agent-store.js +3 -2
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +13 -1
- package/dist/core/checkpoint-requirements.js +3 -1
- package/dist/core/checkpoint-store.d.ts +66 -25
- package/dist/core/checkpoint-store.js +22 -9
- package/dist/core/child-clamp-seats.d.ts +29 -0
- package/dist/core/child-clamp-seats.js +56 -1
- package/dist/core/compliance.d.ts +3 -3
- package/dist/core/compliance.js +1 -1
- 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 +4 -5
- package/dist/core/effective-path-target.d.ts +8 -2
- package/dist/core/effective-path-target.js +8 -3
- package/dist/core/engine-notice.d.ts +156 -23
- package/dist/core/engine-notice.js +19 -5
- package/dist/core/frame-settlement.d.ts +5 -0
- package/dist/core/frame-settlement.js +4 -0
- package/dist/core/gate-fold.js +8 -6
- package/dist/core/gate-lanes.js +47 -12
- package/dist/core/gate-outcome.d.ts +32 -3
- package/dist/core/gate-outcome.js +19 -1
- package/dist/core/governance-codes.d.ts +17 -1
- package/dist/core/governance-codes.js +25 -0
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +70 -59
- package/dist/core/hooks.js +125 -80
- package/dist/core/image-admission.d.ts +106 -52
- package/dist/core/image-admission.js +184 -56
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/locked-config.d.ts +59 -5
- package/dist/core/locked-config.js +82 -50
- package/dist/core/mailbox-store.d.ts +45 -1
- package/dist/core/mailbox-store.js +53 -9
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-failure.d.ts +122 -20
- package/dist/core/mcp-failure.js +73 -5
- package/dist/core/mcp-host-seat.d.ts +92 -0
- package/dist/core/mcp-host-seat.js +131 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +7 -2
- package/dist/core/mcp-server-link.d.ts +22 -1
- package/dist/core/mcp-server-link.js +25 -1
- package/dist/core/mcp-server-spec.d.ts +38 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp.d.ts +27 -12
- package/dist/core/mcp.js +105 -76
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
- package/dist/core/memory-engine/consolidation-driver.js +3 -3
- package/dist/core/memory-engine/consolidation.d.ts +4 -0
- package/dist/core/memory-engine/consolidation.js +1 -0
- 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/delegation-settlement.js +5 -12
- package/dist/core/memory-engine/distiller.js +2 -2
- package/dist/core/memory-engine/dual-root.d.ts +50 -1
- package/dist/core/memory-engine/dual-root.js +44 -1
- package/dist/core/memory-engine/engine.d.ts +67 -14
- package/dist/core/memory-engine/engine.js +384 -212
- package/dist/core/memory-engine/export-bundle.d.ts +23 -0
- package/dist/core/memory-engine/export-bundle.js +23 -4
- package/dist/core/memory-engine/file-backend.d.ts +128 -55
- package/dist/core/memory-engine/file-backend.js +290 -117
- package/dist/core/memory-engine/index.d.ts +3 -2
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +59 -11
- package/dist/core/memory-engine/layout.js +190 -40
- package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
- package/dist/core/memory-engine/memory-backend-contract.js +39 -2
- 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 +51 -9
- package/dist/core/memory-engine/sync-client.js +107 -13
- package/dist/core/memory-engine/sync-report.d.ts +103 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +8 -1
- package/dist/core/memory-engine/types.d.ts +6 -0
- package/dist/core/mode-policy.d.ts +9 -1
- package/dist/core/mode-policy.js +11 -1
- 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 +65 -0
- package/dist/core/mods/agent-stations.js +105 -0
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.js +6 -5
- package/dist/core/mods/kernel/events.d.ts +11 -4
- package/dist/core/mods/kernel/events.js +11 -7
- 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 +4 -0
- package/dist/core/mods/kernel/registration.js +3 -0
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/stations.d.ts +73 -60
- package/dist/core/mods/stations.js +64 -40
- package/dist/core/mods/tool-call.d.ts +10 -4
- package/dist/core/mods/tool-call.js +28 -12
- 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/own-property-receipt.d.ts +3 -0
- package/dist/core/own-property-receipt.js +3 -0
- package/dist/core/parent-spec-seat.d.ts +8 -3
- package/dist/core/parent-spec-seat.js +2 -0
- package/dist/core/park-selfcheck.js +14 -8
- package/dist/core/peer-seat.d.ts +133 -16
- package/dist/core/peer-seat.js +319 -42
- package/dist/core/permission-rule-consent.d.ts +0 -21
- package/dist/core/permission-rule-consent.js +11 -6
- package/dist/core/permission-rule-model.d.ts +20 -2
- package/dist/core/permission-rule-model.js +8 -7
- package/dist/core/present-plan-tool.d.ts +11 -3
- package/dist/core/present-plan-tool.js +2 -2
- 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 +146 -98
- package/dist/core/remote-env.js +113 -14
- package/dist/core/resume-startup-cause.js +1 -0
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +6 -1
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +13 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +69 -3
- package/dist/core/roles.js +167 -80
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/announce-once-ledger.d.ts +5 -4
- package/dist/core/runner/announce-once-ledger.js +4 -2
- package/dist/core/runner/assemble-result.d.ts +0 -5
- package/dist/core/runner/assemble-result.js +0 -1
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +23 -12
- 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/construction-doors.js +5 -0
- package/dist/core/runner/contracts.d.ts +82 -57
- package/dist/core/runner/credential-origin-seat.js +4 -3
- package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
- package/dist/core/runner/cwd-alignment-probe.js +21 -0
- package/dist/core/runner/decide-continuation.d.ts +2 -2
- 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/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 +87 -11
- package/dist/core/runner/gate-exit.js +30 -8
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +3 -4
- package/dist/core/runner/image-removed-seat.d.ts +12 -0
- package/dist/core/runner/image-removed-seat.js +19 -0
- 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/memory-consolidation-driver.js +5 -5
- package/dist/core/runner/park-commit.d.ts +1 -1
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/permission-rule-lanes.js +1 -1
- package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
- package/dist/core/runner/prepare-ask-lane.js +2 -1
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +5 -5
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
- package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +16 -9
- package/dist/core/runner/prepare-context-lane.js +2 -0
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
- package/dist/core/runner/prepare-delegation-surface.js +5 -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 +4 -3
- package/dist/core/runner/prepare-gate-stations.js +4 -3
- package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
- package/dist/core/runner/prepare-hands-readface.js +19 -6
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
- package/dist/core/runner/prepare-inherited-gate.js +22 -31
- 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 +12 -19
- package/dist/core/runner/prepare-park-ask.d.ts +4 -6
- package/dist/core/runner/prepare-park-ask.js +5 -9
- package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
- package/dist/core/runner/prepare-policy-chain.js +136 -121
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +10 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
- package/dist/core/runner/prepare-prompt-inputs.js +10 -20
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +17 -2
- package/dist/core/runner/prepare-run-refs.d.ts +2 -3
- package/dist/core/runner/prepare-run-refs.js +4 -1
- package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
- package/dist/core/runner/prepare-suspend-saga.js +5 -7
- package/dist/core/runner/prepare-task.js +44 -28
- 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 +5 -4
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.js +3 -3
- package/dist/core/runner/reply-pricing.d.ts +30 -0
- package/dist/core/runner/reply-pricing.js +19 -0
- package/dist/core/runner/resume-admission.js +4 -2
- package/dist/core/runner/resume-apply.js +6 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-policy-outcome.js +5 -5
- package/dist/core/runner/retired-runner-deps.js +4 -1
- package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
- package/dist/core/runner/role-seat-defaulted.js +40 -0
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +3 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +1 -1
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +3 -1
- package/dist/core/runner/run-identity-wiring.d.ts +2 -5
- package/dist/core/runner/run-identity-wiring.js +6 -5
- package/dist/core/runner/run-leg.d.ts +2 -0
- package/dist/core/runner/run-leg.js +63 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +16 -10
- package/dist/core/runner/run-settle-and-teardown.js +5 -1
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +14 -6
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
- package/dist/core/runner/run-terminal-adoption.js +9 -3
- package/dist/core/runner/run-turn-boundary.js +89 -77
- package/dist/core/runner/runtask.d.ts +8 -5
- package/dist/core/runner/runtask.js +21 -13
- package/dist/core/runner/side-call-account.d.ts +1 -1
- package/dist/core/runner/side-call-account.js +3 -18
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
- package/dist/core/runner/sub-agent-deny-lists.js +20 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/tool-disclosure.js +0 -2
- package/dist/core/runner/tool-end-body.js +2 -2
- 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-occurrence.d.ts +1 -1
- package/dist/core/runner/tool-occurrence.js +2 -2
- 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/turn-attachments.d.ts +29 -27
- package/dist/core/runner/turn-attachments.js +27 -42
- package/dist/core/runner-deps.d.ts +32 -19
- package/dist/core/secret-env.d.ts +35 -4
- package/dist/core/secret-env.js +65 -3
- package/dist/core/sensitive-path-policy.js +3 -3
- package/dist/core/session-policy-store.d.ts +12 -3
- package/dist/core/session-policy-store.js +29 -10
- package/dist/core/session-store.d.ts +5 -7
- package/dist/core/session-store.js +50 -11
- package/dist/core/side-query.d.ts +11 -1
- package/dist/core/side-query.js +9 -0
- package/dist/core/skill-grant-binding.d.ts +31 -2
- package/dist/core/skill-grant-binding.js +31 -1
- package/dist/core/skill-grant.d.ts +17 -5
- package/dist/core/skill-grant.js +24 -6
- package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
- package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +37 -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/synthetic-read-verdict.js +2 -1
- package/dist/core/task-event.d.ts +50 -10
- package/dist/core/task-notification.d.ts +88 -5
- package/dist/core/task-notification.js +146 -17
- package/dist/core/task-registry-agent.d.ts +18 -12
- package/dist/core/task-registry-agent.js +19 -6
- package/dist/core/task-registry-monitor.d.ts +7 -0
- package/dist/core/task-registry-monitor.js +28 -1
- package/dist/core/task-registry-shared.d.ts +43 -3
- package/dist/core/task-registry-shared.js +21 -7
- package/dist/core/task-registry-workflow.js +1 -1
- package/dist/core/task-registry.d.ts +50 -35
- package/dist/core/task-registry.js +64 -23
- package/dist/core/task-result.d.ts +3 -12
- package/dist/core/task-spec.d.ts +15 -7
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/terminal-cause.d.ts +10 -0
- package/dist/core/tool-catalog-entries.js +1 -1
- package/dist/core/tool-check-reading.d.ts +1 -0
- package/dist/core/tool-check-reading.js +3 -3
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +4 -3
- package/dist/core/tool-name-aliases.d.ts +19 -0
- package/dist/core/tool-name-aliases.js +54 -2
- package/dist/core/tool-policy.d.ts +21 -4
- package/dist/core/tool-policy.js +1 -1
- 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 +88 -5
- package/dist/core/tool-result-store.js +51 -12
- package/dist/core/tool-roster.d.ts +112 -5
- package/dist/core/tool-roster.js +42 -1
- package/dist/core/tool-spec.d.ts +23 -5
- package/dist/core/trace.d.ts +0 -1
- package/dist/core/types.d.ts +5 -5
- package/dist/core/types.js +2 -2
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +15 -7
- package/dist/core/wiring-manifest.d.ts +6 -3
- package/dist/engine/compaction/compaction.js +29 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
- package/dist/engine/execution-env/node-execution-env.js +21 -13
- package/dist/engine/harness/agent-harness.d.ts +26 -3
- package/dist/engine/harness/agent-harness.js +49 -16
- package/dist/engine/harness/messages.d.ts +3 -1
- package/dist/engine/harness/messages.js +3 -2
- package/dist/engine/harness/types.d.ts +119 -28
- package/dist/engine/llm/rejected-images.d.ts +46 -0
- package/dist/engine/llm/rejected-images.js +54 -0
- package/dist/engine/llm/tool-turns.d.ts +2 -1
- package/dist/engine/llm/types.d.ts +18 -7
- package/dist/engine/loop/agent-loop.d.ts +20 -12
- package/dist/engine/loop/agent-loop.js +205 -36
- package/dist/engine/loop/types.d.ts +12 -3
- 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/path-to-root.d.ts +38 -0
- package/dist/engine/session/path-to-root.js +39 -0
- package/dist/engine/session/storage-base.js +4 -21
- package/dist/index.d.ts +35 -21
- package/dist/index.js +26 -17
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/internal/harness.d.ts +1 -0
- package/dist/internal/llm.d.ts +1 -0
- package/dist/orchestration/run-workflow-tool.d.ts +9 -3
- package/dist/orchestration/run-workflow-tool.js +59 -29
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-observe.d.ts +17 -1
- package/dist/orchestration/workflow-observe.js +20 -0
- package/dist/orchestration/workflow-types.d.ts +32 -7
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +762 -491
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/shell/counting-pass.d.ts +50 -0
- package/dist/shell/counting-pass.js +502 -0
- package/dist/shell/lex.d.ts +4 -2
- package/dist/shell/lex.js +93 -34
- package/dist/shell/shell-words.d.ts +1 -1
- package/dist/shell/shell-words.js +7 -6
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +3 -1
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +19 -14
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +3 -1
- package/dist/stores/file/index.d.ts +4 -3
- package/dist/stores/file/index.js +17 -8
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +9 -11
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +3 -1
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +3 -1
- package/dist/stores/file/session-store.d.ts +1 -1
- package/dist/stores/file/session-store.js +3 -1
- 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 +20 -2
- package/dist/stores/file/tool-result-store.js +74 -6
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +3 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -11
- package/dist/stores/file/workflow-journal-store.js +3 -2
- package/dist/tools/fs/containment-face.d.ts +5 -0
- 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 +7 -0
- package/dist/tools/fs/fs-bash-background-text.js +1 -0
- package/dist/tools/fs/fs-bash.d.ts +14 -4
- package/dist/tools/fs/fs-bash.js +29 -35
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +26 -21
- 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 +11 -13
- package/dist/tools/fs/fs-shared.js +11 -7
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +14 -8
- package/dist/tools/fs/index.js +13 -5
- package/dist/tools/fs/program-read-model.d.ts +13 -0
- package/dist/tools/fs/program-read-model.js +15 -0
- package/dist/tools/fs/program-read-model.rows.js +1 -1
- package/dist/tools/fs/read-deny.d.ts +13 -10
- package/dist/tools/fs/read-deny.js +25 -5
- package/dist/tools/fs/read-floor.d.ts +62 -0
- package/dist/tools/fs/read-floor.js +58 -0
- 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 +3 -3
- package/dist/tools/fs/search.js +4 -4
- package/dist/tools/fs/shell-read-check.d.ts +1 -1
- package/dist/tools/fs/shell-read-check.js +2 -1
- package/dist/tools/fs/shell-read-judge.d.ts +16 -8
- package/dist/tools/fs/shell-read-judge.js +10 -6
- package/dist/tools/fs/shell-read-plan.d.ts +6 -1
- package/dist/tools/fs/shell-read-plan.js +22 -15
- package/dist/tools/fs/shell-read-start.js +1 -0
- package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
- package/dist/tools/fs/shell-reentry-text.js +25 -3
- package/dist/tools/monitor.d.ts +9 -4
- package/dist/tools/monitor.js +17 -8
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/package.json +5 -2
- package/test/export-surface.snapshot.json +161 -21
- package/wire-changes/core-stores-sql@7.59.0.json +29 -0
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core@7.59.0.json +2459 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/mods-kernel@7.59.0.json +29 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/primitives@7.59.0.json +29 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
package/dist/agents/subagent.js
CHANGED
|
@@ -7,7 +7,7 @@ import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-star
|
|
|
7
7
|
import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
|
|
8
8
|
import { applyParentSpecSeat, parentSpecSeatOfCtx } from "../core/parent-spec-seat.js";
|
|
9
9
|
import { ADVISOR_FORK_SENTENCE, ADVISOR_TOOL_NAME } from "../core/advisor-verdict.js";
|
|
10
|
-
import { applyClampSeats, assertClampRecord, childClampSeats, clampSeatsOf, clampSourceOf, engineHeadlessLegSeats, foldClampSources, postureUnderClamps } from "../core/child-clamp-seats.js";
|
|
10
|
+
import { applyClampSeats, assertClampRecord, childClampSeats, clampSeatsOf, clampSourceOf, clampsReachNoPerson, clampValuesOf, engineHeadlessLegSeats, foldClampSources, postureUnderClamps, readClampFloor } from "../core/child-clamp-seats.js";
|
|
11
11
|
import { assertNoRetiredKeys } from "../core/retired-keys.js";
|
|
12
12
|
import { stripSpawnTurnQuestionFace } from "../core/ask-question.js";
|
|
13
13
|
import { withDelegationProvenance } from "../core/tool-policy.js";
|
|
@@ -16,14 +16,14 @@ import { notStartedResult } from "../core/delegation-not-started.js";
|
|
|
16
16
|
import { isHighSurrogate, isLowSurrogate } from "../core/surrogate-safe-slice.js";
|
|
17
17
|
import { newDelegationProvenanceAggregate, reduceDelegationAttestation } from "../core/memory-engine/delegation-provenance.js";
|
|
18
18
|
import { registerDelegationLaunch, replayExternalSettlementEffects, settleDelegation } from "../core/memory-engine/delegation-settlement.js";
|
|
19
|
-
import { enqueueMemoryAnnouncement } from "../core/memory-engine/layout.js";
|
|
20
19
|
import { resolveModel, resolveModelDisplayLabel } from "../core/roles.js";
|
|
21
20
|
import { childModelSeat, childThinkingSeat, deploymentStatesSubagentModel, deploymentSubagentThinking, forkModelSeat, inheritedParentModel, runnerRoleMap } from "./child-model-seat.js";
|
|
22
21
|
export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
|
|
23
22
|
import { REPORT_BLOCKED_TOOL_NAME } from "../core/runner/synthetic-tools.js";
|
|
24
23
|
import { TOOL_SEARCH_NAME } from "../core/runner/tool-disclosure.js";
|
|
25
|
-
import { OFFLOAD_TOOL_NAME } from "../core/tool-result-store.js";
|
|
26
|
-
import { compileToolSelector, delegationListWhere, namesEveryTool,
|
|
24
|
+
import { OFFLOAD_TOOL_NAME, persistTaskArtifact } from "../core/tool-result-store.js";
|
|
25
|
+
import { compileToolSelector, delegationListWhere, namesEveryTool, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
|
|
26
|
+
import { snapshotDefinitionLists } from "./agent-definition.js";
|
|
27
27
|
import { readToolNameList, snapshotToolNameList } from "../core/tool-name-list.js";
|
|
28
28
|
import { EXTRA_TOOL_NAMES_CODE, delegationPoolFace, extraToolNamesError, firstUndeclaredExtraTool, readExtraToolNames } from "./extra-tool-names.js";
|
|
29
29
|
import { builtinAgentDefinitions } from "./builtin-agents.js";
|
|
@@ -45,7 +45,7 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
|
|
|
45
45
|
import { readDurableOrgAdmission } from "../core/memory-admission.js";
|
|
46
46
|
import { governanceRetryClass } from "../core/governance-codes.js";
|
|
47
47
|
import { readSkillGrantCapture } from "../core/skill-grant.js";
|
|
48
|
-
import {
|
|
48
|
+
import { completionResultField, oweTerminalDelivery, resolveCompletionSink, retireTerminalDelivery, terminalFrameFacets } from "../core/task-notification.js";
|
|
49
49
|
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";
|
|
50
50
|
function rollupDelegatedCost(stats, nested) {
|
|
51
51
|
if (stats.costMicroUsd === undefined)
|
|
@@ -72,15 +72,15 @@ function providerFaultField(child) {
|
|
|
72
72
|
};
|
|
73
73
|
}
|
|
74
74
|
export { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX };
|
|
75
|
-
import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, } from "./retain-ledger.js";
|
|
75
|
+
import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, holdChildDeclarations, } from "./retain-ledger.js";
|
|
76
76
|
import { createPeerInboundChainRef, createPeerSelfRef } from "./peer-admission.js";
|
|
77
77
|
import { recordRosterSpawn } from "./roster-store.js";
|
|
78
78
|
import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./launch-receipt-contract.js";
|
|
79
79
|
import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
|
|
80
|
-
import { SubagentStepRecorder } from "./subagent-steps.js";
|
|
80
|
+
import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
|
|
81
81
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
82
82
|
import { canonicalNameValue } from "../core/permission-rule-model.js";
|
|
83
|
-
import { inheritedChildPool, inheritedMcpDeclarations } from "./inherited-tool-pool.js";
|
|
83
|
+
import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutHostSeats } from "./inherited-tool-pool.js";
|
|
84
84
|
import { readMember, thrownText } from "../core/thrown-value.js";
|
|
85
85
|
const BG_AGENT_RESULT_MAX = 4_000;
|
|
86
86
|
const BG_AGENT_RESULT_FULL_MAX = 200_000;
|
|
@@ -517,7 +517,7 @@ export function createSubagentResume(deps) {
|
|
|
517
517
|
assertNoRetiredKeys(deps, RETIRED_RESUME_CLAMP_KEYS, "createSubagentResume");
|
|
518
518
|
assertClampRecord(deps.currentClamps, "createSubagentResume currentClamps");
|
|
519
519
|
const notifier = createSafeNotifier(deps.onNotifyError !== undefined ? { onError: deps.onNotifyError } : undefined);
|
|
520
|
-
const
|
|
520
|
+
const resumeAs = (peerOrigin) => async (content) => {
|
|
521
521
|
const ledger = deps.ledger;
|
|
522
522
|
if (!ledger) {
|
|
523
523
|
throw configError("resume unavailable: the parent run did not enable TaskSpec.retainSubagentSessions.", "resume.retain_off");
|
|
@@ -553,6 +553,7 @@ export function createSubagentResume(deps) {
|
|
|
553
553
|
let stream;
|
|
554
554
|
let reviveCycle;
|
|
555
555
|
let reviveEmit;
|
|
556
|
+
let releaseCycleSlot = noopRelease;
|
|
556
557
|
let marker;
|
|
557
558
|
let reviveStartedAt = Date.now();
|
|
558
559
|
try {
|
|
@@ -577,7 +578,7 @@ export function createSubagentResume(deps) {
|
|
|
577
578
|
const wakeClamps = foldClampSources(entry.specSnapshot, deps.currentClamps);
|
|
578
579
|
const resumeSpec = applyClampSeats({
|
|
579
580
|
...entry.specSnapshot,
|
|
580
|
-
objective: createResumePrompt(marker, content,
|
|
581
|
+
objective: createResumePrompt(marker, content, peerOrigin !== undefined ? "peer" : "operator"),
|
|
581
582
|
sessionId: entry.childSessionId,
|
|
582
583
|
requireExistingSession: true,
|
|
583
584
|
...(deps.currentOnQuestion !== undefined ? { onQuestion: deps.currentOnQuestion } : {}),
|
|
@@ -651,8 +652,11 @@ export function createSubagentResume(deps) {
|
|
|
651
652
|
usage: { toolUses: toolStarts },
|
|
652
653
|
});
|
|
653
654
|
}, deps.registry !== undefined && deps.taskId !== undefined ? () => deps.registry.noteBackgroundAgentActivity(deps.taskId) : undefined);
|
|
655
|
+
releaseCycleSlot = deps.entryGate?.occupy(reviveCycle !== undefined ? "registered" : "local") ?? noopRelease;
|
|
654
656
|
stream = childRunner.runTaskStream(resumeSpec, undefined, {
|
|
655
657
|
...entry.internalsSnapshot,
|
|
658
|
+
...inheritedHostSeats(deps.currentMcpHostSeats, resumeSpec.mcp ?? []),
|
|
659
|
+
...(peerOrigin === undefined ? { operatorObjective: true } : {}),
|
|
656
660
|
cycleSeq: entry.cycleSeq,
|
|
657
661
|
parentInteractionPosture: postureUnderClamps(entry.internalsSnapshot.parentInteractionPosture, { interactiveTools: resumeSpec.interactiveTools, approvalReach: resumeSpec.approvalReach }),
|
|
658
662
|
...(true
|
|
@@ -683,7 +687,7 @@ export function createSubagentResume(deps) {
|
|
|
683
687
|
...(deps.currentParentNotify !== undefined
|
|
684
688
|
? { parentNotify: deps.currentParentNotify, parentPeerRef: deps.currentParentPeerRef }
|
|
685
689
|
: {}),
|
|
686
|
-
peerInboundChainRef: createPeerInboundChainRef(
|
|
690
|
+
peerInboundChainRef: createPeerInboundChainRef(peerOrigin?.hopChain),
|
|
687
691
|
...(reviveCycle !== undefined
|
|
688
692
|
? {
|
|
689
693
|
onNotifyInjectorReady: (inject) => {
|
|
@@ -707,18 +711,21 @@ export function createSubagentResume(deps) {
|
|
|
707
711
|
catch (err) {
|
|
708
712
|
entry.running = false;
|
|
709
713
|
entry.activeAbort = undefined;
|
|
714
|
+
releaseCycleSlot();
|
|
710
715
|
throw err;
|
|
711
716
|
}
|
|
712
717
|
if (entry.deferredNotify !== undefined) {
|
|
713
|
-
entry.deferredNotify
|
|
718
|
+
const parked = entry.deferredNotify;
|
|
714
719
|
entry.deferredNotify = undefined;
|
|
720
|
+
notifier.notify(() => parked.cancel(), "subagent.resume.park_cancel");
|
|
715
721
|
}
|
|
722
|
+
oweTerminalDelivery(deps.notify, { task_id: deps.taskId ?? entry.childSessionId, task_type: "background_agent" });
|
|
716
723
|
let settleResolve;
|
|
717
724
|
const settled = new Promise((r) => {
|
|
718
725
|
settleResolve = r;
|
|
719
726
|
});
|
|
720
727
|
if (deps.sink) {
|
|
721
|
-
notifier.notify(() => deps.sink?.(createSteerHandle(stream, deps.parentToolCallId, entry.agentName, settled, { resume, childSessionId: entry.childSessionId })), "subagent.resume.sink");
|
|
728
|
+
notifier.notify(() => deps.sink?.(createSteerHandle(stream, deps.parentToolCallId, entry.agentName, settled, { resume: operatorResume, childSessionId: entry.childSessionId })), "subagent.resume.sink");
|
|
722
729
|
}
|
|
723
730
|
void (async () => {
|
|
724
731
|
try {
|
|
@@ -771,6 +778,9 @@ export function createSubagentResume(deps) {
|
|
|
771
778
|
named: deps.rowName !== undefined,
|
|
772
779
|
});
|
|
773
780
|
const ownsTerminalFacesRevive = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
|
|
781
|
+
const resumeResultField = await completionResultField(resumeHandbackResult, (report) => persistTaskArtifact(deps.currentTaskArtifacts, deps.taskId ?? entry.childSessionId, report));
|
|
782
|
+
if (resumeResultField?.ref !== undefined && deps.taskId !== undefined && reviveCycle !== undefined)
|
|
783
|
+
deps.registry?.recordArtifactRef(deps.taskId, resumeResultField.ref, reviveCycle);
|
|
774
784
|
const resumeFrame = {
|
|
775
785
|
task_id: deps.taskId ?? entry.childSessionId,
|
|
776
786
|
...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
|
|
@@ -784,7 +794,7 @@ export function createSubagentResume(deps) {
|
|
|
784
794
|
...(failReasonRevive !== undefined ? { error: failReasonRevive.slice(0, REPORT_FIELD_MAX) } : {}),
|
|
785
795
|
...(status === "failed" && errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
|
|
786
796
|
...providerFaultField(child),
|
|
787
|
-
...(
|
|
797
|
+
...(resumeResultField !== undefined ? { result: resumeResultField.text } : {}),
|
|
788
798
|
...(status === "killed" && child.result ? { partial: true } : {}),
|
|
789
799
|
...resumeResidual(),
|
|
790
800
|
resumable: resumableRevive,
|
|
@@ -860,6 +870,7 @@ export function createSubagentResume(deps) {
|
|
|
860
870
|
finally {
|
|
861
871
|
entry.running = false;
|
|
862
872
|
entry.activeAbort = undefined;
|
|
873
|
+
releaseCycleSlot();
|
|
863
874
|
entry.settledAt = Date.now();
|
|
864
875
|
ledger.markSettled(deps.parentToolCallId);
|
|
865
876
|
settleResolve();
|
|
@@ -867,7 +878,8 @@ export function createSubagentResume(deps) {
|
|
|
867
878
|
})();
|
|
868
879
|
return marker;
|
|
869
880
|
};
|
|
870
|
-
|
|
881
|
+
const operatorResume = resumeAs(undefined);
|
|
882
|
+
return deps.peerOrigin === undefined ? operatorResume : resumeAs(deps.peerOrigin);
|
|
871
883
|
}
|
|
872
884
|
function parkCompletionNotify(deps) {
|
|
873
885
|
const { registry, entry, owner, pendingCount, payload, notify } = deps;
|
|
@@ -896,6 +908,7 @@ function parkCompletionNotify(deps) {
|
|
|
896
908
|
return;
|
|
897
909
|
done = true;
|
|
898
910
|
unsubscribe();
|
|
911
|
+
retireTerminalDelivery(notify, payload);
|
|
899
912
|
};
|
|
900
913
|
entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
|
|
901
914
|
}
|
|
@@ -1111,9 +1124,10 @@ async function untilAbort(p, signal) {
|
|
|
1111
1124
|
async function openDelegationEntryGate(input) {
|
|
1112
1125
|
const { poolAnchor, registry, store, root, caps, revival, signal } = input;
|
|
1113
1126
|
if (root === undefined)
|
|
1114
|
-
return { key: undefined, admit: () => ({ admitted: true, release: noopRelease }) };
|
|
1127
|
+
return { key: undefined, admit: () => ({ admitted: true, release: noopRelease }), occupy: () => noopRelease };
|
|
1115
1128
|
const scope = input.scope ?? DELEGATION_POOL_DEFAULT_SCOPE;
|
|
1116
1129
|
const key = JSON.stringify([scope, root]);
|
|
1130
|
+
const occupy = (kind) => (kind === "local" ? chargeLocalDelegationInFlight(poolAnchor, key) : noopRelease);
|
|
1117
1131
|
let storedHandles = [];
|
|
1118
1132
|
let storedEnumerationOk = false;
|
|
1119
1133
|
if (store !== undefined && !revival) {
|
|
@@ -1172,9 +1186,9 @@ async function openDelegationEntryGate(input) {
|
|
|
1172
1186
|
};
|
|
1173
1187
|
}
|
|
1174
1188
|
}
|
|
1175
|
-
return { admitted: true, release: kind
|
|
1189
|
+
return { admitted: true, release: occupy(kind) };
|
|
1176
1190
|
};
|
|
1177
|
-
return { key, admit };
|
|
1191
|
+
return { key, admit, occupy };
|
|
1178
1192
|
}
|
|
1179
1193
|
function chargeDelegationEntryHandle(registry, key, store, handle) {
|
|
1180
1194
|
if (handle !== undefined)
|
|
@@ -1183,6 +1197,16 @@ function chargeDelegationEntryHandle(registry, key, store, handle) {
|
|
|
1183
1197
|
armDelegationLedgerLifecycle(registry);
|
|
1184
1198
|
sweepDelegationLedgerRound(registry, 3);
|
|
1185
1199
|
}
|
|
1200
|
+
async function releaseBoundChildSession(bound, sessionId, release) {
|
|
1201
|
+
try {
|
|
1202
|
+
await release();
|
|
1203
|
+
}
|
|
1204
|
+
catch {
|
|
1205
|
+
return false;
|
|
1206
|
+
}
|
|
1207
|
+
bound?.registry.releaseDurableTranscriptAnchor(bound.taskId, sessionId);
|
|
1208
|
+
return true;
|
|
1209
|
+
}
|
|
1186
1210
|
export { normalizeSubagentType } from "../core/permission-rule-model.js";
|
|
1187
1211
|
function canonicalSubagentTypeArgs(args, accepted, generalPurposeShadowed) {
|
|
1188
1212
|
if (args === null || typeof args !== "object" || Array.isArray(args))
|
|
@@ -1245,20 +1269,15 @@ export function forkWorktreeTranslationNote(parentCwd, worktreeDir) {
|
|
|
1245
1269
|
}
|
|
1246
1270
|
export function asyncLaunchedReceipt(p) {
|
|
1247
1271
|
const noteLines = (p.notes ?? []).filter((n) => n !== undefined && n !== "");
|
|
1248
|
-
const oneShotBlocked = p.notify && p.oneShot === true;
|
|
1249
1272
|
return (`Async agent launched successfully. (${launchReceiptNoQuoteClause(", including the task_id below,")})\n` +
|
|
1250
1273
|
`task_id: ${p.taskId} (internal ID - do not mention to user. ${launchContinuationSentence(p.taskId)})\n` +
|
|
1251
|
-
(
|
|
1252
|
-
? `${p.workingLine}
|
|
1253
|
-
: p.
|
|
1254
|
-
? `${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`
|
|
1255
|
-
: `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
|
|
1274
|
+
(p.notify
|
|
1275
|
+
? `${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`
|
|
1276
|
+
: `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
|
|
1256
1277
|
noteLines.map((n) => `${n}\n`).join("") +
|
|
1257
|
-
(
|
|
1258
|
-
? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE}
|
|
1259
|
-
:
|
|
1260
|
-
? `${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.`
|
|
1261
|
-
: `${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.`));
|
|
1278
|
+
(p.notify
|
|
1279
|
+
? `${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.`
|
|
1280
|
+
: `${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.`));
|
|
1262
1281
|
}
|
|
1263
1282
|
function runnerModelCatalog(runner) {
|
|
1264
1283
|
try {
|
|
@@ -1386,10 +1405,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1386
1405
|
const depthPermitsNesting = depth + 1 < maxDepth;
|
|
1387
1406
|
const agentToolFaces = [
|
|
1388
1407
|
...(generalPurposeShadowed ? [] : [{ name: GENERAL_PURPOSE_SUBAGENT_TYPE, ...(depthPermitsNesting ? { canRedelegate: true } : {}) }]),
|
|
1389
|
-
...available.map((a) => ({
|
|
1408
|
+
...available.map((a) => ({ a, allow: definitionAllowTools(a) })).map(({ a, allow }) => ({
|
|
1390
1409
|
name: a.name,
|
|
1391
|
-
...(
|
|
1410
|
+
...(allow !== undefined ? { allowTools: allow } : {}),
|
|
1392
1411
|
...(a.denyTools !== undefined ? { denyTools: a.denyTools } : {}),
|
|
1412
|
+
...(a.mcp !== undefined && a.mcp.length > 0 ? { servers: a.mcp.map((s) => ({ name: s.name, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) })) } : {}),
|
|
1393
1413
|
...(depthPermitsNesting && toolNameAllowed(delegationToolName, a.allowTools, a.denyTools) ? { canRedelegate: true } : {}),
|
|
1394
1414
|
...(depth === 0 && !builtins.includes(a) ? { authored: true } : {}),
|
|
1395
1415
|
})),
|
|
@@ -1510,6 +1530,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1510
1530
|
details: { error: "revive.no_background" },
|
|
1511
1531
|
});
|
|
1512
1532
|
}
|
|
1533
|
+
const revivalFloor = reviveClaim !== undefined ? readClampFloor(reviveClaim.row.policyFloor) : undefined;
|
|
1534
|
+
const floorRefusal = revivalFloor !== undefined && !revivalFloor.ok ? revivalFloor.why : undefined;
|
|
1535
|
+
if (floorRefusal !== undefined && reviveClaim?.parkedResume === undefined) {
|
|
1536
|
+
return notStartedResult({
|
|
1537
|
+
isError: true,
|
|
1538
|
+
content: `Sub-agent not revived: ${inlineUntrusted(floorRefusal, 400)}, so the restrictions it ran under cannot be held on a new cycle. Launch a new agent with the needed context instead.`,
|
|
1539
|
+
details: { error: "revive.policy_floor_unreadable" },
|
|
1540
|
+
});
|
|
1541
|
+
}
|
|
1542
|
+
const bornFloor = revivalFloor?.ok === true ? revivalFloor.floor : undefined;
|
|
1513
1543
|
const prompt = String(a.prompt ?? "").trim();
|
|
1514
1544
|
if (!prompt) {
|
|
1515
1545
|
return notStartedResult({ isError: true, content: "Sub-agent not started: 'prompt' was empty.", details: { error: "empty prompt" } });
|
|
@@ -1670,7 +1700,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1670
1700
|
const inheritedParent = ctx.modelRef ?? ctx.model;
|
|
1671
1701
|
const explicitModelChain = wantsFork ? [inheritedParentModel(inheritedParent, liveCatalog), opts.model] : [perCallModel, def?.model, opts.model];
|
|
1672
1702
|
let childModel = explicitModelChain.find((c) => c !== undefined);
|
|
1673
|
-
const deploymentStatedSubagentModel = deploymentStatesSubagentModel(runnerRoleMap(opts.runner));
|
|
1703
|
+
const deploymentStatedSubagentModel = deploymentStatesSubagentModel(runnerRoleMap(opts.runner), liveCatalog);
|
|
1674
1704
|
if (reviveClaim !== undefined && typeof childModel === "string") {
|
|
1675
1705
|
const resolvable = (ref) => {
|
|
1676
1706
|
try {
|
|
@@ -1715,6 +1745,30 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1715
1745
|
details: { error: "skill_grants.unreadable" },
|
|
1716
1746
|
});
|
|
1717
1747
|
}
|
|
1748
|
+
const stations = reviveClaim === undefined ? ctx.agentStations : undefined;
|
|
1749
|
+
if (stations?.listens("agent.offer") === true) {
|
|
1750
|
+
const listed = agentListing.find((entry) => entry.name === spawnAgentType);
|
|
1751
|
+
const offered = await stations.offered([{ name: spawnAgentType, description: listed?.description ?? "" }], ctx.signal);
|
|
1752
|
+
if (offered.length === 0) {
|
|
1753
|
+
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" } });
|
|
1754
|
+
}
|
|
1755
|
+
}
|
|
1756
|
+
if (stations?.listens("agent.spawn") === true) {
|
|
1757
|
+
const verdict = await stations.spawn({
|
|
1758
|
+
toolCallId: ctx.toolCallId,
|
|
1759
|
+
prompt,
|
|
1760
|
+
description: typeof a.description === "string" ? a.description : "",
|
|
1761
|
+
subagentType: spawnAgentType,
|
|
1762
|
+
...(spawnModel !== undefined ? { model: spawnModel } : {}),
|
|
1763
|
+
...(ctx.model?.id !== undefined ? { parentModel: ctx.model.id } : {}),
|
|
1764
|
+
background: wantsBackground,
|
|
1765
|
+
fork: wantsFork,
|
|
1766
|
+
...(agentName !== undefined ? { name: agentName } : {}),
|
|
1767
|
+
...(childCwd !== undefined ? { cwd: childCwd } : {}),
|
|
1768
|
+
}, ctx.signal);
|
|
1769
|
+
if (!verdict.go)
|
|
1770
|
+
return notStartedResult({ isError: true, content: `Sub-agent not started: ${verdict.reason.slice(0, 600)}`, details: { error: "mods.spawn_refused", refusedBy: verdict.by } });
|
|
1771
|
+
}
|
|
1718
1772
|
let worktreeDir;
|
|
1719
1773
|
if (reviveClaim === undefined && (a.isolation ?? def?.isolation) === "worktree") {
|
|
1720
1774
|
const iso = ctx.worktreeIsolation;
|
|
@@ -1837,13 +1891,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1837
1891
|
}
|
|
1838
1892
|
childPool = [...(opts.tools ?? inherited.filter((t) => ![t.name, ...(t.aliases ?? [])].some((n) => taken.has(n)))), ...accepted];
|
|
1839
1893
|
}
|
|
1840
|
-
const governingLists = def !== undefined ? { allow: def
|
|
1894
|
+
const governingLists = def !== undefined ? { allow: definitionAllowTools(def), deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
|
|
1841
1895
|
const childOwnLayer = Object.freeze({ ...(governingLists.allow != null ? { allow: Object.freeze([...governingLists.allow]) } : {}), deny: Object.freeze([...(governingLists.deny ?? [])]) });
|
|
1842
1896
|
const childListsDigest = toolListsDigest(childOwnLayer.allow, childOwnLayer.deny);
|
|
1843
1897
|
const childListsJudged = agentToolPool !== undefined ? childListsDigest : undefined;
|
|
1844
1898
|
const childCeiling = ctx.toolSelector?.layers ?? [];
|
|
1845
|
-
const
|
|
1846
|
-
const
|
|
1899
|
+
const mountedMcpNow = ctx.mountedMcp?.();
|
|
1900
|
+
const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? mountedMcpNow : undefined;
|
|
1901
|
+
const childMcp = withDefinitionServers(parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined, def?.mcp);
|
|
1847
1902
|
const childTools = [...childPool];
|
|
1848
1903
|
const childRoleBase = roleBaseOf([def !== undefined ? { systemPrompt: def.systemPrompt } : undefined, { promptRole: opts.promptRole, systemPrompt: opts.systemPrompt }]);
|
|
1849
1904
|
const childSystemPrompt = childRoleBase?.systemPrompt;
|
|
@@ -1911,7 +1966,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1911
1966
|
queueReport: async (framed) => injectObservedRequest(framed, "observer"),
|
|
1912
1967
|
};
|
|
1913
1968
|
const reportTool = createObserverReportToolSpec(reportOpts);
|
|
1914
|
-
const observerModelPick = () => childModelSeat(undefined, deploymentStatesSubagentModel(runnerRoleMap(opts.runner)), ctx.modelRef ?? ctx.model, runnerModelCatalog(opts.runner));
|
|
1969
|
+
const observerModelPick = () => childModelSeat(undefined, deploymentStatesSubagentModel(runnerRoleMap(opts.runner), runnerModelCatalog(opts.runner)), ctx.modelRef ?? ctx.model, runnerModelCatalog(opts.runner));
|
|
1915
1970
|
const observerSpec = (objectiveText, resume) => applyParentSpecSeat({
|
|
1916
1971
|
sessionId: sid,
|
|
1917
1972
|
...(resume ? { requireExistingSession: true } : {}),
|
|
@@ -2107,10 +2162,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2107
2162
|
const liveCaptureFloor = reviveClaim === undefined
|
|
2108
2163
|
? { optedOut: (await ctx.memoryCaptureOptedOut) === true, indeterminate: (await ctx.memoryCaptureIndeterminate) === true }
|
|
2109
2164
|
: undefined;
|
|
2165
|
+
const revivalClamps = bornFloor !== undefined ? clampValuesOf(clampSourceOf(ctx, "clamp"), bornFloor) : undefined;
|
|
2166
|
+
const childPosture = revivalClamps !== undefined && clampsReachNoPerson({ interactiveTools: revivalClamps.interactiveTools, approvalReach: revivalClamps.approvalReach }) ? "headless" : ctx.interactionPosture;
|
|
2110
2167
|
const childInternals = {
|
|
2111
2168
|
...(ctx.toolSelector !== undefined ? { toolCeiling: childCeiling, ...(childListsJudged !== undefined ? { toolListsJudged: childListsJudged } : {}) } : {}),
|
|
2112
2169
|
...(childListsDigest !== undefined ? { ownToolLists: { toolName, ...(def !== undefined ? { definition: def.name } : {}), lists: childListsDigest } } : {}),
|
|
2113
|
-
...(
|
|
2170
|
+
...(mountedMcpNow?.pool !== undefined && childMcp.length > 0 ? { mcpPool: mountedMcpNow.pool } : {}),
|
|
2171
|
+
...inheritedHostSeats(mountedMcpNow?.hostSeats, childMcp),
|
|
2114
2172
|
...(childPick.modelRef !== undefined ? { inheritedModelRef: childPick.modelRef } : {}),
|
|
2115
2173
|
...(inheritedSkillGrants.length > 0 ? { inheritedSkillGrants } : {}),
|
|
2116
2174
|
...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
|
|
@@ -2130,7 +2188,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2130
2188
|
peerInboundChainRef: createPeerInboundChainRef(reviveClaim?.peerSeed?.hopChain),
|
|
2131
2189
|
...(childDefaultPersona !== undefined ? { defaultSystemPrompt: childDefaultPersona } : {}),
|
|
2132
2190
|
isDelegatedChild: true,
|
|
2133
|
-
...(
|
|
2191
|
+
...(childPosture !== undefined ? { parentInteractionPosture: childPosture } : {}),
|
|
2134
2192
|
...(reviveClaim === undefined
|
|
2135
2193
|
? {
|
|
2136
2194
|
...(liveCaptureFloor?.optedOut === true ? { memoryCaptureFloor: true } : {}),
|
|
@@ -2196,12 +2254,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2196
2254
|
...(provenanceAgentName !== undefined ? { agentName: provenanceAgentName } : {}),
|
|
2197
2255
|
})
|
|
2198
2256
|
: undefined;
|
|
2199
|
-
const
|
|
2257
|
+
const underBornFloor = (spec) => (bornFloor === undefined ? spec : applyClampSeats(spec, clampValuesOf(spec, bornFloor)));
|
|
2258
|
+
const buildChildSpec = (signal) => underBornFloor(applyParentSpecSeat({
|
|
2200
2259
|
objective: prompt,
|
|
2201
2260
|
...childSeat,
|
|
2202
2261
|
...childThinking,
|
|
2203
2262
|
tools: childTools,
|
|
2204
|
-
...(childMcp
|
|
2263
|
+
...(childMcp.length > 0 ? { mcp: childMcp } : {}),
|
|
2205
2264
|
systemPrompt: childSystemPrompt,
|
|
2206
2265
|
...(childRoleBase?.promptRole !== undefined ? { promptRole: childRoleBase.promptRole } : {}),
|
|
2207
2266
|
...(def?.memory ? { memory: def.memory } : {}),
|
|
@@ -2220,15 +2279,29 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2220
2279
|
enableBlockedReport: true,
|
|
2221
2280
|
limits: childLimits,
|
|
2222
2281
|
signal,
|
|
2223
|
-
}, parentSpecSeat);
|
|
2224
|
-
const
|
|
2282
|
+
}, parentSpecSeat));
|
|
2283
|
+
const spawnPolicyFloor = () => clampSeatsOf(buildChildSpec(undefined));
|
|
2284
|
+
const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, bound, internalsExtra) => {
|
|
2225
2285
|
if (!ledger)
|
|
2226
2286
|
return undefined;
|
|
2227
2287
|
const childSessionId = preMintedSessionId ?? uuidv7();
|
|
2228
2288
|
const retainStrip = stripSpawnTurnQuestionFace(buildChildSpec(undefined));
|
|
2229
2289
|
const { signal: _spawnSignal, ...plainSpec } = retainStrip.spec;
|
|
2290
|
+
const launchesOnThisId = preMintedSessionId !== undefined;
|
|
2291
|
+
let releasing;
|
|
2292
|
+
const releaseEntry = () => (releasing ??= (async () => {
|
|
2293
|
+
try {
|
|
2294
|
+
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2295
|
+
}
|
|
2296
|
+
catch {
|
|
2297
|
+
}
|
|
2298
|
+
if (durableProbe && (await durableProbe().catch(() => false)))
|
|
2299
|
+
return;
|
|
2300
|
+
await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
|
|
2301
|
+
})());
|
|
2230
2302
|
let entry = ledger.register(ctx.toolCallId, {
|
|
2231
2303
|
childSessionId,
|
|
2304
|
+
declarations: holdChildDeclarations(opts.runner, plainSpec),
|
|
2232
2305
|
runner: opts.runner,
|
|
2233
2306
|
...(entryTtlMs !== undefined ? { ttlMs: entryTtlMs } : {}),
|
|
2234
2307
|
...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
|
|
@@ -2245,22 +2318,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2245
2318
|
...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
|
|
2246
2319
|
...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
|
|
2247
2320
|
}),
|
|
2248
|
-
internalsSnapshot: { ...childInternals, ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
|
|
2249
|
-
release:
|
|
2250
|
-
try {
|
|
2251
|
-
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2252
|
-
}
|
|
2253
|
-
catch {
|
|
2254
|
-
}
|
|
2255
|
-
if (durableProbe && (await durableProbe().catch(() => false)))
|
|
2256
|
-
return;
|
|
2257
|
-
try {
|
|
2258
|
-
await opts.runner.sessions.release(childSessionId);
|
|
2259
|
-
releaseAnchor?.();
|
|
2260
|
-
}
|
|
2261
|
-
catch {
|
|
2262
|
-
}
|
|
2263
|
-
},
|
|
2321
|
+
internalsSnapshot: { ...withoutHostSeats(childInternals), ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
|
|
2322
|
+
release: releaseEntry,
|
|
2264
2323
|
});
|
|
2265
2324
|
if (entry) {
|
|
2266
2325
|
try {
|
|
@@ -2268,21 +2327,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2268
2327
|
}
|
|
2269
2328
|
catch {
|
|
2270
2329
|
await ledger.evict(ctx.toolCallId);
|
|
2330
|
+
if (launchesOnThisId)
|
|
2331
|
+
await releaseEntry();
|
|
2271
2332
|
entry = undefined;
|
|
2272
2333
|
}
|
|
2273
2334
|
if (entry !== undefined && (ledger.disposed || ledger.get(ctx.toolCallId) !== entry)) {
|
|
2335
|
+
if (launchesOnThisId)
|
|
2336
|
+
await releaseEntry();
|
|
2274
2337
|
try {
|
|
2275
2338
|
await opts.runner.sessions.unpin?.(childSessionId);
|
|
2276
2339
|
}
|
|
2277
2340
|
catch {
|
|
2278
2341
|
}
|
|
2279
2342
|
if (!(durableProbe && (await durableProbe().catch(() => false)))) {
|
|
2280
|
-
|
|
2281
|
-
await opts.runner.sessions.release(childSessionId);
|
|
2282
|
-
releaseAnchor?.();
|
|
2283
|
-
}
|
|
2284
|
-
catch {
|
|
2285
|
-
}
|
|
2343
|
+
await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
|
|
2286
2344
|
}
|
|
2287
2345
|
entry = undefined;
|
|
2288
2346
|
}
|
|
@@ -2312,6 +2370,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2312
2370
|
const { signal: _spawnSignal, ...plainSpec } = failedRetainStrip.spec;
|
|
2313
2371
|
const entry = ledger.register(ctx.toolCallId, {
|
|
2314
2372
|
childSessionId,
|
|
2373
|
+
declarations: holdChildDeclarations(opts.runner, plainSpec),
|
|
2315
2374
|
runner: opts.runner,
|
|
2316
2375
|
ttlMs: FAILED_SESSION_RETAIN_TTL_MS,
|
|
2317
2376
|
...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
|
|
@@ -2328,7 +2387,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2328
2387
|
...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
|
|
2329
2388
|
...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
|
|
2330
2389
|
}),
|
|
2331
|
-
internalsSnapshot: { ...childInternals, ...failedRetainStrip.internalsFlag },
|
|
2390
|
+
internalsSnapshot: { ...withoutHostSeats(childInternals), ...failedRetainStrip.internalsFlag },
|
|
2332
2391
|
release: releaseChild,
|
|
2333
2392
|
});
|
|
2334
2393
|
if (entry) {
|
|
@@ -2430,7 +2489,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2430
2489
|
const forkObjective = `${FORK_DIRECTIVE_FRAME}${prompt}${forkWorktreeNote !== undefined ? `\n\n${forkWorktreeNote}` : ""}${parentSpecSeat?.advisorModel !== undefined ? `\n\n${ADVISOR_FORK_SENTENCE}` : ""}`;
|
|
2431
2490
|
if (wantsBackground) {
|
|
2432
2491
|
const bg = opts.background;
|
|
2433
|
-
const notify = ctx.onTaskNotification
|
|
2492
|
+
const notify = resolveCompletionSink(ctx.onTaskNotification, bg.notify);
|
|
2434
2493
|
const abort = new AbortController();
|
|
2435
2494
|
const sessionScopedBg = ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
|
|
2436
2495
|
const onHostAbort = () => abort.abort();
|
|
@@ -2441,7 +2500,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2441
2500
|
else if (!sessionScopedBg)
|
|
2442
2501
|
ctx.signal.addEventListener("abort", onHostAbort, { once: true });
|
|
2443
2502
|
}
|
|
2444
|
-
const shortDesc = `fork: ${(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt
|
|
2503
|
+
const shortDesc = `fork: ${redactThenCut(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt, 180)}`;
|
|
2445
2504
|
const bgOwner = sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
|
|
2446
2505
|
const bgScope = treeScope;
|
|
2447
2506
|
const forkEntryGate = await openEntryGate();
|
|
@@ -2500,16 +2559,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2500
2559
|
}
|
|
2501
2560
|
if (!settled) {
|
|
2502
2561
|
const detail = childThrownText(lastErr);
|
|
2503
|
-
|
|
2504
|
-
enqueueMemoryAnnouncement(forkSettlementSeat.controlDir, {
|
|
2505
|
-
kind: "gate",
|
|
2506
|
-
at: Date.now(),
|
|
2507
|
-
items: [`delegation settlement: the terminal observation for a background fork of session ${JSON.stringify(forkSettlementSeat.sessionId)} could NOT be recorded (verdict ${verdict}) — the row stays pending and expires as UNPROVEN at the settlement window (fail-closed floor): ${detail.slice(0, 200)}`],
|
|
2508
|
-
});
|
|
2509
|
-
}
|
|
2510
|
-
catch {
|
|
2511
|
-
console.warn(`[sema] delegation settlement terminal write failed (fork, verdict ${verdict}, session ${forkSettlementSeat.sessionId}): ${detail}`);
|
|
2512
|
-
}
|
|
2562
|
+
console.warn(`[sema] delegation settlement terminal write failed (fork, verdict ${verdict}, session ${forkSettlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
|
|
2513
2563
|
}
|
|
2514
2564
|
};
|
|
2515
2565
|
let taskId;
|
|
@@ -2528,7 +2578,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2528
2578
|
deliveryChannel: "attaching",
|
|
2529
2579
|
toolUseId: ctx.toolCallId,
|
|
2530
2580
|
...(ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
|
|
2531
|
-
...(bg.agentStore !== undefined ? { store: bg.agentStore } : {}),
|
|
2581
|
+
...(bg.agentStore !== undefined ? { store: bg.agentStore, policyFloor: spawnPolicyFloor() } : {}),
|
|
2532
2582
|
abort,
|
|
2533
2583
|
});
|
|
2534
2584
|
}
|
|
@@ -2551,6 +2601,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2551
2601
|
}
|
|
2552
2602
|
if (forkEntryGate.key !== undefined)
|
|
2553
2603
|
chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
|
|
2604
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
2554
2605
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
2555
2606
|
bg.registry.bindBackgroundAgentSession(taskId, forkedId);
|
|
2556
2607
|
const forkBgHangAt = Date.now();
|
|
@@ -2725,11 +2776,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2725
2776
|
const completionIdFork = bg.registry.getCompletionId(taskId);
|
|
2726
2777
|
const stillbornFork = child.terminal.kind === "failed" && child.terminal.code === "resume.session_not_found";
|
|
2727
2778
|
if (stillbornFork) {
|
|
2728
|
-
|
|
2729
|
-
await (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId));
|
|
2730
|
-
}
|
|
2731
|
-
catch {
|
|
2732
|
-
}
|
|
2779
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, forkedId, () => (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId)));
|
|
2733
2780
|
}
|
|
2734
2781
|
const residualFork = residualFields();
|
|
2735
2782
|
const resumableFork = false;
|
|
@@ -2740,6 +2787,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2740
2787
|
? `Agent "${shortDesc}" failed: ${failReasonFork}${ccElapsedTag(forkElapsedMs)}`.slice(0, 300) + errorKindClause(errClassFork)
|
|
2741
2788
|
: `${ccCompletionText(shortDesc, settledBg, childFace.status, forkElapsedMs)}`;
|
|
2742
2789
|
const ownsTerminalFacesFork = bg.registry.claimAgentTerminalNotify(taskId);
|
|
2790
|
+
const forkResultField = await completionResultField(forkBgResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report));
|
|
2791
|
+
if (forkResultField?.ref !== undefined)
|
|
2792
|
+
bg.registry.recordArtifactRef(taskId, forkResultField.ref, 0);
|
|
2743
2793
|
const forkFrame = {
|
|
2744
2794
|
task_id: taskId,
|
|
2745
2795
|
task_type: "background_agent",
|
|
@@ -2752,7 +2802,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2752
2802
|
...(settledBg === "failed" && errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
|
|
2753
2803
|
...providerFaultField(child),
|
|
2754
2804
|
...(child.sessionId ? { sessionId: child.sessionId } : {}),
|
|
2755
|
-
...(
|
|
2805
|
+
...(forkResultField !== undefined ? { result: forkResultField.text } : {}),
|
|
2756
2806
|
...(settledBg === "killed" && child.result ? { partial: true } : {}),
|
|
2757
2807
|
...residualFork,
|
|
2758
2808
|
resumable: resumableFork,
|
|
@@ -2814,7 +2864,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2814
2864
|
taskId,
|
|
2815
2865
|
workingLine: `The forked agent inherits your full current context and works on its prompt in the background.`,
|
|
2816
2866
|
notify: Boolean(notify),
|
|
2817
|
-
oneShot: ctx.oneShot === true,
|
|
2818
2867
|
notes: [
|
|
2819
2868
|
modelNote,
|
|
2820
2869
|
extraToolsNote,
|
|
@@ -2938,7 +2987,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2938
2987
|
if (ctx.checkpointStoreForChildren !== undefined && ctx.checkpointStoreForChildren !== "disabled" && bg.checkpointStore !== undefined && bg.checkpointStore !== ctx.checkpointStoreForChildren)
|
|
2939
2988
|
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");
|
|
2940
2989
|
const childParkStore = ctx.checkpointStoreForChildren === undefined ? bg.checkpointStore : ctx.checkpointStoreForChildren === "disabled" ? undefined : ctx.checkpointStoreForChildren;
|
|
2941
|
-
const notify = ctx.onTaskNotification
|
|
2990
|
+
const notify = resolveCompletionSink(ctx.onTaskNotification, bg.notify);
|
|
2942
2991
|
const abort = new AbortController();
|
|
2943
2992
|
const reviveRow = reviveClaim?.row;
|
|
2944
2993
|
const parkedResume = reviveClaim?.parkedResume;
|
|
@@ -3008,16 +3057,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3008
3057
|
}
|
|
3009
3058
|
if (!settled) {
|
|
3010
3059
|
const detail = childThrownText(lastErr);
|
|
3011
|
-
|
|
3012
|
-
enqueueMemoryAnnouncement(settlementSeat.controlDir, {
|
|
3013
|
-
kind: "gate",
|
|
3014
|
-
at: Date.now(),
|
|
3015
|
-
items: [`delegation settlement: the terminal observation for a background delegation of session ${JSON.stringify(settlementSeat.sessionId)} could NOT be recorded (verdict ${verdict}) — the row stays pending and expires as UNPROVEN at the settlement window (fail-closed floor): ${detail.slice(0, 200)}`],
|
|
3016
|
-
});
|
|
3017
|
-
}
|
|
3018
|
-
catch {
|
|
3019
|
-
console.warn(`[sema] delegation settlement terminal write failed (verdict ${verdict}, session ${settlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
|
|
3020
|
-
}
|
|
3060
|
+
console.warn(`[sema] delegation settlement terminal write failed (verdict ${verdict}, session ${settlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
|
|
3021
3061
|
}
|
|
3022
3062
|
};
|
|
3023
3063
|
let taskId;
|
|
@@ -3071,7 +3111,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3071
3111
|
deliveryChannel: "attaching",
|
|
3072
3112
|
toolUseId: ctx.toolCallId,
|
|
3073
3113
|
...(ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
|
|
3074
|
-
...(bg.agentStore !== undefined ? { store: bg.agentStore } : {}),
|
|
3114
|
+
...(bg.agentStore !== undefined ? { store: bg.agentStore, policyFloor: spawnPolicyFloor() } : {}),
|
|
3075
3115
|
abort,
|
|
3076
3116
|
});
|
|
3077
3117
|
}
|
|
@@ -3090,6 +3130,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3090
3130
|
}
|
|
3091
3131
|
if (capLedgerKey !== undefined)
|
|
3092
3132
|
chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
|
|
3133
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
3093
3134
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
3094
3135
|
if (agentName !== undefined) {
|
|
3095
3136
|
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" }));
|
|
@@ -3164,7 +3205,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3164
3205
|
: ctx.subagentRetain;
|
|
3165
3206
|
if (sessionScopedBg && bgRetainLedger)
|
|
3166
3207
|
ensureSessionReapHook(bg.registry);
|
|
3167
|
-
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe,
|
|
3208
|
+
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, {
|
|
3168
3209
|
delegationTaskType: "background_agent",
|
|
3169
3210
|
});
|
|
3170
3211
|
if (bgRetain) {
|
|
@@ -3175,6 +3216,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3175
3216
|
await origRelease();
|
|
3176
3217
|
};
|
|
3177
3218
|
}
|
|
3219
|
+
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
|
|
3178
3220
|
const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
|
|
3179
3221
|
bg.agentStore !== undefined &&
|
|
3180
3222
|
childParkStore !== undefined &&
|
|
@@ -3299,6 +3341,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3299
3341
|
? `parked resume failed — the approval is no longer redeemable: ${msg}`
|
|
3300
3342
|
: `parked resume did not proceed (${disp}): ${msg}`, { cause: e });
|
|
3301
3343
|
};
|
|
3344
|
+
if (floorRefusal !== undefined)
|
|
3345
|
+
return rollbackAndThrow(Object.assign(new Error(`the agent was not resumed: ${inlineUntrusted(floorRefusal, 400)}, so the restrictions it ran under cannot be held on a new cycle`), { code: "revive.policy_floor_unreadable" }));
|
|
3302
3346
|
try {
|
|
3303
3347
|
await opts.runner.sessions.acquire(bgChildSessionId, { requireExisting: true });
|
|
3304
3348
|
if (opts.runner.sessions.forget)
|
|
@@ -3539,12 +3583,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3539
3583
|
}) ??
|
|
3540
3584
|
(abort.signal.aborted ? "killed" : ok ? "completed" : "failed");
|
|
3541
3585
|
if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
|
|
3542
|
-
|
|
3543
|
-
await opts.runner.sessions.release(child.sessionId);
|
|
3544
|
-
bg.registry.releaseDurableTranscriptAnchor(taskId);
|
|
3545
|
-
}
|
|
3546
|
-
catch {
|
|
3547
|
-
}
|
|
3586
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, child.sessionId, () => opts.runner.sessions.release(child.sessionId));
|
|
3548
3587
|
}
|
|
3549
3588
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3550
3589
|
const completionIdBg = bg.registry.getCompletionId(taskId);
|
|
@@ -3565,6 +3604,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3565
3604
|
? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
|
|
3566
3605
|
: `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
|
|
3567
3606
|
const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
|
|
3607
|
+
const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report));
|
|
3608
|
+
if (bgResultField?.ref !== undefined)
|
|
3609
|
+
bg.registry.recordArtifactRef(taskId, bgResultField.ref, 0);
|
|
3568
3610
|
const completionFrame = {
|
|
3569
3611
|
task_id: taskId,
|
|
3570
3612
|
task_type: "background_agent",
|
|
@@ -3578,7 +3620,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3578
3620
|
...(settled === "failed" && errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
|
|
3579
3621
|
...providerFaultField(child),
|
|
3580
3622
|
...(child.sessionId ? { sessionId: child.sessionId } : {}),
|
|
3581
|
-
...(
|
|
3623
|
+
...(bgResultField !== undefined ? { result: bgResultField.text } : {}),
|
|
3582
3624
|
...(settled === "killed" && child.result ? { partial: true } : {}),
|
|
3583
3625
|
...residual,
|
|
3584
3626
|
resumable: resumableBg,
|
|
@@ -3632,12 +3674,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3632
3674
|
...(errClassBgReject !== undefined ? { retryable: errClassBgReject.retryable, errorKind: errClassBgReject.errorKind } : {}),
|
|
3633
3675
|
}) ?? (killed ? "killed" : "failed");
|
|
3634
3676
|
if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
|
|
3635
|
-
|
|
3636
|
-
await opts.runner.sessions.release(bgChildSessionId);
|
|
3637
|
-
bg.registry.releaseDurableTranscriptAnchor(taskId);
|
|
3638
|
-
}
|
|
3639
|
-
catch {
|
|
3640
|
-
}
|
|
3677
|
+
await releaseBoundChildSession({ registry: bg.registry, taskId }, bgChildSessionId, () => opts.runner.sessions.release(bgChildSessionId));
|
|
3641
3678
|
}
|
|
3642
3679
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3643
3680
|
const completionIdBgReject = bg.registry.getCompletionId(taskId);
|
|
@@ -3697,7 +3734,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3697
3734
|
taskId,
|
|
3698
3735
|
workingLine: `The agent is working in the background.`,
|
|
3699
3736
|
notify: Boolean(notify),
|
|
3700
|
-
oneShot: ctx.oneShot === true,
|
|
3701
3737
|
notes: [
|
|
3702
3738
|
modelNote,
|
|
3703
3739
|
extraToolsNote,
|
|
@@ -3744,9 +3780,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3744
3780
|
...(opts.background?.notify ? { notify: opts.background.notify } : {}),
|
|
3745
3781
|
sink: ctx.onSubagentSpawn,
|
|
3746
3782
|
...(opts.background ? { registry: opts.background.registry } : {}),
|
|
3783
|
+
entryGate: syncEntryGate,
|
|
3747
3784
|
...(opts.onObserverError !== undefined ? { onNotifyError: (f) => opts.onObserverError?.(f.error, { site: f.site }) } : {}),
|
|
3748
3785
|
...(ctx.onQuestion !== undefined ? { currentOnQuestion: ctx.onQuestion } : {}),
|
|
3749
3786
|
...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
|
|
3787
|
+
currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
|
|
3750
3788
|
});
|
|
3751
3789
|
notifier.notify(() => ctx.onSubagentSpawn?.(createSteerHandle(stream, ctx.toolCallId, childAgentName, settled, {
|
|
3752
3790
|
resume,
|