@sema-agent/core 7.60.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +49 -18
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +2 -1
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +2 -1
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +10 -10
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
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;
|
|
@@ -200,7 +189,8 @@ export interface RunWorkflowToolDeps {
|
|
|
200
189
|
/** design/115 P2 core slice: run-local task-notification sink for SDK event + live model XML injection.
|
|
201
190
|
* design/373 §3.7: the sink accepts the injection tier — workflow terminals declare `"next"`
|
|
202
191
|
* 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).
|
|
192
|
+
* default is the EXTERNAL lane's `"later"` and no internal lane may lean on it). A call carrying its run's lane
|
|
193
|
+
* delivers there instead; with neither this nor a {@link notifier}, a call is refused before anything starts. */
|
|
204
194
|
taskNotification?: (notification: TaskNotificationPayload, opts?: {
|
|
205
195
|
priority?: "now" | "next" | "later";
|
|
206
196
|
}) => void;
|
|
@@ -268,6 +258,10 @@ export interface RunWorkflowToolDeps {
|
|
|
268
258
|
/** The HOST task's effective working root — threaded into every spawned agent's trusted internals so a
|
|
269
259
|
* TOC env factory can root the child at the parent's cwd (CC parity, 2026-07-03). */
|
|
270
260
|
parentCwd?: string;
|
|
261
|
+
/** The HOST task's own placement target (what its env reported as its workspace settled) — the fence every agent the
|
|
262
|
+
* workflow spawns is minted under (`RunInternals.placementTarget`). Rides deps for the auto-mounted form (whose
|
|
263
|
+
* execute ctx carries none); a rich ctx's own `placementTarget` wins. */
|
|
264
|
+
placementTarget?: import("../core/remote-env.js").PlacementTarget;
|
|
271
265
|
/** Call-time getter for the level a spawned agent runs at when neither the script, the agentType
|
|
272
266
|
* definition nor the governance baseline set `thinking` (the mount folds the deployment's STATED
|
|
273
267
|
* `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";
|
|
@@ -32,6 +33,7 @@ import { workflowSizeGuidelineSection } from "./workflow-size-guideline.js";
|
|
|
32
33
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
33
34
|
import { 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);
|
|
@@ -360,10 +354,9 @@ async function mountRunWorkflowTool(d) {
|
|
|
360
354
|
"role.\n" +
|
|
361
355
|
"\n" +
|
|
362
356
|
"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." +
|
|
357
|
+
"results in any format — not as prose, summary, or structured output. END YOUR TURN and wait — the completion " +
|
|
358
|
+
"notification carries the result and each agent's outcome (the launch note says how it reaches you). If the " +
|
|
359
|
+
"user asks a follow-up before it lands, give status, not a guess." +
|
|
367
360
|
(namedWorkflowSection !== undefined ? `\n\n${namedWorkflowSection}` : "") +
|
|
368
361
|
sizeGuidelineSection,
|
|
369
362
|
parameters: Type.Object({
|
|
@@ -398,6 +391,9 @@ async function mountRunWorkflowTool(d) {
|
|
|
398
391
|
const rawResume = rawArgs.resumeFromRunId;
|
|
399
392
|
const resumeFromRunId = typeof rawResume === "string" && rawResume.length > 0 ? rawResume : undefined;
|
|
400
393
|
const sourceTaskId = ctx.taskId ?? d.sourceTaskId;
|
|
394
|
+
const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
|
|
395
|
+
if (!admitsBackgroundLaunch(completionSink, d.notifier !== undefined))
|
|
396
|
+
return structuredError(WORKFLOW_NO_COMPLETION_CHANNEL);
|
|
401
397
|
const hostSeat = parentSpecSeatOfCtx(ctx) ?? d.parentSpecSeat;
|
|
402
398
|
const detachedSeat = hostSeat !== undefined ? stripSpawnTurnQuestionFace(hostSeat) : undefined;
|
|
403
399
|
const parentSpecSeat = detachedSeat?.spec;
|
|
@@ -519,6 +515,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
519
515
|
...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
|
|
520
516
|
...((ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId } : {}),
|
|
521
517
|
...((ctx.placementRoot ?? d.placementRoot) !== undefined ? { placementRoot: ctx.placementRoot ?? d.placementRoot } : {}),
|
|
518
|
+
...((ctx.placementTarget ?? d.placementTarget) !== undefined ? { placementTarget: ctx.placementTarget ?? d.placementTarget } : {}),
|
|
522
519
|
...((ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree) !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree } : {}),
|
|
523
520
|
...(workflowTaskId !== undefined ? { runId: workflowTaskId } : {}),
|
|
524
521
|
journalStore: d.journalStore,
|
|
@@ -593,19 +590,8 @@ async function mountRunWorkflowTool(d) {
|
|
|
593
590
|
...(taskOwner !== undefined ? { owner: taskOwner } : {}),
|
|
594
591
|
...(taskScope !== undefined ? { scope: taskScope } : {}),
|
|
595
592
|
...(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
593
|
});
|
|
607
594
|
}
|
|
608
|
-
const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
|
|
609
595
|
oweTerminalDelivery(completionSink, { task_id: runId, task_type: "workflow" });
|
|
610
596
|
{
|
|
611
597
|
let notified = false;
|
|
@@ -641,7 +627,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
641
627
|
const recordOf = async (run) => {
|
|
642
628
|
const artifact = await persistTaskArtifact(d.taskArtifacts, runId, formatWorkflowRun(run, WORKFLOW_RECORD_WHOLE).content);
|
|
643
629
|
if (artifact.kind === "stored")
|
|
644
|
-
d.taskRegistry?.recordArtifactRef(runId, artifact.ref,
|
|
630
|
+
d.taskRegistry?.recordArtifactRef(runId, artifact.ref, run.completionId);
|
|
645
631
|
return workflowRecordTeach(run, artifact);
|
|
646
632
|
};
|
|
647
633
|
handle.done
|
|
@@ -656,9 +642,8 @@ async function mountRunWorkflowTool(d) {
|
|
|
656
642
|
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
643
|
completionId: res.run.completionId,
|
|
658
644
|
}), async (err) => {
|
|
659
|
-
const
|
|
660
|
-
const
|
|
661
|
-
const record = failedRun !== undefined ? await recordOf(failedRun).catch(() => "This run's record could not be read.") : "This failure carries no record of the run's agents and no run store holds one.";
|
|
645
|
+
const failedRun = settledRunOf(handle.done);
|
|
646
|
+
const record = (failedRun !== undefined ? await recordOf(failedRun).catch(() => undefined) : undefined) ?? "This run's record could not be read.";
|
|
662
647
|
fire({
|
|
663
648
|
task_id: runId,
|
|
664
649
|
task_type: "workflow",
|
|
@@ -666,7 +651,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
666
651
|
status: "failed",
|
|
667
652
|
summary: failureSummary(err, runId),
|
|
668
653
|
diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
|
|
669
|
-
...(
|
|
654
|
+
...(failedRun?.completionId !== undefined ? { completionId: failedRun.completionId } : {}),
|
|
670
655
|
});
|
|
671
656
|
})
|
|
672
657
|
.catch(() => { });
|
|
@@ -680,20 +665,12 @@ async function mountRunWorkflowTool(d) {
|
|
|
680
665
|
...(persistedScriptPath !== undefined ? { scriptPath: persistedScriptPath } : {}),
|
|
681
666
|
handling: `${launchReceiptNoQuoteClause(" (the ids above, and scriptPath when present)")} ${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE}`,
|
|
682
667
|
note: (() => {
|
|
683
|
-
const pollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}" })` : undefined;
|
|
684
668
|
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
|
-
: "";
|
|
669
|
+
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
670
|
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}`;
|
|
671
|
+
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
672
|
}
|
|
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.";
|
|
673
|
+
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
674
|
})(),
|
|
698
675
|
}),
|
|
699
676
|
};
|
|
@@ -92,7 +92,7 @@ export interface WorkflowAgentSpec extends ScriptClampSeats {
|
|
|
92
92
|
* restricting value, an add-only row through the row's script and entry laws. A row marked inherited-only (its
|
|
93
93
|
* restricting value switches off an operator-side record) is outside this set and is stripped like any other key.
|
|
94
94
|
*/
|
|
95
|
-
export declare const WHITELIST_KEYS: readonly ("thinking" | "
|
|
95
|
+
export declare const WHITELIST_KEYS: readonly ("thinking" | "objective" | "images" | "systemPrompt" | "limits" | ScriptSeat | "modelName")[];
|
|
96
96
|
/**
|
|
97
97
|
* #505 ② — ACCEPTED ALIAS SPELLINGS on the spec: `alias → the {@link WHITELIST_KEYS} member it means`.
|
|
98
98
|
*
|
|
@@ -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,6 +348,10 @@ 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;
|
|
@@ -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,6 +740,7 @@ 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 } : {}),
|
|
742
745
|
...(opts.originatingSessionId !== undefined ? { parentSessionId: opts.originatingSessionId } : {}),
|
|
743
746
|
};
|
|
@@ -1060,7 +1063,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1060
1063
|
return p;
|
|
1061
1064
|
};
|
|
1062
1065
|
const degradedParkMaterial = (cp) => ({
|
|
1063
|
-
taskId: cp.
|
|
1066
|
+
taskId: cp.sourceSessionId ?? "",
|
|
1064
1067
|
sessionId: cp.sessionId,
|
|
1065
1068
|
result: "",
|
|
1066
1069
|
stats: { turns: 0, tokens: 0, costMicroUsd: 0, usageMissing: true },
|
|
@@ -1164,7 +1167,6 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1164
1167
|
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
1168
|
}
|
|
1166
1169
|
};
|
|
1167
|
-
const driveNeverStarted = (r) => r.terminal.kind === "failed" && (r.terminal.code === "resume.reopened_unstarted" || r.terminal.code === "resume.reopen_failed_unstarted");
|
|
1168
1170
|
const isPausedResult = (r) => isDurablePause(r.terminal);
|
|
1169
1171
|
let isolationAdvised = false;
|
|
1170
1172
|
const adviseIsolationIfConcurrent = (opts) => {
|
|
@@ -2151,7 +2153,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2151
2153
|
}
|
|
2152
2154
|
if (finalized)
|
|
2153
2155
|
return result;
|
|
2154
|
-
const unstartedDrive = drive !== undefined &&
|
|
2156
|
+
const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
|
|
2155
2157
|
if (unstartedDrive !== undefined)
|
|
2156
2158
|
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
2159
|
const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
|
|
@@ -2399,7 +2401,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2399
2401
|
releaseLeg();
|
|
2400
2402
|
if (finalized)
|
|
2401
2403
|
return result;
|
|
2402
|
-
const unstartedDrive = drive !== undefined &&
|
|
2404
|
+
const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
|
|
2403
2405
|
if (unstartedDrive !== undefined)
|
|
2404
2406
|
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
2407
|
const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
|
|
@@ -2850,6 +2852,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2850
2852
|
closeWorkflowChannel(runId);
|
|
2851
2853
|
}
|
|
2852
2854
|
})();
|
|
2855
|
+
bindSettledRun(done, run);
|
|
2853
2856
|
return {
|
|
2854
2857
|
runId,
|
|
2855
2858
|
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;
|
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
2
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
3
|
-
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
3
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
4
|
+
import { readLedgerTuning } from "./ledger-tuning.js";
|
|
4
5
|
import { checkpointExecutionRecorded, executionRecordDisposition, ExecutionOutcomeConflictError, } from "../../core/checkpoint-execution-record.js";
|
|
5
6
|
import { checkpointHolderMatches, checkpointOccMatches, checkpointRevOf } from "../../core/checkpoint-generation.js";
|
|
6
7
|
import { appendPendingSteer, CheckpointError, checkpointRowMatches, encodeAtFidelity, summarizeCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
|
|
7
8
|
import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
|
|
8
9
|
import { readLedgerSettled, SharedLedgerTable } from "./shared-ledger.js";
|
|
9
10
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
11
|
+
const FILE_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0, sessionHeadOf: 0, holderIsCurrent: 0 });
|
|
10
12
|
export const CHECKPOINT_LEDGER_EVENT_KINDS = Object.freeze(["put", "resolve", "reopen", "execution", "expire", "delete", "steer_append"]);
|
|
11
13
|
const KNOWN_CHECKPOINT_LEDGER_EVENTS = new Set(CHECKPOINT_LEDGER_EVENT_KINDS);
|
|
12
14
|
function applyCheckpointEvent(cps, ev) {
|
|
@@ -105,13 +107,14 @@ export class FileCheckpointStore {
|
|
|
105
107
|
discloseCorrupt;
|
|
106
108
|
ledgerPath;
|
|
107
109
|
constructor(root, options) {
|
|
108
|
-
const opts = receiveOptions(options, "FileCheckpointStore");
|
|
110
|
+
const opts = receiveOptions(options, "FileCheckpointStore", FILE_CHECKPOINT_STORE_OPTION_KEYS);
|
|
109
111
|
assertAdoptionBootGate(root, "FileCheckpointStore");
|
|
110
|
-
|
|
112
|
+
const tuning = readLedgerTuning(opts, "FileCheckpointStore", "FileCheckpointStore options");
|
|
113
|
+
this.fsyncEnabled = tuning.fsync;
|
|
111
114
|
this.holderIsCurrent = opts.holderIsCurrent;
|
|
112
115
|
if (opts.holderIsCurrent !== undefined)
|
|
113
116
|
this.fence = Object.freeze({ holder: true });
|
|
114
|
-
this.compactEvery =
|
|
117
|
+
this.compactEvery = tuning.compactEvery;
|
|
115
118
|
this.discloseCorrupt = guardCorruptSink(opts.onCorruptRead);
|
|
116
119
|
const dir = join(root, "checkpoints");
|
|
117
120
|
this.ledgerPath = join(dir, "checkpoints.jsonl");
|
|
@@ -8,7 +8,8 @@ import { atomicWriteFile, ensureDir, sanitizePathComponent, sanitizeScope, write
|
|
|
8
8
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
9
9
|
import { isAbsoluteForFamily } from "../../tools/fs/safety.js";
|
|
10
10
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
11
|
-
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
11
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
12
|
+
const FILE_FILE_HISTORY_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, retention: 0 });
|
|
12
13
|
function trackedDigest(rows) {
|
|
13
14
|
const canonical = [...rows]
|
|
14
15
|
.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
|
|
@@ -157,7 +158,7 @@ export class FileFileHistoryStore {
|
|
|
157
158
|
return this.lastCommittedAt;
|
|
158
159
|
}
|
|
159
160
|
constructor(root, options) {
|
|
160
|
-
const opts = receiveOptions(options, "FileFileHistoryStore");
|
|
161
|
+
const opts = receiveOptions(options, "FileFileHistoryStore", FILE_FILE_HISTORY_STORE_OPTION_KEYS);
|
|
161
162
|
assertAdoptionBootGate(root, "FileFileHistoryStore");
|
|
162
163
|
this.boundaryKeep = resolveFileHistoryRetention("FileFileHistoryStore", opts?.retention);
|
|
163
164
|
this.base = join(root, "file-history");
|
|
@@ -11,7 +11,7 @@ import type { FileHistoryStore } from "../../core/file-history-store.js";
|
|
|
11
11
|
import type { BackgroundAgentStore } from "../../core/background-agent-store.js";
|
|
12
12
|
import type { MailboxStore } from "../../core/mailbox-store.js";
|
|
13
13
|
import type { RosterStore } from "../../agents/roster-store.js";
|
|
14
|
-
import type
|
|
14
|
+
import { type SessionPolicyStore } from "../../core/session-policy-store.js";
|
|
15
15
|
import type { WorkflowJournalStore } from "../../core/workflow-journal-store.js";
|
|
16
16
|
import type { UsageWindowStore } from "../../core/usage-window-store.js";
|
|
17
17
|
import type { EngineStorageBackend } from "../../core/engine-storage-backend.js";
|
|
@@ -67,8 +67,10 @@ export interface FileStorageBackendOptions {
|
|
|
67
67
|
/** `TtlSessionStore` idle-eviction policy. Default `"forget"` (§7 decision 5 — durable history is never
|
|
68
68
|
* deleted by an idle timer). */
|
|
69
69
|
evict?: EvictPolicy;
|
|
70
|
-
/** Checkpoint store tuning (fsync cadence for `put`/`setPendingSteer`, ledger compaction threshold).
|
|
71
|
-
|
|
70
|
+
/** Checkpoint store tuning (fsync cadence for `put`/`setPendingSteer`, ledger compaction threshold, the holder judge). The
|
|
71
|
+
* corrupt-read sink and the session head read are the backend's own — the sink is {@link FileStorageBackendOptions.onCorruptRead}
|
|
72
|
+
* (one failure grammar, one sink) and the head read is its session store's — so neither is accepted here. */
|
|
73
|
+
checkpoint?: Omit<FileCheckpointStoreOptions, "onCorruptRead" | "sessionHeadOf">;
|
|
72
74
|
/**
|
|
73
75
|
* design/381 §片2 — file-history tuning, today just the boundary RETENTION bound (omitted ⇒ the
|
|
74
76
|
* engine default; `{ retention: { keep: "unbounded" } }` hands the GC schedule to the deployment).
|