@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
package/dist/core/tool-spec.d.ts
CHANGED
|
@@ -192,7 +192,9 @@ export interface ToolSpec<TParams extends TSchema = TSchema> {
|
|
|
192
192
|
* runtime tracking of what the child actually did is involved (that is the v2 ticket). `authored`
|
|
193
193
|
* marks the entries minted from a definition a caller wrote on a tool a deployment mounted (not the
|
|
194
194
|
* engine's built-ins, the general-purpose alias, fork, or the engine's nested copy of the tool for a
|
|
195
|
-
* delegated child); prepare's deny-name check judges only those.
|
|
195
|
+
* delegated child); prepare's deny-name check judges only those. `servers` are the MCP servers the definition declares itself
|
|
196
|
+
* (`AgentDefinition.mcp`): part of the child's universe for both readers, and its `allowTools` is the list the child's own layer is
|
|
197
|
+
* minted from (the written one, admitting every tool of those servers).
|
|
196
198
|
*/
|
|
197
199
|
agentToolFaces?: ReadonlyArray<{
|
|
198
200
|
name: string;
|
|
@@ -200,6 +202,10 @@ export interface ToolSpec<TParams extends TSchema = TSchema> {
|
|
|
200
202
|
denyTools?: readonly string[];
|
|
201
203
|
canRedelegate?: boolean;
|
|
202
204
|
authored?: true;
|
|
205
|
+
servers?: ReadonlyArray<{
|
|
206
|
+
name: string;
|
|
207
|
+
contentOrigin?: import("./types.js").ToolContentOrigin;
|
|
208
|
+
}>;
|
|
203
209
|
}>;
|
|
204
210
|
/**
|
|
205
211
|
* The tool-level `denyTools` list of the delegation tool (`SubagentToolOptions.denyTools`, applied when no agent definition is
|
|
@@ -740,9 +746,9 @@ export interface ToolExecuteContext {
|
|
|
740
746
|
* is rejected — this seat never widens, it only reopens the documented re-supply channel to
|
|
741
747
|
* the parked-decide lane). Absent ⇒ exactly the previous behavior.
|
|
742
748
|
*
|
|
743
|
-
* One entry kind is NOT a policy the deployment authored: a
|
|
744
|
-
*
|
|
745
|
-
*
|
|
749
|
+
* One entry kind is NOT a policy the deployment authored: a mods-wired parent contributes a
|
|
750
|
+
* SCREENING entry (issue #33), its installation. Rebuild it as `{ installation: await
|
|
751
|
+
* admitModChain(…), hookEnv, …regime }` over the same registrations and the same installed env,
|
|
746
752
|
* or the chain handed back here will be short and rejected on the count check. A face that only
|
|
747
753
|
* observes should be declared `{ observe: true }` instead, and then never enters the chain
|
|
748
754
|
* at all; a park under a screening entry announces the requirement on `onError`
|
|
@@ -819,6 +825,13 @@ export interface ToolExecuteContext {
|
|
|
819
825
|
* the tool runs outside a Runner task.
|
|
820
826
|
*/
|
|
821
827
|
parentCwd?: string;
|
|
828
|
+
/**
|
|
829
|
+
* The RUNNING task's own placement target (Runner-filled, read-only, never a model argument): what its execution
|
|
830
|
+
* environment reported as its workspace settled. A delegation tool hands it, as is, to every agent it spawns or wakes
|
|
831
|
+
* (`RunInternals.placementTarget` — the fence that agent's env is minted under). Absent outside a Runner task, and when
|
|
832
|
+
* the environment reported none (not remote, or its handle could not answer yet).
|
|
833
|
+
*/
|
|
834
|
+
placementTarget?: import("./remote-env.js").PlacementTarget;
|
|
822
835
|
/** The deployment's compiled host floor (`RunnerDeps.hostFloor`; Runner-filled, read-only, never a model argument): an engine executor
|
|
823
836
|
* that connects — the fetch tool on every hop, WebSearch's SearXNG backend (handed it in the backend's `opts.hostFloor`) — judges each URL
|
|
824
837
|
* by it before the request. Absent outside a Runner, or when none is declared. */
|
|
@@ -958,8 +971,8 @@ export interface ToolExecuteContext {
|
|
|
958
971
|
* from its roster, so a question it needed to ask silently became a guess.
|
|
959
972
|
*
|
|
960
973
|
* Forwarded VERBATIM, unlike `onAsk`'s provenance-stamped wrapper: a content ask carries its issuing
|
|
961
|
-
* identity in the request itself (`AskQuestionRequest.principal` + `
|
|
962
|
-
* own prepare fills from the child's inherited principal
|
|
974
|
+
* identity in the request itself (`AskQuestionRequest.principal` + `sourceSessionId` + `agentId`, which the
|
|
975
|
+
* child's own prepare fills from the child's inherited principal, its Runner-minted session id and its task id), and
|
|
963
976
|
* nothing in the question path does approver-identity collapse (the reason the permission wrapper
|
|
964
977
|
* exists). Wrapping here would add a field no consumer reads and a second function identity for one
|
|
965
978
|
* decision-maker.
|
|
@@ -1174,10 +1187,11 @@ export interface ToolExecuteContext {
|
|
|
1174
1187
|
/**
|
|
1175
1188
|
* A read-only CAPTURE of this (parent) task's request allow entries for the run ({@link import("./task-spec.js").TaskSpec.allowedTools},
|
|
1176
1189
|
* its own and any it inherited), filled by the Runner beside {@link activeSkillGrants}: a delegation tool reads it AT SPAWN
|
|
1177
|
-
* TIME and threads it into the child, which holds them as its own request rows until it ends
|
|
1178
|
-
*
|
|
1190
|
+
* TIME and threads it into the child, which holds them as its own request rows until it ends — an anchored member with its
|
|
1191
|
+
* set's anchors, so the child reads its path rule where the parent did. A copy; the model can neither read nor set it.
|
|
1192
|
+
* Undefined when the tool runs outside a Runner task.
|
|
1179
1193
|
*/
|
|
1180
|
-
activeRequestAllowedTools?: () => readonly
|
|
1194
|
+
activeRequestAllowedTools?: () => readonly import("./allow-entry.js").AllowListEntry[];
|
|
1181
1195
|
/**
|
|
1182
1196
|
* Parent effective-policy inheritance (tighten-only) — the Runner-filled chain accessor a delegation tool
|
|
1183
1197
|
* (`createSubagentTool` / the `run_workflow` spawn legs) calls AT SPAWN TIME and threads verbatim into the
|
|
@@ -1285,7 +1299,7 @@ export interface ToolExecuteContext {
|
|
|
1285
1299
|
*/
|
|
1286
1300
|
checkpointScopeForChildren?: string;
|
|
1287
1301
|
/**
|
|
1288
|
-
* design/99 (nested-subagent live observability): the host run's stable taskId (
|
|
1302
|
+
* design/99 (nested-subagent live observability): the host run's stable taskId (the leg's single mint),
|
|
1289
1303
|
* filled by the Runner. A delegation tool (`createSubagentTool`) reads it AT SPAWN TIME and threads it into the
|
|
1290
1304
|
* child as the child's `parentTaskId`, so a UI can build the live nested-agent tree (child.parentTaskId === this
|
|
1291
1305
|
* taskId). Undefined when the tool runs outside a Runner task.
|
|
@@ -1318,6 +1332,10 @@ export interface ToolExecuteContext {
|
|
|
1318
1332
|
onTaskNotification?: (n: import("./task-notification.js").TaskNotificationPayload, opts?: {
|
|
1319
1333
|
priority?: import("./task-notification.js").SystemInjectionPriority;
|
|
1320
1334
|
}) => unknown;
|
|
1335
|
+
/** Where a background task's result is stored when its completion notification ({@link onTaskNotification}) carries
|
|
1336
|
+
* less than the whole of it — the run's offload store, read back with `ReadToolResult`. Present exactly when the run
|
|
1337
|
+
* has one; absent ⇒ a cut notification says the full text is not readable from this session. TRUSTED, run-scoped. */
|
|
1338
|
+
taskArtifacts?: import("./tool-result-store.js").TaskArtifactSeat;
|
|
1321
1339
|
/**
|
|
1322
1340
|
* design/99 (nested-subagent live observability): the host run's OPT-IN display sink — a deployment sets it (via
|
|
1323
1341
|
* `RunInternals.onForwardEvent`) to receive a SUBAGENT's live `task_progress` ticks that otherwise stay in the
|
|
@@ -1384,6 +1402,17 @@ export interface ToolExecuteContext {
|
|
|
1384
1402
|
forkAccess?: {
|
|
1385
1403
|
denied: "task" | "principal";
|
|
1386
1404
|
};
|
|
1405
|
+
/**
|
|
1406
|
+
* The delegating leg's two agent stations over its mods bus — `agent.offer` (the offered set the delegation reads at
|
|
1407
|
+
* dispatch) and `agent.spawn` (raised before a subagent is let start). Runner-filled; never a model argument. Absent
|
|
1408
|
+
* outside a Runner: no station is raised and every type is offered.
|
|
1409
|
+
*/
|
|
1410
|
+
agentStations?: import("./mods/agent-stations.js").AgentStations;
|
|
1411
|
+
/**
|
|
1412
|
+
* The sending leg's `session.send` station over its mods bus — raised by SendMessage before it delivers a message.
|
|
1413
|
+
* Runner-filled; never a model argument. Absent outside a Runner: no station is raised.
|
|
1414
|
+
*/
|
|
1415
|
+
sendStation?: import("./mods/session-send.js").SendStation;
|
|
1387
1416
|
/**
|
|
1388
1417
|
* design/80 D-B — the general "a tool yields to a HUMAN review gate" primitive. A tool calls this to request
|
|
1389
1418
|
* that, at the next SAFE turn boundary, the engine pause with a durable `plan_review` checkpoint
|
package/dist/core/trace.d.ts
CHANGED
|
@@ -64,7 +64,6 @@ export interface PromptManifestSection {
|
|
|
64
64
|
* metadata-only rule). Field meanings: see the `stats.mechanisms` JSDoc in core/types.ts.
|
|
65
65
|
*/
|
|
66
66
|
export interface TraceMechanismsSummary {
|
|
67
|
-
finalVerifyInjected?: true;
|
|
68
67
|
finalVerifyInjections?: number;
|
|
69
68
|
attachmentsInjected?: number;
|
|
70
69
|
/** design/164: how many LIMIT-APPROACH frames were injected this run (0..2). */
|
|
@@ -97,7 +96,8 @@ export type TraceEvent = {
|
|
|
97
96
|
version: 1;
|
|
98
97
|
taskId: string;
|
|
99
98
|
/** The ENGINE-minted identity of THIS run (`TaskResult.runId`). `taskId` is
|
|
100
|
-
*
|
|
99
|
+
* the leg's task id (a background row's id, else the declared one, else the session id), so two
|
|
100
|
+
* runs of one session that declare no host task id emit two
|
|
101
101
|
* task.start frames under ONE id and a consumer pairing start↔end has no way to say which end
|
|
102
102
|
* closes which start. Present on every `task.start` (the frame is emitted after prepare, which
|
|
103
103
|
* is where the id is minted).
|
|
@@ -925,6 +925,22 @@ export type TraceEvent = {
|
|
|
925
925
|
/** True = store.put failed (or no store): the model lost read-back for this result. */
|
|
926
926
|
storeFallback: boolean;
|
|
927
927
|
ts: number;
|
|
928
|
+
} | {
|
|
929
|
+
/** A request's media trim (`media-byte-cap.ts`) left blocks out of a request that was sent: one frame per such
|
|
930
|
+
* request (the person hears each block once per session, `context.media_removed`). `items` / `base64Chars` are the
|
|
931
|
+
* request's media before the trim; `budgetBase64Chars` is absent when the deployment set no budget. */
|
|
932
|
+
kind: "context.media_removed";
|
|
933
|
+
version: 1;
|
|
934
|
+
taskId: string;
|
|
935
|
+
reason: "media_budget";
|
|
936
|
+
images: number;
|
|
937
|
+
documents: number;
|
|
938
|
+
removedBase64Chars: number;
|
|
939
|
+
items: number;
|
|
940
|
+
base64Chars: number;
|
|
941
|
+
maxItems: number;
|
|
942
|
+
budgetBase64Chars?: number;
|
|
943
|
+
ts: number;
|
|
928
944
|
} | {
|
|
929
945
|
/** C4 — image blocks were replaced with text placeholders because the served model declares no
|
|
930
946
|
* vision input (`ModelSpec.input` without "image"). Silent quality loss without this. */
|
package/dist/core/types.d.ts
CHANGED
|
@@ -18,12 +18,12 @@ export type { PermissionMode } from "./ask-origin.js";
|
|
|
18
18
|
export type { ToolEffect, ToolContentOrigin, ReversibilityVerdict, ReadRootGrantCandidate, ToolSpec, ToolReturn, NestedUsage, NestedUsageAccum, ToolExecuteContext } from "./tool-spec.js";
|
|
19
19
|
export type { BeforeWriteRequest, BeforeWriteResult, BeforeWriteHook, TrackEditRequest, TrackEditResult, TrackFileEditHook, FileEditedNotice, FileEditedHook, HandsBandOptions } from "./hands-band.js";
|
|
20
20
|
export type { AgentDefinition, SkillSpec } from "./agent-definition.js";
|
|
21
|
-
export type { McpServerSpec, A2aServerSpec, McpElicitRequest, McpElicitResponse, OnElicit, McpRevocationLedger, McpMountIdentity, DeclarationFault, DeclarationPathRule, DeclarationRead, ToolAxesRead, ToolAxesSurface } from "./mcp-server-spec.js";
|
|
22
|
-
export { DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, dataKind, declarationFaultOf, declarerWord, perToolEmptyName, perToolEntryRefusal,
|
|
21
|
+
export type { McpServerSpec, A2aServerSpec, McpElicitRequest, McpElicitResponse, OnElicit, McpRevocationLedger, McpMountIdentity, McpTransportKind, DeclarationFault, DeclarationPathRule, DeclarationRead, ToolAxesRead, ToolAxesSurface } from "./mcp-server-spec.js";
|
|
22
|
+
export { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, MCP_TRANSPORT_KINDS, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, callerText, dataKind, declarationFaultOf, declarationPath, declarerWord, perToolEmptyName, perToolEntryRefusal, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal, transportKindOf } from "./mcp-server-spec.js";
|
|
23
23
|
export type { TaskLimits } from "./task-limits.js";
|
|
24
24
|
export type { TaskStatus, RemoteEnvFailureNote, EffectiveMemoryScopes, TaskResult, HumanReviewGateRow } from "./task-result.js";
|
|
25
25
|
export type { TerminalCause, PausedCause } from "./terminal-cause.js";
|
|
26
|
-
export type { TaskEventIdentity, BrainStatusPhase, BrainRetryErrClass, BrainStatus, ToolActivity, HumanInputSource, HumanInputDelivery, DelegationTaskType, TaskEvent, HumanInputEvent, HumanInputAttachment, CompactOutcome, ExtensionRequester, RewriteAuthor, ToolInputRewrite } from "./task-event.js";
|
|
26
|
+
export type { TaskEventIdentity, BrainStatusPhase, BrainStatusSeat, BrainRetryErrClass, BrainStatus, ToolActivity, HumanInputSource, HumanInputDelivery, DelegationTaskType, TaskEvent, HumanInputEvent, HumanInputAttachment, CompactOutcome, ExtensionRequester, RewriteAuthor, ToolInputRewrite } from "./task-event.js";
|
|
27
27
|
export type { TaskStream } from "./task-stream.js";
|
|
28
28
|
export type { WorkflowGovernanceBaseline, RuntimeCaps, AutoModeDenySource } from "./runtime-caps.js";
|
|
29
29
|
export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./runtime-caps.js";
|
package/dist/core/types.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { MODEL_ROLES } from "./model-seat.js";
|
|
2
|
-
export { DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, dataKind, declarationFaultOf, declarerWord, perToolEmptyName, perToolEntryRefusal,
|
|
2
|
+
export { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, MCP_TRANSPORT_KINDS, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, callerText, dataKind, declarationFaultOf, declarationPath, declarerWord, perToolEmptyName, perToolEntryRefusal, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal, transportKindOf } from "./mcp-server-spec.js";
|
|
3
3
|
export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./runtime-caps.js";
|
|
4
4
|
export { __resetMalformedDelegationSeatAnnouncement, backgroundChildTerminal, deliverDelegationLifecycle, emitsChildRowFrames, taskStartedFrame } from "./delegation-frames.js";
|
|
5
5
|
export { __resetMalformedNoticeSeatAnnouncement, deliverEngineNotice, owedUserInputCounts, owedUserInputIds, parentLegIds, parkedInputIdsOf, settleOwedUserInput, undrainedUserInputNotices, USER_INPUT_UNDRAINED_CAUSES, USER_INPUT_UNDRAINED_FAMILIES } from "./engine-notice.js";
|
|
@@ -229,7 +229,7 @@ export const ENGINE_ENVELOPES = Object.freeze([
|
|
|
229
229
|
{
|
|
230
230
|
tag: "example",
|
|
231
231
|
kind: "not-an-envelope",
|
|
232
|
-
mint: "engine/compaction SUMMARIZATION_PROMPT (
|
|
232
|
+
mint: "engine/compaction SUMMARIZATION_PROMPT (the output skeleton shown to the summarizer, captured from an early reference build)",
|
|
233
233
|
guard: "no untrusted bytes reach it: the block is a CONSTANT that frames placeholder text (`[Concept 1]`), it wraps nothing, and it is never emitted back — the summarizer's own answer is read through the `<summary>` envelope, not this one",
|
|
234
234
|
fenced: false,
|
|
235
235
|
disclosed: false,
|
|
@@ -25,6 +25,7 @@
|
|
|
25
25
|
import type { ImageContent, TextContent, UserAttachmentSupply, UserMessageAttachment } from "../internal/llm.js";
|
|
26
26
|
import type { HumanInputAttachment } from "./task-event.js";
|
|
27
27
|
import { type ModelFileReader } from "../tools/fs/fs-read.js";
|
|
28
|
+
import { type ImageDownsampler } from "./image-downsample.js";
|
|
28
29
|
import type { SyntheticReadJudge } from "./synthetic-read-verdict.js";
|
|
29
30
|
import { type ReminderDisclosureCounts } from "./reminder-disclosure.js";
|
|
30
31
|
import { type AgentMessage } from "../internal/harness.js";
|
|
@@ -115,10 +116,11 @@ export interface UserAttachmentDeclaration {
|
|
|
115
116
|
/** The UserPromptSubmit hook's view of the declarations. */
|
|
116
117
|
export declare function userAttachmentDeclarations(screened: readonly ScreenedUserAttachment[]): readonly UserAttachmentDeclaration[];
|
|
117
118
|
/**
|
|
118
|
-
* The host images' byte admission — the one function an image the Read tool serves passes
|
|
119
|
-
* run on the captured values before any attachment is read or delivered. Throws
|
|
119
|
+
* The host images' byte admission — the one function an image the Read tool serves passes, with the run's processor.
|
|
120
|
+
* Asynchronous (it decodes), run on the captured values before any attachment is read or delivered. Throws
|
|
121
|
+
* `config.user_attachment_invalid`.
|
|
120
122
|
*/
|
|
121
|
-
export declare function admitUserAttachmentImages(screened: readonly ScreenedUserAttachment[]): Promise<ReadonlyMap<number, ImageContent>>;
|
|
123
|
+
export declare function admitUserAttachmentImages(screened: readonly ScreenedUserAttachment[], processor: ImageDownsampler | "none"): Promise<ReadonlyMap<number, ImageContent>>;
|
|
122
124
|
/** The transmission an attachment frame is (the read-state entry its delivery records carries it): when the frame leaves
|
|
123
125
|
* the request — a trim drops it — the entry retires with it. One spelling for the mint and every remover. */
|
|
124
126
|
export declare function attachmentTransmissionId(a: Pick<UserMessageAttachment, "inputId" | "ordinal">): string;
|
|
@@ -171,8 +173,11 @@ export interface AttachmentWindowInput {
|
|
|
171
173
|
}
|
|
172
174
|
/** The objective lane's read: once the UserPromptSubmit hook let the objective through (a blocked objective reads
|
|
173
175
|
* nothing), and before the pre-call gate, which prices the frames (`chars`). Refuses the whole objective when the frames
|
|
174
|
-
* and the objective cannot ride one request ({@link refuseFramesOverWindow}). Commits nothing.
|
|
175
|
-
|
|
176
|
+
* and the objective cannot ride one request ({@link refuseFramesOverWindow}). Commits nothing. `imageSeat` is the run's
|
|
177
|
+
* image processor seat (`RunnerDeps.imageProcessor`): the host images are admitted with it (a path's image is read by the
|
|
178
|
+
* reader, with the same seat), and the first image of the frames sent unprocessed over the soft target is told to
|
|
179
|
+
* `prepared.imageUnprocessed`. */
|
|
180
|
+
export declare function readObjectiveAttachments(prepared: Pick<import("./runner/contracts.js").Prepared, "userAttachments" | "modelFileReader" | "syntheticReadVerdict" | "cwdRef" | "reminderMark" | "reminderDisclosureCounts" | "abortController" | "harness" | "modBus" | "hookIdentity" | "imageUnprocessed">, inputId: string, blocked: boolean, window: AttachmentWindowInput, imageSeat: ImageDownsampler | false | undefined): Promise<{
|
|
176
181
|
frames: MintedAttachmentFrame[];
|
|
177
182
|
chars: number;
|
|
178
183
|
}>;
|
|
@@ -3,14 +3,17 @@ import { READ_OUTCOMES } from "../tools/fs/fs-read.js";
|
|
|
3
3
|
import { renderDirectoryListing } from "../tools/fs/dir-entries.js";
|
|
4
4
|
import { MAX_READ_OUTPUT_CHARS } from "../tools/fs/fs-shared.js";
|
|
5
5
|
import { normalizeFileText } from "../tools/fs/encoding.js";
|
|
6
|
-
import { ADMITTED_IMAGE_MIME_TYPES, admitImageBytes } from "./image-admission.js";
|
|
6
|
+
import { ADMITTED_IMAGE_MIME_TYPES, admitImageBytes, firstUnprocessedOverTarget, IMAGE_ADMISSION, unprocessedSizeClause } from "./image-admission.js";
|
|
7
|
+
import { resolveImageProcessor } from "./image-downsample.js";
|
|
7
8
|
import { PDF_MAX_PAGES_PER_READ } from "../tools/fs/pdf.js";
|
|
8
9
|
import { MARKED_BLOCK_AFTER_DATA, mintSystemReminder } from "./reminder-mint.js";
|
|
9
10
|
import { commitReminderDisclosureEffects, planReminderDisclosure } from "./reminder-disclosure.js";
|
|
10
11
|
import { DEFAULT_CHARS_PER_TOKEN, estimateTokens, uuidv7 } from "../internal/harness.js";
|
|
11
12
|
import { thrownText } from "./thrown-value.js";
|
|
13
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
12
14
|
import { guardBudget } from "./context-guard.js";
|
|
13
|
-
import {
|
|
15
|
+
import { failedHandlerClause } from "./mods/stations.js";
|
|
16
|
+
import { agentIdOf } from "./leg-identity.js";
|
|
14
17
|
import { extensionWords } from "./untrusted-egress.js";
|
|
15
18
|
export const USER_ATTACHMENTS_MAX = 20;
|
|
16
19
|
export const USER_ATTACHMENT_LABEL_MAX = 4096;
|
|
@@ -74,10 +77,13 @@ function screenPositiveInt(v, at) {
|
|
|
74
77
|
throw userAttachmentRefusal(at, "must be an integer of at least 1.");
|
|
75
78
|
return v;
|
|
76
79
|
}
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
80
|
+
const PATH_KEYS = optionKeys()({ path: 0, lines: 0 });
|
|
81
|
+
const LINES_KEYS = optionKeys()({ start: 0, end: 0 });
|
|
82
|
+
const TEXT_KEYS = optionKeys()({ name: 0, text: 0, startLine: 0 });
|
|
83
|
+
const IMAGE_KEYS = optionKeys()({ name: 0, image: 0 });
|
|
84
|
+
const IMAGE_BYTES_KEYS = optionKeys()({ data: 0, mimeType: 0 });
|
|
85
|
+
function onlyMembers(o, keys, at) {
|
|
86
|
+
return receiveMembers(o, { subject: at.path, unit: "member", moment: "when the attachment is screened" }, keys, (_, [k]) => userAttachmentRefusal(memberRef(at, String(k)), `is not a member of this attachment (allowed: ${keys.join(", ")}).`));
|
|
81
87
|
}
|
|
82
88
|
function screenEntry(raw, at) {
|
|
83
89
|
if (!isPlainObject(raw))
|
|
@@ -89,17 +95,17 @@ function screenEntry(raw, at) {
|
|
|
89
95
|
}
|
|
90
96
|
switch (arm) {
|
|
91
97
|
case "path": {
|
|
92
|
-
onlyMembers(raw,
|
|
93
|
-
const path = screenLabel(
|
|
94
|
-
const linesRaw =
|
|
98
|
+
const entry = onlyMembers(raw, PATH_KEYS, at);
|
|
99
|
+
const path = screenLabel(entry.path, memberRef(at, "path"));
|
|
100
|
+
const linesRaw = entry.lines;
|
|
95
101
|
if (linesRaw === undefined)
|
|
96
102
|
return { supply: "path", path };
|
|
97
103
|
const linesAt = memberRef(at, "lines");
|
|
98
104
|
if (!isPlainObject(linesRaw))
|
|
99
105
|
throw userAttachmentRefusal(linesAt, "must be { start, end? }.");
|
|
100
|
-
onlyMembers(linesRaw,
|
|
101
|
-
const start = screenPositiveInt(
|
|
102
|
-
const endRaw =
|
|
106
|
+
const lines = onlyMembers(linesRaw, LINES_KEYS, linesAt);
|
|
107
|
+
const start = screenPositiveInt(lines.start, memberRef(linesAt, "start"));
|
|
108
|
+
const endRaw = lines.end;
|
|
103
109
|
if (endRaw === undefined)
|
|
104
110
|
return { supply: "path", path, lines: { start } };
|
|
105
111
|
const end = screenPositiveInt(endRaw, memberRef(linesAt, "end"));
|
|
@@ -108,27 +114,27 @@ function screenEntry(raw, at) {
|
|
|
108
114
|
return { supply: "path", path, lines: { start, end } };
|
|
109
115
|
}
|
|
110
116
|
case "text": {
|
|
111
|
-
onlyMembers(raw,
|
|
112
|
-
const name = screenLabel(
|
|
113
|
-
const text =
|
|
117
|
+
const entry = onlyMembers(raw, TEXT_KEYS, at);
|
|
118
|
+
const name = screenLabel(entry.name, memberRef(at, "name"));
|
|
119
|
+
const text = entry.text;
|
|
114
120
|
if (typeof text !== "string" || text.length === 0)
|
|
115
121
|
throw userAttachmentRefusal(memberRef(at, "text"), "must be a non-empty string.");
|
|
116
|
-
const startLine =
|
|
122
|
+
const startLine = entry.startLine === undefined ? 1 : screenPositiveInt(entry.startLine, memberRef(at, "startLine"));
|
|
117
123
|
const rendered = renderNumbered(text, startLine);
|
|
118
124
|
if (rendered.length > MAX_READ_OUTPUT_CHARS)
|
|
119
125
|
throw userAttachmentRefusal(memberRef(at, "text"), `renders to ${rendered.length} characters with line numbers, over the ${MAX_READ_OUTPUT_CHARS}-character limit a read may deliver — send a part of it.`);
|
|
120
126
|
return { supply: "content_text", name, text, startLine, rendered };
|
|
121
127
|
}
|
|
122
128
|
case "image": {
|
|
123
|
-
onlyMembers(raw,
|
|
124
|
-
const name = screenLabel(
|
|
125
|
-
const img =
|
|
129
|
+
const entry = onlyMembers(raw, IMAGE_KEYS, at);
|
|
130
|
+
const name = screenLabel(entry.name, memberRef(at, "name"));
|
|
131
|
+
const img = entry.image;
|
|
126
132
|
const imageAt = memberRef(at, "image");
|
|
127
133
|
if (!isPlainObject(img))
|
|
128
134
|
throw userAttachmentRefusal(imageAt, "must be { data, mimeType } (base64 bytes and the image's type).");
|
|
129
|
-
onlyMembers(img,
|
|
130
|
-
const data =
|
|
131
|
-
const mimeType =
|
|
135
|
+
const bytes = onlyMembers(img, IMAGE_BYTES_KEYS, imageAt);
|
|
136
|
+
const data = bytes.data;
|
|
137
|
+
const mimeType = bytes.mimeType;
|
|
132
138
|
if (typeof data !== "string" || data.length === 0)
|
|
133
139
|
throw userAttachmentRefusal(memberRef(imageAt, "data"), "must be a non-empty base64 string.");
|
|
134
140
|
if (typeof mimeType !== "string" || !ADMITTED_IMAGE_MIME_TYPES.includes(mimeType)) {
|
|
@@ -151,12 +157,12 @@ function declarationOf(a, ordinal) {
|
|
|
151
157
|
? { ordinal, supply: a.supply, path: a.path }
|
|
152
158
|
: { ordinal, supply: a.supply, name: a.name, bytes: a.supply === "content_text" ? Buffer.byteLength(a.text, "utf8") : Buffer.from(a.data, "base64").byteLength };
|
|
153
159
|
}
|
|
154
|
-
export async function admitUserAttachmentImages(screened) {
|
|
160
|
+
export async function admitUserAttachmentImages(screened, processor) {
|
|
155
161
|
const out = new Map();
|
|
156
162
|
for (const [i, a] of screened.entries()) {
|
|
157
163
|
if (a.supply !== "content_image")
|
|
158
164
|
continue;
|
|
159
|
-
const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType,
|
|
165
|
+
const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType, processor);
|
|
160
166
|
if (admitted.ok) {
|
|
161
167
|
out.set(i + 1, admitted.block);
|
|
162
168
|
continue;
|
|
@@ -169,8 +175,11 @@ export async function admitUserAttachmentImages(screened) {
|
|
|
169
175
|
throw userAttachmentRefusal(memberRef(imageAt, "data"), `does not open with a valid ${a.mimeType} header (empty, truncated, mis-declared, not base64, or a variant such as an Apple-optimized PNG that model APIs cannot read) — refused rather than sent.`);
|
|
170
176
|
case "raw_too_large":
|
|
171
177
|
throw userAttachmentRefusal(memberRef(imageAt, "data"), `${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
|
|
178
|
+
case "dimensions_unreadable":
|
|
179
|
+
case "dimensions_too_large":
|
|
180
|
+
throw userAttachmentRefusal(memberRef(imageAt, "data"), `refused rather than sent: ${unprocessedSizeClause(admitted)}.`);
|
|
172
181
|
case "base64_too_large":
|
|
173
|
-
throw userAttachmentRefusal(memberRef(imageAt, "data"), `base64 of ${admitted.base64.length} characters, over the API's
|
|
182
|
+
throw userAttachmentRefusal(memberRef(imageAt, "data"), `base64 of ${admitted.base64.length} characters, over the API's ${IMAGE_ADMISSION.hard.imageBase64Chars}-character image limit — shrink the image first.`);
|
|
174
183
|
}
|
|
175
184
|
}
|
|
176
185
|
return out;
|
|
@@ -485,15 +494,16 @@ function refuseFramesOverWindow(frames, model, window) {
|
|
|
485
494
|
const n = frames.length;
|
|
486
495
|
throw userAttachmentRefusal(SEAT_REF, `the ${n} ${n === 1 ? "attachment" : "attachments"} and the objective come to about ${tokens} tokens, over the ${budget} tokens one request can hold on this model — to send it the engine would have to drop the objective or some of the attachments. Nothing was sent; attach fewer or smaller parts.`);
|
|
487
496
|
}
|
|
488
|
-
export async function readObjectiveAttachments(prepared, inputId, blocked, window) {
|
|
497
|
+
export async function readObjectiveAttachments(prepared, inputId, blocked, window, imageSeat) {
|
|
489
498
|
if (blocked || prepared.userAttachments === undefined)
|
|
490
499
|
return { frames: [], chars: 0 };
|
|
500
|
+
const processor = await resolveImageProcessor(imageSeat);
|
|
491
501
|
const frames = await readUserAttachments({
|
|
492
502
|
screened: prepared.userAttachments,
|
|
493
503
|
inputId,
|
|
494
504
|
reader: prepared.modelFileReader,
|
|
495
505
|
judge: prepared.syntheticReadVerdict,
|
|
496
|
-
images: await admitUserAttachmentImages(prepared.userAttachments),
|
|
506
|
+
images: await admitUserAttachmentImages(prepared.userAttachments, processor),
|
|
497
507
|
cwd: prepared.cwdRef?.current,
|
|
498
508
|
mark: prepared.reminderMark,
|
|
499
509
|
counts: prepared.reminderDisclosureCounts,
|
|
@@ -501,6 +511,9 @@ export async function readObjectiveAttachments(prepared, inputId, blocked, windo
|
|
|
501
511
|
mentions: { bus: prepared.modBus, ...(agentIdOf(prepared.hookIdentity) !== undefined ? { agentId: agentIdOf(prepared.hookIdentity) } : {}) },
|
|
502
512
|
});
|
|
503
513
|
refuseFramesOverWindow(frames, prepared.harness.getModel(), window);
|
|
514
|
+
const unprocessed = firstUnprocessedOverTarget(frames.flatMap((f) => f.seed.content), processor);
|
|
515
|
+
if (unprocessed !== undefined)
|
|
516
|
+
prepared.imageUnprocessed(unprocessed);
|
|
504
517
|
return { frames, chars: frames.reduce((n, f) => n + f.seed.content.reduce((m, b) => m + (b.type === "text" ? b.text.length : 0), 0), 0) };
|
|
505
518
|
}
|
|
506
519
|
export const COMPACTION_RESTORE_PROBE_FACE = "compaction-restore";
|
|
@@ -135,7 +135,7 @@ export interface WorkflowJournalStore {
|
|
|
135
135
|
/** (CC diagnostics parity, additive): a HUMAN/MODEL-readable coordinate for this run's journal —
|
|
136
136
|
* the file store returns the on-disk jsonl path (CC "Read journal.jsonl" local form); a service store
|
|
137
137
|
* returns its API route (cloud form). `undefined`/absent ⇒ the completion notification's diagnostics
|
|
138
|
-
* line
|
|
138
|
+
* line names no journal (the record behind its ref still carries every agent's row). Engine-facing string, never parsed. */
|
|
139
139
|
locator?(runId: string, scope: string): string | undefined;
|
|
140
140
|
/**
|
|
141
141
|
* ADMISSION for a resume, so two concurrent
|
|
@@ -222,6 +222,8 @@ export declare function queryWorkflowRuns(runs: Iterable<WorkflowRun>, scope: st
|
|
|
222
222
|
* `WorkflowRun` the workflow keeps mutating — must not corrupt the stored row, and a returned run must not
|
|
223
223
|
* be a live reference the caller can mutate back into the store).
|
|
224
224
|
*/
|
|
225
|
+
/** The retention knobs a workflow-run `reap` takes: an age bound and a keep-newest-N bound over the terminal runs. */
|
|
226
|
+
export declare const WORKFLOW_RUN_REAP_KNOBS: readonly ["maxAgeMs", "keep"];
|
|
225
227
|
export declare class InMemoryWorkflowRunStore implements WorkflowRunStore {
|
|
226
228
|
private runs;
|
|
227
229
|
put(id: string, run: WorkflowRun): Promise<void>;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { runParkedOf } from "../orchestration/workflow-types.js";
|
|
2
|
-
import {
|
|
2
|
+
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
3
|
export function summarizeWorkflowRun(run) {
|
|
4
4
|
const latestPhase = run.phases.at(-1);
|
|
5
5
|
return {
|
|
@@ -53,6 +53,7 @@ export function queryWorkflowRuns(runs, scope, opts) {
|
|
|
53
53
|
const limited = opts?.limit !== undefined ? rows.slice(0, Math.max(0, opts.limit)) : rows;
|
|
54
54
|
return limited.map(summarizeWorkflowRun);
|
|
55
55
|
}
|
|
56
|
+
export const WORKFLOW_RUN_REAP_KNOBS = Object.freeze(["maxAgeMs", "keep"]);
|
|
56
57
|
export class InMemoryWorkflowRunStore {
|
|
57
58
|
runs = new Map();
|
|
58
59
|
async put(id, run) {
|
|
@@ -79,16 +80,16 @@ export class InMemoryWorkflowRunStore {
|
|
|
79
80
|
return queryWorkflowRuns(this.runs.values(), scope, opts);
|
|
80
81
|
}
|
|
81
82
|
async reap(scope, now, opts) {
|
|
82
|
-
|
|
83
|
-
if (
|
|
83
|
+
const policy = receiveRetentionPolicy("WorkflowRunStore.reap", opts, WORKFLOW_RUN_REAP_KNOBS);
|
|
84
|
+
if (policy.maxAgeMs === undefined && policy.keep === undefined)
|
|
84
85
|
return 0;
|
|
85
86
|
const terminal = [...this.runs.values()].filter((r) => r.scope === scope && isTerminalWorkflowStatus(r.status));
|
|
86
87
|
terminal.sort((a, b) => b.createdAt - a.createdAt);
|
|
87
88
|
const doomed = new Set();
|
|
88
89
|
for (let i = 0; i < terminal.length; i++) {
|
|
89
90
|
const r = terminal[i];
|
|
90
|
-
const tooOld =
|
|
91
|
-
const overKeep =
|
|
91
|
+
const tooOld = policy.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - policy.maxAgeMs;
|
|
92
|
+
const overKeep = policy.keep !== undefined && i >= policy.keep;
|
|
92
93
|
if (tooOld || overKeep)
|
|
93
94
|
doomed.add(r.id);
|
|
94
95
|
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { WorkflowRun } from "../orchestration/workflow-types.js";
|
|
2
|
+
/** Bind `run` to the `done` promise that settles for it — the run's starter, once, before the promise is handed out. */
|
|
3
|
+
export declare function bindSettledRun(done: Promise<unknown>, run: WorkflowRun): void;
|
|
4
|
+
/** The run `done` settles for; `undefined` for a promise no run was bound to (a handle its caller assembled itself). */
|
|
5
|
+
export declare function settledRunOf(done: Promise<unknown>): WorkflowRun | undefined;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { type FileHandle } from "node:fs/promises";
|
|
2
2
|
import { type BoundFileObject, type ExecResult, type ExecutionEnv, ExecutionError, type ExecutionEnvExecOptions, FileError, type FileInfo, type Result } from "../harness/types.js";
|
|
3
3
|
import { type SecretEnvFinding } from "../../core/secret-env.js";
|
|
4
|
-
import type
|
|
5
|
-
import type { SymlinkChain } from "../harness/types.js";
|
|
4
|
+
import { type EngineNotice } from "../../core/engine-notice.js";
|
|
5
|
+
import type { ExecutionEnvCapabilities, SymlinkChain } from "../harness/types.js";
|
|
6
6
|
import type { BackgroundHardKillOutcome, BackgroundShellCapability, BackgroundShellId, BackgroundPoll, BackgroundSpawnOptions } from "../../core/background-shell.js";
|
|
7
7
|
import { BackgroundShellError } from "../../core/background-shell.js";
|
|
8
8
|
import type { SchedulerCapability, ScheduledIntent, SchedulerContext, ScheduledTaskId, ScheduledTaskSummary } from "../../core/scheduler.js";
|
|
@@ -82,6 +82,14 @@ export declare function openSpoolPair(base: string): {
|
|
|
82
82
|
};
|
|
83
83
|
export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCapability, SchedulerCapability {
|
|
84
84
|
cwd: string;
|
|
85
|
+
/** `ExecutionEnv.capabilities`: the engine's own host — commands are this process's children on its own disk, not
|
|
86
|
+
* contained, not snapshotable; its resolver always answers; it keeps the byte floor exactly when its starts are confined
|
|
87
|
+
* (`readFloorConfinement: "os"` on a host where the probe applied), and otherwise does not. */
|
|
88
|
+
readonly capabilities: ExecutionEnvCapabilities;
|
|
89
|
+
/** Every start carrying a floor runs under that floor's seatbelt profile (the probe applied at construction). */
|
|
90
|
+
private readonly confined;
|
|
91
|
+
/** Each profile's apply, once per text: `undefined` applied, else the launcher's reason. */
|
|
92
|
+
private readonly profileApplies;
|
|
85
93
|
/** `ExecutionEnv.homeDir` = the `HOME` the shell child receives (its `~`/`$HOME`/`${HOME}` all expand to it), read LIVE off the same `shellEnv`-over-`inheritEnv` merge each exec gets; ABSENT when the
|
|
86
94
|
* child gets none (an allowlist that withholds it: `~` then falls back to passwd while `$HOME` is empty — two values, no single home, home-relative operands stay fail-closed). Residual: a per-exec `env.HOME` override. */
|
|
87
95
|
get homeDir(): string | undefined;
|
|
@@ -151,6 +159,13 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
151
159
|
* `code: "config.secret_env_scrubbed"`, `detail.names`); independent of `onSecretEnvScrub` (a raw
|
|
152
160
|
* findings collector) except: that seat wired alone stays console-silent, as before this existed. */
|
|
153
161
|
onNotice?: (notice: EngineNotice) => void;
|
|
162
|
+
/** Confine every start that carries a byte floor (`ExecutionEnvExecOptions.readFloor`) at the OS: `"os"` = on macOS,
|
|
163
|
+
* when the seatbelt base applies here (probed once, now), each such start runs under `sandbox-exec -p <the floor's
|
|
164
|
+
* profile>` and the environment declares `keepsReadFloor: true`; a floor the profile cannot express, or a profile that
|
|
165
|
+
* does not apply, refuses that start (`spawn_error` / `spawn_failed`, naming why) — it never runs unconfined. On any
|
|
166
|
+
* other host, or when the probe does not apply, the environment declares `false` and says so once on `onNotice`
|
|
167
|
+
* (`config.read_floor_confinement_unavailable`). Absent = no confinement (`false`). Any other value throws. */
|
|
168
|
+
readFloorConfinement?: "os";
|
|
154
169
|
});
|
|
155
170
|
get schedulerCapabilities(): SchedulerCapability["schedulerCapabilities"];
|
|
156
171
|
schedule(intent: ScheduledIntent, ctx: SchedulerContext): Promise<Result<{
|
|
@@ -160,6 +175,10 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
160
175
|
list(ctx: SchedulerContext): Promise<Result<ScheduledTaskSummary[], SchedulerError>>;
|
|
161
176
|
absolutePath(path: string): Promise<Result<string, FileError>>;
|
|
162
177
|
joinPath(parts: string[]): Promise<Result<string, FileError>>;
|
|
178
|
+
/** The program and arguments ONE shell start spawns: the shell as it is, or — on a confined environment, for a start
|
|
179
|
+
* carrying a floor — the shell under that floor's seatbelt profile; a floor the profile cannot express, or a profile the
|
|
180
|
+
* host does not apply, is the reason the start is refused (the command never runs, confined or not). */
|
|
181
|
+
private startOf;
|
|
163
182
|
exec(command: string, options?: ExecutionEnvExecOptions): Promise<Result<ExecResult, ExecutionError>>;
|
|
164
183
|
readTextFile(path: string, abortSignal?: AbortSignal): Promise<Result<string, FileError>>;
|
|
165
184
|
readTextLines(path: string, options?: {
|
|
@@ -171,18 +190,29 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
171
190
|
* The former single-step `writeFile` was an in-place O_TRUNC: an abort mid-write
|
|
172
191
|
* (Esc during a large Write — ctx.signal reaches here directly), ENOSPC, or a crash left the target as
|
|
173
192
|
* a torn prefix of the NEW content with the original unrecoverable. Post-fix contract: the target is
|
|
174
|
-
* either fully old or fully new; `aborted` means it was never touched
|
|
175
|
-
*
|
|
193
|
+
* either fully old or fully new; `aborted` means it was never touched — the in-place fallback legs
|
|
194
|
+
* judge the signal once, before their first byte, so they answer `aborted` (untouched), `ok` or their own
|
|
195
|
+
* error, never `aborted` after a truncation. Known semantic change (same as CC): rename breaks a hard link —
|
|
196
|
+
* the other link keeps the old content. The replacement is a new inode made by the writing process: its owner
|
|
197
|
+
* is the writer and its group follows the new-file rule, so the target's group bits can land on another group;
|
|
198
|
+
* no fchown (KL-3120-b). */
|
|
176
199
|
writeFile(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
|
|
177
200
|
/** RB-221: the historical single-step in-place overwrite — kept for targets where
|
|
178
201
|
* staging+rename would change node identity (symlink chains, non-regular files) and as the
|
|
179
|
-
* CC-parity fallback for filesystems where the rename cannot work. NOT atomic by design
|
|
202
|
+
* CC-parity fallback for filesystems where the rename cannot work. NOT atomic by design, and
|
|
203
|
+
* deliberately not cancellable: the signal is judged once, here, before the first byte, and not again —
|
|
204
|
+
* so `aborted` never describes a target this write has truncated. */
|
|
180
205
|
private writeFileInPlace;
|
|
181
206
|
/** Atomic exclusive create ({@link FileSystem.writeFileExclusive}): Node `wx` flag = one
|
|
182
207
|
* `open(O_CREAT|O_EXCL)` syscall — an existing file returns FileError `"already_exists"` and is left
|
|
183
208
|
* untouched. The EEXIST→already_exists mapping lives HERE, on the exclusive-open step only — a parent
|
|
184
209
|
* `mkdir` can also throw EEXIST (parent path component is a regular file) and that is NOT "the target
|
|
185
|
-
* already exists" (fable review). Parent directories are created like writeFile.
|
|
210
|
+
* already exists" (fable review). Parent directories are created like writeFile.
|
|
211
|
+
*
|
|
212
|
+
* The signal is judged before the first byte — at entry and after the parent `mkdir` — and is not handed to the write: the
|
|
213
|
+
* exclusive open creates the target itself, so a write cancelled after it would leave a new file holding a prefix of the
|
|
214
|
+
* content under an `aborted` answer. `aborted` therefore means no file was created; a write whose open has begun runs to its
|
|
215
|
+
* end and answers `ok` or its own error (the same rule as the in-place legs of {@link NodeExecutionEnv.writeFile}). */
|
|
186
216
|
writeFileExclusive(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
|
|
187
217
|
appendFile(path: string, content: string | Uint8Array): Promise<Result<void, FileError>>;
|
|
188
218
|
fileInfo(path: string): Promise<Result<FileInfo, FileError>>;
|
|
@@ -236,7 +266,7 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
|
|
|
236
266
|
suffix?: string;
|
|
237
267
|
}): Promise<Result<string, FileError>>;
|
|
238
268
|
/** design/116 detach: adopt a RUNNING foreground child as a background shell. Pre-fills the bg tails with
|
|
239
|
-
* the output captured so far (so
|
|
269
|
+
* the output captured so far (so the first background read has the full history), attaches fresh data/close
|
|
240
270
|
* handlers, and arms the default bg timeout. Returns undefined when the live-shell limit is hit (detach
|
|
241
271
|
* refused; the exec keeps running in the foreground). */
|
|
242
272
|
private adoptRunningChild;
|