@sema-agent/core 7.66.1 → 7.67.1
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 +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -1,15 +1,47 @@
|
|
|
1
|
+
import { cacheHitOperandsOf } from "../core/runner/cache-hit-account.js";
|
|
2
|
+
const USAGE_SUM_KEYS = ["promptTokens", "totalInputTokens", "cachedTokens", "outputTokens", "cacheWriteTokens", "cacheWriteTokensLong"];
|
|
3
|
+
export function emptyCumulativeUsageFacts() {
|
|
4
|
+
return { published: new Set(), usageMissing: false, cacheReadUnreported: false, cacheWriteUnreported: false, cacheHitRateExcludes: new Map(), rateNumeratorShort: false };
|
|
5
|
+
}
|
|
6
|
+
export function foldUsageFacts(facts, s) {
|
|
7
|
+
for (const k of USAGE_SUM_KEYS)
|
|
8
|
+
if (typeof s[k] === "number")
|
|
9
|
+
facts.published.add(k);
|
|
10
|
+
if (typeof s.totalInputTokens === "number" && typeof s.cachedTokens !== "number")
|
|
11
|
+
facts.rateNumeratorShort = true;
|
|
12
|
+
if (s.usageMissing === true)
|
|
13
|
+
facts.usageMissing = true;
|
|
14
|
+
if (s.cacheReadUnreported === true)
|
|
15
|
+
facts.cacheReadUnreported = true;
|
|
16
|
+
if (s.cacheWriteUnreported === true)
|
|
17
|
+
facts.cacheWriteUnreported = true;
|
|
18
|
+
for (const e of s.cacheHitRateExcludes ?? []) {
|
|
19
|
+
const merged = facts.cacheHitRateExcludes.get(e.lane) ?? { cachedTokens: 0, totalInputTokens: 0 };
|
|
20
|
+
merged.cachedTokens += e.cachedTokens;
|
|
21
|
+
merged.totalInputTokens += e.totalInputTokens;
|
|
22
|
+
facts.cacheHitRateExcludes.set(e.lane, merged);
|
|
23
|
+
}
|
|
24
|
+
}
|
|
1
25
|
export function buildCumulativeStats(base, acc) {
|
|
26
|
+
const facts = acc.usageFacts;
|
|
27
|
+
const sum = (k) => (facts.published.has(k) ? acc[k] : undefined);
|
|
28
|
+
const excludes = [...facts.cacheHitRateExcludes].map(([lane, e]) => ({ lane, cachedTokens: e.cachedTokens, totalInputTokens: e.totalInputTokens }));
|
|
29
|
+
const operands = cacheHitOperandsOf(acc, excludes);
|
|
2
30
|
return {
|
|
3
31
|
...base,
|
|
4
32
|
tokens: acc.tokens,
|
|
5
33
|
turns: acc.turns,
|
|
6
|
-
promptTokens:
|
|
7
|
-
totalInputTokens:
|
|
8
|
-
cachedTokens:
|
|
9
|
-
outputTokens:
|
|
10
|
-
cacheWriteTokens:
|
|
11
|
-
cacheWriteTokensLong:
|
|
12
|
-
cacheHitRate:
|
|
34
|
+
promptTokens: sum("promptTokens"),
|
|
35
|
+
totalInputTokens: sum("totalInputTokens"),
|
|
36
|
+
cachedTokens: sum("cachedTokens"),
|
|
37
|
+
outputTokens: sum("outputTokens"),
|
|
38
|
+
cacheWriteTokens: sum("cacheWriteTokens"),
|
|
39
|
+
cacheWriteTokensLong: sum("cacheWriteTokensLong"),
|
|
40
|
+
cacheHitRate: !facts.rateNumeratorShort && operands.totalInputTokens > 0 ? Math.min(1, operands.cachedTokens / operands.totalInputTokens) : undefined,
|
|
41
|
+
cacheHitRateExcludes: excludes.length > 0 ? excludes : undefined,
|
|
42
|
+
usageMissing: facts.usageMissing ? true : undefined,
|
|
43
|
+
cacheReadUnreported: facts.cacheReadUnreported ? true : undefined,
|
|
44
|
+
cacheWriteUnreported: facts.cacheWriteUnreported ? true : undefined,
|
|
13
45
|
costMicroUsd: acc.anyLegUnpriced ? undefined : acc.costMicroUsd,
|
|
14
46
|
nested: acc.nested.tokens > 0 || acc.nested.tasks > 0
|
|
15
47
|
? { tokens: acc.nested.tokens, turns: acc.nested.turns, tasks: acc.nested.tasks, costMicroUsd: acc.nested.costMicroUsd || undefined }
|
|
@@ -22,7 +54,7 @@ export function buildCumulativeStats(base, acc) {
|
|
|
22
54
|
compactionMicroUsd: acc.compactionMicroUsd,
|
|
23
55
|
...(acc.sideCallMicroUsd !== undefined ? { sideCallMicroUsd: acc.sideCallMicroUsd } : {}),
|
|
24
56
|
},
|
|
25
|
-
humanReview: acc.humanReview.
|
|
57
|
+
humanReview: acc.humanReview.kept
|
|
26
58
|
? { count: acc.humanReview.count, totalWaitMs: acc.humanReview.totalWaitMs, gates: acc.humanReview.gates }
|
|
27
59
|
: undefined,
|
|
28
60
|
};
|
|
@@ -43,7 +75,8 @@ export function createCumulativeStatsTracker() {
|
|
|
43
75
|
llmRootMicroUsd: 0,
|
|
44
76
|
compactionMicroUsd: 0,
|
|
45
77
|
nested: { tokens: 0, turns: 0, tasks: 0, costMicroUsd: 0 },
|
|
46
|
-
humanReview: { count: 0, totalWaitMs: 0, gates: [] },
|
|
78
|
+
humanReview: { kept: false, count: 0, totalWaitMs: 0, gates: [] },
|
|
79
|
+
usageFacts: emptyCumulativeUsageFacts(),
|
|
47
80
|
};
|
|
48
81
|
return {
|
|
49
82
|
get legs() {
|
|
@@ -59,6 +92,7 @@ export function createCumulativeStatsTracker() {
|
|
|
59
92
|
acc.outputTokens += s.outputTokens ?? 0;
|
|
60
93
|
acc.cacheWriteTokens += s.cacheWriteTokens ?? 0;
|
|
61
94
|
acc.cacheWriteTokensLong += s.cacheWriteTokensLong ?? 0;
|
|
95
|
+
foldUsageFacts(acc.usageFacts, s);
|
|
62
96
|
acc.costMicroUsd += s.costMicroUsd ?? 0;
|
|
63
97
|
if (s.costMicroUsd === undefined)
|
|
64
98
|
acc.anyLegUnpriced = true;
|
|
@@ -69,6 +103,7 @@ export function createCumulativeStatsTracker() {
|
|
|
69
103
|
acc.sideCallMicroUsd = (acc.sideCallMicroUsd ?? 0) + s.costBreakdown.sideCallMicroUsd;
|
|
70
104
|
}
|
|
71
105
|
if (s.humanReview) {
|
|
106
|
+
acc.humanReview.kept = true;
|
|
72
107
|
acc.humanReview.count += s.humanReview.count;
|
|
73
108
|
acc.humanReview.totalWaitMs += s.humanReview.totalWaitMs;
|
|
74
109
|
acc.humanReview.gates.push(...s.humanReview.gates);
|
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
import { defaultTaskRegistry } from "../core/task-registry.js";
|
|
2
|
+
import { codedRefusal } from "../core/thrown-value.js";
|
|
2
3
|
export function delegationRegistryOf(ctx, bag) {
|
|
3
4
|
if (bag === undefined)
|
|
4
5
|
return undefined;
|
|
5
6
|
const seat = ctx.taskRegistry;
|
|
6
7
|
const option = bag.registry;
|
|
7
8
|
if (seat !== undefined && option !== undefined && option !== seat) {
|
|
8
|
-
|
|
9
|
-
e.code = "config.invalid_task_registry";
|
|
10
|
-
throw e;
|
|
9
|
+
throw codedRefusal("config.invalid_task_registry", "background.registry is not the registry this run reads (its leg end, TaskStop and teardown read the run's own task registry) — leave the option unset inside a Runner task and the run's registry rides, or wire that one registry.");
|
|
11
10
|
}
|
|
12
11
|
return seat ?? option ?? defaultTaskRegistry;
|
|
13
12
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { AgentDefinition, McpServerSpec, ToolSpec } from "../core/types.js";
|
|
2
|
-
import type { ToolSelector } from "../core/tool-face.js";
|
|
2
|
+
import type { ToolSelector, ToolSelectorLayer } from "../core/tool-face.js";
|
|
3
3
|
import type { MountedMcp } from "../core/mounted-mcp.js";
|
|
4
4
|
import type { McpHostSeat } from "../core/mcp-host-seat.js";
|
|
5
5
|
import type { RunInternals } from "../core/runner/contracts.js";
|
|
@@ -37,9 +37,10 @@ export declare function inheritedMcpDeclarations(mounted: MountedMcp, selector:
|
|
|
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
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)
|
|
41
|
-
* prompt)
|
|
42
|
-
*
|
|
40
|
+
* the run that held them), the placement fence (the target of the leg that spawned it), the objective's author (who wrote the spawn's
|
|
41
|
+
* prompt) and the activity seat (the spawner's, a closure over its row). Each wake hands the waker's own: its seats
|
|
42
|
+
* ({@link inheritedHostSeats} over the waker's mount), its target, so a woken agent is minted where its waker is — the same answer a
|
|
43
|
+
* tier-3 revival of that agent gets — its author, since every resume states who wrote it, and the activity seat of the row it wakes. */
|
|
43
44
|
export declare function withoutWakerSeats(internals: RunInternals): RunInternals;
|
|
44
45
|
/**
|
|
45
46
|
* The MCP servers a leg spawned as an agent definition is declared ({@link AgentDefinition.mcp}): the servers its lane hands it (the
|
|
@@ -57,3 +58,7 @@ export declare function withDefinitionServers<S extends {
|
|
|
57
58
|
* No list (absent or `null`) stays no list.
|
|
58
59
|
*/
|
|
59
60
|
export declare function definitionAllowTools(def: Pick<AgentDefinition, "allowTools" | "mcp">): string[] | undefined;
|
|
61
|
+
/** THE selector layer a pair of governing lists makes, as frozen copies (`null` reads as absent); both are lists the spawn's check already read. */
|
|
62
|
+
export declare function selectorLayerOf(allow: readonly string[] | null | undefined, deny: readonly string[] | null | undefined): ToolSelectorLayer;
|
|
63
|
+
/** THE layer a definition's lists make for the leg launched as it (a delegated child's own, a workflow agent's definition layer). */
|
|
64
|
+
export declare function definitionSelectorLayer(def: Pick<AgentDefinition, "allowTools" | "denyTools" | "mcp">): ToolSelectorLayer;
|
|
@@ -23,7 +23,7 @@ export function inheritedHostSeats(held, servers) {
|
|
|
23
23
|
return seats.length > 0 ? { mcpHostSeats: new Map(seats) } : {};
|
|
24
24
|
}
|
|
25
25
|
export function withoutWakerSeats(internals) {
|
|
26
|
-
const { mcpHostSeats: _live, placementTarget: _spawnersTarget, objectiveAuthor: _spawnAuthor, ...kept } = internals;
|
|
26
|
+
const { mcpHostSeats: _live, placementTarget: _spawnersTarget, objectiveAuthor: _spawnAuthor, onSubtreeActivity: _spawnersActivity, ...kept } = internals;
|
|
27
27
|
return kept;
|
|
28
28
|
}
|
|
29
29
|
export function withDefinitionServers(handed, own) {
|
|
@@ -36,3 +36,9 @@ export function definitionAllowTools(def) {
|
|
|
36
36
|
return written;
|
|
37
37
|
return [...written, ...def.mcp.map((s) => `${mintNamespacePrefix(MCP_NAMESPACE, s.name)}*`)];
|
|
38
38
|
}
|
|
39
|
+
export function selectorLayerOf(allow, deny) {
|
|
40
|
+
return Object.freeze({ ...(allow != null ? { allow: Object.freeze([...allow]) } : {}), deny: Object.freeze([...(deny ?? [])]) });
|
|
41
|
+
}
|
|
42
|
+
export function definitionSelectorLayer(def) {
|
|
43
|
+
return selectorLayerOf(definitionAllowTools(def), def.denyTools);
|
|
44
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The one LEG LABEL binder the compositions dispatch their legs through (the verify gate, the cascade).
|
|
3
|
+
*
|
|
4
|
+
* `RunInternals.onLegFrame` is handed every frame a drained leg offers, with the leg's address; the engine knows nothing
|
|
5
|
+
* about a composition's legs, so it never puts a label on that address — stamping one would be reading a fact off a run
|
|
6
|
+
* it cannot see. The dispatching composition knows, and is the only thing that does, so it says so the one way that
|
|
7
|
+
* cannot be forged: a per-dispatch copy of the internals whose seat closes over the label of the leg being dispatched
|
|
8
|
+
* with it. Nothing a caller can put ON the object produces a label, and a leg nobody labelled arrives without one —
|
|
9
|
+
* which is the honest reading of an unlabelled leg.
|
|
10
|
+
*/
|
|
11
|
+
import type { RunInternals } from "../core/runner/contracts.js";
|
|
12
|
+
import { type LegFrameEntry, type LegLabel } from "../core/runner/leg-frame.js";
|
|
13
|
+
/**
|
|
14
|
+
* Bind THIS leg's label into the caller's drained-leg frame seat, for one dispatch.
|
|
15
|
+
*
|
|
16
|
+
* The copy is made ONLY when the caller actually wired the seat, so a composition whose caller wired nothing dispatches
|
|
17
|
+
* exactly the object it dispatched before (identity forwarding, unchanged). When it is made, every other field still
|
|
18
|
+
* rides by the caller's own reference and the caller's object is never mutated — the same rule as the placement fixed
|
|
19
|
+
* point's copy, whose result this wraps.
|
|
20
|
+
*
|
|
21
|
+
* The caller's object is judged first, by the door's own judgment of a hidden seat ({@link refuseHiddenLegFrameSeat}):
|
|
22
|
+
* the placement copy would otherwise drop that seat before the door saw it and the leg would run with nobody listening.
|
|
23
|
+
*/
|
|
24
|
+
export declare function withLegIdentity(internals: RunInternals | undefined, leg: LegLabel,
|
|
25
|
+
/** The caller's own object — the seat's owner, whatever copy `internals` is (a placement copy is). */
|
|
26
|
+
caller: RunInternals | undefined,
|
|
27
|
+
/** The `Runner` entry this dispatch goes through, for the refusal's own words (a resumed leg: `"resumeStream"`). */
|
|
28
|
+
entry?: LegFrameEntry): RunInternals | undefined;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { refuseHiddenLegFrameSeat } from "../core/runner/leg-frame.js";
|
|
2
|
+
export function withLegIdentity(internals, leg, caller, entry = "runTaskStream") {
|
|
3
|
+
if (caller !== undefined)
|
|
4
|
+
refuseHiddenLegFrameSeat(caller, entry);
|
|
5
|
+
if (typeof internals?.onLegFrame !== "function")
|
|
6
|
+
return internals;
|
|
7
|
+
const label = Object.freeze({ kind: leg.kind, round: leg.round });
|
|
8
|
+
return { ...internals, onLegFrame: (frame, at) => (caller ?? internals).onLegFrame?.(frame, Object.freeze({ ...at, leg: label })) };
|
|
9
|
+
}
|
|
@@ -67,7 +67,7 @@ export interface ListAgentsToolOptions {
|
|
|
67
67
|
* the conversation does not; `none` = only the recorded name. Absent (a direct mount that did not say) ⇒
|
|
68
68
|
* the `none` wording — a label never promises more than the mount can show. */
|
|
69
69
|
continuationTier?: SubagentTranscriptTier;
|
|
70
|
-
/** The run's checkpoint seat — where a PARKED agent row's
|
|
70
|
+
/** The run's checkpoint seat — where a PARKED agent row's park card is read from (the same seat the
|
|
71
71
|
* Agent tool parks children into). Absent ⇒ the card reads `unreadable`. */
|
|
72
72
|
checkpointSeat?: CheckpointSeat;
|
|
73
73
|
/** The clock (tests). */
|
|
@@ -8,7 +8,7 @@ import { PEER_LANE_DEFAULTS } from "./peer-admission.js";
|
|
|
8
8
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
9
9
|
import { thrownText } from "../core/thrown-value.js";
|
|
10
10
|
import { assertNoRetiredKeys } from "../core/retired-keys.js";
|
|
11
|
-
import { agentActivityClause,
|
|
11
|
+
import { agentActivityClause, agentParkClause, formatAgo, readAgentState } from "../core/agent-state.js";
|
|
12
12
|
export const LIST_AGENTS_TOOL_NAME = "ListAgents";
|
|
13
13
|
export const LIST_AGENTS_TOOL_ALIAS = "ListPeers";
|
|
14
14
|
export const LIST_AGENTS_MAX_RESULT_CHARS = 10_000;
|
|
@@ -70,7 +70,7 @@ export function createListAgentsTool(opts) {
|
|
|
70
70
|
`pass includeAll: true to also list stale and offline ones. A peer that is offline or unlisted still accepts messages — they are parked ` +
|
|
71
71
|
`durably in its session box and delivered when it next runs. `
|
|
72
72
|
: `Peer sessions of this engine are not addressable on this mount (no session directory). `) +
|
|
73
|
-
`Background agents you spawned are listed with their task_id, their status, when they last did anything, and — for one parked on a
|
|
73
|
+
`Background agents you spawned are listed with their task_id, their status, when they last did anything, and — for one that is parked — what its park waits on (a person's approval, or a yield that continues when its owner runs again), the card id, state and deadline. ` +
|
|
74
74
|
`A ref is only valid against the listing (or disambiguation error) you read it from — do not invent one.`,
|
|
75
75
|
parameters: Type.Object({
|
|
76
76
|
includeAll: Type.Optional(Type.Boolean({ description: "Also list stale (no activity within the freshness window) and offline peer sessions. Default false." })),
|
|
@@ -171,8 +171,8 @@ export function createListAgentsTool(opts) {
|
|
|
171
171
|
const label = r.kind === "peer_session" ? formatPeerNameRef(inlineUntrusted(r.name, 64), r.ref) : inlineUntrusted(r.name, 64);
|
|
172
172
|
const age = r.kind !== "peer_session" ? undefined : r.lastActiveAt !== undefined ? `active ${formatAgo(now - r.lastActiveAt)} ago` : r.offlineAt !== undefined ? `offline ${formatAgo(now - r.offlineAt)} ago` : "offline";
|
|
173
173
|
const activity = r.agentState !== undefined ? agentActivityClause(r.agentState) : undefined;
|
|
174
|
-
const
|
|
175
|
-
const cols = [label, r.state, age, activity,
|
|
174
|
+
const park = r.agentState?.park !== undefined ? agentParkClause(r.agentState.park, r.agentState.readAt) : undefined;
|
|
175
|
+
const cols = [label, r.state, age, activity, park, r.cwd !== undefined ? inlineUntrusted(r.cwd, 64) : undefined, r.presence !== undefined ? renderPresence(r.presence) : undefined, r.kind === "peer_session" ? `peer session ${PEER_SESSION_WHERE_LABELS[r.where]}` : r.kind === "roster" ? rosterLabel : "agent", r.address];
|
|
176
176
|
return cols.filter((c) => c !== undefined).join(" · ");
|
|
177
177
|
});
|
|
178
178
|
const finishedCount = rows.filter((r) => r.state === "finished").length;
|
|
@@ -2,37 +2,75 @@ import { type MailboxAppendMessage } from "../core/mailbox-store.js";
|
|
|
2
2
|
import type { CrossSessionInboundVerdict } from "./cross-session-judge.js";
|
|
3
3
|
import type { RunnerDeps } from "../core/runner-deps.js";
|
|
4
4
|
/** The prepare-time refusal code of a malformed {@link RunnerDeps.principalInboxConsumer} (and of a gate
|
|
5
|
-
* minting in a deployment that declared no consumer — {@link mintCrossPrincipalRecord}
|
|
5
|
+
* minting in a deployment that declared no consumer — {@link mintCrossPrincipalRecord}; and of an assistant seat a host handed a
|
|
6
|
+
* leg on which the leg cannot read its principal inbox — `detail.reason: "seat_unbound"`). */
|
|
6
7
|
export declare const PRINCIPAL_INBOX_CONSUMER_INVALID_CODE = "config.principal_inbox_consumer_invalid";
|
|
7
8
|
/** Who consumes a scope's principal inbox. `none` = the deployment declared no consumer (it mounts no
|
|
8
|
-
* delivery gate): no lane anywhere.
|
|
9
|
+
* delivery gate): no lane anywhere. `assistant` = the leg the host hands {@link PrincipalInboxAssistantSeat} reads it (the
|
|
10
|
+
* declaration names no leg: the seat does). */
|
|
9
11
|
export type PrincipalInboxConsumer = {
|
|
10
12
|
kind: "none";
|
|
11
13
|
} | {
|
|
12
14
|
kind: "terminals";
|
|
13
15
|
} | {
|
|
14
16
|
kind: "assistant";
|
|
15
|
-
handle: string;
|
|
16
17
|
};
|
|
18
|
+
/**
|
|
19
|
+
* The ASSISTANT SEAT a host hands ONE leg through its trusted internals (`RunInternals.principalInboxAssistant`) — never a
|
|
20
|
+
* {@link RunnerDeps} member, never a `TaskSpec` field, never a tool argument: under the `"assistant"` declaration the leg it is
|
|
21
|
+
* handed to, and that leg alone, reads the scope's principal inbox. The seat names the session it answers for: it counts only on a
|
|
22
|
+
* leg whose session id is exactly {@link sessionId}; on any other leg — a leg that re-ran another leg's internals in a session of
|
|
23
|
+
* its own — it is inert (no lane, no refusal, nothing said). A checkpoint never carries it: the host hands it on every leg it starts,
|
|
24
|
+
* a resumed one included.
|
|
25
|
+
*/
|
|
26
|
+
export interface PrincipalInboxAssistantSeat {
|
|
27
|
+
/** The session this seat answers for — the assistant leg's own session id, compared exactly. A string with a character that is neither whitespace nor a control character: a blank id names no session and is a malformed seat, refused. */
|
|
28
|
+
readonly sessionId: string;
|
|
29
|
+
/**
|
|
30
|
+
* The host's OBSERVER of the letters the leg's model is about to read: called once per `ReadInbox` pull with the page's
|
|
31
|
+
* principal-inbox letters, in the order the page hands them over, after the pass is over and before the result goes back to the
|
|
32
|
+
* model — and awaited. Resolved ⇒ the result carries them. Rejected, thrown, or the call aborted first (`ctx.signal` is the
|
|
33
|
+
* call's own; a late answer is ignored) ⇒ the page's letters are withdrawn: out of the result, still in the box, handed over
|
|
34
|
+
* again — and shown again — by a later pull; the session box's frames on the same page are handed over as made. At least once:
|
|
35
|
+
* the same letter comes again after a withdrawal, a re-supply after a compaction, or a lease another leg took over — its key is
|
|
36
|
+
* {@link principalInboxLetterKey} (recipient scope, {@link PrincipalInboxLetter.fromScope}, {@link PrincipalInboxLetter.gateReceiptId}), never `seq`. Handed
|
|
37
|
+
* over is not read: a host hook that rewrites the result afterwards decides what the model sees. A letter that does not go to
|
|
38
|
+
* the model this time — refused, consumed by the receiving station, still held — is not shown. Absent ⇒ no host step.
|
|
39
|
+
*/
|
|
40
|
+
onLetters?(letters: readonly PrincipalInboxLetter[], ctx: {
|
|
41
|
+
signal: AbortSignal;
|
|
42
|
+
}): Promise<void>;
|
|
43
|
+
}
|
|
44
|
+
/** One principal-inbox letter as {@link PrincipalInboxAssistantSeat.onLetters} receives it: the box record as the delivery gate
|
|
45
|
+
* minted it, not the frame a receiving station rewrote. `content` is another principal's words — untrusted content. */
|
|
46
|
+
export interface PrincipalInboxLetter {
|
|
47
|
+
/** The record's seq in the box: stable while the record lives, minted again after a drop — not a de-duplication key; the letter's key is {@link principalInboxLetterKey}. */
|
|
48
|
+
readonly seq: number;
|
|
49
|
+
readonly fromScope: string;
|
|
50
|
+
readonly gateReceiptId: string;
|
|
51
|
+
readonly sentAt: number;
|
|
52
|
+
/** The sender's display name, as the gate minted it. */
|
|
53
|
+
readonly from?: string;
|
|
54
|
+
readonly urgent?: true;
|
|
55
|
+
readonly content: string;
|
|
56
|
+
}
|
|
17
57
|
/**
|
|
18
58
|
* THE consumer arbitration of a scope's principal inbox ({@link PRINCIPAL_INBOX_HANDLE}),
|
|
19
59
|
* read off {@link RunnerDeps.principalInboxConsumer}: absent ⇒ `none` (no principal-inbox lane: a
|
|
20
60
|
* deployment without a delivery gate claims no extra box, byte for byte as before); `"terminals"` ⇒ the
|
|
21
|
-
* scope's terminal sessions, each draining it as a second box beside its own; `
|
|
22
|
-
*
|
|
23
|
-
*
|
|
61
|
+
* scope's terminal sessions, each draining it as a second box beside its own; `"assistant"` ⇒ the scope's assistant alone — the leg
|
|
62
|
+
* the host hands {@link PrincipalInboxAssistantSeat} — and no terminal session drains the box (it does not claim and yield — it
|
|
63
|
+
* never mints the lane). ANY other value is refused with {@link PRINCIPAL_INBOX_CONSUMER_INVALID_CODE}:
|
|
24
64
|
* a malformed assistant configuration must never be read as "terminals", which would let terminal sessions
|
|
25
|
-
* take the letters past the assistant. The
|
|
26
|
-
* (
|
|
27
|
-
*
|
|
28
|
-
* it is written. The one judgment every reader calls: the drain binding (which
|
|
29
|
-
* lanes), the `ReadInbox` mount (its origin) and the record mint (a gate with no consumer).
|
|
65
|
+
* take the letters past the assistant. The retired form `{ assistant: "<handle>" }` is one of those values, refused by name with
|
|
66
|
+
* the way to the current form (never read as `"assistant"`: the handle chose a leg, and the seat does that now). The one judgment
|
|
67
|
+
* every reader calls: the drain binding (which lanes), the `ReadInbox` mount (its origin) and the record mint (a gate with no consumer).
|
|
30
68
|
*/
|
|
31
69
|
export declare function principalInboxConsumerOf(deps: Pick<RunnerDeps, "principalInboxConsumer">): PrincipalInboxConsumer;
|
|
32
70
|
/** The one refusal shape of the consumer declaration: code {@link PRINCIPAL_INBOX_CONSUMER_INVALID_CODE},
|
|
33
|
-
* `detail.reason` naming which fact refused it (`malformed` / `no_consumer`). Also the refusal of the `ReadInbox` face's copy of the
|
|
71
|
+
* `detail.reason` naming which fact refused it (`malformed` / `no_consumer` / `seat_unbound`). Also the refusal of the `ReadInbox` face's copy of the
|
|
34
72
|
* principal-inbox lane declaration (`coversPrincipalInbox`): the same subject, so the same code. */
|
|
35
|
-
export declare function consumerRefusal(message: string, reason: "malformed" | "no_consumer"): Error;
|
|
73
|
+
export declare function consumerRefusal(message: string, reason: "malformed" | "no_consumer" | "seat_unbound"): Error;
|
|
36
74
|
/**
|
|
37
75
|
* The sender as the deployment's AUTHENTICATION context states it — an object the gate implementation
|
|
38
76
|
* receives from its own auth layer, never a string a caller passes in. `scope` is the authenticated
|
|
@@ -54,9 +92,11 @@ export interface CrossPrincipalBody {
|
|
|
54
92
|
* (or the deployment cannot say they do); `rate_limited` — the cross-principal quota of the sender pair
|
|
55
93
|
* or of the recipient is spent; `inbox_full` — the recipient's principal inbox is at its bound;
|
|
56
94
|
* `recipient_tombstoned` — the recipient principal is being deleted (the store's own pre-delete code,
|
|
57
|
-
* relayed)
|
|
95
|
+
* relayed); `receipt_id_reused` — the caller's receipt id ({@link OrgDeliveryOptions.receiptId}) already
|
|
96
|
+
* names a DIFFERENT letter from this sender in this recipient's inbox. A refused delivery appends nothing
|
|
97
|
+
* anywhere.
|
|
58
98
|
*/
|
|
59
|
-
export declare const ORG_DELIVERY_REFUSAL_CODES: readonly ["org_delivery.not_member", "org_delivery.rate_limited", "org_delivery.inbox_full", "org_delivery.recipient_tombstoned"];
|
|
99
|
+
export declare const ORG_DELIVERY_REFUSAL_CODES: readonly ["org_delivery.not_member", "org_delivery.rate_limited", "org_delivery.inbox_full", "org_delivery.recipient_tombstoned", "org_delivery.receipt_id_reused"];
|
|
60
100
|
export type OrgDeliveryRefusalCode = (typeof ORG_DELIVERY_REFUSAL_CODES)[number];
|
|
61
101
|
export declare function isOrgDeliveryRefusalCode(value: unknown): value is OrgDeliveryRefusalCode;
|
|
62
102
|
/** The gate's synchronous answer: a receipt naming the appended record, or a coded refusal. */
|
|
@@ -71,23 +111,80 @@ export type OrgDeliveryOutcome = {
|
|
|
71
111
|
code: OrgDeliveryRefusalCode;
|
|
72
112
|
message: string;
|
|
73
113
|
};
|
|
114
|
+
/**
|
|
115
|
+
* What a caller may state about ONE delivery, beside the letter itself.
|
|
116
|
+
*
|
|
117
|
+
* `receiptId` is the CALLER's key for the letter: a deployment's outbound queue states it before the first
|
|
118
|
+
* attempt and states the same one on every retry of that letter. Absent = the gate mints one, and the ask
|
|
119
|
+
* cannot be recognised as a repeat. A malformed value (not a string with a non-blank character and no control
|
|
120
|
+
* character, or one that cannot be a record identity — see {@link mintCrossPrincipalRecord}) makes the gate throw before
|
|
121
|
+
* anything is spent or appended.
|
|
122
|
+
* A retry states the SAME letter as the first attempt (the same sender name, content and urgency; when it was sent is
|
|
123
|
+
* not compared): a key that returns with another display name or the urgency flipped is refused
|
|
124
|
+
* `org_delivery.receipt_id_reused`, never answered with the first receipt, which would acknowledge a letter the box does
|
|
125
|
+
* not hold. A deployment that changes either between attempts takes a new receipt id for the changed letter.
|
|
126
|
+
*/
|
|
127
|
+
export interface OrgDeliveryOptions {
|
|
128
|
+
readonly receiptId?: string;
|
|
129
|
+
}
|
|
74
130
|
/**
|
|
75
131
|
* THE contract a deployment implements. `toPrincipal` is the recipient as the deployment addresses
|
|
76
132
|
* principals (its own directory resolves it to the recipient's scope); an unknown recipient and one the
|
|
77
133
|
* sender may not reach answer the same refusal bytes (`not_member`), so the gate is never an existence
|
|
78
134
|
* probe.
|
|
135
|
+
*
|
|
136
|
+
* IDEMPOTENCE on the caller's receipt id: the same key asked again answers the FIRST receipt, counted against no
|
|
137
|
+
* bound and no quota. A letter's key is (the recipient's principal inbox, the sender's scope, the receipt id); the
|
|
138
|
+
* one mint states it as the record's identity ({@link mintCrossPrincipalRecord}), so the inbox's own
|
|
139
|
+
* append-by-identity judgment decides it — over the records the box holds and over its received window
|
|
140
|
+
* ({@link import("../core/mailbox-store.js").MAILBOX_CONSUMED_ID_WINDOW}), atomically with the seq allocation,
|
|
141
|
+
* in every backend. The order a gate keeps: mint the record (pure), then — before it records an attempt, judges
|
|
142
|
+
* membership, reads the inbox bound or takes quota — ask the recipient's inbox store
|
|
143
|
+
* {@link import("../core/mailbox-store.js").MailboxStore.replayOf} for it (an empty recipient scope is refused as
|
|
144
|
+
* `append` refuses it; any other string is a box key, and a box that does not exist holds no letter and answers
|
|
145
|
+
* `undefined`). A hit answers `{ ok: true, receipt: { receiptId, seq } }` with the key's own receipt id and the first `seq`, and nothing else happens; a different letter under the key
|
|
146
|
+
* (what a letter says: the sender's name, the content, the urgency — not when it was sent) is refused
|
|
147
|
+
* `org_delivery.receipt_id_reused`; a miss goes on through the gate's bounds to the append, which decides again
|
|
148
|
+
* if the first ask was still in flight. The question carries the sender's own scope in its key, so it can only
|
|
149
|
+
* meet a letter this sender sent — it is no existence probe — and a letter the box accepted stays acknowledged
|
|
150
|
+
* after its recipient left the organization or began to be deleted. The protection reaches as far as the
|
|
151
|
+
* box's memory: the records it holds and the newest `MAILBOX_CONSUMED_ID_WINDOW` it has received. Map a store's
|
|
152
|
+
* `append` failure to the refusal it means with {@link orgDeliveryRefusalOfAppendFailure}.
|
|
79
153
|
*/
|
|
80
154
|
export interface OrgDeliveryGate {
|
|
81
|
-
|
|
155
|
+
/**
|
|
156
|
+
* @contract cross_session.gate_narrows_reach — A deployment may narrow, inside its gate, who can write to whom beyond organization
|
|
157
|
+
* membership (for example a recipient's own list of the senders that may reach it). A narrowing refusal answers
|
|
158
|
+
* `org_delivery.not_member` with the same code and the same message bytes as an unknown recipient or another organization, and it is
|
|
159
|
+
* given at the membership step — before anything is appended and before any quota is spent; an attempt bound the deployment keeps on
|
|
160
|
+
* membership refusals counts it as it counts one. The gate never writes a verdict on the record: every letter it appends is judged at
|
|
161
|
+
* the recipient's drain by the principal arm, like every other. So passing the gate means "may be stored" and nothing more — it is not
|
|
162
|
+
* `next-turn` or `wake` (a recipient who set nothing still holds the letter as `cross-principal-default`), it releases no letter a
|
|
163
|
+
* setting holds (`managed-setting`, `explicit-setting`, `invalid-setting`, `cross-principal-default`), and the list has no reader in
|
|
164
|
+
* the tool-question ladder: a sender on it mints no allow rule and clears no `mandated` question.
|
|
165
|
+
*/
|
|
166
|
+
deliverCrossPrincipal(authedFrom: OrgAuthenticatedSender, toPrincipal: string, body: CrossPrincipalBody, opts?: OrgDeliveryOptions): Promise<OrgDeliveryOutcome>;
|
|
82
167
|
}
|
|
168
|
+
/**
|
|
169
|
+
* The refusal word an `append` failure of the recipient's principal inbox means, or `undefined` when the failure
|
|
170
|
+
* is none of the gate's refusals (the gate rethrows it). Reads the failure's `code` only — a cross-process store
|
|
171
|
+
* hands back no class instance: the store's pre-delete refusal ⇒ `org_delivery.recipient_tombstoned`; the
|
|
172
|
+
* record-identity refusal (the letter under the caller's receipt id differs from the one the box already
|
|
173
|
+
* has) ⇒ `org_delivery.receipt_id_reused`. The one mapping every gate implementation uses.
|
|
174
|
+
*/
|
|
175
|
+
export declare function orgDeliveryRefusalOfAppendFailure(err: unknown): OrgDeliveryRefusalCode | undefined;
|
|
83
176
|
/**
|
|
84
177
|
* The record the gate appends into `(recipientScope, PRINCIPAL_INBOX_HANDLE)` — the ONE mint, so every
|
|
85
178
|
* gate implementation writes the same typed shape. Pure. Writes `peerMeta { kind: "peer_message",
|
|
86
179
|
* fromScope, gateReceiptId }` (+ `urgent`) and the display `from`; writes NO `fromSession` (a sender's
|
|
87
180
|
* session id addresses nothing in the recipient's scope), NO `fromMode` (the principal arm reads no
|
|
88
181
|
* parity) and NO `hopChain` (the org gate owns the cross-principal quota; the same-principal admission
|
|
89
|
-
* gate's chain does not apply).
|
|
90
|
-
*
|
|
182
|
+
* gate's chain does not apply). States the record's IDENTITY — `id` = the pair (`from.scope`, `receiptId`): with the
|
|
183
|
+
* recipient's box it is the letter's key, the one every repeat of the letter carries (see {@link OrgDeliveryGate}).
|
|
184
|
+
* Throws when the receipt id is not a name the box keeps ({@link isMailboxNameSpelling}), or when the pair is
|
|
185
|
+
* no storable record identity (`mailbox.invalid_record_id` for both; the pair is bounded by
|
|
186
|
+
* {@link import("../core/mailbox-store.js").MAILBOX_RECORD_ID_MAX_CHARS}), when the anchors cannot be stored, or when the
|
|
187
|
+
* sender's scope cannot be spelled on the envelope (the gate maps that to its own failure; nothing has been appended yet).
|
|
91
188
|
*
|
|
92
189
|
* `consumer` is the deployment's declared principal-inbox consumer ({@link principalInboxConsumerOf} over
|
|
93
190
|
* the same `RunnerDeps` the deployment runs its legs with). A gate in a deployment that declared NONE is a
|
|
@@ -121,9 +218,18 @@ export declare const PRINCIPAL_INBOX_TRIAGE_POLICIES: readonly ["triage_readonly
|
|
|
121
218
|
export type PrincipalInboxTriagePolicy = (typeof PRINCIPAL_INBOX_TRIAGE_POLICIES)[number];
|
|
122
219
|
export declare function principalInboxTriagePolicy(verdict: CrossSessionInboundVerdict): PrincipalInboxTriagePolicy;
|
|
123
220
|
/**
|
|
124
|
-
*
|
|
125
|
-
* audit row). The principal inbox is consumed at
|
|
126
|
-
*
|
|
127
|
-
*
|
|
221
|
+
* THE key of one letter — the one every repeat of it carries, and the one every side effect a consumer takes for it
|
|
222
|
+
* (a draft, a decline, an audit row, a host's own copy) is keyed by. The principal inbox is consumed at least once — a
|
|
223
|
+
* lease that lapses before its ack, a withdrawn page, a re-supply after a compaction, a record dropped and appended again
|
|
224
|
+
* serve the letter again — so a consumer that finds an effect under this key already written skips it. The key is
|
|
225
|
+
* (the recipient's scope, the sender's scope, the receipt id): what the delivery gate and the box keep for the letter
|
|
226
|
+
* ({@link OrgDeliveryGate}), never the box `seq`, which a drop and a new append change. A JSON array, so two triples never
|
|
227
|
+
* spell one key (`("a","bc")` is not `("ab","c")`) — the spelling {@link mintCrossPrincipalRecord} gives the record's identity,
|
|
228
|
+
* the recipient's scope added. Total over every letter a box holds: the box guarantees the two anchors are non-empty strings,
|
|
229
|
+
* and a receipt id an older mint accepted — blank, or carrying a control character — is a key like any other. Throws
|
|
230
|
+
* `TypeError` when a part is not a non-empty string: a key that names no letter is refused, never made.
|
|
128
231
|
*/
|
|
129
|
-
export declare function
|
|
232
|
+
export declare function principalInboxLetterKey(recipientScope: string, letter: {
|
|
233
|
+
readonly fromScope: string;
|
|
234
|
+
readonly gateReceiptId: string;
|
|
235
|
+
}): string;
|
|
@@ -1,9 +1,7 @@
|
|
|
1
|
-
import { readMailboxPeerMeta } from "../core/mailbox-store.js";
|
|
1
|
+
import { MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE, MailboxStoreError, isMailboxNameSpelling, readMailboxPeerMeta, readMailboxRecordId } from "../core/mailbox-store.js";
|
|
2
2
|
import { buildCrossSessionEnvelope, encodePeerAddress } from "./cross-session-envelope.js";
|
|
3
3
|
import { PRINCIPAL_INBOX_HANDLE } from "./cross-session-ref.js";
|
|
4
4
|
import { describeRejectedValue } from "../core/tool-search-setting.js";
|
|
5
|
-
import { DURABLE_AGENT_HANDLE_RE } from "../core/task-registry-shared.js";
|
|
6
|
-
import { inlineUntrusted } from "../core/untrusted-text.js";
|
|
7
5
|
export const PRINCIPAL_INBOX_CONSUMER_INVALID_CODE = "config.principal_inbox_consumer_invalid";
|
|
8
6
|
export function principalInboxConsumerOf(deps) {
|
|
9
7
|
const raw = deps.principalInboxConsumer;
|
|
@@ -11,17 +9,14 @@ export function principalInboxConsumerOf(deps) {
|
|
|
11
9
|
return { kind: "none" };
|
|
12
10
|
if (raw === "terminals")
|
|
13
11
|
return { kind: "terminals" };
|
|
14
|
-
if (raw
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
throw consumerRefusal(`RunnerDeps.principalInboxConsumer.assistant must be an agent handle ("a" followed by 6-32 lower-case hex digits, the shape the task registry mints), got ${JSON.stringify(inlineUntrusted(handle, 96))} — ` +
|
|
21
|
-
`a string that is not one equals no leg's task id, so no leg would ever seat the assistant's lane and the principal inbox would wait for a reader that never comes`, "malformed");
|
|
22
|
-
}
|
|
12
|
+
if (raw === "assistant")
|
|
13
|
+
return { kind: "assistant" };
|
|
14
|
+
if (raw !== null && typeof raw === "object" && Reflect.ownKeys(raw).includes("assistant")) {
|
|
15
|
+
throw consumerRefusal(`RunnerDeps.principalInboxConsumer: { assistant: "<handle>" } is retired — the handle chose the leg by its task id, and a seat chooses it now. ` +
|
|
16
|
+
`Declare principalInboxConsumer: "assistant", and hand the assistant's leg RunInternals.principalInboxAssistant: { sessionId: <that leg's own session id> } on every leg you start for it (a resumed leg included); ` +
|
|
17
|
+
`do not carry the handle into the new form`, "malformed");
|
|
23
18
|
}
|
|
24
|
-
throw consumerRefusal(`RunnerDeps.principalInboxConsumer must be absent (no principal-inbox consumer), "terminals" (the scope's terminal sessions drain it beside their own box) or
|
|
19
|
+
throw consumerRefusal(`RunnerDeps.principalInboxConsumer must be absent (no principal-inbox consumer), "terminals" (the scope's terminal sessions drain it beside their own box) or "assistant" (the leg the host hands RunInternals.principalInboxAssistant reads it) ` +
|
|
25
20
|
`(got ${describeRejectedValue(raw)}) — a malformed value is refused rather than read as "terminals", which would let terminal sessions take cross-principal letters past the assistant`, "malformed");
|
|
26
21
|
}
|
|
27
22
|
export function consumerRefusal(message, reason) {
|
|
@@ -30,23 +25,47 @@ export function consumerRefusal(message, reason) {
|
|
|
30
25
|
e.detail = { reason };
|
|
31
26
|
return e;
|
|
32
27
|
}
|
|
33
|
-
export const ORG_DELIVERY_REFUSAL_CODES = Object.freeze([
|
|
28
|
+
export const ORG_DELIVERY_REFUSAL_CODES = Object.freeze([
|
|
29
|
+
"org_delivery.not_member",
|
|
30
|
+
"org_delivery.rate_limited",
|
|
31
|
+
"org_delivery.inbox_full",
|
|
32
|
+
"org_delivery.recipient_tombstoned",
|
|
33
|
+
"org_delivery.receipt_id_reused",
|
|
34
|
+
]);
|
|
34
35
|
export function isOrgDeliveryRefusalCode(value) {
|
|
35
36
|
return typeof value === "string" && ORG_DELIVERY_REFUSAL_CODES.includes(value);
|
|
36
37
|
}
|
|
38
|
+
export function orgDeliveryRefusalOfAppendFailure(err) {
|
|
39
|
+
const code = err !== null && typeof err === "object" ? err.code : undefined;
|
|
40
|
+
if (code === MAILBOX_TOMBSTONED_RECIPIENT_CODE)
|
|
41
|
+
return "org_delivery.recipient_tombstoned";
|
|
42
|
+
if (code === MAILBOX_DUPLICATE_RECORD_ID_CODE)
|
|
43
|
+
return "org_delivery.receipt_id_reused";
|
|
44
|
+
return undefined;
|
|
45
|
+
}
|
|
37
46
|
export function mintCrossPrincipalRecord(input) {
|
|
38
47
|
const { from, body, receiptId, sentAt, consumer } = input;
|
|
39
48
|
if (consumer?.kind !== "terminals" && consumer?.kind !== "assistant") {
|
|
40
|
-
throw consumerRefusal(`an organization delivery gate is minting a principal-inbox letter, but the deployment declares no principal-inbox consumer (RunnerDeps.principalInboxConsumer is absent): nobody would ever read it. Declare "terminals" or
|
|
49
|
+
throw consumerRefusal(`an organization delivery gate is minting a principal-inbox letter, but the deployment declares no principal-inbox consumer (RunnerDeps.principalInboxConsumer is absent): nobody would ever read it. Declare "terminals" or "assistant".`, "no_consumer");
|
|
41
50
|
}
|
|
42
51
|
if (typeof body.content !== "string")
|
|
43
52
|
throw new TypeError("mintCrossPrincipalRecord: body.content must be a string");
|
|
44
53
|
if (!Number.isFinite(sentAt))
|
|
45
54
|
throw new TypeError("mintCrossPrincipalRecord: sentAt must be a finite epoch-ms number");
|
|
55
|
+
readReceiptId(receiptId);
|
|
46
56
|
const peerMeta = readMailboxPeerMeta({ kind: "peer_message", fromScope: from.scope, gateReceiptId: receiptId, ...(body.urgent === true ? { urgent: true } : {}) });
|
|
47
57
|
const name = typeof from.name === "string" && from.name !== "" ? from.name : undefined;
|
|
48
58
|
buildCrossSessionEnvelope({ from: encodePeerAddress(name ?? "unknown"), ...(name !== undefined ? { fromName: name } : {}), fromScope: from.scope }, body.content);
|
|
49
|
-
return { ...(name !== undefined ? { from: name } : {}), content: body.content, sentAt, peerMeta };
|
|
59
|
+
return { id: crossPrincipalRecordId(from.scope, receiptId), ...(name !== undefined ? { from: name } : {}), content: body.content, sentAt, peerMeta };
|
|
60
|
+
}
|
|
61
|
+
function readReceiptId(raw) {
|
|
62
|
+
if (!isMailboxNameSpelling(raw)) {
|
|
63
|
+
throw new MailboxStoreError(MAILBOX_INVALID_RECORD_ID_CODE, "mintCrossPrincipalRecord: receiptId must be a string with a non-blank character and no control character, no format character, and at most 256 characters");
|
|
64
|
+
}
|
|
65
|
+
return raw;
|
|
66
|
+
}
|
|
67
|
+
function crossPrincipalRecordId(fromScope, receiptId) {
|
|
68
|
+
return readMailboxRecordId(JSON.stringify([fromScope, receiptId]));
|
|
50
69
|
}
|
|
51
70
|
export function isGateMintedRecord(meta) {
|
|
52
71
|
return meta !== undefined && meta.kind === "peer_message" && meta.fromScope !== undefined && meta.gateReceiptId !== undefined;
|
|
@@ -67,8 +86,10 @@ export function principalInboxTriagePolicy(verdict) {
|
|
|
67
86
|
}
|
|
68
87
|
}
|
|
69
88
|
}
|
|
70
|
-
export function
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
89
|
+
export function principalInboxLetterKey(recipientScope, letter) {
|
|
90
|
+
const parts = [["recipientScope", recipientScope], ["letter.fromScope", letter?.fromScope], ["letter.gateReceiptId", letter?.gateReceiptId]];
|
|
91
|
+
for (const [name, part] of parts)
|
|
92
|
+
if (typeof part !== "string" || part === "")
|
|
93
|
+
throw new TypeError(`principalInboxLetterKey: ${name} must be a non-empty string`);
|
|
94
|
+
return JSON.stringify([recipientScope, letter.fromScope, letter.gateReceiptId]);
|
|
74
95
|
}
|