@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
|
@@ -31,7 +31,8 @@ export interface TaskEventIdentity {
|
|
|
31
31
|
/**
|
|
32
32
|
* design/122 S2 (the `WorkflowRun.sourceTaskId` family, NOT a second `taskId` — that
|
|
33
33
|
* field already exists on `task_progress` and a duplicate would bite consumers) — the ORIGINATING task's
|
|
34
|
-
* canonical id (
|
|
34
|
+
* canonical id (the leg's single task id mint: a background sub-agent's registry task id, else the
|
|
35
|
+
* declared task id, else the session id), stamped ONLY on the content events of a task running AS A
|
|
35
36
|
* SUB-AGENT (same condition as {@link parentToolCallId}). A consumer of the C1 forward channel
|
|
36
37
|
* (`forwardSubagentEvents`) can key a child's content events by the child task directly, without an
|
|
37
38
|
* alias table. A TOP-LEVEL task's own events carry NO `sourceTaskId` (absent = the consumer's current
|
|
@@ -113,6 +114,12 @@ export type BrainStatusPhase = "rate_limited" | "retrying" | "reconnecting" | "c
|
|
|
113
114
|
* lowered output cap after the provider reported the context limit exceeded (no backoff).
|
|
114
115
|
*/
|
|
115
116
|
export type BrainRetryErrClass = "connect_refused" | "transport" | "stall" | "rate_limit" | "server" | "http" | "output_cap";
|
|
117
|
+
/**
|
|
118
|
+
* WHOSE model call a liveness frame is about, when it is not the run's own turn — the closed set behind
|
|
119
|
+
* {@link BrainStatus.seat}. `classifier` = a call made for the auto-mode classifier lane (the classifier seat's model, or the
|
|
120
|
+
* main model standing in behind it): a side call beside the person's turn, never the turn itself.
|
|
121
|
+
*/
|
|
122
|
+
export type BrainStatusSeat = "classifier";
|
|
116
123
|
/** design/99 §E3/§E10 — the payload of a {@link TaskEvent} `status` event (and the brain→runner signal). */
|
|
117
124
|
export interface BrainStatus {
|
|
118
125
|
phase: BrainStatusPhase;
|
|
@@ -235,6 +242,15 @@ export interface BrainStatus {
|
|
|
235
242
|
/** Which evidence {@link providerCondition} rests on (`unified_header` / `provider_code` / `status`). Present
|
|
236
243
|
* exactly when it is. */
|
|
237
244
|
providerConditionSource?: ProviderConditionSource;
|
|
245
|
+
/**
|
|
246
|
+
* WHOSE model call this frame is about ({@link BrainStatusSeat}), on every phase — a 429 backoff, a reconnect, a
|
|
247
|
+
* `circuit_open` fast-fail or a first-token wait all describe ONE call, and the person watching needs to know it is not their
|
|
248
|
+
* turn's. PRESENCE: `"classifier"` exactly on a frame about a call made for the auto-mode classifier lane
|
|
249
|
+
* (whichever rung's model it was asked on: the classifier seat's, or the main model standing in behind it). ABSENT =
|
|
250
|
+
* the run's own turn: the engine does not state a seat for the person's own model, so a consumer reads absence as "the
|
|
251
|
+
* main loop" — never as "unknown". Additive and optional: a consumer that never reads it renders every frame as before.
|
|
252
|
+
*/
|
|
253
|
+
seat?: BrainStatusSeat;
|
|
238
254
|
}
|
|
239
255
|
/**
|
|
240
256
|
* design/97 CORE-8 (③): one lightweight TOOL-ACTIVITY beat surfaced from a running task, for a per-agent live
|
|
@@ -442,8 +458,8 @@ export type TaskEvent = ({
|
|
|
442
458
|
* text plus whatever else it carries) — with any block that is neither text nor an admitted image/document, at its
|
|
443
459
|
* serialization — are one character stream under the text cap, cut IN
|
|
444
460
|
* PLACE where the cap runs out (that block ends with the marker, the stream's later blocks leave); MEDIA blocks are not
|
|
445
|
-
* measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.
|
|
446
|
-
* default `
|
|
461
|
+
* measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.mediaBudgetBase64Chars`,
|
|
462
|
+
* default `IMAGE_ADMISSION.request.budgetBase64Chars`: base64 characters, spent as wire bytes after the text's
|
|
447
463
|
* serialized size), past which a block becomes `{ type, mimeType?, bytes, truncated: true }` in its slot (never a
|
|
448
464
|
* string; a media type over 255 characters is not echoed), and when not even a descriptor fits, it and every later
|
|
449
465
|
* media block fold into ONE `{ type: "omitted", blocks, bytes, truncated: true }` in its slot, so the media in an event
|
|
@@ -463,7 +479,7 @@ export type TaskEvent = ({
|
|
|
463
479
|
/**
|
|
464
480
|
* design/116 (b) — the tool's CC-shaped `toolUseResult` facts (`details.type` ∈ the known card
|
|
465
481
|
* set: edit/create/update/bash/text/grep/glob/notebook-edit/notebook/file_unchanged/mcp/image/
|
|
466
|
-
* document/worktree/todo/task/task-list/task-
|
|
482
|
+
* document/worktree/todo/task/task-list/task-stop/agent/fork/workflow-run/web-fetch/
|
|
467
483
|
* web-search/cron-create/cron-delete/cron-list/tool-search/repo-map/monitor-start/
|
|
468
484
|
* enter-plan-mode/exit-plan-mode/report-findings/schedule-wakeup/send-message/agent-transcript/
|
|
469
485
|
* a2a/path_not_in_root/readonly_out_of_root/read_unestablished/advisor), surfaced on the live wire so a CC-faithful shell
|
|
@@ -835,6 +851,10 @@ export type TaskEvent = ({
|
|
|
835
851
|
* (summaryMs ?? 0) + persistMs === {@link durationMs} (exact tiling; `summaryMs` absent on a
|
|
836
852
|
* provider-reuse pass — no summary LLM call happened). Absent on legacy emitters. */
|
|
837
853
|
phaseDurations?: import("./auto-compaction.js").CompactionPhaseDurations;
|
|
854
|
+
/** Who asked for this pass when an extension did: present when the pass served a manual request an extension made
|
|
855
|
+
* (`$.session.compact`, by its registration name — the last such caller when several requests coalesced onto the
|
|
856
|
+
* pass); absent on every other pass, a `compact()` request of the host's included. A display and audit fact only. */
|
|
857
|
+
requestedBy?: ExtensionRequester;
|
|
838
858
|
} & TaskEventIdentity) | ({
|
|
839
859
|
/**
|
|
840
860
|
* RB-398-b④: a compaction pass concluded WITHOUT landing — the non-landing outcomes
|
|
@@ -874,6 +894,9 @@ export type TaskEvent = ({
|
|
|
874
894
|
* started — `blocked`, `suppressed`, `disabled`, `noop`, a `mooted` request no boundary served — and on the
|
|
875
895
|
* rapid-refill `disabled` frame, which reports a state the landing before it caused, not that pass's end. */
|
|
876
896
|
pass?: string;
|
|
897
|
+
/** Who asked for this pass when an extension did — the `compacted` frame's member of the same name, on the same
|
|
898
|
+
* condition: present when the outcome is a manual request's an extension made (`$.session.compact`). */
|
|
899
|
+
requestedBy?: ExtensionRequester;
|
|
877
900
|
} & TaskEventIdentity) | ({
|
|
878
901
|
/**
|
|
879
902
|
* A compaction pass is under way: the engine has committed to it and is about to produce its summary.
|
|
@@ -1089,7 +1112,8 @@ export type TaskEvent = ({
|
|
|
1089
1112
|
* `spawn_depth` (the nesting is the `parentTaskId` chain), and the shell/monitor-only members.
|
|
1090
1113
|
*/
|
|
1091
1114
|
type: "task_started";
|
|
1092
|
-
/** The child
|
|
1115
|
+
/** The child leg's task id (a background sub-agent's registry task id, else its session id) — the
|
|
1116
|
+
* key its `task_progress` frames carry. */
|
|
1093
1117
|
taskId: string;
|
|
1094
1118
|
/** The child run's session id — the handle its transcript is read by. */
|
|
1095
1119
|
sessionId: string;
|
|
@@ -1130,9 +1154,9 @@ export type TaskEvent = ({
|
|
|
1130
1154
|
* Live/ephemeral — NOT persisted (a resumable trace re-derives usage from the result), like `status`.
|
|
1131
1155
|
* Maps to CC `SDKTaskProgress` (camelCase here → snake_case `task_id`/`total_tokens`/`tool_uses`/`duration_ms`
|
|
1132
1156
|
* at the SDK/service projection, the same convention as `toolCallId`→`tool_use_id`).
|
|
1133
|
-
* `taskId` is the child
|
|
1134
|
-
*
|
|
1135
|
-
*
|
|
1157
|
+
* `taskId` is the child leg's task id, minted once by the child's prepare: a background
|
|
1158
|
+
* sub-agent's is its registry task id (the `a…` handle TaskStop / TaskOutput / SendMessage take),
|
|
1159
|
+
* a foreground child's is its session id. One child, one id — `docs/INTEGRATION-CORE.md` §1.6a.
|
|
1136
1160
|
*/
|
|
1137
1161
|
type: "task_progress";
|
|
1138
1162
|
taskId: string;
|
|
@@ -1263,8 +1287,9 @@ export type TaskEvent = ({
|
|
|
1263
1287
|
id: string;
|
|
1264
1288
|
source: "marker" | "declared";
|
|
1265
1289
|
};
|
|
1266
|
-
/** True ⇔ the
|
|
1267
|
-
*
|
|
1290
|
+
/** True ⇔ the leg's execution env does not declare its paths the host's (`capabilities.hostLocalPaths`), so the
|
|
1291
|
+
* paths name locations inside that env, not host paths — whatever interface drives it: a host lane driven
|
|
1292
|
+
* through the remote seam reads `false` (the reading `ResolvedWorkspace.remote` carries). */
|
|
1268
1293
|
remote: boolean;
|
|
1269
1294
|
} & TaskEventIdentity) | ({
|
|
1270
1295
|
/**
|
|
@@ -23,6 +23,11 @@ import type { ModelRef } from "./model-seat.js";
|
|
|
23
23
|
*
|
|
24
24
|
* **Priority.** Several axes may be armed at once; the first to trip stops the run. When more than one
|
|
25
25
|
* trips at the same turn boundary the attribution order is tokens > cost > turns > walltime.
|
|
26
|
+
*
|
|
27
|
+
* **One task, several legs.** The verification gate and the repair loop run one task as several `runTask` legs; they read
|
|
28
|
+
* the task's whole-task ceilings (these windows on a task that cannot suspend, the `resourceSuspend` totals on one that can)
|
|
29
|
+
* as the TASK's, and dispatch each later leg on what the legs before it left (`src/agents/composition-allowance.ts`).
|
|
30
|
+
* `runGoal` and the cascade keep a per-iteration / per-rung allowance.
|
|
26
31
|
*/
|
|
27
32
|
export interface TaskLimits {
|
|
28
33
|
/**
|
|
@@ -14,11 +14,13 @@ export type SystemInjectionPriority = "now" | "next" | "later";
|
|
|
14
14
|
* session's next run in this process (a process restart loses it);
|
|
15
15
|
* · `parked_durably` — no live lane; appended to the session's DURABLE box
|
|
16
16
|
* ({@link PendingSessionNotifications.bindSessionBox}) — the next run drains it, in any process;
|
|
17
|
-
* · `dropped_duplicate` — the session already delivered this exact frame
|
|
17
|
+
* · `dropped_duplicate` — the session already delivered this exact frame;
|
|
18
|
+
* · `refused` — a live lane took it and the session's receiving station did not hand it over: an extension consumed it,
|
|
19
|
+
* or a handler there failed ({@link FrameReceiver}). The model never saw it, and it is not owed again.
|
|
18
20
|
* The park backend is the seat's choice ({@link routeOrParkNotification}), never the producer's.
|
|
19
21
|
*/
|
|
20
|
-
export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate";
|
|
21
|
-
export declare const NOTIFICATION_INJECTION_OUTCOMES: readonly ["queued", "parked", "parked_durably", "dropped_duplicate"];
|
|
22
|
+
export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate" | "refused";
|
|
23
|
+
export declare const NOTIFICATION_INJECTION_OUTCOMES: readonly ["queued", "parked", "parked_durably", "dropped_duplicate", "refused"];
|
|
22
24
|
/** Is `value` one of the injector's outcome words? A host-wired uplink may answer anything (a bare
|
|
23
25
|
* `void`, an array's `push` count) — such an answer reads as "outcome not reported", never as a word. */
|
|
24
26
|
export declare function isNotificationInjectionOutcome(value: unknown): value is NotificationInjectionOutcome;
|
|
@@ -207,7 +209,7 @@ export interface TaskNotificationPayload {
|
|
|
207
209
|
resumable?: boolean;
|
|
208
210
|
/** A cross-channel correlation key for ONE completion event — the same task's completion fans out
|
|
209
211
|
* across several independent read faces (this live notification frame, a durable inbox entry, and the
|
|
210
|
-
*
|
|
212
|
+
* host task poll projection). Minted ONCE per completion, fill-once (first writer wins), on the
|
|
211
213
|
* same task-registry handle/record every read face serves from — see
|
|
212
214
|
* {@link "./task-registry.js".UnifiedTaskOutput.completionId} for the shared contract (open-shape
|
|
213
215
|
* `string`, absent until terminal settle, absent on a pre-P1-3 core build). Deliberately ABSENT on
|
|
@@ -285,7 +287,38 @@ export interface TaskNotificationPayload {
|
|
|
285
287
|
* and the record's typed peer metadata rides in `peerMeta` (on a notice frame its `notice` is THE typed notice).
|
|
286
288
|
*/
|
|
287
289
|
_sema_provenance?: SemaProvenance;
|
|
290
|
+
/**
|
|
291
|
+
* The text a receiving extension handed the model in place of this frame's rendering (the `session.receive` station,
|
|
292
|
+
* {@link FrameReceiver}), and who changed it. Set only on the copy a delivery carries — never on the frame a producer,
|
|
293
|
+
* a park or a box holds — and {@link renderTaskNotificationXml} returns it verbatim: every face that renders the frame
|
|
294
|
+
* (the live lane, the turn-open redelivery, a `ReadInbox` result, its receipt ask) reads the one rendering.
|
|
295
|
+
*/
|
|
296
|
+
received?: {
|
|
297
|
+
readonly text: string;
|
|
298
|
+
readonly rewrittenBy: readonly string[];
|
|
299
|
+
};
|
|
300
|
+
}
|
|
301
|
+
/**
|
|
302
|
+
* The session's one receiving station (`session.receive`): every face a frame reaches the model by — the live lane (a
|
|
303
|
+
* producer's injection, a frame routed in from another run of the session, a peer letter the box drain pushes), the
|
|
304
|
+
* turn-open redelivery of what was parked, and the box's `ReadInbox` pull — hands the frame to it before the hand-over, and
|
|
305
|
+
* hands over what it answers. Awaited; with no handler listening, nothing is raised and a caller keeps its own path.
|
|
306
|
+
*/
|
|
307
|
+
export interface FrameReceiver {
|
|
308
|
+
/** Does a handler listen? `false` ⇒ the frame passes as made, and nothing is raised. */
|
|
309
|
+
listens(): boolean;
|
|
310
|
+
/** What becomes of `payload`: handed over (the frame, or a copy carrying {@link TaskNotificationPayload.received}), or
|
|
311
|
+
* consumed — not handed over, by the extension `by` (or the engine, when the station could not judge), for `reason`. */
|
|
312
|
+
receive(payload: TaskNotificationPayload): Promise<ReceivedFrame>;
|
|
288
313
|
}
|
|
314
|
+
export type ReceivedFrame = {
|
|
315
|
+
readonly kind: "arrived";
|
|
316
|
+
readonly payload: TaskNotificationPayload;
|
|
317
|
+
} | {
|
|
318
|
+
readonly kind: "consumed";
|
|
319
|
+
readonly by: string;
|
|
320
|
+
readonly reason: string;
|
|
321
|
+
};
|
|
289
322
|
/** design/385 §1.4 d1 / §4.1 — see {@link TaskNotificationPayload._sema_provenance}. `kind` is a
|
|
290
323
|
* closed set of the engine carriers that mint the record; a future carrier adds a member, never a
|
|
291
324
|
* second key. */
|
|
@@ -515,12 +548,23 @@ export declare function terminalFrameFacets(facts: {
|
|
|
515
548
|
warning?: string | undefined;
|
|
516
549
|
compaction?: TaskNotificationPayload["compaction"] | undefined;
|
|
517
550
|
}): Pick<TaskNotificationPayload, "spawnName" | "handback" | "compaction">;
|
|
551
|
+
/** What the deployment hears when a report the frame carried whole could not be stored: the task row keeps no read handle. */
|
|
552
|
+
export declare const SHORT_REPORT_UNSTORED = "a background task's report could not be stored (the write failed or went unconfirmed): its completion frame carried the whole report, but its task row keeps no read handle for a later list";
|
|
518
553
|
/**
|
|
519
554
|
* A delegated child's report as its completion frame carries it — the one value the parent's notification and the fleet
|
|
520
555
|
* terminal projected from that frame both read: redacted BEFORE the cut, with the pass the task row's copy uses (a token
|
|
521
|
-
* across the cut is never half-shown), then cut with an honest total.
|
|
556
|
+
* across the cut is never half-shown), then cut with an honest total. The report is the task's result artifact whatever its
|
|
557
|
+
* length: `persist` stores the whole redacted report and `record` hands the stored ref to the task row as its read handle
|
|
558
|
+
* (a list of tasks names it when the frame itself is lost) — only after the write landed. A report longer than the frame
|
|
559
|
+
* carries is cut, and its cut line names that ref, so the frame waits for the write; a report the frame carries whole does
|
|
560
|
+
* not wait (its write lands on its own and records the ref then — a stalled store never holds a complete answer back).
|
|
561
|
+
* That unawaited write still has a failure path: a write that went unconfirmed, or anything thrown on the way, reaches the
|
|
562
|
+
* caller's `notifier` (its first failure per site is disclosed on the deployment's channel), never the floor. `record`
|
|
563
|
+
* names the settle the result belongs to, so a write landing after the row moved on records nothing. Absent in ⇒ absent out.
|
|
522
564
|
*/
|
|
523
|
-
export declare function
|
|
565
|
+
export declare function completionResultField(result: string | undefined, persist: (report: string) => Promise<import("./tool-result-store.js").TaskArtifact>, record: (ref: string) => void, notifier: Pick<import("./safe-notify.js").SafeNotifier, "notifyAsync">): Promise<{
|
|
566
|
+
readonly text: string;
|
|
567
|
+
} | undefined>;
|
|
524
568
|
/** The codec version this engine writes into an `engine_frame` record and the highest it reads. */
|
|
525
569
|
export declare const ENGINE_FRAME_CODEC_VERSION = 1;
|
|
526
570
|
/** The engine's own lanes — the only frames the durable park may encode (an `external` event never is). */
|
|
@@ -580,6 +624,75 @@ export declare function isDelegatedAgentTerminal(n: Pick<TaskNotificationPayload
|
|
|
580
624
|
* lane-blind, the trust cut is the marking site's.
|
|
581
625
|
*/
|
|
582
626
|
export declare function isTerminalTaskNotification(n: Pick<TaskNotificationPayload, "status">): boolean;
|
|
627
|
+
/**
|
|
628
|
+
* THE completion-sink resolution every background producer reads — a background command, a Monitor watch, a background
|
|
629
|
+
* agent, a workflow run: the run lane the call carries (`ToolExecuteContext.onTaskNotification`) when there is one, else
|
|
630
|
+
* the mount's own sink. One value per launch: the producer judges "will a completion reach the model" by it, delivers
|
|
631
|
+
* through it, and owes its terminal frame to it ({@link oweTerminalDelivery}) — never one sink for the judgment and
|
|
632
|
+
* another for the delivery.
|
|
633
|
+
*/
|
|
634
|
+
export declare function resolveCompletionSink<C, M>(callSink: C | undefined, mountSink: M | undefined): C | M | undefined;
|
|
635
|
+
/**
|
|
636
|
+
* THE background admission every producer applies at launch — a background command, a Monitor watch, a background
|
|
637
|
+
* agent, a workflow run, a continued agent: the launch is made only when its completion will come back — the one
|
|
638
|
+
* resolved completion sink ({@link resolveCompletionSink}) is there, or the deployment wired a channel of its own for
|
|
639
|
+
* this producer outside the engine (a workflow's durable notifier; a host that announces a continued agent itself).
|
|
640
|
+
* No channel ⇒ no background launch: an agent runs synchronously instead, every other producer refuses before any
|
|
641
|
+
* side effect. Judged at the call, never at the mount — a mount cannot know the run lane a call will carry (a
|
|
642
|
+
* caller-mounted tool gets its run's lane on the call's context only) — so a mount offers its background option on its
|
|
643
|
+
* own capability, and every "you will be notified" a face says holds for any launch this admits.
|
|
644
|
+
*/
|
|
645
|
+
export declare function admitsBackgroundLaunch<S>(sink: S | undefined): sink is S;
|
|
646
|
+
export declare function admitsBackgroundLaunch(sink: unknown, deploymentChannel: boolean): boolean;
|
|
647
|
+
/**
|
|
648
|
+
* The terminal frames a run's notification lane is still OWED — the one book a one-shot submission's ending waits on.
|
|
649
|
+
* A loop-type background task (a background agent, a continued agent, a workflow run) whose completion sink is a run's
|
|
650
|
+
* lane is entered when it is admitted ({@link oweTerminalDelivery}, on the sink it will deliver through); its terminal
|
|
651
|
+
* frame reaching that sink discharges it — whatever the lane then does with the frame (queues it for this run, or parks
|
|
652
|
+
* it for the session's next run): either way nothing more for that cycle will arrive on this lane. A debt is per CYCLE:
|
|
653
|
+
* an agent continued while its previous cycle's frame is still on its way owes two frames, and one frame — counted once,
|
|
654
|
+
* by its identity (`taskNotificationDedupKey`) — settles one. A debt is booked under the task's lane key
|
|
655
|
+
* ({@link taskNotificationLaneKey}, the pending store's own bucket key): admission, discharge and release all name the
|
|
656
|
+
* task by the frame it delivers, so a frame of another lane carrying the same `task_id` settles nothing here. A background
|
|
657
|
+
* command or a Monitor watch never enters: its lifetime is its process's (it may never end), and a one-shot ending treats
|
|
658
|
+
* it by the run's teardown rules without waiting. A sink no lane bound (a host's own) owes nothing.
|
|
659
|
+
*/
|
|
660
|
+
export declare class DeliveryObligations {
|
|
661
|
+
/** lane key → admitted cycles whose terminal frame has not reached the sink. */
|
|
662
|
+
private readonly owed;
|
|
663
|
+
/** The terminal frames already counted (their dedup keys): a repeat of one settles nothing more. */
|
|
664
|
+
private readonly counted;
|
|
665
|
+
private readonly wakers;
|
|
666
|
+
/** When the waiting stops whatever is still owed (monotonic) — set by the first wait, never moved. */
|
|
667
|
+
private waitDeadline;
|
|
668
|
+
owe(task: Pick<TaskNotificationPayload, "task_id" | "task_type">): void;
|
|
669
|
+
discharge(frame: TaskNotificationPayload): void;
|
|
670
|
+
/** A cycle whose terminal frame was voided before it reached the sink (a continuation dropped its deferred frame) owes
|
|
671
|
+
* nothing more: one debt is released, the same way its frame would have released it. */
|
|
672
|
+
retire(task: Pick<TaskNotificationPayload, "task_id" | "task_type">): void;
|
|
673
|
+
private release;
|
|
674
|
+
/** Wake a wait to re-check its condition (a discharge, or input the run can now drain). */
|
|
675
|
+
wake(): void;
|
|
676
|
+
/** The lane keys still owed (an internal lane's is its task id), in admission order. */
|
|
677
|
+
get pending(): readonly string[];
|
|
678
|
+
/** Resolves at the next wake, when `signal` aborts, or after `withinMs` — at once when nothing is owed, it has already
|
|
679
|
+
* aborted, or no time is left. */
|
|
680
|
+
nextDischarge(signal: AbortSignal, withinMs: number): Promise<void>;
|
|
681
|
+
/**
|
|
682
|
+
* Wait out the debt the way a one-shot ending does: wake by wake, while something is owed, `keepWaiting()` holds (no
|
|
683
|
+
* input is queued for the run yet, the run is not ending) and `signal` has not aborted — and never past the reference's
|
|
684
|
+
* print-mode ceiling, counted from this book's first wait: `mFt` (cli309.js:260064), the default of
|
|
685
|
+
* `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` (cli309.js:263180), taken as a constant. `onInput` subscribes a wake to every
|
|
686
|
+
* input that reaches the run's queues meanwhile (a steer, a child's message, any engine note) — the wait re-checks.
|
|
687
|
+
*/
|
|
688
|
+
waitOut(signal: AbortSignal, keepWaiting: () => boolean, onInput: (wake: () => void) => () => void): Promise<void>;
|
|
689
|
+
}
|
|
690
|
+
export declare function bindDeliveryObligations(sink: object, book: DeliveryObligations): void;
|
|
691
|
+
/** An admitted loop-type task owes `sink` its terminal frame — named by that frame's `task_id` and `task_type` (a no-op
|
|
692
|
+
* for a sink no run lane bound, or none). */
|
|
693
|
+
export declare function oweTerminalDelivery(sink: unknown, task: Pick<TaskNotificationPayload, "task_id" | "task_type">): void;
|
|
694
|
+
/** A cycle whose terminal frame will never reach `sink` (it was voided) releases its debt there (no-op for an unbound sink). */
|
|
695
|
+
export declare function retireTerminalDelivery(sink: unknown, task: Pick<TaskNotificationPayload, "task_id" | "task_type">): void;
|
|
583
696
|
export interface DrainedPendingNotifications {
|
|
584
697
|
/** Payloads still held when the session's next run drained. design/373 §3.5: batch order is
|
|
585
698
|
* PRIORITY-MAJOR (now < next < later; a record with no carried priority ranks AS later —
|
|
@@ -606,7 +719,7 @@ export interface DrainedPendingNotifications {
|
|
|
606
719
|
* key, which put a session-level fact into a per-task ledger and broke twice for it: the key could
|
|
607
720
|
* collide with a real, free-form external `task_id` (merging two unrelated counts and mislabelling the
|
|
608
721
|
* lane — design/144 X1 already ruled that the external lane needs its own key space), and the
|
|
609
|
-
* survivors-none renderer told the model to
|
|
722
|
+
* survivors-none renderer told the model to poll a task id `"(evicted-session)"`, an instruction with
|
|
610
723
|
* nothing behind it. The count is a session fact; it now has a session field.
|
|
611
724
|
*/
|
|
612
725
|
droppedWholeSession?: number;
|
|
@@ -705,6 +818,16 @@ export declare class SessionLiveNotificationLanes {
|
|
|
705
818
|
/** Sessions holding at least one live lane (observability + the tests' rollback detector). */
|
|
706
819
|
get size(): number;
|
|
707
820
|
}
|
|
821
|
+
/**
|
|
822
|
+
* What a double fault at the park seat leaves beside its in-process copy: the box the record was meant for (the binding
|
|
823
|
+
* the seat asked, as it was then — the store object, scope and handle) and the record it asked with. The copy is a debt
|
|
824
|
+
* owed to THAT box, settled by asking it again ({@link PendingSessionNotifications.settleBoxDebts}) — never by comparing
|
|
825
|
+
* it with whatever box the session binds later.
|
|
826
|
+
*/
|
|
827
|
+
export interface SessionBoxDebt {
|
|
828
|
+
readonly box: SessionBoxBinding;
|
|
829
|
+
readonly record: MailboxAppendMessage;
|
|
830
|
+
}
|
|
708
831
|
export declare class PendingSessionNotifications {
|
|
709
832
|
private readonly sessions;
|
|
710
833
|
/**
|
|
@@ -738,8 +861,24 @@ export declare class PendingSessionNotifications {
|
|
|
738
861
|
bindSessionBox(sessionId: string, box: SessionBoxBinding | undefined): void;
|
|
739
862
|
/** The session's durable box, when a leg of it mounted the drain in this process. */
|
|
740
863
|
sessionBoxFor(sessionId: string): SessionBoxBinding | undefined;
|
|
741
|
-
|
|
742
|
-
|
|
864
|
+
/**
|
|
865
|
+
* Settle what the session's pending copies owe their boxes ({@link SessionBoxDebt}): each is asked of its own box once
|
|
866
|
+
* more, under its record, in pend order. A box that answers took the record — it holds it, or received it already —
|
|
867
|
+
* so the delivery is the box's and the copy is dropped (the box then owns the key, as after a durable park). A box
|
|
868
|
+
* that refuses, whatever the refusal, is disclosed once on that binding and the copy stays an ordinary pending
|
|
869
|
+
* notification. Never rejects. `undefined` when nothing is owed: a leg with no debt takes no store round trip. ONE
|
|
870
|
+
* pass over what is owed when it starts, stopped by `signal`: a debt that arrives meanwhile, or one an abort left
|
|
871
|
+
* unasked, stays owed — and a copy that owes its box is never drained ({@link drain} keeps it back) — until a later
|
|
872
|
+
* leg's settlement asks.
|
|
873
|
+
*/
|
|
874
|
+
settleBoxDebts(sessionId: string, signal?: AbortSignal): Promise<void> | undefined;
|
|
875
|
+
/** What a drain hands out of a parked record: everything but the copies that still owe their box — those go back
|
|
876
|
+
* into the store as the session's record (with their keys, tiers and debts) for the leg that settles them. */
|
|
877
|
+
private keepBackOwing;
|
|
878
|
+
private settleBoxDebt;
|
|
879
|
+
pend(sessionId: string, n: TaskNotificationPayload, priority?: SystemInjectionPriority, debt?: SessionBoxDebt): void;
|
|
880
|
+
/** Remove and return the session's pendings (one-shot — the next run consumes them exactly once); a copy that
|
|
881
|
+
* still owes its box stays parked for the leg that settles it ({@link settleBoxDebts}).
|
|
743
882
|
* design/373 §3.5: the batch comes out PRIORITY-MAJOR (stable sort — pend order within a class;
|
|
744
883
|
* a no-priority record ranks as later), the idle-dequeue min-value-first form. */
|
|
745
884
|
drain(sessionId: string): DrainedPendingNotifications | undefined;
|
|
@@ -819,7 +958,7 @@ export declare function sessionBoxRecordOf(payload: TaskNotificationPayload & {
|
|
|
819
958
|
* carrier shapes, chosen per survivor:
|
|
820
959
|
* · a CLASSIC survivor (renders through the `<task-notification>` shell) is annotated IN PLACE — the
|
|
821
960
|
* first surviving payload of a task that lost events gets a `[task_id]`-prefixed disclosure line
|
|
822
|
-
* prepended to its summary (backgroundTasks 同规: the id keeps the loss addressable
|
|
961
|
+
* prepended to its summary (backgroundTasks 同规: the id keeps the loss addressable);
|
|
823
962
|
* · an AGENT-MESSAGE survivor (design/385 §1.4 d1; renders as the `<agent-message>` carrier, its
|
|
824
963
|
* `summary` wire-only) is left byte-unchanged, and the disclosure rides as a SEPARATE engine-authored
|
|
825
964
|
* `event` payload inserted immediately AHEAD of it (engine speech never goes inside a peer frame;
|
|
@@ -829,9 +968,30 @@ export declare function sessionBoxRecordOf(payload: TaskNotificationPayload & {
|
|
|
829
968
|
* whole-session line below) — consume it by iteration, never by index-pairing against `items`. The
|
|
830
969
|
* zero-disclosure path returns `drained.items` itself (identity, no allocation). A task whose EVERY
|
|
831
970
|
* pending item was evicted still gets one honest synthetic `event` payload saying so — a fully silent
|
|
832
|
-
* loss is never allowed.
|
|
971
|
+
* loss is never allowed. `readHandleOf` = the leg's reading of a task's read handle (`Prepared.taskReadHandleOf`): that
|
|
972
|
+
* synthetic line names where the task's output or result is read, or that its row is no longer readable from this run.
|
|
973
|
+
* `tasks` = the leg's background-task table, finished rows included (`Prepared.listBackgroundTasks({ settled: true })`):
|
|
974
|
+
* a whole-session loss names no task, so its line carries that table instead — every task the run can still reach, live
|
|
975
|
+
* or finished, and where each is read — or says the run has none. A caller with neither reading claims nothing.
|
|
976
|
+
*/
|
|
977
|
+
export declare function discloseDroppedPending(drained: DrainedPendingNotifications, readHandleOf?: (taskId: string) => string | undefined, tasks?: () => ReadonlyArray<BackgroundTaskTableRow>): TaskNotificationPayload[];
|
|
978
|
+
/** One task as the background-task table lists it: its id (TaskStop addresses it), its description, its status, and its read
|
|
979
|
+
* handle (`TaskRegistry.readHandleOf`) — where its output or result is read; absent = nothing to read yet. */
|
|
980
|
+
export interface BackgroundTaskTableRow {
|
|
981
|
+
id: string;
|
|
982
|
+
description?: string;
|
|
983
|
+
status: string;
|
|
984
|
+
read?: string;
|
|
985
|
+
}
|
|
986
|
+
/**
|
|
987
|
+
* THE background-task table body — every model-facing list of a run's background tasks renders through it (the
|
|
988
|
+
* post-compaction announce, a whole-session loss line). The per-task status phrase is the reference's attachment-renderer
|
|
989
|
+
* wording (cli309.js:296735) "completed in background" — completed → "completed in background" · killed → "stopped" ·
|
|
990
|
+
* running → "still running in background" · anything else → the raw status (CC's own fallback arm); the line mirrors CC's
|
|
991
|
+
* `Task "${description}" ${phrase}` with the sema task_id prefixed and the row's read handle after it. A capped list says
|
|
992
|
+
* how many it left out, so a short count is never passed off as the whole.
|
|
833
993
|
*/
|
|
834
|
-
export declare function
|
|
994
|
+
export declare function renderBackgroundTaskTable(tasks: ReadonlyArray<BackgroundTaskTableRow>): string;
|
|
835
995
|
export declare class SystemInjectionQueue<TPayload = TaskNotificationPayload> {
|
|
836
996
|
private readonly queues;
|
|
837
997
|
private readonly dedup;
|