@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,5 +1,6 @@
|
|
|
1
1
|
export const AUTO_MODE_DEFAULT_TIMEOUT_MS = 180_000;
|
|
2
2
|
export const AUTO_MODE_CLASSIFIER_MAX_RETRIES = 4;
|
|
3
|
+
export const AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT = 3;
|
|
3
4
|
export const AUTO_MODE_RECORDED_ABSENT_TIMEOUT_MS = 15_000;
|
|
4
5
|
export const AUTO_MODE_DEFAULT_WINDOW_MAX_ENTRIES = 40;
|
|
5
6
|
export const AUTO_MODE_DEFAULT_WINDOW_MAX_CHARS = 2_000;
|
|
@@ -67,7 +67,8 @@ export type AutoModeRebuildResult = {
|
|
|
67
67
|
* overrides / settings-deny rules / session context, plus the engine's cross-session lane rule when
|
|
68
68
|
* the recipe says the arming leg spliced it), the transcript-window bounds and the round-trip
|
|
69
69
|
* timeout — i.e. every input the ancestor's own `createAutoModeDecider` call had except the model leg.
|
|
70
|
-
*
|
|
70
|
+
* The rebuilt decider is one rung, which never retires (the rate-limit memory only a rung with another behind it keeps), so it
|
|
71
|
+
* carries no state between rounds and there is no ancestor state to reproduce or to withhold.
|
|
71
72
|
*
|
|
72
73
|
* NOT reproduced: this build's PROMPT ASSETS are its own. The recipe records the deployment's
|
|
73
74
|
* overrides, so the assembled prompt is checked against the digest the arming recorded — a fleet running
|
package/dist/core/auto-mode.d.ts
CHANGED
|
@@ -59,6 +59,12 @@ export declare function isAutoModeTimeoutMs(v: unknown): v is number;
|
|
|
59
59
|
* refusal carrying `config.auto_mode_timeout_invalid`. There is no OFF spelling: the budget bounds how long a
|
|
60
60
|
* permission gate waits, and a gate with no bound is not a setting this knob offers. */
|
|
61
61
|
export declare function autoModeTimeoutMsOf(v: unknown): number;
|
|
62
|
+
/** Read the retirement knob (`RunnerDeps.autoMode.rateLimitBreakAfter` / `AutoModeDeciderOptions.rateLimitBreakAfter`):
|
|
63
|
+
* absent ⇒ {@link AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}; a safe integer of at least 1 ⇒ itself; ANYTHING ELSE
|
|
64
|
+
* (`0`, a negative, a fraction, NaN, ±Infinity, a string, an object) ⇒ a loud refusal carrying
|
|
65
|
+
* `config.auto_mode_rate_limit_break_invalid` — never clamped, never read as the default. There is no OFF
|
|
66
|
+
* spelling: a deployment that wants the seat asked for longer states a larger count. */
|
|
67
|
+
export declare function autoModeRateLimitBreakAfterOf(v: unknown): number;
|
|
62
68
|
/** The classifier's verdict over one pending `ask`. Every arm may carry the classification's model
|
|
63
69
|
* attribution ({@link AutoModeClassifierRound}), present iff the decider was wired with a candidate ladder. */
|
|
64
70
|
export type AutoModeVerdict = ({
|
|
@@ -136,6 +142,15 @@ export declare const AUTO_MODE_ROUND_NOT_ASKED_CODE = "auto_mode.round_not_asked
|
|
|
136
142
|
export declare function autoModeRoundNotAsked(reason: unknown): Error & {
|
|
137
143
|
code: string;
|
|
138
144
|
};
|
|
145
|
+
/**
|
|
146
|
+
* The word for "this rung's dispatch ended on the provider's RATE LIMIT" — an HTTP 429 that outlived the brain's own
|
|
147
|
+
* backoff ladder. A classify hook throws an error carrying this `code` (the same carrier as
|
|
148
|
+
* {@link AUTO_MODE_ROUND_NOT_ASKED_CODE}: a `code` on the thrown error, so any hook — including one this package never
|
|
149
|
+
* constructed — can raise it without importing a constructor). The decider reads it for one thing, the rung's
|
|
150
|
+
* RETIREMENT count (see the header's RATE-LIMIT RETIREMENT); the rung's verdict is the `unavailable` / `error` every
|
|
151
|
+
* leg failure already is.
|
|
152
|
+
*/
|
|
153
|
+
export declare const AUTO_MODE_RUNG_RATE_LIMITED_CODE = "auto_mode.rung_rate_limited";
|
|
139
154
|
/**
|
|
140
155
|
* Why a rung did not settle the classification, or `undefined` when it SETTLED it and the ladder stops — the
|
|
141
156
|
* ONE predicate behind the advance (there is no `if (fallback)` arm anywhere).
|
|
@@ -276,6 +291,13 @@ export interface AutoModeDeciderOptions<T = void> {
|
|
|
276
291
|
* (`config.auto_mode_timeout_invalid`, {@link autoModeTimeoutMsOf}) — never clamped, never read as the
|
|
277
292
|
* default, and there is no OFF: a permission gate always has a bound. */
|
|
278
293
|
timeoutMs?: number;
|
|
294
|
+
/** How many CONSECUTIVE classifications must end on one rung's rate limit ({@link AUTO_MODE_RUNG_RATE_LIMITED_CODE})
|
|
295
|
+
* before that rung is not asked again for the rest of this decider's life — see the header's RATE-LIMIT
|
|
296
|
+
* RETIREMENT. Omitted ⇒ {@link AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}. A present value that is not a whole number
|
|
297
|
+
* of at least 1 is REFUSED at construction (`config.auto_mode_rate_limit_break_invalid`,
|
|
298
|
+
* {@link autoModeRateLimitBreakAfterOf}) — never clamped, never read as the default. Inert on a one-rung ladder:
|
|
299
|
+
* only a rung with a rung behind it retires. */
|
|
300
|
+
rateLimitBreakAfter?: number;
|
|
279
301
|
/**
|
|
280
302
|
* Fired once per `decide` call with the verdict the gate is about to act on and the wall time it waited
|
|
281
303
|
* (`ms`, integer ≥ 0; a timed-out classification reads the deadline, one that walked two rungs the whole
|
|
@@ -302,6 +324,17 @@ export interface AutoModeClassified {
|
|
|
302
324
|
/** The classification's model attribution, present exactly when the decider was wired with a candidate ladder
|
|
303
325
|
* ({@link AutoModeClassifierRound}) — the same object the verdict carries. */
|
|
304
326
|
classifier?: AutoModeClassifierRound;
|
|
327
|
+
/** One entry per rung this classification RETIRED — the classification whose rate-limited dispatch was a rung's
|
|
328
|
+
* `rateLimitBreakAfter`-th in a row, so each retired rung is reported on exactly one classification: which rung stopped
|
|
329
|
+
* being asked (`rung`, its model `model`), the model the walk reaches after it (`to`) and the count that tripped it
|
|
330
|
+
* (`consecutive`; always the configured bound). ABSENT on every other classification, including those that walk
|
|
331
|
+
* behind an already-retired rung. */
|
|
332
|
+
rateLimitBreaks?: readonly {
|
|
333
|
+
readonly rung: number;
|
|
334
|
+
readonly model: string;
|
|
335
|
+
readonly to: string;
|
|
336
|
+
readonly consecutive: number;
|
|
337
|
+
}[];
|
|
305
338
|
}
|
|
306
339
|
export interface AutoModeDecider {
|
|
307
340
|
/** Never rejects. Any internal failure surfaces as `unavailable`/`parse_error` (fail-closed). */
|
|
@@ -311,9 +344,10 @@ export interface AutoModeDecider {
|
|
|
311
344
|
* host implements by hand. */
|
|
312
345
|
readonly timeoutMs?: number;
|
|
313
346
|
}
|
|
314
|
-
/** The per-run decider: timeout + fail-closed error mapping, nothing carried between rounds
|
|
315
|
-
* run (it binds the run's model leg and assembled
|
|
316
|
-
* which asks the model again
|
|
347
|
+
/** The per-run decider: timeout + fail-closed error mapping, and nothing carried between rounds but the rate-limit
|
|
348
|
+
* retirement of a rung that has another behind it. One instance per run (it binds the run's model leg and assembled
|
|
349
|
+
* prompt); a round that failed says nothing about the next, which asks the model again — a rung that was
|
|
350
|
+
* rate-limited `rateLimitBreakAfter` times in a row is the one exception. */
|
|
317
351
|
export declare function createAutoModeDecider<T = void>(opts: AutoModeDeciderOptions<T>): AutoModeDecider;
|
|
318
352
|
/** The deployment's bounds for the denial limit (`RunnerDeps.autoMode.denialLimit`). Every member
|
|
319
353
|
* optional; an omitted member takes its CC default. A present member with a bad value is REFUSED
|
|
@@ -445,13 +479,14 @@ export interface AutoModeDenialTracker {
|
|
|
445
479
|
};
|
|
446
480
|
}
|
|
447
481
|
export declare function autoModeDenialLimitOf(v: unknown): Required<AutoModeDenialLimitOptions>;
|
|
448
|
-
/** The deployment face's
|
|
482
|
+
/** The deployment face's four value knobs, read by their one readers — every leg's prepare runs it while
|
|
449
483
|
* `RunnerDeps.autoMode` is present, whatever mode the leg starts in, so a bad knob refuses the run before a steer or a
|
|
450
484
|
* parent's live ceiling can reach an arming that would have refused it. */
|
|
451
485
|
export declare function screenAutoModeKnobs(face: {
|
|
452
486
|
readonly timeoutMs?: unknown;
|
|
453
487
|
readonly classifierFallback?: unknown;
|
|
454
488
|
readonly denialLimit?: unknown;
|
|
489
|
+
readonly rateLimitBreakAfter?: unknown;
|
|
455
490
|
}): void;
|
|
456
491
|
/** Build the per-run tracker over {@link autoModeDenialLimitOf}'s bounds (a bad knob refuses there). */
|
|
457
492
|
export declare function createAutoModeDenialTracker(opts?: AutoModeDenialLimitOptions): AutoModeDenialTracker;
|
package/dist/core/auto-mode.js
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
import { AUTO_MODE_DEFAULT_TIMEOUT_MS, AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS, AUTO_MODE_DENIAL_LIMIT_DEFAULTS } from "./auto-mode-defaults.js";
|
|
1
|
+
import { AUTO_MODE_DEFAULT_TIMEOUT_MS, AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS, AUTO_MODE_DENIAL_LIMIT_DEFAULTS, AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT } from "./auto-mode-defaults.js";
|
|
2
|
+
import { withStatusSeat } from "../brain/status-sink.js";
|
|
2
3
|
import { thrownIs } from "./thrown-value.js";
|
|
3
4
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
4
5
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
6
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
5
7
|
export const AUTO_MODE_UNAVAILABLE_CAUSES = Object.freeze(["error", "timeout"]);
|
|
6
8
|
const AUTO_MODE_UNAVAILABLE_CAUSE_SET = new Set(AUTO_MODE_UNAVAILABLE_CAUSES);
|
|
7
9
|
export function isAutoModeUnavailableCause(v) {
|
|
@@ -46,6 +48,16 @@ export function autoModeTimeoutMsOf(v) {
|
|
|
46
48
|
e.code = "config.auto_mode_timeout_invalid";
|
|
47
49
|
throw e;
|
|
48
50
|
}
|
|
51
|
+
export function autoModeRateLimitBreakAfterOf(v) {
|
|
52
|
+
if (v === undefined)
|
|
53
|
+
return AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT;
|
|
54
|
+
if (typeof v === "number" && Number.isSafeInteger(v) && v >= 1)
|
|
55
|
+
return v;
|
|
56
|
+
const e = new Error(`RunnerDeps.autoMode.rateLimitBreakAfter must be a whole number of classifications, at least 1 ` +
|
|
57
|
+
`(got ${describeRejectedValue(v)}) — omit it for the default ${AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}`);
|
|
58
|
+
e.code = "config.auto_mode_rate_limit_break_invalid";
|
|
59
|
+
throw e;
|
|
60
|
+
}
|
|
49
61
|
export const AUTO_MODE_ROUND_NOT_ASKED_CODE = "auto_mode.round_not_asked";
|
|
50
62
|
export function autoModeRoundNotAsked(reason) {
|
|
51
63
|
let detail;
|
|
@@ -61,8 +73,15 @@ export function autoModeRoundNotAsked(reason) {
|
|
|
61
73
|
return e;
|
|
62
74
|
}
|
|
63
75
|
function isAutoModeRoundNotAsked(e) {
|
|
76
|
+
return thrownCarriesCode(e, AUTO_MODE_ROUND_NOT_ASKED_CODE);
|
|
77
|
+
}
|
|
78
|
+
export const AUTO_MODE_RUNG_RATE_LIMITED_CODE = "auto_mode.rung_rate_limited";
|
|
79
|
+
function isAutoModeRungRateLimited(e) {
|
|
80
|
+
return thrownCarriesCode(e, AUTO_MODE_RUNG_RATE_LIMITED_CODE);
|
|
81
|
+
}
|
|
82
|
+
function thrownCarriesCode(e, code) {
|
|
64
83
|
try {
|
|
65
|
-
return typeof e === "object" && e !== null && e.code ===
|
|
84
|
+
return typeof e === "object" && e !== null && e.code === code;
|
|
66
85
|
}
|
|
67
86
|
catch {
|
|
68
87
|
return false;
|
|
@@ -184,9 +203,12 @@ export function createAutoModeDecider(opts) {
|
|
|
184
203
|
throw new Error(`AutoModeDeciderOptions.candidates[${bad}] must be a non-empty model id (got ${JSON.stringify(opts.candidates[bad])})`);
|
|
185
204
|
}
|
|
186
205
|
const ladder = opts.candidates ?? [undefined];
|
|
206
|
+
const rateLimitBreakAfter = autoModeRateLimitBreakAfterOf(opts.rateLimitBreakAfter);
|
|
207
|
+
const rateLimitStreak = new Map();
|
|
208
|
+
const retired = new Set();
|
|
187
209
|
const decide = async (input, signal) => {
|
|
188
210
|
const startedAt = performance.now();
|
|
189
|
-
const round = {};
|
|
211
|
+
const round = { rateLimitBreaks: [] };
|
|
190
212
|
const verdict = await decideUnreported(input, round, signal);
|
|
191
213
|
if (opts.onClassified !== undefined) {
|
|
192
214
|
try {
|
|
@@ -197,6 +219,7 @@ export function createAutoModeDecider(opts) {
|
|
|
197
219
|
...(verdict.kind === "unavailable" ? { cause: verdict.cause } : {}),
|
|
198
220
|
...(round.notAsked !== undefined ? { notAsked: round.notAsked } : {}),
|
|
199
221
|
...(verdict.classifier !== undefined ? { classifier: verdict.classifier } : {}),
|
|
222
|
+
...(round.rateLimitBreaks.length > 0 ? { rateLimitBreaks: round.rateLimitBreaks } : {}),
|
|
200
223
|
});
|
|
201
224
|
}
|
|
202
225
|
catch {
|
|
@@ -211,8 +234,14 @@ export function createAutoModeDecider(opts) {
|
|
|
211
234
|
let i = 0;
|
|
212
235
|
const assembled = await assembleRound(input, round, signal);
|
|
213
236
|
for (; round.notAsked === undefined && i < ladder.length; i++) {
|
|
237
|
+
if (i < ladder.length - 1 && retired.has(i)) {
|
|
238
|
+
causes.push("error");
|
|
239
|
+
continue;
|
|
240
|
+
}
|
|
214
241
|
const name = ladder[i];
|
|
215
|
-
|
|
242
|
+
const asked = await askRung(input, signal, name !== undefined ? { index: i, model: name } : undefined, round, assembled);
|
|
243
|
+
verdict = asked.verdict;
|
|
244
|
+
noteRungOutcome(i, asked.rateLimited, signal, round);
|
|
216
245
|
const cause = rungDidNotRule(verdict);
|
|
217
246
|
if (cause === undefined)
|
|
218
247
|
break;
|
|
@@ -250,20 +279,41 @@ export function createAutoModeDecider(opts) {
|
|
|
250
279
|
}
|
|
251
280
|
async function askRung(input, signal, rung, round, assembled) {
|
|
252
281
|
try {
|
|
253
|
-
return parseAutoModeResponse(await withDeadline(timeoutMs, signal, (inner) => opts.classify(input, inner, rung, assembled)));
|
|
282
|
+
return { verdict: parseAutoModeResponse(await withDeadline(timeoutMs, signal, (inner) => opts.classify(input, inner, rung, assembled), inClassifierLane)), rateLimited: false };
|
|
254
283
|
}
|
|
255
284
|
catch (e) {
|
|
256
285
|
if (isAutoModeRoundNotAsked(e)) {
|
|
257
286
|
round.notAsked = "failed";
|
|
258
|
-
return { kind: "unavailable", cause: "error" };
|
|
287
|
+
return { verdict: { kind: "unavailable", cause: "error" }, rateLimited: false };
|
|
259
288
|
}
|
|
260
289
|
if (signal?.aborted)
|
|
261
|
-
return { kind: "unavailable", cause: "error" };
|
|
262
|
-
return { kind: "unavailable", cause: isAutoModeTimeout(e) ? "timeout" : "error" };
|
|
290
|
+
return { verdict: { kind: "unavailable", cause: "error" }, rateLimited: false };
|
|
291
|
+
return { verdict: { kind: "unavailable", cause: isAutoModeTimeout(e) ? "timeout" : "error" }, rateLimited: isAutoModeRungRateLimited(e) };
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
function noteRungOutcome(rungIndex, rateLimited, signal, round) {
|
|
295
|
+
if (signal?.aborted)
|
|
296
|
+
return;
|
|
297
|
+
if (!rateLimited) {
|
|
298
|
+
rateLimitStreak.delete(rungIndex);
|
|
299
|
+
return;
|
|
263
300
|
}
|
|
301
|
+
const streak = (rateLimitStreak.get(rungIndex) ?? 0) + 1;
|
|
302
|
+
rateLimitStreak.set(rungIndex, streak);
|
|
303
|
+
if (streak < rateLimitBreakAfter || retired.has(rungIndex))
|
|
304
|
+
return;
|
|
305
|
+
let next = rungIndex + 1;
|
|
306
|
+
while (next < ladder.length - 1 && retired.has(next))
|
|
307
|
+
next++;
|
|
308
|
+
const model = ladder[rungIndex];
|
|
309
|
+
const to = ladder[next];
|
|
310
|
+
if (model === undefined || to === undefined)
|
|
311
|
+
return;
|
|
312
|
+
retired.add(rungIndex);
|
|
313
|
+
round.rateLimitBreaks.push({ rung: rungIndex, model, to, consecutive: streak });
|
|
264
314
|
}
|
|
265
315
|
}
|
|
266
|
-
async function withDeadline(capMs, signal, call) {
|
|
316
|
+
async function withDeadline(capMs, signal, call, scope = (f) => f()) {
|
|
267
317
|
if (signal?.aborted === true)
|
|
268
318
|
throw new Error("the classification was cancelled before it was dispatched");
|
|
269
319
|
let timer;
|
|
@@ -279,19 +329,19 @@ async function withDeadline(capMs, signal, call) {
|
|
|
279
329
|
end();
|
|
280
330
|
};
|
|
281
331
|
onOuterAbort = () => {
|
|
282
|
-
inner.abort();
|
|
332
|
+
scope(() => inner.abort());
|
|
283
333
|
settle(() => reject(new Error("the classification was cancelled")));
|
|
284
334
|
};
|
|
285
335
|
signal?.addEventListener("abort", onOuterAbort, { once: true });
|
|
286
336
|
timer = setTimeout(() => {
|
|
287
337
|
settle(() => {
|
|
288
|
-
inner.abort();
|
|
338
|
+
scope(() => inner.abort());
|
|
289
339
|
reject(new AutoModeTimeout());
|
|
290
340
|
});
|
|
291
341
|
}, capMs);
|
|
292
342
|
let pending;
|
|
293
343
|
try {
|
|
294
|
-
pending = call(inner.signal);
|
|
344
|
+
pending = scope(() => call(inner.signal));
|
|
295
345
|
}
|
|
296
346
|
catch (e) {
|
|
297
347
|
settle(() => reject(e));
|
|
@@ -307,6 +357,7 @@ async function withDeadline(capMs, signal, call) {
|
|
|
307
357
|
signal.removeEventListener("abort", onOuterAbort);
|
|
308
358
|
}
|
|
309
359
|
}
|
|
360
|
+
const inClassifierLane = (f) => withStatusSeat("classifier", f);
|
|
310
361
|
class AutoModeTimeout extends Error {
|
|
311
362
|
constructor() {
|
|
312
363
|
super("auto-mode classify timeout");
|
|
@@ -332,7 +383,7 @@ export function unarmedWindow(fallback) {
|
|
|
332
383
|
function countsOf(fallback) {
|
|
333
384
|
return { consecutive: fallback.consecutive, total: fallback.total, limit: fallback.limit };
|
|
334
385
|
}
|
|
335
|
-
const
|
|
386
|
+
const DENIAL_LIMIT_KEYS = optionKeys()({ maxConsecutive: 0, maxTotal: 0, autoDenyAfterMs: 0 });
|
|
336
387
|
export function autoModeDenialLimitOf(v) {
|
|
337
388
|
const refuse = (what) => {
|
|
338
389
|
const e = new Error(`RunnerDeps.autoMode.denialLimit${what}`);
|
|
@@ -343,10 +394,7 @@ export function autoModeDenialLimitOf(v) {
|
|
|
343
394
|
return { ...AUTO_MODE_DENIAL_LIMIT_DEFAULTS, autoDenyAfterMs: AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS };
|
|
344
395
|
if (typeof v !== "object" || v === null || Array.isArray(v))
|
|
345
396
|
return refuse(` must be a record of bounds (got ${describeRejectedValue(v)}) — omit it for the defaults`);
|
|
346
|
-
const opts = v;
|
|
347
|
-
const stray = Object.keys(opts).find((k) => !DENIAL_LIMIT_MEMBERS.has(k));
|
|
348
|
-
if (stray !== undefined)
|
|
349
|
-
return refuse(` has no member ${JSON.stringify(stray)} — its members are maxConsecutive, maxTotal and autoDenyAfterMs`);
|
|
397
|
+
const opts = receiveMembers(v, { subject: "RunnerDeps.autoMode.denialLimit", unit: "member", moment: "when the knob is read" }, DENIAL_LIMIT_KEYS, (_, [stray]) => refuse(` has no member ${JSON.stringify(String(stray))} — its members are maxConsecutive, maxTotal and autoDenyAfterMs`));
|
|
350
398
|
const bound = (name, dflt) => {
|
|
351
399
|
const b = opts[name];
|
|
352
400
|
if (b === undefined)
|
|
@@ -365,6 +413,7 @@ export function screenAutoModeKnobs(face) {
|
|
|
365
413
|
autoModeTimeoutMsOf(face.timeoutMs);
|
|
366
414
|
autoModeClassifierFallbackOf(face.classifierFallback);
|
|
367
415
|
autoModeDenialLimitOf(face.denialLimit);
|
|
416
|
+
autoModeRateLimitBreakAfterOf(face.rateLimitBreakAfter);
|
|
368
417
|
}
|
|
369
418
|
export function createAutoModeDenialTracker(opts) {
|
|
370
419
|
const { maxConsecutive, maxTotal, autoDenyAfterMs } = autoModeDenialLimitOf(opts);
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { SubagentEditedFile, SubagentStep } from "../agents/subagent-steps.js";
|
|
2
|
+
import type { SubagentTranscriptTier } from "./wiring-manifest.js";
|
|
2
3
|
/** Terminal/live usage rollup persisted on the row (mirror of the task_notification/BCE fields). */
|
|
3
4
|
export interface BackgroundAgentUsage {
|
|
4
5
|
totalTokens?: number;
|
|
@@ -84,7 +85,7 @@ export interface BackgroundAgentRecord {
|
|
|
84
85
|
stoppedBy?: string;
|
|
85
86
|
/** The cross-channel completion correlation id
|
|
86
87
|
* (task-registry `SemaTaskHandle.completionId` mirror). Written alongside `status`/`settledAt` at
|
|
87
|
-
* the same durable terminal write that lands them, so a cross-restart fallback read (
|
|
88
|
+
* the same durable terminal write that lands them, so a cross-restart fallback read (a host poll
|
|
88
89
|
* after the writing process is gone) REPLAYS this exact value — there is no second mint point here,
|
|
89
90
|
* this field only ever receives what the in-memory handle already minted before the write. */
|
|
90
91
|
completionId?: string;
|
|
@@ -187,7 +188,15 @@ export interface BackgroundAgentRecord {
|
|
|
187
188
|
export declare const REVIVED_ROW_CLEARED_FIELDS: readonly ["settledAt", "stoppedBy", "completionId", "finalOutput", "finalOutputFull", "error", "errorCode", "errorRetryable", "errorKind", "errorRetryAfterMs", "resultIsPartial", "summary", "recentSteps", "editedFiles", "usage"];
|
|
188
189
|
/** Erase {@link REVIVED_ROW_CLEARED_FIELDS} from a record a revival is about to write back. */
|
|
189
190
|
export declare function clearRevivedRowTerminalPayload(record: BackgroundAgentRecord): void;
|
|
190
|
-
|
|
191
|
+
/**
|
|
192
|
+
* Whether a deployment's subagent transcript tier DECLARES that a finished agent's transcript outlives the process — the one tier a vanished
|
|
193
|
+
* transcript contradicts. `full` makes that promise; `rows` keeps the agent's record but says transcripts follow the session store's fate (a
|
|
194
|
+
* transcript gone from a process-local store is what that tier means), and `none` has no row to bind one. The tier is the wiring manifest's
|
|
195
|
+
* own word (`WiringManifest.fleet.subagentTranscripts`, derived by `resolveSubagentTranscriptTier`); every site that meets a gone transcript
|
|
196
|
+
* hands the tier its mount derived to {@link announceTranscriptIntegrityGapOnce}, which asks this predicate — the one place it is asked.
|
|
197
|
+
*/
|
|
198
|
+
export declare const declaresTranscriptDurability: (tier: SubagentTranscriptTier) => boolean;
|
|
199
|
+
export declare function announceTranscriptIntegrityGapOnce(handle: string, scope: string | undefined, sink: ((handle: string, scope: string | undefined) => void) | undefined, tier: SubagentTranscriptTier): void;
|
|
191
200
|
/** Content-free projection for list reads (design/151 HIGH-1: `summary`/`finalOutput`/`recentSteps`
|
|
192
201
|
* and friends NEVER ride a list — content is get-by-handle only, behind the full predicate). */
|
|
193
202
|
export interface BackgroundAgentRowSummary {
|
|
@@ -302,10 +311,12 @@ export interface BackgroundAgentReapOptions {
|
|
|
302
311
|
* Must be a finite, non-negative number of milliseconds. */
|
|
303
312
|
staleRunningMaxAgeMs?: number;
|
|
304
313
|
}
|
|
305
|
-
/**
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
314
|
+
/** The retention knobs a background-agent `reap` takes (and the durable-agent joint reap beside it). */
|
|
315
|
+
export declare const BACKGROUND_AGENT_REAP_KNOBS: readonly ["maxAgeMs", "keep", "staleRunningMaxAgeMs"];
|
|
316
|
+
/** knob-hygiene #98 — read a reap policy once and refuse a malformed one before any row is touched. Delegates to the one
|
|
317
|
+
* shared reading ({@link receiveRetentionPolicy}) both bundled stores and the sibling mailbox / workflow-run retention
|
|
318
|
+
* seams run through, so no implementation can drift from another; the sweep deletes by the copy this returns. */
|
|
319
|
+
export declare function receiveBackgroundAgentReapOptions(opts: BackgroundAgentReapOptions | undefined): Readonly<BackgroundAgentReapOptions>;
|
|
309
320
|
export interface BackgroundAgentStore {
|
|
310
321
|
put(record: BackgroundAgentRecord): Promise<void>;
|
|
311
322
|
get(handle: string, scope: string): Promise<BackgroundAgentRecord | null>;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { uuidv7 } from "../internal/harness.js";
|
|
2
|
-
import {
|
|
2
|
+
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
3
|
export const REVIVED_ROW_CLEARED_FIELDS = Object.freeze([
|
|
4
4
|
"settledAt",
|
|
5
5
|
"stoppedBy",
|
|
@@ -21,9 +21,10 @@ export function clearRevivedRowTerminalPayload(record) {
|
|
|
21
21
|
for (const field of REVIVED_ROW_CLEARED_FIELDS)
|
|
22
22
|
delete record[field];
|
|
23
23
|
}
|
|
24
|
+
export const declaresTranscriptDurability = (tier) => tier === "full";
|
|
24
25
|
const transcriptIntegrityAnnounced = new Set();
|
|
25
|
-
export function announceTranscriptIntegrityGapOnce(handle, scope, sink) {
|
|
26
|
-
if (sink === undefined)
|
|
26
|
+
export function announceTranscriptIntegrityGapOnce(handle, scope, sink, tier) {
|
|
27
|
+
if (sink === undefined || !declaresTranscriptDurability(tier))
|
|
27
28
|
return;
|
|
28
29
|
const key = `${scope ?? ""}\u0000${handle}`;
|
|
29
30
|
if (transcriptIntegrityAnnounced.has(key))
|
|
@@ -58,8 +59,9 @@ export function canAccessAgentRecord(record, access) {
|
|
|
58
59
|
return false;
|
|
59
60
|
}
|
|
60
61
|
export const STALE_RUNNING_REAP_ATTRIBUTION = "the host process was interrupted while this agent was running — its in-process state was lost. Check its worktree / output file for partial work before assuming the task landed (stale running row reaped).";
|
|
61
|
-
export
|
|
62
|
-
|
|
62
|
+
export const BACKGROUND_AGENT_REAP_KNOBS = Object.freeze(["maxAgeMs", "keep", "staleRunningMaxAgeMs"]);
|
|
63
|
+
export function receiveBackgroundAgentReapOptions(opts) {
|
|
64
|
+
return receiveRetentionPolicy("BackgroundAgentStore.reap", opts, BACKGROUND_AGENT_REAP_KNOBS);
|
|
63
65
|
}
|
|
64
66
|
export async function reconcileParkedAgents(stores, scope, now, opts) {
|
|
65
67
|
const out = { failed: 0, rolledBack: 0 };
|
|
@@ -274,15 +276,15 @@ export class InMemoryBackgroundAgentStore {
|
|
|
274
276
|
return [...new Set([...this.rows.values()].map((r) => r.scope))].sort();
|
|
275
277
|
}
|
|
276
278
|
async reap(scope, now, opts) {
|
|
277
|
-
|
|
278
|
-
if (
|
|
279
|
+
const policy = receiveBackgroundAgentReapOptions(opts);
|
|
280
|
+
if (policy.maxAgeMs === undefined && policy.keep === undefined && policy.staleRunningMaxAgeMs === undefined)
|
|
279
281
|
return 0;
|
|
280
282
|
const flippedKeys = new Set();
|
|
281
|
-
if (
|
|
283
|
+
if (policy.staleRunningMaxAgeMs !== undefined) {
|
|
282
284
|
for (const [k, r] of this.rows) {
|
|
283
285
|
if (r.scope !== scope || r.status !== "running")
|
|
284
286
|
continue;
|
|
285
|
-
if (now - r.updatedAt <=
|
|
287
|
+
if (now - r.updatedAt <= policy.staleRunningMaxAgeMs)
|
|
286
288
|
continue;
|
|
287
289
|
const flipped = structuredClone(r);
|
|
288
290
|
flipped.status = "failed";
|
|
@@ -300,14 +302,14 @@ export class InMemoryBackgroundAgentStore {
|
|
|
300
302
|
.filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
|
|
301
303
|
.sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
|
|
302
304
|
const doomed = new Set();
|
|
303
|
-
if (
|
|
305
|
+
if (policy.maxAgeMs !== undefined) {
|
|
304
306
|
for (const [k, r] of terminal) {
|
|
305
|
-
if ((r.settledAt ?? r.spawnedAt) < now -
|
|
307
|
+
if ((r.settledAt ?? r.spawnedAt) < now - policy.maxAgeMs)
|
|
306
308
|
doomed.add(k);
|
|
307
309
|
}
|
|
308
310
|
}
|
|
309
|
-
if (
|
|
310
|
-
for (const [k] of terminal.slice(Math.max(0,
|
|
311
|
+
if (policy.keep !== undefined) {
|
|
312
|
+
for (const [k] of terminal.slice(Math.max(0, policy.keep)))
|
|
311
313
|
doomed.add(k);
|
|
312
314
|
}
|
|
313
315
|
for (const k of doomed)
|
|
@@ -73,7 +73,7 @@ export interface BackgroundPoll {
|
|
|
73
73
|
* 不支持的 env(StubExecutionEnv / SSH / ADB)= 不实现(或 `supported:false`),三个后台工具自动不挂(INERT)。
|
|
74
74
|
*/
|
|
75
75
|
export interface BackgroundShellCapability {
|
|
76
|
-
/** 显式声明能力(像 `
|
|
76
|
+
/** 显式声明能力(像 `ExecutionEnv.capabilities` 一样不猜)。per-env / per-adapter。 */
|
|
77
77
|
readonly backgroundCapabilities: {
|
|
78
78
|
/** 是否真支持后台 spawn;`false` → 三工具不挂(design/103 §3.8)。 */
|
|
79
79
|
readonly supported: boolean;
|
|
@@ -167,6 +167,17 @@ export declare function envDeclaresRetain(env: ExecutionEnv): boolean;
|
|
|
167
167
|
* 单谓词足够:remote-env 刻意拆 `isRemoteExecutionEnv`(结构)/`isSuspendable`(语义)是因为 isolation/suspendable 两轴
|
|
168
168
|
* 彼此独立;这里 `supported` 是唯一语义轴,合进一个谓词不会丢信息。
|
|
169
169
|
*/
|
|
170
|
+
/**
|
|
171
|
+
* THE output file of a background command (a `run_in_background` / detached Bash, a Monitor watch): created empty in the
|
|
172
|
+
* env's temp dir and canonicalized BEFORE it is advertised — the receipt, the completion notification, the registry row
|
|
173
|
+
* and the key Read's root-fence exemption compares (`TaskRegistry.isBackgroundOutputFile`) must be the same string, and
|
|
174
|
+
* the OS temp dir sits behind a symlink on some platforms. The registry watcher appends every polled increment (stdout
|
|
175
|
+
* and stderr) to it. `undefined` = the file could not be created (the row then has no file, and its completion frame
|
|
176
|
+
* says so); a canonicalize failure keeps the raw path (the file still mirrors — only the exemption may miss). No engine
|
|
177
|
+
* deleter: the model may Read the file well after the task ends; reclamation is the temp-dir policy's job, and only the
|
|
178
|
+
* exemption dies early, with the row.
|
|
179
|
+
*/
|
|
180
|
+
export declare function createBackgroundOutputFile(env: ExecutionEnv, prefix: "bash-task-" | "monitor-task-"): Promise<string | undefined>;
|
|
170
181
|
export declare function hasBackgroundShell(env: ExecutionEnv): env is ExecutionEnv & BackgroundShellCapability;
|
|
171
182
|
/**
|
|
172
183
|
* The ONE way core runs an env-level background sweep.
|
|
@@ -15,6 +15,18 @@ export function envDeclaresRetain(env) {
|
|
|
15
15
|
const caps = env.backgroundCapabilities;
|
|
16
16
|
return typeof caps === "object" && caps !== null && caps.retainBackgroundProcesses === true;
|
|
17
17
|
}
|
|
18
|
+
export async function createBackgroundOutputFile(env, prefix) {
|
|
19
|
+
try {
|
|
20
|
+
const tf = await env.createTempFile({ prefix, suffix: ".output" });
|
|
21
|
+
if (!tf.ok)
|
|
22
|
+
return undefined;
|
|
23
|
+
const canon = await env.canonicalPath(tf.value);
|
|
24
|
+
return canon.ok ? canon.value : tf.value;
|
|
25
|
+
}
|
|
26
|
+
catch {
|
|
27
|
+
return undefined;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
18
30
|
export function hasBackgroundShell(env) {
|
|
19
31
|
const e = env;
|
|
20
32
|
return (typeof e.spawnBackground === "function" &&
|
|
@@ -6,7 +6,7 @@ import { type StoreFidelity, type Checkpoint, type CheckpointFeature, type Check
|
|
|
6
6
|
* had carried beside the one its word now names, and the members added after the table, each a capability a reader
|
|
7
7
|
* must have. Downstream reads them for display only (`CheckpointError.detail.requires`).
|
|
8
8
|
*/
|
|
9
|
-
export declare const REQUIREMENT_WORDS: readonly ["resource", "binding", "token", "orgAdmission", "f012", "realApproval", "face", "requirements_digest", "org_admission_inherited", "org_write_grant", "org_governed", "delegation_provenance", "skill_grants", "skill_card_binding", "hands_coordinates", "hands_home", "path_rule_anchors", "path_rule_installations", "permission_mode", "plan_mode_restore", "persisted_rule_mandate", "deployment_authored", "call_names", "write_face", "denial_limit_fallback", "leg_scope", "tool_ceiling", "tool_lists_judged", "own_tool_lists", "approval_targets", "approval_target_reads", "cross_boundary", "mount_site", "skill_scopes", "run_origin", "tool_declaration"];
|
|
9
|
+
export declare const REQUIREMENT_WORDS: readonly ["resource", "binding", "token", "orgAdmission", "f012", "realApproval", "face", "requirements_digest", "org_admission_inherited", "org_write_grant", "org_governed", "delegation_provenance", "skill_grants", "skill_card_binding", "hands_coordinates", "hands_home", "path_rule_anchors", "path_rule_installations", "permission_mode", "plan_mode_restore", "persisted_rule_mandate", "deployment_authored", "call_names", "write_face", "denial_limit_fallback", "leg_scope", "tool_ceiling", "tool_lists_judged", "own_tool_lists", "approval_targets", "approval_target_reads", "cross_boundary", "mount_site", "skill_scopes", "run_origin", "tool_declaration", "composition_leg", "row_task_id", "held_rows", "source_session"];
|
|
10
10
|
export type RequirementWord = (typeof REQUIREMENT_WORDS)[number];
|
|
11
11
|
/** Runtime twin of {@link RequirementWord}. */
|
|
12
12
|
export declare function isRequirementWord(word: unknown): word is RequirementWord;
|
|
@@ -212,9 +212,15 @@ export declare const CHECKPOINT_STATE_REQUIREMENTS: {
|
|
|
212
212
|
readonly isDelegatedChild: {
|
|
213
213
|
readonly digest: "decision-read";
|
|
214
214
|
};
|
|
215
|
+
readonly rowTaskId: {
|
|
216
|
+
readonly word: "row_task_id";
|
|
217
|
+
};
|
|
215
218
|
readonly placementRootSessionId: {
|
|
216
219
|
readonly digest: "decision-read";
|
|
217
220
|
};
|
|
221
|
+
readonly compositionLeg: {
|
|
222
|
+
readonly word: "composition_leg";
|
|
223
|
+
};
|
|
218
224
|
readonly externalContentTarget: {
|
|
219
225
|
readonly digest: "decision-read";
|
|
220
226
|
};
|
|
@@ -293,6 +299,9 @@ export declare const PENDING_ACTION_REQUIREMENTS: {
|
|
|
293
299
|
readonly classes: {
|
|
294
300
|
readonly digest: "decision-read";
|
|
295
301
|
};
|
|
302
|
+
readonly askReasons: {
|
|
303
|
+
readonly ignorable: "shown, never decided (card, listing, transcript or reported count): every read of the name renders, carries transcript or counts";
|
|
304
|
+
};
|
|
296
305
|
readonly boundInputHash: {
|
|
297
306
|
readonly digest: "decision-read";
|
|
298
307
|
};
|
|
@@ -480,6 +489,9 @@ export declare const CHECKPOINT_REQUIREMENTS: {
|
|
|
480
489
|
readonly leafId: {
|
|
481
490
|
readonly digest: "decision-read";
|
|
482
491
|
};
|
|
492
|
+
readonly heldRows: {
|
|
493
|
+
readonly word: "held_rows";
|
|
494
|
+
};
|
|
483
495
|
readonly state: {
|
|
484
496
|
readonly members: {
|
|
485
497
|
readonly activeTools: {
|
|
@@ -591,9 +603,15 @@ export declare const CHECKPOINT_REQUIREMENTS: {
|
|
|
591
603
|
readonly isDelegatedChild: {
|
|
592
604
|
readonly digest: "decision-read";
|
|
593
605
|
};
|
|
606
|
+
readonly rowTaskId: {
|
|
607
|
+
readonly word: "row_task_id";
|
|
608
|
+
};
|
|
594
609
|
readonly placementRootSessionId: {
|
|
595
610
|
readonly digest: "decision-read";
|
|
596
611
|
};
|
|
612
|
+
readonly compositionLeg: {
|
|
613
|
+
readonly word: "composition_leg";
|
|
614
|
+
};
|
|
597
615
|
readonly externalContentTarget: {
|
|
598
616
|
readonly digest: "decision-read";
|
|
599
617
|
};
|
|
@@ -669,8 +687,8 @@ export declare const CHECKPOINT_REQUIREMENTS: {
|
|
|
669
687
|
readonly rev: {
|
|
670
688
|
readonly mutable: "store state-machine member; integrity = CAS contract + kit, see #1580";
|
|
671
689
|
};
|
|
672
|
-
readonly
|
|
673
|
-
readonly
|
|
690
|
+
readonly sourceSessionId: {
|
|
691
|
+
readonly word: "source_session";
|
|
674
692
|
};
|
|
675
693
|
readonly principal: {
|
|
676
694
|
readonly digest: "decision-read";
|
|
@@ -817,6 +835,9 @@ export declare const CHECKPOINT_REQUIREMENTS: {
|
|
|
817
835
|
readonly classes: {
|
|
818
836
|
readonly digest: "decision-read";
|
|
819
837
|
};
|
|
838
|
+
readonly askReasons: {
|
|
839
|
+
readonly ignorable: "shown, never decided (card, listing, transcript or reported count): every read of the name renders, carries transcript or counts";
|
|
840
|
+
};
|
|
820
841
|
readonly boundInputHash: {
|
|
821
842
|
readonly digest: "decision-read";
|
|
822
843
|
};
|
|
@@ -38,6 +38,10 @@ export const REQUIREMENT_WORDS = Object.freeze([
|
|
|
38
38
|
"skill_scopes",
|
|
39
39
|
"run_origin",
|
|
40
40
|
"tool_declaration",
|
|
41
|
+
"composition_leg",
|
|
42
|
+
"row_task_id",
|
|
43
|
+
"held_rows",
|
|
44
|
+
"source_session",
|
|
41
45
|
]);
|
|
42
46
|
export function isRequirementWord(word) {
|
|
43
47
|
return typeof word === "string" && REQUIREMENT_WORDS.includes(word);
|
|
@@ -94,7 +98,9 @@ export const CHECKPOINT_STATE_REQUIREMENTS = {
|
|
|
94
98
|
gitAnnouncement: SHOWN,
|
|
95
99
|
delegationProvenance: { word: "delegation_provenance" },
|
|
96
100
|
isDelegatedChild: DECISION_READ,
|
|
101
|
+
rowTaskId: { word: "row_task_id" },
|
|
97
102
|
placementRootSessionId: DECISION_READ,
|
|
103
|
+
compositionLeg: { word: "composition_leg" },
|
|
98
104
|
externalContentTarget: DECISION_READ,
|
|
99
105
|
legScope: { word: "leg_scope" },
|
|
100
106
|
runOrigin: { word: "run_origin" },
|
|
@@ -123,6 +129,7 @@ export const PENDING_ACTION_REQUIREMENTS = {
|
|
|
123
129
|
origin: DECISION_READ,
|
|
124
130
|
askClass: DECISION_READ,
|
|
125
131
|
classes: DECISION_READ,
|
|
132
|
+
askReasons: SHOWN,
|
|
126
133
|
boundInputHash: DECISION_READ,
|
|
127
134
|
boundGrantDigest: { word: "skill_card_binding" },
|
|
128
135
|
boundGrants: SHOWN,
|
|
@@ -165,6 +172,7 @@ export const CHECKPOINT_REQUIREMENTS = {
|
|
|
165
172
|
scope: DECISION_READ,
|
|
166
173
|
sessionId: DECISION_READ,
|
|
167
174
|
leafId: DECISION_READ,
|
|
175
|
+
heldRows: { word: "held_rows" },
|
|
168
176
|
state: { members: CHECKPOINT_STATE_REQUIREMENTS },
|
|
169
177
|
resourceLedger: { members: RESOURCE_LEDGER_REQUIREMENTS },
|
|
170
178
|
deadline: DECISION_READ,
|
|
@@ -176,7 +184,7 @@ export const CHECKPOINT_REQUIREMENTS = {
|
|
|
176
184
|
resolvedOutcome: STATE_MACHINE,
|
|
177
185
|
reopenReason: STATE_MACHINE,
|
|
178
186
|
rev: STATE_MACHINE,
|
|
179
|
-
|
|
187
|
+
sourceSessionId: { word: "source_session" },
|
|
180
188
|
principal: DECISION_READ,
|
|
181
189
|
durableApproval: DECISION_READ,
|
|
182
190
|
executionOutcome: STATE_MACHINE,
|