@sema-agent/core 7.60.0 → 7.62.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -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);
|
|
@@ -106,8 +106,9 @@ export interface ProgramPosition {
|
|
|
106
106
|
readonly refusal: ProgramPositionRefusal | undefined;
|
|
107
107
|
/** A launcher of the chain moves the directory or the root the program runs in, or where its word is looked up
|
|
108
108
|
* (`env -C <dir>`, `sudo -R <dir>`, `env -P <dirs>`): the program is still the word it names, but where its path
|
|
109
|
-
* operands resolve is not the command line's working directory — each consumer reads that as it must.
|
|
110
|
-
|
|
109
|
+
* operands resolve is not the command line's working directory — each consumer reads that as it must. The argv index of
|
|
110
|
+
* each such option word the walk stepped, in order (its value is that word's rest or the next word); empty: none moves. */
|
|
111
|
+
readonly baseMovedAt: readonly number[];
|
|
111
112
|
}
|
|
112
113
|
/**
|
|
113
114
|
* Read the program position of one segment's argv words.
|
|
@@ -49,7 +49,7 @@ function pastLauncherOptions(launcher, folded, i, moved, queried, ended) {
|
|
|
49
49
|
if (step === 2 && folded[i + 1] === undefined)
|
|
50
50
|
return i;
|
|
51
51
|
if (launcherOptionMovesBase(row, tok))
|
|
52
|
-
moved?.();
|
|
52
|
+
moved?.(i);
|
|
53
53
|
if (launcherOptionQueries(row, tok))
|
|
54
54
|
queried?.();
|
|
55
55
|
i += step;
|
|
@@ -72,7 +72,7 @@ export function readProgramPosition(words) {
|
|
|
72
72
|
controlWords.push(i);
|
|
73
73
|
i = pastLauncherOptions(controlWord, folded, i + 1);
|
|
74
74
|
}
|
|
75
|
-
const none = (written, assignments, refusal) => ({ controlWords, written, assignments, launchers: [], argvFromStdin: false, runsDefaultProgram: false, program: undefined, refusal,
|
|
75
|
+
const none = (written, assignments, refusal) => ({ controlWords, written, assignments, launchers: [], argvFromStdin: false, runsDefaultProgram: false, program: undefined, refusal, baseMovedAt: [] });
|
|
76
76
|
const globProgramRefusal = (idx) => {
|
|
77
77
|
let glob = false;
|
|
78
78
|
for (const p of words[idx].pieces) {
|
|
@@ -110,26 +110,26 @@ export function readProgramPosition(words) {
|
|
|
110
110
|
const glob = globProgramRefusal(i);
|
|
111
111
|
if (glob !== undefined)
|
|
112
112
|
return none(written, assignments, glob);
|
|
113
|
-
return { controlWords, written, assignments, launchers: [], argvFromStdin: false, runsDefaultProgram: false, program: { index: i, name: head, basename }, refusal: undefined,
|
|
113
|
+
return { controlWords, written, assignments, launchers: [], argvFromStdin: false, runsDefaultProgram: false, program: { index: i, name: head, basename }, refusal: undefined, baseMovedAt: [] };
|
|
114
114
|
}
|
|
115
115
|
const launchers = [{ index: i, name: basename }];
|
|
116
116
|
const owner = head;
|
|
117
117
|
const shellRefusal = (launcher, from) => ({ kind: "control_syntax_at_program_position", owner, word: "sh", runsShell: { launcher, from } });
|
|
118
118
|
let lastRow = launcherRowOf(basename)?.launcher;
|
|
119
119
|
let owedOperands = lastRow?.requiredOperands ?? 0;
|
|
120
|
-
const chain0 = (program, refusal) => ({ controlWords, written, assignments, launchers, argvFromStdin: false, runsDefaultProgram: false, program, refusal,
|
|
120
|
+
const chain0 = (program, refusal) => ({ controlWords, written, assignments, launchers, argvFromStdin: false, runsDefaultProgram: false, program, refusal, baseMovedAt: [] });
|
|
121
121
|
if (launcherRunsShell(launcherRowOf(basename), folded.slice(i + 1)))
|
|
122
122
|
return chain0(undefined, shellRefusal(i, i + 1));
|
|
123
123
|
let argvFromStdin = feedsArgvFromStdin(basename);
|
|
124
124
|
let lastReentry = argvFromStdin ? i : -1;
|
|
125
125
|
let reentryDefault = argvFromStdin ? streamDefaultProgram(basename) : undefined;
|
|
126
|
-
|
|
127
|
-
const moved = () => {
|
|
126
|
+
const baseMovedAt = [];
|
|
127
|
+
const moved = (at) => { baseMovedAt.push(at); };
|
|
128
128
|
let looksUp = false;
|
|
129
129
|
const queried = () => { looksUp = true; };
|
|
130
130
|
const chain = (program, refusal) => {
|
|
131
131
|
const runsDefaultProgram = lastReentry === folded.length - 1;
|
|
132
|
-
return { controlWords, written, assignments, launchers, argvFromStdin, runsDefaultProgram, ...(runsDefaultProgram && reentryDefault !== undefined ? { defaultProgram: reentryDefault } : {}), program, refusal,
|
|
132
|
+
return { controlWords, written, assignments, launchers, argvFromStdin, runsDefaultProgram, ...(runsDefaultProgram && reentryDefault !== undefined ? { defaultProgram: reentryDefault } : {}), program, refusal, baseMovedAt };
|
|
133
133
|
};
|
|
134
134
|
const selectsShell = (l, end) => selectedOptions(launcherRowOf(l.name), folded.slice(l.index + 1, end)).some((o) => o.mode === "interactive");
|
|
135
135
|
const first = pastLauncherOptions(basename, folded, i + 1, moved, queried, endsOptions(basename));
|
|
@@ -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;
|
package/dist/tools/fs/fs-bash.js
CHANGED
|
@@ -2,10 +2,7 @@ import { randomBytes } from "node:crypto";
|
|
|
2
2
|
import { Type } from "typebox";
|
|
3
3
|
import { defineTool, errorResult } from "../../core/tools.js";
|
|
4
4
|
import { isTimeCutCode } from "../../internal/harness.js";
|
|
5
|
-
import { defaultTaskRegistry } from "../../core/task-registry.js";
|
|
6
|
-
import { accountDroppedBytes, spoolDropNote } from "../../core/task-registry-shared.js";
|
|
7
5
|
import { RollingTailBuffer } from "../../core/exec-output-tail.js";
|
|
8
|
-
import { TASK_OUTPUT_TOOL_NAME, TASK_STOP_TOOL_NAME, TASK_OUTPUT_MISSING_ID_MESSAGE, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, resolveTaskIdArg, ENV_DIRECT_TASK_TOOL_CAPS, composeTaskOutputDescription, composeTaskOutputParams, composeTaskStopDescription, } from "../../core/task-tool-shape.js";
|
|
9
6
|
import { createBackgroundOutputFile, envDeclaresRetain, hasBackgroundShell, retainsBackgroundProcesses } from "../../core/background-shell.js";
|
|
10
7
|
import { delimitUntrusted } from "../../core/untrusted-text.js";
|
|
11
8
|
import { resolveImageProcessor } from "../../core/image-downsample.js";
|
|
@@ -14,12 +11,12 @@ import { admitImageBytes, sniffImageMime } from "../../core/image-admission.js";
|
|
|
14
11
|
import { isDeadCwd, diagnoseDeadCwd } from "./dead-cwd.js";
|
|
15
12
|
import { boundaryIsTheSandbox, hasDestroy, isIsolated } from "../../core/remote-env.js";
|
|
16
13
|
import { ghRateLimitHint } from "./gh-rate-limit.js";
|
|
17
|
-
import { backgroundLifetimeNote, ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs-bash-background-text.js";
|
|
18
|
-
import { resolveCompletionSink } from "../../core/task-notification.js";
|
|
19
|
-
import { resolveBashTimeoutCaps, bashTimeoutCapsSec, bashTimeoutArgRefusal, bashTimeoutParamDescription, envErrorDetail, bashMaxOutputChars, clipShellOutput, writeShellOverflowFile, shellRecoveryHint, CWD_SENTINEL, stripCwdSentinel, } from "./fs-shared.js";
|
|
14
|
+
import { backgroundLifetimeNote, backgroundOutputFileNote, BASH_BACKGROUND_UNAVAILABLE, ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs-bash-background-text.js";
|
|
15
|
+
import { admitsBackgroundLaunch, resolveCompletionSink } from "../../core/task-notification.js";
|
|
16
|
+
import { resolveBashTimeoutCaps, bashTimeoutCapsSec, bashTimeoutArgRefusal, bashTimeoutParamDescription, envErrorDetail, bashMaxOutputChars, clipShellOutput, writeShellOverflowFile, shellRecoveryHint, zeroOutputSentence, CWD_SENTINEL, stripCwdSentinel, } from "./fs-shared.js";
|
|
20
17
|
import { bashClassifyDefaultAllow, BASH_READONLY_DEFAULT_ALLOW, classifyBoundedReadonlyPollLoopDetailed, classifyCompoundReadonlyDetailed, parseLeadingCommandName } from "./bash-readonly-classifier.js";
|
|
21
18
|
import { readOnlyShellVerdict } from "../../core/read-only-shell.js";
|
|
22
|
-
import {
|
|
19
|
+
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
23
20
|
import { argvOf, compoundValueHidesRun, expansionHidesRun, expansionsInHeredocBody, lexShell } from "../../shell/lex.js";
|
|
24
21
|
import { arithmeticAssignedNames } from "./shell-read-bindings.js";
|
|
25
22
|
import { thrownText } from "../../core/thrown-value.js";
|
|
@@ -377,14 +374,7 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
|
|
|
377
374
|
const captured = (pStdout ? `--- partial stdout ---\n${pStdout}` : "") +
|
|
378
375
|
(pStderr ? `${pStdout ? "\n" : ""}--- partial stderr ---\n${pStderr}` : "");
|
|
379
376
|
const zeroOutput = captured.length === 0;
|
|
380
|
-
const
|
|
381
|
-
? ` — the process wrote nothing to its stdio for ${noOutputSec !== undefined ? `the whole ${noOutputSec}s window` : "the whole window"}; it may have been stalled before producing output, or holding it in a block buffer`
|
|
382
|
-
: res.error.code === "timeout" && timeout >= 60
|
|
383
|
-
? ` — the process ran the full ${timeout}s without writing to its stdio; it may have been stalled before producing output, or holding it in a block buffer`
|
|
384
|
-
: "";
|
|
385
|
-
const body = !zeroOutput
|
|
386
|
-
? `\n${delimitUntrusted("partial command output", captured)}`
|
|
387
|
-
: `\n(no output was produced before the cutoff${zeroOutputHint})`;
|
|
377
|
+
const body = !zeroOutput ? `\n${delimitUntrusted("partial command output", captured)}` : `\n${zeroOutputSentence(res.error, timeout, noOutputSec)}`;
|
|
388
378
|
const overflowNote = cutOverflowFile !== undefined ? shellRecoveryHint(cutOverflowFile, readOnly) : "";
|
|
389
379
|
return {
|
|
390
380
|
content: `Error (${toolName}): ${headline}${body}${overflowNote}`,
|
|
@@ -484,7 +474,7 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
|
|
|
484
474
|
},
|
|
485
475
|
};
|
|
486
476
|
}
|
|
487
|
-
function bashDescription(coAuthor, caps,
|
|
477
|
+
function bashDescription(coAuthor, caps, bgOffered = false, bgRetained = false, bgSessionScoped = false, bgEnvIsolatedOwned = false) {
|
|
488
478
|
const coAuthorLines = coAuthor === false
|
|
489
479
|
? "- Follow the deployment's commit-message conventions."
|
|
490
480
|
: `- End git commit messages with:\nCo-Authored-By: ${coAuthor}`;
|
|
@@ -493,8 +483,7 @@ function bashDescription(coAuthor, caps, bgNotifies = false, bgRetained = false,
|
|
|
493
483
|
- Working directory persists between calls, but prefer absolute paths — each call starts in the directory the previous call ended in, so a \`cd\` carries over and moves the base for every later command. Shell state (env vars, functions) does not persist; the shell is re-initialized each call.
|
|
494
484
|
- IMPORTANT: Avoid using this tool to run \`cat\`, \`head\`, \`tail\`, \`sed\`, \`awk\`, or \`echo\` commands, unless explicitly instructed or after you have verified that a dedicated tool cannot accomplish your task. Instead, use the appropriate dedicated tool as this will provide a much better experience for the user.
|
|
495
485
|
- File search by name: use the Glob tool (NOT \`find\` or \`ls\`); content search: use the Grep tool (NOT \`grep\`/\`rg\` in the shell).
|
|
496
|
-
- \`timeout\` is in milliseconds: default ${caps.defaultMs}, max ${caps.maxMs}.
|
|
497
|
-
- \`run_in_background\` runs the command detached: it keeps running across turns and ${bgNotifies ? "re-invokes you when it exits" : "you read its output later with TaskOutput(task_id)"}. No \`&\` needed.${backgroundLifetimeNote(bgRetained, bgSessionScoped, bgEnvIsolatedOwned, "description")}
|
|
486
|
+
- \`timeout\` is in milliseconds: default ${caps.defaultMs}, max ${caps.maxMs}.${bgOffered ? `\n- \`run_in_background\` runs the command detached: it keeps running across turns and re-invokes you when it exits. No \`&\` needed.${backgroundLifetimeNote(bgRetained, bgSessionScoped, bgEnvIsolatedOwned, "description")}` : ""}
|
|
498
487
|
|
|
499
488
|
# Git
|
|
500
489
|
- Interactive flags (\`-i\`, e.g. \`git rebase -i\`, \`git add -i\`) are not supported in this environment.
|
|
@@ -512,7 +501,7 @@ async function adoptBackgroundShell(req) {
|
|
|
512
501
|
const owner = sessionScoped ? wiring.sessionId : (ctxTaskId ?? wiring.taskOwner);
|
|
513
502
|
const scope = ctxPrincipal ?? wiring.taskScope;
|
|
514
503
|
const onNotify = wiring.onNotify;
|
|
515
|
-
const outputFile =
|
|
504
|
+
const outputFile = await createBackgroundOutputFile(env, "bash-task-");
|
|
516
505
|
try {
|
|
517
506
|
const taskId = registry.registerBackgroundBash({
|
|
518
507
|
env,
|
|
@@ -524,7 +513,7 @@ async function adoptBackgroundShell(req) {
|
|
|
524
513
|
...(sessionScoped ? { sessionScoped: true } : {}),
|
|
525
514
|
...(outputFile !== undefined ? { outputFile } : {}),
|
|
526
515
|
...(ctxTaskArtifacts !== undefined ? { taskArtifacts: ctxTaskArtifacts } : {}),
|
|
527
|
-
|
|
516
|
+
onTerminal: (n) => onNotify(n, { priority: "next" }),
|
|
528
517
|
...(wiring.retainBackgroundProcesses !== undefined ? { retainBackgroundProcesses: wiring.retainBackgroundProcesses } : {}),
|
|
529
518
|
});
|
|
530
519
|
return { ok: true, taskId, outputFile };
|
|
@@ -546,14 +535,14 @@ async function adoptBackgroundShell(req) {
|
|
|
546
535
|
export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = { current: rootCanonical }, taskOpts = {}) {
|
|
547
536
|
const timeoutCaps = resolveBashTimeoutCaps(taskOpts);
|
|
548
537
|
const timeoutCapsSecView = bashTimeoutCapsSec(timeoutCaps);
|
|
549
|
-
const
|
|
538
|
+
const bgOffered = hasBackgroundShell(env) && taskOpts.taskRegistry !== undefined;
|
|
550
539
|
const bgRetained = hasBackgroundShell(env) && retainsBackgroundProcesses({ env: envDeclaresRetain(env), task: taskOpts.retainBackgroundProcesses === true });
|
|
551
540
|
const bgSessionScoped = taskOpts.sessionId !== undefined && taskOpts.taskRegistry !== undefined;
|
|
552
541
|
const bgEnvIsolatedOwned = hasDestroy(env) && isIsolated(env);
|
|
553
542
|
return defineTool({
|
|
554
543
|
name: "Bash",
|
|
555
544
|
...toolFace("bash"),
|
|
556
|
-
description: bashDescription(coAuthor, timeoutCaps,
|
|
545
|
+
description: bashDescription(coAuthor, timeoutCaps, bgOffered, bgRetained, bgSessionScoped, bgEnvIsolatedOwned),
|
|
557
546
|
parameters: Type.Object({
|
|
558
547
|
command: Type.String({ description: "The command to execute" }),
|
|
559
548
|
timeout: Type.Optional(Type.Number({ description: bashTimeoutParamDescription(timeoutCaps, false) })),
|
|
@@ -570,9 +559,13 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
570
559
|
'- git reset --hard origin/main → "Discard all local changes and match remote main"\n' +
|
|
571
560
|
"- curl -s url | jq '.data[]' → \"Fetch JSON from URL and extract data array elements\"",
|
|
572
561
|
})),
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
562
|
+
...(bgOffered
|
|
563
|
+
? {
|
|
564
|
+
run_in_background: Type.Optional(Type.Boolean({
|
|
565
|
+
description: "Set to true to run this command in the background.",
|
|
566
|
+
})),
|
|
567
|
+
}
|
|
568
|
+
: {}),
|
|
576
569
|
}),
|
|
577
570
|
isConcurrencySafe: (args) => {
|
|
578
571
|
const command = shellCommandOf(args);
|
|
@@ -589,9 +582,10 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
589
582
|
if (refused !== undefined)
|
|
590
583
|
return refused;
|
|
591
584
|
if (run_in_background) {
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
585
|
+
const registry = taskOpts.taskRegistry;
|
|
586
|
+
const onNotify = resolveCompletionSink(ctx.onTaskNotification, taskOpts.onTaskNotification);
|
|
587
|
+
if (!hasBackgroundShell(env) || registry === undefined || !admitsBackgroundLaunch(onNotify))
|
|
588
|
+
return errorResult(BASH_BACKGROUND_UNAVAILABLE);
|
|
595
589
|
if (cwdRef && (await isDeadCwd(env, cwdRef.current, ctx.signal))) {
|
|
596
590
|
const diagnosis = await diagnoseDeadCwd(env, "Bash", cwdRef.current, rootCanonical, cwdRef, ctx.signal);
|
|
597
591
|
if (diagnosis !== undefined)
|
|
@@ -619,9 +613,7 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
619
613
|
: ` Time budget: the process may run up to ${appliedTimeoutSec}s (hard cap ${bgCaps.maxBgTimeoutSec}s).`
|
|
620
614
|
: "";
|
|
621
615
|
const lifetimeNote = backgroundLifetimeNote(bgRetained, bgSessionScoped, bgEnvIsolatedOwned);
|
|
622
|
-
|
|
623
|
-
if (registry !== undefined) {
|
|
624
|
-
const onNotify = resolveCompletionSink(ctx.onTaskNotification, taskOpts.onTaskNotification);
|
|
616
|
+
{
|
|
625
617
|
const adopted = await adoptBackgroundShell({
|
|
626
618
|
env,
|
|
627
619
|
shellId: r.value.shellId,
|
|
@@ -639,35 +631,22 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
639
631
|
}
|
|
640
632
|
return {
|
|
641
633
|
content: `Error (Bash): background process was started but could not be registered (${adopted.reason}), and the cleanup kill failed (${adopted.killMsg}). ` +
|
|
642
|
-
`The process could NOT be terminated — it may still be running, but it has no task_id, so
|
|
634
|
+
`The process could NOT be terminated — it may still be running, but it has no task_id, so TaskStop cannot reach it and no completion will arrive. ` +
|
|
643
635
|
`If it must be stopped, kill it manually (e.g. \`pkill -f\` on its command line).`,
|
|
644
636
|
details: { type: "bash", registerFailed: true, killFailed: true },
|
|
645
637
|
isError: true,
|
|
646
638
|
};
|
|
647
639
|
}
|
|
648
640
|
const { taskId, outputFile } = adopted;
|
|
649
|
-
const interimNote = outputFile
|
|
650
|
-
|
|
651
|
-
: ` Use TaskOutput("${taskId}") to check interim output.`;
|
|
652
|
-
if (taskOpts.oneShot === true && onNotify !== undefined) {
|
|
641
|
+
const interimNote = backgroundOutputFileNote(outputFile);
|
|
642
|
+
if (taskOpts.oneShot === true) {
|
|
653
643
|
return `Command running in background; task_id=${taskId}.${interimNote} ${ONE_SHOT_BACKGROUND_COMMAND_NOTE} TaskStop("${taskId}") to stop.` + budgetNote + lifetimeNote;
|
|
654
644
|
}
|
|
655
|
-
return
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
lifetimeNote
|
|
660
|
-
: `Started in background; task_id=${taskId}. ` +
|
|
661
|
-
`Use TaskOutput("${taskId}") to read output (poll until status is no longer "running"); ` +
|
|
662
|
-
`TaskStop("${taskId}") to stop. No '&' needed.` +
|
|
663
|
-
budgetNote +
|
|
664
|
-
lifetimeNote;
|
|
645
|
+
return (`Command running in background; task_id=${taskId}.${interimNote} You will be notified when it completes — do not poll; ` +
|
|
646
|
+
`end your turn if nothing else is pending. TaskStop("${taskId}") to stop.` +
|
|
647
|
+
budgetNote +
|
|
648
|
+
lifetimeNote);
|
|
665
649
|
}
|
|
666
|
-
return (`Started in background; task_id=${r.value.shellId}. ` +
|
|
667
|
-
`Use TaskOutput("${r.value.shellId}") to read output (poll until status is no longer "running"); ` +
|
|
668
|
-
`TaskStop("${r.value.shellId}") to stop. No '&' needed.` +
|
|
669
|
-
budgetNote +
|
|
670
|
-
lifetimeNote);
|
|
671
650
|
}
|
|
672
651
|
const detachHub = taskOpts.detachHub;
|
|
673
652
|
const detachRegistry = taskOpts.taskRegistry;
|
|
@@ -688,11 +667,12 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
688
667
|
detachHub.request(ctx.toolCallId);
|
|
689
668
|
};
|
|
690
669
|
const detachEnv = hasBackgroundShell(env) ? env : undefined;
|
|
691
|
-
const
|
|
670
|
+
const detachSink = resolveCompletionSink(ctx.onTaskNotification, taskOpts.onTaskNotification);
|
|
671
|
+
const detachChain = detachHub !== undefined && detachRegistry !== undefined && detachEnv !== undefined && admitsBackgroundLaunch(detachSink) && detachEnv.backgroundCapabilities.supportsDetach === true
|
|
692
672
|
? {
|
|
693
673
|
signal: detachHub.signalFor(ctx.toolCallId),
|
|
694
674
|
onDetached: async (shellId, stdoutSoFar, stderrSoFar, cause) => {
|
|
695
|
-
const onNotify =
|
|
675
|
+
const onNotify = detachSink;
|
|
696
676
|
const adopted = await adoptBackgroundShell({
|
|
697
677
|
env: detachEnv,
|
|
698
678
|
shellId: shellId,
|
|
@@ -720,7 +700,7 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
720
700
|
}
|
|
721
701
|
return {
|
|
722
702
|
content: `Error (Bash): command was detached to the background but could not be registered (${adopted.reason}), and the cleanup kill failed (${adopted.killMsg}). ` +
|
|
723
|
-
`The process could NOT be terminated — it may still be running, but it has no task_id, so
|
|
703
|
+
`The process could NOT be terminated — it may still be running, but it has no task_id, so TaskStop cannot reach it and no completion will arrive. ` +
|
|
724
704
|
`If it must be stopped, kill it manually (e.g. \`pkill -f\` on its command line).` +
|
|
725
705
|
tails,
|
|
726
706
|
details: { type: "bash", detached: true, registerFailed: true, killFailed: true },
|
|
@@ -739,15 +719,11 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
|
|
|
739
719
|
: backgroundedForQueuedMessage
|
|
740
720
|
? `Command is still running and was moved to the background so a queued message could be delivered without waiting for it (task_id=${taskId}). It was NOT stopped and nothing about it failed. `
|
|
741
721
|
: `Command moved to background; task_id=${taskId}. `) +
|
|
742
|
-
(outputFile
|
|
743
|
-
? `Output file: ${outputFile} (full output is appended there — Read it any time). `
|
|
744
|
-
: `Use TaskOutput("${taskId}") to read its output. `) +
|
|
722
|
+
`${backgroundOutputFileNote(outputFile).trimStart()} ` +
|
|
745
723
|
`TaskStop("${taskId}") to stop it. ` +
|
|
746
|
-
(taskOpts.oneShot === true
|
|
724
|
+
(taskOpts.oneShot === true
|
|
747
725
|
? ONE_SHOT_BACKGROUND_COMMAND_NOTE
|
|
748
|
-
:
|
|
749
|
-
? `You will be notified when it completes — do not poll.`
|
|
750
|
-
: `Poll TaskOutput until its status is no longer "running".`) +
|
|
726
|
+
: `You will be notified when it completes — do not poll.`) +
|
|
751
727
|
adoptBudgetNote +
|
|
752
728
|
backgroundLifetimeNote(bgRetained, bgSessionScoped, bgEnvIsolatedOwned) +
|
|
753
729
|
(tail ? `\n--- output so far (tail) ---\n${tail}` : ""),
|
|
@@ -809,66 +785,3 @@ export function createBashReadonlyTool(env, rootCanonical, allow, opts) {
|
|
|
809
785
|
},
|
|
810
786
|
});
|
|
811
787
|
}
|
|
812
|
-
export function createEnvTaskOutputTool(env) {
|
|
813
|
-
return defineTool({
|
|
814
|
-
name: TASK_OUTPUT_TOOL_NAME,
|
|
815
|
-
...toolFace("task-output-hands"),
|
|
816
|
-
ruleFace: mountRuleFace("task-output-hands"),
|
|
817
|
-
description: composeTaskOutputDescription(ENV_DIRECT_TASK_TOOL_CAPS),
|
|
818
|
-
parameters: composeTaskOutputParams(ENV_DIRECT_TASK_TOOL_CAPS),
|
|
819
|
-
execute: async (args) => {
|
|
820
|
-
const { task_id, filter } = args;
|
|
821
|
-
const id = resolveTaskIdArg(task_id);
|
|
822
|
-
if (!id)
|
|
823
|
-
return errorResult(TASK_OUTPUT_MISSING_ID_MESSAGE);
|
|
824
|
-
if (!hasBackgroundShell(env)) {
|
|
825
|
-
return errorResult("Error (TaskOutput): this environment does not support background processes.");
|
|
826
|
-
}
|
|
827
|
-
let rx;
|
|
828
|
-
if (filter !== undefined) {
|
|
829
|
-
try {
|
|
830
|
-
rx = new RegExp(filter);
|
|
831
|
-
}
|
|
832
|
-
catch {
|
|
833
|
-
return errorResult(`Error (TaskOutput): invalid filter regex: ${filter}`);
|
|
834
|
-
}
|
|
835
|
-
}
|
|
836
|
-
const r = await env.pollBackground(id);
|
|
837
|
-
if (!r.ok)
|
|
838
|
-
return errorResult(`Error (TaskOutput): could not read ${id} (${r.error.code}): ${envErrorDetail(r.error.message)}`);
|
|
839
|
-
const shape = (text) => clipShellOutput(rx ? text.split(/\r?\n/).filter((l) => rx.test(l)).join("\n") : text);
|
|
840
|
-
const status = r.value.status === "exited" ? `exited(code ${r.value.exitCode})` : r.value.status;
|
|
841
|
-
const dropAcct = {};
|
|
842
|
-
accountDroppedBytes(dropAcct, r.value);
|
|
843
|
-
const droppedNote = spoolDropNote(dropAcct);
|
|
844
|
-
const body = `status: ${status}\n${droppedNote}--- new stdout ---\n${shape(r.value.stdout) || "(none)"}\n` +
|
|
845
|
-
`--- new stderr ---\n${shape(r.value.stderr) || "(none)"}`;
|
|
846
|
-
return delimitUntrusted(`TaskOutput ${id}`, body);
|
|
847
|
-
},
|
|
848
|
-
});
|
|
849
|
-
}
|
|
850
|
-
export function createEnvTaskStopTool(env, registry = defaultTaskRegistry) {
|
|
851
|
-
return defineTool({
|
|
852
|
-
name: TASK_STOP_TOOL_NAME,
|
|
853
|
-
...toolFace("task-stop-hands"),
|
|
854
|
-
ruleFace: mountRuleFace("task-stop-hands"),
|
|
855
|
-
description: composeTaskStopDescription(ENV_DIRECT_TASK_TOOL_CAPS),
|
|
856
|
-
parameters: TASK_STOP_PARAMS,
|
|
857
|
-
execute: async (args) => {
|
|
858
|
-
const { task_id, shell_id } = args;
|
|
859
|
-
const id = resolveTaskIdArg(task_id, shell_id);
|
|
860
|
-
if (!id)
|
|
861
|
-
return errorResult(TASK_STOP_MISSING_ID_MESSAGE);
|
|
862
|
-
if (!hasBackgroundShell(env)) {
|
|
863
|
-
return errorResult("Error (TaskStop): this environment does not support background processes.");
|
|
864
|
-
}
|
|
865
|
-
registry.markStopSourceByShellId(id, "parent", env);
|
|
866
|
-
const r = await env.killBackground(id);
|
|
867
|
-
if (!r.ok) {
|
|
868
|
-
registry.clearPendingStopSourceByShellId(id, "parent", env);
|
|
869
|
-
return errorResult(`${id} is unknown or has already ended.`);
|
|
870
|
-
}
|
|
871
|
-
return `Terminated ${id}.`;
|
|
872
|
-
},
|
|
873
|
-
});
|
|
874
|
-
}
|
package/dist/tools/fs/fs-pdf.js
CHANGED
|
@@ -3,6 +3,7 @@ import { resolveImageProcessor } from "../../core/image-downsample.js";
|
|
|
3
3
|
import { PDF_FALLBACK_RENDER_PAGES, PDF_INLINE_PAGE_THRESHOLD, PDF_MAX_EXTRACT_SIZE, PDF_MAX_PAGES_PER_READ, extractPdfPagesAsImages, extractPdfTextLayer, getPdfPageCount, parsePdfPageRange, pdfCutWords, } from "./pdf.js";
|
|
4
4
|
import { admitImageBytes, IMAGE_ADMISSION, PDF_TARGET_RAW_SIZE, pdfMagicMatches, unprocessedSizeClause } from "../../core/image-admission.js";
|
|
5
5
|
import { enoentMessage, MAX_READ_BYTES } from "./fs-shared.js";
|
|
6
|
+
import { readFloorSeat } from "./read-floor.js";
|
|
6
7
|
import { planReminderDisclosure, renderReminderDisclosureTrailer } from "../../core/reminder-disclosure.js";
|
|
7
8
|
import { MARKED_BLOCK_AFTER_DATA } from "../../core/reminder-mint.js";
|
|
8
9
|
function pdfDisclosureTrailer(body, d) {
|
|
@@ -47,6 +48,7 @@ function boundPdfExtractedText(text) {
|
|
|
47
48
|
}
|
|
48
49
|
export async function readPdfFile(env, path, key, pages, signal, imageProcessor, cwd, preRead, caps, readDeny, disclosure) {
|
|
49
50
|
const cap = caps ?? { document: true, vision: true };
|
|
51
|
+
const readFloor = readFloorSeat(readDeny)?.(undefined);
|
|
50
52
|
const meta = await env.fileInfo(key, signal);
|
|
51
53
|
if (!meta.ok) {
|
|
52
54
|
const ex = await env.exists(key, signal);
|
|
@@ -76,7 +78,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
76
78
|
if (range.last !== Infinity && range.last - range.first + 1 > PDF_MAX_PAGES_PER_READ) {
|
|
77
79
|
return `Error (Read): Page range "${pages}" exceeds maximum of ${PDF_MAX_PAGES_PER_READ} pages per request. Please use a smaller range.`;
|
|
78
80
|
}
|
|
79
|
-
const pageCount = await getPdfPageCount(env, key, bytes, signal);
|
|
81
|
+
const pageCount = await getPdfPageCount(env, key, bytes, signal, readFloor);
|
|
80
82
|
if (pageCount !== undefined && range.first > pageCount) {
|
|
81
83
|
return `Error (Read): page range "${pages}" starts past the end of the PDF (${pageCount} page${pageCount === 1 ? "" : "s"}).`;
|
|
82
84
|
}
|
|
@@ -84,7 +86,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
84
86
|
if (pageCount !== undefined)
|
|
85
87
|
last = Math.min(last, pageCount);
|
|
86
88
|
if (!cap.document && !cap.vision) {
|
|
87
|
-
const t = await extractPdfTextLayer(env, key, { first: range.first, last }, signal);
|
|
89
|
+
const t = await extractPdfTextLayer(env, key, { first: range.first, last }, signal, readFloor);
|
|
88
90
|
if (t.ok) {
|
|
89
91
|
const { body, truncated } = boundPdfExtractedText(t.text);
|
|
90
92
|
const words = t.cut !== undefined ? pdfCutWords(t.cut) : undefined;
|
|
@@ -122,7 +124,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
122
124
|
},
|
|
123
125
|
};
|
|
124
126
|
}
|
|
125
|
-
const extract = await extractPdfPagesAsImages(env, key, range.first, last, signal);
|
|
127
|
+
const extract = await extractPdfPagesAsImages(env, key, range.first, last, signal, readFloor);
|
|
126
128
|
if (!extract.ok) {
|
|
127
129
|
if (extract.toolMissing) {
|
|
128
130
|
return (`Error (Read): reading a PDF page range requires the poppler utility \`pdftoppm\`, which is not available in this environment. ` +
|
|
@@ -160,7 +162,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
160
162
|
},
|
|
161
163
|
};
|
|
162
164
|
}
|
|
163
|
-
const pageCount = await getPdfPageCount(env, key, bytes, signal);
|
|
165
|
+
const pageCount = await getPdfPageCount(env, key, bytes, signal, readFloor);
|
|
164
166
|
if (pageCount !== undefined && pageCount > PDF_INLINE_PAGE_THRESHOLD) {
|
|
165
167
|
return `Error (Read): This PDF has ${pageCount} pages, which is too many to read at once. Use the pages parameter to read specific page ranges (e.g., pages: "1-5"). Maximum ${PDF_MAX_PAGES_PER_READ} pages per request.`;
|
|
166
168
|
}
|
|
@@ -169,7 +171,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
169
171
|
}
|
|
170
172
|
if (!cap.document) {
|
|
171
173
|
const fileCard = { type: "application/pdf", originalSize: size, ...(pageCount !== undefined ? { pageCount } : {}) };
|
|
172
|
-
const t = await extractPdfTextLayer(env, key, undefined, signal);
|
|
174
|
+
const t = await extractPdfTextLayer(env, key, undefined, signal, readFloor);
|
|
173
175
|
if (t.ok) {
|
|
174
176
|
const { body, truncated } = boundPdfExtractedText(t.text);
|
|
175
177
|
const words = t.cut !== undefined ? pdfCutWords(t.cut) : undefined;
|
|
@@ -195,7 +197,7 @@ export async function readPdfFile(env, path, key, pages, signal, imageProcessor,
|
|
|
195
197
|
let renderWhy;
|
|
196
198
|
if (cap.vision) {
|
|
197
199
|
const n = Math.min(PDF_FALLBACK_RENDER_PAGES, pageCount ?? PDF_FALLBACK_RENDER_PAGES);
|
|
198
|
-
const extract = await extractPdfPagesAsImages(env, key, 1, n, signal);
|
|
200
|
+
const extract = await extractPdfPagesAsImages(env, key, 1, n, signal, readFloor);
|
|
199
201
|
if (extract.ok) {
|
|
200
202
|
const blocks = await pdfPagesToImageBlocks(extract.pages, path, imageProcessor);
|
|
201
203
|
if (typeof blocks !== "string") {
|
package/dist/tools/fs/fs-read.js
CHANGED
|
@@ -5,7 +5,7 @@ import { decodeTextBytes } from "./encoding.js";
|
|
|
5
5
|
import { isNotebookPath, parseNotebookCells, renderNotebookCells, stripNotebookImageData, NOTEBOOK_IMAGE_BASE64_BUDGET } from "./notebook.js";
|
|
6
6
|
import { resolveImageProcessor } from "../../core/image-downsample.js";
|
|
7
7
|
import { countPdfPagesFromBytes, PDF_MAX_PAGES_PER_READ } from "./pdf.js";
|
|
8
|
-
import { MAX_READ_BYTES, SLICED_READ_MAX_BYTES,
|
|
8
|
+
import { MAX_READ_BYTES, SLICED_READ_MAX_BYTES, noProcessorImageCapHint, MAX_READ_OUTPUT_CHARS, FILE_PATH_PARAMS, countLines, seededFileUnchangedReminder, enoentMessage, } from "./fs-shared.js";
|
|
9
9
|
import { readPdfFile } from "./fs-pdf.js";
|
|
10
10
|
import { seatForCall, seatReady } from "./read-deny.js";
|
|
11
11
|
import { thrownText } from "../../core/thrown-value.js";
|
|
@@ -93,7 +93,7 @@ export function createModelFileReader(opts) {
|
|
|
93
93
|
}
|
|
94
94
|
const processor = await resolveImageProcessor(imageProcessor);
|
|
95
95
|
const readCap = imageReadCap(processor);
|
|
96
|
-
const noProcessorHint = processor === "none" ? ` ${
|
|
96
|
+
const noProcessorHint = processor === "none" ? ` ${noProcessorImageCapHint(imageProcessor)}` : "";
|
|
97
97
|
const tooLargeToRead = (bytes) => `Error (Read): image "${path}" is too large to read (${bytes} bytes > ${readCap}-byte cap).${noProcessorHint}`;
|
|
98
98
|
if (meta.value.size > readCap)
|
|
99
99
|
return refuse(errorResult(tooLargeToRead(meta.value.size)), "image");
|