@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
|
@@ -60,6 +60,13 @@ export declare function frameMidTurnUserInput(projected: string): string;
|
|
|
60
60
|
* A blank text passes through untouched (the harness's empty-injection no-op), like the person's frame.
|
|
61
61
|
*/
|
|
62
62
|
export declare function frameExtensionInput(name: string | undefined, projected: string): string;
|
|
63
|
+
/** The frame a person's words are delivered in (the author table's `person` frame): the speaker envelope, inside the trusted
|
|
64
|
+
* caller's reminder or the mid-turn frame. The live steer lane mints it; so does the resume of a parked steer, of the message a
|
|
65
|
+
* wake carries, and of a parked steer an extension already answered — that input's row is the frame it was taken in. `source` is
|
|
66
|
+
* the carrier the words arrived on, or `system` when their sender said it wrote them itself: such a text is its sender's own,
|
|
67
|
+
* so it gets neither the speaker label nor the person's mid-turn frame. `trusted` is the other question (may it ride the
|
|
68
|
+
* reminder?) and is read the same either way. */
|
|
69
|
+
export declare function personSteerFrame(text: string, actor: ActorAssertion | undefined, trusted: boolean, reminderMark: string, source: "steer" | "wake" | "system"): string;
|
|
63
70
|
/**
|
|
64
71
|
* Render the speaker envelope for one human-input frame. Pure; see the module contract above.
|
|
65
72
|
* Call BEFORE any trust framing (`formatHookFeedback` / `delimitUntrusted`) so the label stays
|
|
@@ -1,27 +1,35 @@
|
|
|
1
1
|
import { snapshotActorAssertion } from "../internal/llm.js";
|
|
2
2
|
import { uuidv7 } from "../internal/harness.js";
|
|
3
|
+
import { isBlankInput } from "./input-author.js";
|
|
3
4
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
5
|
+
import { formatHookFeedback } from "./reminder-mint.js";
|
|
4
6
|
import { attrEscape, EXTERNAL_SOURCE_MAX } from "./task-notification.js";
|
|
5
7
|
const MID_TURN_USER_INPUT_HEAD = "The user sent a new message while you were working:\n";
|
|
6
8
|
const MID_TURN_USER_INPUT_TAIL = "\n\nThis is how a message sent mid-turn is surfaced: within the turn that is still running, often " +
|
|
7
9
|
"alongside the next tool result, rather than as a separate conversation turn. Address the message " +
|
|
8
10
|
"above as you continue this turn.";
|
|
9
11
|
export function frameMidTurnUserInput(projected) {
|
|
10
|
-
if (projected
|
|
12
|
+
if (isBlankInput(projected))
|
|
11
13
|
return projected;
|
|
12
14
|
return `${MID_TURN_USER_INPUT_HEAD}${projected}${MID_TURN_USER_INPUT_TAIL}`;
|
|
13
15
|
}
|
|
14
16
|
const EXTENSION_INPUT_TAIL = "\n\nThis is how a prompt an extension submits is surfaced: between turns, starting this turn in the user's place. Address " +
|
|
15
17
|
"the message above.";
|
|
16
18
|
export function frameExtensionInput(name, projected) {
|
|
17
|
-
if (projected
|
|
19
|
+
if (isBlankInput(projected))
|
|
18
20
|
return projected;
|
|
19
21
|
return `${name !== undefined ? `The extension "${name}"` : "An extension"} sent a message:\n${projected}${EXTENSION_INPUT_TAIL}`;
|
|
20
22
|
}
|
|
23
|
+
export function personSteerFrame(text, actor, trusted, reminderMark, source) {
|
|
24
|
+
const projected = projectHumanInput({ text, actor, source });
|
|
25
|
+
if (trusted)
|
|
26
|
+
return formatHookFeedback(projected, reminderMark);
|
|
27
|
+
return source === "system" ? projected : frameMidTurnUserInput(projected);
|
|
28
|
+
}
|
|
21
29
|
export function projectHumanInput(frame) {
|
|
22
30
|
if (frame.actor === undefined || frame.source === "system")
|
|
23
31
|
return frame.text;
|
|
24
|
-
if (frame.text
|
|
32
|
+
if (isBlankInput(frame.text))
|
|
25
33
|
return frame.text;
|
|
26
34
|
const label = attrEscape(inlineUntrusted(frame.actor.id, EXTERNAL_SOURCE_MAX));
|
|
27
35
|
const mark = frame.actor.hostAsserted ? "" : " (unverified)";
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { DocumentContent, ImageContent } from "../internal/llm.js";
|
|
2
2
|
import type { ImageDimensions, ImageDownsampler } from "./image-downsample.js";
|
|
3
3
|
import type { MediaBlock } from "./media-byte-cap.js";
|
|
4
|
+
import { type BytesNotKeptReason, type ToolResultBytesKeeper } from "./tool-result-bytes.js";
|
|
4
5
|
/** Max raw size sent whole as a document block (CC `PDF_TARGET_RAW_SIZE`). */
|
|
5
6
|
export declare const PDF_TARGET_RAW_SIZE: number;
|
|
6
7
|
/**
|
|
@@ -171,7 +172,9 @@ export declare function admitDocumentBytes(bytes: Uint8Array, claimedMime: strin
|
|
|
171
172
|
export type MediaRefusalReason = "undecodable" | "mime_unsupported" | "raw_too_large" | "magic_mismatch" | "dimensions_unreadable" | "dimensions_too_large" | "base64_too_large";
|
|
172
173
|
/** One media block the seat refused: its type, the refusal, its decoded size, the bound it exceeded (the raw-byte cap for
|
|
173
174
|
* `raw_too_large`, the reject edge for `dimensions_too_large` — with the size its header states —, the base64 length
|
|
174
|
-
* limit for `base64_too_large`), and its media type when it can be one.
|
|
175
|
+
* limit for `base64_too_large`), and its media type when it can be one. A refusal for size also says under which ref of the
|
|
176
|
+
* run's tool-result store its bytes were kept (`ref`), or why they were not (`notKept`, with the store's own error text in
|
|
177
|
+
* `saveError` when the store refused them); no other refusal carries any of the three. */
|
|
175
178
|
export interface ToolResultMediaRefusal {
|
|
176
179
|
type: MediaBlock["type"];
|
|
177
180
|
reason: MediaRefusalReason;
|
|
@@ -180,6 +183,9 @@ export interface ToolResultMediaRefusal {
|
|
|
180
183
|
width?: number;
|
|
181
184
|
height?: number;
|
|
182
185
|
mimeType?: string;
|
|
186
|
+
ref?: string;
|
|
187
|
+
notKept?: BytesNotKeptReason;
|
|
188
|
+
saveError?: string;
|
|
183
189
|
}
|
|
184
190
|
/** What the seat made of one result's content: every media block rebuilt from its checked bytes or replaced, in its slot,
|
|
185
191
|
* by its placeholder; and the refusals. */
|
|
@@ -187,6 +193,11 @@ export interface ToolResultMediaAdmission {
|
|
|
187
193
|
content: unknown[];
|
|
188
194
|
refused: ToolResultMediaRefusal[];
|
|
189
195
|
}
|
|
196
|
+
/** The media block a claimed type names, read off the admission's own sets (exactly: no parameter, lowercase) — `image` for
|
|
197
|
+
* one of the four image types, `document` for `application/pdf`, `undefined` for any other value. A carrier that holds
|
|
198
|
+
* bytes under a claimed type and no block type (an MCP resource blob) reads its block here, so what it builds is judged by
|
|
199
|
+
* the same sets that judge it. */
|
|
200
|
+
export declare function mediaBlockTypeOf(mime: unknown): MediaBlock["type"] | undefined;
|
|
190
201
|
/** The media type a block claims — its `type`, read once, when that is a media type — or `undefined` for any other value. */
|
|
191
202
|
export declare function claimedMediaType(block: unknown): MediaBlock["type"] | undefined;
|
|
192
203
|
/**
|
|
@@ -206,11 +217,12 @@ export declare function toolResultMediaBlocks(content: unknown): unknown[] | und
|
|
|
206
217
|
/**
|
|
207
218
|
* The tool-result seat's admission over blocks {@link toolResultMediaBlocks} read: each media block admitted with the run's
|
|
208
219
|
* `processor` — rebuilt from the bytes it checked (an image a carrier already brought within the target and the frame passes
|
|
209
|
-
* unchanged), or replaced in its slot by a placeholder naming `toolName` and the refusal
|
|
220
|
+
* unchanged), or replaced in its slot by a placeholder naming `toolName` and the refusal (and, for a refusal for size, the
|
|
221
|
+
* ref `keep` kept its bytes under, or why they were not kept — no `keep` keeps nothing).
|
|
210
222
|
*/
|
|
211
|
-
export declare function admitToolResultMediaBlocks(blocks: readonly unknown[], toolName: string, processor: ImageDownsampler | "none"): Promise<ToolResultMediaAdmission>;
|
|
223
|
+
export declare function admitToolResultMediaBlocks(blocks: readonly unknown[], toolName: string, processor: ImageDownsampler | "none", keep?: ToolResultBytesKeeper): Promise<ToolResultMediaAdmission>;
|
|
212
224
|
/**
|
|
213
225
|
* The tool-result seat over one executed call's content with a processor in hand: {@link toolResultMediaBlocks}, then
|
|
214
226
|
* {@link admitToolResultMediaBlocks} — `undefined` when no block claims a media type (nothing is awaited).
|
|
215
227
|
*/
|
|
216
|
-
export declare function admitToolResultMedia(content: unknown, toolName: string, processor: ImageDownsampler | "none"): Promise<ToolResultMediaAdmission> | undefined;
|
|
228
|
+
export declare function admitToolResultMedia(content: unknown, toolName: string, processor: ImageDownsampler | "none", keep?: ToolResultBytesKeeper): Promise<ToolResultMediaAdmission> | undefined;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
+
import { keepBytesWith, mediaTypeEcho } from "./tool-result-bytes.js";
|
|
2
3
|
import { readMember } from "./thrown-value.js";
|
|
3
4
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
4
5
|
export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
|
|
@@ -199,8 +200,13 @@ export function admitDocumentBytes(bytes, claimedMime) {
|
|
|
199
200
|
return { ok: false, reason: "magic_mismatch", rawBytes };
|
|
200
201
|
return { ok: true, block: { type: "document", data: Buffer.from(bytes).toString("base64"), mimeType: claimedMime }, originalSize: rawBytes };
|
|
201
202
|
}
|
|
202
|
-
const mediaTypeEcho = (mime) => typeof mime === "string" && /^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$/.test(mime) ? mime : undefined;
|
|
203
203
|
const ADMITTED_FOR = { image: ADMITTED_IMAGE_MIME_TYPES, document: ADMITTED_DOCUMENT_MIME_TYPES };
|
|
204
|
+
export function mediaBlockTypeOf(mime) {
|
|
205
|
+
if (typeof mime !== "string")
|
|
206
|
+
return undefined;
|
|
207
|
+
return Object.keys(ADMITTED_FOR).find((type) => ADMITTED_FOR[type].includes(mime));
|
|
208
|
+
}
|
|
209
|
+
const KEPT_FOR_SIZE = new Set(["raw_too_large", "dimensions_too_large", "base64_too_large"]);
|
|
204
210
|
const REFUSAL_CLAUSE = {
|
|
205
211
|
undecodable: () => "it carried no base64 payload",
|
|
206
212
|
mime_unsupported: (r) => `${r.mimeType ?? "its media type"} is not a ${r.type} type the model accepts (${ADMITTED_FOR[r.type].join(", ")})`,
|
|
@@ -210,9 +216,9 @@ const REFUSAL_CLAUSE = {
|
|
|
210
216
|
dimensions_too_large: (r) => unprocessedSizeClause({ reason: "dimensions_too_large", width: r.width, height: r.height, limit: r.limit }),
|
|
211
217
|
base64_too_large: (r) => `its base64 encoding exceeds the ${r.limit}-character provider limit (${r.bytes} bytes)`,
|
|
212
218
|
};
|
|
213
|
-
const placeholderOf = (toolName, r) => ({
|
|
219
|
+
const placeholderOf = (toolName, r, keptClause) => ({
|
|
214
220
|
type: "text",
|
|
215
|
-
text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
|
|
221
|
+
text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})${keptClause !== undefined ? `; ${keptClause}` : ""}]`,
|
|
216
222
|
});
|
|
217
223
|
const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
|
|
218
224
|
export function claimedMediaType(block) {
|
|
@@ -220,7 +226,7 @@ export function claimedMediaType(block) {
|
|
|
220
226
|
return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
|
|
221
227
|
}
|
|
222
228
|
const claimsMedia = (block) => claimedMediaType(block) !== undefined;
|
|
223
|
-
async function admitBlock(block, processor) {
|
|
229
|
+
async function admitBlock(block, processor, keep) {
|
|
224
230
|
const type = claimedMediaType(block);
|
|
225
231
|
if (type === undefined)
|
|
226
232
|
return { block };
|
|
@@ -233,8 +239,9 @@ async function admitBlock(block, processor) {
|
|
|
233
239
|
if (typeof data !== "string")
|
|
234
240
|
return refusal("undecodable", 0);
|
|
235
241
|
let a;
|
|
242
|
+
let bytes;
|
|
236
243
|
try {
|
|
237
|
-
|
|
244
|
+
bytes = Buffer.from(data, "base64");
|
|
238
245
|
const claimed = typeof mime === "string" ? mime : "";
|
|
239
246
|
a = type === "image" ? await admitImageBytes(bytes, claimed, processor) : admitDocumentBytes(bytes, claimed);
|
|
240
247
|
}
|
|
@@ -243,13 +250,18 @@ async function admitBlock(block, processor) {
|
|
|
243
250
|
}
|
|
244
251
|
if (a.ok)
|
|
245
252
|
return { block: a.block };
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
+
const refused = a.reason === "raw_too_large"
|
|
254
|
+
? refusal(a.reason, a.rawBytes, a.cap)
|
|
255
|
+
: a.reason === "dimensions_too_large"
|
|
256
|
+
? refusal(a.reason, a.rawBytes, a.limit, { width: a.width, height: a.height })
|
|
257
|
+
: a.reason === "base64_too_large"
|
|
258
|
+
? refusal(a.reason, a.rawBytes, IMAGE_ADMISSION.hard.imageBase64Chars)
|
|
259
|
+
: refusal(a.reason, a.rawBytes);
|
|
260
|
+
if (!KEPT_FOR_SIZE.has(refused.refusal.reason))
|
|
261
|
+
return refused;
|
|
262
|
+
const { kept, clause } = await keepBytesWith(keep, bytes, mime);
|
|
263
|
+
const where = "ref" in kept ? { ref: kept.ref } : { notKept: kept.notKept, ...(kept.notKept === "store_failed" ? { saveError: kept.saveError } : {}) };
|
|
264
|
+
return { refusal: { ...refused.refusal, ...where }, keptClause: clause };
|
|
253
265
|
}
|
|
254
266
|
export function firstUnprocessedOverTarget(blocks, processor) {
|
|
255
267
|
if (processor !== "none")
|
|
@@ -277,22 +289,22 @@ export function toolResultMediaBlocks(content) {
|
|
|
277
289
|
return undefined;
|
|
278
290
|
}
|
|
279
291
|
}
|
|
280
|
-
export async function admitToolResultMediaBlocks(blocks, toolName, processor) {
|
|
292
|
+
export async function admitToolResultMediaBlocks(blocks, toolName, processor, keep) {
|
|
281
293
|
const refused = [];
|
|
282
294
|
const out = [];
|
|
283
295
|
for (const b of blocks) {
|
|
284
|
-
const r = await admitBlock(b, processor);
|
|
296
|
+
const r = await admitBlock(b, processor, keep);
|
|
285
297
|
if ("block" in r) {
|
|
286
298
|
out.push(r.block);
|
|
287
299
|
}
|
|
288
300
|
else {
|
|
289
301
|
refused.push(r.refusal);
|
|
290
|
-
out.push(placeholderOf(toolName, r.refusal));
|
|
302
|
+
out.push(placeholderOf(toolName, r.refusal, r.keptClause));
|
|
291
303
|
}
|
|
292
304
|
}
|
|
293
305
|
return { content: out, refused };
|
|
294
306
|
}
|
|
295
|
-
export function admitToolResultMedia(content, toolName, processor) {
|
|
307
|
+
export function admitToolResultMedia(content, toolName, processor, keep) {
|
|
296
308
|
const blocks = toolResultMediaBlocks(content);
|
|
297
|
-
return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor);
|
|
309
|
+
return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor, keep);
|
|
298
310
|
}
|
|
@@ -5,6 +5,45 @@ export declare const INPUT_AUTHORS: readonly ["operator", "parent_model", "workf
|
|
|
5
5
|
export type InputAuthor = (typeof INPUT_AUTHORS)[number];
|
|
6
6
|
/** Membership test for {@link InputAuthor}. */
|
|
7
7
|
export declare function isInputAuthor(v: unknown): v is InputAuthor;
|
|
8
|
+
/**
|
|
9
|
+
* Does this input text say nothing? The ONE reading of "empty" on the input path: the harness's no-op for an empty injection,
|
|
10
|
+
* the steer verb's own bookkeeping of it, the three frames' blank passthrough and `$.prompt.submit`'s door all ask this, so the
|
|
11
|
+
* person's steer and an extension's prompt are never judged by two definitions. A text is blank when it holds only whitespace
|
|
12
|
+
* (`\s`) and control characters (`\p{Cc}`: C0, DEL, C1) — a text with any other code point says something, whatever else
|
|
13
|
+
* surrounds it (a zero-width or format character included: only control characters and whitespace are read as nothing).
|
|
14
|
+
*/
|
|
15
|
+
export declare function isBlankInput(text: string): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* HRD-APV-4: the char cap on a steering text — the last persisted, model-facing string on a checkpoint row that had none
|
|
18
|
+
* (`validatePendingSteer` enforces it on a parked operator steer, a parked reply's answer and entered text meet it, and a live
|
|
19
|
+
* `{ reply }` at the prompt screen's door meets the same one: {@link steeringTextDefect}).
|
|
20
|
+
*
|
|
21
|
+
* Sized as an INSTRUCTION budget, not a preview budget: the siblings above cap echo-only projections at
|
|
22
|
+
* 200/512 chars, while a steer is prose a human wrote for the model to act on and is re-delivered on
|
|
23
|
+
* every resume of the checkpoint. 16k chars (~4k tokens) holds any realistic operator instruction and
|
|
24
|
+
* still bounds the durable row and the per-resume context cost. Exported (from the checkpoint store's module as before) so a BFF
|
|
25
|
+
* can validate before it calls `CheckpointStore.setPendingSteer` rather than discovering the reject at persist time.
|
|
26
|
+
*/
|
|
27
|
+
export declare const MAX_PENDING_STEER_CHARS = 16000;
|
|
28
|
+
/** The C0/DEL control-character class every persisted steering string is rejected on — ONE pattern home
|
|
29
|
+
* for the text half and the actor labels (the in-memory backend stores a NUL fine, Postgres text/jsonb
|
|
30
|
+
* refuses it, so a steer that persisted on one backend would fail on the other). Ordinary `\t`/`\n`/`\r`
|
|
31
|
+
* whitespace is deliberately allowed. */
|
|
32
|
+
export declare const STEERING_CONTROL_CHARS_RE: RegExp;
|
|
33
|
+
/** Why a steering text may not be persisted or entered: it carries a system-reminder break-out tag, a control character, or is
|
|
34
|
+
* longer than {@link MAX_PENDING_STEER_CHARS}. */
|
|
35
|
+
export type SteeringTextDefect = "break_out_tag" | "control_chars" | "too_long";
|
|
36
|
+
/**
|
|
37
|
+
* THE judgment of a steering text's content — the text half every persisted steering string meets (`validatePendingSteer`'s
|
|
38
|
+
* text and a parked reply's answer and entered text) and a live `{ reply }` meets at the prompt screen's door: the same payload
|
|
39
|
+
* is accepted or refused the same way whether the leg is running or parked. The first defect in the order the persist-time
|
|
40
|
+
* checks run: a break-out tag (the canonical neutralizer changes the text IFF it carries one), a C0 / DEL control character
|
|
41
|
+
* (ordinary `\t` `\n` `\r` allowed), a length over the bound. `undefined` = none. Blankness ({@link isBlankInput}) and type are
|
|
42
|
+
* the caller's. Format characters (bidi marks, zero-width) are not defects: only control characters, the break-out tag and the bound.
|
|
43
|
+
*/
|
|
44
|
+
export declare function steeringTextDefect(text: string): SteeringTextDefect | undefined;
|
|
45
|
+
/** The defect as a clause a refusal sentence reads ("a reply that contains …"). */
|
|
46
|
+
export declare function steeringTextDefectClause(defect: SteeringTextDefect): string;
|
|
8
47
|
/** An author as read: a member of the set, or `unknown` for anything else. */
|
|
9
48
|
export type InputAuthorReading = InputAuthor | "unknown";
|
|
10
49
|
/** The one reader: a member reads as itself, anything else (`undefined` included) as `unknown`. */
|
|
@@ -57,9 +96,12 @@ export interface AuthoredRelayCall {
|
|
|
57
96
|
readonly signal?: AbortSignal;
|
|
58
97
|
}
|
|
59
98
|
/** The relay's answer, decided when the input is taken (never when it is read): the text that entered the leg — the caller's,
|
|
60
|
-
* or the prompt screen's rewrite of it
|
|
99
|
+
* or the prompt screen's rewrite of it —, the answer the prompt screen already gave it (`replied`: it entered, and the turn it
|
|
100
|
+
* opens is that answer, no model asked), or why it did not enter. */
|
|
61
101
|
export type AuthoredRelayAnswer = {
|
|
62
102
|
readonly entered: string;
|
|
103
|
+
} | {
|
|
104
|
+
readonly replied: string;
|
|
63
105
|
} | {
|
|
64
106
|
readonly drop: string;
|
|
65
107
|
};
|
|
@@ -1,9 +1,28 @@
|
|
|
1
1
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
|
+
import { sanitizeUntrustedText } from "./untrusted-text.js";
|
|
2
3
|
export const INPUT_AUTHORS = Object.freeze(["operator", "parent_model", "workflow", "peer", "observer", "engine", "extension"]);
|
|
3
4
|
const INPUT_AUTHOR_SET = new Set(INPUT_AUTHORS);
|
|
4
5
|
export function isInputAuthor(v) {
|
|
5
6
|
return INPUT_AUTHOR_SET.has(v);
|
|
6
7
|
}
|
|
8
|
+
const SAYS_NOTHING = /^[\s\p{Cc}]*$/u;
|
|
9
|
+
export function isBlankInput(text) {
|
|
10
|
+
return SAYS_NOTHING.test(text);
|
|
11
|
+
}
|
|
12
|
+
export const MAX_PENDING_STEER_CHARS = 16_000;
|
|
13
|
+
export const STEERING_CONTROL_CHARS_RE = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/;
|
|
14
|
+
export function steeringTextDefect(text) {
|
|
15
|
+
if (sanitizeUntrustedText(text) !== text)
|
|
16
|
+
return "break_out_tag";
|
|
17
|
+
if (STEERING_CONTROL_CHARS_RE.test(text))
|
|
18
|
+
return "control_chars";
|
|
19
|
+
if (text.length > MAX_PENDING_STEER_CHARS)
|
|
20
|
+
return "too_long";
|
|
21
|
+
return undefined;
|
|
22
|
+
}
|
|
23
|
+
export function steeringTextDefectClause(defect) {
|
|
24
|
+
return defect === "break_out_tag" ? "contains a system-reminder break-out tag" : defect === "control_chars" ? "contains control characters" : `is longer than ${MAX_PENDING_STEER_CHARS} characters`;
|
|
25
|
+
}
|
|
7
26
|
export function readInputAuthor(raw) {
|
|
8
27
|
return isInputAuthor(raw) ? raw : "unknown";
|
|
9
28
|
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The ONE reading of a task's ISOLATION SCOPE ({@link import("./task-spec.js").TaskSpec.isolationScope}): the member when it is set,
|
|
3
|
+
* else the principal. Every face that keys a run's working state on "which scope of this person's work" reads it here — the registry
|
|
4
|
+
* domain, the offload namespace, the checkpoint scope's last rung, the scheduler's keys, the delegation tree's domain, the MCP
|
|
5
|
+
* connection pool — and every face that keys on the PERSON keeps reading the principal.
|
|
6
|
+
*
|
|
7
|
+
* `||`, not `??`: the empty string is absence wearing clothes (the principal's own discipline, and the checkpoint scope's), so a blank
|
|
8
|
+
* member falls to the principal, and a task without the member answers its principal VERBATIM — the empty string included — which is
|
|
9
|
+
* exactly what each of those faces read before the member existed.
|
|
10
|
+
*
|
|
11
|
+
* Import-free: the tool modules reach it without pulling the runner in.
|
|
12
|
+
*/
|
|
13
|
+
/** The holder of the two identity members: a task spec, a spec seat, a resume config, a scheduler context. */
|
|
14
|
+
export interface IsolationScopeHolder {
|
|
15
|
+
readonly isolationScope?: string;
|
|
16
|
+
readonly principal?: string;
|
|
17
|
+
}
|
|
18
|
+
/** The isolation scope of `holder`: its member when set, else its principal (possibly `undefined`, possibly `""`). */
|
|
19
|
+
export declare function isolationScopeOf(holder: IsolationScopeHolder): string | undefined;
|
|
20
|
+
/**
|
|
21
|
+
* The isolation-scope member a parked row RECORDS, spread into the row: present only when the task set one that differs from its
|
|
22
|
+
* principal — the one case the principal alone does not restate. A row that records it carries a reader requirement (a reader that
|
|
23
|
+
* cannot read it would resume the leg in the principal's scope); every other row stays exactly the row it was.
|
|
24
|
+
*/
|
|
25
|
+
export declare function isolationScopeRecordOf(holder: IsolationScopeHolder): {
|
|
26
|
+
isolationScope?: string;
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* The scope a registry-facing tool acts in: the running task's isolation scope the Runner put on the tool's context, else the scope
|
|
30
|
+
* the tool was mounted with. The context's `principal` is the person and is never read here — a tool handed a context outside a
|
|
31
|
+
* Runner task names its scope on `isolationScope` (or mounts with one).
|
|
32
|
+
*
|
|
33
|
+
* `??`, not `||`: the context's value is a RESOLVED scope — what {@link isolationScopeOf} answered for the task — and is carried as handed,
|
|
34
|
+
* the empty string included (a task whose principal is the empty string has always keyed its state under it, and its mounted scope is the
|
|
35
|
+
* same string). The `||` above reads a member INPUT, where the empty string is absence wearing clothes; the two are different quantities.
|
|
36
|
+
*/
|
|
37
|
+
export declare function callScopeOf(ctx: {
|
|
38
|
+
readonly isolationScope?: string;
|
|
39
|
+
} | undefined, mounted: {
|
|
40
|
+
readonly scope?: string;
|
|
41
|
+
}): string | undefined;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export function isolationScopeOf(holder) {
|
|
2
|
+
return holder.isolationScope || holder.principal;
|
|
3
|
+
}
|
|
4
|
+
export function isolationScopeRecordOf(holder) {
|
|
5
|
+
const own = holder.isolationScope || undefined;
|
|
6
|
+
return own !== undefined && own !== (holder.principal || undefined) ? { isolationScope: own } : {};
|
|
7
|
+
}
|
|
8
|
+
export function callScopeOf(ctx, mounted) {
|
|
9
|
+
return ctx?.isolationScope ?? mounted.scope;
|
|
10
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The JSON Schema keywords whose VALUE is a subschema position, and in which form — the one table every walk over a
|
|
3
|
+
* schema reads to know where a subschema can sit (the MCP payload sanitizer, the tool-schema wire projection). A keyword
|
|
4
|
+
* absent here holds data, never a schema: a walk leaves that subtree byte-exact.
|
|
5
|
+
*
|
|
6
|
+
* - `"properties"` — an object from a NAME (a parameter, a `$defs` id) to a subschema.
|
|
7
|
+
* - `"schemaMap"` — an object from a key that is DATA (today `patternProperties`' regular expressions) to a subschema.
|
|
8
|
+
* - `"schema"` — a subschema, or an array of subschemas.
|
|
9
|
+
*/
|
|
10
|
+
export type JsonSchemaSubschemaSeat = "properties" | "schemaMap" | "schema";
|
|
11
|
+
export declare const JSON_SCHEMA_SUBSCHEMA_SEATS: ReadonlyMap<string, JsonSchemaSubschemaSeat>;
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export const JSON_SCHEMA_SUBSCHEMA_SEATS = new Map([
|
|
2
|
+
...["properties", "definitions", "$defs", "dependentSchemas"].map((k) => [k, "properties"]),
|
|
3
|
+
...["patternProperties"].map((k) => [k, "schemaMap"]),
|
|
4
|
+
...["items", "prefixItems", "additionalItems", "additionalProperties", "unevaluatedItems", "unevaluatedProperties", "contains", "propertyNames", "contentSchema", "not", "if", "then", "else", "allOf", "anyOf", "oneOf"].map((k) => [k, "schema"]),
|
|
5
|
+
]);
|
|
@@ -4,14 +4,15 @@
|
|
|
4
4
|
* mods layer).
|
|
5
5
|
*/
|
|
6
6
|
import type { HookInvocationIdentity } from "./hooks.js";
|
|
7
|
-
import type {
|
|
7
|
+
import type { EngineNotice } from "./engine-notice.js";
|
|
8
|
+
import type { NoticeDestinationJudge, SessionAddress } from "./task-notification.js";
|
|
8
9
|
import type { AskSourceIdentity } from "./tool-policy.js";
|
|
9
10
|
/**
|
|
10
11
|
* The id a delegated leg's events carry as `agentId`: the leg's task id ({@link legTaskIdOf}) — for a background child, the
|
|
11
12
|
* registry task id its spawner registered it under (the string its row, launch card, notifications, `TaskStop` and
|
|
12
|
-
* `SendMessage` use); a foreground child has no
|
|
13
|
-
* the leg's identity, so a face minted before the leg's hook envelope (the
|
|
14
|
-
* row's summary asks it with the two the row records.
|
|
13
|
+
* `SendMessage` use); a foreground child has no registry identity (INTEGRATION-CORE §1.6a), so it is its session id. A
|
|
14
|
+
* top-level leg carries none. It reads two facts of the leg's identity, so a face minted before the leg's hook envelope (the
|
|
15
|
+
* ask source) asks it with the same two, and a parked row's summary asks it with the two the row records.
|
|
15
16
|
*/
|
|
16
17
|
export declare function agentIdOf(identity: Pick<HookInvocationIdentity, "taskId" | "isDelegatedChild"> | undefined): string | undefined;
|
|
17
18
|
/** A leg's task id — the row a delegation lane runs it as (`internals.rowTaskId`), else its host's `spec.taskId`, else its
|
|
@@ -27,6 +28,37 @@ export declare function legTaskIdOf(spec: {
|
|
|
27
28
|
}, internals: {
|
|
28
29
|
readonly rowTaskId?: string | undefined;
|
|
29
30
|
} | undefined, sessionId: string | undefined): string | undefined;
|
|
31
|
+
/** The members of the SYNCHRONOUS-CHILD BLOCK a parked row records beside its identity, in the spelling of the run internals they are read from
|
|
32
|
+
* ({@link import("./runner/contracts.js").RunInternals}): the spawning run's session and task, and the delegation tree's root session with
|
|
33
|
+
* the occupant of its row. One tuple, so the mint, the resume's restore, the row's member-shape table and the summary all name the same four. */
|
|
34
|
+
export declare const SYNC_CHILD_BLOCK_MEMBERS: readonly ["parentSessionId", "parentTaskId", "rootSessionId", "rootSessionIncarnation"];
|
|
35
|
+
export type SyncChildBlock = {
|
|
36
|
+
readonly [K in (typeof SYNC_CHILD_BLOCK_MEMBERS)[number]]?: string;
|
|
37
|
+
};
|
|
38
|
+
/**
|
|
39
|
+
* The block a SYNCHRONOUS child's park rows record: {@link SYNC_CHILD_BLOCK_MEMBERS}, each only when it is a non-blank string — ONE
|
|
40
|
+
* predicate, ONE mint, read at prepare and stamped on every row the leg parks (approval, `resource_limit`, `plan_review`). A synchronous
|
|
41
|
+
* child is a delegated leg that is neither a registry row (`rowTaskId` absent: a background child's parent and root are the key and the
|
|
42
|
+
* columns of its registry record) nor a workflow agent (`delegationTaskType` absent: a workflow's agent is a delegated leg with no row too,
|
|
43
|
+
* but it has no synchronous parent to answer to): the one leg whose parked row is the only place a consumer can read where it came from.
|
|
44
|
+
* A root run has no parent — its rows carry none of the four. On a resumed leg a member the live internals carry none of (a host resume
|
|
45
|
+
* hands the leg none) is read from the parked row's own record (`recorded`): the row holds the answer once, a resume reads it and never
|
|
46
|
+
* re-derives it. Pure over the leg's facts.
|
|
47
|
+
*/
|
|
48
|
+
export declare function syncChildBlockOf(leg: {
|
|
49
|
+
readonly isDelegatedChild: boolean;
|
|
50
|
+
readonly internals: ({
|
|
51
|
+
readonly rowTaskId?: string | undefined;
|
|
52
|
+
readonly delegationTaskType?: string | undefined;
|
|
53
|
+
} & SyncChildBlock) | undefined;
|
|
54
|
+
/** The parked row's own copy on a resumed leg. */
|
|
55
|
+
readonly recorded?: SyncChildBlock | undefined;
|
|
56
|
+
}): {
|
|
57
|
+
[K in (typeof SYNC_CHILD_BLOCK_MEMBERS)[number]]?: string;
|
|
58
|
+
};
|
|
59
|
+
/** The block a parked row recorded ({@link SYNC_CHILD_BLOCK_MEMBERS}, each only as a non-blank string), or `undefined` when it recorded none —
|
|
60
|
+
* what a resumed leg hands the park mint as {@link syncChildBlockOf}'s `recorded`. */
|
|
61
|
+
export declare function recordedSyncChildBlock(row: SyncChildBlock): SyncChildBlock | undefined;
|
|
30
62
|
/** The facts a leg's ask source is minted from — all the leg's own, read once its session and task id are minted. */
|
|
31
63
|
export interface AskSourceFacts {
|
|
32
64
|
/** The leg's end-user principal (its spec's). */
|
|
@@ -88,9 +120,25 @@ export interface NoticeRoute {
|
|
|
88
120
|
* at depth ≥ 2 has no host leg of its own to read it on) and carries the delegated leg's session and agent id — the shape a
|
|
89
121
|
* subagent's permission denial takes upstream (the top-level session id plus the agent id). The root is a session address
|
|
90
122
|
* like every other destination: its id and its occupant (`internals.rootSessionIncarnation`), so a notice of a tree whose
|
|
91
|
-
* root was deleted and created again is not delivered to the root's later occupant.
|
|
123
|
+
* root was deleted and created again is not delivered to the root's later occupant. The id is read as the run's internals carry
|
|
124
|
+
* it — a non-empty string or absent (`readRootOccupant` refuses a run whose root id is anything else) — so it is asked nothing here.
|
|
92
125
|
*/
|
|
93
126
|
export declare function noticeAddressOf(askSource: AskSourceIdentity, root: {
|
|
94
127
|
readonly rootSessionId?: string;
|
|
95
128
|
readonly rootSessionIncarnation?: string;
|
|
96
129
|
} | undefined): NoticeRoute;
|
|
130
|
+
/** A leg's user-face notice seat: where its notices go ({@link NoticeRoute}) and the admission every one is delivered under. */
|
|
131
|
+
export interface LegNotice {
|
|
132
|
+
readonly route: NoticeRoute;
|
|
133
|
+
/** Judged against the tree's root occupant (below); absent for a top-level leg and for a leg prepared outside a Runner. */
|
|
134
|
+
readonly admission: ((notice: EngineNotice) => boolean) | undefined;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* The leg's one notice seat, minted ONCE at prepare beside the ask source (`Prepared.legNotice`): every seat that tells the
|
|
138
|
+
* person something about this leg — the gate's stations, the shell's withheld-variables line — reads this address and this
|
|
139
|
+
* admission, so a delegated leg's notice is never addressed one way here and another way there.
|
|
140
|
+
*/
|
|
141
|
+
export declare function mintLegNotice(askSource: AskSourceIdentity, root: {
|
|
142
|
+
readonly rootSessionId?: string;
|
|
143
|
+
readonly rootSessionIncarnation?: string;
|
|
144
|
+
} | undefined, judge: NoticeDestinationJudge | undefined): LegNotice;
|
|
@@ -4,6 +4,27 @@ export function agentIdOf(identity) {
|
|
|
4
4
|
export function legTaskIdOf(spec, internals, sessionId) {
|
|
5
5
|
return internals?.rowTaskId ?? spec.taskId ?? sessionId;
|
|
6
6
|
}
|
|
7
|
+
export const SYNC_CHILD_BLOCK_MEMBERS = Object.freeze(["parentSessionId", "parentTaskId", "rootSessionId", "rootSessionIncarnation"]);
|
|
8
|
+
export function syncChildBlockOf(leg) {
|
|
9
|
+
if (!leg.isDelegatedChild || leg.internals?.rowTaskId !== undefined || leg.internals?.delegationTaskType !== undefined)
|
|
10
|
+
return {};
|
|
11
|
+
const block = {};
|
|
12
|
+
for (const name of SYNC_CHILD_BLOCK_MEMBERS) {
|
|
13
|
+
const value = leg.internals?.[name] ?? leg.recorded?.[name];
|
|
14
|
+
if (typeof value === "string" && value.trim() !== "")
|
|
15
|
+
block[name] = value;
|
|
16
|
+
}
|
|
17
|
+
return block;
|
|
18
|
+
}
|
|
19
|
+
export function recordedSyncChildBlock(row) {
|
|
20
|
+
const block = {};
|
|
21
|
+
for (const name of SYNC_CHILD_BLOCK_MEMBERS) {
|
|
22
|
+
const value = row[name];
|
|
23
|
+
if (typeof value === "string" && value.trim() !== "")
|
|
24
|
+
block[name] = value;
|
|
25
|
+
}
|
|
26
|
+
return Object.keys(block).length > 0 ? block : undefined;
|
|
27
|
+
}
|
|
7
28
|
export function mintAskSourceIdentity(leg) {
|
|
8
29
|
const agentId = agentIdOf({ taskId: leg.taskId, isDelegatedChild: leg.isDelegatedChild });
|
|
9
30
|
const sourceAgentName = leg.internals?.explicitAgentName ?? leg.internals?.agentName;
|
|
@@ -22,7 +43,17 @@ export function noticeAddressOf(askSource, root) {
|
|
|
22
43
|
throw new TypeError("noticeAddressOf: the leg's ask source carries no session");
|
|
23
44
|
if (askSource.isDelegatedChild !== true)
|
|
24
45
|
return { address: { sessionId: own } };
|
|
25
|
-
const rootId = root?.rootSessionId
|
|
46
|
+
const rootId = root?.rootSessionId;
|
|
26
47
|
const address = { sessionId: rootId ?? own, sourceSessionId: own, ...(askSource.agentId !== undefined ? { agentId: askSource.agentId } : {}) };
|
|
27
48
|
return rootId !== undefined && rootId !== own ? { address, destination: { sessionId: rootId, occupant: root?.rootSessionIncarnation } } : { address };
|
|
28
49
|
}
|
|
50
|
+
function legNoticeAdmission(route, judge) {
|
|
51
|
+
const { address, destination } = route;
|
|
52
|
+
if (destination === undefined || judge === undefined)
|
|
53
|
+
return undefined;
|
|
54
|
+
return (notice) => judge(destination, { taskId: address.agentId ?? address.sourceSessionId ?? address.sessionId, taskType: notice.code }) !== true;
|
|
55
|
+
}
|
|
56
|
+
export function mintLegNotice(askSource, root, judge) {
|
|
57
|
+
const route = noticeAddressOf(askSource, root);
|
|
58
|
+
return Object.freeze({ route, admission: legNoticeAdmission(route, judge) });
|
|
59
|
+
}
|
|
@@ -152,6 +152,17 @@ export declare function refusedDeclarer(refusal: unknown): string | undefined;
|
|
|
152
152
|
* read the same way; `at` is the surface the entry sits on, which only decides what the refusal calls the declarer.
|
|
153
153
|
*/
|
|
154
154
|
export declare function snapshotDeclaredEntry<E extends McpServerSpec | A2aServerSpec>(entry: E, at: ToolAxesSurface): E;
|
|
155
|
+
/** What every question about ONE snapshot MCP entry answers: the entry (carrying the reader's own copy of whatever was judged) or the coded
|
|
156
|
+
* refusal that names the server and the member. The one answer shape of {@link judgeMcpEntryDeclarations} and of each leg it runs. */
|
|
157
|
+
export type McpEntryJudgment = {
|
|
158
|
+
ok: true;
|
|
159
|
+
entry: McpServerSpec;
|
|
160
|
+
} | {
|
|
161
|
+
ok: false;
|
|
162
|
+
error: Error & {
|
|
163
|
+
code: string;
|
|
164
|
+
};
|
|
165
|
+
};
|
|
155
166
|
/**
|
|
156
167
|
* The `toolAxes` question for ONE snapshot entry of either surface (`at`: an MCP server, an A2A peer) — asked by the preparation door (a
|
|
157
168
|
* refusal ends the prepare) and by each materialization entrance (a refusal fails that server's or that peer's dial), so there is one
|
|
@@ -178,29 +189,20 @@ export declare function judgeEntryToolAxes<E extends McpServerSpec | A2aServerSp
|
|
|
178
189
|
* frozen copy in place of the declaration (an empty record declares nothing and leaves no key); `ok: false` carries the coded refusal
|
|
179
190
|
* (`config.tool_face_invalid`) naming the server, the tool and the member.
|
|
180
191
|
*/
|
|
181
|
-
export declare function judgeEntryToolFaces(copy: McpServerSpec):
|
|
182
|
-
ok: true;
|
|
183
|
-
entry: McpServerSpec;
|
|
184
|
-
} | {
|
|
185
|
-
ok: false;
|
|
186
|
-
error: Error & {
|
|
187
|
-
code: string;
|
|
188
|
-
};
|
|
189
|
-
};
|
|
192
|
+
export declare function judgeEntryToolFaces(copy: McpServerSpec): McpEntryJudgment;
|
|
190
193
|
/**
|
|
191
194
|
* The `sessionMetaKey` question for ONE snapshot MCP entry — asked by the door and the materialization entrance like its siblings, through
|
|
192
195
|
* the one judge ({@link judgeSessionMetaKey}); a key that cannot ride refuses under `config.invalid_argument`, naming the server and the key.
|
|
193
196
|
* The entry is unchanged (a string is already the engine's own copy).
|
|
194
197
|
*/
|
|
195
|
-
export declare function judgeEntrySessionMetaKey(copy: McpServerSpec):
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
};
|
|
198
|
+
export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): McpEntryJudgment;
|
|
199
|
+
/**
|
|
200
|
+
* The reserved-name question for ONE snapshot MCP entry, asked after its `toolAxes` and `toolFaces` were read: a declaration keyed by a
|
|
201
|
+
* reserved face word ({@link MCP_FACE_WORDS}) names a face of the server, never a tool — no tool of the server is ever mounted under that
|
|
202
|
+
* name, so the declaration could never be in force. Each face refuses through its own leg's one mint (`toolAxes` the generic
|
|
203
|
+
* `config.invalid_argument`, `toolFaces` its `config.tool_face_invalid`), naming the server and the word.
|
|
204
|
+
*/
|
|
205
|
+
export declare function judgeEntryReservedKeys(copy: McpServerSpec): McpEntryJudgment;
|
|
204
206
|
/**
|
|
205
207
|
* The host-transport question for ONE snapshot MCP entry: a `{ kind: "host" }` transport carries no member beyond its kind (its host seat
|
|
206
208
|
* carries its own pieces — a reference, a principal header, a command or a url would be declared and never in force), and its server
|
|
@@ -208,25 +210,18 @@ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
|
|
|
208
210
|
* host's own interface, and the engine advertises no elicitation for it). Either refuses under
|
|
209
211
|
* `config.invalid_argument`, naming the server and the member. Any other entry is unchanged.
|
|
210
212
|
*/
|
|
211
|
-
export declare function judgeEntryHostTransport(copy: McpServerSpec):
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
}
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
entry: McpServerSpec;
|
|
224
|
-
} | {
|
|
225
|
-
ok: false;
|
|
226
|
-
error: Error & {
|
|
227
|
-
code: string;
|
|
228
|
-
};
|
|
229
|
-
};
|
|
213
|
+
export declare function judgeEntryHostTransport(copy: McpServerSpec): McpEntryJudgment;
|
|
214
|
+
/**
|
|
215
|
+
* Everything a snapshot MCP entry declares beyond its plain data, judged: its `toolAxes` ({@link judgeEntryToolAxes}), its `toolFaces`
|
|
216
|
+
* ({@link judgeEntryToolFaces}), the keys of both against the reserved face words ({@link judgeEntryReservedKeys}), its `sessionMetaKey`
|
|
217
|
+
* ({@link judgeEntrySessionMetaKey}), its host transport ({@link judgeEntryHostTransport}) — in that order, the first refusal is the answer.
|
|
218
|
+
*
|
|
219
|
+
* The one judge of an entry's declarations, and the one a caller outside the engine asks (a request door, a resume reader): a part of it (the host
|
|
220
|
+
* transport alone) would leave the other three unasked. A `{ kind: "host" }` row answers `ok: true` carrying the entry when its transport carries its
|
|
221
|
+
* kind alone and the server does not opt in to `elicitation`; otherwise `ok: false` with the coded refusal (`config.invalid_argument`) naming the
|
|
222
|
+
* server and the member. A row of any other transport is judged on the other three declarations only.
|
|
223
|
+
*/
|
|
224
|
+
export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): McpEntryJudgment;
|
|
230
225
|
/** One received thing: what the receipt read, or the refusal it raised — kept, raised by the door where it would have been raised. */
|
|
231
226
|
export type Received<T> = {
|
|
232
227
|
readonly read: T;
|
|
@@ -271,7 +266,7 @@ export declare function snapshotAndValidateMcpEntries(declared: unknown, where?:
|
|
|
271
266
|
* screen calls this same function (`enter` naming each refusal's seat) and hands the leg its judged copies
|
|
272
267
|
* of the lists THIS resume handed (the row records none), so the leg's prepare judges engine-owned plain data and dials what was judged.
|
|
273
268
|
*/
|
|
274
|
-
export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: RunnerDeps, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
|
|
269
|
+
export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: Pick<RunnerDeps, "lockedConfig" | "toolPolicy" | "basePolicyForResumeEdit" | "peerSeat">, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
|
|
275
270
|
/**
|
|
276
271
|
* The two caller policies a prepare resolves to: the task's own seat over the deployment's, or the deployment's alone
|
|
277
272
|
* under a `toolPolicy` lock — one resolution, read by the preflight above (which a resume enters before its claim).
|