@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -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 +145 -0
- package/dist/brain/model-lane.js +444 -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 +161 -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 +103 -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 +6 -0
- package/dist/core/roles.js +65 -4
- 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 +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -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 +13 -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 +115 -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 +63 -34
- package/dist/index.js +44 -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 +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -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
|
@@ -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
|
+
}
|
|
@@ -3,6 +3,7 @@ import { isWithin } from "./session-rule-policy.js";
|
|
|
3
3
|
import { isWinFormPath, normalizeAbsPathLexically } from "../../tools/fs/safety.js";
|
|
4
4
|
import { validatePath } from "../effective-path-target.js";
|
|
5
5
|
import { inlineUntrusted } from "../untrusted-text.js";
|
|
6
|
+
import { envErrorDetail } from "../../tools/fs/env-error-detail.js";
|
|
6
7
|
export const PLAN_FILE_INVALID_CODE = "config.plan_file_invalid";
|
|
7
8
|
export function planFileInvalid(value, why) {
|
|
8
9
|
let shown;
|
|
@@ -105,19 +106,19 @@ export class AdvertisedWritableDirs {
|
|
|
105
106
|
if (leaf.ok && leaf.value.kind !== "file")
|
|
106
107
|
throw planFileInvalid(spelled, leaf.value.kind === "symlink" ? "is a symbolic link (the plan file must be the file itself, not a link to one)" : `is a ${leaf.value.kind}, not a file`);
|
|
107
108
|
if (!leaf.ok && leaf.error.code !== "not_found")
|
|
108
|
-
throw planFileInvalid(spelled, `could not be examined (${leaf.error.code}: ${leaf.error.message})`);
|
|
109
|
+
throw planFileInvalid(spelled, `could not be examined (${leaf.error.code}: ${envErrorDetail(leaf.error.message)})`);
|
|
109
110
|
const parentCanonical = await this.env.canonicalPath(parent);
|
|
110
111
|
if (!parentCanonical.ok)
|
|
111
|
-
throw planFileInvalid(spelled, `has a directory that does not resolve (${parentCanonical.error.code}: ${parentCanonical.error.message}) — the host creates the plan file's directory before the run`);
|
|
112
|
+
throw planFileInvalid(spelled, `has a directory that does not resolve (${parentCanonical.error.code}: ${envErrorDetail(parentCanonical.error.message)}) — the host creates the plan file's directory before the run`);
|
|
112
113
|
const parentInfo = await this.env.fileInfo(parentCanonical.value);
|
|
113
114
|
if (!parentInfo.ok || parentInfo.value.kind !== "directory")
|
|
114
115
|
throw planFileInvalid(spelled, `has a parent ${parentCanonical.value} that is not a directory`);
|
|
115
116
|
const own = leaf.ok ? await this.env.canonicalPath(spelled) : undefined;
|
|
116
117
|
if (own !== undefined && !own.ok)
|
|
117
|
-
throw planFileInvalid(spelled, `could not be resolved (${own.error.code}: ${own.error.message})`);
|
|
118
|
+
throw planFileInvalid(spelled, `could not be resolved (${own.error.code}: ${envErrorDetail(own.error.message)})`);
|
|
118
119
|
const joined = own?.ok === true ? own : await this.env.joinPath([parentCanonical.value, name]);
|
|
119
120
|
if (!joined.ok)
|
|
120
|
-
throw planFileInvalid(spelled, `could not be joined below its directory (${joined.error.code}: ${joined.error.message})`);
|
|
121
|
+
throw planFileInvalid(spelled, `could not be joined below its directory (${joined.error.code}: ${envErrorDetail(joined.error.message)})`);
|
|
121
122
|
const key = joined.value;
|
|
122
123
|
await this.resolveDeclaredRoots();
|
|
123
124
|
const swallowed = swallowedFenceRoot(key, [...this.fenceRoots, ...this.admitted]);
|
|
@@ -135,20 +136,20 @@ export class AdvertisedWritableDirs {
|
|
|
135
136
|
return { ok: false, reason: "this run admitted no plan file" };
|
|
136
137
|
const canonical = await this.env.canonicalPath(planFile.key, signal);
|
|
137
138
|
if (!canonical.ok)
|
|
138
|
-
return canonical.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${canonical.error.code}: ${canonical.error.message}` };
|
|
139
|
+
return canonical.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${canonical.error.code}: ${envErrorDetail(canonical.error.message)}` };
|
|
139
140
|
if (canonical.value !== planFile.key)
|
|
140
141
|
return { ok: false, reason: `it now resolves to ${canonical.value} (a link replaced it or one of its directories), which is not read through` };
|
|
141
142
|
let bytes;
|
|
142
143
|
if (this.env.openBound !== undefined) {
|
|
143
144
|
const held = await this.env.openBound(planFile.key, signal);
|
|
144
145
|
if (!held.ok)
|
|
145
|
-
return held.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${held.error.code}: ${held.error.message}` };
|
|
146
|
+
return held.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${held.error.code}: ${envErrorDetail(held.error.message)}` };
|
|
146
147
|
try {
|
|
147
148
|
if (held.value.kind !== "file")
|
|
148
149
|
return { ok: false, reason: `it is now a ${held.value.kind}` };
|
|
149
150
|
const read = await held.value.readBytes(PLAN_FILE_MAX_BYTES, signal);
|
|
150
151
|
if (!read.ok)
|
|
151
|
-
return { ok: false, reason: `${read.error.code}: ${read.error.message}` };
|
|
152
|
+
return { ok: false, reason: `${read.error.code}: ${envErrorDetail(read.error.message)}` };
|
|
152
153
|
bytes = read.value;
|
|
153
154
|
}
|
|
154
155
|
finally {
|
|
@@ -158,14 +159,14 @@ export class AdvertisedWritableDirs {
|
|
|
158
159
|
else {
|
|
159
160
|
const leaf = await this.env.fileInfo(planFile.key, signal);
|
|
160
161
|
if (!leaf.ok)
|
|
161
|
-
return leaf.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${leaf.error.code}: ${leaf.error.message}` };
|
|
162
|
+
return leaf.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${leaf.error.code}: ${envErrorDetail(leaf.error.message)}` };
|
|
162
163
|
if (leaf.value.kind !== "file")
|
|
163
164
|
return { ok: false, reason: leaf.value.kind === "symlink" ? "it is now a symbolic link, which is not read through" : `it is now a ${leaf.value.kind}` };
|
|
164
165
|
if (leaf.value.size > PLAN_FILE_MAX_BYTES)
|
|
165
166
|
return { ok: false, reason: `it is ${leaf.value.size} bytes, over the ${PLAN_FILE_MAX_BYTES} a plan is read up to` };
|
|
166
167
|
const read = await this.env.readBinaryFile(planFile.key, signal);
|
|
167
168
|
if (!read.ok)
|
|
168
|
-
return read.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${read.error.code}: ${read.error.message}` };
|
|
169
|
+
return read.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${read.error.code}: ${envErrorDetail(read.error.message)}` };
|
|
169
170
|
const after = await this.env.canonicalPath(planFile.key, signal);
|
|
170
171
|
const afterLeaf = await this.env.fileInfo(planFile.key, signal);
|
|
171
172
|
if (!after.ok || after.value !== planFile.key || !afterLeaf.ok || afterLeaf.value.kind !== "file")
|
|
@@ -4,10 +4,9 @@
|
|
|
4
4
|
* the `advisor_tool` attachment kind: it rides a fresh leg's first request, and a compaction inside a leg that mounts the
|
|
5
5
|
* tool restates the full text right after it lands. Model lane only: no `steering_injected` echo.
|
|
6
6
|
*/
|
|
7
|
-
import type { AnnouncedAdvisorState, AnnouncedListingSnapshotInput
|
|
8
|
-
import type
|
|
9
|
-
import type {
|
|
10
|
-
import type { FrameReceiptLedger } from "./contracts.js";
|
|
7
|
+
import type { AnnouncedAdvisorState, AnnouncedListingSnapshotInput } from "../../internal/harness.js";
|
|
8
|
+
import { type ToldSeat } from "./conversation-segment.js";
|
|
9
|
+
import type { FrameReceiptLedger, Prepared } from "./contracts.js";
|
|
11
10
|
export declare const ADVISOR_TOOL_INSTRUCTIONS = "# Advisor Tool\n\nYou have access to an `advisor` tool backed by a stronger reviewer model. It takes NO parameters -- when you call advisor(), your entire conversation history is automatically forwarded. They see the task, every tool call you've made, every result you've seen.\n\nCall advisor BEFORE substantive work -- before writing, before committing to an interpretation, before building on an assumption. If the task requires orientation first (finding files, fetching a source, seeing what's there), do that, then call advisor. Orientation is not substantive work. Writing, editing, and declaring an answer are.\n\nAlso call advisor:\n- When you believe the task is complete. BEFORE this call, make your deliverable durable: write the file, save the result, commit the change. The advisor call takes time; if the session ends during it, a durable result persists and an unwritten one doesn't.\n- When stuck -- errors recurring, approach not converging, results that don't fit.\n- When considering a change of approach.\n\nOn tasks longer than a few steps, call advisor at least once before committing to an approach and once before declaring done. On short reactive tasks where the next action is dictated by tool output you just read, you don't need to keep calling -- the advisor adds most of its value on the first call, before the approach crystallizes.\n\nGive the advice serious weight. If you follow a step and it fails empirically, or you have primary-source evidence that contradicts a specific claim (the file says X, the paper states Y), adapt. A passing self-test is not evidence the advice is wrong -- it's evidence your test doesn't check what the advice is checking.\n\nIf you've already retrieved data pointing one way and the advisor points another: don't silently switch. Surface the conflict in one more advisor call -- \"I found X, you suggest Y, which constraint breaks the tie?\" The advisor saw your evidence but may have underweighted it; a reconcile call is cheaper than committing to the wrong branch.";
|
|
12
11
|
export declare const ADVISOR_TOOL_ABBREVIATED = "The advisor tool is available; the advisor instructions announced earlier apply.";
|
|
13
12
|
export declare const ADVISOR_TOOL_REMOVED = "The advisor tool is no longer available; disregard the earlier advisor instructions.";
|
|
@@ -16,19 +15,14 @@ export type AdvisorInstructionState = AnnouncedAdvisorState["state"];
|
|
|
16
15
|
/**
|
|
17
16
|
* The advisor instructions a leg owes, from what the model was told and whether the tool is mounted now: nothing told and
|
|
18
17
|
* mounted ⇒ the full text; told and not mounted ⇒ the withdrawal; withdrawn and mounted again ⇒ the short re-attach; every
|
|
19
|
-
* other pair owes nothing. `
|
|
18
|
+
* other pair owes nothing. `value` is what the model has been told once the frame is delivered.
|
|
20
19
|
*/
|
|
21
20
|
export declare function advisorInstructionFrame(told: AdvisorInstructionState | undefined, mounted: boolean): {
|
|
22
21
|
body: string;
|
|
23
|
-
|
|
22
|
+
value: AdvisorInstructionState;
|
|
24
23
|
} | undefined;
|
|
25
|
-
/** A leg's advisor-instructions seat: the frame its first request owes, the segment that was judged in
|
|
26
|
-
export interface AdvisorInstructionSeat {
|
|
27
|
-
owed?: {
|
|
28
|
-
readonly body: string;
|
|
29
|
-
readonly state: AdvisorInstructionState;
|
|
30
|
-
};
|
|
31
|
-
readonly segment: string | null;
|
|
24
|
+
/** A leg's advisor-instructions seat: the told seat (the frame its first request owes, the segment that was judged in) and whether the tool is mounted. */
|
|
25
|
+
export interface AdvisorInstructionSeat extends ToldSeat<AdvisorInstructionState> {
|
|
32
26
|
readonly mounted: boolean;
|
|
33
27
|
}
|
|
34
28
|
/** The owed frame as one engine-marked reminder — what a fresh leg's first message and a resumed leg's continuation both
|
|
@@ -54,18 +48,8 @@ export declare function settleAdvisorInstruction(prepared: {
|
|
|
54
48
|
};
|
|
55
49
|
}): void;
|
|
56
50
|
/**
|
|
57
|
-
* A compaction landed on a leg that mounts the advisor: the full instructions it summarized away are
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
* the segment before this compaction, so the next leg tells the model again (a duplicate, never a gap). Never throws.
|
|
51
|
+
* A compaction landed on a leg that mounts the advisor: the full instructions it summarized away are restated (the told seat's
|
|
52
|
+
* one compaction arm), and the record moves to the new segment — so a leg that no longer mounts the tool withdraws what the
|
|
53
|
+
* model now holds, and a leg that still does tells nothing twice. Never throws.
|
|
61
54
|
*/
|
|
62
|
-
export declare function appendAdvisorRestate(prepared:
|
|
63
|
-
readonly advisorInstruction?: AdvisorInstructionSeat;
|
|
64
|
-
readonly reminderMark: string;
|
|
65
|
-
readonly session: Pick<StoredSession, "appendMessage">;
|
|
66
|
-
readonly admitRows: RowAdmission;
|
|
67
|
-
readonly batchHaltRef: {
|
|
68
|
-
readonly current?: unknown;
|
|
69
|
-
};
|
|
70
|
-
readonly postureFrameRef: Pick<PostureFrameRef, "report">;
|
|
71
|
-
}): Promise<void>;
|
|
55
|
+
export declare function appendAdvisorRestate(prepared: Pick<Prepared, "advisorInstruction" | "reminderMark" | "session" | "admitRows" | "batchHaltRef" | "postureFrameRef" | "announcedListingsRef" | "frameReceipts" | "announcedSnapshotRecovered">): Promise<void>;
|
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { appendAdmittedRow } from "../row-admission.js";
|
|
2
1
|
import { mintSystemReminder } from "../reminder-mint.js";
|
|
3
|
-
import {
|
|
2
|
+
import { restateToldSeat } from "./conversation-segment.js";
|
|
4
3
|
export const ADVISOR_TOOL_INSTRUCTIONS = `# Advisor Tool
|
|
5
4
|
|
|
6
5
|
You have access to an \`advisor\` tool backed by a stronger reviewer model. It takes NO parameters -- when you call advisor(), your entire conversation history is automatically forwarded. They see the task, every tool call you've made, every result you've seen.
|
|
@@ -21,11 +20,11 @@ export const ADVISOR_TOOL_ABBREVIATED = "The advisor tool is available; the advi
|
|
|
21
20
|
export const ADVISOR_TOOL_REMOVED = "The advisor tool is no longer available; disregard the earlier advisor instructions.";
|
|
22
21
|
export function advisorInstructionFrame(told, mounted) {
|
|
23
22
|
if (mounted && told === undefined)
|
|
24
|
-
return { body: ADVISOR_TOOL_INSTRUCTIONS,
|
|
23
|
+
return { body: ADVISOR_TOOL_INSTRUCTIONS, value: "announced" };
|
|
25
24
|
if (mounted && told === "withdrawn")
|
|
26
|
-
return { body: ADVISOR_TOOL_ABBREVIATED,
|
|
25
|
+
return { body: ADVISOR_TOOL_ABBREVIATED, value: "announced" };
|
|
27
26
|
if (!mounted && told === "announced")
|
|
28
|
-
return { body: ADVISOR_TOOL_REMOVED,
|
|
27
|
+
return { body: ADVISOR_TOOL_REMOVED, value: "withdrawn" };
|
|
29
28
|
return undefined;
|
|
30
29
|
}
|
|
31
30
|
export function advisorFrameText(prepared) {
|
|
@@ -42,21 +41,20 @@ export function settleAdvisorInstruction(prepared) {
|
|
|
42
41
|
if (seat === undefined || owed === undefined)
|
|
43
42
|
return;
|
|
44
43
|
seat.owed = undefined;
|
|
45
|
-
|
|
44
|
+
if (seat.segment === undefined)
|
|
45
|
+
return;
|
|
46
|
+
prepared.announcedListingsRef.advisor = { state: owed.value, segment: seat.segment };
|
|
46
47
|
prepared.frameReceipts.listingSnapshotOwed = true;
|
|
47
48
|
}
|
|
48
|
-
export
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
catch {
|
|
60
|
-
}
|
|
61
|
-
}
|
|
49
|
+
export function appendAdvisorRestate(prepared) {
|
|
50
|
+
const seat = prepared.advisorInstruction;
|
|
51
|
+
if (seat?.mounted !== true)
|
|
52
|
+
return Promise.resolve();
|
|
53
|
+
return restateToldSeat(prepared, seat, {
|
|
54
|
+
body: ADVISOR_TOOL_INSTRUCTIONS,
|
|
55
|
+
value: "announced",
|
|
56
|
+
what: "the advisor instructions",
|
|
57
|
+
carried: seat.owed?.body === ADVISOR_TOOL_INSTRUCTIONS,
|
|
58
|
+
record: (state, segment) => void (prepared.announcedListingsRef.advisor = { state, segment }),
|
|
59
|
+
});
|
|
62
60
|
}
|
|
@@ -87,6 +87,7 @@ async function consult(seat, toolCallId, signal) {
|
|
|
87
87
|
...(sent.tools !== undefined && sent.tools.length > 0 ? { tools: sent.tools.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters })) } : {}),
|
|
88
88
|
...(signal !== undefined ? { signal } : {}),
|
|
89
89
|
...(seat.getApiKeyAndHeaders !== undefined ? { getApiKeyAndHeaders: seat.getApiKeyAndHeaders } : {}),
|
|
90
|
+
...(sent.promptLocale !== undefined ? { promptLocale: sent.promptLocale } : {}),
|
|
90
91
|
}, { brain: seat.brain });
|
|
91
92
|
return outcomeOf(model, r);
|
|
92
93
|
}
|
|
@@ -60,7 +60,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
|
|
|
60
60
|
recovered = false;
|
|
61
61
|
return undefined;
|
|
62
62
|
});
|
|
63
|
-
const seed = checkpointMirror?.mcpFailed !== undefined || checkpointMirror?.advisories !== undefined || checkpointMirror?.advisor !== undefined ? checkpointMirror : entry;
|
|
63
|
+
const seed = checkpointMirror?.mcpFailed !== undefined || checkpointMirror?.advisories !== undefined || checkpointMirror?.advisor !== undefined || checkpointMirror?.language !== undefined ? checkpointMirror : entry;
|
|
64
64
|
const listingSrc = checkpointMirror?.agents !== undefined || checkpointMirror?.skills !== undefined || checkpointMirror?.models !== undefined ? checkpointMirror : entry;
|
|
65
65
|
let mcpFailed = (seed?.mcpFailed ?? []).map((f) => ({ ...f }));
|
|
66
66
|
const advisories = new Set(seed?.advisories ?? []);
|
|
@@ -116,6 +116,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
|
|
|
116
116
|
...(mcpFailed.length > 0 ? { mcpFailed: mcpFailed.map((f) => ({ ...f })) } : {}),
|
|
117
117
|
...(advisories.size > 0 ? { advisories: withAnnounceDigests(undefined, [...advisories]) } : {}),
|
|
118
118
|
...(seed?.advisor !== undefined ? { advisor: { ...seed.advisor } } : {}),
|
|
119
|
+
...(seed?.language !== undefined ? { language: { ...seed.language } } : {}),
|
|
119
120
|
}),
|
|
120
121
|
settle: async (s, ref) => {
|
|
121
122
|
if (advisories.size > 0)
|
|
@@ -130,6 +131,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
|
|
|
130
131
|
...(ref.mcpFailed !== undefined && ref.mcpFailed.length > 0 ? { mcpFailed: ref.mcpFailed } : {}),
|
|
131
132
|
...(ref.advisories !== undefined && ref.advisories.length > 0 ? { advisories: ref.advisories } : {}),
|
|
132
133
|
...(ref.advisor !== undefined ? { advisor: ref.advisor } : {}),
|
|
134
|
+
...(ref.language !== undefined ? { language: ref.language } : {}),
|
|
133
135
|
})
|
|
134
136
|
.catch(() => undefined);
|
|
135
137
|
},
|
|
@@ -143,6 +145,7 @@ export function serializeAnnouncedListings(ref) {
|
|
|
143
145
|
...(ref.mcpFailed !== undefined ? { mcpFailed: ref.mcpFailed.map((f) => ({ ...f })) } : {}),
|
|
144
146
|
...(ref.advisories !== undefined ? { advisories: [...ref.advisories] } : {}),
|
|
145
147
|
...(ref.advisor !== undefined ? { advisor: { ...ref.advisor } } : {}),
|
|
148
|
+
...(ref.language !== undefined ? { language: { ...ref.language } } : {}),
|
|
146
149
|
};
|
|
147
150
|
return Object.keys(out).length > 0 ? out : undefined;
|
|
148
151
|
}
|
|
@@ -1,25 +1,26 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* What the approving person wrote on the card ({@link ResumeOutcome} `policy_ask` `allow` `feedback`) —
|
|
3
|
-
*
|
|
2
|
+
* What the approving person wrote on the card ({@link ResumeOutcome} `policy_ask` `allow` `feedback`) — which decide may carry it,
|
|
3
|
+
* and how it joins the resume continuation; and the live leg's carrier for the same words ({@link approvalWordsSeat}).
|
|
4
4
|
*
|
|
5
|
-
* ONE READING of "did the person write anything" ({@link writtenFeedback}
|
|
6
|
-
* not keep removed, or nothing when that leaves nothing. The
|
|
7
|
-
*
|
|
5
|
+
* ONE READING of "did the person write anything" ({@link writtenFeedback}, in approval-words.ts beside the judge of which words
|
|
6
|
+
* may be delivered): the text with the whitespace the card's input does not keep removed, or nothing when that leaves nothing. The
|
|
7
|
+
* pre-CAS checks and the continuation both ask it, as does the live answer's reading, so they cannot disagree about a blank value.
|
|
8
|
+
* (A deny's `reason` keeps its own rule, `decidersNote`: only `""` is blank there.)
|
|
8
9
|
*
|
|
9
10
|
* The words ride the resume continuation user message — the first message after the batch's tool results, once the batch's
|
|
10
11
|
* unanswered siblings have settled — as a user-lane range of their own: outside every engine segment, so a derived view reads
|
|
11
12
|
* them as user speech; verbatim, no fence, no wrapper sentence, no length bound. They are owed with the rest of the
|
|
12
13
|
* continuation: when the batch parks again before the prompt lands they ride the new row as its last parked steer.
|
|
13
14
|
*/
|
|
15
|
+
import type { AgentHarness } from "../../internal/harness.js";
|
|
16
|
+
import { type ApprovalWordsSeat } from "../approval-words.js";
|
|
14
17
|
import { type PendingSteerEntry, type ResumeOutcome } from "../checkpoint-store.js";
|
|
15
18
|
type PolicyAsk = Extract<ResumeOutcome, {
|
|
16
19
|
gate: "policy_ask";
|
|
17
20
|
}>;
|
|
18
|
-
/** The words as the model is to read them, or `undefined` when nothing was written (absent, empty, whitespace-only). */
|
|
19
|
-
export declare function writtenFeedback(feedback: string | undefined): string | undefined;
|
|
20
21
|
/**
|
|
21
22
|
* Pre-CAS: a WRITTEN feedback is the allow arm's, a person's, and free of the `<system-reminder>` tag (opening or closing — the one
|
|
22
|
-
* judge `sanitizeUntrustedText
|
|
23
|
+
* judge `sanitizeUntrustedText`; why a tag is refused at this door and not defused is the one reading in `docs/CLOSED-SETS.md`). Each is refused
|
|
23
24
|
* (`checkpoint.invalid_outcome`, the row stays pending for a well-formed decide) rather than dropped or delivered as something it
|
|
24
25
|
* is not: a deny's words are `reason`, and a machine's text must never reach the model as the user's. The twin is the captured
|
|
25
26
|
* plain data (its text already held to the string domain by the capture), never the caller's object.
|
|
@@ -35,6 +36,14 @@ export declare function withApprovalWords(continuation: string, engineSegments:
|
|
|
35
36
|
start: number;
|
|
36
37
|
end: number;
|
|
37
38
|
}>, words: string): string;
|
|
39
|
+
/**
|
|
40
|
+
* The live leg's carrier ({@link ApprovalWordsSeat}): the words queue on the harness's steer lane as a plain user message — verbatim,
|
|
41
|
+
* no fence, no wrapper sentence, no provenance mark, so a derived view reads them as the person's speech, exactly as the resume
|
|
42
|
+
* continuation's user-lane range is read. The lane drains at the turn boundary after the batch's tool results, which is where a
|
|
43
|
+
* durable leg's continuation also lands. A queue that refuses them (the run is no longer taking input) is reported through `report`,
|
|
44
|
+
* never thrown into the gate; words still queued when the run ends are the steer lane's own undrained account.
|
|
45
|
+
*/
|
|
46
|
+
export declare function approvalWordsSeat(harness: Pick<AgentHarness, "steer">, report: (error: Error) => void): ApprovalWordsSeat;
|
|
38
47
|
/**
|
|
39
48
|
* The words as the continuation's owed content: the last parked steer, an untrusted one (the carrier that exists for an owed instruction).
|
|
40
49
|
* The frame is remembered by identity ({@link isApprovalWordsFrame}) — never by a member, which the steer store would refuse as an unknown
|