@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
|
@@ -40,25 +40,37 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
40
40
|
catch {
|
|
41
41
|
}
|
|
42
42
|
};
|
|
43
|
-
const clearDeadline = (
|
|
44
|
-
const h = deadlines.get(seq);
|
|
43
|
+
const clearDeadline = (entry) => {
|
|
44
|
+
const h = deadlines.get(entry.seq);
|
|
45
45
|
if (h !== undefined) {
|
|
46
46
|
clock.clearTimeout(h);
|
|
47
|
-
deadlines.delete(seq);
|
|
47
|
+
deadlines.delete(entry.seq);
|
|
48
48
|
}
|
|
49
|
+
delete entry.deadlineAt;
|
|
49
50
|
};
|
|
50
51
|
const remove = (entry) => {
|
|
51
52
|
const i = entries.indexOf(entry);
|
|
52
53
|
if (i !== -1)
|
|
53
54
|
entries.splice(i, 1);
|
|
54
|
-
clearDeadline(entry
|
|
55
|
+
clearDeadline(entry);
|
|
56
|
+
};
|
|
57
|
+
const sendReceipt = (sink, entry, state) => {
|
|
58
|
+
let landed;
|
|
59
|
+
try {
|
|
60
|
+
landed = Promise.resolve(sink.receipt(entry, state));
|
|
61
|
+
}
|
|
62
|
+
catch (e) {
|
|
63
|
+
landed = Promise.reject(e);
|
|
64
|
+
}
|
|
65
|
+
landed.catch(() => undefined);
|
|
66
|
+
return landed;
|
|
55
67
|
};
|
|
56
68
|
const leave = (entry, settlement, reason, receipt) => {
|
|
57
69
|
const sink = sinkOrThrow();
|
|
58
70
|
remove(entry);
|
|
59
|
-
|
|
60
|
-
safe(() => sink.receipt(entry, receipt));
|
|
71
|
+
const landed = receipt !== undefined ? sendReceipt(sink, entry, receipt) : undefined;
|
|
61
72
|
safe(() => sink.onSettled?.(entry, settlement, reason, entries.length));
|
|
73
|
+
return landed;
|
|
62
74
|
};
|
|
63
75
|
const move = async (entry, next) => {
|
|
64
76
|
const sink = sinkOrThrow();
|
|
@@ -78,13 +90,17 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
78
90
|
const adoptCurrent = (entry, current) => {
|
|
79
91
|
if (!entries.includes(entry))
|
|
80
92
|
return;
|
|
81
|
-
if (current === "gone" || current === "unset")
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
93
|
+
if (current === "gone" || current === "unset") {
|
|
94
|
+
leave(entry, "retired", "superseded", undefined);
|
|
95
|
+
return;
|
|
96
|
+
}
|
|
97
|
+
if (isMailboxDecisionFinal(current)) {
|
|
98
|
+
leave(entry, current, "decided_elsewhere", undefined);
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
85
101
|
if (isMailboxDecisionDeliverable(current) && entry.decision !== current) {
|
|
86
102
|
entry.decision = current;
|
|
87
|
-
clearDeadline(entry
|
|
103
|
+
clearDeadline(entry);
|
|
88
104
|
}
|
|
89
105
|
};
|
|
90
106
|
const settleLocal = async (entry, settlement, reason) => {
|
|
@@ -97,13 +113,16 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
97
113
|
tells = false;
|
|
98
114
|
}
|
|
99
115
|
const from = settlement === "expired" ? "held" : "delivered";
|
|
100
|
-
if (!tells || entry.decision !== from)
|
|
101
|
-
|
|
116
|
+
if (!tells || entry.decision !== from) {
|
|
117
|
+
leave(entry, "retired", reason, undefined);
|
|
118
|
+
return {};
|
|
119
|
+
}
|
|
102
120
|
const r = await move(entry, settlement);
|
|
103
121
|
if (r === "won")
|
|
104
|
-
leave(entry, settlement, reason, settlement);
|
|
105
|
-
|
|
122
|
+
return { landed: leave(entry, settlement, reason, settlement) };
|
|
123
|
+
if (r === "fault")
|
|
106
124
|
leave(entry, "retired", reason, undefined);
|
|
125
|
+
return {};
|
|
107
126
|
};
|
|
108
127
|
const armDeadline = (entry) => {
|
|
109
128
|
if (cfg === undefined || cfg.dialogExpiryMs === null || deadlines.has(entry.seq))
|
|
@@ -112,8 +131,9 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
112
131
|
return;
|
|
113
132
|
if (!PEER_HELD_REVIEW_CAUSES.includes(entry.cause))
|
|
114
133
|
return;
|
|
134
|
+
entry.deadlineAt = clock.now() + cfg.dialogExpiryMs;
|
|
115
135
|
const h = clock.setTimeout(() => {
|
|
116
|
-
|
|
136
|
+
clearDeadline(entry);
|
|
117
137
|
void (async () => {
|
|
118
138
|
if (!entries.includes(entry))
|
|
119
139
|
return;
|
|
@@ -150,7 +170,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
150
170
|
if (r === "fault")
|
|
151
171
|
return "no_leg";
|
|
152
172
|
entry.decision = "delivered";
|
|
153
|
-
clearDeadline(entry
|
|
173
|
+
clearDeadline(entry);
|
|
154
174
|
}
|
|
155
175
|
try {
|
|
156
176
|
if (sink.inject(entry) === "deferred")
|
|
@@ -191,7 +211,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
191
211
|
if (verdict.verdict === "hold" && verdict.cause !== entry.cause) {
|
|
192
212
|
entry.cause = verdict.cause;
|
|
193
213
|
reannounce.push([entry, verdict.cause]);
|
|
194
|
-
clearDeadline(entry
|
|
214
|
+
clearDeadline(entry);
|
|
195
215
|
armDeadline(entry);
|
|
196
216
|
}
|
|
197
217
|
return "held";
|
|
@@ -253,7 +273,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
253
273
|
cfg = next;
|
|
254
274
|
for (const entry of entries) {
|
|
255
275
|
if (next.dialogExpiryMs === null)
|
|
256
|
-
clearDeadline(entry
|
|
276
|
+
clearDeadline(entry);
|
|
257
277
|
else
|
|
258
278
|
armDeadline(entry);
|
|
259
279
|
}
|
|
@@ -266,8 +286,10 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
266
286
|
cfg = { ...cfg, sink: rest };
|
|
267
287
|
},
|
|
268
288
|
configured: () => cfg !== undefined,
|
|
269
|
-
async hold(
|
|
289
|
+
async hold(held, known) {
|
|
270
290
|
const sink = sinkOrThrow();
|
|
291
|
+
const { deadlineAt: _callerDeadline, ...input } = held;
|
|
292
|
+
void _callerDeadline;
|
|
271
293
|
if (entries.some((e) => e.box === input.box && e.seq === input.seq))
|
|
272
294
|
return "adopted";
|
|
273
295
|
let state = known ?? "held";
|
|
@@ -294,7 +316,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
294
316
|
return fresh ? "held" : "adopted";
|
|
295
317
|
if (!(await makeRoom())) {
|
|
296
318
|
if (fresh)
|
|
297
|
-
|
|
319
|
+
void sendReceipt(sink, { ...input, heldAt: clock.now(), decision: state }, "held");
|
|
298
320
|
return "uncarded";
|
|
299
321
|
}
|
|
300
322
|
const entry = { ...input, heldAt: clock.now(), decision: state };
|
|
@@ -303,7 +325,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
303
325
|
if (state === "held")
|
|
304
326
|
safe(() => sink.onHeld?.(entry, entries.length, entry.cause, false));
|
|
305
327
|
if (fresh)
|
|
306
|
-
|
|
328
|
+
void sendReceipt(sink, entry, "held");
|
|
307
329
|
return fresh ? "held" : "adopted";
|
|
308
330
|
},
|
|
309
331
|
rejudge,
|
|
@@ -322,12 +344,25 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
322
344
|
deadlines.clear();
|
|
323
345
|
return;
|
|
324
346
|
}
|
|
347
|
+
const owed = [];
|
|
325
348
|
for (const entry of [...entries]) {
|
|
326
349
|
await onCard(entry.seq, async () => {
|
|
327
|
-
if (entries.includes(entry))
|
|
328
|
-
|
|
350
|
+
if (!entries.includes(entry))
|
|
351
|
+
return;
|
|
352
|
+
const { landed } = await settleLocal(entry, "expired", "shutdown");
|
|
353
|
+
if (landed !== undefined)
|
|
354
|
+
owed.push({ seq: entry.seq, landed });
|
|
329
355
|
});
|
|
330
356
|
}
|
|
357
|
+
const outcomes = await Promise.allSettled(owed.map((o) => o.landed));
|
|
358
|
+
const unlanded = [];
|
|
359
|
+
outcomes.forEach((outcome, i) => {
|
|
360
|
+
if (outcome.status === "rejected")
|
|
361
|
+
unlanded.push({ seq: owed[i].seq, reason: outcome.reason });
|
|
362
|
+
});
|
|
363
|
+
if (unlanded.length > 0) {
|
|
364
|
+
throw new AggregateError(unlanded.map((u) => u.reason), `PeerHeldQueue.shutdown: every held card was settled, but the expired receipt of seq ${unlanded.map((u) => u.seq).join(", ")} did not reach its sender's box`);
|
|
365
|
+
}
|
|
331
366
|
},
|
|
332
367
|
};
|
|
333
368
|
async function settleCard(seq, decision) {
|
|
@@ -371,7 +406,7 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
371
406
|
if (r === "lost")
|
|
372
407
|
return "decided_elsewhere";
|
|
373
408
|
entry.decision = "approved";
|
|
374
|
-
clearDeadline(entry
|
|
409
|
+
clearDeadline(entry);
|
|
375
410
|
}
|
|
376
411
|
if (verdict === undefined)
|
|
377
412
|
return "released_pending";
|
|
@@ -386,25 +421,35 @@ export function createPeerHeldQueue(key, opts = {}) {
|
|
|
386
421
|
});
|
|
387
422
|
return queue;
|
|
388
423
|
}
|
|
424
|
+
function peerHeldQueueSeat(scope, sessionId, box) {
|
|
425
|
+
const own = peerSessionBoxHandle(sessionId);
|
|
426
|
+
const at = box ?? own;
|
|
427
|
+
return { scope, sessionId, box: at, key: JSON.stringify(at === own ? [scope, own] : [scope, own, at]) };
|
|
428
|
+
}
|
|
389
429
|
const heldQueues = new Map();
|
|
390
430
|
export function peerHeldQueueKey(scope, sessionId, box) {
|
|
391
|
-
|
|
392
|
-
return JSON.stringify(box === undefined || box === own ? [scope, own] : [scope, own, box]);
|
|
431
|
+
return peerHeldQueueSeat(scope, sessionId, box).key;
|
|
393
432
|
}
|
|
394
433
|
export function peerHeldQueueFor(scope, sessionId, opts = {}) {
|
|
395
|
-
const
|
|
396
|
-
let
|
|
397
|
-
if (
|
|
398
|
-
|
|
399
|
-
heldQueues.set(key,
|
|
434
|
+
const seat = peerHeldQueueSeat(scope, sessionId, opts.box);
|
|
435
|
+
let row = heldQueues.get(seat.key);
|
|
436
|
+
if (row === undefined) {
|
|
437
|
+
row = { seat, queue: createPeerHeldQueue(seat.key, opts) };
|
|
438
|
+
heldQueues.set(seat.key, row);
|
|
400
439
|
}
|
|
401
|
-
return
|
|
440
|
+
return row.queue;
|
|
402
441
|
}
|
|
403
442
|
export function peerHeldQueueIfAny(scope, sessionId, box) {
|
|
404
|
-
return heldQueues.get(peerHeldQueueKey(scope, sessionId, box));
|
|
443
|
+
return heldQueues.get(peerHeldQueueKey(scope, sessionId, box))?.queue;
|
|
444
|
+
}
|
|
445
|
+
export function listPeerHeldQueues() {
|
|
446
|
+
return [...heldQueues.values()].map(({ seat, queue }) => {
|
|
447
|
+
const entries = queue.list();
|
|
448
|
+
return { scope: seat.scope, sessionId: seat.sessionId, box: seat.box, size: entries.length, entries };
|
|
449
|
+
});
|
|
405
450
|
}
|
|
406
451
|
export function resetPeerHeldQueuesForTests() {
|
|
407
|
-
for (const
|
|
408
|
-
crashHandlers.get(
|
|
452
|
+
for (const { queue } of heldQueues.values())
|
|
453
|
+
crashHandlers.get(queue)?.();
|
|
409
454
|
heldQueues.clear();
|
|
410
455
|
}
|
|
@@ -20,7 +20,7 @@ export interface PeerNoticeRoute {
|
|
|
20
20
|
}
|
|
21
21
|
/** A delivery RECEIPT to the sender of one message this session judged (held / expired / delivered /
|
|
22
22
|
* refused / denied). `refSeq` = the seq of the sender's message in THIS session's box. */
|
|
23
|
-
export declare function routePeerDeliveryReceipt(route: PeerNoticeRoute, toSession: string, state: Exclude<PeerDeliveryReceiptState, "dropped">, refSeq: number): Promise<boolean>;
|
|
23
|
+
export declare function routePeerDeliveryReceipt(route: PeerNoticeRoute, toSession: string, state: Exclude<PeerDeliveryReceiptState, "dropped">, refSeq: number, detail?: string): Promise<boolean>;
|
|
24
24
|
/** A `dropped` receipt (the ingress guard's arm). */
|
|
25
25
|
export declare function routePeerDroppedReceipt(route: PeerNoticeRoute, toSession: string, refSeq: number, dropReason?: PeerDropReason): Promise<boolean>;
|
|
26
26
|
/** An idle NOTICE to a requester (`idle` / `exited` / `unavailable` from the target; `expired` from the
|
|
@@ -28,10 +28,11 @@ async function appendNotice(route, toSession, content, peerMeta, classification)
|
|
|
28
28
|
return false;
|
|
29
29
|
}
|
|
30
30
|
}
|
|
31
|
-
export function routePeerDeliveryReceipt(route, toSession, state, refSeq) {
|
|
31
|
+
export function routePeerDeliveryReceipt(route, toSession, state, refSeq, detail) {
|
|
32
32
|
const recipient = route.self.name ?? peerSessionBoxHandle(route.self.sessionId);
|
|
33
|
-
const
|
|
34
|
-
|
|
33
|
+
const said = state === "refused" && detail !== undefined ? peerIdleNoticeLabel(detail) : undefined;
|
|
34
|
+
const notice = { state, refSeq, recipient, ...(said !== undefined ? { detail: said } : {}) };
|
|
35
|
+
return appendNotice(route, toSession, renderCrossSessionDeliveryNotice(state, 1, [recipient], said), noticeMeta(route, "delivery_notice", notice), "peer-receipt-route");
|
|
35
36
|
}
|
|
36
37
|
export function routePeerDroppedReceipt(route, toSession, refSeq, dropReason) {
|
|
37
38
|
const recipient = route.self.name ?? peerSessionBoxHandle(route.self.sessionId);
|
|
@@ -65,7 +65,7 @@ export declare function peerRecipientSuffix(recipients: readonly string[]): stri
|
|
|
65
65
|
* CC `y$e` — the model-face delivery receipt for the five non-drop states. `count` folds several
|
|
66
66
|
* receipts of one state into one line (the requester's drain may fold; a single record renders as 1).
|
|
67
67
|
*/
|
|
68
|
-
export declare function renderCrossSessionDeliveryNotice(state: Exclude<PeerDeliveryReceiptState, "dropped">, count: number, recipients?: readonly string[]): string;
|
|
68
|
+
export declare function renderCrossSessionDeliveryNotice(state: Exclude<PeerDeliveryReceiptState, "dropped">, count: number, recipients?: readonly string[], detail?: string): string;
|
|
69
69
|
/** CC `S$e` — the drop reasons, rendered. */
|
|
70
70
|
export declare function describePeerDropReasons(reasons: readonly (PeerDropReason | undefined)[]): string;
|
|
71
71
|
/** CC `b$e` — the model-face receipt for messages DROPPED at the recipient's ingress guard. */
|
|
@@ -79,9 +79,9 @@ export declare function isPeerIdleNoticeKind(v: unknown): v is PeerIdleNoticeKin
|
|
|
79
79
|
export declare const PEER_IDLE_UNAVAILABLE_CAUSES = "it is shutting down, its subscription table is full, a newer subscription displaced this one, or it answered in a form this version does not recognize";
|
|
80
80
|
/**
|
|
81
81
|
* CC `nYt` — a label or detail line made safe for the notice text: format/control characters and the
|
|
82
|
-
* envelope-ish punctuation (`<>«»"[]`) become spaces, whitespace collapses,
|
|
83
|
-
* phrase
|
|
84
|
-
* when nothing printable is left.
|
|
82
|
+
* envelope-ish punctuation (`<>«»"[]`) become spaces, whitespace collapses, neither notice's own prefix
|
|
83
|
+
* phrase can be smuggled in (the idle notice's, and the delivery notice's a `refused` receipt's detail
|
|
84
|
+
* rides), and the result is capped at {@link PEER_IDLE_LABEL_MAX}. `undefined` when nothing printable is left.
|
|
85
85
|
*/
|
|
86
86
|
export declare function peerIdleNoticeLabel(raw: string): string | undefined;
|
|
87
87
|
export interface PeerIdleNoticeFields {
|
|
@@ -33,7 +33,7 @@ export function peerRecipientSuffix(recipients) {
|
|
|
33
33
|
return ` (recipient: ${uniq[0]})`;
|
|
34
34
|
return ` (recipients: ${uniq.slice(0, 3).join(", ")}${uniq.length > 3 ? ", …" : ""})`;
|
|
35
35
|
}
|
|
36
|
-
export function renderCrossSessionDeliveryNotice(state, count, recipients = []) {
|
|
36
|
+
export function renderCrossSessionDeliveryNotice(state, count, recipients = [], detail) {
|
|
37
37
|
const n = Math.max(1, Math.floor(count));
|
|
38
38
|
const P = n === 1 ? "Your message to another session" : `${n} of your messages to another session`;
|
|
39
39
|
const J = n === 1 ? "was" : "were";
|
|
@@ -47,8 +47,12 @@ export function renderCrossSessionDeliveryNotice(state, count, recipients = [])
|
|
|
47
47
|
return `[Cross-session delivery notice] ${P} ${J} not approved before expiry${R}. Not delivered to that session's assistant. Do not wait for a reply; continue, or choose another approach.`;
|
|
48
48
|
case "delivered":
|
|
49
49
|
return `[Cross-session delivery notice] ${P} ${J} approved and released to that session${R}.`;
|
|
50
|
-
case "refused":
|
|
51
|
-
|
|
50
|
+
case "refused": {
|
|
51
|
+
const said = detail !== undefined ? peerIdleNoticeLabel(detail) : undefined;
|
|
52
|
+
return said !== undefined
|
|
53
|
+
? `[Cross-session delivery notice] ${P} ${J} refused${R} by ${said}. Not delivered to that session's assistant. Do not wait for a reply and do not resend; tell the user, or choose another approach.`
|
|
54
|
+
: `[Cross-session delivery notice] ${P} ${J} refused${R}: that session is not accepting cross-session messages (the feature is off there, or a setting or policy there refuses them). Not delivered to that session's assistant. Do not wait for a reply and do not resend; tell the user, or choose another approach.`;
|
|
55
|
+
}
|
|
52
56
|
default: {
|
|
53
57
|
const _exhaustive = state;
|
|
54
58
|
void _exhaustive;
|
|
@@ -98,7 +102,7 @@ export function peerIdleNoticeLabel(raw) {
|
|
|
98
102
|
.replace(/[\p{Cc}\p{Cf}<>«»"[\]]/gu, " ")
|
|
99
103
|
.replace(/[\s\p{Z}]+/gu, " ");
|
|
100
104
|
for (;;) {
|
|
101
|
-
const r = t.replace(/cross-session idle notice/giu, " ").replace(/ {2,}/g, " ");
|
|
105
|
+
const r = t.replace(/cross-session (?:idle|delivery) notice/giu, " ").replace(/ {2,}/g, " ");
|
|
102
106
|
if (r === t)
|
|
103
107
|
break;
|
|
104
108
|
t = r;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { type MailboxCrossProcessVerdict, type MailboxStore } from "../core/mailbox-store.js";
|
|
2
|
-
import { type SessionBoxBinding, type SystemInjectionPriority, type TaskNotificationPayload } from "../core/task-notification.js";
|
|
2
|
+
import { type FrameReceiver, type SessionBoxBinding, type SystemInjectionPriority, type TaskNotificationPayload } from "../core/task-notification.js";
|
|
3
3
|
import { type FrameSettlement } from "../core/frame-settlement.js";
|
|
4
4
|
import { type EngineNotice, type RunnerDeps } from "../core/types.js";
|
|
5
5
|
import { type PermissionModeClass } from "./cross-session-envelope.js";
|
|
@@ -140,6 +140,11 @@ export interface PeerSessionDrainOptions {
|
|
|
140
140
|
* private one, which is honest but inert: nothing fills it, so every delivered record waits for a
|
|
141
141
|
* receipt that never comes and stays parked (at-least-once). Every production binding supplies it. */
|
|
142
142
|
settlement?: FrameSettlement;
|
|
143
|
+
/** The leg's receiving station (`session.receive`): every record the PULL face hands back passes it first, and a
|
|
144
|
+
* record it consumed is settled as that decision (its sender told `refused`). A record the drain injects passes it on
|
|
145
|
+
* the live lane, which answers a consume through the settlement seam ({@link FrameSettlement.consumed}). Absent ⇒ no
|
|
146
|
+
* station: every record is handed over as made. */
|
|
147
|
+
receive?: FrameReceiver;
|
|
143
148
|
leaseTtlMs?: number;
|
|
144
149
|
/** Tests: a virtual clock for the held deadlines and idle timers (honored when this process first sees the session). */
|
|
145
150
|
clock?: PeerClock;
|
|
@@ -318,6 +323,8 @@ export declare function bindPeerLaneDrain(harness: PeerDrainHarness, args: {
|
|
|
318
323
|
/** #1036 — the leg's settlement seam (receipts + compaction effects), minted by the
|
|
319
324
|
* orchestrator and shared with the harness sink and the compaction commit beat. */
|
|
320
325
|
settlement?: FrameSettlement;
|
|
326
|
+
/** The leg's receiving station ({@link PeerSessionDrainOptions.receive}). */
|
|
327
|
+
receive?: FrameReceiver;
|
|
321
328
|
selfName?: () => string | undefined;
|
|
322
329
|
parked?: () => boolean;
|
|
323
330
|
lastTurnText?: () => string | undefined;
|
|
@@ -147,14 +147,31 @@ export function createPeerSessionDrain(opts) {
|
|
|
147
147
|
_sema_provenance: { kind: "cross_session_notice", from: encodePeerAddress(storedSessionAddress(m.peerMeta?.fromSession) ?? (m.from ?? "unknown")), taskId: boxHandle, seq: m.seq, ...(m.peerMeta !== undefined ? { peerMeta: { ...m.peerMeta } } : {}) },
|
|
148
148
|
});
|
|
149
149
|
const receiptAddress = (lane, entry) => (lane.kind === "session" ? entry.peerMeta?.fromSession : undefined);
|
|
150
|
-
const receipt = (lane) => (entry, state) => {
|
|
150
|
+
const receipt = (lane) => async (entry, state) => {
|
|
151
151
|
const to = receiptAddress(lane, entry);
|
|
152
152
|
if (to === undefined)
|
|
153
153
|
return;
|
|
154
|
+
const faults = [];
|
|
155
|
+
const via = {
|
|
156
|
+
...route(),
|
|
157
|
+
onError: (error, ctx) => {
|
|
158
|
+
faults.push(error);
|
|
159
|
+
opts.onError?.(error, ctx);
|
|
160
|
+
},
|
|
161
|
+
};
|
|
154
162
|
if (state === "dropped")
|
|
155
|
-
|
|
163
|
+
await routePeerDroppedReceipt(via, to, entry.seq);
|
|
156
164
|
else
|
|
157
|
-
|
|
165
|
+
await routePeerDeliveryReceipt(via, to, state, entry.seq);
|
|
166
|
+
if (faults.length > 0)
|
|
167
|
+
throw faults[0];
|
|
168
|
+
};
|
|
169
|
+
const settleConsumed = (lane, seq, payload, by, reason) => {
|
|
170
|
+
lane.ledger.set(seq, { kind: "terminal", why: "consumed" });
|
|
171
|
+
const peerMeta = payload._sema_provenance?.kind === "cross_session_message" ? payload._sema_provenance.peerMeta : undefined;
|
|
172
|
+
const to = peerMeta !== undefined ? receiptAddress(lane, { peerMeta }) : undefined;
|
|
173
|
+
if (to !== undefined)
|
|
174
|
+
void routePeerDeliveryReceipt(route(), to, "refused", seq, by === "engine" ? "the receiving engine (it could not judge the message)" : `extension ${by} of that session: ${reason}`);
|
|
158
175
|
};
|
|
159
176
|
const heldSink = (lane, live) => ({
|
|
160
177
|
judge: (entry) => judgeMeta(readFacts(), entry.peerMeta),
|
|
@@ -164,6 +181,10 @@ export function createPeerSessionDrain(opts) {
|
|
|
164
181
|
if (currentRound === undefined || !currentRound.holds(lane))
|
|
165
182
|
return "deferred";
|
|
166
183
|
const payload = buildPeerMessagePayload(lane, entry);
|
|
184
|
+
if (currentRound.out !== undefined && opts.receive?.listens() === true) {
|
|
185
|
+
currentRound.batch.push({ lane, payload, priority: "next", urgent: false, seq: entry.seq, attempt: 1 });
|
|
186
|
+
return undefined;
|
|
187
|
+
}
|
|
167
188
|
if (currentRound.deliver(payload, "next") === "deferred")
|
|
168
189
|
return "deferred";
|
|
169
190
|
noteDelivered(lane, entry.seq, 1, payload, currentRound.carrier);
|
|
@@ -253,7 +274,7 @@ export function createPeerSessionDrain(opts) {
|
|
|
253
274
|
return true;
|
|
254
275
|
return false;
|
|
255
276
|
};
|
|
256
|
-
const noteDelivered = (lane, seq, attempt, payload, carrier) => {
|
|
277
|
+
const noteDelivered = (lane, seq, attempt, payload, carrier, shown = payload) => {
|
|
257
278
|
const own = taskNotificationDedupKey(payload);
|
|
258
279
|
const key = carrier === undefined ? own : `${carrier}|${own}`;
|
|
259
280
|
lane.ledger.set(seq, { kind: "delivered", attempt, key, payload });
|
|
@@ -266,7 +287,7 @@ export function createPeerSessionDrain(opts) {
|
|
|
266
287
|
opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-external-mark" });
|
|
267
288
|
}
|
|
268
289
|
}
|
|
269
|
-
seam.awaiting.set(key, carrier === undefined ? { carrier: own } : { carrier, frameText: renderTaskNotificationXml(
|
|
290
|
+
seam.awaiting.set(key, carrier === undefined ? { carrier: own } : { carrier, frameText: renderTaskNotificationXml(shown) });
|
|
270
291
|
};
|
|
271
292
|
const deriveAckPrefix = (lane, messages) => {
|
|
272
293
|
let prefix;
|
|
@@ -287,10 +308,16 @@ export function createPeerSessionDrain(opts) {
|
|
|
287
308
|
const settleLaneLocally = (lane, landed) => {
|
|
288
309
|
const { ledger, boxHandle } = lane;
|
|
289
310
|
const hostWithheldSeqs = [];
|
|
290
|
-
if (seam.receipts.size > 0 || seam.withheld.size > 0 || seam.hostWithheld.size > 0) {
|
|
311
|
+
if (seam.receipts.size > 0 || seam.withheld.size > 0 || seam.hostWithheld.size > 0 || seam.consumed.size > 0) {
|
|
291
312
|
for (const [seq, d] of ledger) {
|
|
292
313
|
if (d.kind !== "delivered")
|
|
293
314
|
continue;
|
|
315
|
+
const consumed = seam.consumed.get(d.key);
|
|
316
|
+
if (consumed !== undefined) {
|
|
317
|
+
seam.consumed.delete(d.key);
|
|
318
|
+
settleConsumed(lane, seq, d.payload, consumed.by, consumed.reason);
|
|
319
|
+
continue;
|
|
320
|
+
}
|
|
294
321
|
if (seam.hostWithheld.delete(d.key)) {
|
|
295
322
|
ledger.set(seq, { kind: "terminal", why: "host_withheld" });
|
|
296
323
|
hostWithheldSeqs.push(seq);
|
|
@@ -311,7 +338,7 @@ export function createPeerSessionDrain(opts) {
|
|
|
311
338
|
}
|
|
312
339
|
}
|
|
313
340
|
if (hostWithheldSeqs.length > 0) {
|
|
314
|
-
opts.onError?.(new Error(`${hostWithheldSeqs.length} cross-session message frame(s) (seq ${hostWithheldSeqs.join(", ")}) could not be found in this session's ReadInbox result as a postToolUse hook
|
|
341
|
+
opts.onError?.(new Error(`${hostWithheldSeqs.length} cross-session message frame(s) (seq ${hostWithheldSeqs.join(", ")}) could not be found in this session's ReadInbox result as the host side rewrote it (a postToolUse hook or an extension's session.append handler: removed, truncated or reshaped beyond whitespace) — settled as the host's decision: they leave ${boxHandle} and are not handed over again`), { phase: "degraded", sessionId, classification: "peer-inbox-host-withheld" });
|
|
315
342
|
}
|
|
316
343
|
for (const effect of landed) {
|
|
317
344
|
for (const [seq, d] of ledger) {
|
|
@@ -373,7 +400,7 @@ export function createPeerSessionDrain(opts) {
|
|
|
373
400
|
else {
|
|
374
401
|
const state = notice.state;
|
|
375
402
|
const recipients = [notice.recipient ?? m.from ?? ""];
|
|
376
|
-
text = state === "dropped" ? renderCrossSessionDroppedNotice(1, recipients, [notice.dropReason]) : renderCrossSessionDeliveryNotice(state, 1, recipients);
|
|
403
|
+
text = state === "dropped" ? renderCrossSessionDroppedNotice(1, recipients, [notice.dropReason]) : renderCrossSessionDeliveryNotice(state, 1, recipients, notice.detail);
|
|
377
404
|
}
|
|
378
405
|
const judged = judgeMeta(facts, meta);
|
|
379
406
|
if (judged.verdict === "refuse") {
|
|
@@ -647,15 +674,26 @@ export function createPeerSessionDrain(opts) {
|
|
|
647
674
|
finally {
|
|
648
675
|
const ordered = round.batch.splice(0).sort((a, b) => Number(b.urgent) - Number(a.urgent));
|
|
649
676
|
for (const item of ordered) {
|
|
677
|
+
let shown = item.payload;
|
|
678
|
+
if (round.out !== undefined && opts.receive?.listens() === true) {
|
|
679
|
+
if (round.spent)
|
|
680
|
+
continue;
|
|
681
|
+
const verdict = await opts.receive.receive(item.payload);
|
|
682
|
+
if (verdict.kind === "consumed") {
|
|
683
|
+
settleConsumed(item.lane, item.seq, item.payload, verdict.by, verdict.reason);
|
|
684
|
+
continue;
|
|
685
|
+
}
|
|
686
|
+
shown = verdict.payload;
|
|
687
|
+
}
|
|
650
688
|
try {
|
|
651
|
-
if (round.deliver(
|
|
689
|
+
if (round.deliver(shown, item.priority) === "deferred")
|
|
652
690
|
continue;
|
|
653
691
|
}
|
|
654
692
|
catch (e) {
|
|
655
693
|
opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-box-inject" });
|
|
656
694
|
break;
|
|
657
695
|
}
|
|
658
|
-
noteDelivered(item.lane, item.seq, item.attempt, item.payload, round.carrier);
|
|
696
|
+
noteDelivered(item.lane, item.seq, item.attempt, item.payload, round.carrier, shown);
|
|
659
697
|
}
|
|
660
698
|
}
|
|
661
699
|
for (const { lane, lease } of leased) {
|
|
@@ -872,6 +910,7 @@ export function bindPeerLaneDrain(harness, args) {
|
|
|
872
910
|
selfName: () => rowName ?? args.selfName?.(),
|
|
873
911
|
warmup: lookupRowName,
|
|
874
912
|
...(args.settlement !== undefined ? { settlement: args.settlement } : {}),
|
|
913
|
+
...(args.receive !== undefined ? { receive: args.receive } : {}),
|
|
875
914
|
...(args.parked !== undefined ? { parked: args.parked } : {}),
|
|
876
915
|
...(args.lastTurnText !== undefined ? { lastTurnText: args.lastTurnText } : {}),
|
|
877
916
|
...(args.markExternalContent !== undefined ? { markExternalContent: args.markExternalContent } : {}),
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import { isDurablePause, pauseFamily } from "./suspend-guard.js";
|
|
2
2
|
import { delimitUntrusted, sanitizeUntrustedText } from "../core/untrusted-text.js";
|
|
3
|
+
import { recipeContinuationLeg } from "../core/input-author.js";
|
|
3
4
|
import { assertOracleIsolation } from "../core/oracle-isolation.js";
|
|
4
5
|
import { buildCumulativeStats } from "./cumulative-stats.js";
|
|
6
|
+
import { laterLegAllowance } from "./composition-allowance.js";
|
|
5
7
|
export function isolationPermitsAutoAccept(verdict) {
|
|
6
8
|
return verdict.protected && verdict.isolationClass === "out_of_process";
|
|
7
9
|
}
|
|
@@ -154,8 +156,11 @@ export async function runRepairLoop(runner, implSpec, config) {
|
|
|
154
156
|
});
|
|
155
157
|
let restartedOnce = false;
|
|
156
158
|
let restartUsed = false;
|
|
159
|
+
let firstAttempt = true;
|
|
160
|
+
let laterAttemptSpec = implSpec;
|
|
161
|
+
const ownSpend = () => ({ costMicroUsd: anyAttemptUnpriced ? undefined : ownCostMicro, tokens: ownTokens, turns: ownTurns });
|
|
157
162
|
const cleanRestartSpec = () => {
|
|
158
|
-
const { sessionId: _drop, ...rest } =
|
|
163
|
+
const { sessionId: _drop, ...rest } = laterAttemptSpec;
|
|
159
164
|
return { ...rest, objective: `${implSpec.objective}\n\n${repairObjective(bundle)}` };
|
|
160
165
|
};
|
|
161
166
|
const exhaustedBeforeDispatch = (message, errorCode) => ({
|
|
@@ -188,7 +193,7 @@ export async function runRepairLoop(runner, implSpec, config) {
|
|
|
188
193
|
const spec = restartedOnce
|
|
189
194
|
? cleanRestartSpec()
|
|
190
195
|
: isRepair
|
|
191
|
-
? { ...
|
|
196
|
+
? { ...laterAttemptSpec, sessionId: lastResult.sessionId, objective: repairObjective(bundle) }
|
|
192
197
|
: isSeededResume
|
|
193
198
|
? {
|
|
194
199
|
...implSpec,
|
|
@@ -200,10 +205,11 @@ export async function runRepairLoop(runner, implSpec, config) {
|
|
|
200
205
|
liveStamp.unref?.();
|
|
201
206
|
let result;
|
|
202
207
|
try {
|
|
203
|
-
result = await runner.runTask(spec, { repairBundle: bundle });
|
|
208
|
+
result = await runner.runTask(spec, firstAttempt ? { repairBundle: bundle } : recipeContinuationLeg({ repairBundle: bundle }));
|
|
204
209
|
}
|
|
205
210
|
finally {
|
|
206
211
|
clearInterval(liveStamp);
|
|
212
|
+
firstAttempt = false;
|
|
207
213
|
}
|
|
208
214
|
spend += (result.stats.costMicroUsd ?? 0) + (result.stats.nested?.costMicroUsd ?? 0);
|
|
209
215
|
stampAccount();
|
|
@@ -258,8 +264,12 @@ export async function runRepairLoop(runner, implSpec, config) {
|
|
|
258
264
|
}
|
|
259
265
|
const overTime = config.totalTimeoutMs != null && priorActiveMs + (Date.now() - startedAt) >= config.totalTimeoutMs;
|
|
260
266
|
const overCost = config.costCeilingMicroUsd != null && spend >= config.costCeilingMicroUsd;
|
|
261
|
-
|
|
262
|
-
|
|
267
|
+
const allowance = laterLegAllowance(implSpec, ownSpend());
|
|
268
|
+
if (allowance.spec !== undefined)
|
|
269
|
+
laterAttemptSpec = allowance.spec;
|
|
270
|
+
const overAllowance = allowance.exhausted;
|
|
271
|
+
if (bundle.attemptCount >= maxAttempts || overTime || overCost || overAllowance !== undefined) {
|
|
272
|
+
if (bundle.attemptCount >= maxAttempts && !overTime && !overCost && overAllowance === undefined && lastResult !== undefined && !restartUsed) {
|
|
263
273
|
restartUsed = true;
|
|
264
274
|
restartedOnce = true;
|
|
265
275
|
continue;
|
|
@@ -272,7 +282,7 @@ export async function runRepairLoop(runner, implSpec, config) {
|
|
|
272
282
|
bundle,
|
|
273
283
|
...(isolationClass ? { isolationClass } : {}),
|
|
274
284
|
oracleCostMicroUsd,
|
|
275
|
-
verification: outcomeFor(terminal, lastOracle, bundle.attemptCount),
|
|
285
|
+
verification: { ...outcomeFor(terminal, lastOracle, bundle.attemptCount), ...(overAllowance !== undefined ? { allowanceExhausted: overAllowance } : {}) },
|
|
276
286
|
};
|
|
277
287
|
}
|
|
278
288
|
}
|
|
@@ -3,6 +3,8 @@ import { PEER_MESSAGE_NOTICE } from "./peer-admission.js";
|
|
|
3
3
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
4
4
|
import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../config/defaults.js";
|
|
5
5
|
import { asThrownError } from "../core/thrown-value.js";
|
|
6
|
+
import { optionKeys, receiveMembers } from "../core/own-property-receipt.js";
|
|
7
|
+
const RETAIN_CONFIG_KEYS = optionKeys()({ ttlMs: 0, max: 0 });
|
|
6
8
|
export const SUBAGENT_RESUME_CAP = 8;
|
|
7
9
|
export function holdChildDeclarations(runner, declared) {
|
|
8
10
|
if (typeof runner.holdDeclarations !== "function") {
|
|
@@ -24,7 +26,7 @@ export class SubagentRetainLedger {
|
|
|
24
26
|
lastFailure;
|
|
25
27
|
notifier = createSafeNotifier();
|
|
26
28
|
constructor(config, hooks) {
|
|
27
|
-
const cfg = config === true ? {} : config;
|
|
29
|
+
const cfg = config === true ? {} : receiveMembers(config, { subject: "TaskSpec.retainSubagentSessions", unit: "member", moment: "when the retain ledger is made" }, RETAIN_CONFIG_KEYS);
|
|
28
30
|
this.ttlMs = cfg.ttlMs ?? RETAIN_DEFAULT_TTL_MS;
|
|
29
31
|
this.max = cfg.max ?? RETAIN_DEFAULT_MAX;
|
|
30
32
|
this.hooks = hooks;
|
|
@@ -133,7 +133,7 @@ export declare class MemoryRosterStore implements RosterStore {
|
|
|
133
133
|
private entries;
|
|
134
134
|
private readonly maxAgeMs;
|
|
135
135
|
private readonly gc;
|
|
136
|
-
constructor(
|
|
136
|
+
constructor(options?: RosterGcOptions);
|
|
137
137
|
record(entry: RosterEntry): void;
|
|
138
138
|
resolve(name: string, access: RosterAccess): RosterEntry | undefined;
|
|
139
139
|
list(): RosterEntry[];
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { mkdirSync, readFileSync } from "node:fs";
|
|
2
2
|
import { assertRetentionPolicy } from "../core/retention-policy.js";
|
|
3
|
-
import { receiveOptions } from "../core/own-property-receipt.js";
|
|
3
|
+
import { optionKeys, receiveOptions } from "../core/own-property-receipt.js";
|
|
4
4
|
import { atomicWriteFile } from "../stores/file/fs-atomic.js";
|
|
5
5
|
import { dirname } from "node:path";
|
|
6
6
|
import { normalizeAgentName } from "../core/task-registry.js";
|
|
@@ -29,6 +29,8 @@ function resolveIn(entries, name, access) {
|
|
|
29
29
|
return undefined;
|
|
30
30
|
return latestOf(entries.filter((e) => normalizeAgentName(e.name) === key && entryAccessible(e, access)));
|
|
31
31
|
}
|
|
32
|
+
const ROSTER_GC_OPTION_KEYS = optionKeys()({ onNotifyError: 0, maxAgeMs: 0, maxEntries: 0, onEvicted: 0 });
|
|
33
|
+
const FILE_ROSTER_STORE_OPTION_KEYS = optionKeys()({ onNotifyError: 0, maxAgeMs: 0, maxEntries: 0, onEvicted: 0, onCorruptRead: 0 });
|
|
32
34
|
function freshOnly(entries, maxAgeMs, now = Date.now()) {
|
|
33
35
|
if (maxAgeMs === undefined)
|
|
34
36
|
return entries;
|
|
@@ -51,9 +53,10 @@ export class MemoryRosterStore {
|
|
|
51
53
|
entries = [];
|
|
52
54
|
maxAgeMs;
|
|
53
55
|
gc;
|
|
54
|
-
constructor(
|
|
56
|
+
constructor(options) {
|
|
57
|
+
const opts = receiveOptions(options, "MemoryRosterStore", ROSTER_GC_OPTION_KEYS);
|
|
55
58
|
assertRetentionPolicy("RosterStore", opts);
|
|
56
|
-
this.maxAgeMs = opts
|
|
59
|
+
this.maxAgeMs = opts.maxAgeMs;
|
|
57
60
|
this.gc = opts;
|
|
58
61
|
}
|
|
59
62
|
record(entry) {
|
|
@@ -81,7 +84,7 @@ export class FileRosterStore {
|
|
|
81
84
|
gc;
|
|
82
85
|
onCorruptRead;
|
|
83
86
|
constructor(path, options) {
|
|
84
|
-
const opts =
|
|
87
|
+
const opts = receiveOptions(options, "FileRosterStore", FILE_ROSTER_STORE_OPTION_KEYS);
|
|
85
88
|
assertRetentionPolicy("RosterStore", opts);
|
|
86
89
|
this.path = path;
|
|
87
90
|
this.maxAgeMs = opts?.maxAgeMs;
|