@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
|
@@ -85,6 +85,17 @@ export interface PathRuleDenyRow {
|
|
|
85
85
|
* A leg judges the row where that location LEADS too ({@link withRuleRowsWhereTheyLead}). Absent on a hand-built
|
|
86
86
|
* row, or one whose head cannot be read: it is judged as spelled. */
|
|
87
87
|
readonly head?: string;
|
|
88
|
+
/** The row's reach as a shape an OS confinement translates (the rule model's `pathRuleReachShapeOf`): the absolute
|
|
89
|
+
* location the resolved pattern starts at (`at`, the identity spelling, `/` for the root) and the glob segments after it
|
|
90
|
+
* (`*` within a segment, `**` across segments) — the row reaches every path whose segments below `at` match the globs as
|
|
91
|
+
* a PREFIX (the path the pattern names, and everything below it). Absent on a hand-built row or one whose pattern cannot
|
|
92
|
+
* be resolved: a confinement cannot express it, and a start carrying it is refused. */
|
|
93
|
+
readonly reachShape?: RuleReachShape;
|
|
94
|
+
}
|
|
95
|
+
/** {@link PathRuleDenyRow.reachShape}. */
|
|
96
|
+
export interface RuleReachShape {
|
|
97
|
+
readonly at: string;
|
|
98
|
+
readonly globs: readonly string[];
|
|
88
99
|
}
|
|
89
100
|
/** A row's reach over ONE absolute spelling, three-valued: `unreadable` = the row cannot be judged there (a base its anchor
|
|
90
101
|
* lacks) — a tightening judgment holds on it, an allow grants nothing on it. */
|
|
@@ -219,9 +230,20 @@ export interface ReadDenyMatcher {
|
|
|
219
230
|
* covers. A rule row's reach below a path is not enumerable: any rule row answers. */
|
|
220
231
|
rowAtOrBelow?(path: string): ReadDenyHit | null;
|
|
221
232
|
/** The table ONE call judges with — the Runner's tables are one per read of the person's rules, and a call judges with
|
|
222
|
-
* the read it was pinned to (an unknown or released call: the run's latest
|
|
223
|
-
*
|
|
233
|
+
* the read it was pinned to (an unknown or released call: the run's latest; no call, `undefined`: the table a judgment
|
|
234
|
+
* that is no call's takes now, refused as that judgment is — what a command start that is no call's pins). Absent on a
|
|
235
|
+
* table compiled once: it is every call's ({@link seatForCall}). */
|
|
224
236
|
forCall?(toolCallId: string | undefined): ReadDenyMatcher;
|
|
237
|
+
/** The compiled segment rows `matchPath` judges with (built-in tiers, additions, each placement of a placed row) — what an
|
|
238
|
+
* OS confinement translates the table from (read-floor.ts); the rule rows are {@link ruleRows}. Absent on a hand-built
|
|
239
|
+
* matcher: such a table has no confinement. */
|
|
240
|
+
readonly compiledSegments?: readonly CompiledSegmentPattern[];
|
|
241
|
+
/** The table's identity, minted once where {@link compileReadDeny} compiles it: a compiled table never changes its
|
|
242
|
+
* judgment, so two tables with one `id` judge every path alike. Not enumerable: a spread copy (which may replace the
|
|
243
|
+
* judgment) has none; the copy that only carries other home views (`carryHomeViews`) keeps it. Absent on a hand-built
|
|
244
|
+
* matcher and on a judge that reads another table at each judgment (`readDenyOver`): neither is one compiled table. The
|
|
245
|
+
* byte floor a start carries reports it (`ReadFloor.id`). */
|
|
246
|
+
readonly id?: string;
|
|
225
247
|
}
|
|
226
248
|
/** A seat the run's tables back — a deny table, a read-root set — as ONE call takes it: the call's own where the seat
|
|
227
249
|
* carries `forCall`, the seat itself otherwise (a table compiled once, a host's own list) and for a reader that is no
|
|
@@ -438,6 +460,8 @@ export interface SegmentMatcher {
|
|
|
438
460
|
test(segment: string): boolean;
|
|
439
461
|
/** The pattern is stars only: it matches every one segment. */
|
|
440
462
|
readonly anything: boolean;
|
|
463
|
+
/** The segment pattern as folded at compile (`*` the one metacharacter) — what an OS confinement translates the segment from. */
|
|
464
|
+
readonly source: string;
|
|
441
465
|
}
|
|
442
466
|
/** A compiled segment-run pattern (shared engine — the write guard delegates here too). */
|
|
443
467
|
export interface CompiledSegmentPattern {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
1
2
|
import { sliceHeadSafe, sliceTailSafe } from "../../core/surrogate-safe-slice.js";
|
|
2
3
|
import { isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity } from "./safety.js";
|
|
3
4
|
import { PROBE_REASON_MAX } from "../../core/untrusted-text.js";
|
|
@@ -99,10 +100,12 @@ function rowLedTo(row, head, at) {
|
|
|
99
100
|
return to.identity;
|
|
100
101
|
return id.identity.startsWith(under) ? `${onto}/${id.identity.slice(under.length)}` : undefined;
|
|
101
102
|
};
|
|
102
|
-
const { head: _head, ...rest } = row;
|
|
103
|
+
const { head: _head, reachShape: shape, ...rest } = row;
|
|
103
104
|
const reach = row.reach;
|
|
105
|
+
const twinShape = shape === undefined ? undefined : shape.at === to.identity ? { at: base, globs: shape.globs } : shape.at.startsWith(`${onto}/`) ? { at: `${under}${shape.at.slice(onto.length + 1)}`, globs: shape.globs } : undefined;
|
|
104
106
|
return {
|
|
105
107
|
...rest,
|
|
108
|
+
...(twinShape !== undefined ? { reachShape: twinShape } : {}),
|
|
106
109
|
reaches: (absolutePath) => {
|
|
107
110
|
const m = mapped(absolutePath);
|
|
108
111
|
return m !== undefined && row.reaches(m);
|
|
@@ -372,6 +375,7 @@ function foldedViewsOf(views) {
|
|
|
372
375
|
function segmentMatcher(pattern) {
|
|
373
376
|
return {
|
|
374
377
|
anything: /^\*+$/.test(pattern),
|
|
378
|
+
source: pattern,
|
|
375
379
|
test: (segment) => !segment.includes("/") && wildcardMatch(pattern, segment),
|
|
376
380
|
};
|
|
377
381
|
}
|
|
@@ -673,7 +677,7 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
673
677
|
const hit = denyTableHit(tableRows, { views: [{ path, kind: "lexical", ...(opts?.aliasResolved === true ? { aliasResolved: true } : {}) }] });
|
|
674
678
|
return hit === null ? null : { pattern: hit.pattern };
|
|
675
679
|
};
|
|
676
|
-
|
|
680
|
+
const table = {
|
|
677
681
|
entries: normalized,
|
|
678
682
|
...(ruleRows.length > 0 ? { ruleRows } : {}),
|
|
679
683
|
matchPath,
|
|
@@ -683,5 +687,8 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
683
687
|
unexcludableUnder,
|
|
684
688
|
rowUnderRoot,
|
|
685
689
|
rowAtOrBelow,
|
|
690
|
+
compiledSegments: Object.freeze([...judged]),
|
|
686
691
|
};
|
|
692
|
+
Object.defineProperty(table, "id", { value: `rdt-${randomUUID()}`, enumerable: false });
|
|
693
|
+
return table;
|
|
687
694
|
}
|
|
@@ -8,6 +8,11 @@
|
|
|
8
8
|
* engine's refusals cite (`readDenySeat`) and the judgment is the table's own `matchPath`, read off the table the call
|
|
9
9
|
* is pinned to (`seatForCall`). A floor never loosens the station: what the station refuses never starts.
|
|
10
10
|
*
|
|
11
|
+
* The floor is the run's, never the start's: every start a table owner makes carries the floor its seat answers for that
|
|
12
|
+
* start — a call's own pinned table, else the owner's base table — whether or not the start's output reaches the model.
|
|
13
|
+
* A floor is pinned at the start ({@link readFloorSeat}) and carries the identity of the compiled table it stands on
|
|
14
|
+
* (`ReadFloor.id`, minted where the table is compiled): one id, one judgment.
|
|
15
|
+
*
|
|
11
16
|
* Whether the environment KEEPS the floor is its declaration (`capabilities.keepsReadFloor`), judged once per table
|
|
12
17
|
* owner by {@link judgeReadFloorKept}: a non-empty table on an environment that does not keep it is announced, or
|
|
13
18
|
* refused when the deployment requires the floor.
|
|
@@ -15,12 +20,15 @@
|
|
|
15
20
|
import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
|
|
16
21
|
import { type EngineNotice } from "../../core/engine-notice.js";
|
|
17
22
|
import { type ReadDenyMatcher } from "./read-deny.js";
|
|
18
|
-
/** The floor ONE
|
|
19
|
-
*
|
|
20
|
-
*
|
|
23
|
+
/** The floor ONE command start carries, read at the start off the table it judges with — a tool call's own (`toolCallId`),
|
|
24
|
+
* else the owner's base table (`undefined`: a start that is no call's, such as a git bookkeeping command or a probe whose
|
|
25
|
+
* lines enter the prompt) — `undefined` when that table holds no row (an empty table keeps nothing, and the start then
|
|
26
|
+
* carries no floor: the options are the ones a start took before the floor existed). Throws when the table cannot be
|
|
27
|
+
* read now (a call's tables that failed to compile, the run's newest still compiling, a partition of the person's rows
|
|
28
|
+
* unread): the start is refused. */
|
|
21
29
|
export type ReadFloorSeat = (toolCallId: string | undefined) => ReadFloor | undefined;
|
|
22
|
-
/** The seat over a
|
|
23
|
-
*
|
|
30
|
+
/** The seat over a table owner's deny table (the run's, or a library-direct band's own); `undefined` for no table. Built
|
|
31
|
+
* once per owner; every start the owner makes reads its floor through it, at the start. */
|
|
24
32
|
export declare function readFloorSeat(table: ReadDenyMatcher | undefined): ReadFloorSeat | undefined;
|
|
25
33
|
/** The value gate of the floor requirement (`RunnerDeps.readDenyFloorRequired`, mirrored on `HandsToolkitOptions`), the one
|
|
26
34
|
* gate of every door that admits it: a boolean, or absent (`undefined`, read as "not required"); anything else refuses
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { deliverEngineNotice } from "../../core/engine-notice.js";
|
|
2
2
|
import { keepsReadFloor } from "../../core/remote-env.js";
|
|
3
|
+
import { seatbeltProfile } from "../../core/shell-confinement.js";
|
|
4
|
+
import { thrownText } from "../../core/thrown-value.js";
|
|
3
5
|
import { readDenySeat, seatForCall } from "./read-deny.js";
|
|
4
6
|
import { isAbsoluteForFamily } from "./safety.js";
|
|
5
7
|
export function readFloorSeat(table) {
|
|
@@ -7,10 +9,14 @@ export function readFloorSeat(table) {
|
|
|
7
9
|
return undefined;
|
|
8
10
|
return (toolCallId) => readFloorOf(seatForCall(table, toolCallId));
|
|
9
11
|
}
|
|
10
|
-
function readFloorOf(
|
|
12
|
+
function readFloorOf(seat) {
|
|
13
|
+
return floorOver(typeof seat.forCall === "function" ? seat.forCall(undefined) : seat);
|
|
14
|
+
}
|
|
15
|
+
function floorOver(table) {
|
|
11
16
|
const rows = Object.freeze([...readDenySeat(table).denyEntries]);
|
|
12
17
|
if (rows.length === 0)
|
|
13
18
|
return undefined;
|
|
19
|
+
const id = typeof table.id === "string" ? table.id : undefined;
|
|
14
20
|
const denies = (absolutePath) => {
|
|
15
21
|
if (typeof absolutePath !== "string" || !isAbsoluteForFamily("own", absolutePath))
|
|
16
22
|
return rows[0];
|
|
@@ -21,7 +27,205 @@ function readFloorOf(table) {
|
|
|
21
27
|
return rows[0];
|
|
22
28
|
}
|
|
23
29
|
};
|
|
24
|
-
|
|
30
|
+
let made;
|
|
31
|
+
const confinement = (dialect) => {
|
|
32
|
+
if (dialect !== "seatbelt")
|
|
33
|
+
return { ok: false, row: rows[0], reason: `no confinement dialect is named ${JSON.stringify(dialect)} (the one dialect is "seatbelt")` };
|
|
34
|
+
try {
|
|
35
|
+
table.matchPath("/");
|
|
36
|
+
const segments = table.compiledSegments;
|
|
37
|
+
const rules = table.ruleRows ?? NO_RULE_ROWS;
|
|
38
|
+
if (made === undefined || made.segments !== segments || made.rules !== rules)
|
|
39
|
+
made = { segments, rules, profile: seatbeltProfileOf(segments, rules, rows[0]) };
|
|
40
|
+
return made.profile;
|
|
41
|
+
}
|
|
42
|
+
catch (e) {
|
|
43
|
+
return { ok: false, row: rows[0], reason: `the read-deny table cannot be judged now (${thrownText(e).slice(0, 300)})` };
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
return Object.freeze({ ...(id !== undefined ? { id } : {}), rows, denies, confinement });
|
|
47
|
+
}
|
|
48
|
+
const SEATBELT_EXPRESSION_MAX = 900;
|
|
49
|
+
const SEGMENT_SEP = "[/\\\\]";
|
|
50
|
+
const NO_RULE_ROWS = Object.freeze([]);
|
|
51
|
+
let canonicalAliases;
|
|
52
|
+
function aliasesOf() {
|
|
53
|
+
if (canonicalAliases !== undefined)
|
|
54
|
+
return canonicalAliases;
|
|
55
|
+
const single = new Map();
|
|
56
|
+
const multi = new Set();
|
|
57
|
+
for (let c = 0; c < 0x30000; c++) {
|
|
58
|
+
if (c >= 0xd800 && c <= 0xdfff)
|
|
59
|
+
continue;
|
|
60
|
+
const ch = String.fromCodePoint(c);
|
|
61
|
+
const n = ch.normalize("NFC");
|
|
62
|
+
if (n === ch)
|
|
63
|
+
continue;
|
|
64
|
+
if ([...n].length === 1)
|
|
65
|
+
single.set(n, [...(single.get(n) ?? []), ch]);
|
|
66
|
+
else
|
|
67
|
+
multi.add(n);
|
|
68
|
+
}
|
|
69
|
+
return (canonicalAliases = { single, multi: [...multi] });
|
|
70
|
+
}
|
|
71
|
+
function codePointExpression(ch, foldAscii, exact) {
|
|
72
|
+
const c = ch.codePointAt(0);
|
|
73
|
+
const letter = (c >= 0x41 && c <= 0x5a) || (c >= 0x61 && c <= 0x7a);
|
|
74
|
+
const spellings = foldAscii && letter ? [ch.toLowerCase(), ch.toUpperCase()] : [ch];
|
|
75
|
+
const aliases = exact ? [] : spellings.flatMap((sp) => aliasesOf().single.get(sp) ?? []);
|
|
76
|
+
if (spellings.length === 1 && aliases.length === 0)
|
|
77
|
+
return escapeLiteral(ch);
|
|
78
|
+
if (letter)
|
|
79
|
+
return `[${[...spellings, ...aliases].join("")}]`;
|
|
80
|
+
return `(${[...spellings, ...aliases].map(escapeLiteral).join("|")})`;
|
|
81
|
+
}
|
|
82
|
+
function escapeLiteral(x) {
|
|
83
|
+
return x.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
84
|
+
}
|
|
85
|
+
function seatbeltProfileOf(segments, rules, firstRow) {
|
|
86
|
+
if (segments === undefined)
|
|
87
|
+
return { ok: false, row: firstRow, reason: "the table carries no compiled rows to translate (a hand-built table)" };
|
|
88
|
+
const reads = new Set();
|
|
89
|
+
const holds = new Set();
|
|
90
|
+
const add = (row, e) => {
|
|
91
|
+
if ("untranslatable" in e)
|
|
92
|
+
return { ok: false, row, reason: e.untranslatable };
|
|
93
|
+
for (const x of [...e.reads, ...e.holds]) {
|
|
94
|
+
if (Buffer.byteLength(JSON.stringify(x)) - 2 > SEATBELT_EXPRESSION_MAX)
|
|
95
|
+
return { ok: false, row, reason: `its expression is longer than the ${SEATBELT_EXPRESSION_MAX} bytes a seatbelt profile reads` };
|
|
96
|
+
}
|
|
97
|
+
for (const x of e.reads)
|
|
98
|
+
reads.add(x);
|
|
99
|
+
for (const x of e.holds)
|
|
100
|
+
holds.add(x);
|
|
101
|
+
return undefined;
|
|
102
|
+
};
|
|
103
|
+
for (const pat of segments) {
|
|
104
|
+
const refused = add(pat.raw, segmentRowExpressions(pat));
|
|
105
|
+
if (refused !== undefined)
|
|
106
|
+
return refused;
|
|
107
|
+
}
|
|
108
|
+
for (const rule of rules) {
|
|
109
|
+
const refused = add(rule.rule, ruleRowExpressions(rule));
|
|
110
|
+
if (refused !== undefined)
|
|
111
|
+
return refused;
|
|
112
|
+
}
|
|
113
|
+
return { ok: true, profile: seatbeltProfile([...reads], [...holds]) };
|
|
114
|
+
}
|
|
115
|
+
function literalExpression(text, foldAscii, exact = false) {
|
|
116
|
+
let out = "";
|
|
117
|
+
for (const cluster of text.match(/\P{M}\p{M}*|\p{M}+/gu) ?? []) {
|
|
118
|
+
for (const ch of cluster) {
|
|
119
|
+
const c = ch.codePointAt(0);
|
|
120
|
+
if (c < 0x20 || c === 0x7f)
|
|
121
|
+
return { untranslatable: "it holds a control character" };
|
|
122
|
+
}
|
|
123
|
+
const composed = cluster.normalize("NFC");
|
|
124
|
+
const decomposed = cluster.normalize("NFD");
|
|
125
|
+
const cannotList = { untranslatable: `its name holds a character (${JSON.stringify(cluster)}) whose canonical spellings the dialect cannot list` };
|
|
126
|
+
if (!exact && aliasesOf().multi.some((m) => composed.includes(m)))
|
|
127
|
+
return cannotList;
|
|
128
|
+
if (exact || (composed === decomposed && cluster === composed)) {
|
|
129
|
+
for (const ch of cluster)
|
|
130
|
+
out += codePointExpression(ch, foldAscii, exact);
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
const parts = [...decomposed];
|
|
134
|
+
if (parts.length !== 2)
|
|
135
|
+
return cannotList;
|
|
136
|
+
const spell = (x) => [x, ...(aliasesOf().single.get(x) ?? [])];
|
|
137
|
+
const forms = new Set([...spell(composed)]);
|
|
138
|
+
for (const b of spell(parts[0]))
|
|
139
|
+
for (const m of spell(parts[1]))
|
|
140
|
+
forms.add(`${b}${m}`);
|
|
141
|
+
out += `(${[...forms].map(escapeLiteral).join("|")})`;
|
|
142
|
+
}
|
|
143
|
+
return out;
|
|
144
|
+
}
|
|
145
|
+
function segmentExpression(source, foldAscii) {
|
|
146
|
+
const parts = [];
|
|
147
|
+
const texts = source.split("*");
|
|
148
|
+
for (const [i, part] of texts.entries()) {
|
|
149
|
+
const last = [...part.normalize("NFD")].at(-1);
|
|
150
|
+
if ((i < texts.length - 1 && last !== undefined && /\p{M}/u.test(last)) || (i > 0 && /^\p{M}/u.test(part.normalize("NFD")))) {
|
|
151
|
+
return { untranslatable: `a marked character stands beside a wildcard in ${JSON.stringify(source)} (the marks the wildcard meets can reorder into it)` };
|
|
152
|
+
}
|
|
153
|
+
const lit = literalExpression(part, foldAscii);
|
|
154
|
+
if (typeof lit !== "string")
|
|
155
|
+
return lit;
|
|
156
|
+
parts.push(lit);
|
|
157
|
+
}
|
|
158
|
+
const trailing = /[*. ]$/.test(source) ? "" : "[. ]*";
|
|
159
|
+
return `${SEGMENT_SEP}${parts.join("[^/\\\\]*")}${trailing}`;
|
|
160
|
+
}
|
|
161
|
+
function segmentRowExpressions(pat) {
|
|
162
|
+
if (pat.fold === "unicode")
|
|
163
|
+
return { untranslatable: "its case fold is not the deny table's" };
|
|
164
|
+
const fold = pat.fold === "ascii";
|
|
165
|
+
const run = [];
|
|
166
|
+
for (const seg of pat.segments) {
|
|
167
|
+
const e = segmentExpression(seg.source, fold);
|
|
168
|
+
if (typeof e !== "string")
|
|
169
|
+
return e;
|
|
170
|
+
run.push(e);
|
|
171
|
+
}
|
|
172
|
+
if (pat.anchors !== undefined) {
|
|
173
|
+
const reads = [];
|
|
174
|
+
const holds = [];
|
|
175
|
+
for (const anchor of pat.anchors) {
|
|
176
|
+
const at = [];
|
|
177
|
+
for (const seg of anchor) {
|
|
178
|
+
const e = literalExpression(seg, fold);
|
|
179
|
+
if (typeof e !== "string")
|
|
180
|
+
return e;
|
|
181
|
+
at.push(`${SEGMENT_SEP}${e}${/[. ]$/.test(seg) ? "" : "[. ]*"}`);
|
|
182
|
+
}
|
|
183
|
+
const whole = `^${at.join("")}${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
184
|
+
reads.push(whole);
|
|
185
|
+
holds.push(whole);
|
|
186
|
+
const located = [...at, ...run];
|
|
187
|
+
for (let k = 1; k < located.length; k++)
|
|
188
|
+
holds.push(`^${located.slice(0, k).join("")}$`);
|
|
189
|
+
}
|
|
190
|
+
return { reads, holds };
|
|
191
|
+
}
|
|
192
|
+
const whole = `^(/.*)?${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
193
|
+
const holds = [whole];
|
|
194
|
+
for (let k = 1; k < run.length; k++)
|
|
195
|
+
holds.push(`^(/.*)?${run.slice(0, k).join("")}$`);
|
|
196
|
+
return { reads: [whole], holds };
|
|
197
|
+
}
|
|
198
|
+
function ruleRowExpressions(rule) {
|
|
199
|
+
const shape = rule.reachShape;
|
|
200
|
+
if (shape === undefined)
|
|
201
|
+
return { untranslatable: "the row's reach has no shape a profile can spell (a hand-built row, or one whose base is missing)" };
|
|
202
|
+
const at = [];
|
|
203
|
+
for (const seg of shape.at.split("/").filter(Boolean)) {
|
|
204
|
+
const e = literalExpression(seg, false, true);
|
|
205
|
+
if (typeof e !== "string")
|
|
206
|
+
return e;
|
|
207
|
+
at.push(`/${e}`);
|
|
208
|
+
}
|
|
209
|
+
const globs = [];
|
|
210
|
+
for (const glob of shape.globs) {
|
|
211
|
+
if (glob === "**") {
|
|
212
|
+
globs.push("(/[^/]+)*");
|
|
213
|
+
continue;
|
|
214
|
+
}
|
|
215
|
+
const parts = [];
|
|
216
|
+
for (const part of glob.split("*")) {
|
|
217
|
+
const lit = literalExpression(part, false, true);
|
|
218
|
+
if (typeof lit !== "string")
|
|
219
|
+
return lit;
|
|
220
|
+
parts.push(lit);
|
|
221
|
+
}
|
|
222
|
+
globs.push(`/${parts.join("[^/]*")}`);
|
|
223
|
+
}
|
|
224
|
+
const whole = `^${at.join("")}${globs.join("")}(/.*)?$`;
|
|
225
|
+
const holds = [whole];
|
|
226
|
+
for (let k = 1; k <= at.length; k++)
|
|
227
|
+
holds.push(`^${at.slice(0, k).join("")}$`);
|
|
228
|
+
return { reads: [whole], holds };
|
|
25
229
|
}
|
|
26
230
|
export function screenReadDenyFloorRequired(value, seat) {
|
|
27
231
|
if (value === undefined || typeof value === "boolean")
|
|
@@ -211,8 +211,9 @@ export declare function jsGrepDetailed(env: ExecutionEnv, root: string, p: GrepP
|
|
|
211
211
|
export declare function jsGrep(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, guards?: JsGrepGuards, deny?: ReadDenyJudge, denyOut?: {
|
|
212
212
|
withheld?: ReadDenyWithheld;
|
|
213
213
|
}): Promise<string>;
|
|
214
|
-
/** Detect ripgrep once per env (cached).
|
|
215
|
-
|
|
214
|
+
/** Detect ripgrep once per env (cached). The detection is a start of the call that asks first and carries that call's floor
|
|
215
|
+
* (`readFloor`; absent ⇒ none, a caller with no run's table). */
|
|
216
|
+
export declare function detectRipgrep(env: ExecutionEnv, readFloor?: ReadFloor): Promise<boolean>;
|
|
216
217
|
/** How a grep result was produced when the ripgrep leg could not complete normally. Either the
|
|
217
218
|
* delivered text IS ripgrep's own partial output (`partial: true`), or ripgrep produced nothing
|
|
218
219
|
* usable and the results came from the JS fallback scanner (`fallback: "js-scan"`). Absent on a
|
package/dist/tools/fs/search.js
CHANGED
|
@@ -1022,11 +1022,11 @@ export async function jsGrep(env, root, p, signal, guards, deny, denyOut) {
|
|
|
1022
1022
|
return (await jsGrepDetailed(env, root, p, signal, guards, deny, denyOut)).text;
|
|
1023
1023
|
}
|
|
1024
1024
|
const rgCache = new WeakMap();
|
|
1025
|
-
export function detectRipgrep(env) {
|
|
1025
|
+
export function detectRipgrep(env, readFloor) {
|
|
1026
1026
|
let cached = rgCache.get(env);
|
|
1027
1027
|
if (!cached) {
|
|
1028
1028
|
cached = env
|
|
1029
|
-
.exec("rg --version", { timeout: 10 })
|
|
1029
|
+
.exec("rg --version", { timeout: 10, ...(readFloor !== undefined ? { readFloor } : {}) })
|
|
1030
1030
|
.then((r) => r.ok && r.value.exitCode === 0)
|
|
1031
1031
|
.catch(() => false);
|
|
1032
1032
|
rgCache.set(env, cached);
|
|
@@ -1244,7 +1244,7 @@ export async function rgGrepDetailed(env, root, p, signal, deny, readFloor) {
|
|
|
1244
1244
|
if (info.ok && info.value.kind === "file")
|
|
1245
1245
|
return { note: "" };
|
|
1246
1246
|
}
|
|
1247
|
-
const withheld = await rgDenyExistenceProbe(env, root, deny, target, signal);
|
|
1247
|
+
const withheld = await rgDenyExistenceProbe(env, root, deny, target, signal, readFloor);
|
|
1248
1248
|
if (withheld === undefined)
|
|
1249
1249
|
return { note: "" };
|
|
1250
1250
|
const note = withheld.kind === "existence"
|
|
@@ -1284,14 +1284,14 @@ export async function rgGrepDetailed(env, root, p, signal, deny, readFloor) {
|
|
|
1284
1284
|
const formatted = formatRgRecords(ordered, p);
|
|
1285
1285
|
return { text: formatted.text + d.note, rows: formatted.served, ...(d.withheld !== undefined ? { withheld: d.withheld } : {}) };
|
|
1286
1286
|
}
|
|
1287
|
-
async function rgDenyExistenceProbe(env, root, deny, target, signal) {
|
|
1287
|
+
async function rgDenyExistenceProbe(env, root, deny, target, signal, readFloor) {
|
|
1288
1288
|
const probeFlags = ["--files", "--hidden", "--no-require-git", "--no-messages"];
|
|
1289
1289
|
for (const d of VCS_DIRS)
|
|
1290
1290
|
probeFlags.push("--glob", `!${d}`);
|
|
1291
1291
|
for (const g of deny.rgProbeGlobs)
|
|
1292
1292
|
probeFlags.push(g.flag, shellQuote(g.glob));
|
|
1293
1293
|
try {
|
|
1294
|
-
const res = await env.exec(`( rg ${probeFlags.join(" ")} -- ${target}; echo "__RG_PROBE_EXIT_$?" 1>&2 ) | head -n 1`, { cwd: root, timeout: 10, abortSignal: signal });
|
|
1294
|
+
const res = await env.exec(`( rg ${probeFlags.join(" ")} -- ${target}; echo "__RG_PROBE_EXIT_$?" 1>&2 ) | head -n 1`, { cwd: root, timeout: 10, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
1295
1295
|
if (!res.ok)
|
|
1296
1296
|
return { kind: "probe_failed" };
|
|
1297
1297
|
const first = res.value.stdout.split("\n").find((l) => l.trim().length > 0);
|
|
@@ -1325,7 +1325,7 @@ export async function runGrepDetailed(env, root, p, signal, deny, readFloor) {
|
|
|
1325
1325
|
return false;
|
|
1326
1326
|
return deny.unexcludableUnder(scope) || (home.view !== undefined && deny.unexcludableUnder(home.view));
|
|
1327
1327
|
};
|
|
1328
|
-
if (!(await unexcludableUnder()) && (await detectRipgrep(env)))
|
|
1328
|
+
if (!(await unexcludableUnder()) && (await detectRipgrep(env, readFloor)))
|
|
1329
1329
|
return rgGrepDetailed(env, root, p, signal, deny, readFloor);
|
|
1330
1330
|
const denyOut = {};
|
|
1331
1331
|
const { text, rows } = await jsGrepDetailed(env, root, p, signal, undefined, deny, denyOut);
|
|
@@ -6,6 +6,7 @@ import { judgedCandidatesOf, sedBackupNames } from "./shell-read-write-targets.j
|
|
|
6
6
|
import { movedReads, withHomeViews } from "./shell-read-identity.js";
|
|
7
7
|
import { passesUnasked } from "./shell-read-device.js";
|
|
8
8
|
import { compileFsGlob, fsGlobClass } from "./fs-glob.js";
|
|
9
|
+
import { chainHopsOrNone, leafChainMayHold, symlinkChainHops } from "../../core/path-identity.js";
|
|
9
10
|
const GLOB_METACHAR_RE = /[*?[]/;
|
|
10
11
|
export const MAX_GLOB_DIRS = 256;
|
|
11
12
|
export const MAX_GLOB_MATCHES = 8192;
|
|
@@ -391,7 +392,8 @@ function establishLegOver(seen, readRoots) {
|
|
|
391
392
|
if (!real.exact && real.missing !== true) {
|
|
392
393
|
return { candidate, established: "unestablishable", spellings, ...(origin !== undefined ? { origin } : {}), cause: `"${spelling}" cannot be resolved to verify where it reads`, unresolved: true };
|
|
393
394
|
}
|
|
394
|
-
|
|
395
|
+
const hops = seat === "landing" && leafChainMayHold([spelling], !real.exact || real.value !== normalizeAbsPathLexically(spelling), family) ? chainHopsOrNone(await symlinkChainHops(env, spelling, signal, family)) : [];
|
|
396
|
+
return { candidate, established, target: real.value, spellings, ...(origin !== undefined ? { origin } : {}), ...(hops.length > 0 ? { hops } : {}) };
|
|
395
397
|
};
|
|
396
398
|
const followedName = async (spelled, base, homeDir, signal) => {
|
|
397
399
|
let name = spelled;
|
|
@@ -2,7 +2,9 @@ import type { EstablishedPlan } from "./shell-read-establish.js";
|
|
|
2
2
|
import type { ObservedEnvironment } from "./shell-read-environment.js";
|
|
3
3
|
import type { EstablishedRead } from "./shell-read-judge.js";
|
|
4
4
|
import { type HomeViewsCarrier } from "./read-deny-home.js";
|
|
5
|
-
/** Every read of either establishment whose candidate's settled target set
|
|
5
|
+
/** Every read of either establishment whose candidate's settled target set — or the set of link-chain hops it was judged
|
|
6
|
+
* through ({@link EstablishedRead.hops}: a chain re-pointed through another directory may keep its terminal) — differs
|
|
7
|
+
* between the two. */
|
|
6
8
|
export declare function movedReads(previous: EstablishedPlan, again: EstablishedPlan): EstablishedRead[];
|
|
7
9
|
/** One read candidate's landing: its key and where it settled, each as a sha256 hex digest (the key's raw tuple joins on
|
|
8
10
|
* NUL and follows the command's length; a pattern lands on up to thousands of entries), with the raw word and the
|
|
@@ -7,7 +7,7 @@ export function movedReads(previous, again) {
|
|
|
7
7
|
for (const key of new Set([...before.keys(), ...after.keys()])) {
|
|
8
8
|
const b = before.get(key);
|
|
9
9
|
const a = after.get(key);
|
|
10
|
-
if (b !== undefined && a !== undefined && landingOf(b.targets) === landingOf(a.targets))
|
|
10
|
+
if (b !== undefined && a !== undefined && landingOf(b.targets) === landingOf(a.targets) && landingOf(b.hops) === landingOf(a.hops))
|
|
11
11
|
continue;
|
|
12
12
|
changed.push(...(b?.reads ?? []), ...(a?.reads ?? []));
|
|
13
13
|
}
|
|
@@ -27,11 +27,13 @@ function targetsByCandidate(e) {
|
|
|
27
27
|
for (const r of p.reads.get(segment) ?? []) {
|
|
28
28
|
const c = r.candidate;
|
|
29
29
|
const key = [at, si, c.denyOnly === true ? "floor" : "read", c.provenance, c.spelled, String(c.expands), c.raw].join("\0");
|
|
30
|
-
const landing = out.get(key) ?? { targets: new Set(), reads: [] };
|
|
30
|
+
const landing = out.get(key) ?? { targets: new Set(), hops: new Set(), reads: [] };
|
|
31
31
|
out.set(key, landing);
|
|
32
32
|
landing.reads.push(r);
|
|
33
33
|
if ((r.established === "canonical" || r.established === "expansion") && r.target !== undefined)
|
|
34
34
|
landing.targets.add(r.target);
|
|
35
|
+
for (const hop of r.hops ?? [])
|
|
36
|
+
landing.hops.add(hop);
|
|
35
37
|
}
|
|
36
38
|
segment.nested.forEach((n, ni) => {
|
|
37
39
|
const nested = p.nested.get(n);
|
|
@@ -5,7 +5,8 @@
|
|
|
5
5
|
*
|
|
6
6
|
* · `judgeRead` judges ONE established candidate: the deny half first, over every view the candidate has
|
|
7
7
|
* (its canonical target, its folded spelling, the kernel spelling of a `..` operand, the folded spelling
|
|
8
|
-
* of a candidate that could not be established
|
|
8
|
+
* of a candidate that could not be established, the hops of its leaf symlink chain), then containment over
|
|
9
|
+
* the canonical target alone. The
|
|
9
10
|
* deny judge is the boundary's own `denyMatch` closure (`readDenySeat`, read-deny.ts) — the same function
|
|
10
11
|
* object every read face mounts; nothing here compiles a pattern or re-derives a view set. The containment
|
|
11
12
|
* judge is `withinAnyRoot` over the roots the boundary declares — a WRITE target's over the write roots, at the
|
|
@@ -248,6 +249,11 @@ export interface EstablishedRead {
|
|
|
248
249
|
* name of a GNU sed `--follow-symlinks` backup when the operand's links supplied it. Every other spelling is the command's
|
|
249
250
|
* own text (folded, or as the kernel walks it). Absent ⇒ none. */
|
|
250
251
|
readonly derivedSpellings?: readonly string[];
|
|
252
|
+
/** The hops of the landed target's LEAF symlink chain — each an unresolved spelling some link on the way wrote — where the
|
|
253
|
+
* program follows the target's links (the landing seat): the views a call's target reading judges beside the canonical
|
|
254
|
+
* and the lexical one, read through the same chain reader. Deny views only: not a spelling the
|
|
255
|
+
* command wrote, not a containment candidate, not a write view of its own. Absent ⇒ none read. */
|
|
256
|
+
readonly hops?: readonly string[];
|
|
251
257
|
/** The pattern or traversal root an `expansion` came from, as folded. */
|
|
252
258
|
readonly origin?: string;
|
|
253
259
|
/** What the environment said the target IS, where a read asked — only a traversal root asks (it lists the root
|
|
@@ -46,7 +46,7 @@ export function judgeRead(read, boundary) {
|
|
|
46
46
|
const writeTarget = read.candidate.face === "write";
|
|
47
47
|
const deny = writeTarget ? boundary.writeDenyMatch : boundary.denyMatch;
|
|
48
48
|
if (deny !== undefined) {
|
|
49
|
-
const views = [...(read.target !== undefined ? [read.target] : []), ...read.spellings];
|
|
49
|
+
const views = [...(read.target !== undefined ? [read.target] : []), ...read.spellings, ...(read.hops ?? [])];
|
|
50
50
|
for (const view of views) {
|
|
51
51
|
const folded = normalizeAbsPathLexically(view);
|
|
52
52
|
const pattern = writeTarget ? boundary.writeDenyMatch(folded) : boundary.denyMatch(folded);
|
package/dist/tools/monitor.d.ts
CHANGED
|
@@ -42,9 +42,11 @@
|
|
|
42
42
|
import type { AgentTool, ExecutionEnv } from "../internal/harness-types.js";
|
|
43
43
|
import { type MonitorTimers, type TaskRegistry } from "../core/task-registry.js";
|
|
44
44
|
import { type TaskNotificationPayload } from "../core/task-notification.js";
|
|
45
|
-
import type { ToolResultStore } from "../core/tool-result-store.js";
|
|
46
45
|
import type { ShellReadAdmission } from "./fs/shell-read-check.js";
|
|
47
46
|
import type { ReadFloorSeat } from "./fs/read-floor.js";
|
|
47
|
+
/** The refusal a watch gets where no event or completion would come back from it (no completion sink for the call, no
|
|
48
|
+
* mount sink): nothing is spawned. */
|
|
49
|
+
export declare const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here \u2014 no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
|
|
48
50
|
export interface MonitorToolOptions {
|
|
49
51
|
registry: TaskRegistry;
|
|
50
52
|
/** Fallbacks when the runtime ctx carries no identity (direct mounts) — same posture as createBashTool. */
|
|
@@ -53,8 +55,8 @@ export interface MonitorToolOptions {
|
|
|
53
55
|
/** design/129: the session id — a `persistent` monitor registers session-scoped under it (outlives the
|
|
54
56
|
* turn; reaped by the deployment's session release via `reapSessionBackground`). */
|
|
55
57
|
sessionId?: string;
|
|
56
|
-
/** The notification sink (the run-local task-notification lane).
|
|
57
|
-
*
|
|
58
|
+
/** The notification sink (the run-local task-notification lane). A call carrying its run's lane delivers there
|
|
59
|
+
* instead; with neither, the watch is refused before anything is spawned (nothing it saw would reach the model). */
|
|
58
60
|
onTaskNotification?: (n: TaskNotificationPayload, opts?: {
|
|
59
61
|
priority?: "now" | "next" | "later";
|
|
60
62
|
}) => void;
|
|
@@ -67,10 +69,9 @@ export interface MonitorToolOptions {
|
|
|
67
69
|
/** Test/deployment knobs (defaults: 200ms window, 50 batches/min). */
|
|
68
70
|
batchWindowMs?: number;
|
|
69
71
|
maxBatchesPerMinute?: number;
|
|
70
|
-
/**
|
|
71
|
-
*
|
|
72
|
-
|
|
73
|
-
toolResultStore?: ToolResultStore;
|
|
72
|
+
/** This run is a one-shot submission (`TaskSpec.oneShot`): its ending does not wait for the watch, and the
|
|
73
|
+
* receipt says so with the one process-lane sentence a background command's receipt carries. */
|
|
74
|
+
oneShot?: boolean;
|
|
74
75
|
/** The gate's shell read station's pre-spawn ADMISSION — the SAME option `createBashTool` takes: this face
|
|
75
76
|
* spawns a shell command too, so what it runs is what the station judged, re-established before the watch
|
|
76
77
|
* spawns. Absent ⇒ no station judged this mount; nothing is re-established. */
|
package/dist/tools/monitor.js
CHANGED
|
@@ -2,10 +2,12 @@ import { Type } from "typebox";
|
|
|
2
2
|
import { defineTool, errorResult } from "../core/tools.js";
|
|
3
3
|
import { createBackgroundOutputFile, envDeclaresRetain, hasBackgroundShell, retainsBackgroundProcesses } from "../core/background-shell.js";
|
|
4
4
|
import { MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, } from "../core/task-registry.js";
|
|
5
|
-
import { resolveCompletionSink } from "../core/task-notification.js";
|
|
5
|
+
import { admitsBackgroundLaunch, resolveCompletionSink } from "../core/task-notification.js";
|
|
6
6
|
import { toolFace } from "../core/tool-catalog-entries.js";
|
|
7
|
+
import { ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs/fs-bash-background-text.js";
|
|
7
8
|
import { isDeadCwd, diagnoseDeadCwd } from "./fs/dead-cwd.js";
|
|
8
9
|
import { thrownText } from "../core/thrown-value.js";
|
|
10
|
+
export const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here — no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
|
|
9
11
|
const MONITOR_DESCRIPTION = "Run a shell command in the background and watch its stdout as a stream of events.\n" +
|
|
10
12
|
"\n" +
|
|
11
13
|
"- Each line the command writes to stdout becomes a notification event delivered to you between turns; " +
|
|
@@ -67,6 +69,9 @@ export function createMonitorTool(env, opts) {
|
|
|
67
69
|
if (!hasBackgroundShell(env)) {
|
|
68
70
|
return errorResult("Error (Monitor): this environment does not support background processes.");
|
|
69
71
|
}
|
|
72
|
+
const onNotify = resolveCompletionSink(ctx.onTaskNotification, opts.onTaskNotification);
|
|
73
|
+
if (!admitsBackgroundLaunch(onNotify))
|
|
74
|
+
return errorResult(MONITOR_NO_COMPLETION_CHANNEL);
|
|
70
75
|
const isPersistent = persistent === true;
|
|
71
76
|
const timeoutMs = Math.min(MONITOR_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeout_ms ?? MONITOR_DEFAULT_TIMEOUT_MS)));
|
|
72
77
|
const spawnTimeoutSec = isPersistent ? undefined : Math.ceil(timeoutMs / 1000) + 5;
|
|
@@ -91,7 +96,6 @@ export function createMonitorTool(env, opts) {
|
|
|
91
96
|
const sessionScoped = isPersistent && opts.sessionId !== undefined;
|
|
92
97
|
const owner = sessionScoped ? opts.sessionId : (ctx.taskId ?? opts.owner);
|
|
93
98
|
const scope = ctx.principal ?? opts.scope;
|
|
94
|
-
const onNotify = resolveCompletionSink(ctx.onTaskNotification, opts.onTaskNotification);
|
|
95
99
|
const outputFile = await createBackgroundOutputFile(env, "monitor-task-");
|
|
96
100
|
let taskId;
|
|
97
101
|
try {
|
|
@@ -108,12 +112,11 @@ export function createMonitorTool(env, opts) {
|
|
|
108
112
|
...(sessionScoped ? { sessionScoped: true } : {}),
|
|
109
113
|
...(isPersistent ? {} : { timeoutMs }),
|
|
110
114
|
...(opts.retainBackgroundProcesses !== undefined ? { retainBackgroundProcesses: opts.retainBackgroundProcesses } : {}),
|
|
111
|
-
|
|
115
|
+
onEvent: (n) => onNotify(n, { priority: "next" }),
|
|
112
116
|
...(opts.timers !== undefined ? { timers: opts.timers } : {}),
|
|
113
117
|
...(opts.batchWindowMs !== undefined ? { batchWindowMs: opts.batchWindowMs } : {}),
|
|
114
118
|
...(opts.maxBatchesPerMinute !== undefined ? { maxBatchesPerMinute: opts.maxBatchesPerMinute } : {}),
|
|
115
119
|
...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}),
|
|
116
|
-
...(opts.toolResultStore !== undefined ? { toolResultStore: opts.toolResultStore } : {}),
|
|
117
120
|
});
|
|
118
121
|
}
|
|
119
122
|
catch (e) {
|
|
@@ -166,12 +169,11 @@ export function createMonitorTool(env, opts) {
|
|
|
166
169
|
const fileClause = outputFile !== undefined
|
|
167
170
|
? `Output file: ${outputFile} (stdout and stderr are appended there — Read it any time).`
|
|
168
171
|
: "No output file could be created for this watch.";
|
|
169
|
-
const content =
|
|
170
|
-
|
|
171
|
-
`~200ms are batched)
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
`${fileClause} Stop it with TaskStop("${taskId}"). ${lifetime}`;
|
|
172
|
+
const content = `Monitoring in background; task_id=${taskId}. Each stdout line becomes a notification event (lines within ` +
|
|
173
|
+
(opts.oneShot === true
|
|
174
|
+
? `~200ms are batched). ${ONE_SHOT_BACKGROUND_COMMAND_NOTE} `
|
|
175
|
+
: `~200ms are batched); you'll get a final notification with the exit code when it ends — do not poll. `) +
|
|
176
|
+
`${lifetime} ${fileClause} TaskStop("${taskId}") stops the watch.`;
|
|
175
177
|
return {
|
|
176
178
|
content,
|
|
177
179
|
details: {
|
package/dist/tools/worktree.d.ts
CHANGED
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
* `CheckpointState.activeWorktree` (+ the cwd into `handsCwd`); resume re-seeds both, so
|
|
46
46
|
* Enter→suspend→resume→Exit behaves exactly like an unsuspended session.
|
|
47
47
|
*/
|
|
48
|
-
import type { ActiveWorktreeSession, AgentTool, ExecutionEnv } from "../internal/harness-types.js";
|
|
48
|
+
import type { ActiveWorktreeSession, AgentTool, ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
|
|
49
49
|
import type { ManagedCheckoutView } from "../core/write-protect.js";
|
|
50
50
|
import type { CwdRef } from "./fs/index.js";
|
|
51
51
|
/** the ACTIVE worktree session, ALL-SERIALIZABLE (plain strings, no closures):
|
|
@@ -111,6 +111,10 @@ export interface WorktreeToolsOptions {
|
|
|
111
111
|
* the durable checkpoint and re-seeds it on resume). Omitted ⇒ a private per-mount ref (same live
|
|
112
112
|
* behavior, minus durable-suspend survival — prepare-task always passes one). */
|
|
113
113
|
session?: WorktreeSessionRef;
|
|
114
|
+
/** The byte floor's seat (`ExecutionEnvExecOptions.readFloor`): every git command a call starts carries the floor of the
|
|
115
|
+
* table that call judges with, read as the call begins. Absent ⇒ the starts carry none (a host mount that holds no
|
|
116
|
+
* run's table); the Runner always passes the run's. */
|
|
117
|
+
readFloor?: (toolCallId: string | undefined) => ReadFloor | undefined;
|
|
114
118
|
}
|
|
115
119
|
/**
|
|
116
120
|
* Build the EnterWorktree/ExitWorktree pair. One session-state closure per mount (= per task): the
|