@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
package/dist/tools/fs/fs-read.js
CHANGED
|
@@ -3,9 +3,9 @@ import { defineTool, errorResult } from "../../core/tools.js";
|
|
|
3
3
|
import { sha256, resolveKey, violationText, violationDetails, binaryMagicFormat, hasBinaryExtension, isBinaryContent, imageMimeForRead, } from "./safety.js";
|
|
4
4
|
import { decodeTextBytes } from "./encoding.js";
|
|
5
5
|
import { isNotebookPath, parseNotebookCells, renderNotebookCells, stripNotebookImageData, NOTEBOOK_IMAGE_BASE64_BUDGET } from "./notebook.js";
|
|
6
|
-
import {
|
|
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";
|
|
@@ -13,14 +13,28 @@ import { MARKED_BLOCK_AFTER_DATA, openSystemReminder } from "../../core/reminder
|
|
|
13
13
|
import { planReminderDisclosure, commitReminderDisclosureEffects, renderReminderDisclosureTrailer, } from "../../core/reminder-disclosure.js";
|
|
14
14
|
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
15
15
|
import { fileArgPath } from "../../core/tool-registry.js";
|
|
16
|
-
import { admitImageBytes, imageReadCap, PDF_TARGET_RAW_SIZE, pdfMagicMatches } from "../../core/image-admission.js";
|
|
16
|
+
import { admitImageBytes, IMAGE_ADMISSION, imageReadCap, PDF_TARGET_RAW_SIZE, pdfMagicMatches, unprocessedSizeClause } from "../../core/image-admission.js";
|
|
17
17
|
import { createEntryDenyJudge, enumerateDirectory } from "./dir-entries.js";
|
|
18
18
|
import { FileError } from "../../internal/harness.js";
|
|
19
19
|
export const READ_OUTCOMES = Object.freeze(["attached", "partial", "unchanged", "not_attached"]);
|
|
20
20
|
const UNBINDABLE = "this environment cannot bind a read to the file that was checked, so it was not read";
|
|
21
21
|
const NO_EFFECTS = () => ({ disclosure: [] });
|
|
22
|
+
async function admitNotebookImages(blocks, imageProcessor) {
|
|
23
|
+
if (!blocks.some((b) => b.type === "image"))
|
|
24
|
+
return blocks;
|
|
25
|
+
const processor = await resolveImageProcessor(imageProcessor);
|
|
26
|
+
return Promise.all(blocks.map(async (b) => {
|
|
27
|
+
if (b.type !== "image")
|
|
28
|
+
return b;
|
|
29
|
+
const a = await admitImageBytes(Buffer.from(b.data, "base64"), b.mimeType, processor);
|
|
30
|
+
if (a.ok)
|
|
31
|
+
return a.block;
|
|
32
|
+
const why = a.reason === "dimensions_unreadable" || a.reason === "dimensions_too_large" ? `: ${unprocessedSizeClause(a)}` : "";
|
|
33
|
+
return { type: "text", text: `[image output not shown (media admission: ${a.reason})${why}]` };
|
|
34
|
+
}));
|
|
35
|
+
}
|
|
22
36
|
export function createModelFileReader(opts) {
|
|
23
|
-
const { env, state, rootCanonical, cwdRef,
|
|
37
|
+
const { env, state, rootCanonical, cwdRef, imageProcessor, pdfCapabilities, bgOutputReadExemption, readFace, reminderMark, readDeny: readDenySeat, additionalRoots: rootsSeat } = opts;
|
|
24
38
|
const windows = opts.disclosureWindows ?? new Map();
|
|
25
39
|
const refuse = (envelope, kind) => ({
|
|
26
40
|
outcome: "not_attached",
|
|
@@ -77,16 +91,16 @@ export function createModelFileReader(opts) {
|
|
|
77
91
|
return refuse(errorResult(`Error (Read): ${await enoentMessage(env, r.key, cwdRef?.current ?? rootCanonical, ctx.signal, readDeny)}`), "image");
|
|
78
92
|
return refuse(errorResult(`Error (Read): cannot stat image "${path}" to verify its size before reading: ${meta.error.message}`), "image");
|
|
79
93
|
}
|
|
80
|
-
const
|
|
81
|
-
const readCap = imageReadCap(
|
|
82
|
-
const
|
|
83
|
-
|
|
94
|
+
const processor = await resolveImageProcessor(imageProcessor);
|
|
95
|
+
const readCap = imageReadCap(processor);
|
|
96
|
+
const noProcessorHint = processor === "none" ? ` ${noProcessorImageCapHint(imageProcessor)}` : "";
|
|
97
|
+
const tooLargeToRead = (bytes) => `Error (Read): image "${path}" is too large to read (${bytes} bytes > ${readCap}-byte cap).${noProcessorHint}`;
|
|
84
98
|
if (meta.value.size > readCap)
|
|
85
99
|
return refuse(errorResult(tooLargeToRead(meta.value.size)), "image");
|
|
86
100
|
const bin = await readBytes(r.key, readCap);
|
|
87
101
|
if (!bin.ok)
|
|
88
102
|
return refuse(errorResult(`Error (Read): cannot read image "${path}": ${bin.error.message}`), "image");
|
|
89
|
-
const admitted = await admitImageBytes(bin.value, imageMime,
|
|
103
|
+
const admitted = await admitImageBytes(bin.value, imageMime, processor);
|
|
90
104
|
if (!admitted.ok) {
|
|
91
105
|
switch (admitted.reason) {
|
|
92
106
|
case "raw_too_large":
|
|
@@ -94,11 +108,14 @@ export function createModelFileReader(opts) {
|
|
|
94
108
|
case "magic_mismatch":
|
|
95
109
|
case "mime_unsupported":
|
|
96
110
|
return refuse(errorResult(`Error (Read): "${path}" has an image extension but its content is not a valid ${imageMime} (empty, truncated, or mis-named).`), "image");
|
|
111
|
+
case "dimensions_unreadable":
|
|
112
|
+
case "dimensions_too_large":
|
|
113
|
+
return refuse(errorResult(`Error (Read): image "${path}" cannot be sent: ${unprocessedSizeClause(admitted)}.${noProcessorHint}`), "image");
|
|
97
114
|
case "base64_too_large":
|
|
98
|
-
return refuse(errorResult(`Error (Read): image "${path}" is too large to send (${bin.value.byteLength} bytes; base64 ${admitted.base64.length} chars exceeds the ${
|
|
99
|
-
(
|
|
100
|
-
? ";
|
|
101
|
-
: `; raw images over ${
|
|
115
|
+
return refuse(errorResult(`Error (Read): image "${path}" is too large to send (${bin.value.byteLength} bytes; base64 ${admitted.base64.length} chars exceeds the ${IMAGE_ADMISSION.hard.imageBase64Chars}-char / 5MB API image limit` +
|
|
116
|
+
(processor !== "none"
|
|
117
|
+
? "; processing could not bring it under the limit)."
|
|
118
|
+
: `; raw images over ${IMAGE_ADMISSION.soft.rawBytes} bytes always exceed it — shrink it first, e.g. with an image tool via bash).`)), "image");
|
|
102
119
|
}
|
|
103
120
|
}
|
|
104
121
|
const { block, dimensions, originalSize, resized } = admitted;
|
|
@@ -135,7 +152,7 @@ export function createModelFileReader(opts) {
|
|
|
135
152
|
};
|
|
136
153
|
}
|
|
137
154
|
const effects = [];
|
|
138
|
-
const out = await readPdfFile(env, path, r.key, pages, ctx.signal,
|
|
155
|
+
const out = await readPdfFile(env, path, r.key, pages, ctx.signal, imageProcessor, cwdRef?.current ?? rootCanonical, preRead, pdfCapabilities, readDeny, {
|
|
139
156
|
mark: reminderMark,
|
|
140
157
|
windows,
|
|
141
158
|
key: r.key,
|
|
@@ -195,7 +212,7 @@ export function createModelFileReader(opts) {
|
|
|
195
212
|
`this tool reads UTF-8 and BOM-marked UTF-16LE text only. Inspect or convert it with bash instead.`), "text");
|
|
196
213
|
}
|
|
197
214
|
const decoded = decodeTextBytes(readBin.value);
|
|
198
|
-
if (decoded.malformed) {
|
|
215
|
+
if (decoded.malformed === "truncated_utf16") {
|
|
199
216
|
return refuse(errorResult(`Error (Read): "${path}" has a UTF-16 BOM but a truncated (odd-length) body — the file is corrupt or mis-labelled; repair/convert it with bash (e.g. \`iconv\`) first.`), "text");
|
|
200
217
|
}
|
|
201
218
|
const content = decoded.text;
|
|
@@ -249,7 +266,7 @@ export function createModelFileReader(opts) {
|
|
|
249
266
|
return {
|
|
250
267
|
outcome: "attached",
|
|
251
268
|
kind: "notebook",
|
|
252
|
-
data: rendered.blocks,
|
|
269
|
+
data: await admitNotebookImages(rendered.blocks, imageProcessor),
|
|
253
270
|
notes,
|
|
254
271
|
details: { type: "notebook", file: { filePath: path, cells: parsed.cells.map(stripNotebookImageData) } },
|
|
255
272
|
observation,
|
|
@@ -435,14 +452,14 @@ export function renderReadToolResult(r, mark) {
|
|
|
435
452
|
}
|
|
436
453
|
}
|
|
437
454
|
}
|
|
438
|
-
export function createReadFileTool(env, state, rootCanonical, cwdRef, additionalRoots,
|
|
455
|
+
export function createReadFileTool(env, state, rootCanonical, cwdRef, additionalRoots, imageProcessor, pdfCapabilities, bgOutputReadExemption, readDeny, readFace, reminderMark, reminderDisclosureCounts, sharedReader) {
|
|
439
456
|
const reader = sharedReader ?? createModelFileReader({
|
|
440
457
|
env,
|
|
441
458
|
state,
|
|
442
459
|
rootCanonical,
|
|
443
460
|
...(cwdRef !== undefined ? { cwdRef } : {}),
|
|
444
461
|
...(additionalRoots !== undefined ? { additionalRoots } : {}),
|
|
445
|
-
|
|
462
|
+
imageProcessor,
|
|
446
463
|
...(pdfCapabilities !== undefined ? { pdfCapabilities } : {}),
|
|
447
464
|
...(bgOutputReadExemption !== undefined ? { bgOutputReadExemption } : {}),
|
|
448
465
|
...(readDeny !== undefined ? { readDeny } : {}),
|
|
@@ -3,6 +3,7 @@ import { defineTool, errorResult } from "../../core/tools.js";
|
|
|
3
3
|
import { clipSpelling, pathFamilyOf, resolveKey, violationText, violationDetails, WIN32_NAMESPACE_REFUSAL_TEXT } from "./safety.js";
|
|
4
4
|
import { runGrepDetailed, runGlobDetailed, invalidGlobTokens } from "./search.js";
|
|
5
5
|
import { seatForCall } from "./read-deny.js";
|
|
6
|
+
import { readFloorSeat } from "./read-floor.js";
|
|
6
7
|
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
7
8
|
import { pathTargetBaseOf, splitAbsoluteGlobPattern } from "../../core/effective-path-target.js";
|
|
8
9
|
import { pathTargetValue } from "../../core/tool-registry.js";
|
|
@@ -77,6 +78,7 @@ export function grepDetailFields(text, mode, offset, structuredRows) {
|
|
|
77
78
|
}
|
|
78
79
|
export function createGrepTool(env, rootCanonical, rootsSeat, denySeat, readFace, cwdRef, readAdmission) {
|
|
79
80
|
const declaredTarget = toolFace("grep").pathTarget;
|
|
81
|
+
const grepReadFloor = readFloorSeat(denySeat);
|
|
80
82
|
return defineTool({
|
|
81
83
|
name: "Grep",
|
|
82
84
|
...toolFace("grep"),
|
|
@@ -115,6 +117,7 @@ export function createGrepTool(env, rootCanonical, rootsSeat, denySeat, readFace
|
|
|
115
117
|
execute: async (args, ctx) => {
|
|
116
118
|
const readDeny = seatForCall(denySeat, ctx.toolCallId);
|
|
117
119
|
const additionalRoots = seatForCall(rootsSeat, ctx.toolCallId);
|
|
120
|
+
const readFloor = grepReadFloor?.(ctx.toolCallId);
|
|
118
121
|
const retired = args;
|
|
119
122
|
for (const [name, repair] of [
|
|
120
123
|
["regex", "the `pattern` is ALWAYS evaluated as a regular expression (ripgrep semantics) — drop the key; to match text literally, escape the regex metacharacters in `pattern`"],
|
|
@@ -167,7 +170,7 @@ export function createGrepTool(env, rootCanonical, rootsSeat, denySeat, readFace
|
|
|
167
170
|
context_before: a.context_before ?? a["-B"],
|
|
168
171
|
ignore_case: a.ignore_case ?? a["-i"],
|
|
169
172
|
only_matching: a.only_matching ?? a["-o"],
|
|
170
|
-
}, ctx.signal, readDeny);
|
|
173
|
+
}, ctx.signal, readDeny, readFloor);
|
|
171
174
|
const text = grepRun.text;
|
|
172
175
|
if (text.startsWith("Error (grep)") || text.startsWith("Error (Grep)"))
|
|
173
176
|
return errorResult(text);
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { Type } from "typebox";
|
|
2
2
|
import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
3
3
|
import { type FsViolation, type ReadEntry, type ReadFileState } from "./safety.js";
|
|
4
|
-
import { type DecodedTextFile } from "./encoding.js";
|
|
4
|
+
import { type DecodedTextFile, type MalformedBody } from "./encoding.js";
|
|
5
5
|
import { type HomeViewsCarrier } from "./read-deny-home.js";
|
|
6
|
-
import {
|
|
6
|
+
import type { ImageDownsampler } from "../../core/image-downsample.js";
|
|
7
7
|
import { type EngineNotice } from "../../core/types.js";
|
|
8
8
|
/**
|
|
9
9
|
* The "hand" tool band — built per task over an injected {@link ExecutionEnv} and a per-task
|
|
@@ -60,6 +60,11 @@ export declare function tooLargeToEditMessage(path: string, bytes: number): stri
|
|
|
60
60
|
/** The truncated-UTF-16 repair instruction, parameterized by the tool that refused. The condition is one
|
|
61
61
|
* condition — an odd-length UTF-16 body cannot be decoded — reached from Edit, Write and NotebookEdit. */
|
|
62
62
|
export declare function truncatedUtf16BodyMessage(tool: string, path: string): string;
|
|
63
|
+
/** The refusal of a body that is not valid UTF-8 (`not_utf8`), parameterized by the tool that refused: nothing was written,
|
|
64
|
+
* and the ways to make the change without converting the file. */
|
|
65
|
+
export declare function notUtf8BodyMessage(tool: string, path: string): string;
|
|
66
|
+
/** The write lanes' one refusal of a body they cannot write back byte for byte, by why ({@link MalformedBody}). */
|
|
67
|
+
export declare function malformedBodyMessage(tool: string, path: string, why: MalformedBody): string;
|
|
63
68
|
/** Why a bash_readonly refusal is terminal rather than escalated. Appended by every arm of that refusal
|
|
64
69
|
* family; the arms differ in what they found, never in what the model can do about it. */
|
|
65
70
|
export declare const BASH_READONLY_CONFINEMENT_NOTE = "bash_readonly is confined to the workspace roots; it has no approval path, so the call is refused rather than escalated.";
|
|
@@ -111,18 +116,36 @@ export declare function applyRecordedEdit(text: string, edit: RecordedEdit): str
|
|
|
111
116
|
* both sharper shapes describe files Read handled successfully, so the encoding-deadlock sentence
|
|
112
117
|
* would be false there — and stacking two escape routes on one refusal buries the one that applies. */
|
|
113
118
|
export declare function notReadRefusalText(env: ExecutionEnv, toolName: string, key: string, v: Pick<FsViolation, "code" | "message" | "partialView">, signal?: AbortSignal, fallbackHint?: string): Promise<string>;
|
|
114
|
-
/** The no-
|
|
115
|
-
* read like a hard ceiling. Whether the higher cap is reachable depends on an OPTIONAL dependency the
|
|
119
|
+
/** The no-processor read cap (`IMAGE_ADMISSION.hard.readBytes.withoutProcessor`) is a DELIBERATE bound and does not move — but its
|
|
120
|
+
* refusal must not read like a hard ceiling. Whether the higher cap is reachable depends on an OPTIONAL dependency the
|
|
116
121
|
* caller can install, and only this package knows that, so the refusal names the move instead of
|
|
117
|
-
* leaving the caller to guess that the limit is negotiable. Appended ONLY on the no-
|
|
118
|
-
* branch: with
|
|
119
|
-
export declare const NO_DOWNSAMPLER_IMAGE_CAP_HINT
|
|
120
|
-
/**
|
|
121
|
-
*
|
|
122
|
-
export
|
|
123
|
-
/**
|
|
124
|
-
*
|
|
125
|
-
|
|
122
|
+
* leaving the caller to guess that the limit is negotiable. Appended ONLY on the no-processor
|
|
123
|
+
* branch: with a processor already resolved the hint would be false advice. */
|
|
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;
|
|
126
149
|
/** Output-token cap as a char proxy (CC's 25000, at ~4 chars/token). Caps the shown body so 2000 very
|
|
127
150
|
* long lines cannot blow the context budget.
|
|
128
151
|
*
|
|
@@ -258,7 +281,7 @@ export declare function coerceWriteArguments(args: unknown): unknown;
|
|
|
258
281
|
* marker, because the head AND tail both matter for a shell. Kept as the inline shape even beside the
|
|
259
282
|
* file-backed recovery below — unlike a background task's poll-for-the-latest-tail interaction, a
|
|
260
283
|
* foreground command's head can carry status a bare tail-keep would drop. Shared by runShell
|
|
261
|
-
* (foreground)
|
|
284
|
+
* (foreground). Delegates its arithmetic to the shared
|
|
262
285
|
* {@link clipWithFilePointer} but never exercises its pointer arm — no caller here passes a path. */
|
|
263
286
|
export declare function clipShellOutput(s: string): string;
|
|
264
287
|
/**
|
|
@@ -273,12 +296,12 @@ export declare function clipShellOutput(s: string): string;
|
|
|
273
296
|
* fired, so nothing here overclaims completeness beyond what the text itself already discloses. Purely
|
|
274
297
|
* ADDITIVE: the inline head+tail framing above is untouched; this only gives the model a second, explicit
|
|
275
298
|
* route to the bytes that framing dropped. Writes BOTH streams (not just the one that overflowed) to ONE
|
|
276
|
-
* combined file — same shape
|
|
299
|
+
* combined file — same shape a background command's A5 output file uses (`stdout + stderr`, single pointer) — so the
|
|
277
300
|
* model gets one path regardless of which stream tripped the clip. Uses `env.createTempFile`/`writeFile`/
|
|
278
301
|
* `canonicalPath` — the standard `FileSystem` primitives every {@link ExecutionEnv} backend implements —
|
|
279
302
|
* NOT the Node env's internal exec spool, so this works uniformly across backends, not just the Node adapter.
|
|
280
303
|
*
|
|
281
|
-
* 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
|
|
282
305
|
* exemption is keyed off a TaskRegistry `background_bash` row with a live lifecycle (owner/scope/session
|
|
283
306
|
* visibility, membership dies with the row) — a one-shot foreground command has no such row, and building
|
|
284
307
|
* one purely to carry a read-exemption would be a parallel, un-owned lifecycle with no natural teardown.
|
|
@@ -5,8 +5,7 @@ import { decodeTextBytes, normalizeFileText } from "./encoding.js";
|
|
|
5
5
|
import { shellQuote } from "./search.js";
|
|
6
6
|
import { isNotebookPath } from "./notebook.js";
|
|
7
7
|
import { homeViewsOf } from "./read-deny-home.js";
|
|
8
|
-
import {
|
|
9
|
-
import { MAX_IMAGE_DOWNSAMPLE_INPUT_BYTES } from "../../core/image-admission.js";
|
|
8
|
+
import { IMAGE_ADMISSION } from "../../core/image-admission.js";
|
|
10
9
|
import { deliverEngineNotice } from "../../core/types.js";
|
|
11
10
|
import { resolveEnvBudget } from "../../core/env-budget.js";
|
|
12
11
|
import { openSystemReminder } from "../../core/reminder-mint.js";
|
|
@@ -38,6 +37,15 @@ export function tooLargeToEditMessage(path, bytes) {
|
|
|
38
37
|
export function truncatedUtf16BodyMessage(tool, path) {
|
|
39
38
|
return `Error (${tool}): "${path}" has a truncated UTF-16 body; repair/convert it with bash first.`;
|
|
40
39
|
}
|
|
40
|
+
export function notUtf8BodyMessage(tool, path) {
|
|
41
|
+
return (`Error (${tool}): "${path}" is not valid UTF-8: it uses an older encoding such as Windows-1252, Shift-JIS or GBK, or it is binary. ` +
|
|
42
|
+
`These tools write UTF-8 (or UTF-16LE behind its byte-order mark) and never convert a file's encoding on their own, so nothing was written. ` +
|
|
43
|
+
`If the file is text, make the change with a shell command that reads and writes it in its own encoding (iconv), or ask the user whether to convert it to UTF-8 first. ` +
|
|
44
|
+
`To replace the whole file with new UTF-8 text anyway, delete it first, then Write it.`);
|
|
45
|
+
}
|
|
46
|
+
export function malformedBodyMessage(tool, path, why) {
|
|
47
|
+
return why === "truncated_utf16" ? truncatedUtf16BodyMessage(tool, path) : notUtf8BodyMessage(tool, path);
|
|
48
|
+
}
|
|
41
49
|
export const BASH_READONLY_CONFINEMENT_NOTE = "bash_readonly is confined to the workspace roots; it has no approval path, so the call is refused rather than escalated.";
|
|
42
50
|
export function persistedTextOf(encoded) {
|
|
43
51
|
return decodeTextBytes(typeof encoded === "string" ? Buffer.from(encoded, "utf8") : encoded).text;
|
|
@@ -56,10 +64,21 @@ export async function notReadRefusalText(env, toolName, key, v, signal, fallback
|
|
|
56
64
|
return `${base} ${OVERSIZE_READ_ESCAPE_HINT}`;
|
|
57
65
|
return fallbackHint === undefined ? base : `${base} ${fallbackHint}`;
|
|
58
66
|
}
|
|
59
|
-
export const NO_DOWNSAMPLER_IMAGE_CAP_HINT = `Install the optional "sharp" dependency (declared in this package's optionalDependencies) to read images up to ${
|
|
60
|
-
|
|
61
|
-
export function
|
|
62
|
-
return
|
|
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})`;
|
|
63
82
|
}
|
|
64
83
|
export const MAX_READ_OUTPUT_CHARS = 100_000;
|
|
65
84
|
export const BASH_DEFAULT_TIMEOUT_SEC = 120;
|
|
@@ -4,7 +4,7 @@ import { defineTool, errorResult } from "../../core/tools.js";
|
|
|
4
4
|
import { sha256, resolveKey, violationText, violationDetails, requireRead, checkStale, checkEditMatch, checkNoChange, resolveQuoteMatch, adaptNewStringQuotes, resolveEscapeMatch, adaptNewStringEscapes, escapeMatchWasAttempted, ESCAPE_MATCH_MISS_NOTE, deletionOldString, countOccurrences, READ_REFUSED_ESCAPE_HINT, } from "./safety.js";
|
|
5
5
|
import { decodeTextBytes, encodeTextForFile, normalizeEditText, normalizeFileText } from "./encoding.js";
|
|
6
6
|
import { seatForCall } from "./read-deny.js";
|
|
7
|
-
import { MAX_EDIT_BYTES, decodeEditBytes, tooLargeToEditMessage,
|
|
7
|
+
import { MAX_EDIT_BYTES, decodeEditBytes, tooLargeToEditMessage, malformedBodyMessage, persistedTextOf, notReadRefusalText, enoentMessage, FILE_STATE_TRAILER, FILE_PATH_PARAMS, coerceWriteArguments, ipynbRedirect, countLines, applyRecordedEdit, } from "./fs-shared.js";
|
|
8
8
|
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
9
9
|
import { fileArgPath } from "../../core/tool-registry.js";
|
|
10
10
|
import { thrownText } from "../../core/thrown-value.js";
|
|
@@ -209,7 +209,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
209
209
|
return errorResult(preDecResult.message);
|
|
210
210
|
const preDec = preDecResult.value;
|
|
211
211
|
if (preDec.malformed)
|
|
212
|
-
return errorResult(
|
|
212
|
+
return errorResult(malformedBodyMessage("Edit", path, preDec.malformed));
|
|
213
213
|
if (preDec.text.trim() !== "")
|
|
214
214
|
return errorResult(`Error (Edit): Cannot create new file - file already exists.`);
|
|
215
215
|
const priorRead = state.get(r.key);
|
|
@@ -255,7 +255,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
255
255
|
return errorResult(decodedResult.message);
|
|
256
256
|
const decoded = decodedResult.value;
|
|
257
257
|
if (decoded.malformed)
|
|
258
|
-
return errorResult(
|
|
258
|
+
return errorResult(malformedBodyMessage("Edit", path, decoded.malformed));
|
|
259
259
|
const original = decoded.text;
|
|
260
260
|
const entry = state.get(r.key);
|
|
261
261
|
const readWasTruncated = entry?.truncated === true;
|
|
@@ -383,7 +383,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
383
383
|
return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${readBin.error.message}`);
|
|
384
384
|
const decodedPrev = decodeTextBytes(readBin.value);
|
|
385
385
|
if (decodedPrev.malformed)
|
|
386
|
-
return errorResult(
|
|
386
|
+
return errorResult(malformedBodyMessage("Write", path, decodedPrev.malformed));
|
|
387
387
|
const stale = checkStale(state.get(r.key), sha256(decodedPrev.text));
|
|
388
388
|
if (stale)
|
|
389
389
|
return errorResult(violationText("Write", stale));
|
|
@@ -494,7 +494,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
|
|
|
494
494
|
return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${readBin.error.message}`);
|
|
495
495
|
const decodedNb = decodeTextBytes(readBin.value);
|
|
496
496
|
if (decodedNb.malformed)
|
|
497
|
-
return errorResult(
|
|
497
|
+
return errorResult(malformedBodyMessage("NotebookEdit", notebook_path, decodedNb.malformed));
|
|
498
498
|
const nbText = decodedNb.text;
|
|
499
499
|
const stale = checkStale(state.get(r.key), sha256(nbText));
|
|
500
500
|
if (stale)
|
package/dist/tools/fs/index.d.ts
CHANGED
|
@@ -17,7 +17,7 @@ export { BASH_CLASSIFY_EXTRA_ALLOW, bashClassifyDefaultAllow } from "./bash-read
|
|
|
17
17
|
import { type ReadDenyEntry } from "./read-deny.js";
|
|
18
18
|
import { type ContainmentFace } from "./containment-face.js";
|
|
19
19
|
export * from "./containment-face.js";
|
|
20
|
-
import { type CwdRef
|
|
20
|
+
import { type CwdRef } from "./fs-shared.js";
|
|
21
21
|
/** Options for {@link createHandsToolkit}. */
|
|
22
22
|
export interface HandsToolkitOptions {
|
|
23
23
|
/** CC --add-dir parity: extra allowed containment roots (canonical). Widens file-tool containment
|
|
@@ -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). */
|
|
@@ -113,10 +113,9 @@ export interface HandsToolkitOptions {
|
|
|
113
113
|
* console line prints verbatim (last-resort loudness). Threaded per toolkit build — never a
|
|
114
114
|
* global. */
|
|
115
115
|
onNotice?: (n: import("../../core/types.js").EngineNotice) => void;
|
|
116
|
-
/** See createBashTool's taskOpts.oneShot
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
* `mountBackgroundTaskTools: true`) the TaskOutput poll receipt. Absent ⇒ the unbranched wording. */
|
|
116
|
+
/** See createBashTool's taskOpts.oneShot for the full contract: this run has no later turn for an async background
|
|
117
|
+
* notification to land in, and its ending waits for loop-type tasks only — threaded to the Bash background-launch
|
|
118
|
+
* receipt. Absent ⇒ the unbranched wording. */
|
|
120
119
|
oneShot?: boolean;
|
|
121
120
|
/** CC `Zry`/`WZi.#m` parity: see createBashTool's taskOpts field of the same name for the full
|
|
122
121
|
* contract. Threaded from {@link HandsBandOptions.autoBackgroundOnTimeout} (a deployment-level
|
|
@@ -132,9 +131,10 @@ export interface HandsToolkitOptions {
|
|
|
132
131
|
* of the same name. Runner-wired (reads the harness's own accepted-but-unserved account); absent ⇒ the
|
|
133
132
|
* shell never auto-backgrounds a running command, exactly as before. */
|
|
134
133
|
queuedHumanInput?: () => boolean;
|
|
135
|
-
/**
|
|
136
|
-
*
|
|
137
|
-
|
|
134
|
+
/** The run's image processor seat (`RunnerDeps.imageProcessor`), for every image this band hands the model (Read, a
|
|
135
|
+
* rendered PDF page, a Bash data URI): a processor; `false` = none (deterministic no-sharp behavior); undefined =
|
|
136
|
+
* auto-detect the optional sharp dependency once per process. */
|
|
137
|
+
imageProcessor?: import("../../core/image-downsample.js").ImageDownsampler | false;
|
|
138
138
|
/** PDF degradation chain: the SERVING model's PDF capability profile (prepare-task derives it via
|
|
139
139
|
* {@link import("./fs-pdf.js").pdfModelCapabilitiesOf}). A model without native document input gets pdftotext text extraction →
|
|
140
140
|
* rendered page images (vision) → an honest placeholder, instead of a brain-level placeholder. Default
|
|
@@ -180,6 +180,12 @@ export interface HandsToolkitOptions {
|
|
|
180
180
|
* of an inactive tier is a satisfied intent (no-op); a name matching NO table row throws at wiring
|
|
181
181
|
* time (never silently ignored). Deployment seat ONLY, same clamp argument as the tiers key. */
|
|
182
182
|
readDenyBuiltinExclude?: readonly string[];
|
|
183
|
+
/** Mirror of `RunnerDeps.readDenyFloorRequired`, for a band that compiles its OWN table (no Runner face carried):
|
|
184
|
+
* `true` ⇒ building the band throws `config.read_deny_floor_unkept` when that table holds a row and `env` does not
|
|
185
|
+
* declare it keeps the byte floor; absent / `false` ⇒ the same fact is announced once per construction through
|
|
186
|
+
* {@link onNotice}. A non-boolean value throws (`config.read_face_seat`). A band handed the Runner's face judges
|
|
187
|
+
* nothing: the Runner judged that table when it compiled it. */
|
|
188
|
+
readDenyFloorRequired?: boolean;
|
|
183
189
|
/** The spellings of the execution environment's home a home-anchored deny row (`~/…`) is placed under
|
|
184
190
|
* ({@link import("./read-deny-home.js").readDenyHomesOf}: the declared home and the account home, each with its canonical
|
|
185
191
|
* spelling). Absolute path strings only — any other shape throws at wiring time, naming the seat. The Runner passes the
|
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";
|
|
@@ -17,14 +17,14 @@ export { BASH_CLASSIFY_EXTRA_ALLOW, bashClassifyDefaultAllow } from "./bash-read
|
|
|
17
17
|
import { checkedReadDenyHomes, compileReadDeny, compileWriteDeny, readDenyBuiltinConfigOf, readDenyRowAnchor } from "./read-deny.js";
|
|
18
18
|
import { withGateTimeout } from "../../core/gate-bounded-await.js";
|
|
19
19
|
import { carriedReadFaceOf, carryHomeViews, homeViewsAt, placeReadDenyAtHome, placementViewsOf, readDenyPlacedLater, sayPlacementLost } from "./read-deny-home.js";
|
|
20
|
-
import { readFloorSeat } from "./read-floor.js";
|
|
20
|
+
import { judgeReadFloorKept, readFloorSeat, screenReadDenyFloorRequired } from "./read-floor.js";
|
|
21
21
|
import { deploymentFaceClampNotice, resolveContainmentFace } from "./containment-face.js";
|
|
22
22
|
export * from "./containment-face.js";
|
|
23
23
|
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
|
}
|
|
@@ -45,6 +45,9 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
45
45
|
: (canonicalKey, c) => readAdmission?.(c.toolCallId, canonicalKey) === true || (bgOutput?.(canonicalKey, c) ?? false);
|
|
46
46
|
const { readDeny, writeDeny, afterPlacement } = carriedFace !== undefined ? { readDeny: carriedFace.readDeny, writeDeny: carriedFace.writeDeny, afterPlacement: (tool) => tool } : bandOwnTables(env, opts);
|
|
47
47
|
const readFloor = readFloorSeat(readDeny);
|
|
48
|
+
const floorRequired = screenReadDenyFloorRequired(opts.readDenyFloorRequired, "HandsToolkitOptions.readDenyFloorRequired") === true;
|
|
49
|
+
if (carriedFace === undefined)
|
|
50
|
+
judgeReadFloorKept({ env, table: readDeny, floor: readFloor?.(undefined), required: floorRequired, onNotice: opts.onNotice });
|
|
48
51
|
const readFace = resolveContainmentFace({
|
|
49
52
|
kind: "read",
|
|
50
53
|
depsFace: opts.readFace,
|
|
@@ -69,7 +72,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
69
72
|
rootCanonical,
|
|
70
73
|
...(readCwd !== undefined ? { cwdRef: readCwd } : {}),
|
|
71
74
|
...(readFaceRoots !== undefined ? { additionalRoots: readFaceRoots } : {}),
|
|
72
|
-
|
|
75
|
+
imageProcessor: opts.imageProcessor,
|
|
73
76
|
...(opts.pdfModelCapabilities !== undefined ? { pdfCapabilities: opts.pdfModelCapabilities } : {}),
|
|
74
77
|
...(bgOutputReadExemption !== undefined ? { bgOutputReadExemption } : {}),
|
|
75
78
|
...(readDeny !== undefined ? { readDeny } : {}),
|
|
@@ -80,7 +83,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
80
83
|
if (opts.modelFileReaderSeat !== undefined)
|
|
81
84
|
opts.modelFileReaderSeat.current = reader;
|
|
82
85
|
const tools = [
|
|
83
|
-
afterPlacement(createReadFileTool(env, readFileState, rootCanonical, readCwd, readFaceRoots, opts.
|
|
86
|
+
afterPlacement(createReadFileTool(env, readFileState, rootCanonical, readCwd, readFaceRoots, opts.imageProcessor, opts.pdfModelCapabilities, bgOutputReadExemption, readDeny, readFace, opts.reminderMark, opts.reminderDisclosureCounts, reader)),
|
|
84
87
|
];
|
|
85
88
|
if (handsWriteHalfMounts({ readOnly })) {
|
|
86
89
|
tools.push(createEditFileTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny), createWriteFileTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny), createNotebookEditTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny));
|
|
@@ -94,6 +97,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
94
97
|
...(opts.onNotice !== undefined ? { onNotice: opts.onNotice } : {}),
|
|
95
98
|
...(opts.shellReadAdmission !== undefined ? { shellReadAdmission: opts.shellReadAdmission } : {}),
|
|
96
99
|
...(readFloor !== undefined ? { readFloor } : {}),
|
|
100
|
+
...(opts.imageProcessor !== undefined ? { imageProcessor: opts.imageProcessor } : {}),
|
|
97
101
|
...(opts.onToolProgress !== undefined ? { onToolProgress: opts.onToolProgress } : {}),
|
|
98
102
|
})
|
|
99
103
|
: createBashTool(env, rootCanonical, commitCoAuthor, cwdRef, {
|
|
@@ -111,26 +115,16 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
111
115
|
...(additionalRoots !== undefined ? { additionalRoots } : {}),
|
|
112
116
|
...(opts.shellReadAdmission !== undefined ? { shellReadAdmission: opts.shellReadAdmission } : {}),
|
|
113
117
|
...(readFloor !== undefined ? { readFloor } : {}),
|
|
118
|
+
...(opts.imageProcessor !== undefined ? { imageProcessor: opts.imageProcessor } : {}),
|
|
114
119
|
...(opts.bashDefaultTimeoutMs !== undefined ? { bashDefaultTimeoutMs: opts.bashDefaultTimeoutMs } : {}),
|
|
115
120
|
...(opts.bashMaxTimeoutMs !== undefined ? { bashMaxTimeoutMs: opts.bashMaxTimeoutMs } : {}),
|
|
116
121
|
...(opts.onNotice !== undefined ? { onNotice: opts.onNotice } : {}),
|
|
117
122
|
...(opts.monitorToolActive !== undefined ? { monitorToolActive: opts.monitorToolActive } : {}),
|
|
118
123
|
...(opts.reminderMark !== undefined ? { reminderMark: opts.reminderMark } : {}),
|
|
119
124
|
})));
|
|
120
|
-
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env)) {
|
|
125
|
+
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env) && opts.taskRegistry !== undefined) {
|
|
121
126
|
const sessionAxis = opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {};
|
|
122
|
-
tools.push(opts.taskRegistry
|
|
123
|
-
? createTaskOutputTool({
|
|
124
|
-
registry: opts.taskRegistry,
|
|
125
|
-
owner: opts.taskOwner,
|
|
126
|
-
scope: opts.taskScope,
|
|
127
|
-
...sessionAxis,
|
|
128
|
-
...(opts.oneShot !== undefined ? { oneShot: opts.oneShot } : {}),
|
|
129
|
-
notificationWired: opts.taskNotification !== undefined,
|
|
130
|
-
})
|
|
131
|
-
: createEnvTaskOutputTool(env), opts.taskRegistry
|
|
132
|
-
? createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis })
|
|
133
|
-
: createEnvTaskStopTool(env));
|
|
127
|
+
tools.push(createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis }));
|
|
134
128
|
}
|
|
135
129
|
}
|
|
136
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;
|