@sema-agent/core 7.60.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +49 -18
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +2 -1
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +2 -1
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +10 -10
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
package/dist/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");
|
|
@@ -3,6 +3,7 @@ import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
|
3
3
|
import { type FsViolation, type ReadEntry, type ReadFileState } from "./safety.js";
|
|
4
4
|
import { type DecodedTextFile, type MalformedBody } from "./encoding.js";
|
|
5
5
|
import { type HomeViewsCarrier } from "./read-deny-home.js";
|
|
6
|
+
import type { ImageDownsampler } from "../../core/image-downsample.js";
|
|
6
7
|
import { type EngineNotice } from "../../core/types.js";
|
|
7
8
|
/**
|
|
8
9
|
* The "hand" tool band — built per task over an injected {@link ExecutionEnv} and a per-task
|
|
@@ -121,6 +122,30 @@ export declare function notReadRefusalText(env: ExecutionEnv, toolName: string,
|
|
|
121
122
|
* leaving the caller to guess that the limit is negotiable. Appended ONLY on the no-processor
|
|
122
123
|
* branch: with a processor already resolved the hint would be false advice. */
|
|
123
124
|
export declare const NO_DOWNSAMPLER_IMAGE_CAP_HINT: string;
|
|
125
|
+
/** The same refusal when the deployment itself set the processor seat to `false`: installing sharp changes nothing there,
|
|
126
|
+
* so naming it would be a wrong cause. */
|
|
127
|
+
export declare const IMAGE_PROCESSOR_OFF_CAP_HINT: string;
|
|
128
|
+
/** The one place the processor seat's three states pick the no-processor refusal's second sentence: `false` (the deployment
|
|
129
|
+
* turned it off) says so, absent (nothing resolved, so an install is the move) names the optional dependency, and a processor
|
|
130
|
+
* never reaches here — a resolved processor takes no hint. */
|
|
131
|
+
export declare function noProcessorImageCapHint(seat: ImageDownsampler | false | undefined): string;
|
|
132
|
+
/**
|
|
133
|
+
* The sentence a ran-then-cut Bash result ends with when it holds no captured output at all. The execution environment either STATED
|
|
134
|
+
* what it captured before the cut (a string for each of `partialStdout` / `partialStderr`, empty or not) or attached nothing: only the
|
|
135
|
+
* first can say the command wrote nothing, and the second says nothing about it — reading both as "" made a silence nobody observed.
|
|
136
|
+
*
|
|
137
|
+
* With the capture stated, a LONG-lived process that wrote nothing to its stdio is a real, examined phenomenon (capture chain proven
|
|
138
|
+
* live in and out of containers) — the honest reading is "stalled before producing output, or holding it in a block buffer", and saying
|
|
139
|
+
* so turns a dead-end disclosure into an actionable lead. Only on the timeout arm with a substantial window (>= 60s): a short window's
|
|
140
|
+
* silence is ordinary, and the aborted/callback arms don't know how long the process actually lived. A silence cut is the same
|
|
141
|
+
* phenomenon seen from the other side, and its window is by definition the substantial one — no minimum applies; the number is the
|
|
142
|
+
* window, never the request.
|
|
143
|
+
*/
|
|
144
|
+
export declare function zeroOutputSentence(error: {
|
|
145
|
+
code: string;
|
|
146
|
+
partialStdout?: string;
|
|
147
|
+
partialStderr?: string;
|
|
148
|
+
}, timeoutSec: number, noOutputSec: number | undefined): string;
|
|
124
149
|
/** Output-token cap as a char proxy (CC's 25000, at ~4 chars/token). Caps the shown body so 2000 very
|
|
125
150
|
* long lines cannot blow the context budget.
|
|
126
151
|
*
|
|
@@ -256,7 +281,7 @@ export declare function coerceWriteArguments(args: unknown): unknown;
|
|
|
256
281
|
* marker, because the head AND tail both matter for a shell. Kept as the inline shape even beside the
|
|
257
282
|
* file-backed recovery below — unlike a background task's poll-for-the-latest-tail interaction, a
|
|
258
283
|
* foreground command's head can carry status a bare tail-keep would drop. Shared by runShell
|
|
259
|
-
* (foreground)
|
|
284
|
+
* (foreground). Delegates its arithmetic to the shared
|
|
260
285
|
* {@link clipWithFilePointer} but never exercises its pointer arm — no caller here passes a path. */
|
|
261
286
|
export declare function clipShellOutput(s: string): string;
|
|
262
287
|
/**
|
|
@@ -271,12 +296,12 @@ export declare function clipShellOutput(s: string): string;
|
|
|
271
296
|
* fired, so nothing here overclaims completeness beyond what the text itself already discloses. Purely
|
|
272
297
|
* ADDITIVE: the inline head+tail framing above is untouched; this only gives the model a second, explicit
|
|
273
298
|
* route to the bytes that framing dropped. Writes BOTH streams (not just the one that overflowed) to ONE
|
|
274
|
-
* combined file — same shape
|
|
299
|
+
* combined file — same shape a background command's A5 output file uses (`stdout + stderr`, single pointer) — so the
|
|
275
300
|
* model gets one path regardless of which stream tripped the clip. Uses `env.createTempFile`/`writeFile`/
|
|
276
301
|
* `canonicalPath` — the standard `FileSystem` primitives every {@link ExecutionEnv} backend implements —
|
|
277
302
|
* NOT the Node env's internal exec spool, so this works uniformly across backends, not just the Node adapter.
|
|
278
303
|
*
|
|
279
|
-
* Deliberately NOT wired into the Read-tool root-fence exemption (unlike
|
|
304
|
+
* Deliberately NOT wired into the Read-tool root-fence exemption (unlike a background command's A5 file): that
|
|
280
305
|
* exemption is keyed off a TaskRegistry `background_bash` row with a live lifecycle (owner/scope/session
|
|
281
306
|
* visibility, membership dies with the row) — a one-shot foreground command has no such row, and building
|
|
282
307
|
* one purely to carry a read-exemption would be a parallel, un-owned lifecycle with no natural teardown.
|
|
@@ -65,6 +65,21 @@ export async function notReadRefusalText(env, toolName, key, v, signal, fallback
|
|
|
65
65
|
return fallbackHint === undefined ? base : `${base} ${fallbackHint}`;
|
|
66
66
|
}
|
|
67
67
|
export const NO_DOWNSAMPLER_IMAGE_CAP_HINT = `Install the optional "sharp" dependency (declared in this package's optionalDependencies) to read images up to ${IMAGE_ADMISSION.hard.readBytes.withProcessor} bytes — it downsamples them to fit the API image limit.`;
|
|
68
|
+
export const IMAGE_PROCESSOR_OFF_CAP_HINT = `This deployment turned the image processor off: images are not downsampled and are read only up to ${IMAGE_ADMISSION.hard.readBytes.withoutProcessor} bytes — shrink the image first, e.g. with an image tool run in the shell.`;
|
|
69
|
+
export function noProcessorImageCapHint(seat) {
|
|
70
|
+
return seat === false ? IMAGE_PROCESSOR_OFF_CAP_HINT : NO_DOWNSAMPLER_IMAGE_CAP_HINT;
|
|
71
|
+
}
|
|
72
|
+
export function zeroOutputSentence(error, timeoutSec, noOutputSec) {
|
|
73
|
+
if (error.partialStdout === undefined || error.partialStderr === undefined) {
|
|
74
|
+
return "(the execution environment attached no partial output for this cutoff, so whether the command wrote anything before it is not known)";
|
|
75
|
+
}
|
|
76
|
+
const hint = error.code === "liveness_no_output"
|
|
77
|
+
? ` — 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`
|
|
78
|
+
: error.code === "timeout" && timeoutSec >= 60
|
|
79
|
+
? ` — the process ran the full ${timeoutSec}s without writing to its stdio; it may have been stalled before producing output, or holding it in a block buffer`
|
|
80
|
+
: "";
|
|
81
|
+
return `(no output was produced before the cutoff${hint})`;
|
|
82
|
+
}
|
|
68
83
|
export const MAX_READ_OUTPUT_CHARS = 100_000;
|
|
69
84
|
export const BASH_DEFAULT_TIMEOUT_SEC = 120;
|
|
70
85
|
export const BASH_MAX_TIMEOUT_SEC = 600;
|
package/dist/tools/fs/index.d.ts
CHANGED
|
@@ -84,7 +84,7 @@ export interface HandsToolkitOptions {
|
|
|
84
84
|
* receipts) and stamped onto every background row Bash registers (stated). Absent ⇒ not stated: the rows
|
|
85
85
|
* leave the lane to the owning run's teardown. */
|
|
86
86
|
retainBackgroundProcesses?: boolean;
|
|
87
|
-
/** Mount
|
|
87
|
+
/** Mount TaskStop directly from this band (with a registry). Runner sets false and mounts it on the delegation surface once. */
|
|
88
88
|
mountBackgroundTaskTools?: boolean;
|
|
89
89
|
/** Completion-notification sink for finished background commands (threaded to createBashTool's
|
|
90
90
|
* onTaskNotification; the Runner wires the run-local injection lane here). */
|
package/dist/tools/fs/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { deliverEngineNotice } from "../../core/types.js";
|
|
2
|
-
import {
|
|
2
|
+
import { createTaskStopTool } from "../../core/task-registry.js";
|
|
3
3
|
import { hasBackgroundShell } from "../../core/background-shell.js";
|
|
4
4
|
import {} from "./safety.js";
|
|
5
5
|
import { createRepoMapTool } from "./repo-map.js";
|
|
@@ -24,7 +24,7 @@ import {} from "./fs-shared.js";
|
|
|
24
24
|
import { createModelFileReader, createReadFileTool } from "./fs-read.js";
|
|
25
25
|
import { createEditFileTool, createWriteFileTool, createNotebookEditTool } from "./fs-write.js";
|
|
26
26
|
import { createGrepTool, createGlobTool } from "./fs-search-tools.js";
|
|
27
|
-
import { createBashTool, createBashReadonlyTool
|
|
27
|
+
import { createBashTool, createBashReadonlyTool } from "./fs-bash.js";
|
|
28
28
|
export function handsWriteHalfMounts(opts) {
|
|
29
29
|
return opts.readOnly !== true;
|
|
30
30
|
}
|
|
@@ -122,19 +122,9 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
122
122
|
...(opts.monitorToolActive !== undefined ? { monitorToolActive: opts.monitorToolActive } : {}),
|
|
123
123
|
...(opts.reminderMark !== undefined ? { reminderMark: opts.reminderMark } : {}),
|
|
124
124
|
})));
|
|
125
|
-
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env)) {
|
|
125
|
+
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env) && opts.taskRegistry !== undefined) {
|
|
126
126
|
const sessionAxis = opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {};
|
|
127
|
-
tools.push(opts.taskRegistry
|
|
128
|
-
? createTaskOutputTool({
|
|
129
|
-
registry: opts.taskRegistry,
|
|
130
|
-
owner: opts.taskOwner,
|
|
131
|
-
scope: opts.taskScope,
|
|
132
|
-
...sessionAxis,
|
|
133
|
-
notificationWired: opts.taskNotification !== undefined,
|
|
134
|
-
})
|
|
135
|
-
: createEnvTaskOutputTool(env), opts.taskRegistry
|
|
136
|
-
? createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis })
|
|
137
|
-
: createEnvTaskStopTool(env));
|
|
127
|
+
tools.push(createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis }));
|
|
138
128
|
}
|
|
139
129
|
}
|
|
140
130
|
return tools;
|
package/dist/tools/fs/pdf.d.ts
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
* sema follows the same shape with the ExecutionEnv seam (works against remote envs too) and honest
|
|
16
16
|
* degradation when poppler is absent — never a fake success.
|
|
17
17
|
*/
|
|
18
|
-
import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
18
|
+
import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
|
|
19
19
|
/** Max pages a single `pages` request may span (CC `PDF_MAX_PAGES_PER_READ`). */
|
|
20
20
|
export declare const PDF_MAX_PAGES_PER_READ = 20;
|
|
21
21
|
/** Above this page count a whole-PDF read is refused and `pages` is required (CC `PDF_AT_MENTION_INLINE_THRESHOLD`). */
|
|
@@ -48,7 +48,7 @@ export declare function previewExecStream(s: string): string;
|
|
|
48
48
|
* when the tool is absent/fails and the bytes were already read. `undefined` = unknown (fail-open,
|
|
49
49
|
* matching CC's `getPDFPageCount → null`).
|
|
50
50
|
*/
|
|
51
|
-
export declare function getPdfPageCount(env: ExecutionEnv, absPath: string, bytes: Uint8Array | undefined, signal?: AbortSignal): Promise<number | undefined>;
|
|
51
|
+
export declare function getPdfPageCount(env: ExecutionEnv, absPath: string, bytes: Uint8Array | undefined, signal?: AbortSignal, readFloor?: ReadFloor): Promise<number | undefined>;
|
|
52
52
|
/** How many leading pages the vision fallback (level 2) renders for a whole-PDF read on a model without
|
|
53
53
|
* document input — conservative per-request budget; the note directs the model to `pages` for more. */
|
|
54
54
|
export declare const PDF_FALLBACK_RENDER_PAGES = 5;
|
|
@@ -110,7 +110,7 @@ export type PdfTextResult = {
|
|
|
110
110
|
export declare function extractPdfTextLayer(env: ExecutionEnv, absPath: string, range?: {
|
|
111
111
|
first: number;
|
|
112
112
|
last: number;
|
|
113
|
-
}, signal?: AbortSignal): Promise<PdfTextResult>;
|
|
113
|
+
}, signal?: AbortSignal, readFloor?: ReadFloor): Promise<PdfTextResult>;
|
|
114
114
|
export type PdfExtractResult = {
|
|
115
115
|
ok: true;
|
|
116
116
|
pages: Array<{
|
|
@@ -131,4 +131,4 @@ export type PdfExtractResult = {
|
|
|
131
131
|
* 120s timeout). Runs through the ExecutionEnv seam (temp dir + exec + readBinaryFile), so it works
|
|
132
132
|
* wherever the env does. `toolMissing` distinguishes "install poppler" from a real extraction failure.
|
|
133
133
|
*/
|
|
134
|
-
export declare function extractPdfPagesAsImages(env: ExecutionEnv, absPath: string, first: number, last: number, signal?: AbortSignal): Promise<PdfExtractResult>;
|
|
134
|
+
export declare function extractPdfPagesAsImages(env: ExecutionEnv, absPath: string, first: number, last: number, signal?: AbortSignal, readFloor?: ReadFloor): Promise<PdfExtractResult>;
|
package/dist/tools/fs/pdf.js
CHANGED
|
@@ -33,9 +33,9 @@ export function previewExecStream(s) {
|
|
|
33
33
|
? `${s.slice(0, PDF_EXEC_ERROR_PREVIEW_CHARS)} …[${s.length - PDF_EXEC_ERROR_PREVIEW_CHARS} chars truncated]`
|
|
34
34
|
: s;
|
|
35
35
|
}
|
|
36
|
-
export async function getPdfPageCount(env, absPath, bytes, signal) {
|
|
36
|
+
export async function getPdfPageCount(env, absPath, bytes, signal, readFloor) {
|
|
37
37
|
try {
|
|
38
|
-
const r = await env.exec(`pdfinfo ${shellQuote(absPath)}`, { timeout: 10, abortSignal: signal });
|
|
38
|
+
const r = await env.exec(`pdfinfo ${shellQuote(absPath)}`, { timeout: 10, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
39
39
|
if (r.ok && r.value.exitCode === 0) {
|
|
40
40
|
const m = /^Pages:\s+(\d+)/m.exec(r.value.stdout);
|
|
41
41
|
if (m) {
|
|
@@ -67,7 +67,7 @@ export function pdfCutWords(cut) {
|
|
|
67
67
|
return { clause: `timed out after ${cut.sec}s`, noun: "timeout" };
|
|
68
68
|
return { clause: cut.sec !== undefined ? `was cut after producing no output for ${cut.sec}s` : "was cut for producing no output", noun: "cut" };
|
|
69
69
|
}
|
|
70
|
-
export async function extractPdfTextLayer(env, absPath, range, signal) {
|
|
70
|
+
export async function extractPdfTextLayer(env, absPath, range, signal, readFloor) {
|
|
71
71
|
const tmp = await env.createTempDir("sema-pdf-text-", signal);
|
|
72
72
|
if (!tmp.ok)
|
|
73
73
|
return { ok: false, toolMissing: false, error: `cannot create a temp dir for text extraction: ${tmp.error.message}` };
|
|
@@ -78,7 +78,7 @@ export async function extractPdfTextLayer(env, absPath, range, signal) {
|
|
|
78
78
|
return { ok: false, toolMissing: false, error: outR.error.message };
|
|
79
79
|
const rangeArgs = range ? `-f ${range.first} -l ${range.last} ` : "";
|
|
80
80
|
const cmd = `pdftotext -layout ${rangeArgs}${shellQuote(absPath)} ${shellQuote(outR.value)}`;
|
|
81
|
-
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal });
|
|
81
|
+
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
82
82
|
if (!r.ok) {
|
|
83
83
|
if (isTimeCutCode(r.error.code)) {
|
|
84
84
|
const cut = cutOf(r.error);
|
|
@@ -125,7 +125,7 @@ async function listRenderedJpegs(env, dir, signal) {
|
|
|
125
125
|
.sort(),
|
|
126
126
|
};
|
|
127
127
|
}
|
|
128
|
-
export async function extractPdfPagesAsImages(env, absPath, first, last, signal) {
|
|
128
|
+
export async function extractPdfPagesAsImages(env, absPath, first, last, signal, readFloor) {
|
|
129
129
|
const tmp = await env.createTempDir("sema-pdf-pages-", signal);
|
|
130
130
|
if (!tmp.ok)
|
|
131
131
|
return { ok: false, toolMissing: false, error: `cannot create a temp dir for page extraction: ${tmp.error.message}` };
|
|
@@ -135,7 +135,7 @@ export async function extractPdfPagesAsImages(env, absPath, first, last, signal)
|
|
|
135
135
|
if (!prefixR.ok)
|
|
136
136
|
return { ok: false, toolMissing: false, error: prefixR.error.message };
|
|
137
137
|
const cmd = `pdftoppm -jpeg -r 100 -f ${first} -l ${last} ${shellQuote(absPath)} ${shellQuote(prefixR.value)}`;
|
|
138
|
-
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal });
|
|
138
|
+
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
139
139
|
if (!r.ok) {
|
|
140
140
|
if (isTimeCutCode(r.error.code)) {
|
|
141
141
|
const cut = cutOf(r.error);
|
|
@@ -390,6 +390,9 @@ export function readDenyOver(current, homeViews) {
|
|
|
390
390
|
unexcludableUnder: (scope) => current().unexcludableUnder?.(scope) ?? false,
|
|
391
391
|
rowUnderRoot: (scope) => current().rowUnderRoot?.(scope) ?? null,
|
|
392
392
|
rowAtOrBelow: (path) => current().rowAtOrBelow?.(path) ?? null,
|
|
393
|
+
get compiledSegments() {
|
|
394
|
+
return current().compiledSegments;
|
|
395
|
+
},
|
|
393
396
|
homeViews: homeViews ?? { views: (signal) => current().homeViews.views(signal) },
|
|
394
397
|
};
|
|
395
398
|
}
|
|
@@ -411,7 +414,11 @@ export function homeViewsOf(env, judge, signal) {
|
|
|
411
414
|
return (judge?.homeViews ?? homeViewsAt(env, [])).views(signal, env);
|
|
412
415
|
}
|
|
413
416
|
export function carryHomeViews(judge, source) {
|
|
414
|
-
|
|
417
|
+
const carried = { ...judge, homeViews: source };
|
|
418
|
+
const id = judge.id;
|
|
419
|
+
if (typeof id === "string")
|
|
420
|
+
Object.defineProperty(carried, "id", { value: id, enumerable: false });
|
|
421
|
+
return carried;
|
|
415
422
|
}
|
|
416
423
|
export async function placeReadDenyAtHome(env, compile, homes, signal, configRoot) {
|
|
417
424
|
const entries = compile([]).entries;
|