@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
|
@@ -105,6 +105,17 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
105
105
|
* even with a damaged owner record, so removing one on a guess would destroy another session's output.
|
|
106
106
|
*/
|
|
107
107
|
deleteBySession(sessionId: string): ToolResultDeletionReport;
|
|
108
|
+
/**
|
|
109
|
+
* Age out the entries stored more than `maxAgeMs` before `now` (interface: {@link ToolResultStore.reap}). An entry's
|
|
110
|
+
* age is its content file's modification time: the write-once publication sets it and nothing rewrites the file.
|
|
111
|
+
* Both namespaces are swept, and only names this store writes are judged. Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
|
|
112
|
+
* record whose content is already gone — the leftover of an interrupted pass, or of a session sweep — is removed
|
|
113
|
+
* once it is past the cutoff too, and is not counted (it was not an entry). Synchronous: under the data root's single
|
|
114
|
+
* writer nothing interleaves with it.
|
|
115
|
+
*/
|
|
116
|
+
reap(now: number, opts?: {
|
|
117
|
+
maxAgeMs?: number;
|
|
118
|
+
}): number;
|
|
108
119
|
/**
|
|
109
120
|
* The entries `sessionId` owns, as ref + recorded owner (interface: {@link ToolResultStore.listBySession}). The selection is
|
|
110
121
|
* {@link deleteBySession}'s own: it walks the same two namespaces and matches on the SIDECAR's `sessionId`, never on a file name; a
|
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import { readFileSync, readdirSync, unlinkSync } from "node:fs";
|
|
2
|
+
import { readFileSync, readdirSync, statSync, unlinkSync } from "node:fs";
|
|
3
3
|
import { join } from "node:path";
|
|
4
|
+
import { ageCutoff } from "../../core/retention-policy.js";
|
|
4
5
|
import { assertSafeToolResultRef, assertToolResultProvenanceMatch, normalizeToolResultProvenance, ToolResultRefConflictError, } from "../../core/tool-result-store.js";
|
|
5
6
|
import { ensureDir, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
|
|
6
7
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
7
8
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
8
|
-
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
9
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
10
|
+
const FILE_TOOL_RESULT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
9
11
|
export class FileToolResultStore {
|
|
10
12
|
dir;
|
|
11
13
|
discloseCorrupt;
|
|
12
14
|
constructor(root, options) {
|
|
13
|
-
const opts = receiveOptions(options, "FileToolResultStore");
|
|
15
|
+
const opts = receiveOptions(options, "FileToolResultStore", FILE_TOOL_RESULT_STORE_OPTION_KEYS);
|
|
14
16
|
assertAdoptionBootGate(root, "FileToolResultStore");
|
|
15
17
|
this.dir = join(root, "tool-results");
|
|
16
18
|
this.discloseCorrupt = guardCorruptSink(opts?.onCorruptRead);
|
|
@@ -181,6 +183,44 @@ export class FileToolResultStore {
|
|
|
181
183
|
}
|
|
182
184
|
return { deleted, unattributable };
|
|
183
185
|
}
|
|
186
|
+
reap(now, opts) {
|
|
187
|
+
const cutoff = ageCutoff("FileToolResultStore.reap", now, opts);
|
|
188
|
+
if (cutoff === undefined)
|
|
189
|
+
return 0;
|
|
190
|
+
let removed = 0;
|
|
191
|
+
for (const [dir, folded] of [[this.dir, false], [join(this.dir, FOLDED_SUBDIR), true]]) {
|
|
192
|
+
let names;
|
|
193
|
+
try {
|
|
194
|
+
names = readdirSync(dir);
|
|
195
|
+
}
|
|
196
|
+
catch (err) {
|
|
197
|
+
if (err.code === "ENOENT")
|
|
198
|
+
continue;
|
|
199
|
+
throw err;
|
|
200
|
+
}
|
|
201
|
+
const listed = new Set(names);
|
|
202
|
+
for (const name of names) {
|
|
203
|
+
const content = name.endsWith(CONTENT_SUFFIX);
|
|
204
|
+
if (!content && !name.endsWith(OWNER_SUFFIX))
|
|
205
|
+
continue;
|
|
206
|
+
const stem = name.slice(0, -(content ? CONTENT_SUFFIX : OWNER_SUFFIX).length);
|
|
207
|
+
if (!isEncodedStem(stem, folded))
|
|
208
|
+
continue;
|
|
209
|
+
if (!content && listed.has(`${stem}${CONTENT_SUFFIX}`))
|
|
210
|
+
continue;
|
|
211
|
+
const path = join(dir, name);
|
|
212
|
+
const modified = modifiedAt(path);
|
|
213
|
+
if (modified === undefined || modified >= cutoff)
|
|
214
|
+
continue;
|
|
215
|
+
unlinkIfAbsentOk(path);
|
|
216
|
+
if (content) {
|
|
217
|
+
unlinkIfAbsentOk(join(dir, `${stem}${OWNER_SUFFIX}`));
|
|
218
|
+
removed++;
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
return removed;
|
|
223
|
+
}
|
|
184
224
|
listBySession(sessionId) {
|
|
185
225
|
const entries = [];
|
|
186
226
|
let unattributable = 0;
|
|
@@ -277,6 +317,16 @@ function readOwnerAt(path) {
|
|
|
277
317
|
const read = readOwnerFileAt(path);
|
|
278
318
|
return typeof read === "string" ? read : read.provenance;
|
|
279
319
|
}
|
|
320
|
+
function modifiedAt(path) {
|
|
321
|
+
try {
|
|
322
|
+
return statSync(path).mtimeMs;
|
|
323
|
+
}
|
|
324
|
+
catch (err) {
|
|
325
|
+
if (err.code === "ENOENT")
|
|
326
|
+
return undefined;
|
|
327
|
+
throw err;
|
|
328
|
+
}
|
|
329
|
+
}
|
|
280
330
|
function unlinkIfAbsentOk(path) {
|
|
281
331
|
try {
|
|
282
332
|
unlinkSync(path);
|
|
@@ -295,6 +345,10 @@ function encodeRefFilename(ref) {
|
|
|
295
345
|
const base = ref.replace(/[^A-Za-z0-9_.-]/g, "-").slice(0, 64);
|
|
296
346
|
return { folded: true, stem: `${base || "ref"}-${createHash("sha256").update(Buffer.from(ref, "utf16le")).digest("hex")}` };
|
|
297
347
|
}
|
|
348
|
+
const FOLDED_STEM = /^[A-Za-z0-9_.-]{1,64}-[0-9a-f]{64}$/;
|
|
349
|
+
function isEncodedStem(stem, folded) {
|
|
350
|
+
return folded ? FOLDED_STEM.test(stem) : stem.length <= MAX_FILENAME_CHARS && NATIVE_FILENAME_CHARSET.test(stem);
|
|
351
|
+
}
|
|
298
352
|
function intOr(x, fallback) {
|
|
299
353
|
return Number.isFinite(x) ? Math.floor(x) : fallback;
|
|
300
354
|
}
|
|
@@ -3,13 +3,14 @@ import { join } from "node:path";
|
|
|
3
3
|
import { chargeUsageRecord, readUsageRecord, EMPTY_USAGE_WINDOW_RECORD, } from "../../core/usage-window-store.js";
|
|
4
4
|
import { atomicWriteFile, ensureDir, sanitizeScope } from "./fs-atomic.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
7
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
8
|
+
const FILE_USAGE_WINDOW_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
8
9
|
export class FileUsageWindowStore {
|
|
9
10
|
dir;
|
|
10
11
|
onCorruptRead;
|
|
11
12
|
constructor(root, options) {
|
|
12
|
-
const opts = receiveOptions(options, "FileUsageWindowStore");
|
|
13
|
+
const opts = receiveOptions(options, "FileUsageWindowStore", FILE_USAGE_WINDOW_STORE_OPTION_KEYS);
|
|
13
14
|
assertAdoptionBootGate(root, "FileUsageWindowStore");
|
|
14
15
|
this.dir = join(root, "usage-windows");
|
|
15
16
|
ensureDir(this.dir);
|
|
@@ -126,8 +126,6 @@ export declare class FileWorkflowJournalStore implements WorkflowJournalStore {
|
|
|
126
126
|
/** RB-242 — release ONLY a claim this `newRunId` still holds. A claim that is already gone (TTL-reaped
|
|
127
127
|
* and possibly taken over) is a no-op: unlinking a successor's claim would re-open the very fork this prevents. */
|
|
128
128
|
releaseResumeClaim(input: ResumeClaimArgs): Promise<void>;
|
|
129
|
-
/** GC (service extra, mirrors the SQL twins): drop the run's ledger once the run is terminal + retained. */
|
|
130
|
-
deleteByRun(runId: string): Promise<number>;
|
|
131
129
|
/** Release ledger fds (graceful shutdown; parity with the other file stores' dispose).
|
|
132
130
|
* Refcounted: the fds are shared with any other instance on the same directory, so the LAST holder
|
|
133
131
|
* closes them. Idempotent — a second dispose() on the same instance must not decrement twice and pull
|
|
@@ -6,7 +6,7 @@ import { AppendLog, readJsonlRecords } from "./fs-atomic.js";
|
|
|
6
6
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
7
7
|
import { canonicalStoreKey, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
|
|
8
8
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
9
|
-
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
9
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
10
10
|
import { assertJournalEntryFits } from "../../core/workflow-journal-store.js";
|
|
11
11
|
export const RESUME_CLAIM_TTL_MS = 60 * 60 * 1000;
|
|
12
12
|
export const RESUME_CLAIM_RELEASE_GRACE_MS = 5_000;
|
|
@@ -18,6 +18,7 @@ function isJournalLine(r) {
|
|
|
18
18
|
const rec = r;
|
|
19
19
|
return typeof rec.scope === "string" && Number.isFinite(rec.ordinal);
|
|
20
20
|
}
|
|
21
|
+
const FILE_WORKFLOW_JOURNAL_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
21
22
|
export class FileWorkflowJournalStore {
|
|
22
23
|
fsyncEnabled;
|
|
23
24
|
dir;
|
|
@@ -35,7 +36,7 @@ export class FileWorkflowJournalStore {
|
|
|
35
36
|
discloseCorrupt;
|
|
36
37
|
constructor(root, fsyncEnabled = true, options) {
|
|
37
38
|
this.fsyncEnabled = fsyncEnabled;
|
|
38
|
-
const opts = receiveOptions(options, "FileWorkflowJournalStore");
|
|
39
|
+
const opts = receiveOptions(options, "FileWorkflowJournalStore", FILE_WORKFLOW_JOURNAL_STORE_OPTION_KEYS);
|
|
39
40
|
this.discloseCorrupt = guardCorruptSink(opts?.onCorruptRead);
|
|
40
41
|
assertAdoptionBootGate(root, "FileWorkflowJournalStore");
|
|
41
42
|
this.dir = join(root, "workflow-journal");
|
|
@@ -259,22 +260,6 @@ export class FileWorkflowJournalStore {
|
|
|
259
260
|
return;
|
|
260
261
|
this.unlinkIfUnchanged(path, existing.raw);
|
|
261
262
|
}
|
|
262
|
-
async deleteByRun(runId) {
|
|
263
|
-
const log = this.logs.get(runId);
|
|
264
|
-
if (log !== undefined) {
|
|
265
|
-
try {
|
|
266
|
-
log.close();
|
|
267
|
-
}
|
|
268
|
-
catch { }
|
|
269
|
-
this.logs.delete(runId);
|
|
270
|
-
}
|
|
271
|
-
this.scopes.delete(runId);
|
|
272
|
-
const path = this.pathFor(runId);
|
|
273
|
-
if (!existsSync(path))
|
|
274
|
-
return 0;
|
|
275
|
-
unlinkSync(path);
|
|
276
|
-
return 1;
|
|
277
|
-
}
|
|
278
263
|
dispose() {
|
|
279
264
|
if (this.closed)
|
|
280
265
|
return;
|
|
@@ -17,7 +17,7 @@ export declare class FileWorkflowRunStore implements WorkflowRunStore {
|
|
|
17
17
|
/** RB-145: this instance's own close latch — the refcount belongs to the DIRECTORY, not to callers. */
|
|
18
18
|
private closed;
|
|
19
19
|
private get runs();
|
|
20
|
-
constructor(root: string,
|
|
20
|
+
constructor(root: string, options?: FileWorkflowRunStoreOptions);
|
|
21
21
|
/** Serialize an op behind any in-flight op on the same id (the in-process per-id async mutex). */
|
|
22
22
|
private withLock;
|
|
23
23
|
/** Commit one ledger event (append + fsync) THEN flip the in-memory map (crash-safe ordering), then
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
|
-
import {
|
|
3
|
-
import { WorkflowRunStoreError, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, } from "../../core/workflow-run-store.js";
|
|
2
|
+
import { receiveRetentionPolicy } from "../../core/retention-policy.js";
|
|
3
|
+
import { WorkflowRunStoreError, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, WORKFLOW_RUN_REAP_KNOBS, } from "../../core/workflow-run-store.js";
|
|
4
4
|
import { SharedLedgerTable } from "./shared-ledger.js";
|
|
5
5
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
6
6
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
7
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
8
|
+
import { readLedgerTuning } from "./ledger-tuning.js";
|
|
9
|
+
const FILE_WORKFLOW_RUN_STORE_OPTION_KEYS = optionKeys()({ fsync: 0, compactEvery: 0, onCorruptRead: 0 });
|
|
7
10
|
const isRunRow = (x) => x !== null && typeof x === "object" && typeof x.id === "string";
|
|
8
11
|
const runLedgers = new SharedLedgerTable({
|
|
9
12
|
label: "workflow-run ledger",
|
|
@@ -31,10 +34,12 @@ export class FileWorkflowRunStore {
|
|
|
31
34
|
get runs() {
|
|
32
35
|
return this.ledger.rows;
|
|
33
36
|
}
|
|
34
|
-
constructor(root,
|
|
37
|
+
constructor(root, options) {
|
|
38
|
+
const opts = receiveOptions(options, "FileWorkflowRunStore", FILE_WORKFLOW_RUN_STORE_OPTION_KEYS);
|
|
35
39
|
assertAdoptionBootGate(root, "FileWorkflowRunStore");
|
|
36
|
-
|
|
37
|
-
this.
|
|
40
|
+
const tuning = readLedgerTuning(opts, "FileWorkflowRunStore", "FileWorkflowRunStore options");
|
|
41
|
+
this.fsyncEnabled = tuning.fsync;
|
|
42
|
+
this.compactEvery = tuning.compactEvery;
|
|
38
43
|
const dir = join(root, "workflow-runs");
|
|
39
44
|
this.ledger = runLedgers.acquire({
|
|
40
45
|
dir,
|
|
@@ -78,16 +83,16 @@ export class FileWorkflowRunStore {
|
|
|
78
83
|
return queryWorkflowRuns(this.runs.values(), scope, opts);
|
|
79
84
|
}
|
|
80
85
|
async reap(scope, now, opts) {
|
|
81
|
-
|
|
82
|
-
if (
|
|
86
|
+
const policy = receiveRetentionPolicy("WorkflowRunStore.reap", opts, WORKFLOW_RUN_REAP_KNOBS);
|
|
87
|
+
if (policy.maxAgeMs === undefined && policy.keep === undefined)
|
|
83
88
|
return 0;
|
|
84
89
|
const terminal = [...this.runs.values()].filter((r) => r.scope === scope && isTerminalWorkflowStatus(r.status));
|
|
85
90
|
terminal.sort((a, b) => b.createdAt - a.createdAt);
|
|
86
91
|
const doomed = [];
|
|
87
92
|
for (let i = 0; i < terminal.length; i++) {
|
|
88
93
|
const r = terminal[i];
|
|
89
|
-
const tooOld =
|
|
90
|
-
const overKeep =
|
|
94
|
+
const tooOld = policy.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - policy.maxAgeMs;
|
|
95
|
+
const overKeep = policy.keep !== undefined && i >= policy.keep;
|
|
91
96
|
if (tooOld || overKeep)
|
|
92
97
|
doomed.push({ id: r.id, byAge: tooOld });
|
|
93
98
|
}
|
|
@@ -97,7 +102,7 @@ export class FileWorkflowRunStore {
|
|
|
97
102
|
const live = this.runs.get(id);
|
|
98
103
|
if (!live || live.scope !== scope || !isTerminalWorkflowStatus(live.status))
|
|
99
104
|
return false;
|
|
100
|
-
if (byAge &&
|
|
105
|
+
if (byAge && policy.maxAgeMs !== undefined && (live.endedAt ?? live.createdAt) >= now - policy.maxAgeMs) {
|
|
101
106
|
return false;
|
|
102
107
|
}
|
|
103
108
|
this.commit({ t: "delete", id }, this.fsyncEnabled);
|
|
@@ -11,11 +11,11 @@ import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
|
11
11
|
* is lstat-semantics, so a symlink is judged by FOLLOWING it (`canonicalPath`, then one probe of the
|
|
12
12
|
* target — a link retargeted at a file resolves perfectly well and is still not a cwd).
|
|
13
13
|
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
14
|
+
* One reading at every step (the initial lstat, the link's resolution, the target's own): an error means
|
|
15
|
+
* death only when it SAYS so — refusing a command, or resetting somebody's working directory, over one
|
|
16
|
+
* flaky or unclassified answer would be worse than the failure being diagnosed. A link chain that loops
|
|
17
|
+
* says so (`symlink_loop`), and so does a dangling one (`not_found`); a probe that answered `unknown`
|
|
18
|
+
* leaves the spawn to run and report its own error.
|
|
19
19
|
*/
|
|
20
20
|
export declare function isDeadCwd(env: ExecutionEnv, dir: string, signal?: AbortSignal): Promise<boolean>;
|
|
21
21
|
/**
|
|
@@ -1,27 +1,20 @@
|
|
|
1
1
|
function errorMeansDead(code) {
|
|
2
|
-
return code === "not_found" || code === "not_directory";
|
|
3
|
-
}
|
|
4
|
-
function resolutionFailureMeansDead(code) {
|
|
5
|
-
return errorMeansDead(code) || code === "unknown";
|
|
2
|
+
return code === "not_found" || code === "not_directory" || code === "symlink_loop";
|
|
6
3
|
}
|
|
7
4
|
function cancelled(signal) {
|
|
8
5
|
return signal?.aborted === true;
|
|
9
6
|
}
|
|
10
7
|
export async function isDeadCwd(env, dir, signal) {
|
|
11
8
|
const info = await env.fileInfo(dir, signal);
|
|
12
|
-
if (!info.ok)
|
|
13
|
-
|
|
14
|
-
return errorMeansDead(info.error.code);
|
|
15
|
-
const resolved = await env.canonicalPath(dir, signal);
|
|
16
|
-
return !resolved.ok && resolutionFailureMeansDead(resolved.error.code);
|
|
17
|
-
}
|
|
9
|
+
if (!info.ok)
|
|
10
|
+
return errorMeansDead(info.error.code);
|
|
18
11
|
if (info.value.kind === "directory")
|
|
19
12
|
return false;
|
|
20
13
|
if (info.value.kind !== "symlink")
|
|
21
14
|
return true;
|
|
22
15
|
const target = await env.canonicalPath(dir, signal);
|
|
23
16
|
if (!target.ok)
|
|
24
|
-
return
|
|
17
|
+
return errorMeansDead(target.error.code);
|
|
25
18
|
const followed = await env.fileInfo(target.value, signal);
|
|
26
19
|
if (!followed.ok)
|
|
27
20
|
return errorMeansDead(followed.error.code);
|
|
@@ -20,4 +20,10 @@ export declare function backgroundLifetimeNote(retained: boolean, sessionScoped:
|
|
|
20
20
|
* process's, which may never end (a server, `tail -f`), so it is not waited for and its completion may never be heard.
|
|
21
21
|
* ONE construction point for both background legs (run_in_background and an adopted command).
|
|
22
22
|
*/
|
|
23
|
+
export declare const BASH_BACKGROUND_UNAVAILABLE = "Error (Bash): run_in_background is not available here \u2014 this environment cannot run background processes, or no completion would come back from one on this mount. Run the command in the foreground (with a timeout).";
|
|
24
|
+
/**
|
|
25
|
+
* The output-file sentence a background command's receipt carries — ONE construction point for both background legs.
|
|
26
|
+
* The file is the full record; without one (it could not be created) the completion notification says what was retained.
|
|
27
|
+
*/
|
|
28
|
+
export declare function backgroundOutputFileNote(outputFile: string | undefined): string;
|
|
23
29
|
export declare const ONE_SHOT_BACKGROUND_COMMAND_NOTE = "This is a one-shot submission \u2014 the engine does not wait for background commands; run it in the foreground (with a timeout) if you need its output before the submission ends.";
|
|
@@ -20,4 +20,10 @@ export function backgroundLifetimeNote(retained, sessionScoped, envIsolatedOwned
|
|
|
20
20
|
return ` Background processes do NOT survive the session — they are reaped ${bgReapClause(sessionScoped, envIsolatedOwned)}. A deliverable that must stay alive afterwards (a server, a daemon) needs a self-detaching FOREGROUND start instead: run \`nohup cmd >log 2>&1 &\` as a normal foreground command (portable; setsid does not exist on macOS), or use a service manager${bgNohupCaveat(envIsolatedOwned)}.`;
|
|
21
21
|
return ` NOTE: background processes do NOT survive the session (reaped ${bgReapClause(sessionScoped, envIsolatedOwned)}). If this is a deliverable service that must stay alive afterwards, host it with a FOREGROUND command instead: \`nohup cmd >log 2>&1 &\` (self-detaching — survives the session)${bgNohupCaveat(envIsolatedOwned)}.`;
|
|
22
22
|
}
|
|
23
|
+
export const BASH_BACKGROUND_UNAVAILABLE = "Error (Bash): run_in_background is not available here — this environment cannot run background processes, or no completion would come back from one on this mount. Run the command in the foreground (with a timeout).";
|
|
24
|
+
export function backgroundOutputFileNote(outputFile) {
|
|
25
|
+
return outputFile !== undefined
|
|
26
|
+
? ` Output file: ${outputFile} (full output is appended there — Read it any time).`
|
|
27
|
+
: " No output file could be created for it — its completion notification says whether any of its output was kept and how to read it.";
|
|
28
|
+
}
|
|
23
29
|
export const ONE_SHOT_BACKGROUND_COMMAND_NOTE = "This is a one-shot submission — the engine does not wait for background commands; run it in the foreground (with a timeout) if you need its output before the submission ends.";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { type AgentTool, type ExecutionEnv } from "../../internal/harness.js";
|
|
2
|
-
import {
|
|
2
|
+
import type { TaskRegistry } from "../../core/task-registry.js";
|
|
3
3
|
import { type ImageDownsampler } from "../../core/image-downsample.js";
|
|
4
4
|
import { type CwdRef } from "./fs-shared.js";
|
|
5
5
|
import type { ReversibilityVerdict } from "../../core/types.js";
|
|
@@ -72,7 +72,8 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
72
72
|
* run-scoped registration exactly as before (killed-with-receipt at teardown). */
|
|
73
73
|
sessionId?: string;
|
|
74
74
|
/** Completion-notification sink — a finished background command fires ONE
|
|
75
|
-
* task-notification (priority "next": boundary interrupt, CC LocalShellTask posture).
|
|
75
|
+
* task-notification (priority "next": boundary interrupt, CC LocalShellTask posture). A call carrying its run's
|
|
76
|
+
* lane delivers there instead; with neither, a background request is refused before anything is spawned. */
|
|
76
77
|
onTaskNotification?: (n: import("../../core/task-notification.js").TaskNotificationPayload, opts?: {
|
|
77
78
|
priority?: "now" | "next" | "later";
|
|
78
79
|
}) => void;
|
|
@@ -217,19 +218,3 @@ export declare function createBashReadonlyTool(env: ExecutionEnv, rootCanonical:
|
|
|
217
218
|
* chain, so it ticks and never auto-backgrounds. Absent ⇒ no streaming callbacks, byte-unchanged. */
|
|
218
219
|
onToolProgress?: (body: import("../../core/runner/contracts.js").ToolProgressBody) => void;
|
|
219
220
|
}): AgentTool;
|
|
220
|
-
/**
|
|
221
|
-
* `TaskOutput` — read a background shell's NEW output
|
|
222
|
-
* since the last call (cursor), by task_id. Optional legacy `filter` regex is applied BEFORE the per-poll truncation so a watched line survives even when it
|
|
223
|
-
* falls in a high-throughput middle window. Untrusted process output is fenced (delimitUntrusted) — observe-only,
|
|
224
|
-
* never re-fed as instructions.
|
|
225
|
-
*/
|
|
226
|
-
export declare function createEnvTaskOutputTool(env: ExecutionEnv): AgentTool;
|
|
227
|
-
/** `TaskStop` — terminate a background shell by task_id.
|
|
228
|
-
*
|
|
229
|
-
* This band kills ENV-DIRECT (it mounts precisely when the toolkit has
|
|
230
|
-
* no registry — the createHandsToolkit ternary routes registry deployments to createTaskStopTool), so a
|
|
231
|
-
* row for the SAME shell in the process-local {@link defaultTaskRegistry} (a Runner-mounted run sharing
|
|
232
|
-
* this env) used to settle via the watcher's no-claimant floor as stoppedBy:"system". The tool now marks
|
|
233
|
-
* the initiation site ("parent") on `registry` (default: the process-local {@link defaultTaskRegistry})
|
|
234
|
-
* BEFORE the kill — attribution only; the kill path and the model-facing receipt text are unchanged. */
|
|
235
|
-
export declare function createEnvTaskStopTool(env: ExecutionEnv, registry?: TaskRegistry): AgentTool;
|