@sema-agent/core 7.60.0 → 7.62.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 +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- 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 +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- 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 +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -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 +138 -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 +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- 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 +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- 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/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- 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 +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- 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 +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -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/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- 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 +11 -11
- 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 +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- 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 +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- 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/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
import { randomBytes } from "node:crypto";
|
|
2
|
-
import {
|
|
2
|
+
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
3
|
import { uuidv7 } from "../internal/harness.js";
|
|
4
|
-
import { canAccessAgentRecord, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
|
|
4
|
+
import { BACKGROUND_AGENT_REAP_KNOBS, canAccessAgentRecord, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
|
|
5
5
|
import { shutdownDebug } from "./shutdown-debug.js";
|
|
6
6
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
7
7
|
import { boundedRedactedSummary } from "./untrusted-egress.js";
|
|
8
|
-
import { mintCompletionId, commitCompletionIdIfEmpty, clipTaskOutput, assertOwnership, sleepPollStep, alreadyTerminalStopNote, canAccess, normalizeAgentName, engineAgentName, chosenAgentName,
|
|
9
|
-
import { buildToolResultRef, OFFLOAD_TOOL_NAME, toolResultProvenanceOf } from "./tool-result-store.js";
|
|
8
|
+
import { mintCompletionId, commitCompletionIdIfEmpty, clipTaskOutput, assertOwnership, sleepPollStep, alreadyTerminalStopNote, canAccess, normalizeAgentName, engineAgentName, chosenAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, } from "./task-registry-shared.js";
|
|
10
9
|
import { thrownLabel } from "./thrown-value.js";
|
|
10
|
+
import { closestName } from "./closest-name.js";
|
|
11
11
|
import { agentStateSourceOfHandle, agentStateSummary, readAgentState } from "./agent-state.js";
|
|
12
12
|
export function activeDelegationHandlesLane(core, scope, rootSessionId) {
|
|
13
|
+
return activeDelegationOccupantsLane(core, scope, rootSessionId).map((o) => o.id);
|
|
14
|
+
}
|
|
15
|
+
export function activeDelegationOccupantsLane(core, scope, rootSessionId, caller) {
|
|
13
16
|
const out = [];
|
|
14
17
|
for (const h of core.handles.values()) {
|
|
15
18
|
if (h.type !== "background_agent")
|
|
@@ -22,7 +25,7 @@ export function activeDelegationHandlesLane(core, scope, rootSessionId) {
|
|
|
22
25
|
const root = bh.rootSessionId ?? bh.parentSessionId ?? (bh.sessionScoped ? bh.owner : undefined);
|
|
23
26
|
if (root !== rootSessionId)
|
|
24
27
|
continue;
|
|
25
|
-
out.push(h.id);
|
|
28
|
+
out.push({ id: h.id, name: bh.name, reachable: caller !== undefined && canAccess(h, { ...caller, scope }) });
|
|
26
29
|
}
|
|
27
30
|
return out;
|
|
28
31
|
}
|
|
@@ -183,24 +186,24 @@ export function endDurableClaimLane(core, id) {
|
|
|
183
186
|
core.claimingHandles.delete(id);
|
|
184
187
|
}
|
|
185
188
|
export async function reapDurableAgentsLane(core, scope, deps, policy) {
|
|
186
|
-
|
|
187
|
-
const now =
|
|
188
|
-
if (
|
|
189
|
-
await deps.store.reap(scope, now, { staleRunningMaxAgeMs:
|
|
189
|
+
const knobs = receiveRetentionPolicy("reapDurableAgents", policy, BACKGROUND_AGENT_REAP_KNOBS, ["now"]);
|
|
190
|
+
const now = knobs.now ?? Date.now();
|
|
191
|
+
if (knobs.staleRunningMaxAgeMs !== undefined) {
|
|
192
|
+
await deps.store.reap(scope, now, { staleRunningMaxAgeMs: knobs.staleRunningMaxAgeMs });
|
|
190
193
|
}
|
|
191
|
-
if (
|
|
194
|
+
if (knobs.maxAgeMs === undefined && knobs.keep === undefined)
|
|
192
195
|
return { rowsReaped: 0, sessionsReleased: 0, skippedNoSessions: 0, orphanPlacedReleased: 0 };
|
|
193
196
|
const terminal = (await deps.store.listByScope(scope)).filter((r) => r.status !== "running" && r.status !== "parked");
|
|
194
197
|
terminal.sort((a, b) => b.spawnedAt - a.spawnedAt);
|
|
195
198
|
const doomed = new Map();
|
|
196
|
-
if (
|
|
199
|
+
if (knobs.maxAgeMs !== undefined) {
|
|
197
200
|
for (const r of terminal) {
|
|
198
|
-
if ((r.settledAt ?? r.spawnedAt) < now -
|
|
201
|
+
if ((r.settledAt ?? r.spawnedAt) < now - knobs.maxAgeMs)
|
|
199
202
|
doomed.set(r.handle, r);
|
|
200
203
|
}
|
|
201
204
|
}
|
|
202
|
-
if (
|
|
203
|
-
for (const r of terminal.slice(Math.max(0,
|
|
205
|
+
if (knobs.keep !== undefined) {
|
|
206
|
+
for (const r of terminal.slice(Math.max(0, knobs.keep)))
|
|
204
207
|
doomed.set(r.handle, r);
|
|
205
208
|
}
|
|
206
209
|
let rowsReaped = 0;
|
|
@@ -265,10 +268,10 @@ export async function reapDurableAgentsLane(core, scope, deps, policy) {
|
|
|
265
268
|
}
|
|
266
269
|
}
|
|
267
270
|
let orphanPlacedReleased = 0;
|
|
268
|
-
if (
|
|
271
|
+
if (knobs.maxAgeMs !== undefined && deps.sessions !== undefined && typeof deps.sessions.listPlaced === "function") {
|
|
269
272
|
let placed = [];
|
|
270
273
|
try {
|
|
271
|
-
placed = await deps.sessions.listPlaced("subagent", { olderThanMs:
|
|
274
|
+
placed = await deps.sessions.listPlaced("subagent", { olderThanMs: knobs.maxAgeMs, scope });
|
|
272
275
|
}
|
|
273
276
|
catch {
|
|
274
277
|
placed = [];
|
|
@@ -312,29 +315,33 @@ export async function reapDurableAgentsLane(core, scope, deps, policy) {
|
|
|
312
315
|
return { rowsReaped, sessionsReleased, skippedNoSessions, orphanPlacedReleased };
|
|
313
316
|
}
|
|
314
317
|
export function childSessionAnchorOf(handle) {
|
|
315
|
-
|
|
318
|
+
if (handle.type !== "background_agent" || handle.sessionId === undefined)
|
|
319
|
+
return undefined;
|
|
320
|
+
return { sessionId: handle.sessionId, store: handle.sessionStore };
|
|
316
321
|
}
|
|
317
322
|
export function releaseDurableTranscriptAnchorLane(core, id, sessionId) {
|
|
318
323
|
const handle = core.handles.get(id);
|
|
319
324
|
if (!handle || handle.type !== "background_agent")
|
|
320
325
|
return;
|
|
321
|
-
if (childSessionAnchorOf(handle) !== sessionId)
|
|
326
|
+
if (childSessionAnchorOf(handle)?.sessionId !== sessionId)
|
|
322
327
|
return;
|
|
323
328
|
delete handle.sessionId;
|
|
329
|
+
delete handle.sessionStore;
|
|
324
330
|
durableAgentWriteLane(handle, {}, ["sessionId"]);
|
|
325
331
|
}
|
|
326
|
-
export function bindBackgroundAgentSessionLane(core, id, sessionId) {
|
|
332
|
+
export function bindBackgroundAgentSessionLane(core, id, sessionId, store) {
|
|
327
333
|
if (typeof sessionId !== "string" || sessionId === "")
|
|
328
334
|
throw new Error(`TaskRegistry: a background-agent session anchor must be a non-empty session id (got ${typeof sessionId === "string" ? "an empty string" : `a ${sessionId === null ? "null" : typeof sessionId}`})`);
|
|
329
335
|
const handle = core.handles.get(id);
|
|
330
336
|
if (!handle || handle.type !== "background_agent")
|
|
331
337
|
return;
|
|
332
|
-
const anchored = childSessionAnchorOf(handle);
|
|
338
|
+
const anchored = childSessionAnchorOf(handle)?.sessionId;
|
|
333
339
|
if (anchored === sessionId)
|
|
334
340
|
return;
|
|
335
341
|
if (anchored !== undefined)
|
|
336
342
|
throw new Error(`TaskRegistry: background-agent row ${id} is anchored to a session already — release that anchor before binding another (the row keeps its anchor)`);
|
|
337
343
|
handle.sessionId = sessionId;
|
|
344
|
+
handle.sessionStore = store;
|
|
338
345
|
durableAgentWriteLane(handle, { sessionId });
|
|
339
346
|
}
|
|
340
347
|
export function recordBackgroundAgentOrgAdmissionLane(core, id, verdict) {
|
|
@@ -1107,8 +1114,6 @@ export async function reviveBackgroundAgentLane(core, id, access, abort) {
|
|
|
1107
1114
|
handle.abort = abort;
|
|
1108
1115
|
handle.result = undefined;
|
|
1109
1116
|
handle.resultFull = undefined;
|
|
1110
|
-
handle.spillRef = undefined;
|
|
1111
|
-
handle.spillFailed = undefined;
|
|
1112
1117
|
handle.artifactRef = undefined;
|
|
1113
1118
|
handle.error = undefined;
|
|
1114
1119
|
handle.errorCode = undefined;
|
|
@@ -1261,6 +1266,9 @@ export async function deliverToRunningAgentLane(core, id, access, notification,
|
|
|
1261
1266
|
if (d === "parked" || d === "parked_durably") {
|
|
1262
1267
|
result = handle.retainedContinuation === true ? { ok: true, disposition: "parked" } : { ok: false, reason: "not_running" };
|
|
1263
1268
|
}
|
|
1269
|
+
else if (d === "refused") {
|
|
1270
|
+
result = { ok: false, reason: "refused" };
|
|
1271
|
+
}
|
|
1264
1272
|
else {
|
|
1265
1273
|
result = { ok: true, disposition: "queued" };
|
|
1266
1274
|
}
|
|
@@ -1323,7 +1331,7 @@ export function serveDurableAgentRowLane(row, agentState) {
|
|
|
1323
1331
|
const stateLine = agentState !== undefined ? `state: ${agentStateSummary(agentState)}\n` : "";
|
|
1324
1332
|
if (row.status === "parked") {
|
|
1325
1333
|
return {
|
|
1326
|
-
content: delimitUntrusted(`
|
|
1334
|
+
content: delimitUntrusted(`task ${row.handle}`, `status: parked
|
|
1327
1335
|
${stateLine}The agent is durably suspended, waiting for an approval decision. It resumes when the pending approval is decided (durable approval inbox), or lands failed if the approval expires.`),
|
|
1328
1336
|
details: buildAgentPollDetails({
|
|
1329
1337
|
taskId: row.handle,
|
|
@@ -1342,7 +1350,7 @@ ${stateLine}${row.error ? `error: ${row.error}${kindClause}
|
|
|
1342
1350
|
` : ""}${row.finalOutput ? `--- result${row.resultIsPartial ? " (partial — produced before the task was stopped)" : ""} ---
|
|
1343
1351
|
${clipTaskOutput(row.finalOutputFull ?? row.finalOutput)}` : "(no result text)"}`;
|
|
1344
1352
|
return {
|
|
1345
|
-
content: delimitUntrusted(`
|
|
1353
|
+
content: delimitUntrusted(`task ${row.handle}`, body),
|
|
1346
1354
|
details: buildAgentPollDetails({
|
|
1347
1355
|
taskId: row.handle,
|
|
1348
1356
|
status: row.status,
|
|
@@ -1360,35 +1368,7 @@ ${clipTaskOutput(row.finalOutputFull ?? row.finalOutput)}` : "(no result text)"}
|
|
|
1360
1368
|
...(row.status === "failed" ? { isError: true } : {}),
|
|
1361
1369
|
};
|
|
1362
1370
|
}
|
|
1363
|
-
|
|
1364
|
-
export async function spillClippedAgentResult(handle, full, clipped, store, sessionId) {
|
|
1365
|
-
if (clipped === full)
|
|
1366
|
-
return clipped;
|
|
1367
|
-
if (store === undefined)
|
|
1368
|
-
return clipped;
|
|
1369
|
-
const disclose = (ref) => `${clipped}\n\n[full output persisted — call ${OFFLOAD_TOOL_NAME} with ref "${ref}" to read it back.]`;
|
|
1370
|
-
if (handle.spillRef !== undefined)
|
|
1371
|
-
return disclose(handle.spillRef);
|
|
1372
|
-
if (handle.spillFailed === true)
|
|
1373
|
-
return `${clipped}${AGENT_SPILL_FAILED_NOTE}`;
|
|
1374
|
-
const mintCycle = handle.reviveCycle ?? 0;
|
|
1375
|
-
const ref = buildToolResultRef(sessionId ?? "no-session", handle.id, `c${mintCycle}`);
|
|
1376
|
-
try {
|
|
1377
|
-
await store.put(ref, full, sessionId === undefined ? undefined : toolResultProvenanceOf(sessionId));
|
|
1378
|
-
}
|
|
1379
|
-
catch {
|
|
1380
|
-
if ((handle.reviveCycle ?? 0) === mintCycle) {
|
|
1381
|
-
if (handle.spillRef !== undefined)
|
|
1382
|
-
return disclose(handle.spillRef);
|
|
1383
|
-
handle.spillFailed = true;
|
|
1384
|
-
}
|
|
1385
|
-
return `${clipped}${AGENT_SPILL_FAILED_NOTE}`;
|
|
1386
|
-
}
|
|
1387
|
-
if ((handle.reviveCycle ?? 0) === mintCycle)
|
|
1388
|
-
handle.spillRef = ref;
|
|
1389
|
-
return disclose(ref);
|
|
1390
|
-
}
|
|
1391
|
-
export async function pollBackgroundAgentLane(handle, deadline, signal, store, sessionId, checkpointSeat) {
|
|
1371
|
+
export async function pollBackgroundAgentLane(handle, deadline, signal, checkpointSeat) {
|
|
1392
1372
|
while (handle.status === "running" && deadline !== undefined && Date.now() < deadline && !signal?.aborted) {
|
|
1393
1373
|
await sleepPollStep(deadline, signal);
|
|
1394
1374
|
}
|
|
@@ -1399,7 +1379,7 @@ export async function pollBackgroundAgentLane(handle, deadline, signal, store, s
|
|
|
1399
1379
|
const parkedSeq = handle.cycleSeq;
|
|
1400
1380
|
const agentState = await readAgentState(parkedSource, checkpointSeat, Date.now());
|
|
1401
1381
|
return {
|
|
1402
|
-
content: delimitUntrusted(`
|
|
1382
|
+
content: delimitUntrusted(`task ${handle.id}`, `status: parked
|
|
1403
1383
|
state: ${agentStateSummary(agentState)}
|
|
1404
1384
|
The agent is durably suspended, waiting for an approval decision. It resumes when the pending approval is decided (durable approval inbox), or lands failed if the approval expires.`),
|
|
1405
1385
|
details: buildAgentPollDetails({
|
|
@@ -1428,7 +1408,7 @@ The agent is durably suspended, waiting for an approval decision. It resumes whe
|
|
|
1428
1408
|
const stateRead = readAgentState(agentStateSourceOfHandle({ status: snap.status, updatedAt: snap.updatedAt }), checkpointSeat, Date.now());
|
|
1429
1409
|
const agentState = stateRead instanceof Promise ? await stateRead : stateRead;
|
|
1430
1410
|
const fullResult = snap.result ? (handle.resultFull ?? snap.result) : undefined;
|
|
1431
|
-
const resultText = fullResult !== undefined ?
|
|
1411
|
+
const resultText = fullResult !== undefined ? clipTaskOutput(fullResult, handle.outputFile) : undefined;
|
|
1432
1412
|
const kindClause = snap.status === "failed" && snap.errorKind !== undefined && snap.errorRetryable !== undefined
|
|
1433
1413
|
? ` (error_kind: ${snap.errorKind}, retryable: ${snap.errorRetryable}${snap.errorRetryAfterMs !== undefined ? `, retry_after_ms: ${snap.errorRetryAfterMs}` : ""})`
|
|
1434
1414
|
: "";
|
|
@@ -1441,7 +1421,7 @@ ${stateLine}${snap.error ? `error: ${snap.error}${kindClause}
|
|
|
1441
1421
|
` : ""}${snap.result ? `--- result${snap.resultIsPartial ? " (partial — produced before the task was stopped)" : ""} ---
|
|
1442
1422
|
${resultText}` : "(no result text)"}`;
|
|
1443
1423
|
return {
|
|
1444
|
-
content: delimitUntrusted(`
|
|
1424
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
1445
1425
|
details: buildAgentPollDetails({
|
|
1446
1426
|
taskId: handle.id,
|
|
1447
1427
|
status: snap.status,
|
|
@@ -26,7 +26,7 @@ export declare function emitMonitorEventLane(handle: MonitorTaskHandle, n: TaskN
|
|
|
26
26
|
* plus the three monitor-only exits: watcher-enforced timeout, event-storm auto-stop, and the
|
|
27
27
|
* line→batched-event emission path. All time reads go through the INJECTED clock (design/87). */
|
|
28
28
|
export declare function startMonitorWatcherLane(core: RegistryCore, id: string): void;
|
|
29
|
-
/** design/135 G2:
|
|
29
|
+
/** design/135 G2: the host poll over a monitor — a RE-READABLE spool snapshot (the watcher owns the env
|
|
30
30
|
* cursor, exactly the bash G2b spool posture): repeated polls return the same accumulated output. */
|
|
31
31
|
export declare function pollMonitorLane(handle: MonitorTaskHandle, filter: string | undefined, deadline?: number, signal?: AbortSignal): Promise<UnifiedTaskResult>;
|
|
32
32
|
export declare function stopMonitorLane(core: RegistryCore, handle: MonitorTaskHandle): Promise<UnifiedTaskResult>;
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { delimitUntrusted } from "./untrusted-text.js";
|
|
2
2
|
import { envDeclaresRetain, retainsBackgroundProcesses } from "./background-shell.js";
|
|
3
|
-
import { assertOwnership, defaultMonitorTimers, MONITOR_MAX_TIMEOUT_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_BATCH_WINDOW_MS, MONITOR_MAX_BATCHES_PER_MINUTE, MONITOR_STORM_BURST, MONITOR_STORM_KILL_AFTER_MS, MONITOR_LINE_BUF_CAP,
|
|
4
|
-
import { buildToolResultRef, OFFLOAD_TOOL_NAME, toolResultProvenanceOf } from "./tool-result-store.js";
|
|
3
|
+
import { assertOwnership, defaultMonitorTimers, MONITOR_MAX_TIMEOUT_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_BATCH_WINDOW_MS, MONITOR_MAX_BATCHES_PER_MINUTE, MONITOR_STORM_BURST, MONITOR_STORM_KILL_AFTER_MS, MONITOR_LINE_BUF_CAP, TASK_OUTPUT_MAX_CHARS, mintCompletionId, clipMonitorEvent, clipMonitorLine, terminalTaskSummary, accountDroppedBytes, renderSpoolBody, SPOOL_REPLAY, rollSpoolText, statusFromBackground, droppedGapNote, firstDropNote, alreadyTerminalStopNote, clipTaskOutput, sleepPollStep, } from "./task-registry-shared.js";
|
|
5
4
|
import { thrownText } from "./thrown-value.js";
|
|
6
5
|
export function registerMonitorLane(core, input) {
|
|
7
6
|
assertOwnership(input, "registerMonitor");
|
|
@@ -42,8 +41,6 @@ export function registerMonitorLane(core, input) {
|
|
|
42
41
|
...(timeoutMs !== undefined ? { timeoutMs, deadlineAt: timers.now() + timeoutMs } : {}),
|
|
43
42
|
timers,
|
|
44
43
|
...(input.onEvent !== undefined ? { onEvent: input.onEvent } : {}),
|
|
45
|
-
...(input.toolResultStore !== undefined ? { toolResultStore: input.toolResultStore } : {}),
|
|
46
|
-
...(input.sessionId !== undefined ? { spillSessionId: input.sessionId } : {}),
|
|
47
44
|
...(retainsBackgroundProcesses({ env: envDeclaresRetain(input.env), task: input.retainBackgroundProcesses === true }) ? { retained: true } : {}),
|
|
48
45
|
...(input.retainBackgroundProcesses !== undefined ? { retainStatedAtLaunch: true } : {}),
|
|
49
46
|
};
|
|
@@ -57,60 +54,12 @@ export function registerMonitorLane(core, input) {
|
|
|
57
54
|
}
|
|
58
55
|
return id;
|
|
59
56
|
}
|
|
60
|
-
function spillRolledMonitorChunk(handle, stream, dropped) {
|
|
61
|
-
const store = handle.toolResultStore;
|
|
62
|
-
if (store === undefined)
|
|
63
|
-
return;
|
|
64
|
-
const used = handle.spillCharsUsed ?? 0;
|
|
65
|
-
if (used >= MONITOR_SPILL_CAP_CHARS) {
|
|
66
|
-
handle.spillCapped = true;
|
|
67
|
-
return;
|
|
68
|
-
}
|
|
69
|
-
const n = stream === "out" ? (handle.spillSegCount ?? 0) : (handle.spillErrSegCount ?? 0);
|
|
70
|
-
const ref = buildToolResultRef(handle.spillSessionId ?? "no-session", handle.id, `${stream}_seg${n}`);
|
|
71
|
-
handle.spillCharsUsed = used + dropped.length;
|
|
72
|
-
if (stream === "out")
|
|
73
|
-
handle.spillSegCount = n + 1;
|
|
74
|
-
else
|
|
75
|
-
handle.spillErrSegCount = n + 1;
|
|
76
|
-
try {
|
|
77
|
-
const provenance = handle.spillSessionId === undefined ? undefined : toolResultProvenanceOf(handle.spillSessionId);
|
|
78
|
-
void Promise.resolve(store.put(ref, dropped, provenance)).catch(() => {
|
|
79
|
-
handle.spillFailed = true;
|
|
80
|
-
});
|
|
81
|
-
}
|
|
82
|
-
catch {
|
|
83
|
-
handle.spillFailed = true;
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
function monitorSpillNote(handle) {
|
|
87
|
-
const outN = handle.spillSegCount ?? 0;
|
|
88
|
-
const errN = handle.spillErrSegCount ?? 0;
|
|
89
|
-
if (outN === 0 && errN === 0)
|
|
90
|
-
return "";
|
|
91
|
-
const sid = handle.spillSessionId ?? "no-session";
|
|
92
|
-
const segLabel = (stream, n) => {
|
|
93
|
-
const first = buildToolResultRef(sid, handle.id, `${stream}_seg0`);
|
|
94
|
-
return n <= 1 ? `ref "${first}"` : `refs "${first}" .. "${buildToolResultRef(sid, handle.id, `${stream}_seg${n - 1}`)}"`;
|
|
95
|
-
};
|
|
96
|
-
const clauses = [];
|
|
97
|
-
if (outN > 0)
|
|
98
|
-
clauses.push(`stdout ${segLabel("out", outN)}`);
|
|
99
|
-
if (errN > 0)
|
|
100
|
-
clauses.push(`stderr ${segLabel("err", errN)}`);
|
|
101
|
-
const coverage = handle.spillFailed === true
|
|
102
|
-
? " — a write failed partway through; the ref chain may be INCOMPLETE, read what is there"
|
|
103
|
-
: handle.spillCapped === true
|
|
104
|
-
? ` — spill cap (${MONITOR_SPILL_CAP_CHARS} chars) reached; earlier segments retained, later rolls were not spilled`
|
|
105
|
-
: "";
|
|
106
|
-
return `; spilled to ${clauses.join(", ")} (read back via ${OFFLOAD_TOOL_NAME})${coverage}`;
|
|
107
|
-
}
|
|
108
57
|
export function absorbMonitorPollLane(handle, v) {
|
|
109
58
|
const spool = handle.spool;
|
|
110
59
|
accountDroppedBytes(spool, v);
|
|
111
60
|
const ROLL_CAP = 2 * TASK_OUTPUT_MAX_CHARS;
|
|
112
|
-
spool.stdout = rollSpoolText(spool, spool.stdout + v.stdout, ROLL_CAP
|
|
113
|
-
spool.stderr = rollSpoolText(spool, spool.stderr + v.stderr, ROLL_CAP
|
|
61
|
+
spool.stdout = rollSpoolText(spool, spool.stdout + v.stdout, ROLL_CAP);
|
|
62
|
+
spool.stderr = rollSpoolText(spool, spool.stderr + v.stderr, ROLL_CAP);
|
|
114
63
|
handle.lineBuf += v.stdout;
|
|
115
64
|
if (handle.lineBuf.length > MONITOR_LINE_BUF_CAP)
|
|
116
65
|
handle.lineBuf = handle.lineBuf.slice(-MONITOR_LINE_BUF_CAP);
|
|
@@ -275,7 +224,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
275
224
|
handle.status = "killed";
|
|
276
225
|
handle.stoppedBy = handle.stopSource ?? "system";
|
|
277
226
|
return terminal("killed", `auto-stopped: too much output (${suppressed} event batch(es) suppressed over ${overloadSecs}s of sustained overload; sustained budget is ${handle.maxBatchesPerMinute} batches/minute). ` +
|
|
278
|
-
`The process was killed; its full output
|
|
227
|
+
`The process was killed; ${monitorOutputReading(handle, "its full output")}. Restart it with a quieter command (filter its output) if you still need the watch.`, pendingFinalLines(lines));
|
|
279
228
|
}
|
|
280
229
|
if ((handle.suppressedBatches ?? 0) > 0) {
|
|
281
230
|
const suppressed = handle.suppressedBatches;
|
|
@@ -290,7 +239,7 @@ export function startMonitorWatcherLane(core, id) {
|
|
|
290
239
|
...(handle.toolUseId !== undefined ? { toolUseId: handle.toolUseId } : {}),
|
|
291
240
|
status: "event",
|
|
292
241
|
seq: handle.seq,
|
|
293
|
-
summary: `${(handle.description ?? "monitor").slice(0, 200)} — ${suppressed} event batch(es) suppressed (output rate too high); the suppressed output
|
|
242
|
+
summary: `${(handle.description ?? "monitor").slice(0, 200)} — ${suppressed} event batch(es) suppressed (output rate too high); ${monitorOutputReading(handle, "the suppressed output")}`,
|
|
294
243
|
result: note,
|
|
295
244
|
});
|
|
296
245
|
}
|
|
@@ -331,7 +280,7 @@ export async function pollMonitorLane(handle, filter, deadline, signal) {
|
|
|
331
280
|
}
|
|
332
281
|
catch {
|
|
333
282
|
return {
|
|
334
|
-
content: `Error (
|
|
283
|
+
content: `Error (task poll): invalid filter regex: ${filter}`,
|
|
335
284
|
details: { task_id: handle.id, type: "monitor", status: handle.status, retrieval_status: "not_ready" },
|
|
336
285
|
isError: true,
|
|
337
286
|
};
|
|
@@ -348,11 +297,10 @@ export async function pollMonitorLane(handle, filter, deadline, signal) {
|
|
|
348
297
|
running,
|
|
349
298
|
handleStatus: handle.status,
|
|
350
299
|
shape,
|
|
351
|
-
rolledExtraClause: monitorSpillNote(handle),
|
|
352
300
|
drainNote: spool.drainFailed === true ? "[!] the final output drain at stop failed — the tail of the output may be missing\n" : "",
|
|
353
301
|
});
|
|
354
302
|
return {
|
|
355
|
-
content: delimitUntrusted(`
|
|
303
|
+
content: delimitUntrusted(`task ${handle.id}`, body),
|
|
356
304
|
details: {
|
|
357
305
|
task_id: handle.id,
|
|
358
306
|
type: "monitor",
|
|
@@ -375,7 +323,14 @@ function consumePendingSuppressionNote(handle) {
|
|
|
375
323
|
if (suppressed <= 0)
|
|
376
324
|
return "";
|
|
377
325
|
handle.suppressedBatches = 0;
|
|
378
|
-
return ` [${suppressed} event batch(es) suppressed before the watch ended — output rate was too high; the suppressed output
|
|
326
|
+
return ` [${suppressed} event batch(es) suppressed before the watch ended — output rate was too high; ${monitorOutputReading(handle, "the suppressed output")}.]`;
|
|
327
|
+
}
|
|
328
|
+
function monitorOutputReading(handle, what) {
|
|
329
|
+
if (handle.outputFile === undefined)
|
|
330
|
+
return `${what} was not kept (no output file could be created for this watch)`;
|
|
331
|
+
return handle.spool.mirrorFailed === true
|
|
332
|
+
? `${what} is only partly in its output file (${handle.outputFile} — an append failed, so it is not the whole output)`
|
|
333
|
+
: `${what} is in its output file (${handle.outputFile} — Read it)`;
|
|
379
334
|
}
|
|
380
335
|
function explicitStopTerminalNote(handle, alreadyGone) {
|
|
381
336
|
const label = (handle.description ?? "monitor").slice(0, 200);
|
|
@@ -4,7 +4,7 @@ import { type WorkflowRunStore } from "./workflow-run-store.js";
|
|
|
4
4
|
import type { BackgroundAgentRecord, BackgroundAgentStore } from "./background-agent-store.js";
|
|
5
5
|
import type { WorkflowHandle, WorkflowRun } from "../orchestration/workflow.js";
|
|
6
6
|
import type { TaskNotificationPayload } from "./task-notification.js";
|
|
7
|
-
import type { TaskArtifactSeat
|
|
7
|
+
import type { TaskArtifactSeat } from "./tool-result-store.js";
|
|
8
8
|
import type { AssertAllKeysHandled } from "./ask-origin.js";
|
|
9
9
|
export type SemaTaskType = "background_bash" | "workflow" | "background_agent" | "monitor";
|
|
10
10
|
/** design/134 §3.3 (R3): WHO initiated a kill — recorded at the initiation site (first-marker-wins),
|
|
@@ -86,8 +86,8 @@ export interface UnifiedTaskOutput {
|
|
|
86
86
|
* per-task-kind poll/stop arm). `UnifiedTaskOutput` (the `details` face) has no isError channel of its
|
|
87
87
|
* own — it is a REQUIRED-field wire shape consumed by callers beyond these two tools too, so isError is
|
|
88
88
|
* carried as a sibling on the WRAPPER instead (trap avoidance per the E1 sweep: never carry across isError
|
|
89
|
-
* through a narrower helper contract). Optional, absent/false = success — `
|
|
90
|
-
*
|
|
89
|
+
* through a narrower helper contract). Optional, absent/false = success — `createTaskStopTool` forwards it onto
|
|
90
|
+
* the real `ToolReturn` at the tool boundary. Every internal helper
|
|
91
91
|
* keeps constructing `content`/`details` exactly as before; this only adds a place to say "and this one
|
|
92
92
|
* is a genuine failure" where the failure is actually detected.
|
|
93
93
|
*/
|
|
@@ -152,7 +152,7 @@ export interface BackgroundBashTaskHandle extends SemaTaskHandle {
|
|
|
152
152
|
* (`TaskSpec.retainBackgroundProcesses`) or the env capability declares retain, and by a run teardown
|
|
153
153
|
* whose own spec declares it. In-memory only (shell-lane rows are never persisted); a row without the
|
|
154
154
|
* field reads as not marked. The row is the delivered daemon's ONLY management surface — while the process runs it survives the
|
|
155
|
-
* per-run evict (
|
|
155
|
+
* per-run evict (TaskStop and the host poll resolve through this map; the watcher must stay live to mint
|
|
156
156
|
* the natural-exit receipt) and rides every later run's dispose except-list on the same env
|
|
157
157
|
* ({@link TaskRegistry.runningShellIds}). A terminal row evicts normally. Terminals: explicit
|
|
158
158
|
* TaskStop, the process's own exit (watcher settle), or env destruction (watcher env-death settle)
|
|
@@ -166,7 +166,7 @@ export interface BackgroundBashTaskHandle extends SemaTaskHandle {
|
|
|
166
166
|
* launcher did not know the lane (a host tool registering directly): the owning run's teardown supplies it. */
|
|
167
167
|
retainStatedAtLaunch?: true;
|
|
168
168
|
/** design/116 §7 G2b: when a watcher is attached, the registry accumulates the FULL output here (rolling
|
|
169
|
-
* bound) —
|
|
169
|
+
* bound) — the host poll then serves a RE-READABLE snapshot (CC semantics) instead of a consume-once cursor.
|
|
170
170
|
* `timedOut`/`timeoutSec` record a SELF-INFLICTED background-timeout kill (the env's per-shell budget
|
|
171
171
|
* fired), so later re-readable polls keep rendering it distinguishably from an external stop.
|
|
172
172
|
* `mirrorFailed` records that at least one append to the advertised output FILE failed — the terminal
|
|
@@ -225,8 +225,6 @@ export interface WorkflowTaskHandle extends SemaTaskHandle {
|
|
|
225
225
|
* session end — a would-be regression caught by cross-review before this shipped (see docs/
|
|
226
226
|
* REVIEW-BACKLOG.md's "RB-215 复核" entry for the full incident). */
|
|
227
227
|
sessionScoped?: true;
|
|
228
|
-
/** See {@link RegisterWorkflowInput.onServedTerminal}. Cleared after the single fire. */
|
|
229
|
-
onServedTerminal?: () => void;
|
|
230
228
|
/** The bounded return value, captured on the done-hook so the STORE-LESS in-memory lane's
|
|
231
229
|
* terminal poll can hand it over too (the launch note promises it; without a store there was no result). */
|
|
232
230
|
result?: string;
|
|
@@ -257,6 +255,9 @@ export interface DurableAgentLane {
|
|
|
257
255
|
* flush success); past the ceiling the lane is abandoned loudly instead of retrying forever. */
|
|
258
256
|
redrives?: number;
|
|
259
257
|
}
|
|
258
|
+
/** What a background agent's row keeps of the store its child session lives in: that store's `acquire` (structural, so any
|
|
259
|
+
* session store fits — the type-only import is erased, the one-way import rule at the top is untouched). */
|
|
260
|
+
export type ChildSessionStore = Pick<import("./session.js").SessionStore, "acquire">;
|
|
260
261
|
export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
261
262
|
type: "background_agent";
|
|
262
263
|
/** The spawning tree's cross-boundary token ({@link RegisterBackgroundAgentInput.crossBoundaryTree}), compared by identity. */
|
|
@@ -275,6 +276,10 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
275
276
|
* durable record's copy — by the successful release of that session
|
|
276
277
|
* ({@link TaskRegistry.releaseDurableTranscriptAnchor}). Read through `childSessionAnchorOf` only. */
|
|
277
278
|
sessionId?: string;
|
|
279
|
+
/** The store the child's run holds that session through, written by the same bind and removed by the same release as
|
|
280
|
+
* `sessionId` — a reader of the child's transcript travels with its row, never with the runner that happens to read it.
|
|
281
|
+
* Process-local: the durable record keeps the id alone, and a revival's own bind brings its own runner's store. */
|
|
282
|
+
sessionStore?: ChildSessionStore;
|
|
278
283
|
/** design/151 S1a — the durable write lane (present iff the registration wired a store). */
|
|
279
284
|
durable?: DurableAgentLane;
|
|
280
285
|
/** design/147 S2a — the RUNNING child run's notification injector (attached once its lane is
|
|
@@ -344,7 +349,7 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
344
349
|
* skips it; `reapSessionBackground` is its terminal anchor. Explicit flag, never inferred from key values
|
|
345
350
|
* (hostTaskId===sessionId deployments would otherwise be ambiguous). */
|
|
346
351
|
sessionScoped?: true;
|
|
347
|
-
/** Terminal snapshot (bounded, {@link BG_AGENT_RESULT_MAX} in subagent.ts) — served by
|
|
352
|
+
/** Terminal snapshot (bounded, {@link BG_AGENT_RESULT_MAX} in subagent.ts) — served by the host poll
|
|
348
353
|
* once the child finishes. */
|
|
349
354
|
result?: string;
|
|
350
355
|
/** The FULL result (bounded only by the defensive {@link BG_AGENT_RESULT_FULL_MAX} ceiling
|
|
@@ -353,26 +358,6 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
|
|
|
353
358
|
* ~2-4K chars with no disclosure — clipTaskOutput's own file-pointer/offload-friendly design at the
|
|
354
359
|
* poll layer was structurally unreachable because `result` itself could never be long enough to need it. */
|
|
355
360
|
resultFull?: string;
|
|
356
|
-
/** design/158 S1 (RB-205-B 半) — the tool-result-store ref `resultFull`'s full text was spilled to,
|
|
357
|
-
* the FIRST time a poll's `clipTaskOutput` actually cut it (lazy write, not at settle time). Cached
|
|
358
|
-
* here so every LATER poll within the SAME cycle reuses the same ref instead of re-writing (the
|
|
359
|
-
* store's own `put` is write-once too, but re-deriving/re-calling it every poll would still cost a
|
|
360
|
-
* redundant round-trip on a durable backend, and a changing ref across polls would be a needless
|
|
361
|
-
* disclosure churn). {@link reviveBackgroundAgentLane} clears this on revive — the cycle's full text
|
|
362
|
-
* is gone, so a stale ref must not be reused across cycles. Ref format ties in `reviveCycle` (see
|
|
363
|
-
* {@link import("./task-registry-agent.js").spillClippedAgentResult}) precisely so a revived cycle's
|
|
364
|
-
* eventual spill lands under a DIFFERENT ref rather than colliding with (and being silently refused
|
|
365
|
-
* by the write-once store under) cycle 1's. */
|
|
366
|
-
spillRef?: string;
|
|
367
|
-
/** Backlog #169 — the spill `put` for the CURRENT revive cycle threw or rejected. One-time latch,
|
|
368
|
-
* scoped to the cycle ({@link import("./task-registry-agent.js").reviveBackgroundAgentLane} clears
|
|
369
|
-
* it in lockstep with `spillRef`): later polls serve the clipped text with an honest ref-free loss
|
|
370
|
-
* note instead of retrying the write — the ref is minted deterministically, so the known permanent
|
|
371
|
-
* failure class (the store's write-once/provenance conflict) would fail identically on every poll,
|
|
372
|
-
* each retry a guaranteed-failure round trip to a durable backend. The monitor lane's
|
|
373
|
-
* `spillFailed` twin (same degrade discipline, different write shape — that one is fire-and-forget,
|
|
374
|
-
* this one is awaited). */
|
|
375
|
-
spillFailed?: true;
|
|
376
361
|
error?: string;
|
|
377
362
|
/** RB-386② — the machine-readable failure code beside `error`, threaded from the settle
|
|
378
363
|
* mint point (subagent.ts computes it ONCE from the child's TaskResult.errorCode taxonomy /
|
|
@@ -429,7 +414,7 @@ export interface MonitorTimers {
|
|
|
429
414
|
}
|
|
430
415
|
export declare const defaultMonitorTimers: MonitorTimers;
|
|
431
416
|
/** design/135 G2: Monitor watch — background_bash's near kin, but the watcher streams stdout LINES as
|
|
432
|
-
* batched event notifications instead of firing one terminal notify. Spool stays re-readable (
|
|
417
|
+
* batched event notifications instead of firing one terminal notify. Spool stays re-readable (host poll) and the output file holds the full record. */
|
|
433
418
|
export interface MonitorTaskHandle extends SemaTaskHandle {
|
|
434
419
|
type: "monitor";
|
|
435
420
|
env: ExecutionEnv & BackgroundShellCapability;
|
|
@@ -510,40 +495,6 @@ export interface MonitorTaskHandle extends SemaTaskHandle {
|
|
|
510
495
|
/** Terminal-notification once-latch — same discipline as the bash handle (fidelity R1-3). Only the
|
|
511
496
|
* TERMINAL frame is latched; "event" frames are unaffected. */
|
|
512
497
|
terminalNotified?: true;
|
|
513
|
-
/** design/158 S2 (RB-364 半) — the offload store a ROLLED-OFF spool middle spills to, captured at
|
|
514
|
-
* REGISTRATION time (RegisterMonitorInput's additive field), not per-poll like the background_agent
|
|
515
|
-
* lane's `TaskPollOptions.toolResultStore` (S1): the roll happens inside the watcher tick — an async
|
|
516
|
-
* timer callback with no per-call "access" to thread a store through — so registration is the only
|
|
517
|
-
* point that has one to hang on the handle. Absent ⇒ legal degrade: `rollSpoolText`'s `onDrop` hook
|
|
518
|
-
* is simply never wired, byte-identical to pre-S2 rolling (design/158 §2.2). */
|
|
519
|
-
toolResultStore?: ToolResultStore;
|
|
520
|
-
/** design/158 S2 — the session id spilled refs are scoped under (same `TaskAccess.sessionId` role as
|
|
521
|
-
* every other `buildToolResultRef` call site); captured at registration for the same reason as
|
|
522
|
-
* `toolResultStore` above. */
|
|
523
|
-
spillSessionId?: string;
|
|
524
|
-
/** design/158 S2 — next segment index to mint for the STDOUT dropped-middle ref chain (0-based;
|
|
525
|
-
* design/158 §3 "方案 a": a ref PER dropped segment, chained by index, rather than one ref with an
|
|
526
|
-
* append primitive — ToolResultStore's contract is write-once with no append). stdout and stderr get
|
|
527
|
-
* INDEPENDENT counters (this field vs `spillErrSegCount`) so each stream's own segments concatenate
|
|
528
|
-
* back in original byte order without interleaving the other stream's drops between them. */
|
|
529
|
-
spillSegCount?: number;
|
|
530
|
-
/** design/158 S2 — the STDERR twin of {@link spillSegCount}. */
|
|
531
|
-
spillErrSegCount?: number;
|
|
532
|
-
/** design/158 S2 — cumulative chars (UTF-16 code units, `string.length`) handed to `store.put`
|
|
533
|
-
* across every segment this handle has spilled so far (both streams combined) — the per-handle
|
|
534
|
-
* disk-cap accounting ({@link import("./task-registry-monitor.js")} reads `MONITOR_SPILL_CAP_CHARS`
|
|
535
|
-
* against this). The field used to be named `spillBytesUsed` while the ledger counted
|
|
536
|
-
* chars — renamed to the axis it really measures (see the constant's own doc for why chars). */
|
|
537
|
-
spillCharsUsed?: number;
|
|
538
|
-
/** design/158 S2 — the per-handle spill cap (`MONITOR_SPILL_CAP_CHARS`) was reached; further
|
|
539
|
-
* rolled-off middles are no longer spilled (already-written segments stay readable — "earlier
|
|
540
|
-
* segments retained"). One-time latch; the poll disclosure reads it to stop claiming full ref
|
|
541
|
-
* coverage. */
|
|
542
|
-
spillCapped?: true;
|
|
543
|
-
/** design/158 S2 — at least one `store.put` for this handle rejected or threw. One-time latch; the
|
|
544
|
-
* poll disclosure downgrades its wording once this is set (never claims the ref chain is complete —
|
|
545
|
-
* the fire-and-forget write may have silently failed; see task-registry-monitor.ts's spill helper). */
|
|
546
|
-
spillFailed?: true;
|
|
547
498
|
}
|
|
548
499
|
export type RegisteredTaskHandle = BackgroundBashTaskHandle | WorkflowTaskHandle | BackgroundAgentTaskHandle | MonitorTaskHandle;
|
|
549
500
|
export interface RegisterMonitorInput extends TaskAccess {
|
|
@@ -574,9 +525,6 @@ export interface RegisterMonitorInput extends TaskAccess {
|
|
|
574
525
|
/** Burst capacity of the storm bucket (default MONITOR_STORM_BURST = CC's 10). */
|
|
575
526
|
stormBurst?: number;
|
|
576
527
|
now?: number;
|
|
577
|
-
/** design/158 S2 (RB-364 半) — the offload store a rolled-off spool middle spills to (see
|
|
578
|
-
* {@link MonitorTaskHandle.toolResultStore}). Absent ⇒ legal degrade, byte-identical rolling. */
|
|
579
|
-
toolResultStore?: ToolResultStore;
|
|
580
528
|
/** The watch's output file (see {@link MonitorTaskHandle.outputFile}); absent when it could not be created. */
|
|
581
529
|
outputFile?: string;
|
|
582
530
|
/** See {@link MonitorTaskHandle.taskArtifacts}. */
|
|
@@ -595,13 +543,6 @@ export interface RegisterWorkflowInput extends TaskAccess {
|
|
|
595
543
|
* (its completion notification routes to the session) — deliberately unlike a background agent's
|
|
596
544
|
* live handle, whose sibling-turn invisibility is a channel-discipline ruling (§3.1c). */
|
|
597
545
|
originatingSessionId?: string;
|
|
598
|
-
/**
|
|
599
|
-
* Fired AT MOST ONCE when a `pollTask` through THIS registry entry (= the originating
|
|
600
|
-
* session's own lane; cross-session store-fallback polls don't fire it) serves a TERMINAL snapshot.
|
|
601
|
-
* The RunWorkflow tool wires it to {@link import("../orchestration/run-workflow-tool.js").WorkflowCompletionNotifier.ackServed}
|
|
602
|
-
* so the deployment can drop the now-redundant completion-inbox entry. Errors are swallowed.
|
|
603
|
-
*/
|
|
604
|
-
onServedTerminal?: () => void;
|
|
605
546
|
}
|
|
606
547
|
/** T2A-7 (2026-07-05 soak): one blocked-poll step, CLAMPED to the caller's deadline — a small timeoutMs
|
|
607
548
|
* (e.g. 10ms) must not sleep the full 400ms step (~40× overshoot, and the overshoot window even served a
|
|
@@ -655,31 +596,11 @@ export declare function clipTaskOutput(s: string, fullOutputPath?: string): stri
|
|
|
655
596
|
export declare function statusFromBackground(status: string, exitCode?: number): SemaTaskStatus;
|
|
656
597
|
/** Rolling middle-drop bound for the bash spool, shared by the watcher's per-tick accumulate and the
|
|
657
598
|
* teardown settle's terminal flush: keep head+tail halves within `cap`, account the dropped middle in
|
|
658
|
-
* `rolledChars` (the honesty counter the poll face reports as permanently-dropped bytes).
|
|
659
|
-
*
|
|
660
|
-
* design/158 S2 (RB-364 半): `onDrop`, when given, is called SYNCHRONOUSLY (before this function
|
|
661
|
-
* returns) with exactly the middle substring being dropped — the ONE place that substring is ever
|
|
662
|
-
* materialized, so a caller wanting to preserve it (the monitor lane's spill-to-offload-store) does not
|
|
663
|
-
* need to re-derive the same slice arithmetic a second time. Every EXISTING caller (the background_bash
|
|
664
|
-
* lane, task-registry.ts) omits the 4th argument, so their behavior — return value AND `rolledChars`
|
|
665
|
-
* accounting — is untouched byte-for-byte; the callback is a pure side-channel hook. */
|
|
599
|
+
* `rolledChars` (the honesty counter the poll face reports as permanently-dropped bytes). The full record of
|
|
600
|
+
* a background command or a watch is its output file; the spool is the bounded copy. */
|
|
666
601
|
export declare function rollSpoolText(spool: {
|
|
667
602
|
rolledChars: number;
|
|
668
|
-
}, s: string, cap: number
|
|
669
|
-
/** design/158 S2 (RB-364 半) — per-monitor-handle hard cap on cumulative CHARS (UTF-16 code units)
|
|
670
|
-
* spilled to the offload store (design/158 §3's S3 half, pulled forward alongside S2). Once a
|
|
671
|
-
* handle's running total reaches this, further rolled-off middles are simply not spilled —
|
|
672
|
-
* already-written segments stay readable (the poll disclosure says "earlier segments retained"),
|
|
673
|
-
* matching the pre-S2 loss shape for whatever is dropped PAST the cap. Exported so the boundary is a
|
|
674
|
-
* testable contract, not a buried literal.
|
|
675
|
-
*
|
|
676
|
-
* The constant used to be named
|
|
677
|
-
* `..._BYTES` while the ledger added `dropped.length` — chars, up to ~3× fewer than UTF-8 bytes on
|
|
678
|
-
* multibyte content. CHARS is the axis kept (name changed, arithmetic untouched) because it is the
|
|
679
|
-
* offload store family's own coordinate (`InMemoryToolResultStore.maxTotalChars` evicts by
|
|
680
|
-
* `content.length`; `ToolResultSlice.totalChars`) and the spool's `rolledChars` axis — one unit
|
|
681
|
-
* end-to-end; a `Buffer.byteLength` ledger here would sit crosswise to the store's own cap. */
|
|
682
|
-
export declare const MONITOR_SPILL_CAP_CHARS: number;
|
|
603
|
+
}, s: string, cap: number): string;
|
|
683
604
|
/** Fold one poll's env-side-loss disclosure into the spool's account. The env's
|
|
684
605
|
* tail buffer evicts its HEAD under pressure (node-execution-env 8MB bound) — those bytes are gone
|
|
685
606
|
* before any watcher ever saw them, which is a different loss than the registry-side `rolledChars`
|
|
@@ -771,11 +692,10 @@ export interface RenderableSpool {
|
|
|
771
692
|
dropUnknown?: true;
|
|
772
693
|
}
|
|
773
694
|
/** The per-lane inputs {@link renderSpoolBody} cannot derive from the spool itself.
|
|
774
|
-
* `
|
|
775
|
-
*
|
|
776
|
-
*
|
|
777
|
-
*
|
|
778
|
-
* place. Both are "" on a lane that has no such disclosure. */
|
|
695
|
+
* `drainNote` is a PRE-RENDERED STRING, deliberately not a boolean or a lane discriminator: the renderer must stay
|
|
696
|
+
* ignorant of which lane called it, otherwise the monitor-only disclosure (RB-239 stop-time drain failure) comes back
|
|
697
|
+
* as an in-renderer branch on a kind switch — the exact shape that let the two hand-copied renderers drift in the
|
|
698
|
+
* first place. "" on a lane that has no such disclosure. */
|
|
779
699
|
export interface SpoolBodyOptions {
|
|
780
700
|
/** The handle is still running (drives the "running" display status). */
|
|
781
701
|
running: boolean;
|
|
@@ -783,12 +703,10 @@ export interface SpoolBodyOptions {
|
|
|
783
703
|
handleStatus: SemaTaskStatus;
|
|
784
704
|
/** The lane's filter+clip projection, applied to stdout and stderr alike. */
|
|
785
705
|
shape: (text: string) => string;
|
|
786
|
-
/** Appended INSIDE the roll note, before its newline ("" when the lane has no extra clause). */
|
|
787
|
-
rolledExtraClause: string;
|
|
788
706
|
/** A full banner line (own trailing newline) rendered after the drop note, or "". */
|
|
789
707
|
drainNote: string;
|
|
790
708
|
}
|
|
791
|
-
/** The ONE renderer for a re-readable spool's
|
|
709
|
+
/** The ONE renderer for a re-readable spool's host-poll body,
|
|
792
710
|
* shared by the monitor lane (pollMonitorLane) and the bash spool lane (pollBackgroundBash).
|
|
793
711
|
*
|
|
794
712
|
* Both faces were hand-copied twins carrying three real disclosure bugs' worth of wording (env-side
|
|
@@ -910,14 +828,6 @@ export declare const BG_AGENT_REAP_STOP_ERROR = "stopped (parent task ended or T
|
|
|
910
828
|
* as this resolver, or an NFKC-equivalent spelling (fullwidth "main") skips the reserved lane and
|
|
911
829
|
* reaches the description layers. One normalizer, every name face. */
|
|
912
830
|
export declare function normalizeAgentName(s: string): string;
|
|
913
|
-
/** CC `gtr` (fable 复审 F1 — 亲核 @16169850: NOT plain Levenshtein but OSA / restricted
|
|
914
|
-
* Damerau-Levenshtein, WITH the adjacent-transposition term `o[i][s]=min(o[i][s], o[i-2][s-2]+1)`
|
|
915
|
-
* when `e[i-1]===t[s-2] && e[i-2]===t[s-1]`). The transposition matters: a typo like "tset"→"test"
|
|
916
|
-
* is distance 1 (CC has a Did-you-mean), plain Levenshtein would call it 2. */
|
|
917
|
-
export declare function editDistance(a: string, b: string): number;
|
|
918
|
-
/** CC `htr` shape (206:519814-519827): candidates within Levenshtein ≤2 (length-diff ≤2 pre-filter),
|
|
919
|
-
* best-first; the single best is the "Did you mean" suggestion (`htr(e, keys, 1)[0]`, 206:575196). */
|
|
920
|
-
export declare function closestName(query: string, candidates: Iterable<string>): string | undefined;
|
|
921
831
|
/** DEFAULT-DENY on BOTH axes — the old predicate skipped
|
|
922
832
|
* a missing axis (owner-less handle = readable by everyone in scope; scope-less handle = readable
|
|
923
833
|
* across scopes), splitting polarity with `canAccessAgentRecord` and re-opening the session-axis
|