@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,14 +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";
|
|
9
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
10
|
+
const FILE_TOOL_RESULT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
8
11
|
export class FileToolResultStore {
|
|
9
12
|
dir;
|
|
10
13
|
discloseCorrupt;
|
|
11
|
-
constructor(root,
|
|
14
|
+
constructor(root, options) {
|
|
15
|
+
const opts = receiveOptions(options, "FileToolResultStore", FILE_TOOL_RESULT_STORE_OPTION_KEYS);
|
|
12
16
|
assertAdoptionBootGate(root, "FileToolResultStore");
|
|
13
17
|
this.dir = join(root, "tool-results");
|
|
14
18
|
this.discloseCorrupt = guardCorruptSink(opts?.onCorruptRead);
|
|
@@ -98,7 +102,7 @@ export class FileToolResultStore {
|
|
|
98
102
|
}
|
|
99
103
|
writeOwnerFile(ref, provenance) {
|
|
100
104
|
try {
|
|
101
|
-
writeThenLink(this.ownerPathFor(ref), JSON.stringify(normalizeToolResultProvenance(provenance)));
|
|
105
|
+
writeThenLink(this.ownerPathFor(ref), JSON.stringify({ ...normalizeToolResultProvenance(provenance), ref }));
|
|
102
106
|
}
|
|
103
107
|
catch (err) {
|
|
104
108
|
if (err.code !== "EEXIST")
|
|
@@ -179,10 +183,109 @@ export class FileToolResultStore {
|
|
|
179
183
|
}
|
|
180
184
|
return { deleted, unattributable };
|
|
181
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
|
+
}
|
|
224
|
+
listBySession(sessionId) {
|
|
225
|
+
const entries = [];
|
|
226
|
+
let unattributable = 0;
|
|
227
|
+
let unaddressable = 0;
|
|
228
|
+
for (const dir of [this.dir, join(this.dir, FOLDED_SUBDIR)]) {
|
|
229
|
+
let names;
|
|
230
|
+
try {
|
|
231
|
+
names = readdirSync(dir);
|
|
232
|
+
}
|
|
233
|
+
catch (err) {
|
|
234
|
+
if (err.code === "ENOENT")
|
|
235
|
+
continue;
|
|
236
|
+
throw err;
|
|
237
|
+
}
|
|
238
|
+
const listed = new Set(names);
|
|
239
|
+
for (const name of names) {
|
|
240
|
+
if (!name.endsWith(OWNER_SUFFIX))
|
|
241
|
+
continue;
|
|
242
|
+
const owner = readOwnerFileAt(join(dir, name));
|
|
243
|
+
if (owner === "gone")
|
|
244
|
+
continue;
|
|
245
|
+
if (owner === "damaged") {
|
|
246
|
+
unattributable++;
|
|
247
|
+
continue;
|
|
248
|
+
}
|
|
249
|
+
if (owner.provenance.sessionId !== sessionId)
|
|
250
|
+
continue;
|
|
251
|
+
const stem = name.slice(0, -OWNER_SUFFIX.length);
|
|
252
|
+
const ref = this.refOfEntry(dir, stem, owner.ref);
|
|
253
|
+
if (ref === undefined)
|
|
254
|
+
unaddressable++;
|
|
255
|
+
else
|
|
256
|
+
entries.push({ ref, provenance: owner.provenance });
|
|
257
|
+
}
|
|
258
|
+
for (const name of names) {
|
|
259
|
+
if (!name.endsWith(CONTENT_SUFFIX))
|
|
260
|
+
continue;
|
|
261
|
+
if (listed.has(`${name.slice(0, -CONTENT_SUFFIX.length)}${OWNER_SUFFIX}`))
|
|
262
|
+
continue;
|
|
263
|
+
unattributable++;
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
return { entries, unattributable, unaddressable };
|
|
267
|
+
}
|
|
268
|
+
refOfEntry(dir, stem, stated) {
|
|
269
|
+
const lies = (ref) => {
|
|
270
|
+
try {
|
|
271
|
+
const at = this.locate(ref);
|
|
272
|
+
return at.dir === dir && at.stem === stem;
|
|
273
|
+
}
|
|
274
|
+
catch {
|
|
275
|
+
return false;
|
|
276
|
+
}
|
|
277
|
+
};
|
|
278
|
+
if (stated !== undefined)
|
|
279
|
+
return lies(stated) ? stated : undefined;
|
|
280
|
+
return dir === this.dir && lies(stem) ? stem : undefined;
|
|
281
|
+
}
|
|
182
282
|
}
|
|
183
283
|
const CONTENT_SUFFIX = ".txt";
|
|
184
284
|
const OWNER_SUFFIX = ".owner.json";
|
|
185
285
|
function parseOwnerRecord(raw) {
|
|
286
|
+
return parseOwnerFile(raw)?.provenance;
|
|
287
|
+
}
|
|
288
|
+
function parseOwnerFile(raw) {
|
|
186
289
|
const parsed = (() => {
|
|
187
290
|
try {
|
|
188
291
|
return JSON.parse(raw);
|
|
@@ -192,14 +295,15 @@ function parseOwnerRecord(raw) {
|
|
|
192
295
|
}
|
|
193
296
|
})();
|
|
194
297
|
if (typeof parsed === "object" && parsed !== null) {
|
|
195
|
-
const { sessionId, taskId } = parsed;
|
|
298
|
+
const { sessionId, taskId, ref } = parsed;
|
|
196
299
|
if (typeof sessionId === "string" && (taskId === undefined || typeof taskId === "string")) {
|
|
197
|
-
|
|
300
|
+
const provenance = taskId === undefined ? { sessionId } : { sessionId, taskId };
|
|
301
|
+
return typeof ref === "string" ? { provenance, ref } : { provenance };
|
|
198
302
|
}
|
|
199
303
|
}
|
|
200
304
|
return undefined;
|
|
201
305
|
}
|
|
202
|
-
function
|
|
306
|
+
function readOwnerFileAt(path) {
|
|
203
307
|
let raw;
|
|
204
308
|
try {
|
|
205
309
|
raw = readFileSync(path, "utf8");
|
|
@@ -207,7 +311,21 @@ function readOwnerAt(path) {
|
|
|
207
311
|
catch (err) {
|
|
208
312
|
return err.code === "ENOENT" ? "gone" : "damaged";
|
|
209
313
|
}
|
|
210
|
-
return
|
|
314
|
+
return parseOwnerFile(raw) ?? "damaged";
|
|
315
|
+
}
|
|
316
|
+
function readOwnerAt(path) {
|
|
317
|
+
const read = readOwnerFileAt(path);
|
|
318
|
+
return typeof read === "string" ? read : read.provenance;
|
|
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
|
+
}
|
|
211
329
|
}
|
|
212
330
|
function unlinkIfAbsentOk(path) {
|
|
213
331
|
try {
|
|
@@ -227,6 +345,10 @@ function encodeRefFilename(ref) {
|
|
|
227
345
|
const base = ref.replace(/[^A-Za-z0-9_.-]/g, "-").slice(0, 64);
|
|
228
346
|
return { folded: true, stem: `${base || "ref"}-${createHash("sha256").update(Buffer.from(ref, "utf16le")).digest("hex")}` };
|
|
229
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
|
+
}
|
|
230
352
|
function intOr(x, fallback) {
|
|
231
353
|
return Number.isFinite(x) ? Math.floor(x) : fallback;
|
|
232
354
|
}
|
|
@@ -25,7 +25,7 @@ export interface FileUsageWindowStoreOptions {
|
|
|
25
25
|
export declare class FileUsageWindowStore implements UsageWindowStore {
|
|
26
26
|
private readonly dir;
|
|
27
27
|
private readonly onCorruptRead;
|
|
28
|
-
constructor(root: string,
|
|
28
|
+
constructor(root: string, options?: FileUsageWindowStoreOptions);
|
|
29
29
|
/** key → a safe, INJECTIVE filename (`sanitizeScope` appends the full sha256 of the raw key, so two
|
|
30
30
|
* distinct principals can never share a ledger file). */
|
|
31
31
|
private pathFor;
|
|
@@ -3,11 +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 { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
6
7
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
8
|
+
const FILE_USAGE_WINDOW_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
7
9
|
export class FileUsageWindowStore {
|
|
8
10
|
dir;
|
|
9
11
|
onCorruptRead;
|
|
10
|
-
constructor(root,
|
|
12
|
+
constructor(root, options) {
|
|
13
|
+
const opts = receiveOptions(options, "FileUsageWindowStore", FILE_USAGE_WINDOW_STORE_OPTION_KEYS);
|
|
11
14
|
assertAdoptionBootGate(root, "FileUsageWindowStore");
|
|
12
15
|
this.dir = join(root, "usage-windows");
|
|
13
16
|
ensureDir(this.dir);
|
|
@@ -1,15 +1,5 @@
|
|
|
1
1
|
import { type WorkflowJournalEntry, type WorkflowJournalStore, type ResumeClaimArgs } from "../../core/workflow-journal-store.js";
|
|
2
2
|
import { type CorruptReadInfo } from "./corrupt-read-sink.js";
|
|
3
|
-
/**
|
|
4
|
-
* SVC-2 — the shared size bound for a journaled workflow-agent entry, so ALL backends answer an oversize
|
|
5
|
-
* TaskResult with the SAME refusal (no dialect divergence). Inlined from service's `workflow-journal-limits` on
|
|
6
|
-
* onboarding — the 5 MiB figure aligns with TiDB's ~6 MiB per-row txn-entry-size-limit (a row over it is
|
|
7
|
-
* REJECTED with "entry too large"). PostgreSQL TEXT has no such low limit, so without a shared bound the same
|
|
8
|
-
* large entry would journal on PG and fail on TiDB; the shared bound makes every backend refuse at the same
|
|
9
|
-
* byte and with the same code (`workflow.journal_oversize`) before the row reaches the medium. Measured in
|
|
10
|
-
* BYTES (UTF-8) — a multibyte result can be larger than its `.length` in chars.
|
|
11
|
-
*/
|
|
12
|
-
export { MAX_JOURNAL_RESULT_BYTES, oversizeJournalResult } from "../../core/workflow-journal-store.js";
|
|
13
3
|
/**
|
|
14
4
|
* RB-242 — how long a resume claim survives WITHOUT an engine release. This is the backstop for an engine that
|
|
15
5
|
* died holding one (crash / kill -9 / box reboot): it never reaches its `finally`, so nothing but expiry can
|
|
@@ -74,7 +64,7 @@ export declare class FileWorkflowJournalStore implements WorkflowJournalStore {
|
|
|
74
64
|
private get scopes();
|
|
75
65
|
/** The swallow-guarded corrupt-read seat (undefined = the old silent tolerance). */
|
|
76
66
|
private readonly discloseCorrupt;
|
|
77
|
-
constructor(root: string, fsyncEnabled?: boolean,
|
|
67
|
+
constructor(root: string, fsyncEnabled?: boolean, options?: FileWorkflowJournalStoreOptions);
|
|
78
68
|
private pathFor;
|
|
79
69
|
/** CC local form: the run's on-disk journal path for the notification diagnostics line.
|
|
80
70
|
* Traversal-shaped ids (LLM-controlled on some paths) degrade to undefined, never throw. */
|
|
@@ -136,8 +126,6 @@ export declare class FileWorkflowJournalStore implements WorkflowJournalStore {
|
|
|
136
126
|
/** RB-242 — release ONLY a claim this `newRunId` still holds. A claim that is already gone (TTL-reaped
|
|
137
127
|
* and possibly taken over) is a no-op: unlinking a successor's claim would re-open the very fork this prevents. */
|
|
138
128
|
releaseResumeClaim(input: ResumeClaimArgs): Promise<void>;
|
|
139
|
-
/** GC (service extra, mirrors the SQL twins): drop the run's ledger once the run is terminal + retained. */
|
|
140
|
-
deleteByRun(runId: string): Promise<number>;
|
|
141
129
|
/** Release ledger fds (graceful shutdown; parity with the other file stores' dispose).
|
|
142
130
|
* Refcounted: the fds are shared with any other instance on the same directory, so the LAST holder
|
|
143
131
|
* closes them. Idempotent — a second dispose() on the same instance must not decrement twice and pull
|
|
@@ -6,8 +6,8 @@ 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 { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
9
10
|
import { assertJournalEntryFits } from "../../core/workflow-journal-store.js";
|
|
10
|
-
export { MAX_JOURNAL_RESULT_BYTES, oversizeJournalResult } 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;
|
|
13
13
|
export const RESUME_CLAIM_SWEEP_INTERVAL_MS = 60_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;
|
|
@@ -33,8 +34,9 @@ export class FileWorkflowJournalStore {
|
|
|
33
34
|
return this.shared.scopes;
|
|
34
35
|
}
|
|
35
36
|
discloseCorrupt;
|
|
36
|
-
constructor(root, fsyncEnabled = true,
|
|
37
|
+
constructor(root, fsyncEnabled = true, options) {
|
|
37
38
|
this.fsyncEnabled = fsyncEnabled;
|
|
39
|
+
const opts = receiveOptions(options, "FileWorkflowJournalStore", FILE_WORKFLOW_JOURNAL_STORE_OPTION_KEYS);
|
|
38
40
|
this.discloseCorrupt = guardCorruptSink(opts?.onCorruptRead);
|
|
39
41
|
assertAdoptionBootGate(root, "FileWorkflowJournalStore");
|
|
40
42
|
this.dir = join(root, "workflow-journal");
|
|
@@ -258,22 +260,6 @@ export class FileWorkflowJournalStore {
|
|
|
258
260
|
return;
|
|
259
261
|
this.unlinkIfUnchanged(path, existing.raw);
|
|
260
262
|
}
|
|
261
|
-
async deleteByRun(runId) {
|
|
262
|
-
const log = this.logs.get(runId);
|
|
263
|
-
if (log !== undefined) {
|
|
264
|
-
try {
|
|
265
|
-
log.close();
|
|
266
|
-
}
|
|
267
|
-
catch { }
|
|
268
|
-
this.logs.delete(runId);
|
|
269
|
-
}
|
|
270
|
-
this.scopes.delete(runId);
|
|
271
|
-
const path = this.pathFor(runId);
|
|
272
|
-
if (!existsSync(path))
|
|
273
|
-
return 0;
|
|
274
|
-
unlinkSync(path);
|
|
275
|
-
return 1;
|
|
276
|
-
}
|
|
277
263
|
dispose() {
|
|
278
264
|
if (this.closed)
|
|
279
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);
|
|
@@ -77,6 +77,11 @@ export interface ContainmentFaceInputs {
|
|
|
77
77
|
* reaches anyway" does not hold, so no implicit default may open it).
|
|
78
78
|
* 5. default: ROOTS — the engine never opens implicitly.
|
|
79
79
|
*
|
|
80
|
+
* A face is a DEPLOYMENT's trust statement, never an execution environment's capability: no declaration of the
|
|
81
|
+
* environment (a sandbox's `isolation` included) enters this order, so every lane's default is ROOTS, and a lane that is to
|
|
82
|
+
* read open says so at a seat allowed to open — the deployment seat in force for its run, or the task seat where no
|
|
83
|
+
* organization governance is declared; under governance only the deployment seat opens.
|
|
84
|
+
*
|
|
80
85
|
* @contract fs.containment_face.seat_independence — the two containment seats never read each other:
|
|
81
86
|
* each band passes its OWN resolved value into the shared containment step, a seat nobody declared
|
|
82
87
|
* resolves to "roots" on its own, and no gate other than that step is touched by either word. A
|
|
@@ -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);
|
|
@@ -33,11 +33,20 @@ export interface DecodedTextFile {
|
|
|
33
33
|
* BACK across the entire file, so sampling a prefix is exactly the case where the cheap answer
|
|
34
34
|
* flips the remaining 99% of the lines. */
|
|
35
35
|
endings: DetectedLineEndings;
|
|
36
|
-
/**
|
|
37
|
-
*
|
|
38
|
-
|
|
39
|
-
malformed?: true;
|
|
36
|
+
/** The body cannot be written back byte for byte ({@link MalformedBody}). Flagged so the tool layer fails closed instead
|
|
37
|
+
* of "repairing" the file. */
|
|
38
|
+
malformed?: MalformedBody;
|
|
40
39
|
}
|
|
40
|
+
/**
|
|
41
|
+
* Why a decoded body cannot be written back byte for byte — the one fact every write lane (Edit, Write onto an existing file,
|
|
42
|
+
* NotebookEdit) refuses on:
|
|
43
|
+
* - `truncated_utf16`: a utf16le body with an ODD byte count is truncated/corrupt — decoding drops the dangling byte and a
|
|
44
|
+
* write-back would destroy it permanently (Read refuses it too: the text itself is incomplete);
|
|
45
|
+
* - `not_utf8`: a body read as UTF-8 (with or without its BOM) that is not valid UTF-8 — an older encoding such as
|
|
46
|
+
* Windows-1252, Shift-JIS or GBK, or binary. Its undecodable bytes decode to U+FFFD, and writing the text back would
|
|
47
|
+
* replace every one of them with U+FFFD (Read shows the decoded text as it is).
|
|
48
|
+
*/
|
|
49
|
+
export type MalformedBody = "truncated_utf16" | "not_utf8";
|
|
41
50
|
/** BOM-only encoding detection (CC `detectEncodingForResolvedPath` parity — no content heuristics). */
|
|
42
51
|
export declare function detectFileEncoding(bytes: Uint8Array): DetectedFileEncoding;
|
|
43
52
|
/** Decode file bytes into the model-facing normalized form + the metadata needed to write back losslessly. */
|
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
const STRICT_UTF8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
|
|
2
|
+
function isValidUtf8(body) {
|
|
3
|
+
try {
|
|
4
|
+
STRICT_UTF8.decode(body);
|
|
5
|
+
return true;
|
|
6
|
+
}
|
|
7
|
+
catch {
|
|
8
|
+
return false;
|
|
9
|
+
}
|
|
10
|
+
}
|
|
1
11
|
export function detectFileEncoding(bytes) {
|
|
2
12
|
if (bytes.length >= 2 && bytes[0] === 0xff && bytes[1] === 0xfe)
|
|
3
13
|
return { encoding: "utf16le", hadBom: true };
|
|
@@ -23,8 +33,13 @@ export function decodeTextBytes(bytes) {
|
|
|
23
33
|
const body = encoding.hadBom ? bytes.subarray(encoding.encoding === "utf16le" ? 2 : 3) : bytes;
|
|
24
34
|
const raw = Buffer.from(body).toString(encoding.encoding);
|
|
25
35
|
const decoded = { text: raw.replaceAll("\r\n", "\n"), encoding, endings: detectLineEndings(raw) };
|
|
26
|
-
if (encoding.encoding === "utf16le"
|
|
27
|
-
|
|
36
|
+
if (encoding.encoding === "utf16le") {
|
|
37
|
+
if (body.length % 2 !== 0)
|
|
38
|
+
decoded.malformed = "truncated_utf16";
|
|
39
|
+
}
|
|
40
|
+
else if (raw.includes("�") && !isValidUtf8(body)) {
|
|
41
|
+
decoded.malformed = "not_utf8";
|
|
42
|
+
}
|
|
28
43
|
return decoded;
|
|
29
44
|
}
|
|
30
45
|
export function encodeTextForFile(text, encoding, endings) {
|
|
@@ -14,3 +14,16 @@
|
|
|
14
14
|
* (its own leg says so in a comment), so the sentence it gets must be the same string, not a second copy.
|
|
15
15
|
*/
|
|
16
16
|
export declare function backgroundLifetimeNote(retained: boolean, sessionScoped: boolean, envIsolatedOwned: boolean, face?: "receipt" | "description"): string;
|
|
17
|
+
/**
|
|
18
|
+
* The one sentence a background COMMAND's receipt carries in a one-shot submission (e.g. headless `-p`): the submission's
|
|
19
|
+
* ending waits for the completion of loop-type background tasks (agents, workflows) only — a command's lifetime is its
|
|
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
|
+
* ONE construction point for both background legs (run_in_background and an adopted command).
|
|
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;
|
|
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,3 +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
|
+
}
|
|
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,6 @@
|
|
|
1
1
|
import { type AgentTool, type ExecutionEnv } from "../../internal/harness.js";
|
|
2
|
-
import {
|
|
2
|
+
import type { TaskRegistry } from "../../core/task-registry.js";
|
|
3
|
+
import { type ImageDownsampler } from "../../core/image-downsample.js";
|
|
3
4
|
import { type CwdRef } from "./fs-shared.js";
|
|
4
5
|
import type { ReversibilityVerdict } from "../../core/types.js";
|
|
5
6
|
import type { ShellReadAdmission } from "./shell-read-check.js";
|
|
@@ -71,7 +72,8 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
71
72
|
* run-scoped registration exactly as before (killed-with-receipt at teardown). */
|
|
72
73
|
sessionId?: string;
|
|
73
74
|
/** Completion-notification sink — a finished background command fires ONE
|
|
74
|
-
* 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. */
|
|
75
77
|
onTaskNotification?: (n: import("../../core/task-notification.js").TaskNotificationPayload, opts?: {
|
|
76
78
|
priority?: "now" | "next" | "later";
|
|
77
79
|
}) => void;
|
|
@@ -122,10 +124,9 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
122
124
|
/**
|
|
123
125
|
* Mirrors {@link import("../../core/types.js").TaskSpec.oneShot}: this run has no later
|
|
124
126
|
* turn for an async background notification to land in (a headless `-p` process exits once the
|
|
125
|
-
* turn ends)
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
* one-shot process loses the result — the process exits with nothing left alive to receive it).
|
|
127
|
+
* turn ends), and its ending waits for loop-type background tasks only — never for a command's
|
|
128
|
+
* process. Branches the background-launch receipt to {@link ONE_SHOT_BACKGROUND_COMMAND_NOTE}
|
|
129
|
+
* instead of "you will be notified — do not poll".
|
|
129
130
|
*/
|
|
130
131
|
oneShot?: boolean;
|
|
131
132
|
/**
|
|
@@ -148,6 +149,8 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
148
149
|
/** The byte floor's seat (read-floor.ts): every command this leg starts, foreground or background, carries the
|
|
149
150
|
* read-deny table its call judges with to the environment. Absent ⇒ no table, the starts carry nothing. */
|
|
150
151
|
readFloor?: ReadFloorSeat;
|
|
152
|
+
/** The run's image processor seat (`RunnerDeps.imageProcessor`), for an image-data-URI stdout. */
|
|
153
|
+
imageProcessor?: ImageDownsampler | false;
|
|
151
154
|
/** Override of the `timeout` parameter's DEFAULT budget, in ms — see
|
|
152
155
|
* {@link import("./index.js").HandsToolkitOptions.bashDefaultTimeoutMs} for the resolution
|
|
153
156
|
* contract (options over env over constant; invalid values discarded). */
|
|
@@ -207,25 +210,11 @@ export declare function createBashReadonlyTool(env: ExecutionEnv, rootCanonical:
|
|
|
207
210
|
shellReadAdmission?: ShellReadAdmission;
|
|
208
211
|
/** The byte floor's seat — the SAME one the full shell leg takes (read-floor.ts). */
|
|
209
212
|
readFloor?: ReadFloorSeat;
|
|
213
|
+
/** The image processor seat — the SAME one the full shell leg takes. */
|
|
214
|
+
imageProcessor?: ImageDownsampler | false;
|
|
210
215
|
/** The run's tool-progress sink — the SAME seat the full shell leg takes, for the same reason its
|
|
211
216
|
* two neighbours above are shared: both foreground legs run through `runShell`, so a long command
|
|
212
217
|
* must breathe on both or a person watching one of them is told nothing. This face has no detach
|
|
213
218
|
* chain, so it ticks and never auto-backgrounds. Absent ⇒ no streaming callbacks, byte-unchanged. */
|
|
214
219
|
onToolProgress?: (body: import("../../core/runner/contracts.js").ToolProgressBody) => void;
|
|
215
220
|
}): AgentTool;
|
|
216
|
-
/**
|
|
217
|
-
* `TaskOutput` — read a background shell's NEW output
|
|
218
|
-
* 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
|
|
219
|
-
* falls in a high-throughput middle window. Untrusted process output is fenced (delimitUntrusted) — observe-only,
|
|
220
|
-
* never re-fed as instructions.
|
|
221
|
-
*/
|
|
222
|
-
export declare function createEnvTaskOutputTool(env: ExecutionEnv): AgentTool;
|
|
223
|
-
/** `TaskStop` — terminate a background shell by task_id.
|
|
224
|
-
*
|
|
225
|
-
* This band kills ENV-DIRECT (it mounts precisely when the toolkit has
|
|
226
|
-
* no registry — the createHandsToolkit ternary routes registry deployments to createTaskStopTool), so a
|
|
227
|
-
* row for the SAME shell in the process-local {@link defaultTaskRegistry} (a Runner-mounted run sharing
|
|
228
|
-
* this env) used to settle via the watcher's no-claimant floor as stoppedBy:"system". The tool now marks
|
|
229
|
-
* the initiation site ("parent") on `registry` (default: the process-local {@link defaultTaskRegistry})
|
|
230
|
-
* BEFORE the kill — attribution only; the kill path and the model-facing receipt text are unchanged. */
|
|
231
|
-
export declare function createEnvTaskStopTool(env: ExecutionEnv, registry?: TaskRegistry): AgentTool;
|