@sema-agent/core 7.60.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +605 -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 +61 -10
- package/dist/agents/cascade.js +60 -20
- 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-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- 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-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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 +49 -18
- 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 +2 -1
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- 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 +2 -1
- 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 +220 -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.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/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +38 -16
- package/dist/core/mods/stations.js +25 -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 +61 -2
- package/dist/core/own-property-receipt.js +42 -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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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 +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- 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/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/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 +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- 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 +56 -28
- 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 +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-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.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- 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 +40 -29
- 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 +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/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-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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +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 +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- 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 +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +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 +2 -3
- 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 +108 -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-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- 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 +41 -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/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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 +16 -3
- package/dist/stores/file/session-store.js +21 -20
- 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/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/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +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 +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
package/README.md
CHANGED
|
@@ -51,8 +51,8 @@ const res = await runner.runTask({ objective: "...", model: "main" });
|
|
|
51
51
|
tool lifecycle, progress, diagnostics), ready to pipe into SSE via `createTaskServer`.
|
|
52
52
|
- **Security model built in.** Tool policies with allow/ask/deny semantics, per-principal
|
|
53
53
|
authorization, shell gating, and durable approval suspension — not bolted on.
|
|
54
|
-
- **Small and honest.**
|
|
55
|
-
`@sema-agent/primitives`, installed with it at the same version).
|
|
54
|
+
- **Small and honest.** Five runtime dependencies (`typebox`, `@modelcontextprotocol/client` with its `@modelcontextprotocol/core`,
|
|
55
|
+
`undici`, and the sibling package `@sema-agent/primitives`, installed with it at the same version).
|
|
56
56
|
A deterministic vitest suite of 5,400+ tests runs fully offline (`npm test`), including a real
|
|
57
57
|
stdio MCP server.
|
|
58
58
|
- **Source-available.** BUSL-1.1: free for personal, educational, research, and non-commercial
|
|
@@ -15,7 +15,7 @@ export interface AgentTranscriptToolOptions {
|
|
|
15
15
|
* lifecycle flip skipped its release). Reads go through `runner.sessions` — a split-store child
|
|
16
16
|
* (caller-mounted Agent tool with its own runner) is honestly unreadable here after a restart. */
|
|
17
17
|
agentStore?: import("../core/background-agent-store.js").BackgroundAgentStore;
|
|
18
|
-
/** Access identity (mirrors SendMessage/
|
|
18
|
+
/** Access identity (mirrors SendMessage/TaskStop — the mount fills these). */
|
|
19
19
|
owner?: string;
|
|
20
20
|
scope?: string;
|
|
21
21
|
sessionId?: string;
|
|
@@ -50,7 +50,7 @@ export interface AgentTranscriptToolOptions {
|
|
|
50
50
|
* into a child's tail when the residual isn't enough.
|
|
51
51
|
*
|
|
52
52
|
* Safety: reads are bounded to the parent's OWN lineage — the same non-leaking registry access scope as
|
|
53
|
-
* SendMessage/
|
|
53
|
+
* SendMessage/TaskStop (an unknown or out-of-scope id reads identically to "not found"). Two read
|
|
54
54
|
* paths keep a child's session reachable: the retain ledger (a RETAINED child), and the durable
|
|
55
55
|
* agent-store fallback (`agentStore` wired + accessible row + preserved `sessionId` — readable even
|
|
56
56
|
* with retain off/expired/evicted). Only when BOTH miss does the call return the honest
|
|
@@ -100,7 +100,7 @@ export function createAgentTranscriptTool(opts) {
|
|
|
100
100
|
if (!row || row.type !== "background_agent") {
|
|
101
101
|
if (/^w[0-9a-f]{16}$/.test(id) || (row !== undefined && row.type === "workflow")) {
|
|
102
102
|
return {
|
|
103
|
-
content: `No transcript: "${id}" is a WORKFLOW run id — AgentTranscript reads sub-agent transcripts only.
|
|
103
|
+
content: `No transcript: "${id}" is a WORKFLOW run id — AgentTranscript reads sub-agent transcripts only. The run's per-agent rows (which agent failed, why, elapsed) are in its completion notification (the full record behind the ReadToolResult ref it names); to continue a fixed script, re-invoke the workflow with resumeFromRunId: "${id}".`,
|
|
104
104
|
details: { error: "workflow_id", id },
|
|
105
105
|
isError: true,
|
|
106
106
|
};
|
package/dist/agents/cascade.d.ts
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
import type { RunInternals, RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
1
|
+
import type { CompositionLeg, RunInternals, RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
2
|
+
import type { CheckpointToken, ResumeOutcome } from "../core/checkpoint-store.js";
|
|
2
3
|
import type { ModelRef, TaskResult, TaskSpec, TaskStatus } from "../core/types.js";
|
|
3
4
|
/**
|
|
4
5
|
* Quality-gate cascade (design/27). Run the SAME task across a ladder of models (cheapest → strongest);
|
|
5
6
|
* after each rung a caller-supplied **decidable gate** judges "good enough" — pass = keep it, fail =
|
|
6
|
-
* escalate to the next rung. Classic FrugalGPT cascade, as a thin function over `runner.runTask`
|
|
7
|
-
*
|
|
7
|
+
* escalate to the next rung. Classic FrugalGPT cascade, as a thin function over `runner.runTask` — and over
|
|
8
|
+
* `runner.resume` for the one rung whose parked card {@link resumeCascade} continues. Both entries climb the ladder through
|
|
9
|
+
* ONE step loop (`climbLadder`); neither has a copy of it.
|
|
8
10
|
*
|
|
9
11
|
* APPLICABILITY: cascade only helps when the gate is **decidable** (a schema check, a verifier model, a
|
|
10
12
|
* concrete assertion). Open-ended "completeness" tasks (find every bug, writing quality) have no oracle —
|
|
@@ -153,8 +155,8 @@ export interface CascadeRunResult extends TaskResult {
|
|
|
153
155
|
export declare function runCascade(runner: RunnerSelfSeat, spec: TaskSpec, config: CascadeConfig,
|
|
154
156
|
/**
|
|
155
157
|
* The TRUSTED, run-scoped internals channel — the same object `Runner.runTask` takes as its second
|
|
156
|
-
* argument — forwarded to EVERY rung under the composition forward contract (identity, with the
|
|
157
|
-
* placement
|
|
158
|
+
* argument — forwarded to EVERY rung under the composition forward contract (identity, with the
|
|
159
|
+
* placement exception stated where the shape is named in `src/index.ts`).
|
|
158
160
|
*
|
|
159
161
|
* WHY THE SEAT EXISTS: `runCascade` returns a `TaskResult` and DRAINS each rung's event stream
|
|
160
162
|
* internally, so the host never holds a `TaskStream` for any rung. Without this parameter a
|
|
@@ -192,10 +194,59 @@ export declare function runCascade(runner: RunnerSelfSeat, spec: TaskSpec, confi
|
|
|
192
194
|
* order. Whether it is still readable afterwards is the FACTORY's contract: each rung's
|
|
193
195
|
* factory-minted env is torn down at the end of that rung's run.
|
|
194
196
|
*
|
|
195
|
-
*
|
|
196
|
-
*
|
|
197
|
-
*
|
|
198
|
-
*
|
|
199
|
-
* object
|
|
197
|
+
* The design/380 O1② PLACEMENT delta, either way (present or absent): rung 0 is dispatched with a shallow
|
|
198
|
+
* copy whose `onWorkspaceResolved` first records the target rung 0's env reported, then calls the
|
|
199
|
+
* caller's own sink; rungs after the first land where the first rung landed — a fresh shallow copy
|
|
200
|
+
* carrying `placementRoot` = the fixed point that rung's result reports (`TaskResult.placementRoot`)
|
|
201
|
+
* unless the caller's object already resolves there (`placementRoot`, else `rootSessionId`: the
|
|
202
|
+
* ladder's fixed point), and `placementTarget` = that rung's target when it reported one (a later rung
|
|
203
|
+
* minted on another device is refused `config.placement_not_honored`).
|
|
204
|
+
*
|
|
205
|
+
* The COMPOSITION-LEG delta: when the caller's spec names its session (`spec.sessionId`, which no rung
|
|
206
|
+
* runs in — every rung is a cold re-run in its own), every rung is dispatched with a copy carrying
|
|
207
|
+
* `compositionLeg = { entry: "cascade", leg: <the rung's index>, hostSessionId: spec.sessionId }`, so a
|
|
208
|
+
* rung that durably parks files a card that says which rung it is and whose run it belongs to (the host
|
|
209
|
+
* links the card to its run by that session and hands it to {@link resumeCascade}). A spec that names
|
|
210
|
+
* no session mints none: such a rung's card cannot be linked to a composition.
|
|
211
|
+
*
|
|
212
|
+
* Every other field still rides by the same reference; a later rung with nothing to gain on any axis
|
|
213
|
+
* is dispatched with the caller's object itself (absent ⇒ `undefined`).
|
|
214
|
+
*/
|
|
215
|
+
internals?: RunInternals): Promise<CascadeRunResult>;
|
|
216
|
+
/**
|
|
217
|
+
* Continue a cascade from a rung's parked card, then climb the rest of the ladder: the resume entry beside {@link runCascade},
|
|
218
|
+
* as {@link import("./verify.js").resumeWithVerification} is beside its fresh-run entry. A rung that durably parks ends the
|
|
219
|
+
* ladder with `cascadeOutcome: "exhausted"` and the pause on `failed.nestedPause` — the host holds the token, and the card's
|
|
220
|
+
* `CheckpointState.compositionLeg` says which rung parked and which host session it belongs to. Once the pause is decided,
|
|
221
|
+
* the host calls this with the token, the outcome, the ORIGINAL task spec, the ladder config and that `compositionLeg` as the
|
|
222
|
+
* card records it.
|
|
223
|
+
*
|
|
224
|
+
* - **One door**: the parked rung is continued through `runner.resume(token, outcome, <rung config>, internals)` — the rung's
|
|
225
|
+
* config is the one {@link runCascade} derives for that rung (the task spec with the rung's model and overrides), minus the
|
|
226
|
+
* members a resume does not take (`objective`, `sessionId`, `userAttachments`, `runOrigin`); its internals carry
|
|
227
|
+
* `compositionLeg = parkedLeg`, so a card that records a different leg is refused before anything is consumed
|
|
228
|
+
* (`resume.composition_mismatch`, the card stays pending). The rung's placement fixed point and fence come back off the card
|
|
229
|
+
* inside the resumed rung's prepare; this entry neither reads nor re-supplies them. The rungs after it are placed at the fixed
|
|
230
|
+
* point the resumed rung reports.
|
|
231
|
+
* - **The resumed rung occupies its slot**: it continues the rung that parked, it is not a new escalation, so it is never
|
|
232
|
+
* refused by the escalation cap, the cost ceiling or the wall-clock budget, and the deadline does not cut it; it is run under
|
|
233
|
+
* the caller's `spec.signal` alone. Its result is gated exactly like a fresh rung: a pass ends the ladder `passed`, a fail
|
|
234
|
+
* escalates to the next rung, a re-park ends it again with that rung's own card. A resumed rung whose approved action never
|
|
235
|
+
* started (`resume.reopened_unstarted` / `resume.reopen_failed_unstarted`: the card is pending again, or its state unproven)
|
|
236
|
+
* is never escalated: the ladder ends there with its result as is, the session kept, and the same token resumes it again.
|
|
237
|
+
* - **Accounting covers this call**: `attempts` starts at the resumed rung (`index: parkedLeg.leg`), and the cumulative stats,
|
|
238
|
+
* the escalations counted against `maxEscalations`, the cost ceiling and `totalTimeoutMs` cover only the rungs this call
|
|
239
|
+
* dispatched. The resumed rung's stats are the engine's own report of that leg — never added to the stats of the call that
|
|
240
|
+
* parked it. A host that keeps one budget across a pause passes what is left of it.
|
|
241
|
+
*
|
|
242
|
+
* `parkedLeg` that is not a cascade leg of this ladder (another entry, a rung index outside the ladder, an empty host session)
|
|
243
|
+
* is refused before anything is dispatched (`config.cascade_invalid`); the checkpoint is untouched.
|
|
200
244
|
*/
|
|
245
|
+
export declare function resumeCascade(runner: RunnerSelfSeat, token: CheckpointToken, outcome: ResumeOutcome,
|
|
246
|
+
/** The ORIGINAL task spec the cascade ran (objective, attachments and run origin included): every rung after the resumed one
|
|
247
|
+
* is a cold re-run of it, and the resumed rung's config is derived from it. */
|
|
248
|
+
spec: TaskSpec, config: CascadeConfig,
|
|
249
|
+
/** The parked card's `CheckpointState.compositionLeg`, as the card records it. */
|
|
250
|
+
parkedLeg: CompositionLeg,
|
|
251
|
+
/** The trusted run-scoped internals channel, forwarded to every rung under the same contract as {@link runCascade}'s. */
|
|
201
252
|
internals?: RunInternals): Promise<CascadeRunResult>;
|
package/dist/agents/cascade.js
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { terminalProjection } from "../core/runner/terminal-projection.js";
|
|
2
2
|
import { releaseSession } from "./session-util.js";
|
|
3
|
-
import { mapNestedSuspend, isDurablePause } from "./suspend-guard.js";
|
|
3
|
+
import { mapNestedSuspend, isDurablePause, resumeNeverStarted } from "./suspend-guard.js";
|
|
4
4
|
import { buildCumulativeStats } from "./cumulative-stats.js";
|
|
5
5
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
6
|
+
import { compositionPlacement } from "./composition-placement.js";
|
|
6
7
|
import { thrownText } from "../core/thrown-value.js";
|
|
7
8
|
const CASCADE_ON_RUNG_SITE = "cascade.onRung";
|
|
8
9
|
const CASCADE_CONFIG_ERROR_CODE = "config.cascade_invalid";
|
|
@@ -21,15 +22,42 @@ function createDefaultGate(spec) {
|
|
|
21
22
|
return (result) => result.terminal.kind === "completed" && (!requiresStructured || result.structuredOutput !== undefined);
|
|
22
23
|
}
|
|
23
24
|
export async function runCascade(runner, spec, config, internals) {
|
|
25
|
+
const hostSessionId = spec.sessionId || undefined;
|
|
26
|
+
return climbLadder("runCascade", runner, spec, config, internals, { kind: "fresh", hostSessionId });
|
|
27
|
+
}
|
|
28
|
+
export async function resumeCascade(runner, token, outcome, spec, config, parkedLeg, internals) {
|
|
29
|
+
const ladderLength = config.ladder?.length ?? 0;
|
|
30
|
+
const leg = parkedLeg;
|
|
31
|
+
const entry = typeof leg === "object" && leg !== null ? Reflect.get(leg, "entry") : undefined;
|
|
32
|
+
const index = typeof leg === "object" && leg !== null ? Reflect.get(leg, "leg") : undefined;
|
|
33
|
+
const host = typeof leg === "object" && leg !== null ? Reflect.get(leg, "hostSessionId") : undefined;
|
|
34
|
+
if (ladderLength > 0 && (entry !== "cascade" || typeof index !== "number" || !Number.isInteger(index) || index < 0 || index >= ladderLength || typeof host !== "string" || host === "")) {
|
|
35
|
+
throw cascadeConfigError(`resumeCascade: parkedLeg must be the card's cascade leg of this ladder — { entry: "cascade", leg: <a rung index below ${ladderLength}>, hostSessionId: <a session> } (got ${describeParkedLeg(leg)}); nothing was resumed and the checkpoint is untouched.`);
|
|
36
|
+
}
|
|
37
|
+
return climbLadder("resumeCascade", runner, spec, config, internals, { kind: "resume", token, outcome, parked: { entry: "cascade", leg: index, hostSessionId: host } });
|
|
38
|
+
}
|
|
39
|
+
function describeParkedLeg(leg) {
|
|
40
|
+
if (typeof leg !== "object" || leg === null)
|
|
41
|
+
return typeof leg;
|
|
42
|
+
try {
|
|
43
|
+
return JSON.stringify({ entry: Reflect.get(leg, "entry"), leg: Reflect.get(leg, "leg"), hostSessionId: Reflect.get(leg, "hostSessionId") }) ?? "an unreadable object";
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
return "an unreadable object";
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
async function climbLadder(entryName, runner, spec, config, internals, opening) {
|
|
24
50
|
const ladder = config.ladder;
|
|
25
51
|
if (!ladder || ladder.length === 0) {
|
|
26
|
-
throw new Error(
|
|
52
|
+
throw new Error(`${entryName}: config.ladder must have at least one rung`);
|
|
27
53
|
}
|
|
28
54
|
const maxEscalations = config.maxEscalations ?? ladder.length - 1;
|
|
29
55
|
if (typeof maxEscalations !== "number" || !Number.isFinite(maxEscalations)) {
|
|
30
|
-
throw cascadeConfigError(
|
|
56
|
+
throw cascadeConfigError(`${entryName}: config.maxEscalations must be a finite number (got ${String(config.maxEscalations)}) — an unevaluable escalation ceiling is not a ceiling, and folding it to a default would run the cascade under a bound nobody chose.`);
|
|
31
57
|
}
|
|
32
|
-
const
|
|
58
|
+
const start = opening.kind === "resume" ? opening.parked.leg : 0;
|
|
59
|
+
const maxRungs = Math.min(ladder.length, start + Math.max(0, maxEscalations) + 1);
|
|
60
|
+
const hostSessionId = opening.kind === "resume" ? opening.parked.hostSessionId : opening.hostSessionId;
|
|
33
61
|
const gate = config.gate ?? createDefaultGate(spec);
|
|
34
62
|
const startedAt = Date.now();
|
|
35
63
|
const deadlineAt = config.totalTimeoutMs != null ? startedAt + config.totalTimeoutMs : undefined;
|
|
@@ -65,43 +93,56 @@ export async function runCascade(runner, spec, config, internals) {
|
|
|
65
93
|
});
|
|
66
94
|
let lastResult;
|
|
67
95
|
let passedRung = -1;
|
|
68
|
-
let
|
|
96
|
+
let firstLegResult;
|
|
97
|
+
let finalRung = -1;
|
|
98
|
+
const placement = compositionPlacement(internals);
|
|
69
99
|
const { sessionId: _drop, ...specBase } = spec;
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
100
|
+
const rungSpecOf = (rung, signal) => ({ ...specBase, model: rung.model, ...(rung.overrides ?? {}), ...(signal ? { signal } : {}) });
|
|
101
|
+
const resumeConfigOf = (task) => {
|
|
102
|
+
const { objective: _objective, userAttachments: _attachments, runOrigin: _origin, ...config } = task;
|
|
103
|
+
return config;
|
|
104
|
+
};
|
|
105
|
+
const legOf = (i) => (hostSessionId === undefined ? undefined : { entry: "cascade", leg: i, hostSessionId });
|
|
106
|
+
for (let i = start; i < maxRungs; i++) {
|
|
107
|
+
const resumed = opening.kind === "resume" && i === start ? opening : undefined;
|
|
108
|
+
if (resumed === undefined) {
|
|
109
|
+
if (deadlineAt !== undefined && Date.now() >= deadlineAt)
|
|
110
|
+
break;
|
|
111
|
+
if (i > start && config.costCeilingMicroUsd != null && (totalCost >= config.costCeilingMicroUsd || !ceilingCostKnown)) {
|
|
112
|
+
break;
|
|
113
|
+
}
|
|
75
114
|
}
|
|
76
115
|
const rung = ladder[i];
|
|
77
116
|
let deadlineFired = false;
|
|
78
117
|
const rungAbort = new AbortController();
|
|
79
118
|
let deadlineTimer;
|
|
80
|
-
if (deadlineAt !== undefined) {
|
|
119
|
+
if (deadlineAt !== undefined && resumed === undefined) {
|
|
81
120
|
deadlineTimer = setTimeout(() => {
|
|
82
121
|
deadlineFired = true;
|
|
83
|
-
rungAbort.abort(new Error(
|
|
122
|
+
rungAbort.abort(new Error(`${entryName}: totalTimeoutMs (${config.totalTimeoutMs}ms) reached`));
|
|
84
123
|
}, Math.max(0, deadlineAt - Date.now()));
|
|
85
124
|
deadlineTimer.unref?.();
|
|
86
125
|
}
|
|
87
|
-
const rungSignal =
|
|
126
|
+
const rungSignal = deadlineTimer === undefined
|
|
88
127
|
? specBase.signal
|
|
89
128
|
: specBase.signal
|
|
90
129
|
? AbortSignal.any([specBase.signal, rungAbort.signal])
|
|
91
130
|
: rungAbort.signal;
|
|
92
131
|
let result;
|
|
93
|
-
const
|
|
94
|
-
|
|
95
|
-
|
|
132
|
+
const placed = firstLegResult === undefined ? placement.firstLeg : placement.laterLeg(firstLegResult);
|
|
133
|
+
const compositionLeg = resumed !== undefined ? resumed.parked : legOf(i);
|
|
134
|
+
const rungInternals = compositionLeg === undefined ? placed : { ...placed, compositionLeg };
|
|
135
|
+
const rungTask = rungSpecOf(rung, rungSignal);
|
|
96
136
|
try {
|
|
97
|
-
result = await runner.
|
|
137
|
+
result = resumed !== undefined ? await runner.resume(resumed.token, resumed.outcome, resumeConfigOf(rungTask), rungInternals) : await runner.runTask(rungTask, rungInternals);
|
|
98
138
|
}
|
|
99
139
|
finally {
|
|
100
140
|
if (deadlineTimer !== undefined)
|
|
101
141
|
clearTimeout(deadlineTimer);
|
|
102
142
|
}
|
|
103
143
|
lastResult = result;
|
|
104
|
-
|
|
144
|
+
finalRung = i;
|
|
145
|
+
firstLegResult ??= result;
|
|
105
146
|
const s = result.stats;
|
|
106
147
|
const rungCostKnown = s.costMicroUsd !== undefined && (s.nested === undefined || s.nested.costMicroUsd !== undefined);
|
|
107
148
|
const rungCost = rungCostKnown ? (s.costMicroUsd ?? 0) + (s.nested?.costMicroUsd ?? 0) : undefined;
|
|
@@ -136,7 +177,7 @@ export async function runCascade(runner, spec, config, internals) {
|
|
|
136
177
|
nestedTasks += s.nested.tasks;
|
|
137
178
|
nestedCostMicro += s.nested.costMicroUsd ?? 0;
|
|
138
179
|
}
|
|
139
|
-
if (isDurablePause(result.terminal)) {
|
|
180
|
+
if (isDurablePause(result.terminal) || resumeNeverStarted(result)) {
|
|
140
181
|
const mapped = mapNestedSuspend(result);
|
|
141
182
|
attempts.push({ index: i, model: rung.model, passed: false, costMicroUsd: rungCost, status: attemptTerminal(result).status, errorCode: attemptTerminal(mapped).errorCode });
|
|
142
183
|
return {
|
|
@@ -216,7 +257,6 @@ export async function runCascade(runner, spec, config, internals) {
|
|
|
216
257
|
};
|
|
217
258
|
}
|
|
218
259
|
const base = lastResult;
|
|
219
|
-
const finalRung = attempts.length - 1;
|
|
220
260
|
return {
|
|
221
261
|
...base,
|
|
222
262
|
stats: cumulativeStats(base.stats),
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { TaskSpec } from "../core/types.js";
|
|
2
|
+
/**
|
|
3
|
+
* The allowance a composition's later legs run on. A composition that dispatches several legs of ONE task — the
|
|
4
|
+
* verification gate's implementation and fix legs, the repair loop's attempts — spends from one account: every leg after
|
|
5
|
+
* the first is dispatched with what the task's WHOLE-TASK ceilings have left after the legs before it, so the caller's
|
|
6
|
+
* ceiling bounds the task, not each leg of it. One rule, read the same by every such composition:
|
|
7
|
+
* · the whole-task ceilings are `resourceSuspend.totalBudgetUsd` / `totalTokens` on a task that opted into resource
|
|
8
|
+
* suspension (its `limits` windows pace each slice, and each leg opens one exactly as a resume does), and
|
|
9
|
+
* `limits.maxCostUsd` / `maxTokens` / `maxTurns` otherwise (a task that cannot suspend runs one slice, so its window is
|
|
10
|
+
* the whole task's);
|
|
11
|
+
* · what the legs spent is their OWN reported spend — the figures the engine's limit gate reads on each leg (delegated
|
|
12
|
+
* children's spend stays on their own axis, as it does there);
|
|
13
|
+
* · an axis with nothing left dispatches no further leg: the composition stops where its own ceilings stop it, and says
|
|
14
|
+
* which axis (`AllowanceExhausted`) — it never mints a leg's terminal for a leg that did not run.
|
|
15
|
+
* The engine is not involved: the later leg's spec carries the figure, so the engine judges that leg exactly as it judges
|
|
16
|
+
* any run, and a leg that durably parks freezes the figure on its first slice's ledger. The account is the one call's: the
|
|
17
|
+
* ceilings are the ones this call was handed and the spend is what its legs reported, so across a durable pause it does
|
|
18
|
+
* not see the parking call's other legs or the totals frozen on the checkpoint (`docs/KNOWN-LIMITS.md` KL-3170-c, closed by #3176).
|
|
19
|
+
*/
|
|
20
|
+
/** The whole-task axes a composition's legs share. */
|
|
21
|
+
export type AllowanceAxis = "cost" | "tokens" | "turns";
|
|
22
|
+
/** What a composition's legs spent so far, from their own reports. `costMicroUsd` is undefined once any leg was unpriced. */
|
|
23
|
+
export interface CompositionSpend {
|
|
24
|
+
readonly costMicroUsd: number | undefined;
|
|
25
|
+
readonly tokens: number;
|
|
26
|
+
readonly turns: number;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* A whole-task axis with nothing left, so the composition dispatched no further leg. `remaining` is in the axis's own unit
|
|
30
|
+
* (micro-USD for `cost`, tokens, turns) and is `0` once the legs spent the ceiling; it is absent when the spend on the axis
|
|
31
|
+
* cannot be known (a leg ran unpriced under a cost ceiling; a reported figure that is NaN, infinite or negative, on any
|
|
32
|
+
* axis), which is never read as room to spend.
|
|
33
|
+
*/
|
|
34
|
+
export interface AllowanceExhausted {
|
|
35
|
+
readonly axis: AllowanceAxis;
|
|
36
|
+
readonly remaining?: number;
|
|
37
|
+
}
|
|
38
|
+
/** A later leg's dispatch: the spec carrying what is left, or the axis with nothing left. */
|
|
39
|
+
export type LaterLegAllowance<S> = {
|
|
40
|
+
readonly spec: S;
|
|
41
|
+
readonly exhausted?: undefined;
|
|
42
|
+
} | {
|
|
43
|
+
readonly spec?: undefined;
|
|
44
|
+
readonly exhausted: AllowanceExhausted;
|
|
45
|
+
};
|
|
46
|
+
type AllowanceSpec = Pick<TaskSpec, "limits" | "resourceSuspend">;
|
|
47
|
+
/**
|
|
48
|
+
* The spec a composition's later leg is dispatched with, given the caller's spec and what the legs before it spent. Every
|
|
49
|
+
* armed whole-task ceiling is replaced by what is left of it; nothing armed ⇒ the caller's spec itself (the same object).
|
|
50
|
+
* The attribution order when several axes are spent is the engine's own: tokens, then cost, then turns.
|
|
51
|
+
*/
|
|
52
|
+
export declare function laterLegAllowance<S extends AllowanceSpec>(spec: S, spent: CompositionSpend): LaterLegAllowance<S>;
|
|
53
|
+
export {};
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
export function laterLegAllowance(spec, spent) {
|
|
2
|
+
const suspendable = spec.resourceSuspend !== undefined;
|
|
3
|
+
const ceiling = (v) => (v !== undefined && Number.isFinite(v) ? v : undefined);
|
|
4
|
+
const costCeiling = ceiling(suspendable ? spec.resourceSuspend?.totalBudgetUsd : spec.limits?.maxCostUsd);
|
|
5
|
+
const tokenCeiling = ceiling(suspendable ? spec.resourceSuspend?.totalTokens : spec.limits?.maxTokens);
|
|
6
|
+
const turnCeiling = suspendable || spec.limits?.maxTurns === 0 ? undefined : ceiling(spec.limits?.maxTurns);
|
|
7
|
+
const known = (v) => v !== undefined && Number.isFinite(v) && v >= 0;
|
|
8
|
+
if (tokenCeiling !== undefined && !known(spent.tokens))
|
|
9
|
+
return { exhausted: { axis: "tokens" } };
|
|
10
|
+
const tokensLeft = tokenCeiling === undefined ? undefined : tokenCeiling - spent.tokens;
|
|
11
|
+
if (tokensLeft !== undefined && tokensLeft <= 0)
|
|
12
|
+
return { exhausted: { axis: "tokens", remaining: 0 } };
|
|
13
|
+
if (costCeiling !== undefined && !known(spent.costMicroUsd))
|
|
14
|
+
return { exhausted: { axis: "cost" } };
|
|
15
|
+
const costLeftMicroUsd = costCeiling === undefined ? undefined : Math.round(costCeiling * 1e6) - (spent.costMicroUsd ?? 0);
|
|
16
|
+
if (costLeftMicroUsd !== undefined && costLeftMicroUsd <= 0)
|
|
17
|
+
return { exhausted: { axis: "cost", remaining: 0 } };
|
|
18
|
+
if (turnCeiling !== undefined && !known(spent.turns))
|
|
19
|
+
return { exhausted: { axis: "turns" } };
|
|
20
|
+
const turnsLeft = turnCeiling === undefined ? undefined : turnCeiling - spent.turns;
|
|
21
|
+
if (turnsLeft !== undefined && turnsLeft <= 0)
|
|
22
|
+
return { exhausted: { axis: "turns", remaining: 0 } };
|
|
23
|
+
if (tokensLeft === undefined && costLeftMicroUsd === undefined && turnsLeft === undefined)
|
|
24
|
+
return { spec };
|
|
25
|
+
const totals = spec.resourceSuspend;
|
|
26
|
+
if (totals !== undefined) {
|
|
27
|
+
return {
|
|
28
|
+
spec: {
|
|
29
|
+
...spec,
|
|
30
|
+
resourceSuspend: {
|
|
31
|
+
...totals,
|
|
32
|
+
...(costLeftMicroUsd !== undefined ? { totalBudgetUsd: costLeftMicroUsd / 1e6 } : {}),
|
|
33
|
+
...(tokensLeft !== undefined ? { totalTokens: tokensLeft } : {}),
|
|
34
|
+
},
|
|
35
|
+
},
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
return {
|
|
39
|
+
spec: {
|
|
40
|
+
...spec,
|
|
41
|
+
limits: {
|
|
42
|
+
...spec.limits,
|
|
43
|
+
...(costLeftMicroUsd !== undefined ? { maxCostUsd: costLeftMicroUsd / 1e6 } : {}),
|
|
44
|
+
...(tokensLeft !== undefined ? { maxTokens: tokensLeft } : {}),
|
|
45
|
+
...(turnsLeft !== undefined ? { maxTurns: turnsLeft } : {}),
|
|
46
|
+
},
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { RunInternals } from "../core/runner/contracts.js";
|
|
2
|
+
import type { TaskResult } from "../core/types.js";
|
|
3
|
+
/**
|
|
4
|
+
* Where a composition entry places the legs it drives after the first — a cascade's rungs after the first it drives, a
|
|
5
|
+
* verification gate's verifier and fix legs. They are ONE piece of work, so each later leg is placed where the FIRST leg ran, on
|
|
6
|
+
* both axes a target-bound env factory reads:
|
|
7
|
+
* · the tree's fixed point (`RunInternals.placementRoot`): every later leg lands where the first leg landed — the first leg's
|
|
8
|
+
* own report of the fixed point its prepare resolved (`TaskResult.placementRoot`). It is minted into the copy unless the
|
|
9
|
+
* caller's object already resolves there by prepare's fold (`placementRoot`, else `rootSessionId`); on a fresh entry it
|
|
10
|
+
* always does whenever the caller carries a fixed point, so that caller's object rides unchanged. The first leg is the one
|
|
11
|
+
* the entry drove first: a resume entry's resumed leg reports the fixed point its parked row recorded, which outranks a
|
|
12
|
+
* supplied `rootSessionId` there, so a caller whose `rootSessionId` names another session still sees every leg after it land
|
|
13
|
+
* where the composition's work was placed, not at that session or the resumed leg's own. A first leg that reported none (a
|
|
14
|
+
* result no run assembled) mints none — the same law as the target below;
|
|
15
|
+
* · the target (`RunInternals.placementTarget`): what the first leg's environment reported as its workspace settled, learned
|
|
16
|
+
* through the trusted `onWorkspaceResolved` seat — the first leg is dispatched with a shallow copy whose sink records it
|
|
17
|
+
* before handing the payload to the caller's own sink, if any. A later leg whose env does not name the device the first leg's
|
|
18
|
+
* did is refused (`config.placement_not_honored`): a re-bind mid-composition moves no later leg onto another device. A first
|
|
19
|
+
* leg that reported no target leaves the caller's own `placementTarget` (if any) riding by reference.
|
|
20
|
+
* Every other field of the caller's object rides every leg by the caller's reference; the caller's object is never mutated, and
|
|
21
|
+
* a later leg with nothing to gain on either axis is dispatched with the caller's object itself.
|
|
22
|
+
*/
|
|
23
|
+
export interface CompositionPlacement {
|
|
24
|
+
/** The internals the first leg is dispatched with: a copy whose `onWorkspaceResolved` records the leg's own target. */
|
|
25
|
+
readonly firstLeg: RunInternals;
|
|
26
|
+
/** The internals a later leg is dispatched with, given the first leg's result (its self-reported fixed point). */
|
|
27
|
+
laterLeg(firstLeg: Pick<TaskResult, "placementRoot">): RunInternals | undefined;
|
|
28
|
+
}
|
|
29
|
+
export declare function compositionPlacement(internals: RunInternals | undefined): CompositionPlacement;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
export function compositionPlacement(internals) {
|
|
2
|
+
let observed = false;
|
|
3
|
+
let firstTarget;
|
|
4
|
+
const firstLeg = {
|
|
5
|
+
...internals,
|
|
6
|
+
onWorkspaceResolved: (workspace) => {
|
|
7
|
+
if (!observed) {
|
|
8
|
+
observed = true;
|
|
9
|
+
firstTarget = workspace.target;
|
|
10
|
+
}
|
|
11
|
+
internals?.onWorkspaceResolved?.(workspace);
|
|
12
|
+
},
|
|
13
|
+
};
|
|
14
|
+
return {
|
|
15
|
+
firstLeg,
|
|
16
|
+
laterLeg(first) {
|
|
17
|
+
const landed = first.placementRoot;
|
|
18
|
+
const root = landed !== undefined && (internals?.placementRoot ?? internals?.rootSessionId) !== landed ? landed : undefined;
|
|
19
|
+
if (root === undefined && firstTarget === undefined)
|
|
20
|
+
return internals;
|
|
21
|
+
return { ...internals, ...(root !== undefined ? { placementRoot: root } : {}), ...(firstTarget !== undefined ? { placementTarget: firstTarget } : {}) };
|
|
22
|
+
},
|
|
23
|
+
};
|
|
24
|
+
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { TaskResult } from "../core/types.js";
|
|
2
|
+
import type { CompositionSpend } from "./composition-allowance.js";
|
|
2
3
|
/**
|
|
3
4
|
* Shared CUMULATIVE-STATS constructor for the multi-leg agent compositions (cascade rungs, repair-loop
|
|
4
5
|
* attempts, verify legs). Each runs `runner.runTask` MORE THAN ONCE and must report the OPERATION's totals,
|
|
@@ -95,6 +96,9 @@ export interface CumulativeStatsTracker {
|
|
|
95
96
|
* would rewrite a caller's object (0 → `undefined` normalization, a re-derived `cacheHitRate`) for no
|
|
96
97
|
* gain. */
|
|
97
98
|
readonly legs: number;
|
|
99
|
+
/** The legs' OWN spend so far, on the axes a later leg's allowance is cut from (`./composition-allowance.ts`); the cost is
|
|
100
|
+
* undefined once any leg was unpriced. */
|
|
101
|
+
spend(): CompositionSpend;
|
|
98
102
|
}
|
|
99
103
|
/**
|
|
100
104
|
* Create a {@link CumulativeStatsTracker}.
|
|
@@ -83,5 +83,8 @@ export function createCumulativeStatsTracker() {
|
|
|
83
83
|
build(base) {
|
|
84
84
|
return buildCumulativeStats(base, acc);
|
|
85
85
|
},
|
|
86
|
+
spend() {
|
|
87
|
+
return { costMicroUsd: acc.anyLegUnpriced ? undefined : acc.costMicroUsd, tokens: acc.tokens, turns: acc.turns };
|
|
88
|
+
},
|
|
86
89
|
};
|
|
87
90
|
}
|
|
@@ -36,9 +36,11 @@ export declare function inheritedMcpDeclarations(mounted: MountedMcp, selector:
|
|
|
36
36
|
* host-transport servers among the child's declarations (`servers`), as the child's internals carry them — none ⇒ no member, so such a server
|
|
37
37
|
* of the child fails its dial like any declaration without a seat. */
|
|
38
38
|
export declare function inheritedHostSeats(held: ReadonlyMap<string, McpHostSeat> | undefined, servers: ReadonlyArray<McpServerSpec>): Pick<RunInternals, "mcpHostSeats">;
|
|
39
|
-
/** A child's internals as a retained snapshot keeps them: without
|
|
40
|
-
*
|
|
41
|
-
|
|
39
|
+
/** A child's internals as a retained snapshot keeps them: without the seats that belong to whoever wakes it — the host seats (live objects of
|
|
40
|
+
* the run that held them), the placement fence (the target of the leg that spawned it) and the objective's author (who wrote the spawn's
|
|
41
|
+
* prompt). Each wake hands the waker's own: its seats ({@link inheritedHostSeats} over the waker's mount), its target, so a woken agent is
|
|
42
|
+
* minted where its waker is — the same answer a tier-3 revival of that agent gets — and its author, since every resume states who wrote it. */
|
|
43
|
+
export declare function withoutWakerSeats(internals: RunInternals): RunInternals;
|
|
42
44
|
/**
|
|
43
45
|
* The MCP servers a leg spawned as an agent definition is declared ({@link AgentDefinition.mcp}): the servers its lane hands it (the
|
|
44
46
|
* spawning run's it inherits, a workflow child's governed spec's) first, then each of the definition's own whose tool namespace none of
|
|
@@ -22,8 +22,8 @@ export function inheritedHostSeats(held, servers) {
|
|
|
22
22
|
});
|
|
23
23
|
return seats.length > 0 ? { mcpHostSeats: new Map(seats) } : {};
|
|
24
24
|
}
|
|
25
|
-
export function
|
|
26
|
-
const { mcpHostSeats: _live, ...kept } = internals;
|
|
25
|
+
export function withoutWakerSeats(internals) {
|
|
26
|
+
const { mcpHostSeats: _live, placementTarget: _spawnersTarget, objectiveAuthor: _spawnAuthor, ...kept } = internals;
|
|
27
27
|
return kept;
|
|
28
28
|
}
|
|
29
29
|
export function withDefinitionServers(handed, own) {
|
|
@@ -101,7 +101,7 @@ export interface ListAgentsRow {
|
|
|
101
101
|
* COMPLETED and nothing else: a model applies the continuable rule to that word. */
|
|
102
102
|
state: "busy" | "idle" | "offline" | "running" | "parked" | "finished" | "failed" | "killed" | "cancelled" | "unknown";
|
|
103
103
|
/** Agent lanes with a live registry row: the agent's current state
|
|
104
|
-
* ({@link import("../core/agent-state.js").readAgentState}, the one reading AgentTranscript and
|
|
104
|
+
* ({@link import("../core/agent-state.js").readAgentState}, the one reading AgentTranscript and the host task poll
|
|
105
105
|
* render too); {@link state} is this status word through the lane table. Absent on peer rows and on a
|
|
106
106
|
* roster row with no live row. */
|
|
107
107
|
agentState?: AgentState;
|
|
@@ -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;
|