@sema-agent/core 7.60.0 → 7.62.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -17,14 +17,15 @@ export { DEFAULT_CHARS_PER_TOKEN, DEFAULT_CLAMP_TOLERANCE, DEFAULT_COMPACTION_SE
|
|
|
17
17
|
export { SKILL_RETENTION_PER_SKILL_MAX_CHARS, SKILL_RETENTION_TOTAL_MAX_CHARS, SKILL_RETENTION_TRUNCATION_MARKER, formatFileOperations, formatPersistedOutputRefs, readCompactionActiveTools, readRetainedInvokedSkills, renderInvokedSkillsRetention, } from "../engine/compaction/utils.js";
|
|
18
18
|
export { NodeExecutionEnv } from "../engine/execution-env/node-execution-env.js";
|
|
19
19
|
export { StoredSession, buildSessionContext } from "../engine/session/session.js";
|
|
20
|
-
export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, readIncarnationCell, readOwnerCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
|
|
20
|
+
export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
|
|
21
21
|
export { validateEntriesForImport, StreamingImportValidator } from "../engine/session/import-validate.js";
|
|
22
|
-
export { BaseSessionStorage, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
|
|
22
|
+
export { BaseSessionStorage, entryParentLinks, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
|
|
23
23
|
export { InMemorySessionStorage } from "../engine/session/memory-storage.js";
|
|
24
24
|
export { InMemorySessionRepo } from "../engine/session/memory-repo.js";
|
|
25
25
|
export { uuidv7 } from "../engine/session/uuid.js";
|
|
26
26
|
export { ParentChainGuard } from "../engine/session/parent-chain-guard.js";
|
|
27
|
-
export type { ForkPoint } from "../engine/session/path-to-root.js";
|
|
27
|
+
export type { ForkPoint, ReplayLoss } from "../engine/session/path-to-root.js";
|
|
28
|
+
export { LineageBreak, pathToRoot, replayLossText } from "../engine/session/path-to-root.js";
|
|
28
29
|
export { findUnansweredToolBatch, readToolCallArguments } from "../engine/loop/agent-loop.js";
|
|
29
30
|
export { SessionError } from "../engine/harness/types.js";
|
|
30
31
|
export type { AnnouncedAdvisorState, AnnouncedListingSnapshot, AnnouncedListingSnapshotInput, AnnouncedMcpFailure } from "../engine/harness/types.js";
|
package/dist/internal/harness.js
CHANGED
|
@@ -5,13 +5,14 @@ export { DEFAULT_CHARS_PER_TOKEN, DEFAULT_CLAMP_TOLERANCE, DEFAULT_COMPACTION_SE
|
|
|
5
5
|
export { SKILL_RETENTION_PER_SKILL_MAX_CHARS, SKILL_RETENTION_TOTAL_MAX_CHARS, SKILL_RETENTION_TRUNCATION_MARKER, formatFileOperations, formatPersistedOutputRefs, readCompactionActiveTools, readRetainedInvokedSkills, renderInvokedSkillsRetention, } from "../engine/compaction/utils.js";
|
|
6
6
|
export { NodeExecutionEnv } from "../engine/execution-env/node-execution-env.js";
|
|
7
7
|
export { StoredSession, buildSessionContext } from "../engine/session/session.js";
|
|
8
|
-
export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, readIncarnationCell, readOwnerCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
|
|
8
|
+
export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
|
|
9
9
|
export { validateEntriesForImport, StreamingImportValidator } from "../engine/session/import-validate.js";
|
|
10
|
-
export { BaseSessionStorage, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
|
|
10
|
+
export { BaseSessionStorage, entryParentLinks, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
|
|
11
11
|
export { InMemorySessionStorage } from "../engine/session/memory-storage.js";
|
|
12
12
|
export { InMemorySessionRepo } from "../engine/session/memory-repo.js";
|
|
13
13
|
export { uuidv7 } from "../engine/session/uuid.js";
|
|
14
14
|
export { ParentChainGuard } from "../engine/session/parent-chain-guard.js";
|
|
15
|
+
export { LineageBreak, pathToRoot, replayLossText } from "../engine/session/path-to-root.js";
|
|
15
16
|
export { findUnansweredToolBatch, readToolCallArguments } from "../engine/loop/agent-loop.js";
|
|
16
17
|
export { SessionError } from "../engine/harness/types.js";
|
|
17
18
|
export { normalizeGitAnnouncement } from "../engine/harness/types.js";
|
package/dist/internal/llm.d.ts
CHANGED
|
@@ -5,5 +5,6 @@
|
|
|
5
5
|
* llm-core); the facade stays so consumers never notice which side a symbol lives on.
|
|
6
6
|
*/
|
|
7
7
|
export { createAssistantMessageEventStream, DATA_LABEL_UNSAFE, ensureToolTurnInvariants, findToolByName, isTextBlock, MODEL_OUTPUT_INVALID_CAUSES, quoteDataLabel, renderContentBlock, renderUserAttachmentView, snapshotActorAssertion, stampStreamDrops, streamDropsOf, stripEngineMetadata, TOOL_TURN_INCOMPLETE_CAUSES, TOOL_TURN_REPAIR_DROPS, toolNameIndex, userAttachmentOf } from "../engine/llm/index.js";
|
|
8
|
-
export type { ActorAssertion, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, UserMessageAttachment, AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ModelOutputInvalid, ModelOutputInvalidCause, OutputLimit, ResilienceOptions, RouteAdjudication, RouteCredential, RouteCredentialSource, RoutePairingConfig, RoutePairingPosture, RouteRefusalCode, RouteRefusalDetail, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolDescriptionVariant, ToolResultMessage, StreamDrop, StreamDropCause, ToolTurnIncompleteCause, ToolTurnRepair, Usage, UserMessage, } from "../engine/llm/index.js";
|
|
8
|
+
export type { ActorAssertion, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, UserMessageAttachment, AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ModelOutputInvalid, ModelOutputInvalidCause, OutputLimit, ResilienceOptions, RouteAdjudication, RouteCredential, RouteCredentialSource, RoutePairingConfig, RoutePairingPosture, RouteRefusalCode, RouteRefusalDetail, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolDescriptionVariant, ToolResultMessage, StreamDrop, StreamDropCause, ToolTurnIncompleteCause, ToolTurnRepair, Usage, UserMessage, RowRewrittenBy, } from "../engine/llm/index.js";
|
|
9
9
|
export type { RejectedImageRemoval } from "../engine/llm/rejected-images.js";
|
|
10
|
+
export { MEDIA_REMOVED_REASONS, mediaRemovedPlaceholder, type MediaRemovedReason } from "../engine/llm/media-removed.js";
|
package/dist/internal/llm.js
CHANGED
|
@@ -1 +1,2 @@
|
|
|
1
1
|
export { createAssistantMessageEventStream, DATA_LABEL_UNSAFE, ensureToolTurnInvariants, findToolByName, isTextBlock, MODEL_OUTPUT_INVALID_CAUSES, quoteDataLabel, renderContentBlock, renderUserAttachmentView, snapshotActorAssertion, stampStreamDrops, streamDropsOf, stripEngineMetadata, TOOL_TURN_INCOMPLETE_CAUSES, TOOL_TURN_REPAIR_DROPS, toolNameIndex, userAttachmentOf } from "../engine/llm/index.js";
|
|
2
|
+
export { MEDIA_REMOVED_REASONS, mediaRemovedPlaceholder } from "../engine/llm/media-removed.js";
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* **无任何 commit/accept 副作用**(纯 loop,同 runRepairLoop SAFE-tier 永不 `fixed`)。要 accept,caller 自走
|
|
12
12
|
* design/77 Gate-1 out-of-process oracle 隔离边界,不在 goal helper 开后门。
|
|
13
13
|
*/
|
|
14
|
-
import type { RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
14
|
+
import type { RunInternals, RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
15
15
|
import type { CheckpointToken } from "../core/checkpoint-store.js";
|
|
16
16
|
import type { GateKind, PAUSE_REGISTRY } from "../core/pause-registry.js";
|
|
17
17
|
import type { PausedCause, TaskResult, TaskSpec } from "../core/types.js";
|
|
@@ -124,6 +124,10 @@ export declare const DECLARE_DONE_TOOL_NAME = "DeclareDone";
|
|
|
124
124
|
* Only `declare_done` AND `doneCheck.done` → `achieved` (surfaced, NEVER auto-accepted, G1). A rejected
|
|
125
125
|
* doneCheck feeds its reason back (fenced) and continues. Bounded by maxIterations / budget / wall-clock /
|
|
126
126
|
* cancel; a durable pause (suspended/needs_review) is a hard boundary that surfaces the checkpointToken.
|
|
127
|
+
*
|
|
128
|
+
* `internals` is the trusted run-scoped channel of the caller, forwarded to every iteration (the shape the verification gate
|
|
129
|
+
* takes): a goal run inside a delegated leg keeps the delegation fact and its caller's author. The first iteration hands over the
|
|
130
|
+
* caller's goal and carries the caller's author; every later one is this loop's own words (`engine`).
|
|
127
131
|
*/
|
|
128
|
-
export declare function runGoal(runner: RunnerSelfSeat, spec: GoalSpec): Promise<GoalResult>;
|
|
132
|
+
export declare function runGoal(runner: RunnerSelfSeat, spec: GoalSpec, internals?: RunInternals): Promise<GoalResult>;
|
|
129
133
|
export {};
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { createHash, randomUUID } from "node:crypto";
|
|
2
2
|
import { Type } from "typebox";
|
|
3
3
|
import { delimitUntrusted } from "../core/untrusted-text.js";
|
|
4
|
+
import { recipeContinuationLeg } from "../core/input-author.js";
|
|
5
|
+
import { legTaskIdOf } from "../core/leg-identity.js";
|
|
4
6
|
import { isDurablePause, pauseFamily } from "../agents/suspend-guard.js";
|
|
5
7
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
6
8
|
export const DECLARE_DONE_TOOL_NAME = "DeclareDone";
|
|
@@ -57,7 +59,7 @@ function raceAbortReject(p, signal) {
|
|
|
57
59
|
});
|
|
58
60
|
});
|
|
59
61
|
}
|
|
60
|
-
export async function runGoal(runner, spec) {
|
|
62
|
+
export async function runGoal(runner, spec, internals) {
|
|
61
63
|
if (!Number.isFinite(spec.maxIterations) || spec.maxIterations < 1) {
|
|
62
64
|
throw new Error(`runGoal: maxIterations must be a finite number ≥ 1 (got ${spec.maxIterations})`);
|
|
63
65
|
}
|
|
@@ -108,7 +110,7 @@ export async function runGoal(runner, spec) {
|
|
|
108
110
|
if (verificationKind === "mechanical" && status !== "suspended" && status !== "needs_review") {
|
|
109
111
|
runner.emitTaskOutcome?.({
|
|
110
112
|
taskSignature: spec.taskSignature ?? `goal:${objectiveHash}`,
|
|
111
|
-
runId: r.result?.taskId ?? sessionId,
|
|
113
|
+
runId: r.result?.taskId ?? legTaskIdOf(spec.taskSpec, internals, sessionId),
|
|
112
114
|
model: r.result?.model,
|
|
113
115
|
verificationKind: "mechanical",
|
|
114
116
|
status,
|
|
@@ -140,7 +142,8 @@ export async function runGoal(runner, spec) {
|
|
|
140
142
|
const tools = hasOutputSchema
|
|
141
143
|
? spec.taskSpec.tools
|
|
142
144
|
: [...(spec.taskSpec.tools ?? []), createDeclareDoneTool(doneRef)];
|
|
143
|
-
const
|
|
145
|
+
const roundInternals = { ...internals, goalMode: true };
|
|
146
|
+
const result = await runner.runTask({ ...spec.taskSpec, sessionId, objective, tools, signal: goalSignal }, iteration === 1 ? roundInternals : recipeContinuationLeg(roundInternals));
|
|
144
147
|
lastResult = result;
|
|
145
148
|
cumulativeTokens += (result.stats.tokens ?? 0) + (result.stats.nested?.tokens ?? 0);
|
|
146
149
|
spentCostMicroUsd += (result.stats.costMicroUsd ?? 0) + (result.stats.nested?.costMicroUsd ?? 0);
|
|
@@ -27,6 +27,9 @@ import { type WorkflowSizeGuideline } from "./workflow-size-guideline.js";
|
|
|
27
27
|
* `run_workflow` are NOT callable — they live in RETIRED_TOOL_NAMES as validation data only (a call
|
|
28
28
|
* under either gets a loud roster miss), so every model-visible mention must use THIS constant. */
|
|
29
29
|
export declare const RUN_WORKFLOW_TOOL_NAME = "Workflow";
|
|
30
|
+
/** The refusal a workflow call gets where its completion would come back on no channel (no completion sink for the call,
|
|
31
|
+
* none on the mount, no deployment notifier): a workflow has no synchronous form, so nothing is started. */
|
|
32
|
+
export declare const WORKFLOW_NO_COMPLETION_CHANNEL = "a workflow run is not available here \u2014 no completion would come back from one on this mount (no notification channel and no deployment notifier is wired), and a workflow has no synchronous form. Do the work directly instead.";
|
|
30
33
|
/**
|
|
31
34
|
* design/98 §D.5 — the seam the deployment implements to RE-INVOKE the originating LLM when its workflow
|
|
32
35
|
* finishes. Core calls `notify` once per run (at most once — `runId` dedup) with a REDACTED, BOUNDED summary;
|
|
@@ -58,21 +61,6 @@ export interface WorkflowCompletionNotifier {
|
|
|
58
61
|
* repeat the diagnostics field's own drift history (the comment right above this one). */
|
|
59
62
|
completionId?: string;
|
|
60
63
|
}): Promise<void> | void;
|
|
61
|
-
/**
|
|
62
|
-
* Poll-then-also-notify dedup: the ORIGINATING session was served this run's TERMINAL
|
|
63
|
-
* state IN-BAND (a `TaskOutput` poll through the task registry returned a non-running snapshot) —
|
|
64
|
-
* the deployment should ack/drop any still-pending completion-inbox entry for (originatingSessionId,
|
|
65
|
-
* runId), so a later stream-open doesn't re-deliver a `workflow_complete` the model already
|
|
66
|
-
* consumed. Fired at most once per run, AFTER `notify` may already have enqueued (the whole point:
|
|
67
|
-
* the poll usually wins the race in-turn). Optional; errors are swallowed. The shell-side same-process
|
|
68
|
-
* seed dedup remains the belt — this is the durable/cross-restart half.
|
|
69
|
-
*/
|
|
70
|
-
ackServed?(input: {
|
|
71
|
-
runId: string;
|
|
72
|
-
originatingSessionId?: string;
|
|
73
|
-
sourceTaskId?: string;
|
|
74
|
-
principal?: string;
|
|
75
|
-
}): Promise<void> | void;
|
|
76
64
|
}
|
|
77
65
|
/** design/98 §D.6 — the deployment's hard CEILINGS for an LLM-authored workflow (the tool forces them; a
|
|
78
66
|
* script may only tighten). All optional; sensible defaults bound a runaway script. */
|
|
@@ -176,7 +164,8 @@ export interface RunWorkflowToolDeps {
|
|
|
176
164
|
onAgentSpawn?: (handle: WorkflowAgentHandle) => void;
|
|
177
165
|
/** Tenant/grouping key for the run. */
|
|
178
166
|
scope?: string;
|
|
179
|
-
/** Completion re-invoke seam
|
|
167
|
+
/** Completion re-invoke seam — the deployment-channel term of the one background admission: with it, a call is
|
|
168
|
+
* admitted even when no completion sink resolves. */
|
|
180
169
|
notifier?: WorkflowCompletionNotifier;
|
|
181
170
|
/** The originating session id, threaded into every completion notify. */
|
|
182
171
|
originatingSessionId?: string;
|
|
@@ -195,12 +184,16 @@ export interface RunWorkflowToolDeps {
|
|
|
195
184
|
/** The host run tree's cross-boundary token (`RunInternals.crossBoundaryTree`), riding deps for the same auto-mounted-ctx reason as
|
|
196
185
|
* `rootSessionId` above; handed to the workflow run so every workflow-spawned agent joins the host tree's state. */
|
|
197
186
|
crossBoundaryTree?: import("../core/cross-boundary-taint.js").CrossBoundaryTreeToken;
|
|
187
|
+
/** The host run tree's owner seat (`RunInternals.delegationOwner`), riding deps for the same auto-mounted-ctx reason; handed to the
|
|
188
|
+
* workflow run so every workflow-spawned agent (and the children it delegates) reads the host tree's owner. */
|
|
189
|
+
delegationOwner?: import("../core/runner/delegation-owner.js").DelegationOwnerSeat;
|
|
198
190
|
/** Process-local unified task registry. When present, RunWorkflow returns `task_id === runId` with a `w*` id. */
|
|
199
191
|
taskRegistry?: TaskRegistry;
|
|
200
192
|
/** design/115 P2 core slice: run-local task-notification sink for SDK event + live model XML injection.
|
|
201
193
|
* design/373 §3.7: the sink accepts the injection tier — workflow terminals declare `"next"`
|
|
202
194
|
* explicitly (a completion must reach a busy model at the boundary; the parameterless funnel
|
|
203
|
-
* default is the EXTERNAL lane's `"later"` and no internal lane may lean on it).
|
|
195
|
+
* default is the EXTERNAL lane's `"later"` and no internal lane may lean on it). A call carrying its run's lane
|
|
196
|
+
* delivers there instead; with neither this nor a {@link notifier}, a call is refused before anything starts. */
|
|
204
197
|
taskNotification?: (notification: TaskNotificationPayload, opts?: {
|
|
205
198
|
priority?: "now" | "next" | "later";
|
|
206
199
|
}) => void;
|
|
@@ -268,6 +261,10 @@ export interface RunWorkflowToolDeps {
|
|
|
268
261
|
/** The HOST task's effective working root — threaded into every spawned agent's trusted internals so a
|
|
269
262
|
* TOC env factory can root the child at the parent's cwd (CC parity, 2026-07-03). */
|
|
270
263
|
parentCwd?: string;
|
|
264
|
+
/** The HOST task's own placement target (what its env reported as its workspace settled) — the fence every agent the
|
|
265
|
+
* workflow spawns is minted under (`RunInternals.placementTarget`). Rides deps for the auto-mounted form (whose
|
|
266
|
+
* execute ctx carries none); a rich ctx's own `placementTarget` wins. */
|
|
267
|
+
placementTarget?: import("../core/remote-env.js").PlacementTarget;
|
|
271
268
|
/** Call-time getter for the level a spawned agent runs at when neither the script, the agentType
|
|
272
269
|
* definition nor the governance baseline set `thinking` (the mount folds the deployment's STATED
|
|
273
270
|
* `roles.subagent.thinking` over the HOST task's current level — the child thinking seat's lower rungs).
|
|
@@ -3,11 +3,12 @@ import { defineTool, errorResult } from "../core/tools.js";
|
|
|
3
3
|
import { governanceBaselineError, governanceBaselineProblem } from "./governance-baseline-validity.js";
|
|
4
4
|
import { formatWorkflowRun, WORKFLOW_RECORD_WHOLE } from "../core/task-registry-shared.js";
|
|
5
5
|
import { persistTaskArtifact } from "../core/tool-result-store.js";
|
|
6
|
-
import { oweTerminalDelivery, resolveCompletionSink } from "../core/task-notification.js";
|
|
6
|
+
import { admitsBackgroundLaunch, oweTerminalDelivery, resolveCompletionSink } from "../core/task-notification.js";
|
|
7
7
|
import { egressText, egressThrownText, boundedRedactedSummary } from "../core/untrusted-egress.js";
|
|
8
8
|
import { withDelegationProvenance } from "../core/tool-policy.js";
|
|
9
9
|
import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "../agents/launch-receipt-contract.js";
|
|
10
10
|
import { startWorkflow } from "./workflow.js";
|
|
11
|
+
import { settledRunOf } from "../core/workflow-settled-run.js";
|
|
11
12
|
import { WORKFLOW_AGENT_PARKED_ERROR_CODE, parkedAgentsOf } from "./workflow-types.js";
|
|
12
13
|
import { checkpointStoreOfSeat } from "../core/checkpoint-seat.js";
|
|
13
14
|
import { buildWorkflowPrimitives } from "./workflow-primitives.js";
|
|
@@ -30,8 +31,9 @@ import { parseWorkflowMeta, splitWorkflowMeta, workflowScriptReadsClockOrRandom
|
|
|
30
31
|
import { mergeWorkflowArgs, normalizeStringArg } from "./workflow-script-store.js";
|
|
31
32
|
import { workflowSizeGuidelineSection } from "./workflow-size-guideline.js";
|
|
32
33
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
33
|
-
import { thrownText } from "../core/thrown-value.js";
|
|
34
|
+
import { readMember, thrownText } from "../core/thrown-value.js";
|
|
34
35
|
export const RUN_WORKFLOW_TOOL_NAME = "Workflow";
|
|
36
|
+
export const WORKFLOW_NO_COMPLETION_CHANNEL = "a workflow run is not available here — no completion would come back from one on this mount (no notification channel and no deployment notifier is wired), and a workflow has no synchronous form. Do the work directly instead.";
|
|
35
37
|
function stripCodeFences(s) {
|
|
36
38
|
const t = s.trim();
|
|
37
39
|
const m = /^```[A-Za-z]*\r?\n([\s\S]*?)\r?\n?```$/.exec(t);
|
|
@@ -70,18 +72,10 @@ function workflowRecordTeach(run, artifact) {
|
|
|
70
72
|
const recordTeach = artifact.kind === "stored"
|
|
71
73
|
? `Full record (the result and every agent's row): read it with ReadToolResult (ref "${artifact.ref}") before assuming an empty or unexpected result.`
|
|
72
74
|
: artifact.kind === "unconfirmed"
|
|
73
|
-
? "The full record (the result and every agent's row) could not be stored (the write failed or went unconfirmed), so no ref can read it back
|
|
74
|
-
: "The full record (the result and every agent's row) is not stored behind a ref (no offload store)
|
|
75
|
+
? "The full record (the result and every agent's row) could not be stored (the write failed or went unconfirmed), so no ref can read it back — it is not readable in this session."
|
|
76
|
+
: "The full record (the result and every agent's row) is not stored behind a ref (no offload store) — it is not readable in this session.";
|
|
75
77
|
return `${rowsTeach}${recordTeach}`;
|
|
76
78
|
}
|
|
77
|
-
function completionIdFromRejection(err) {
|
|
78
|
-
return workflowRunOfRejection(err)?.completionId;
|
|
79
|
-
}
|
|
80
|
-
function workflowRunOfRejection(err) {
|
|
81
|
-
if (err === null || (typeof err !== "object" && typeof err !== "function"))
|
|
82
|
-
return undefined;
|
|
83
|
-
return err.workflowRun;
|
|
84
|
-
}
|
|
85
79
|
function workflowUsageBlock(run) {
|
|
86
80
|
const agents = run.agents;
|
|
87
81
|
const parked = parkedAgentsOf(agents);
|
|
@@ -125,10 +119,11 @@ const SCRIPT_ERROR_CODES = new Set([
|
|
|
125
119
|
"workflow.budget_exceeded",
|
|
126
120
|
]);
|
|
127
121
|
function failureSummary(err, runId) {
|
|
128
|
-
const
|
|
129
|
-
const code = typeof
|
|
122
|
+
const codeWord = readMember(err, "code");
|
|
123
|
+
const code = typeof codeWord === "string" ? codeWord : undefined;
|
|
130
124
|
if (code === WORKFLOW_AGENT_PARKED_ERROR_CODE) {
|
|
131
|
-
const
|
|
125
|
+
const parkedWords = readMember(err, "message");
|
|
126
|
+
const msg = typeof parkedWords === "string" ? egressText("same-principal", parkedWords) : "";
|
|
132
127
|
return (`workflow parked (${code}): ${msg.length > 200 ? `${msg.slice(0, 200)}…` : msg} — it did not fail and is not finished` +
|
|
133
128
|
(runId ? `; the diagnostics below name its record (the parked agent's row reads status "parked")` : "") +
|
|
134
129
|
`; do not re-issue the same call — once the approval is decided, the deployment resumes this run${runId ? ` (resumeFromRunId: "${runId}")` : ""} and the script continues from the parked call`);
|
|
@@ -136,8 +131,9 @@ function failureSummary(err, runId) {
|
|
|
136
131
|
const guide = runId
|
|
137
132
|
? `; which agents failed is in the diagnostics below; after fixing, re-invoke with resumeFromRunId: "${runId}" (completed agents replay from the journal)`
|
|
138
133
|
: "";
|
|
139
|
-
|
|
140
|
-
|
|
134
|
+
const scriptWords = code && SCRIPT_ERROR_CODES.has(code) ? readMember(err, "message") : undefined;
|
|
135
|
+
if (code && typeof scriptWords === "string") {
|
|
136
|
+
const msg = egressText("same-principal", scriptWords);
|
|
141
137
|
return `workflow failed (${code}): ${msg.length > 200 ? `${msg.slice(0, 200)}…` : msg}${guide}`;
|
|
142
138
|
}
|
|
143
139
|
return `${code && code.startsWith("workflow.") ? `workflow failed (${code})` : "workflow failed"}${guide}`;
|
|
@@ -360,10 +356,9 @@ async function mountRunWorkflowTool(d) {
|
|
|
360
356
|
"role.\n" +
|
|
361
357
|
"\n" +
|
|
362
358
|
"Don't race. After launching, you know nothing about what the workflow found. Never fabricate or predict its " +
|
|
363
|
-
"results in any format — not as prose, summary, or structured output.
|
|
364
|
-
"
|
|
365
|
-
"
|
|
366
|
-
"give status, not a guess." +
|
|
359
|
+
"results in any format — not as prose, summary, or structured output. END YOUR TURN and wait — the completion " +
|
|
360
|
+
"notification carries the result and each agent's outcome (the launch note says how it reaches you). If the " +
|
|
361
|
+
"user asks a follow-up before it lands, give status, not a guess." +
|
|
367
362
|
(namedWorkflowSection !== undefined ? `\n\n${namedWorkflowSection}` : "") +
|
|
368
363
|
sizeGuidelineSection,
|
|
369
364
|
parameters: Type.Object({
|
|
@@ -398,6 +393,9 @@ async function mountRunWorkflowTool(d) {
|
|
|
398
393
|
const rawResume = rawArgs.resumeFromRunId;
|
|
399
394
|
const resumeFromRunId = typeof rawResume === "string" && rawResume.length > 0 ? rawResume : undefined;
|
|
400
395
|
const sourceTaskId = ctx.taskId ?? d.sourceTaskId;
|
|
396
|
+
const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
|
|
397
|
+
if (!admitsBackgroundLaunch(completionSink, d.notifier !== undefined))
|
|
398
|
+
return structuredError(WORKFLOW_NO_COMPLETION_CHANNEL);
|
|
401
399
|
const hostSeat = parentSpecSeatOfCtx(ctx) ?? d.parentSpecSeat;
|
|
402
400
|
const detachedSeat = hostSeat !== undefined ? stripSpawnTurnQuestionFace(hostSeat) : undefined;
|
|
403
401
|
const parentSpecSeat = detachedSeat?.spec;
|
|
@@ -519,7 +517,9 @@ async function mountRunWorkflowTool(d) {
|
|
|
519
517
|
...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
|
|
520
518
|
...((ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId } : {}),
|
|
521
519
|
...((ctx.placementRoot ?? d.placementRoot) !== undefined ? { placementRoot: ctx.placementRoot ?? d.placementRoot } : {}),
|
|
520
|
+
...((ctx.placementTarget ?? d.placementTarget) !== undefined ? { placementTarget: ctx.placementTarget ?? d.placementTarget } : {}),
|
|
522
521
|
...((ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree) !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree } : {}),
|
|
522
|
+
...((ctx.delegationOwner ?? d.delegationOwner) !== undefined ? { delegationOwner: ctx.delegationOwner ?? d.delegationOwner } : {}),
|
|
523
523
|
...(workflowTaskId !== undefined ? { runId: workflowTaskId } : {}),
|
|
524
524
|
journalStore: d.journalStore,
|
|
525
525
|
...(resumeFromRunId !== undefined ? { resumeFromRunId } : {}),
|
|
@@ -593,19 +593,8 @@ async function mountRunWorkflowTool(d) {
|
|
|
593
593
|
...(taskOwner !== undefined ? { owner: taskOwner } : {}),
|
|
594
594
|
...(taskScope !== undefined ? { scope: taskScope } : {}),
|
|
595
595
|
...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
|
|
596
|
-
onServedTerminal: () => {
|
|
597
|
-
void Promise.resolve()
|
|
598
|
-
.then(() => d.notifier?.ackServed?.({
|
|
599
|
-
runId,
|
|
600
|
-
...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
|
|
601
|
-
...(sourceTaskId !== undefined ? { sourceTaskId } : {}),
|
|
602
|
-
...(principal !== undefined ? { principal } : {}),
|
|
603
|
-
}))
|
|
604
|
-
.catch(() => { });
|
|
605
|
-
},
|
|
606
596
|
});
|
|
607
597
|
}
|
|
608
|
-
const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
|
|
609
598
|
oweTerminalDelivery(completionSink, { task_id: runId, task_type: "workflow" });
|
|
610
599
|
{
|
|
611
600
|
let notified = false;
|
|
@@ -641,7 +630,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
641
630
|
const recordOf = async (run) => {
|
|
642
631
|
const artifact = await persistTaskArtifact(d.taskArtifacts, runId, formatWorkflowRun(run, WORKFLOW_RECORD_WHOLE).content);
|
|
643
632
|
if (artifact.kind === "stored")
|
|
644
|
-
d.taskRegistry?.recordArtifactRef(runId, artifact.ref,
|
|
633
|
+
d.taskRegistry?.recordArtifactRef(runId, artifact.ref, run.completionId);
|
|
645
634
|
return workflowRecordTeach(run, artifact);
|
|
646
635
|
};
|
|
647
636
|
handle.done
|
|
@@ -656,17 +645,29 @@ async function mountRunWorkflowTool(d) {
|
|
|
656
645
|
diagnostics: workflowDiagnostics(runId, d.journalStore?.locator?.(runId, res.run.scope), res.run.resume?.journalEntries === 0, await recordOf(res.run).catch(() => "This run's record could not be read.")),
|
|
657
646
|
completionId: res.run.completionId,
|
|
658
647
|
}), async (err) => {
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
648
|
+
let parts = {
|
|
649
|
+
summary: failureSummary(undefined, runId),
|
|
650
|
+
diagnostics: workflowDiagnostics(runId, undefined, undefined, "This run's record could not be read."),
|
|
651
|
+
};
|
|
652
|
+
try {
|
|
653
|
+
const failedRun = settledRunOf(handle.done);
|
|
654
|
+
const record = (failedRun !== undefined ? await recordOf(failedRun).catch(() => undefined) : undefined) ?? "This run's record could not be read.";
|
|
655
|
+
const summary = failureSummary(err, runId);
|
|
656
|
+
const settleId = failedRun?.completionId;
|
|
657
|
+
parts = {
|
|
658
|
+
summary,
|
|
659
|
+
diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
|
|
660
|
+
...(settleId !== undefined ? { completionId: settleId } : {}),
|
|
661
|
+
};
|
|
662
|
+
}
|
|
663
|
+
catch {
|
|
664
|
+
}
|
|
662
665
|
fire({
|
|
663
666
|
task_id: runId,
|
|
664
667
|
task_type: "workflow",
|
|
665
668
|
...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}),
|
|
666
669
|
status: "failed",
|
|
667
|
-
|
|
668
|
-
diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
|
|
669
|
-
...(completionIdFromRejection(err) !== undefined ? { completionId: completionIdFromRejection(err) } : {}),
|
|
670
|
+
...parts,
|
|
670
671
|
});
|
|
671
672
|
})
|
|
672
673
|
.catch(() => { });
|
|
@@ -680,20 +681,12 @@ async function mountRunWorkflowTool(d) {
|
|
|
680
681
|
...(persistedScriptPath !== undefined ? { scriptPath: persistedScriptPath } : {}),
|
|
681
682
|
handling: `${launchReceiptNoQuoteClause(" (the ids above, and scriptPath when present)")} ${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE}`,
|
|
682
683
|
note: (() => {
|
|
683
|
-
const pollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}" })` : undefined;
|
|
684
684
|
const journalRef = d.journalStore?.locator?.(runId, taskScope ?? d.scope ?? "");
|
|
685
|
-
const carries =
|
|
686
|
-
? ` A terminal ${pollExpr} reply carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`
|
|
687
|
-
: "";
|
|
685
|
+
const carries = ` The completion notification carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`;
|
|
688
686
|
if (d.notifier) {
|
|
689
|
-
return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll
|
|
690
|
-
}
|
|
691
|
-
if (completionSink) {
|
|
692
|
-
return `The workflow runs asynchronously. Its completion is injected into THIS session if it is still active; if you have ended your turn and hear nothing, ${pollExpr ? `poll ${pollExpr}` : "there is no poll path wired"}.${carries}`;
|
|
687
|
+
return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll.${carries}`;
|
|
693
688
|
}
|
|
694
|
-
return
|
|
695
|
-
? `The workflow runs asynchronously and no completion notifier is wired. Poll ${pollExpr}.${carries}`
|
|
696
|
-
: "The workflow runs asynchronously; no completion notifier is wired and no status/poll path is available.";
|
|
689
|
+
return `The workflow runs asynchronously. Its completion is delivered to this session (its next turn, if this one has ended) — end your turn and wait.${carries}`;
|
|
697
690
|
})(),
|
|
698
691
|
}),
|
|
699
692
|
};
|
|
@@ -365,8 +365,8 @@ export interface WorkflowRun {
|
|
|
365
365
|
* Absent on `completed` runs (their per-agent failures ride `agentFailures` + each `WorkflowAgentRun.errorCode`). */
|
|
366
366
|
errorCode?: string;
|
|
367
367
|
/** The script's RETURN VALUE, bounded + redacted at completion time (same egress
|
|
368
|
-
* discipline as the notifier `result`), so a terminal
|
|
369
|
-
*
|
|
368
|
+
* discipline as the notifier `result`), so a terminal host poll and the completion record carry the
|
|
369
|
+
* result. Absent on failed runs and runs recorded by
|
|
370
370
|
* older engine versions. */
|
|
371
371
|
result?: string;
|
|
372
372
|
/** NH-1: the FULL return value (redacted, capped at {@link WORKFLOW_RESULT_FULL_MAX}), set ONLY
|
|
@@ -348,9 +348,16 @@ export interface RunWorkflowOptions {
|
|
|
348
348
|
* placed at the ladder/gate root. Absent ⇒ nothing extra travels (the rootSessionId chain is the
|
|
349
349
|
* placement root through prepare's mint middle segment). */
|
|
350
350
|
placementRoot?: string;
|
|
351
|
+
/** The host run's own placement target (threaded by the run-workflow tool: what the host leg's env reported as its
|
|
352
|
+
* workspace settled) — every workflow-spawned agent, on either spawn leg, is minted under it as its fence
|
|
353
|
+
* (`RunInternals.placementTarget`). Absent ⇒ the agents carry no fence. */
|
|
354
|
+
placementTarget?: import("../core/remote-env.js").PlacementTarget;
|
|
351
355
|
/** The host run tree's cross-boundary token (`RunInternals.crossBoundaryTree`, threaded by the run-workflow tool): every
|
|
352
356
|
* workflow-spawned agent joins the tree it names, so a bit a workflow agent sets is read by the host and its siblings. */
|
|
353
357
|
crossBoundaryTree?: import("../core/cross-boundary-taint.js").CrossBoundaryTreeToken;
|
|
358
|
+
/** The host run tree's owner seat (`RunInternals.delegationOwner`, threaded by the run-workflow tool): every workflow-spawned agent
|
|
359
|
+
* holds it, so a child it delegates records the host tree's owner. */
|
|
360
|
+
delegationOwner?: import("../core/runner/delegation-owner.js").DelegationOwnerSeat;
|
|
354
361
|
/** design/149 — the PROCESS-level child observer (same seam as
|
|
355
362
|
* {@link import("../core/types.js").RunnerDeps.onBackgroundChildEvent}). When set, every workflow
|
|
356
363
|
* agent emits spawn/tick/terminal {@link import("../core/types.js").BackgroundChildEvent} frames with a
|
|
@@ -15,7 +15,7 @@ import { combinePolicies, createAllowDenyPolicy } from "../core/tool-policy.js";
|
|
|
15
15
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
16
16
|
import { callKeyOrdinal, clampRunIdText, oversizeJournalResult, journalOversizeTombstone, readWorkflowJournalEntry, JOURNAL_OVERSIZE_ERROR_CODE, MAX_JOURNAL_RESULT_BYTES, WorkflowJournalIncompatibleError, } from "../core/workflow-journal-store.js";
|
|
17
17
|
import { isWorkflowRunActive, closeWorkflowChannel, markWorkflowActive, publishWorkflowEvent, registerWorkflowParkDelivery } from "./workflow-observe.js";
|
|
18
|
-
import { isDurablePause } from "../agents/suspend-guard.js";
|
|
18
|
+
import { isDurablePause, resumeNeverStarted } from "../agents/suspend-guard.js";
|
|
19
19
|
import { RUNNING_AGENT_OBSERVE_EVERY_BEATS } from "../config/defaults.js";
|
|
20
20
|
import { boundInputHashOf } from "../core/canonical-json.js";
|
|
21
21
|
import { boundedRedactedSummary, egressThrownText } from "../core/untrusted-egress.js";
|
|
@@ -30,6 +30,7 @@ import { WorkflowBudgetExceededError, WorkflowNestingError, WorkflowAgentBlocked
|
|
|
30
30
|
import { WorkflowScriptError } from "./workflow-meta.js";
|
|
31
31
|
import { firstByteLaneKnobMs, STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS } from "../brain/timeout.js";
|
|
32
32
|
import { asThrownError, isErrorLike, readMember, thrownIs, thrownName, thrownText } from "../core/thrown-value.js";
|
|
33
|
+
import { bindSettledRun } from "../core/workflow-settled-run.js";
|
|
33
34
|
export * from "./workflow-types.js";
|
|
34
35
|
const MAX_TRANSCRIPT_CHARS = 4000;
|
|
35
36
|
const WORKFLOW_RESULT_MAX = 4000;
|
|
@@ -727,6 +728,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
727
728
|
};
|
|
728
729
|
const spawnAttribution = {
|
|
729
730
|
isDelegatedChild: true,
|
|
731
|
+
objectiveAuthor: "workflow",
|
|
730
732
|
...(opts.questionFaceStripped === true ? { questionFaceStripped: true } : {}),
|
|
731
733
|
...(opts.interactionPosture !== undefined ? { parentInteractionPosture: opts.interactionPosture } : {}),
|
|
732
734
|
...(opts.parentToolCallId !== undefined ? { parentToolCallId: opts.parentToolCallId } : {}),
|
|
@@ -738,7 +740,9 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
738
740
|
...(agentCeiling !== undefined ? { toolCeiling: agentCeiling } : {}),
|
|
739
741
|
...((opts.rootSessionId ?? opts.originatingSessionId) !== undefined ? { rootSessionId: opts.rootSessionId ?? opts.originatingSessionId } : {}),
|
|
740
742
|
...(opts.placementRoot !== undefined ? { placementRoot: opts.placementRoot } : {}),
|
|
743
|
+
...(opts.placementTarget !== undefined ? { placementTarget: opts.placementTarget } : {}),
|
|
741
744
|
...(opts.crossBoundaryTree !== undefined ? { crossBoundaryTree: opts.crossBoundaryTree } : {}),
|
|
745
|
+
...(opts.delegationOwner !== undefined ? { delegationOwner: opts.delegationOwner } : {}),
|
|
742
746
|
...(opts.originatingSessionId !== undefined ? { parentSessionId: opts.originatingSessionId } : {}),
|
|
743
747
|
};
|
|
744
748
|
const captureFloorSeatsNow = async () => {
|
|
@@ -1060,7 +1064,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1060
1064
|
return p;
|
|
1061
1065
|
};
|
|
1062
1066
|
const degradedParkMaterial = (cp) => ({
|
|
1063
|
-
taskId: cp.
|
|
1067
|
+
taskId: cp.sourceSessionId ?? "",
|
|
1064
1068
|
sessionId: cp.sessionId,
|
|
1065
1069
|
result: "",
|
|
1066
1070
|
stats: { turns: 0, tokens: 0, costMicroUsd: 0, usageMissing: true },
|
|
@@ -1164,7 +1168,6 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1164
1168
|
throw Object.assign(new Error("agent.checkpointStore is not the store this run's children park in (the workflow's resolved checkpoint seat, RunWorkflowOptions.checkpointStore) — wire the one store, or leave the field unset and let the seat ride."), { code: "config.invalid_checkpoint_store" });
|
|
1165
1169
|
}
|
|
1166
1170
|
};
|
|
1167
|
-
const driveNeverStarted = (r) => r.terminal.kind === "failed" && (r.terminal.code === "resume.reopened_unstarted" || r.terminal.code === "resume.reopen_failed_unstarted");
|
|
1168
1171
|
const isPausedResult = (r) => isDurablePause(r.terminal);
|
|
1169
1172
|
let isolationAdvised = false;
|
|
1170
1173
|
const adviseIsolationIfConcurrent = (opts) => {
|
|
@@ -2151,7 +2154,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2151
2154
|
}
|
|
2152
2155
|
if (finalized)
|
|
2153
2156
|
return result;
|
|
2154
|
-
const unstartedDrive = drive !== undefined &&
|
|
2157
|
+
const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
|
|
2155
2158
|
if (unstartedDrive !== undefined)
|
|
2156
2159
|
emitRunLog(`[park] the parked leg "${label}" was driven but the approved action never started (${result.terminal.kind === "failed" ? result.terminal.code : ""}); the park stands.`);
|
|
2157
2160
|
const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
|
|
@@ -2399,7 +2402,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2399
2402
|
releaseLeg();
|
|
2400
2403
|
if (finalized)
|
|
2401
2404
|
return result;
|
|
2402
|
-
const unstartedDrive = drive !== undefined &&
|
|
2405
|
+
const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
|
|
2403
2406
|
if (unstartedDrive !== undefined)
|
|
2404
2407
|
emitRunLog(`[park] the parked leg "${label}" was driven but the approved action never started (${result.terminal.kind === "failed" ? result.terminal.code : ""}); the park stands.`);
|
|
2405
2408
|
const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
|
|
@@ -2780,13 +2783,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2780
2783
|
run.error = egressThrownText("same-principal", err);
|
|
2781
2784
|
closeAbandonedAgents(run.endedAt);
|
|
2782
2785
|
{
|
|
2783
|
-
|
|
2784
|
-
try {
|
|
2785
|
-
thrownCode = err !== null && (typeof err === "object" || typeof err === "function") ? err.code : undefined;
|
|
2786
|
-
}
|
|
2787
|
-
catch {
|
|
2788
|
-
thrownCode = undefined;
|
|
2789
|
-
}
|
|
2786
|
+
const thrownCode = readMember(err, "code");
|
|
2790
2787
|
const firstFailed = run.agents
|
|
2791
2788
|
.filter((a) => a.status === "failed" && typeof a.errorCode === "string" && a.errorCode !== "")
|
|
2792
2789
|
.sort((a, b) => (a.endedAt ?? Number.POSITIVE_INFINITY) - (b.endedAt ?? Number.POSITIVE_INFINITY))[0];
|
|
@@ -2850,6 +2847,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2850
2847
|
closeWorkflowChannel(runId);
|
|
2851
2848
|
}
|
|
2852
2849
|
})();
|
|
2850
|
+
bindSettledRun(done, run);
|
|
2853
2851
|
return {
|
|
2854
2852
|
runId,
|
|
2855
2853
|
done,
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
|
-
import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION,
|
|
2
|
+
import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, receiveBackgroundAgentReapOptions, queryBackgroundAgents, } from "../../core/background-agent-store.js";
|
|
3
3
|
import { SharedLedgerTable } from "./shared-ledger.js";
|
|
4
4
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
5
5
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
6
|
-
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
6
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
7
|
+
import { readLedgerTuning } from "./ledger-tuning.js";
|
|
8
|
+
const FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0 });
|
|
7
9
|
const isAgentRow = (x) => x !== null && typeof x === "object" && typeof x.handle === "string" && typeof x.scope === "string";
|
|
8
10
|
const agentLedgers = new SharedLedgerTable({
|
|
9
11
|
label: "background-agent ledger",
|
|
@@ -32,10 +34,11 @@ export class FileBackgroundAgentStore {
|
|
|
32
34
|
return this.ledger.rows;
|
|
33
35
|
}
|
|
34
36
|
constructor(root, options) {
|
|
35
|
-
const opts = receiveOptions(options, "FileBackgroundAgentStore");
|
|
37
|
+
const opts = receiveOptions(options, "FileBackgroundAgentStore", FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS);
|
|
36
38
|
assertAdoptionBootGate(root, "FileBackgroundAgentStore");
|
|
37
|
-
|
|
38
|
-
this.
|
|
39
|
+
const tuning = readLedgerTuning(opts, "FileBackgroundAgentStore", "FileBackgroundAgentStore options");
|
|
40
|
+
this.fsyncEnabled = tuning.fsync;
|
|
41
|
+
this.compactEvery = tuning.compactEvery;
|
|
39
42
|
const dir = join(root, "background-agents");
|
|
40
43
|
this.ledger = agentLedgers.acquire({
|
|
41
44
|
dir,
|
|
@@ -128,18 +131,18 @@ export class FileBackgroundAgentStore {
|
|
|
128
131
|
});
|
|
129
132
|
}
|
|
130
133
|
async reap(scope, now, opts) {
|
|
131
|
-
|
|
132
|
-
if (
|
|
134
|
+
const policy = receiveBackgroundAgentReapOptions(opts);
|
|
135
|
+
if (policy.maxAgeMs === undefined && policy.keep === undefined && policy.staleRunningMaxAgeMs === undefined)
|
|
133
136
|
return 0;
|
|
134
137
|
const changed = new Set();
|
|
135
|
-
if (
|
|
138
|
+
if (policy.staleRunningMaxAgeMs !== undefined) {
|
|
136
139
|
const staleCandidates = [...this.rows.entries()]
|
|
137
|
-
.filter(([, r]) => r.scope === scope && r.status === "running" && now - r.updatedAt >
|
|
140
|
+
.filter(([, r]) => r.scope === scope && r.status === "running" && now - r.updatedAt > policy.staleRunningMaxAgeMs)
|
|
138
141
|
.map(([k]) => k);
|
|
139
142
|
for (const k of staleCandidates) {
|
|
140
143
|
const flipped = await this.withLock(k, () => {
|
|
141
144
|
const live = this.rows.get(k);
|
|
142
|
-
if (!live || live.status !== "running" || now - live.updatedAt <=
|
|
145
|
+
if (!live || live.status !== "running" || now - live.updatedAt <= policy.staleRunningMaxAgeMs)
|
|
143
146
|
return false;
|
|
144
147
|
const next = structuredClone(live);
|
|
145
148
|
next.status = "failed";
|
|
@@ -160,14 +163,14 @@ export class FileBackgroundAgentStore {
|
|
|
160
163
|
.filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
|
|
161
164
|
.sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
|
|
162
165
|
const doomed = new Map();
|
|
163
|
-
if (
|
|
166
|
+
if (policy.maxAgeMs !== undefined) {
|
|
164
167
|
for (const [k, r] of terminal) {
|
|
165
|
-
if ((r.settledAt ?? r.spawnedAt) < now -
|
|
168
|
+
if ((r.settledAt ?? r.spawnedAt) < now - policy.maxAgeMs)
|
|
166
169
|
doomed.set(k, { byAge: true });
|
|
167
170
|
}
|
|
168
171
|
}
|
|
169
|
-
if (
|
|
170
|
-
for (const [k] of terminal.slice(Math.max(0,
|
|
172
|
+
if (policy.keep !== undefined) {
|
|
173
|
+
for (const [k] of terminal.slice(Math.max(0, policy.keep))) {
|
|
171
174
|
if (!doomed.has(k))
|
|
172
175
|
doomed.set(k, { byAge: false });
|
|
173
176
|
}
|
|
@@ -177,7 +180,7 @@ export class FileBackgroundAgentStore {
|
|
|
177
180
|
const live = this.rows.get(k);
|
|
178
181
|
if (!live || live.scope !== scope || live.status === "running" || live.status === "parked")
|
|
179
182
|
return false;
|
|
180
|
-
if (why.byAge &&
|
|
183
|
+
if (why.byAge && policy.maxAgeMs !== undefined && (live.settledAt ?? live.spawnedAt) >= now - policy.maxAgeMs)
|
|
181
184
|
return false;
|
|
182
185
|
this.commit({ t: "delete", k });
|
|
183
186
|
return true;
|
|
@@ -174,6 +174,8 @@ export declare class FileCheckpointStore implements CheckpointStore {
|
|
|
174
174
|
private readonly ledger;
|
|
175
175
|
private closed;
|
|
176
176
|
private get cps();
|
|
177
|
+
/** The listing's memo of each replayed row object's verdict: a put or a replay holds a new object, so a replaced row is judged again. */
|
|
178
|
+
private readonly rowVerdicts;
|
|
177
179
|
/** One-shot crash fault (mirrors `InMemoryCheckpointStore.testInjectFault`). */
|
|
178
180
|
private fault;
|
|
179
181
|
/** The guarded {@link FileCheckpointStoreOptions.onCorruptRead} seat (the ledger's replay and this store's projection share it). */
|