@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
package/dist/core/roles.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { selectModel } from "./select-model.js";
|
|
2
2
|
import { namesRoleBase } from "../prompt-assembly/role-base.js";
|
|
3
3
|
import { readPromptRole } from "../prompt-assembly/select.js";
|
|
4
|
-
import { bindingShown, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
|
|
4
|
+
import { bindingShown, forkModelSnapshot, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
|
|
5
|
+
import { MAX_MODEL_FALLBACKS, modelFallbackRefusal, recordedFallbackChainOf, recordFallbackChain } from "./model-fallbacks.js";
|
|
5
6
|
import { describeFault, receive } from "./mods/kernel/receive.js";
|
|
6
7
|
import { CONFIG_RECEIPT_MODE, DECLARATION_RECEIPT_MODE, receiveOwnProperties } from "./own-property-receipt.js";
|
|
7
8
|
import { MODEL_ROLES } from "./types.js";
|
|
@@ -12,8 +13,30 @@ function catalogEntry(ref, models) {
|
|
|
12
13
|
return m || undefined;
|
|
13
14
|
}
|
|
14
15
|
export function catalogModel(ref, models, seat, what = `${bindingShown(ref)} (a catalog entry)`) {
|
|
15
|
-
const
|
|
16
|
-
return
|
|
16
|
+
const at = entryAt(ref, models, seat, what);
|
|
17
|
+
return at === undefined ? undefined : chainedRead(at, models, seat, () => readSubject(ref, seat), (word) => entryAt(word, models, seat, `${bindingShown(word)} (a fallback of the catalog entry ${bindingShown(ref)})`)?.entry);
|
|
18
|
+
}
|
|
19
|
+
const readSubject = (ref, seat) => `the \`fallbacks\` of the catalog entry ${bindingShown(ref)} (read at ${seat})`;
|
|
20
|
+
function entryAt(ref, models, seat, what) {
|
|
21
|
+
const written = catalogEntry(ref, models);
|
|
22
|
+
return written === undefined ? undefined : { written, entry: receiveModel(written, seat, what, "", true) };
|
|
23
|
+
}
|
|
24
|
+
function chainedRead(at, models, seat, subject, hopOf) {
|
|
25
|
+
const { written, entry } = at;
|
|
26
|
+
const words = entry.fallbacks;
|
|
27
|
+
if (words === undefined || written === entry)
|
|
28
|
+
return entry;
|
|
29
|
+
return chainedSnapshot(entry, chainHops(entry, words, hopOf, models, seat, subject()));
|
|
30
|
+
}
|
|
31
|
+
export function isCatalogEntry(ref, models) {
|
|
32
|
+
return catalogEntry(ref, models) !== undefined;
|
|
33
|
+
}
|
|
34
|
+
export function catalogSliceOf(ref, models) {
|
|
35
|
+
const entry = catalogEntry(ref, models);
|
|
36
|
+
const slice = {};
|
|
37
|
+
if (entry !== undefined)
|
|
38
|
+
Object.defineProperty(slice, ref, { value: entry, enumerable: true, writable: true, configurable: true });
|
|
39
|
+
return slice;
|
|
17
40
|
}
|
|
18
41
|
const ROLE_RECORD_KEYS = new Set(["model", "select", "thinking", "promptRole", "systemPrompt"]);
|
|
19
42
|
function isBindingObject(value) {
|
|
@@ -35,7 +58,7 @@ function modelObjectAt(value, seat, binds) {
|
|
|
35
58
|
if (typeof value !== "object" || value === null || isList(value)) {
|
|
36
59
|
throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${bindingShown(value)}, not a model reference — ${binds}.`);
|
|
37
60
|
}
|
|
38
|
-
return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "");
|
|
61
|
+
return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "", binds === TIER_BINDS);
|
|
39
62
|
}
|
|
40
63
|
const ROLE_BINDS = "a role binds a catalog model name or a Model object";
|
|
41
64
|
const TIER_BINDS = "a tier binds a catalog model name or a Model object";
|
|
@@ -109,7 +132,7 @@ export function resolveModelDisplayLabel(ref) {
|
|
|
109
132
|
}
|
|
110
133
|
const TIERS_ACTIVE = Symbol.for("sema.tiersActive");
|
|
111
134
|
const TIER_ALIAS_VIA = Symbol.for("sema.tierAliasVia");
|
|
112
|
-
|
|
135
|
+
function expandTierKeys(models, tiers, laidOut) {
|
|
113
136
|
if (!tiers || Object.keys(tiers).length === 0)
|
|
114
137
|
return models;
|
|
115
138
|
const out = { ...models };
|
|
@@ -120,7 +143,13 @@ export function expandTiers(models, tiers) {
|
|
|
120
143
|
const b = Object.hasOwn(tiers, name) ? tiers[name] : undefined;
|
|
121
144
|
if (b === undefined)
|
|
122
145
|
return undefined;
|
|
123
|
-
|
|
146
|
+
const seat = `tiers.${name}`;
|
|
147
|
+
if (typeof b !== "string")
|
|
148
|
+
return { model: modelObjectAt(b, seat, TIER_BINDS), written: b };
|
|
149
|
+
const at = entryAt(b, models, seat, `${bindingShown(b)} (a catalog entry)`);
|
|
150
|
+
if (at === undefined)
|
|
151
|
+
throw unknownModelRefRefusal(b, seat);
|
|
152
|
+
return { model: at.entry, written: at.written };
|
|
124
153
|
};
|
|
125
154
|
const ownKey = (k) => models !== undefined && Object.hasOwn(models, k) && Boolean(models[k]);
|
|
126
155
|
const landing = (t, self) => {
|
|
@@ -128,7 +157,7 @@ export function expandTiers(models, tiers) {
|
|
|
128
157
|
if (!m)
|
|
129
158
|
return undefined;
|
|
130
159
|
const b = Object.hasOwn(tiers, t) ? tiers[t] : undefined;
|
|
131
|
-
return {
|
|
160
|
+
return { ...m, via: [...(t !== self && !ownKey(t) ? [t] : []), ...(typeof b === "string" ? [b] : [])], seat: `tiers.${t}` };
|
|
132
161
|
};
|
|
133
162
|
const resolveTier = (name, self = name) => {
|
|
134
163
|
const direct = landing(name, self);
|
|
@@ -140,14 +169,15 @@ export function expandTiers(models, tiers) {
|
|
|
140
169
|
for (let i = at + 1; i < DEFAULT_TIER_ORDER.length; i++) {
|
|
141
170
|
const next = landing(DEFAULT_TIER_ORDER[i], self);
|
|
142
171
|
if (next)
|
|
143
|
-
return {
|
|
172
|
+
return { ...next, via: [...(name !== self && !ownKey(name) ? [name] : []), ...next.via] };
|
|
144
173
|
}
|
|
145
174
|
return undefined;
|
|
146
175
|
};
|
|
147
176
|
const shadowed = (key) => Object.hasOwn(out, key) && Boolean(out[key]);
|
|
148
|
-
const put = (key,
|
|
149
|
-
Object.defineProperty(out, key, { value:
|
|
150
|
-
aliasVia.set(key, via);
|
|
177
|
+
const put = (key, r) => {
|
|
178
|
+
Object.defineProperty(out, key, { value: r.model, writable: true, enumerable: true, configurable: true });
|
|
179
|
+
aliasVia.set(key, r.via);
|
|
180
|
+
laidOut?.set(key, r);
|
|
151
181
|
};
|
|
152
182
|
const tierNames = new Set([...DEFAULT_TIER_ORDER, ...Object.keys(tiers)]);
|
|
153
183
|
for (const name of tierNames) {
|
|
@@ -155,26 +185,39 @@ export function expandTiers(models, tiers) {
|
|
|
155
185
|
continue;
|
|
156
186
|
const r = resolveTier(name);
|
|
157
187
|
if (r)
|
|
158
|
-
put(name, r
|
|
188
|
+
put(name, r);
|
|
159
189
|
}
|
|
160
190
|
for (const [alias, tier] of Object.entries(CC_MODEL_TIER_ALIASES)) {
|
|
161
191
|
if (shadowed(alias))
|
|
162
192
|
continue;
|
|
163
193
|
const r = resolveTier(tier, alias);
|
|
164
194
|
if (r)
|
|
165
|
-
put(alias, r
|
|
195
|
+
put(alias, r);
|
|
166
196
|
}
|
|
167
197
|
if (!shadowed("best")) {
|
|
168
198
|
for (const name of DEFAULT_TIER_ORDER) {
|
|
169
199
|
const r = landing(name, "best");
|
|
170
200
|
if (r) {
|
|
171
|
-
put("best", r
|
|
201
|
+
put("best", r);
|
|
172
202
|
break;
|
|
173
203
|
}
|
|
174
204
|
}
|
|
175
205
|
}
|
|
176
206
|
return out;
|
|
177
207
|
}
|
|
208
|
+
export function expandTiers(models, tiers) {
|
|
209
|
+
const laidOut = new Map();
|
|
210
|
+
const out = expandTierKeys(models, tiers, laidOut);
|
|
211
|
+
if (out === undefined || out === models)
|
|
212
|
+
return out;
|
|
213
|
+
for (const [key, { model, seat, written }] of laidOut) {
|
|
214
|
+
const subject = () => `the \`fallbacks\` of the model the tier key ${bindingShown(key)} lays out (${seat})`;
|
|
215
|
+
const chained = chainedRead({ written, entry: model }, out, seat, subject, (word) => entryAt(word, out, seat, `${bindingShown(word)} (a fallback of the model the tier key ${bindingShown(key)} lays out)`)?.entry);
|
|
216
|
+
if (chained !== model)
|
|
217
|
+
Object.defineProperty(out, key, { value: chained, writable: true, enumerable: true, configurable: true });
|
|
218
|
+
}
|
|
219
|
+
return out;
|
|
220
|
+
}
|
|
178
221
|
const RECEIVED_CATALOGS = new WeakSet();
|
|
179
222
|
export function isReceivedCatalog(models) {
|
|
180
223
|
return models !== undefined && RECEIVED_CATALOGS.has(models);
|
|
@@ -189,7 +232,7 @@ export function receiveModelCatalog(models, tiers, field) {
|
|
|
189
232
|
held = {};
|
|
190
233
|
for (const key of Object.keys(given)) {
|
|
191
234
|
const m = given[key];
|
|
192
|
-
Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)
|
|
235
|
+
Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)`, "", true) : m, enumerable: true, writable: true, configurable: true });
|
|
193
236
|
}
|
|
194
237
|
}
|
|
195
238
|
let bindings;
|
|
@@ -202,11 +245,87 @@ export function receiveModelCatalog(models, tiers, field) {
|
|
|
202
245
|
}
|
|
203
246
|
Object.freeze(bindings);
|
|
204
247
|
}
|
|
205
|
-
const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ?
|
|
206
|
-
if (expanded !== undefined)
|
|
248
|
+
const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ? expandTierKeys(held, bindings) : held;
|
|
249
|
+
if (expanded !== undefined) {
|
|
250
|
+
resolveFallbackChains(expanded, field);
|
|
207
251
|
RECEIVED_CATALOGS.add(Object.freeze(expanded));
|
|
252
|
+
}
|
|
208
253
|
return { ...(expanded !== undefined ? { models: expanded } : {}), ...(bindings !== undefined ? { tiers: bindings } : {}) };
|
|
209
254
|
}
|
|
255
|
+
function resolveFallbackChains(catalog, field) {
|
|
256
|
+
const firstKey = new Map();
|
|
257
|
+
for (const key of Object.keys(catalog)) {
|
|
258
|
+
const entry = catalogEntry(key, catalog);
|
|
259
|
+
if (entry !== undefined)
|
|
260
|
+
firstKey.set(entry, firstKey.get(entry) ?? key);
|
|
261
|
+
}
|
|
262
|
+
const resolved = new Map();
|
|
263
|
+
for (const [entry, key] of firstKey) {
|
|
264
|
+
const words = entry.fallbacks;
|
|
265
|
+
if (words === undefined)
|
|
266
|
+
continue;
|
|
267
|
+
const seat = `${field}.models.${key}.fallbacks`;
|
|
268
|
+
resolved.set(entry, chainHops(entry, words, (word) => catalogEntry(word, catalog), catalog, seat, seat));
|
|
269
|
+
}
|
|
270
|
+
const forks = new Map();
|
|
271
|
+
for (const [entry, hops] of resolved) {
|
|
272
|
+
const chained = chainedSnapshot(entry, hops);
|
|
273
|
+
if (chained !== entry)
|
|
274
|
+
forks.set(entry, chained);
|
|
275
|
+
}
|
|
276
|
+
if (forks.size === 0)
|
|
277
|
+
return;
|
|
278
|
+
for (const key of Object.keys(catalog)) {
|
|
279
|
+
const fork = forks.get(Object.getOwnPropertyDescriptor(catalog, key)?.value);
|
|
280
|
+
if (fork !== undefined)
|
|
281
|
+
Object.defineProperty(catalog, key, { value: fork, writable: true, enumerable: true, configurable: true });
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
function chainHops(entry, words, hopOf, catalog, field, subject) {
|
|
285
|
+
if (words.length > MAX_MODEL_FALLBACKS) {
|
|
286
|
+
throw modelFallbackRefusal(field, `${subject} names ${words.length} models — a chain holds at most ${MAX_MODEL_FALLBACKS} (more is refused, never cut).`);
|
|
287
|
+
}
|
|
288
|
+
const hops = [];
|
|
289
|
+
for (const word of words) {
|
|
290
|
+
const hop = hopOf(word);
|
|
291
|
+
if (hop === undefined)
|
|
292
|
+
throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, which this catalog does not hold — a fallback is a catalog word.${unexpandedTierWordNote(word, catalog)}`);
|
|
293
|
+
if (hop === entry || hop.id === entry.id)
|
|
294
|
+
throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, which is the model ${bindingShown(entry.id)} itself — a fallback is another model.`);
|
|
295
|
+
if (hops.some((h) => h === hop || h.id === hop.id))
|
|
296
|
+
throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, the model ${bindingShown(hop.id)} a word before it already names — each hop is a different model.`);
|
|
297
|
+
hops.push(hop);
|
|
298
|
+
}
|
|
299
|
+
return hops;
|
|
300
|
+
}
|
|
301
|
+
function chainedSnapshot(entry, hops) {
|
|
302
|
+
const before = recordedFallbackChainOf(entry);
|
|
303
|
+
if (before === undefined) {
|
|
304
|
+
recordFallbackChain(entry, hops);
|
|
305
|
+
return entry;
|
|
306
|
+
}
|
|
307
|
+
return sameHops(before, hops) ? entry : chainedFork(entry, hops);
|
|
308
|
+
}
|
|
309
|
+
function sameHops(a, b) {
|
|
310
|
+
return a.length === b.length && a.every((h, i) => h === b[i]);
|
|
311
|
+
}
|
|
312
|
+
const FORKS = new WeakMap();
|
|
313
|
+
function chainedFork(entry, hops) {
|
|
314
|
+
const known = FORKS.get(entry) ?? [];
|
|
315
|
+
const found = known.find((f) => sameHops(recordedFallbackChainOf(f) ?? [], hops));
|
|
316
|
+
if (found !== undefined)
|
|
317
|
+
return found;
|
|
318
|
+
const fork = forkModelSnapshot(entry);
|
|
319
|
+
recordFallbackChain(fork, hops);
|
|
320
|
+
FORKS.set(entry, [...known, fork]);
|
|
321
|
+
return fork;
|
|
322
|
+
}
|
|
323
|
+
function unexpandedTierWordNote(word, catalog) {
|
|
324
|
+
const tierWord = DEFAULT_TIER_ORDER.includes(word) || Object.hasOwn(CC_MODEL_TIER_ALIASES, word) || word === "best";
|
|
325
|
+
if (!tierWord || catalog?.[TIERS_ACTIVE] === true)
|
|
326
|
+
return "";
|
|
327
|
+
return ` ${bindingShown(word)} is a tier word, and this catalog was handed over without its tier expansion: hand over the tier bindings beside it (\`tiers\`), or its expansion (\`expandTiers(models, tiers)\`), and the word is one of its keys.`;
|
|
328
|
+
}
|
|
210
329
|
export function tierAliasVia(word, models) {
|
|
211
330
|
const via = models?.[TIER_ALIAS_VIA];
|
|
212
331
|
return via?.get(word) ?? [];
|
|
@@ -332,13 +451,21 @@ function partsModel(parts, models, seat = "a role seat") {
|
|
|
332
451
|
if (needs != null && !Array.isArray(needs)) {
|
|
333
452
|
throw modelBindingRefusal(`${seat}.select`, "not_a_model_ref", `${seat}.select.needs is ${bindingShown(needs)}, not a list of capabilities (vision / reasoning).`);
|
|
334
453
|
}
|
|
454
|
+
const at = `${seat}.select`;
|
|
335
455
|
const held = [];
|
|
456
|
+
const byKey = new Map();
|
|
336
457
|
for (const key of models != null && typeof models === "object" ? Object.keys(models) : []) {
|
|
337
|
-
const
|
|
338
|
-
if (
|
|
339
|
-
|
|
458
|
+
const read = entryAt(key, models, at, `the catalog entry ${bindingShown(key)} the criteria read`);
|
|
459
|
+
if (read === undefined)
|
|
460
|
+
continue;
|
|
461
|
+
held.push(read.entry);
|
|
462
|
+
byKey.set(key, read);
|
|
340
463
|
}
|
|
341
|
-
|
|
464
|
+
const picked = selectModel(held, parts.select);
|
|
465
|
+
if (picked === undefined)
|
|
466
|
+
return undefined;
|
|
467
|
+
const [key, read] = [...byKey].find(([, r]) => r.entry === picked);
|
|
468
|
+
return chainedRead(read, models, at, () => readSubject(key, at), (word) => byKey.get(word)?.entry ?? entryAt(word, models, at, `${bindingShown(word)} (a fallback of the catalog entry ${bindingShown(key)})`)?.entry);
|
|
342
469
|
}
|
|
343
470
|
return undefined;
|
|
344
471
|
}
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The shape reading of a persisted row, written once per row family: a MEMBER-SHAPE TABLE beside the family's row type, and
|
|
3
|
+
* one factory ({@link rowShapeReader}) that turns it into the family's only reader. Every face of a store that reaches into a
|
|
4
|
+
* stored row's members — the replay's row judge, a listing, a `get`, a transition that reads a member before it writes — asks
|
|
5
|
+
* that reader, so no face answers "this row reads" for a row another face cannot read.
|
|
6
|
+
*
|
|
7
|
+
* NAMED SEGMENTS, IN ORDER. A table is a list of named segments. The `rowKey` segment is the family's row predicate as the
|
|
8
|
+
* replay reads it (what files a row under its key); the others are the members the readers reach for. A face judges exactly
|
|
9
|
+
* the segments it judged before this table existed, named at the call — the replay judges `rowKey` alone, so a row the replay
|
|
10
|
+
* kept is still kept; a listing or a `get` judges every segment. Event envelopes (the tag, the event's own key, a delete arm)
|
|
11
|
+
* and container predicates (a document's own shape) are not rows and stay with their store.
|
|
12
|
+
*
|
|
13
|
+
* EXITS, PER MEMBER, FROM A CLOSED SET ({@link ROW_EXITS}). A table names the exit of a row that does not read; an entry may name
|
|
14
|
+
* another for its member; a row's exit is the exit of the FIRST member that does not read. `list-damaged`: the row stays where
|
|
15
|
+
* it is, a listing answers it by its identity and a damaged verdict, a `get` and every verb that reads its members refuse in the
|
|
16
|
+
* family's code, deletion by key goes on. `block`: an ordered log's exit — the readable prefix is served and nothing is served,
|
|
17
|
+
* leased, acknowledged or counted past the first record that does not read. `omit` and `refuse-container` are the exits of a
|
|
18
|
+
* rule family's row (one row left out with a disclosure on every read; the whole container refused); no table here uses them yet.
|
|
19
|
+
*
|
|
20
|
+
* NOTHING IS ERASED FOR NOT READING: a reader answers; it never removes a row, and no face removes a row because it does not read.
|
|
21
|
+
*
|
|
22
|
+
* WORDS: the corrupt forms are the store contract's ({@link CorruptBodyForm}) — a member that is absent where the table requires
|
|
23
|
+
* it is `missing-required`; one of another type, outside its closed set, or contradicting the row's key is `wrong-type`; a row
|
|
24
|
+
* that is no object is `not-an-object`. An answer's `why` names the member by its path and its shape, never by its value.
|
|
25
|
+
*/
|
|
26
|
+
import type { CorruptBodyForm } from "./store-contracts/read-back-shape-contract.js";
|
|
27
|
+
/** The exits of a row that does not read (closed; see the module note). */
|
|
28
|
+
export declare const ROW_EXITS: readonly ["list-damaged", "block", "omit", "refuse-container"];
|
|
29
|
+
export type RowExit = (typeof ROW_EXITS)[number];
|
|
30
|
+
/** What a store knows about a row besides its body: the key it files the row under, and the members its medium holds as the
|
|
31
|
+
* authority over the body (a SQL row's primary key, partition scope and OCC revision columns — never a lossy display column). */
|
|
32
|
+
export interface RowContext {
|
|
33
|
+
readonly key: string;
|
|
34
|
+
readonly authoritative?: Readonly<Record<string, unknown>>;
|
|
35
|
+
}
|
|
36
|
+
/** A row that does not read: the corrupt form, the segment and member that failed first, the exit it takes, and why. */
|
|
37
|
+
export interface RowCorrupt {
|
|
38
|
+
readonly corrupt: CorruptBodyForm;
|
|
39
|
+
readonly segment: string;
|
|
40
|
+
readonly member: string;
|
|
41
|
+
readonly exit: RowExit;
|
|
42
|
+
readonly why: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* A reader's answer: `row` — the row as its readers read it (the stored object itself, or a shallow copy carrying the readings of
|
|
46
|
+
* members that were absent, that a member's own reader normalizes, or that the medium holds authoritatively) — or a corrupt row.
|
|
47
|
+
*/
|
|
48
|
+
export type RowAnswer<T> = {
|
|
49
|
+
readonly row: T;
|
|
50
|
+
} | RowCorrupt;
|
|
51
|
+
/** A listed row's verdict: `ok`, or `damaged` with the family's code, the member that failed first, its corrupt form and the
|
|
52
|
+
* family's fixed engine sentence (the sentence a refusal of the same row starts with). Closed words and engine text only. */
|
|
53
|
+
export type RowVerdict = {
|
|
54
|
+
readonly kind: "ok";
|
|
55
|
+
} | DamagedRowVerdict;
|
|
56
|
+
/** The verdict of a row that does not read. A listing's damaged entry carries it as `rowVerdict` — the member a readable entry never
|
|
57
|
+
* has, so `"rowVerdict" in entry` is the narrowing. */
|
|
58
|
+
export interface DamagedRowVerdict {
|
|
59
|
+
readonly kind: "damaged";
|
|
60
|
+
readonly code: string;
|
|
61
|
+
readonly member: string;
|
|
62
|
+
readonly form: CorruptBodyForm;
|
|
63
|
+
readonly sentence: string;
|
|
64
|
+
}
|
|
65
|
+
/** One member's reading: it reads as stored, it reads AS a value (an absent member's reading, a reader's normalization), or not. */
|
|
66
|
+
export type MemberReading = {
|
|
67
|
+
readonly reads: true;
|
|
68
|
+
readonly as?: unknown;
|
|
69
|
+
readonly replaced?: true;
|
|
70
|
+
} | {
|
|
71
|
+
readonly form: CorruptBodyForm;
|
|
72
|
+
readonly why: string;
|
|
73
|
+
};
|
|
74
|
+
/** One entry of a table: the member's name (its path, for an answer) and its judgment over the record and the row's context. */
|
|
75
|
+
export interface MemberEntry {
|
|
76
|
+
readonly member: string;
|
|
77
|
+
readonly exit?: RowExit;
|
|
78
|
+
readonly judge: (row: Readonly<Record<string, unknown>>, ctx: RowContext) => MemberReading;
|
|
79
|
+
}
|
|
80
|
+
/** A named segment of a table (see the module note). */
|
|
81
|
+
export interface RowSegment {
|
|
82
|
+
readonly name: string;
|
|
83
|
+
readonly entries: readonly MemberEntry[];
|
|
84
|
+
}
|
|
85
|
+
/** A family's member-shape table. `admitOnly` entries are invariants only the write gate holds a candidate to. */
|
|
86
|
+
export interface RowShapeTable {
|
|
87
|
+
readonly family: string;
|
|
88
|
+
/** The family's refusal code — one code for the write gate and every read face. */
|
|
89
|
+
readonly code: string;
|
|
90
|
+
/** The fixed engine sentence of a refusal and of a damaged verdict — never built from the row. */
|
|
91
|
+
readonly sentence: string;
|
|
92
|
+
readonly segments: readonly RowSegment[];
|
|
93
|
+
readonly exit: RowExit;
|
|
94
|
+
readonly admitOnly?: readonly MemberEntry[];
|
|
95
|
+
}
|
|
96
|
+
/** A family's reader ({@link rowShapeReader}). */
|
|
97
|
+
export interface RowShapeReader<T> {
|
|
98
|
+
readonly table: RowShapeTable;
|
|
99
|
+
/** Judge `raw` over the named segments (default: every segment, in table order). Total over JSON values. */
|
|
100
|
+
read(raw: unknown, ctx: RowContext, segments?: readonly string[]): RowAnswer<T>;
|
|
101
|
+
/** Judge a write's candidate — the row as the store is about to keep it, its key and revision already placed by the store's own
|
|
102
|
+
* rule — over the named segments, then the `admitOnly` entries. The answered row is what the store keeps. */
|
|
103
|
+
admit(candidate: unknown, ctx: RowContext, segments?: readonly string[]): RowAnswer<T>;
|
|
104
|
+
/** The family's row predicate (the `rowKey` segment alone): what the replay files under its key. */
|
|
105
|
+
rowKey(raw: unknown): boolean;
|
|
106
|
+
/** The verdict a listing carries for an answer. */
|
|
107
|
+
verdictOf(answer: RowAnswer<T>): RowVerdict;
|
|
108
|
+
/** The damaged verdict of a corrupt row (what a listing carries for it). */
|
|
109
|
+
damagedVerdict(corrupt: RowCorrupt): DamagedRowVerdict;
|
|
110
|
+
/** The text of a refusal of a corrupt row: the fixed sentence, then the member's diagnostic. */
|
|
111
|
+
refusalText(corrupt: RowCorrupt): string;
|
|
112
|
+
}
|
|
113
|
+
/** Is an answer a corrupt row? */
|
|
114
|
+
export declare function isRowCorrupt<T>(answer: RowAnswer<T>): answer is RowCorrupt;
|
|
115
|
+
/** A face's check that a corrupt row takes the exit the face implements: the exit is the table's declaration, so a member whose
|
|
116
|
+
* declared exit this face does not implement is an engine defect, refused here rather than answered by another exit's rule. */
|
|
117
|
+
export declare function takesExit(corrupt: RowCorrupt, exit: RowExit, face: string): void;
|
|
118
|
+
/**
|
|
119
|
+
* The family's reader over its table: the only mechanism; the table carries the family's facts.
|
|
120
|
+
*/
|
|
121
|
+
export declare function rowShapeReader<T>(table: RowShapeTable): RowShapeReader<T>;
|
|
122
|
+
/** A value shape: `undefined` = the value reads; otherwise the phrase that follows "its <member>" (a path step, or " is not …"). */
|
|
123
|
+
export type ValueShape = (value: unknown) => string | undefined;
|
|
124
|
+
export declare const isString: ValueShape;
|
|
125
|
+
export declare const isNonBlankString: ValueShape;
|
|
126
|
+
export declare const isBoolean: ValueShape;
|
|
127
|
+
export declare const isFiniteNumber: ValueShape;
|
|
128
|
+
/** A non-negative safe integer (a revision, a generation). */
|
|
129
|
+
export declare const isCount: ValueShape;
|
|
130
|
+
export declare const isRecord: ValueShape;
|
|
131
|
+
/** A member of a closed word set. */
|
|
132
|
+
export declare function isWord(words: readonly string[]): ValueShape;
|
|
133
|
+
/** A list whose every element reads as `element`. */
|
|
134
|
+
export declare function isListOf(element: ValueShape): ValueShape;
|
|
135
|
+
/** A record whose named members read as their shapes (a member absent from `optional` is required). */
|
|
136
|
+
export declare function isRecordOf(members: Readonly<Record<string, ValueShape>>, optional?: readonly string[]): ValueShape;
|
|
137
|
+
/** A member the row must carry, of `shape`. */
|
|
138
|
+
export declare function required(member: string, shape: ValueShape, exit?: RowExit): MemberEntry;
|
|
139
|
+
/** A member the row may omit; present, it is of `shape`. */
|
|
140
|
+
export declare function optional(member: string, shape: ValueShape, exit?: RowExit): MemberEntry;
|
|
141
|
+
/** A member whose ABSENCE reads as a value (what the absence means, in a read and a write alike); present, it is of `shape`.
|
|
142
|
+
* `fill` may throw (the absence has no reading for this row): the row then does not read, `missing-required`. */
|
|
143
|
+
export declare function absentReads(member: string, fill: (row: Readonly<Record<string, unknown>>) => unknown, shape: ValueShape): MemberEntry;
|
|
144
|
+
/** A member a reader of its own reads (`reader` answers its reading or throws its refusal): a throw is a member that does not
|
|
145
|
+
* read; a reading other than the stored value (the reader's registered normalization) is what the row reads as. */
|
|
146
|
+
export declare function via(member: string, reader: (value: unknown) => unknown): MemberEntry;
|
|
147
|
+
/** A judgment over the whole row and its context (a member against the key, a member against another): `check` answers
|
|
148
|
+
* `undefined` or the sentence that says what does not read. */
|
|
149
|
+
export declare function pair(member: string, check: (row: Readonly<Record<string, unknown>>, ctx: RowContext) => string | undefined, form?: CorruptBodyForm): MemberEntry;
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { thrownName } from "./thrown-value.js";
|
|
2
|
+
export const ROW_EXITS = Object.freeze(["list-damaged", "block", "omit", "refuse-container"]);
|
|
3
|
+
const READS = Object.freeze({ reads: true });
|
|
4
|
+
const OK_VERDICT = Object.freeze({ kind: "ok" });
|
|
5
|
+
export function isRowCorrupt(answer) {
|
|
6
|
+
return "corrupt" in answer;
|
|
7
|
+
}
|
|
8
|
+
export function takesExit(corrupt, exit, face) {
|
|
9
|
+
if (corrupt.exit !== exit)
|
|
10
|
+
throw new TypeError(`${face}: the row's member ${corrupt.member} declares the exit ${corrupt.exit}, which this face does not implement (it implements ${exit})`);
|
|
11
|
+
}
|
|
12
|
+
function isRecordValue(value) {
|
|
13
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
14
|
+
}
|
|
15
|
+
function coveredBy(raw, authoritative) {
|
|
16
|
+
const out = { ...raw };
|
|
17
|
+
for (const [member, value] of Object.entries(authoritative)) {
|
|
18
|
+
if (value === null || value === undefined)
|
|
19
|
+
Reflect.deleteProperty(out, member);
|
|
20
|
+
else
|
|
21
|
+
out[member] = value;
|
|
22
|
+
}
|
|
23
|
+
return out;
|
|
24
|
+
}
|
|
25
|
+
export function rowShapeReader(table) {
|
|
26
|
+
const names = new Set(table.segments.map((s) => s.name));
|
|
27
|
+
const selected = (segments) => {
|
|
28
|
+
if (segments === undefined)
|
|
29
|
+
return table.segments;
|
|
30
|
+
for (const name of segments)
|
|
31
|
+
if (!names.has(name))
|
|
32
|
+
throw new TypeError(`row shape table ${table.family}: no segment named ${JSON.stringify(name)}`);
|
|
33
|
+
return table.segments.filter((s) => segments.includes(s.name));
|
|
34
|
+
};
|
|
35
|
+
const judge = (raw, ctx, segments, admitOnly) => {
|
|
36
|
+
if (!isRecordValue(raw))
|
|
37
|
+
return { corrupt: "not-an-object", segment: segments[0]?.name ?? "admitOnly", member: "(row)", exit: table.exit, why: "the row is not an object" };
|
|
38
|
+
let readAs = ctx.authoritative === undefined ? undefined : coveredBy(raw, ctx.authoritative);
|
|
39
|
+
const pass = (segment, entries) => {
|
|
40
|
+
for (const entry of entries) {
|
|
41
|
+
const reading = entry.judge(readAs ?? raw, ctx);
|
|
42
|
+
if ("form" in reading)
|
|
43
|
+
return { corrupt: reading.form, segment, member: entry.member, exit: entry.exit ?? table.exit, why: reading.why };
|
|
44
|
+
if (reading.replaced === true) {
|
|
45
|
+
readAs ??= { ...raw };
|
|
46
|
+
if (reading.as === undefined)
|
|
47
|
+
Reflect.deleteProperty(readAs, entry.member);
|
|
48
|
+
else
|
|
49
|
+
readAs[entry.member] = reading.as;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
return undefined;
|
|
53
|
+
};
|
|
54
|
+
for (const segment of segments) {
|
|
55
|
+
const corrupt = pass(segment.name, segment.entries);
|
|
56
|
+
if (corrupt !== undefined)
|
|
57
|
+
return corrupt;
|
|
58
|
+
}
|
|
59
|
+
const gate = pass("admitOnly", admitOnly);
|
|
60
|
+
if (gate !== undefined)
|
|
61
|
+
return gate;
|
|
62
|
+
return { row: (readAs ?? raw) };
|
|
63
|
+
};
|
|
64
|
+
const rowKeySegment = table.segments.filter((s) => s.name === "rowKey");
|
|
65
|
+
const damagedVerdict = (corrupt) => Object.freeze({ kind: "damaged", code: table.code, member: corrupt.member, form: corrupt.corrupt, sentence: table.sentence });
|
|
66
|
+
return {
|
|
67
|
+
table,
|
|
68
|
+
read: (raw, ctx, segments) => judge(raw, ctx, selected(segments), []),
|
|
69
|
+
admit: (candidate, ctx, segments) => judge(candidate, ctx, selected(segments), table.admitOnly ?? []),
|
|
70
|
+
rowKey: (raw) => "row" in judge(raw, { key: "" }, rowKeySegment, []),
|
|
71
|
+
verdictOf: (answer) => ("corrupt" in answer ? damagedVerdict(answer) : OK_VERDICT),
|
|
72
|
+
damagedVerdict,
|
|
73
|
+
refusalText: (corrupt) => `${table.sentence} Diagnostic: ${corrupt.why}.`,
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
const phrase = (member, problem) => `its ${member}${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
|
|
77
|
+
export const isString = (v) => (typeof v === "string" ? undefined : "is not a string");
|
|
78
|
+
export const isNonBlankString = (v) => (typeof v === "string" && v.trim() !== "" ? undefined : "is not a non-blank string");
|
|
79
|
+
export const isBoolean = (v) => (typeof v === "boolean" ? undefined : "is not a boolean");
|
|
80
|
+
export const isFiniteNumber = (v) => (typeof v === "number" && Number.isFinite(v) ? undefined : "is not a finite number");
|
|
81
|
+
export const isCount = (v) => (typeof v === "number" && Number.isSafeInteger(v) && v >= 0 ? undefined : "is not a non-negative safe integer");
|
|
82
|
+
export const isRecord = (v) => (isRecordValue(v) ? undefined : "is not an object");
|
|
83
|
+
export function isWord(words) {
|
|
84
|
+
return (v) => (typeof v === "string" && words.includes(v) ? undefined : `is not one of ${words.join(" / ")}`);
|
|
85
|
+
}
|
|
86
|
+
export function isListOf(element) {
|
|
87
|
+
return (v) => {
|
|
88
|
+
if (!Array.isArray(v))
|
|
89
|
+
return "is not a list";
|
|
90
|
+
for (let i = 0; i < v.length; i++) {
|
|
91
|
+
const problem = element(v[i]);
|
|
92
|
+
if (problem !== undefined)
|
|
93
|
+
return `[${i}]${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
|
|
94
|
+
}
|
|
95
|
+
return undefined;
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
export function isRecordOf(members, optional = []) {
|
|
99
|
+
return (v) => {
|
|
100
|
+
if (!isRecordValue(v))
|
|
101
|
+
return "is not an object";
|
|
102
|
+
for (const [name, shape] of Object.entries(members)) {
|
|
103
|
+
const value = v[name];
|
|
104
|
+
if (value === undefined) {
|
|
105
|
+
if (optional.includes(name))
|
|
106
|
+
continue;
|
|
107
|
+
return `.${name} is missing`;
|
|
108
|
+
}
|
|
109
|
+
const problem = shape(value);
|
|
110
|
+
if (problem !== undefined)
|
|
111
|
+
return `.${name}${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
|
|
112
|
+
}
|
|
113
|
+
return undefined;
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
export function required(member, shape, exit) {
|
|
117
|
+
return {
|
|
118
|
+
member,
|
|
119
|
+
...(exit !== undefined ? { exit } : {}),
|
|
120
|
+
judge: (row) => {
|
|
121
|
+
const value = row[member];
|
|
122
|
+
if (value === undefined)
|
|
123
|
+
return { form: "missing-required", why: `its ${member} is missing` };
|
|
124
|
+
const problem = shape(value);
|
|
125
|
+
return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
|
|
126
|
+
},
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
export function optional(member, shape, exit) {
|
|
130
|
+
return {
|
|
131
|
+
member,
|
|
132
|
+
...(exit !== undefined ? { exit } : {}),
|
|
133
|
+
judge: (row) => {
|
|
134
|
+
const value = row[member];
|
|
135
|
+
if (value === undefined)
|
|
136
|
+
return READS;
|
|
137
|
+
const problem = shape(value);
|
|
138
|
+
return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
export function absentReads(member, fill, shape) {
|
|
143
|
+
return {
|
|
144
|
+
member,
|
|
145
|
+
judge: (row) => {
|
|
146
|
+
const value = row[member];
|
|
147
|
+
if (value === undefined) {
|
|
148
|
+
try {
|
|
149
|
+
return { reads: true, as: fill(row), replaced: true };
|
|
150
|
+
}
|
|
151
|
+
catch {
|
|
152
|
+
return { form: "missing-required", why: `its ${member} is missing and its absence has no reading for this row` };
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
const problem = shape(value);
|
|
156
|
+
return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
|
|
157
|
+
},
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
export function via(member, reader) {
|
|
161
|
+
return {
|
|
162
|
+
member,
|
|
163
|
+
judge: (row) => {
|
|
164
|
+
const value = row[member];
|
|
165
|
+
let reading;
|
|
166
|
+
try {
|
|
167
|
+
reading = reader(value);
|
|
168
|
+
}
|
|
169
|
+
catch (e) {
|
|
170
|
+
return { form: "wrong-type", why: `its ${member} does not read (${thrownName(e) ?? typeof e})` };
|
|
171
|
+
}
|
|
172
|
+
return reading === value ? READS : { reads: true, as: reading, replaced: true };
|
|
173
|
+
},
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
export function pair(member, check, form = "wrong-type") {
|
|
177
|
+
return {
|
|
178
|
+
member,
|
|
179
|
+
judge: (row, ctx) => {
|
|
180
|
+
const why = check(row, ctx);
|
|
181
|
+
return why === undefined ? READS : { form, why };
|
|
182
|
+
},
|
|
183
|
+
};
|
|
184
|
+
}
|