@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,13 +1,15 @@
|
|
|
1
|
-
import { spawn } from "node:child_process";
|
|
1
|
+
import { spawn, spawnSync } from "node:child_process";
|
|
2
2
|
import { randomUUID } from "node:crypto";
|
|
3
3
|
import { closeSync, constants, createReadStream, mkdtempSync, openSync, readSync, rmSync, statSync, truncateSync, unlinkSync } from "node:fs";
|
|
4
4
|
import { access, appendFile, lstat, mkdir, mkdtemp, open, readdir, readFile, readlink, rename, rm, stat, unlink, writeFile, } from "node:fs/promises";
|
|
5
5
|
import { tmpdir } from "node:os";
|
|
6
|
-
import { dirname, isAbsolute, join, sep } from "node:path";
|
|
6
|
+
import { basename, dirname, isAbsolute, join, sep } from "node:path";
|
|
7
7
|
import { createInterface } from "node:readline";
|
|
8
8
|
import { ExecutionError, err, FileError, ok, toError, } from "../harness/types.js";
|
|
9
9
|
import { killProcessTree, shutdownDebug } from "./kill-tree.js";
|
|
10
10
|
import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
|
|
11
|
+
import { deliverEngineNotice } from "../../core/engine-notice.js";
|
|
12
|
+
import { confineShellStart, SANDBOX_EXEC, SEATBELT_PROBE_PROFILE } from "../../core/shell-confinement.js";
|
|
11
13
|
import { physicalPathOfAsync } from "../../core/physical-path.js";
|
|
12
14
|
import { posixModeBitsMeaningful } from "../../core/posix-mode-face.js";
|
|
13
15
|
import { anchorAtLinkDir, walkSymlinkChain } from "./symlink-chain.js";
|
|
@@ -15,6 +17,51 @@ import { RollingTailBuffer, markTruncated, newStreamCursorState, sliceStreamIncr
|
|
|
15
17
|
import { BackgroundShellError } from "../../core/background-shell.js";
|
|
16
18
|
import { SchedulerError } from "../../core/scheduler.js";
|
|
17
19
|
const MAX_TIMER_TIMEOUT_MS = 2_147_000_000;
|
|
20
|
+
const NODE_ENV_CAPABILITIES = Object.freeze({
|
|
21
|
+
isolation: false,
|
|
22
|
+
suspendable: false,
|
|
23
|
+
sharesProcessTable: true,
|
|
24
|
+
canonicalPathAuthoritative: true,
|
|
25
|
+
hostLocalPaths: true,
|
|
26
|
+
externalContentTarget: false,
|
|
27
|
+
io: true,
|
|
28
|
+
keepsReadFloor: false,
|
|
29
|
+
});
|
|
30
|
+
const NODE_ENV_CONFINED_CAPABILITIES = Object.freeze({ ...NODE_ENV_CAPABILITIES, keepsReadFloor: true });
|
|
31
|
+
function probeReadFloorConfinement() {
|
|
32
|
+
if (process.platform !== "darwin")
|
|
33
|
+
return { ok: false, reason: `this platform (${process.platform}) has no process confinement the engine applies — macOS only` };
|
|
34
|
+
try {
|
|
35
|
+
const r = spawnSync(SANDBOX_EXEC, ["-p", SEATBELT_PROBE_PROFILE, "/usr/bin/true"], { env: {}, stdio: ["ignore", "ignore", "pipe"], timeout: 10_000, encoding: "utf8" });
|
|
36
|
+
if (r.status === 0)
|
|
37
|
+
return { ok: true };
|
|
38
|
+
const said = (r.error?.message ?? r.stderr ?? "").trim().slice(0, 300);
|
|
39
|
+
return { ok: false, reason: `${SANDBOX_EXEC} could not apply the confinement base here (${r.status === null ? `signal ${r.signal ?? "none"}` : `exit ${r.status}`}${said !== "" ? `: ${said}` : ""})` };
|
|
40
|
+
}
|
|
41
|
+
catch (e) {
|
|
42
|
+
return { ok: false, reason: `${SANDBOX_EXEC} could not be run (${toError(e).message.slice(0, 300)})` };
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
function profileApplyFailure(profile) {
|
|
46
|
+
return new Promise((resolve) => {
|
|
47
|
+
let said = "";
|
|
48
|
+
let child;
|
|
49
|
+
try {
|
|
50
|
+
child = spawn(SANDBOX_EXEC, ["-p", profile, "/usr/bin/true"], { env: {}, stdio: ["ignore", "ignore", "pipe"] });
|
|
51
|
+
}
|
|
52
|
+
catch (e) {
|
|
53
|
+
resolve(`${SANDBOX_EXEC} could not be run: ${toError(e).message.slice(0, 300)}`);
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
child.stderr?.setEncoding("utf8");
|
|
57
|
+
child.stderr?.on("data", (chunk) => {
|
|
58
|
+
if (said.length < 300)
|
|
59
|
+
said += chunk;
|
|
60
|
+
});
|
|
61
|
+
child.on("error", (e) => resolve(`${SANDBOX_EXEC} could not be run: ${e.message.slice(0, 300)}`));
|
|
62
|
+
child.on("close", (code, signal) => resolve(code === 0 ? undefined : `${code === null ? `signal ${signal ?? "none"}` : `exit ${code}`}${said.trim() !== "" ? `: ${said.trim().slice(0, 300)}` : ""}`));
|
|
63
|
+
});
|
|
64
|
+
}
|
|
18
65
|
function resolvePath(cwd, path) {
|
|
19
66
|
if (isAbsolute(path))
|
|
20
67
|
return path;
|
|
@@ -116,6 +163,8 @@ function toFileError(error, path) {
|
|
|
116
163
|
return new FileError("permission_denied", message, path, cause);
|
|
117
164
|
case "ENOTDIR":
|
|
118
165
|
return new FileError("not_directory", message, path, cause);
|
|
166
|
+
case "ELOOP":
|
|
167
|
+
return new FileError("symlink_loop", message, path, cause);
|
|
119
168
|
case "EISDIR":
|
|
120
169
|
return new FileError("is_directory", message, path, cause);
|
|
121
170
|
case "ENAMETOOLONG":
|
|
@@ -146,6 +195,106 @@ function isFsSupportError(error) {
|
|
|
146
195
|
return code === "EINVAL" || code === "ENOTSUP" || code === "EPERM" || code === "ENOSYS";
|
|
147
196
|
}
|
|
148
197
|
const RENAME_FALLBACK_CODES = new Set(["EXDEV", "EPERM", "EEXIST", "EBUSY"]);
|
|
198
|
+
const NAME_MAX_BYTES = 255;
|
|
199
|
+
const STAGING_SUFFIX = /\.tmp\.(\d+)\.[0-9a-f]{12}$/;
|
|
200
|
+
function stagingSuffix(pid) {
|
|
201
|
+
return `.tmp.${pid}.${randomUUID().replace(/-/g, "").slice(0, 12)}`;
|
|
202
|
+
}
|
|
203
|
+
function stagingNameOf(name, suffix) {
|
|
204
|
+
const nameBytes = Buffer.byteLength(name, "utf8");
|
|
205
|
+
const room = NAME_MAX_BYTES - Buffer.byteLength(suffix, "utf8");
|
|
206
|
+
if (nameBytes <= room || nameBytes > NAME_MAX_BYTES)
|
|
207
|
+
return `${name}${suffix}`;
|
|
208
|
+
let kept = "";
|
|
209
|
+
let used = 0;
|
|
210
|
+
for (const char of name) {
|
|
211
|
+
const bytes = Buffer.byteLength(char, "utf8");
|
|
212
|
+
if (used + bytes > room)
|
|
213
|
+
break;
|
|
214
|
+
kept += char;
|
|
215
|
+
used += bytes;
|
|
216
|
+
}
|
|
217
|
+
return `${kept}${suffix}`;
|
|
218
|
+
}
|
|
219
|
+
function stagingSiblingOf(target) {
|
|
220
|
+
const suffix = stagingSuffix(process.pid);
|
|
221
|
+
const name = basename(target);
|
|
222
|
+
if (!target.endsWith(name))
|
|
223
|
+
return `${target}${suffix}`;
|
|
224
|
+
return `${target.slice(0, target.length - name.length)}${stagingNameOf(name, suffix)}`;
|
|
225
|
+
}
|
|
226
|
+
function processIsGone(pid) {
|
|
227
|
+
if (!Number.isSafeInteger(pid) || pid < 1)
|
|
228
|
+
return false;
|
|
229
|
+
try {
|
|
230
|
+
process.kill(pid, 0);
|
|
231
|
+
return false;
|
|
232
|
+
}
|
|
233
|
+
catch (error) {
|
|
234
|
+
return isNodeError(error) && error.code === "ESRCH";
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
async function sweepDeadStaging(target) {
|
|
238
|
+
const name = basename(target);
|
|
239
|
+
if (!target.endsWith(name))
|
|
240
|
+
return 0;
|
|
241
|
+
const prefix = target.slice(0, target.length - name.length);
|
|
242
|
+
let entries;
|
|
243
|
+
try {
|
|
244
|
+
entries = await readdir(dirname(target));
|
|
245
|
+
}
|
|
246
|
+
catch {
|
|
247
|
+
return 0;
|
|
248
|
+
}
|
|
249
|
+
let swept = 0;
|
|
250
|
+
for (const entry of entries) {
|
|
251
|
+
if (entry === name)
|
|
252
|
+
continue;
|
|
253
|
+
const tail = STAGING_SUFFIX.exec(entry);
|
|
254
|
+
if (tail === null || entry !== stagingNameOf(name, tail[0]) || !processIsGone(Number(tail[1])))
|
|
255
|
+
continue;
|
|
256
|
+
const at = `${prefix}${entry}`;
|
|
257
|
+
if (SWEEPING.has(at))
|
|
258
|
+
continue;
|
|
259
|
+
SWEEPING.add(at);
|
|
260
|
+
try {
|
|
261
|
+
const st = await lstat(at);
|
|
262
|
+
if (!st.isFile() || st.nlink !== 1)
|
|
263
|
+
continue;
|
|
264
|
+
await unlink(at);
|
|
265
|
+
swept += 1;
|
|
266
|
+
}
|
|
267
|
+
catch {
|
|
268
|
+
}
|
|
269
|
+
finally {
|
|
270
|
+
SWEEPING.delete(at);
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
return swept;
|
|
274
|
+
}
|
|
275
|
+
const SWEEPING = new Set();
|
|
276
|
+
async function discardStaging(tmp) {
|
|
277
|
+
try {
|
|
278
|
+
await unlink(tmp);
|
|
279
|
+
return undefined;
|
|
280
|
+
}
|
|
281
|
+
catch (error) {
|
|
282
|
+
const code = isNodeError(error) ? error.code : undefined;
|
|
283
|
+
return code === "ENOENT" ? undefined : { path: tmp, sentence: `staging file left at ${tmp} (${code ?? "unlink failed"})` };
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
function withStagingResidue(result, left, onNotice) {
|
|
287
|
+
if (left === undefined)
|
|
288
|
+
return result;
|
|
289
|
+
if (result.ok) {
|
|
290
|
+
if (typeof onNotice === "function") {
|
|
291
|
+
deliverEngineNotice(onNotice, { code: "fs.staging_file_left", message: `${left.sentence}; the write itself succeeded`, detail: { path: left.path } });
|
|
292
|
+
}
|
|
293
|
+
return result;
|
|
294
|
+
}
|
|
295
|
+
const { code, message, path, cause } = result.error;
|
|
296
|
+
return err(new FileError(code, `${message}; ${left.sentence}`, path, cause instanceof Error ? cause : undefined));
|
|
297
|
+
}
|
|
149
298
|
async function pathExists(path) {
|
|
150
299
|
try {
|
|
151
300
|
await access(path, constants.F_OK);
|
|
@@ -314,6 +463,9 @@ export function openSpoolPair(base) {
|
|
|
314
463
|
}
|
|
315
464
|
export class NodeExecutionEnv {
|
|
316
465
|
cwd;
|
|
466
|
+
capabilities;
|
|
467
|
+
confined;
|
|
468
|
+
profileApplies = new Map();
|
|
317
469
|
get homeDir() {
|
|
318
470
|
return this.childEnvForRead()?.HOME;
|
|
319
471
|
}
|
|
@@ -347,6 +499,9 @@ export class NodeExecutionEnv {
|
|
|
347
499
|
spoolPairs = new Set();
|
|
348
500
|
backgroundCapabilities;
|
|
349
501
|
constructor(options) {
|
|
502
|
+
if (options.readFloorConfinement !== undefined && options.readFloorConfinement !== "os") {
|
|
503
|
+
throw new Error(`NodeExecutionEnv: readFloorConfinement must be "os" or absent (got ${JSON.stringify(options.readFloorConfinement) ?? typeof options.readFloorConfinement}) — a confinement request that cannot be read is no request, so it refuses instead of reading as one side.`);
|
|
504
|
+
}
|
|
350
505
|
this.cwd = options.cwd;
|
|
351
506
|
this.shellPath = options.shellPath;
|
|
352
507
|
this.shellEnv = options.shellEnv;
|
|
@@ -358,6 +513,16 @@ export class NodeExecutionEnv {
|
|
|
358
513
|
this.retainBackgroundProcesses = options.retainBackgroundProcesses ?? false;
|
|
359
514
|
this.onSecretEnvScrub = options.onSecretEnvScrub;
|
|
360
515
|
this.onNotice = options.onNotice;
|
|
516
|
+
const probe = options.readFloorConfinement === "os" ? probeReadFloorConfinement() : undefined;
|
|
517
|
+
this.confined = probe?.ok === true;
|
|
518
|
+
this.capabilities = this.confined ? NODE_ENV_CONFINED_CAPABILITIES : NODE_ENV_CAPABILITIES;
|
|
519
|
+
if (probe !== undefined && !probe.ok) {
|
|
520
|
+
deliverEngineNotice(this.onNotice, {
|
|
521
|
+
code: "config.read_floor_confinement_unavailable",
|
|
522
|
+
message: `Process confinement of the byte floor was requested (readFloorConfinement: "os") and is not available: ${probe.reason}. This environment declares that it does not keep the floor (capabilities.keepsReadFloor is false), so a run with read-deny rows is announced or, under readDenyFloorRequired, refused.`,
|
|
523
|
+
detail: { reason: probe.reason },
|
|
524
|
+
});
|
|
525
|
+
}
|
|
361
526
|
this.backgroundCapabilities = {
|
|
362
527
|
supported: true,
|
|
363
528
|
maxConcurrent: 8,
|
|
@@ -399,6 +564,27 @@ export class NodeExecutionEnv {
|
|
|
399
564
|
const named = parts.map((part, i) => (i === 0 ? part : part.replace(leading, ""))).filter((part) => part !== "");
|
|
400
565
|
return ok(named.length === 0 ? "." : named.reduce((at, part) => anchorAtLinkDir(at, part, sep)));
|
|
401
566
|
}
|
|
567
|
+
async startOf(shell, command, floor) {
|
|
568
|
+
const start = { command: shell.shell, args: [...shell.args, command] };
|
|
569
|
+
if (!this.confined)
|
|
570
|
+
return { ok: true, ...start };
|
|
571
|
+
const confined = confineShellStart(start, floor);
|
|
572
|
+
if (!confined.ok)
|
|
573
|
+
return { ok: false, reason: `the read-deny row ${JSON.stringify(confined.row)} cannot be kept by this environment's process confinement (${confined.reason}) — the command was not started` };
|
|
574
|
+
if (confined.profile === undefined)
|
|
575
|
+
return { ok: true, ...confined.start };
|
|
576
|
+
let applies = this.profileApplies.get(confined.profile);
|
|
577
|
+
if (applies === undefined) {
|
|
578
|
+
if (this.profileApplies.size >= 16)
|
|
579
|
+
this.profileApplies.clear();
|
|
580
|
+
applies = profileApplyFailure(confined.profile);
|
|
581
|
+
this.profileApplies.set(confined.profile, applies);
|
|
582
|
+
}
|
|
583
|
+
const failed = await applies;
|
|
584
|
+
if (failed !== undefined)
|
|
585
|
+
return { ok: false, reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
|
|
586
|
+
return { ok: true, ...confined.start };
|
|
587
|
+
}
|
|
402
588
|
async exec(command, options) {
|
|
403
589
|
if (options?.abortSignal?.aborted) {
|
|
404
590
|
return err(new ExecutionError("aborted", "aborted"));
|
|
@@ -408,6 +594,9 @@ export class NodeExecutionEnv {
|
|
|
408
594
|
if (!shellConfig.ok) {
|
|
409
595
|
return shellConfig;
|
|
410
596
|
}
|
|
597
|
+
const start = await this.startOf(shellConfig.value, command, options?.readFloor);
|
|
598
|
+
if (!start.ok)
|
|
599
|
+
return err(new ExecutionError("spawn_error", start.reason));
|
|
411
600
|
return await new Promise((resolvePromise) => {
|
|
412
601
|
const stdoutTail = new RollingTailBuffer();
|
|
413
602
|
const stderrTail = new RollingTailBuffer();
|
|
@@ -506,7 +695,7 @@ export class NodeExecutionEnv {
|
|
|
506
695
|
execSpoolFds = undefined;
|
|
507
696
|
};
|
|
508
697
|
try {
|
|
509
|
-
child = spawn(
|
|
698
|
+
child = spawn(start.command, [...start.args], {
|
|
510
699
|
cwd,
|
|
511
700
|
detached: process.platform !== "win32",
|
|
512
701
|
env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
|
|
@@ -883,10 +1072,23 @@ export class NodeExecutionEnv {
|
|
|
883
1072
|
existingMode = st.mode & 0o7777;
|
|
884
1073
|
}
|
|
885
1074
|
}
|
|
886
|
-
const
|
|
1075
|
+
const swept = await sweepDeadStaging(target);
|
|
1076
|
+
if (swept > 0 && typeof this.onNotice === "function") {
|
|
1077
|
+
deliverEngineNotice(this.onNotice, {
|
|
1078
|
+
code: "fs.staging_file_swept",
|
|
1079
|
+
message: `removed ${swept} staging file${swept === 1 ? "" : "s"} that a process which no longer runs left beside a file this write replaces`,
|
|
1080
|
+
detail: { count: swept },
|
|
1081
|
+
});
|
|
1082
|
+
}
|
|
1083
|
+
const afterSweepAbort = abortResult(abortSignal, resolved);
|
|
1084
|
+
if (afterSweepAbort)
|
|
1085
|
+
return afterSweepAbort;
|
|
1086
|
+
const tmp = stagingSiblingOf(target);
|
|
887
1087
|
let tmpDurable = false;
|
|
1088
|
+
let created = false;
|
|
888
1089
|
try {
|
|
889
|
-
const handle = await open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0));
|
|
1090
|
+
const handle = await open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), existingMode === undefined ? 0o666 : 0o600);
|
|
1091
|
+
created = true;
|
|
890
1092
|
try {
|
|
891
1093
|
await handle.writeFile(content, { signal: abortSignal });
|
|
892
1094
|
if (existingMode !== undefined) {
|
|
@@ -912,17 +1114,15 @@ export class NodeExecutionEnv {
|
|
|
912
1114
|
}
|
|
913
1115
|
}
|
|
914
1116
|
catch (error) {
|
|
915
|
-
await
|
|
1117
|
+
const left = created ? await discardStaging(tmp) : undefined;
|
|
916
1118
|
if (isNodeError(error) && error.code === "EACCES" && existingMode !== undefined) {
|
|
917
|
-
return await this.writeFileInPlace(resolved, content, abortSignal);
|
|
1119
|
+
return withStagingResidue(await this.writeFileInPlace(resolved, content, abortSignal), left, this.onNotice);
|
|
918
1120
|
}
|
|
919
|
-
return err(toFileError(error, resolved));
|
|
1121
|
+
return withStagingResidue(err(toFileError(error, resolved)), left, this.onNotice);
|
|
920
1122
|
}
|
|
921
1123
|
const preRenameAbort = abortResult(abortSignal, resolved);
|
|
922
|
-
if (preRenameAbort)
|
|
923
|
-
await
|
|
924
|
-
return preRenameAbort;
|
|
925
|
-
}
|
|
1124
|
+
if (preRenameAbort)
|
|
1125
|
+
return withStagingResidue(preRenameAbort, await discardStaging(tmp), this.onNotice);
|
|
926
1126
|
try {
|
|
927
1127
|
await rename(tmp, target);
|
|
928
1128
|
return ok(undefined);
|
|
@@ -931,19 +1131,19 @@ export class NodeExecutionEnv {
|
|
|
931
1131
|
const code = isNodeError(error) ? error.code : undefined;
|
|
932
1132
|
if (tmpDurable && code !== undefined && RENAME_FALLBACK_CODES.has(code)) {
|
|
933
1133
|
const inPlace = await this.writeFileInPlace(resolved, content, abortSignal);
|
|
934
|
-
if (inPlace.ok)
|
|
935
|
-
await
|
|
936
|
-
return inPlace;
|
|
937
|
-
}
|
|
1134
|
+
if (inPlace.ok || inPlace.error.code === "aborted")
|
|
1135
|
+
return withStagingResidue(inPlace, await discardStaging(tmp), this.onNotice);
|
|
938
1136
|
return err(new FileError("unknown", `write to ${resolved} failed after the atomic rename was refused (${code}): ${inPlace.error.message}. The new content was preserved at ${tmp}`, resolved, inPlace.error));
|
|
939
1137
|
}
|
|
940
|
-
|
|
941
|
-
return err(toFileError(error, resolved));
|
|
1138
|
+
return withStagingResidue(err(toFileError(error, resolved)), await discardStaging(tmp), this.onNotice);
|
|
942
1139
|
}
|
|
943
1140
|
}
|
|
944
1141
|
async writeFileInPlace(resolved, content, abortSignal) {
|
|
1142
|
+
const aborted = abortResult(abortSignal, resolved);
|
|
1143
|
+
if (aborted)
|
|
1144
|
+
return aborted;
|
|
945
1145
|
try {
|
|
946
|
-
await writeFile(resolved, content
|
|
1146
|
+
await writeFile(resolved, content);
|
|
947
1147
|
return ok(undefined);
|
|
948
1148
|
}
|
|
949
1149
|
catch (error) {
|
|
@@ -967,7 +1167,7 @@ export class NodeExecutionEnv {
|
|
|
967
1167
|
return afterMkdirAbort;
|
|
968
1168
|
}
|
|
969
1169
|
try {
|
|
970
|
-
await writeFile(resolved, content, {
|
|
1170
|
+
await writeFile(resolved, content, { flag: "wx" });
|
|
971
1171
|
return ok(undefined);
|
|
972
1172
|
}
|
|
973
1173
|
catch (error) {
|
|
@@ -1308,6 +1508,9 @@ export class NodeExecutionEnv {
|
|
|
1308
1508
|
if (!shellConfig.ok) {
|
|
1309
1509
|
return err(new BackgroundShellError("spawn_failed", shellConfig.error.message, shellConfig.error));
|
|
1310
1510
|
}
|
|
1511
|
+
const start = await this.startOf(shellConfig.value, command, options?.readFloor);
|
|
1512
|
+
if (!start.ok)
|
|
1513
|
+
return err(new BackgroundShellError("spawn_failed", start.reason));
|
|
1311
1514
|
let spool;
|
|
1312
1515
|
let spoolFds;
|
|
1313
1516
|
if (this.retainBackgroundProcesses || process.platform !== "win32") {
|
|
@@ -1328,7 +1531,7 @@ export class NodeExecutionEnv {
|
|
|
1328
1531
|
}
|
|
1329
1532
|
let child;
|
|
1330
1533
|
try {
|
|
1331
|
-
child = spawn(
|
|
1534
|
+
child = spawn(start.command, [...start.args], {
|
|
1332
1535
|
cwd: options?.cwd ? resolvePath(this.cwd, options.cwd) : this.cwd,
|
|
1333
1536
|
detached: process.platform !== "win32",
|
|
1334
1537
|
env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
|
|
@@ -6,8 +6,9 @@ import type { HaltRemainingDirective } from "../loop/types.js";
|
|
|
6
6
|
import type { AgentMessage, AgentTool, AgentToolCall, LoopMalformedToolUseRecovery, LoopThinkingOnlyRecovery, LoopTruncatedOutputRecovery, QueueMode, ThinkingLevel } from "../loop/types.js";
|
|
7
7
|
import { type EngineSegment } from "../../core/untrusted-text.js";
|
|
8
8
|
import { type RunOrigin } from "../../core/run-origin.js";
|
|
9
|
+
import { type InputAuthor } from "../../core/input-author.js";
|
|
9
10
|
import type { CommittedFrameCarrier } from "../../core/frame-settlement.js";
|
|
10
|
-
import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PromptTemplate, Skill } from "./types.js";
|
|
11
|
+
import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
|
|
11
12
|
/** [c209-C] 收口 C1/C2 — engine-provenance metadata a caller can stamp on the user message it
|
|
12
13
|
* mints (see the field docs on {@link UserMessage}). Threaded from `prompt`/`steer`/`followUp`/
|
|
13
14
|
* `nextTurn` options into the persisted message so derived views (auto-mode window, compaction
|
|
@@ -51,6 +52,12 @@ export interface TrailingMessageSeed {
|
|
|
51
52
|
export interface PromptTrailing {
|
|
52
53
|
trailing?: readonly TrailingMessageSeed[];
|
|
53
54
|
}
|
|
55
|
+
/** `prompt()` option: the prompt RECORDS a decision that ended the turn awaiting the user (a person's bare refusal) and
|
|
56
|
+
* owes no model turn — what joins it at turn open (engine notes only) rides along unanswered, the steer / follow-up
|
|
57
|
+
* drain points still continue the run, and an ending with no new answer answers with the last assistant message. */
|
|
58
|
+
export interface PromptEndsAwaitingUser {
|
|
59
|
+
endsAwaitingUser?: true;
|
|
60
|
+
}
|
|
54
61
|
export interface UserMessageProvenance {
|
|
55
62
|
/** Exact char length of the engine-prepended prefix on `text` (first-frame reminders etc.).
|
|
56
63
|
* Sugar for the single segment `[0, chars)` — when `engineSegments` is also supplied, segments win. */
|
|
@@ -65,13 +72,14 @@ export interface UserMessageProvenance {
|
|
|
65
72
|
/** [c209-C] R3: engine-injected note whose content must stay VISIBLE in derived views (diagnostics,
|
|
66
73
|
* task notifications, steering, recall) but never under user authority — see UserMessage.provenance. */
|
|
67
74
|
provenance?: "engine-note";
|
|
68
|
-
/**
|
|
69
|
-
* engine-authored guidance. Rides only WITH `provenance:"engine-note"` (the projection semantics are
|
|
70
|
-
* identical — visible, never `[user]` authority); what it changes is the run-control judgment: the
|
|
71
|
-
*
|
|
72
|
-
*
|
|
73
|
-
* frames — never inferred from text. Metadata only; not
|
|
74
|
-
|
|
75
|
+
/** Who wrote the input this frame's CONTENT is ({@link InputAuthor}) — an input relayed by the engine (a TaskStream steer, the
|
|
76
|
+
* observer's report), not engine-authored guidance. Rides only WITH `provenance:"engine-note"` (the projection semantics are
|
|
77
|
+
* identical — visible, never `[user]` authority); what it changes is the run-control judgment: the human-halt hold below
|
|
78
|
+
* treats an authored frame as input (always passes) while an engine-authored one is held, and only a frame whose author
|
|
79
|
+
* counts as the operator's (`countsAsOperator`) is the person's input — parkable across a pause, on the undelivered-input
|
|
80
|
+
* account. Minter-stated at the single relay seam that mints such frames — never inferred from text. Metadata only; not
|
|
81
|
+
* persisted on the message. */
|
|
82
|
+
author?: InputAuthor;
|
|
75
83
|
/** #1036 — the frame's injection-queue dedup key, persisted on the message it becomes
|
|
76
84
|
* ({@link UserMessage.engineNoteKey}) so a reader of the TRANSCRIPT alone can join an entry back
|
|
77
85
|
* to its frame. Rides only WITH `provenance:"engine-note"`. */
|
|
@@ -155,6 +163,14 @@ export interface HarnessLoopRecovery {
|
|
|
155
163
|
withholdErrorEvents?: boolean;
|
|
156
164
|
};
|
|
157
165
|
}
|
|
166
|
+
/** How a durable park's commit ended, for the rows its gate took off the port ({@link AgentHarness.parkCapture}): the row
|
|
167
|
+
* holds them (`committed`), no row was written (`absent`), or whether one was is unknown (`indeterminate`). */
|
|
168
|
+
type ParkCaptureOutcome = "committed" | "absent" | "indeterminate";
|
|
169
|
+
/** The port's held rows as a park's gate took them, in queue order, and the one call that says how the commit ended. */
|
|
170
|
+
interface ParkCapture {
|
|
171
|
+
readonly rows: readonly AgentMessage[];
|
|
172
|
+
settle(outcome: ParkCaptureOutcome): void;
|
|
173
|
+
}
|
|
158
174
|
export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate, TTool extends AgentTool = AgentTool> {
|
|
159
175
|
readonly env: ExecutionEnv;
|
|
160
176
|
private session;
|
|
@@ -179,7 +195,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
179
195
|
* per turn, so identity carries the generation); the loop's cut-consumption report is accepted for THIS seat only. */
|
|
180
196
|
private lastPublishedSeat?;
|
|
181
197
|
private readonly seatCutSources;
|
|
182
|
-
private
|
|
198
|
+
private endedOnPriorAnswer;
|
|
183
199
|
private promptReceipt?;
|
|
184
200
|
private turnCutConsumed?;
|
|
185
201
|
private readonly committedEntryIds;
|
|
@@ -204,6 +220,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
204
220
|
private runAbortController?;
|
|
205
221
|
private runPromise?;
|
|
206
222
|
private pendingSessionWrites;
|
|
223
|
+
/** A park's capture of the port's held rows, from the gate's snapshot until its commit settles: the port waits on it. */
|
|
224
|
+
private parkCaptureInFlight?;
|
|
225
|
+
/** Set when a park's commit took the port's rows, or may have: the port refuses from then on (this leg's conversation goes on from the checkpoint). */
|
|
226
|
+
private parkedPortClosed;
|
|
207
227
|
private model;
|
|
208
228
|
/** The ref that chose {@link model}, moved by the SAME assignment (one value, never two answers). */
|
|
209
229
|
private modelRef;
|
|
@@ -215,10 +235,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
215
235
|
* with every request view that needed one (the transcript is never rewritten, so a broken turn is repaired, and
|
|
216
236
|
* reported, on each request; the sink owns its dedup). Advisory: a throwing sink never breaks the request. */
|
|
217
237
|
onToolTurnRepaired?: (repairs: readonly ToolTurnRepair[]) => void;
|
|
218
|
-
/** Runner-set sink for the images a provider refused in THIS run ({@link
|
|
238
|
+
/** Runner-set sink for the images a provider refused in THIS run ({@link removeRefusedRequestParts}) — a refusal recorded
|
|
219
239
|
* before the run began is not reported. Every request re-reads the transcript, so the sink owns its dedup (by
|
|
220
240
|
* `refusalAt`). Advisory: a throwing sink never breaks the request. */
|
|
221
241
|
onImagesRemoved?: (removals: readonly RejectedImageRemoval[]) => void;
|
|
242
|
+
/** Runner-set sink for a tool whose input schema a provider refused in THIS run, told when the loop re-sends the turn
|
|
243
|
+
* without it (the loop config's `onToolSchemaRefused`). Advisory: a throwing sink never breaks the re-send. */
|
|
244
|
+
onToolSchemaRefused?: (refusal: {
|
|
245
|
+
tool: string;
|
|
246
|
+
refusalAt: number;
|
|
247
|
+
}) => void;
|
|
222
248
|
/** The image refusals standing in the transcript when the current run began, by their identity
|
|
223
249
|
* ({@link RejectedImageRemoval.refusalAt}): the run that met them announced them. */
|
|
224
250
|
private priorImageRefusals?;
|
|
@@ -241,6 +267,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
241
267
|
steer: readonly unknown[];
|
|
242
268
|
followUp: readonly unknown[];
|
|
243
269
|
}) => void;
|
|
270
|
+
/** The same terminal moment's inputs that are NOT the operator's ({@link UserMessageProvenance.author} outside
|
|
271
|
+
* `countsAsOperator`, e.g. an observer's report): never parked and never on the account above, they end with the run;
|
|
272
|
+
* handed over by author, in service order, so the runner can say once that they were dropped. */
|
|
273
|
+
onUndrainedOtherInputs?: (authors: readonly InputAuthor[]) => void;
|
|
244
274
|
/** design/176 — runner-set sink fired at the CONSUMPTION boundary, once per engine-note payload,
|
|
245
275
|
* in consumption order (steer/followUp drain and the turn-open nextTurn splice — the two points
|
|
246
276
|
* where a queued frame actually enters the model's input). The runner uses it to record the
|
|
@@ -276,7 +306,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
276
306
|
* minted it. */
|
|
277
307
|
engineInjectionsHeld?: () => boolean;
|
|
278
308
|
/** The provider boundary's tool-turn law: the repaired view goes to the brain, the repairs to the runner's sink. */
|
|
279
|
-
/** The request view of `messages` under the provider's image refusals they hold ({@link
|
|
309
|
+
/** The request view of `messages` under the provider's image refusals they hold ({@link removeRefusedRequestParts}), and
|
|
280
310
|
* the removals this run met handed to {@link onImagesRemoved}. */
|
|
281
311
|
private imageRefusalView;
|
|
282
312
|
private holdToolTurnLaw;
|
|
@@ -294,9 +324,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
294
324
|
private sweepUndrainedEngineNotes;
|
|
295
325
|
/**
|
|
296
326
|
* How much of a PERSON's input is currently accepted-but-unserved, per lane — the one predicate behind
|
|
297
|
-
* both readers below, so "a person's input is waiting" cannot come to mean two things.
|
|
298
|
-
*
|
|
299
|
-
* is as pending as one that never left it).
|
|
327
|
+
* both readers below, so "a person's input is waiting" cannot come to mean two things. Only the operator's
|
|
328
|
+
* input counts ({@link isOperatorInput}: engine-AUTHORED frames and inputs another author wrote are out), and the
|
|
329
|
+
* IN-FLIGHT slot counts (a frame spliced out of a queue and never injected is as pending as one that never left it).
|
|
300
330
|
*/
|
|
301
331
|
private pendingUserInputFramesByLane;
|
|
302
332
|
private pendingUserInputsByLane;
|
|
@@ -336,10 +366,11 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
336
366
|
private stallTimeoutsPerCall?;
|
|
337
367
|
private abortResultDetails?;
|
|
338
368
|
private executeTool?;
|
|
369
|
+
private admitRows;
|
|
339
370
|
private activeRun?;
|
|
340
371
|
private loopTrace?;
|
|
341
372
|
private onToolInputValidationFault?;
|
|
342
|
-
private
|
|
373
|
+
private toolResultMedia;
|
|
343
374
|
private resilience?;
|
|
344
375
|
private maxToolConcurrency?;
|
|
345
376
|
private streamingToolExecution?;
|
|
@@ -436,7 +467,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
436
467
|
images?: ImageContent[];
|
|
437
468
|
settleUnansweredToolCalls?: TrailingToolBatchOptions;
|
|
438
469
|
onCommitted?: PromptCommittedCallback;
|
|
439
|
-
} & UserMessageProvenance & PromptTrailing): Promise<AssistantMessage | undefined>;
|
|
470
|
+
} & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser): Promise<AssistantMessage | undefined>;
|
|
440
471
|
/** R2-③: an empty/whitespace-only injection with no images carries ZERO information — it
|
|
441
472
|
* must not mint a user frame (strict endpoints reject empty user content, and an empty follow-up would
|
|
442
473
|
* pointlessly extend the run by one turn). No-op, not a throw: injection callers are fire-and-
|
|
@@ -577,7 +608,11 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
577
608
|
nextTurn(text: string, options?: {
|
|
578
609
|
images?: ImageContent[];
|
|
579
610
|
} & UserMessageProvenance): Promise<void>;
|
|
580
|
-
|
|
611
|
+
/** The admission seat first (a raised row carries its `raising`; one the seat does not keep is not stored), then the store:
|
|
612
|
+
* at once when no turn runs and nothing is held before it, else queued for the next serialization point. A park's capture
|
|
613
|
+
* in progress is waited out; once a park took (or may have taken) the held rows, the row is refused — no running loop
|
|
614
|
+
* takes it. */
|
|
615
|
+
appendMessage(message: AgentMessage, raising?: RowRaising): Promise<void>;
|
|
581
616
|
/** The loop's `afterToolCall`: one `tool_result` hook emit per executed call (every registered handler, one fold). */
|
|
582
617
|
private afterToolCallHook;
|
|
583
618
|
/**
|
|
@@ -639,6 +674,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
639
674
|
* the queue is empty.
|
|
640
675
|
*/
|
|
641
676
|
flushQueuedSessionWrites(): Promise<void>;
|
|
677
|
+
/**
|
|
678
|
+
* A durable park's gate takes the rows the port holds (non-destructive, in queue order) to write them on its checkpoint;
|
|
679
|
+
* until {@link ParkCapture.settle} the port waits. `committed` takes them off the queue (the resumed leg writes them) and
|
|
680
|
+
* closes the port; `indeterminate` closes the port and leaves them queued (this leg's own branch gets them if its
|
|
681
|
+
* transcript is closed again); `absent` changes nothing. Only rows are held at a park: the other queued writes come from
|
|
682
|
+
* turn ends, which flush before any park point.
|
|
683
|
+
*/
|
|
684
|
+
parkCapture(): ParkCapture;
|
|
685
|
+
/** The session writes still held (queue order) — what an interrupted run whose batch stayed open cannot write. */
|
|
686
|
+
heldSessionWrites(): readonly PendingSessionWrite[];
|
|
642
687
|
/**
|
|
643
688
|
* backlog #389 — the accepted-but-undelivered CALLER frames a durable suspend can carry forward,
|
|
644
689
|
* in delivery order (steer before followUp, each queue forward — the order the live loop serves).
|
|
@@ -646,8 +691,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
646
691
|
* for a checkpoint that never landed would be lost twice over. {@link dropParkedUserInputs} is the
|
|
647
692
|
* second half, called only once the checkpoint is durably committed.
|
|
648
693
|
*
|
|
649
|
-
* Only frames carrying a park record are returned — engine-authored notes have
|
|
650
|
-
* lane (`onUndrainedEngineNotes` → pend per session) and must not be parked twice
|
|
694
|
+
* Only the operator's frames carrying a park record are returned ({@link isOperatorInput}) — engine-authored notes have
|
|
695
|
+
* their own lossless lane (`onUndrainedEngineNotes` → pend per session) and must not be parked twice, and an input another
|
|
696
|
+
* author wrote is not the person's to carry (it ends with the run, named through `onUndrainedOtherInputs`).
|
|
651
697
|
*/
|
|
652
698
|
readParkableUserInputs(): unknown[];
|
|
653
699
|
/**
|
|
@@ -704,3 +750,4 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
|
|
|
704
750
|
type: TType;
|
|
705
751
|
}>) => Promise<AgentHarnessEventResultMap[TType]> | AgentHarnessEventResultMap[TType]): () => void;
|
|
706
752
|
}
|
|
753
|
+
export {};
|