@sema-agent/core 7.66.0 → 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 +3498 -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 +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- 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.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -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
|
@@ -1,23 +1,48 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
* `
|
|
5
|
-
*
|
|
2
|
+
* The closed set of reasons a request's prefix may lawfully change (design/1393 §5.3). Five open a new
|
|
3
|
+
* epoch of the head; the sixth rewrites history without touching the head.
|
|
4
|
+
* - `leg_start_inputs` — a leg-start input of the head moved since the session's anchor (environment facts, memory
|
|
5
|
+
* tail, MCP instructions, the stable body, the tool table).
|
|
6
|
+
* - `tool_table` — the mounted tool table moved inside the leg (a deferred activation, a roster refresh, the
|
|
7
|
+
* per-request view).
|
|
8
|
+
* - `compaction` — a landed compaction: the history is replaced, and a center-prompt adoption moves the system.
|
|
9
|
+
* - `request_policy` — the request's controls moved (thinking level, output cap, retention word).
|
|
10
|
+
* - `model_namespace` — the serving model moved (a lane hop, a degrade switch): a different cache namespace.
|
|
11
|
+
* - `history_rewrite` — a request-time reducer rewrote earlier messages (a cleared tool result, a guard trim).
|
|
6
12
|
*
|
|
7
|
-
*
|
|
8
|
-
* the
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
* v1 is task-scoped (compares turns within one run; system/tools are stable so the high-value per-tool
|
|
12
|
-
* attribution mostly fires on a model switch or across runs). A per-session v2 would feed a persisted
|
|
13
|
-
* prior snapshot — the `observe` contract is already shaped for that.
|
|
13
|
+
* @contract prompt_cache.declaration.one_word — every in-leg change to a request's prefix is declared exactly
|
|
14
|
+
* once, by the seat that makes it, before the request that carries it goes out, with one word of this set; the
|
|
15
|
+
* detector reads the declarations only to say whether a change it located was expected, and never infers a
|
|
16
|
+
* reason from the change itself — a located change with no declaration is reported as undeclared.
|
|
14
17
|
*/
|
|
18
|
+
export declare const PREFIX_CHANGE_CAUSES: readonly ["leg_start_inputs", "tool_table", "compaction", "request_policy", "model_namespace", "history_rewrite"];
|
|
19
|
+
export type PrefixChangeCause = (typeof PREFIX_CHANGE_CAUSES)[number];
|
|
20
|
+
/** One declaration of a prefix change, made by the seat that changes the request. */
|
|
21
|
+
export interface PrefixChangeDeclaration {
|
|
22
|
+
cause: PrefixChangeCause;
|
|
23
|
+
/** `history_rewrite` only: the first message position the rewrite changed, when the reducer knows it. */
|
|
24
|
+
firstChangedIndex?: number;
|
|
25
|
+
/** `history_rewrite` only: the rewrite is a bounded deletion (clearing old tool results) — a drop it explains
|
|
26
|
+
* is not reported at all (the provider re-bills the cleared span once, by design). */
|
|
27
|
+
bounded?: true;
|
|
28
|
+
}
|
|
29
|
+
/** Where a located change sits in the request — `CacheBreakFinding["cause"]`; the order is the request's own
|
|
30
|
+
* (namespace, tools, system, controls, history), the residual last. */
|
|
31
|
+
export declare const CACHE_BREAK_CAUSES: readonly ["model-switch", "tool-schema", "tool-set", "system-prefix", "request-policy", "history-rewrite", "server-or-ttl"];
|
|
32
|
+
export type CacheBreakCause = (typeof CACHE_BREAK_CAUSES)[number];
|
|
15
33
|
export interface CacheBreakFinding {
|
|
16
34
|
turn: number;
|
|
17
35
|
cacheReadBefore: number;
|
|
18
36
|
cacheReadAfter: number;
|
|
19
|
-
|
|
37
|
+
/** Where the request changed (never why — the why is the declaration's word). */
|
|
38
|
+
cause: CacheBreakCause;
|
|
20
39
|
detail: string;
|
|
40
|
+
/** The located change was declared before the request went out: a lawful epoch opening, not a defect.
|
|
41
|
+
* Absent on a located change ⇒ undeclared (a contract breach); never present on `server-or-ttl`. */
|
|
42
|
+
expected?: true;
|
|
43
|
+
/** The first changed position: the tool index for `tool-schema` / `tool-set`, the message index a
|
|
44
|
+
* `history-rewrite` declaration named. Absent when not known. */
|
|
45
|
+
firstChangedIndex?: number;
|
|
21
46
|
}
|
|
22
47
|
export interface ToolFingerprintInput {
|
|
23
48
|
name: string;
|
|
@@ -29,6 +54,7 @@ export interface ToolFingerprintInput {
|
|
|
29
54
|
* snapshot in `prepareTask` AND the per-materialization refresh in tool-disclosure (design/36): both
|
|
30
55
|
* MUST derive the fingerprint the same way, or a deferred tool going placeholder→full schema would
|
|
31
56
|
* be hashed inconsistently. Keep this the single source of "what counts as the cacheable tool prefix".
|
|
57
|
+
* The schema is the one the wire carries (`projectToolSchema`), so the prefix identity moves when those bytes do.
|
|
32
58
|
*/
|
|
33
59
|
export declare function toolsToFingerprintInputs(tools: ReadonlyArray<{
|
|
34
60
|
name: string;
|
|
@@ -37,20 +63,18 @@ export declare function toolsToFingerprintInputs(tools: ReadonlyArray<{
|
|
|
37
63
|
}>): ToolFingerprintInput[];
|
|
38
64
|
export declare class CacheBreakDetector {
|
|
39
65
|
private prev;
|
|
66
|
+
/** The declarations made since the last observation; consumed by the next one (an observation that is skipped
|
|
67
|
+
* — an unknown row — consumes nothing, so a declaration is never lost while the baseline stays). */
|
|
68
|
+
private pending;
|
|
69
|
+
/** Record a declaration the next observation reads (see {@link PrefixChangeDeclaration}). */
|
|
70
|
+
declare(declaration: PrefixChangeDeclaration): void;
|
|
40
71
|
/**
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
* Record this turn's fingerprint + compare cacheRead to the prior warm turn. Returns a finding on a
|
|
48
|
-
* confirmed break. Hashes are computed here per call **by design**, taking the raw prefix rather than
|
|
49
|
-
* pre-computed hashes. NOTE (design/36): the inputs are NOT necessarily stable within a run — deferred
|
|
50
|
-
* tools materialize placeholder→full schema mid-task, so the caller refreshes the fingerprint at
|
|
51
|
-
* materialization (via `toolsToFingerprintInputs`). A resulting `tool-schema`/`tool-set` finding on
|
|
52
|
-
* that turn is EXPECTED and truthful (the cacheable prefix genuinely changed); the bug this guards
|
|
53
|
-
* against is the opposite — a frozen fingerprint hiding that change (a false negative).
|
|
72
|
+
* Record this turn's fingerprint + compare it and its cacheRead to the prior observation. Returns a finding for
|
|
73
|
+
* an undeclared change (whether or not the cache dropped), or for a confirmed drop (expected when the located
|
|
74
|
+
* change was declared). Hashes are computed here per call **by design**, from the raw prefix. The inputs are NOT
|
|
75
|
+
* stable within a run — a deferred tool materializes placeholder→full schema mid-task, a compaction may adopt a
|
|
76
|
+
* new center prompt — and every such seat moves the fingerprint AND declares the change; the bug this guards
|
|
77
|
+
* against is a seat that moves one without the other.
|
|
54
78
|
*/
|
|
55
79
|
observe(input: {
|
|
56
80
|
turn: number;
|
|
@@ -1,5 +1,23 @@
|
|
|
1
|
+
import { projectToolSchema } from "../brain/tool-schema-projection.js";
|
|
2
|
+
export const PREFIX_CHANGE_CAUSES = Object.freeze([
|
|
3
|
+
"leg_start_inputs",
|
|
4
|
+
"tool_table",
|
|
5
|
+
"compaction",
|
|
6
|
+
"request_policy",
|
|
7
|
+
"model_namespace",
|
|
8
|
+
"history_rewrite",
|
|
9
|
+
]);
|
|
10
|
+
export const CACHE_BREAK_CAUSES = Object.freeze([
|
|
11
|
+
"model-switch",
|
|
12
|
+
"tool-schema",
|
|
13
|
+
"tool-set",
|
|
14
|
+
"system-prefix",
|
|
15
|
+
"request-policy",
|
|
16
|
+
"history-rewrite",
|
|
17
|
+
"server-or-ttl",
|
|
18
|
+
]);
|
|
1
19
|
export function toolsToFingerprintInputs(tools) {
|
|
2
|
-
return tools.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters }));
|
|
20
|
+
return tools.map((t) => ({ name: t.name, description: t.description, parameters: projectToolSchema(t.parameters) }));
|
|
3
21
|
}
|
|
4
22
|
const BREAK_REL = 0.05;
|
|
5
23
|
const BREAK_ABS = 2000;
|
|
@@ -17,69 +35,106 @@ function stableStringify(v) {
|
|
|
17
35
|
? Object.fromEntries(Object.keys(val).sort().map((k) => [k, val[k]]))
|
|
18
36
|
: val);
|
|
19
37
|
}
|
|
38
|
+
function locateChanges(prev, snap) {
|
|
39
|
+
const out = [];
|
|
40
|
+
if (snap.modelKey !== prev.modelKey) {
|
|
41
|
+
out.push({ cause: "model-switch", detail: `model switched ${prev.modelKey} → ${snap.modelKey} (different cache namespace)`, declaredBy: "model_namespace" });
|
|
42
|
+
}
|
|
43
|
+
const drifted = snap.toolOrder.findIndex((name) => {
|
|
44
|
+
const p = prev.perToolHash.get(name);
|
|
45
|
+
return p !== undefined && p !== snap.perToolHash.get(name);
|
|
46
|
+
});
|
|
47
|
+
if (drifted >= 0) {
|
|
48
|
+
out.push({ cause: "tool-schema", detail: `tool "${snap.toolOrder[drifted]}" description/schema changed (drifting tool defs are the most common prefix breaker)`, firstChangedIndex: drifted, declaredBy: "tool_table" });
|
|
49
|
+
}
|
|
50
|
+
const firstMoved = firstDifference(prev.toolOrder, snap.toolOrder);
|
|
51
|
+
if (firstMoved !== undefined) {
|
|
52
|
+
const sameMembers = [...prev.toolOrder].sort().join(",") === [...snap.toolOrder].sort().join(",");
|
|
53
|
+
out.push({
|
|
54
|
+
cause: "tool-set",
|
|
55
|
+
detail: sameMembers
|
|
56
|
+
? "the tool ORDER changed (same tools, different positions) — a reordered tool list is a byte-different prefix from the first moved tool onward, so the provider re-bills the whole tail"
|
|
57
|
+
: "the tool set changed (a tool was added or removed)",
|
|
58
|
+
firstChangedIndex: firstMoved,
|
|
59
|
+
declaredBy: "tool_table",
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
if (snap.systemHash !== prev.systemHash) {
|
|
63
|
+
out.push({ cause: "system-prefix", detail: "the system prompt prefix changed (volatile content placed up front?)", declaredBy: "compaction" });
|
|
64
|
+
}
|
|
65
|
+
return out;
|
|
66
|
+
}
|
|
67
|
+
function firstDifference(a, b) {
|
|
68
|
+
const n = Math.min(a.length, b.length);
|
|
69
|
+
for (let i = 0; i < n; i++)
|
|
70
|
+
if (a[i] !== b[i])
|
|
71
|
+
return i;
|
|
72
|
+
return a.length === b.length ? undefined : n;
|
|
73
|
+
}
|
|
20
74
|
export class CacheBreakDetector {
|
|
21
75
|
prev;
|
|
22
|
-
|
|
23
|
-
|
|
76
|
+
pending = [];
|
|
77
|
+
declare(declaration) {
|
|
78
|
+
this.pending.push(declaration);
|
|
24
79
|
}
|
|
25
80
|
observe(input) {
|
|
26
81
|
const snap = {
|
|
27
82
|
systemHash: fnv1a(input.systemPrompt),
|
|
28
83
|
perToolHash: new Map(input.tools.map((t) => [t.name, fnv1a(`${t.name}\0${t.description}\0${stableStringify(t.parameters)}`)])),
|
|
29
|
-
|
|
30
|
-
toolOrderHash: fnv1a(input.tools.map((t) => t.name).join(",")),
|
|
84
|
+
toolOrder: input.tools.map((t) => t.name),
|
|
31
85
|
modelKey: input.modelKey,
|
|
32
86
|
cacheRead: input.cacheRead,
|
|
33
87
|
at: Date.now(),
|
|
34
88
|
};
|
|
35
89
|
const prev = this.prev;
|
|
90
|
+
const declared = this.pending;
|
|
36
91
|
this.prev = snap;
|
|
92
|
+
this.pending = [];
|
|
37
93
|
if (!prev)
|
|
38
94
|
return undefined;
|
|
39
95
|
const before = prev.cacheRead;
|
|
40
96
|
const after = input.cacheRead;
|
|
41
|
-
|
|
42
|
-
|
|
97
|
+
const finding = (c, expected, suffix) => ({
|
|
98
|
+
turn: input.turn,
|
|
99
|
+
cacheReadBefore: before,
|
|
100
|
+
cacheReadAfter: after,
|
|
101
|
+
cause: c.cause,
|
|
102
|
+
detail: `${c.detail}${suffix}`,
|
|
103
|
+
...(expected ? { expected: true } : {}),
|
|
104
|
+
...(c.firstChangedIndex !== undefined ? { firstChangedIndex: c.firstChangedIndex } : {}),
|
|
105
|
+
});
|
|
106
|
+
const words = new Set(declared.map((d) => d.cause));
|
|
107
|
+
const located = locateChanges(prev, snap);
|
|
108
|
+
const undeclared = located.find((c) => !words.has(c.declaredBy));
|
|
109
|
+
if (undeclared !== undefined) {
|
|
110
|
+
return finding(undeclared, false, ` — no ${undeclared.declaredBy} declaration preceded this request (an undeclared prefix change)`);
|
|
111
|
+
}
|
|
43
112
|
const drop = before - after;
|
|
44
|
-
if (!(drop > BREAK_ABS && drop / before > BREAK_REL))
|
|
113
|
+
if (before <= 0 || !(drop > BREAK_ABS && drop / before > BREAK_REL))
|
|
45
114
|
return undefined;
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
if (
|
|
49
|
-
cause
|
|
50
|
-
detail = `model switched ${prev.modelKey} → ${snap.modelKey} (different cache namespace)`;
|
|
115
|
+
if (located.length > 0)
|
|
116
|
+
return finding(located[0], true, ` — declared (${located[0].declaredBy})`);
|
|
117
|
+
if (words.has("request_policy")) {
|
|
118
|
+
return finding({ cause: "request-policy", detail: "the request's controls changed (thinking level / output cap / retention)" }, true, " — declared (request_policy)");
|
|
51
119
|
}
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
return
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
detail = `tool "${changed[0]}" description/schema changed (drifting tool defs are the most common prefix breaker)`;
|
|
60
|
-
}
|
|
61
|
-
else if (snap.toolSetHash !== prev.toolSetHash) {
|
|
62
|
-
cause = "tool-set";
|
|
63
|
-
detail = "the tool set changed (a tool was added or removed)";
|
|
64
|
-
}
|
|
65
|
-
else if (snap.toolOrderHash !== prev.toolOrderHash) {
|
|
66
|
-
cause = "tool-set";
|
|
67
|
-
detail = "the tool ORDER changed (same tools, different positions) — a reordered tool list is a byte-different prefix from the first moved tool onward, so the provider re-bills the whole tail";
|
|
68
|
-
}
|
|
69
|
-
else if (snap.systemHash !== prev.systemHash) {
|
|
70
|
-
cause = "system-prefix";
|
|
71
|
-
detail = "the system prompt prefix changed (volatile content placed up front?)";
|
|
72
|
-
}
|
|
73
|
-
else {
|
|
74
|
-
const gapMs = snap.at - prev.at;
|
|
75
|
-
cause = "server-or-ttl";
|
|
76
|
-
const checked = "nothing this detector fingerprints (system prefix, tool set + order, model)";
|
|
77
|
-
detail =
|
|
78
|
-
gapMs < SERVER_GAP_MS
|
|
79
|
-
? `${checked} changed and the gap was ${Math.round(gapMs / 1000)}s — most likely a server-side miss; the message history is not fingerprinted, so volatile content early in the conversation would also land here`
|
|
80
|
-
: `${checked} changed and the gap was ${Math.round(gapMs / 60_000)}min — most likely a normal TTL expiry (cold cache)`;
|
|
81
|
-
}
|
|
120
|
+
const rewrites = declared.filter((d) => d.cause === "history_rewrite" || d.cause === "compaction");
|
|
121
|
+
if (rewrites.length > 0) {
|
|
122
|
+
if (rewrites.every((d) => d.bounded === true))
|
|
123
|
+
return undefined;
|
|
124
|
+
const indices = rewrites.flatMap((d) => (d.firstChangedIndex !== undefined ? [d.firstChangedIndex] : []));
|
|
125
|
+
const word = rewrites.some((d) => d.cause === "compaction") ? "compaction" : "history_rewrite";
|
|
126
|
+
return finding({ cause: "history-rewrite", detail: "earlier messages were rewritten", ...(indices.length === rewrites.length ? { firstChangedIndex: Math.min(...indices) } : {}) }, true, ` — declared (${word})`);
|
|
82
127
|
}
|
|
83
|
-
|
|
128
|
+
const gapMs = snap.at - prev.at;
|
|
129
|
+
const checked = "nothing this detector fingerprints (system prefix, tool set + order, model) changed, no rewrite was declared,";
|
|
130
|
+
return {
|
|
131
|
+
turn: input.turn,
|
|
132
|
+
cacheReadBefore: before,
|
|
133
|
+
cacheReadAfter: after,
|
|
134
|
+
cause: "server-or-ttl",
|
|
135
|
+
detail: gapMs < SERVER_GAP_MS
|
|
136
|
+
? `${checked} and the gap was ${Math.round(gapMs / 1000)}s — most likely a server-side miss; the message history is not fingerprinted, so volatile content early in the conversation would also land here`
|
|
137
|
+
: `${checked} and the gap was ${Math.round(gapMs / 60_000)}min — most likely a normal TTL expiry (cold cache)`,
|
|
138
|
+
};
|
|
84
139
|
}
|
|
85
140
|
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* THE one shape text the caller wrote takes in a judge's sentence: the redaction mark and its length, never the text. A value
|
|
3
|
+
* that is no string is named by its kind ({@link dataKind}). A caller's text can be anything a deployment put in the wrong
|
|
4
|
+
* field, a credential included, and the sentence travels to logs, panels and probes.
|
|
5
|
+
*
|
|
6
|
+
* Who wrote the text decides what a refusal (an error's message, a refused answer's reason, a tool result saying what was
|
|
7
|
+
* refused) says about it — five authors, one shape each:
|
|
8
|
+
* (a) the HOST or a DECLARER — a value or a key it wrote that is not the identity of what it declares: a member's value, a key
|
|
9
|
+
* it chose (a tool or skill name a per-tool table keys, a member the declaration does not have, a `_meta` key, a header or
|
|
10
|
+
* variable name a seat answered), a `RunnerDeps` or `TaskSpec` member, a setting, an environment value, a malformed list
|
|
11
|
+
* entry, a word outside a closed vocabulary. Shape: `callerText` — the mark and the length (a symbol: its description's).
|
|
12
|
+
* A refusal over a closed vocabulary lists the closed words (and may name the nearest one), never the word the caller wrote;
|
|
13
|
+
* (b) the IDENTITY of a declared entry — the name a declaration gives the server, peer, extension, device, agent or memory
|
|
14
|
+
* scope it declares, a principal, and, for an entry whose spelling is its only identity (a permission rule, a tool-list
|
|
15
|
+
* entry, a host pattern the floor holds), that spelling. The identity is published (the engine mints it into tool names,
|
|
16
|
+
* status rows and listings), so the sentence says whose: the single-line sanitized echo (`inlineUntrusted`). A listing of
|
|
17
|
+
* the identities a refusal could have meant (the mounted scopes, the roster) is that refusal's closed vocabulary;
|
|
18
|
+
* (c) the MODEL's own tool input, told back to the model it came from — a path, a command, a pattern, a URL: the sanitized
|
|
19
|
+
* echo, which is how the model learns what it sent;
|
|
20
|
+
* (d) a REMOTE party — a server's, a peer's, an adapter's, a store's or an execution environment's answer or error: its
|
|
21
|
+
* credentials erased first (the egress pass), then the sanitized echo — the diagnostic the person needs;
|
|
22
|
+
* (e) an operator LOG line or a notice's detail — the sanitized echo.
|
|
23
|
+
* Everything else a sentence says is the engine's own: where (the declaration's member names, a list index), why (the
|
|
24
|
+
* closed vocabulary, a kind, a count and its bound) and whose.
|
|
25
|
+
*/
|
|
26
|
+
export declare function callerText(value: unknown): string;
|
|
27
|
+
/** The kind of a value, in the words a sentence uses for it: `null`, `undefined`, `an array`, `a record`, or `a <typeof>`. */
|
|
28
|
+
export declare function dataKind(value: unknown): string;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { REDACTION_MARK } from "./redaction-marks.js";
|
|
2
|
+
export function callerText(value) {
|
|
3
|
+
if (typeof value === "symbol")
|
|
4
|
+
return `a symbol ${callerText(value.description ?? "")}`;
|
|
5
|
+
if (typeof value !== "string")
|
|
6
|
+
return dataKind(value);
|
|
7
|
+
const length = [...value].length;
|
|
8
|
+
return `${REDACTION_MARK} (${length} character${length === 1 ? "" : "s"})`;
|
|
9
|
+
}
|
|
10
|
+
export function dataKind(value) {
|
|
11
|
+
return value === null ? "null" : value === undefined ? "undefined" : Array.isArray(value) ? "an array" : typeof value === "object" ? "a record" : `a ${typeof value}`;
|
|
12
|
+
}
|
|
@@ -63,6 +63,11 @@ export declare const UNCANONICALIZABLE = "<uncanonicalizable>";
|
|
|
63
63
|
* what the operator sees / the D-G signer signs.
|
|
64
64
|
*/
|
|
65
65
|
export declare function boundInputHashOf(value: unknown): string;
|
|
66
|
+
/** The short digest the engine names an identity by: the first sixteen hex characters of the SHA-256 of `text`. The tool roster mints its
|
|
67
|
+
* capability identity and its own digest through it; {@link isSha16} is the one reading of the form it mints. */
|
|
68
|
+
export declare function sha16(text: string): string;
|
|
69
|
+
/** Does `value` read as a digest {@link sha16} mints — a string of exactly sixteen lowercase hex digits? */
|
|
70
|
+
export declare function isSha16(value: unknown): value is string;
|
|
66
71
|
/**
|
|
67
72
|
* THE digest an approval binds a CALL by: SHA-256 (hex) over the canonical form of the one record `{ tool, input }` — the tool's name as the
|
|
68
73
|
* call spells it and the arguments in their JSON form ({@link capturedJsonOf}: a record member holding `undefined` absent), one
|
|
@@ -13,6 +13,13 @@ export const UNCANONICALIZABLE = "<uncanonicalizable>";
|
|
|
13
13
|
export function boundInputHashOf(value) {
|
|
14
14
|
return createHash("sha256").update(canonicalize(value), "utf8").digest("hex");
|
|
15
15
|
}
|
|
16
|
+
export function sha16(text) {
|
|
17
|
+
return createHash("sha256").update(text).digest("hex").slice(0, 16);
|
|
18
|
+
}
|
|
19
|
+
const SHA16_SHAPE = /^[0-9a-f]{16}$/;
|
|
20
|
+
export function isSha16(value) {
|
|
21
|
+
return typeof value === "string" && SHA16_SHAPE.test(value);
|
|
22
|
+
}
|
|
16
23
|
export function exactBoundInputHashOf(tool, input) {
|
|
17
24
|
const captured = capturedJsonOf(input);
|
|
18
25
|
if (!captured.ok)
|
|
@@ -138,7 +138,7 @@ export declare const FACE_CHECKPOINT_VERSION: 9;
|
|
|
138
138
|
* `unsupported_version` (the row stays `pending`, retryable on a newer worker). */
|
|
139
139
|
export declare const MAX_SUPPORTED_CHECKPOINT_VERSION: 10;
|
|
140
140
|
/**
|
|
141
|
-
* Read a checkpoint's schema version, defaulting an absent field to
|
|
141
|
+
* Read a checkpoint's schema version, defaulting an absent field to **`0`** (the row of a 1.67-era checkpoint,
|
|
142
142
|
* written before the field existed — it carries no `workspaceHandle`, so resuming it the v1 way is safe).
|
|
143
143
|
* Compare with `<= MAX_SUPPORTED_CHECKPOINT_VERSION`, never `=== CURRENT_CHECKPOINT_VERSION` (design/49 §3).
|
|
144
144
|
*/
|
|
@@ -207,12 +207,22 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
|
|
|
207
207
|
/** On `config.unknown_role` (a fresh run's terminal `detail.detail.reason`; on a resume, `detail.reason` of `checkpoint.config_refused` with `detail.code` `config.unknown_role`)
|
|
208
208
|
* — a model binding or a role word the engine cannot read: a word the model catalog does not hold (`"unknown_model_ref"`), a value that is
|
|
209
209
|
* no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a `modelRole` value (`"unknown_role_word"`) — or a task naming no model whose requested role and fallback chain supply none (`"no_model_for_role"`, `field` the requested role's seat). The sentence names the seat the refusal's `field` names (`roles.consolidate`, `tiers.pro`, `TaskSpec.model`). */
|
|
210
|
-
| "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role"
|
|
210
|
+
| "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role"
|
|
211
|
+
/** On `resume.composition_mismatch` — the two arms of the one code: `"live_leg_contradicts_row"` (a resume handed a composition leg that
|
|
212
|
+
* differs from the one the row recorded: the composition's resume entry was handed another card's identity; the row stays pending,
|
|
213
|
+
* re-resume with the recorded value or none) and `"not_a_verifier_card"` (`Runner.voidVerifierPause` was handed a card whose recorded
|
|
214
|
+
* leg is not a verification gate's `verify` leg, or records none: nothing was settled, the row is as it was). */
|
|
215
|
+
| "live_leg_contradicts_row" | "not_a_verifier_card"
|
|
216
|
+
/** On `resume.agent_definition_mismatch` — the two arms of the one code, both pre-CAS with the row `pending`: `"live_lists_contradict_row"`
|
|
217
|
+
* (the delegation lane resolved the parked agent's name to a definition whose own tool lists digest differently from the lists the row
|
|
218
|
+
* recorded — another definition wears the name now) and `"row_records_no_lists"` (the delegation lane handed a live record but the row
|
|
219
|
+
* records no readable digest of its own lists — a row parked before the record existed, or one whose record cannot be read). */
|
|
220
|
+
| "live_lists_contradict_row" | "row_records_no_lists";
|
|
211
221
|
/**
|
|
212
222
|
* The codes a RESUME's pre-claim configuration screen carries as `detail.code` of a `checkpoint.config_refused` — the words prepare's
|
|
213
|
-
* doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style,
|
|
223
|
+
* doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style, language,
|
|
214
224
|
* approval-reach, invoked-skill, attachment, recorded-mode and tool-face doors (`config.spec_retired_key` … `config.tool_face_control`, the first
|
|
215
|
-
*
|
|
225
|
+
* ten — `detail.reason` names the tool-face arm: {@link CheckpointErrorReason}), and every value door of the config-door phase over the
|
|
216
226
|
* re-supplied config and the deployment's deps (`configValueDoors`, the rest): the retired deps seats and caller-policy members
|
|
217
227
|
* (`config.deps_retired_key`), the peer presence, the restore selector, the microCompact knob, the prompt selectors, `resumeAt` on a resume
|
|
218
228
|
* (`resume_at.conflicts_resume`, `resume_at.mode_without_target` — a resume carrying `resumeAt` is refused as a conflict before its mode is
|
|
@@ -227,13 +237,32 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
|
|
|
227
237
|
* The re-supplied config's one read (`readCallerSpec`, the read a run takes of its spec) refuses with its own two words, last in the set:
|
|
228
238
|
* a member whose read throws (`config.spec_member_unreadable`) and a key the engine does not read (`config.spec_unknown_key`); its third,
|
|
229
239
|
* a retired key, is `config.spec_retired_key` (first).
|
|
240
|
+
*
|
|
241
|
+
* A SUBSET of {@link CONFIG_REFUSAL_CODES}, the family's whole refusal vocabulary: the words a resume's screen can produce, held to that set at compile time.
|
|
230
242
|
*/
|
|
231
|
-
export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
|
|
243
|
+
export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.language_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
|
|
232
244
|
export type CheckpointConfigRefusalCode = (typeof CHECKPOINT_CONFIG_REFUSAL_CODES)[number];
|
|
233
245
|
export declare const isCheckpointConfigRefusalCode: (word: unknown) => word is CheckpointConfigRefusalCode;
|
|
234
246
|
/** The words of a {@link CheckpointError}'s optional `detail.field` (what each means: the `detail` member's doc). A CLOSED SET with one home, registered in
|
|
235
247
|
* `docs/CLOSED-SETS.md`: a consumer holding a table over it is tsc-red on a new word until it places the word. */
|
|
236
248
|
export type CheckpointErrorField = "boundCallId" | "boundInputHash" | "boundGrantDigest" | "answer" | "hostDecision" | "approver" | "feedback" | "outcome" | "updatedInput" | "decision" | "reason" | "taskConfig" | "deps" | "inheritedGate";
|
|
249
|
+
/**
|
|
250
|
+
* The words of a {@link CheckpointError}'s optional `detail.settler` — who settled the row when the deployment's `resumePreflight` ruled
|
|
251
|
+
* a resume PERMANENTLY blocked (its `terminal` verdict). The member is present on exactly those three arms of `resume.preflight_rejected`
|
|
252
|
+
* and absent on its retry-later arms (a deadline, a throw, an unreadable or plain refusal answer), so a host reads the settlement off the
|
|
253
|
+
* word instead of off the sentence. A CLOSED SET with one home, registered in `docs/CLOSED-SETS.md`: a consumer holding a table over it is
|
|
254
|
+
* tsc-red on a new word until it places the word.
|
|
255
|
+
*
|
|
256
|
+
* · `"this_refusal"` — this refusal's own single-shot expire settled the row (`expired`): the token is not redeemable;
|
|
257
|
+
* · `"concurrent_actor"` — the expire lost its race and the live row is no longer `pending`: another actor had already settled it, nothing was
|
|
258
|
+
* settled by this refusal, and the token is consumed;
|
|
259
|
+
* · `"nobody"` — the expire lost its race but the live row is `pending` again (a concurrent resolve / reopen cycle moved it): nothing was settled
|
|
260
|
+
* and the same token is redeemable once more — re-resume against the current state.
|
|
261
|
+
*/
|
|
262
|
+
export type ResumePreflightSettler = "this_refusal" | "concurrent_actor" | "nobody";
|
|
263
|
+
/** The input a `checkpoint.config_refused` names in its `detail.field`: the re-supplied config, the deployment's deps, or the row's recorded gate. The three words of
|
|
264
|
+
* {@link CheckpointErrorField} that code carries; the one spelling of them for the resume's refusal channel (`asResumeConfigRefusal`) and the judge that asks it before the claim. */
|
|
265
|
+
export type ResumeConfigRefusalField = Extract<CheckpointErrorField, "taskConfig" | "deps" | "inheritedGate">;
|
|
237
266
|
/** A typed checkpoint-store error so callers branch on `code` (mirrors `SessionError`). */
|
|
238
267
|
export declare class CheckpointError extends Error {
|
|
239
268
|
readonly code: "checkpoint.already_exists" | "checkpoint.already_resolved" | "checkpoint.not_found"
|
|
@@ -366,6 +395,12 @@ export declare class CheckpointError extends Error {
|
|
|
366
395
|
* refusal exists to close. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the
|
|
367
396
|
* original principal, or omit the field to inherit the recorded one. */
|
|
368
397
|
| "resume.principal_mismatch"
|
|
398
|
+
/** The `resume.principal_mismatch` rung's twin on the partition: the resume config carries a NON-EMPTY `isolationScope` that
|
|
399
|
+
* differs from the {@link Checkpoint.isolationScope} recorded at the suspend mint. The isolation scope keys the resumed leg's
|
|
400
|
+
* working state (registry domain, offload namespace, scheduler, later parks), so running it in another one would move all of
|
|
401
|
+
* them. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the recorded value, or omit the field to inherit it.
|
|
402
|
+
* A row that records none (its partition was its principal) skips the check; `""` reads as absence on both sides. */
|
|
403
|
+
| "resume.isolation_scope_mismatch"
|
|
369
404
|
/** design/380 O1③ (placement identity continuity — the `resume.principal_mismatch` rung's twin
|
|
370
405
|
* on the placement axis): the resume supplied trusted internals whose EXPLICIT
|
|
371
406
|
* `placementRoot` differs from the {@link CheckpointState.placementRootSessionId} recorded at
|
|
@@ -386,8 +421,18 @@ export declare class CheckpointError extends Error {
|
|
|
386
421
|
* not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
387
422
|
* re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
|
|
388
423
|
* the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
|
|
389
|
-
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
|
|
424
|
+
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
|
|
425
|
+
* The two arms are told apart by `detail.reason`: `live_leg_contradicts_row` / `not_a_verifier_card` ({@link CheckpointErrorReason}). */
|
|
390
426
|
| "resume.composition_mismatch"
|
|
427
|
+
/** The own-lists twin of `resume.composition_mismatch`: the delegation lane handed trusted internals whose `ownToolLists`
|
|
428
|
+
* digest is not the {@link CheckpointState.ownToolLists} digest recorded at the suspend mint — the parked agent's name resolves
|
|
429
|
+
* now to a definition with other tool lists (a request's own definition parked under a name a built-in or deployment definition
|
|
430
|
+
* also carries), and continuing would run the leg on that definition's tool face. A live record beside a row that records no
|
|
431
|
+
* readable digest is refused too: the row cannot say which lists it ran under. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
432
|
+
* resume it where the name resolves to the definition it was parked under, or expire it. A resume that hands no live record (a
|
|
433
|
+
* host resume, a workflow leg) checks nothing. The two arms are told apart by `detail.reason`: `live_lists_contradict_row` /
|
|
434
|
+
* `row_records_no_lists` ({@link CheckpointErrorReason}). */
|
|
435
|
+
| "resume.agent_definition_mismatch"
|
|
391
436
|
/** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
|
|
392
437
|
* explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
|
|
393
438
|
* answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
|
|
@@ -396,7 +441,9 @@ export declare class CheckpointError extends Error {
|
|
|
396
441
|
* deployment's wait hint when it gave one — the #449 G1 carrier); the explicit `terminal` arm
|
|
397
442
|
* has ALREADY settled the row out of `pending` via the single-shot `expire` CAS (reaper
|
|
398
443
|
* parity) before this throw — the token is NOT redeemable, by the deployment's own permanent
|
|
399
|
-
* verdict (a dead binding must not be redialed forever).
|
|
444
|
+
* verdict (a dead binding must not be redialed forever). The permanent arm states who settled the row
|
|
445
|
+
* in `detail.settler` ({@link ResumePreflightSettler}: this refusal's expire, a concurrent actor, or nobody — the row
|
|
446
|
+
* moved and is `pending` again); the retry-later arm carries no `settler`. */
|
|
400
447
|
| "resume.preflight_rejected"
|
|
401
448
|
/** The resume carried a claim holder ({@link ResolveExpectation.holder}) and lost its CAS while the row is still the one it
|
|
402
449
|
* validated — same scope, `pending`, the same generation — so the holder was not the deployment's current grant: nothing was
|
|
@@ -452,6 +499,9 @@ export declare class CheckpointError extends Error {
|
|
|
452
499
|
* (`code` remains the only REQUIRED discriminant), which is exactly why the obligation to SPELL it
|
|
453
500
|
* is a gate rather than a type: see the closed set's own doc. */
|
|
454
501
|
reason?: CheckpointErrorReason;
|
|
502
|
+
/** On the permanent arms of `resume.preflight_rejected` (the deployment's `terminal` verdict) — who settled the row ({@link ResumePreflightSettler}).
|
|
503
|
+
* Absent on every retry-later arm of that code and on every other code. */
|
|
504
|
+
settler?: ResumePreflightSettler;
|
|
455
505
|
/** On a `version_newer` refusal of a v10 row: the reader-requirement words the row lists that this worker lacks
|
|
456
506
|
* (sorted, display only). Absent on every other arm. */
|
|
457
507
|
requires?: readonly string[];
|
|
@@ -597,6 +647,12 @@ export declare class CheckpointError extends Error {
|
|
|
597
647
|
* refusal exists to close. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the
|
|
598
648
|
* original principal, or omit the field to inherit the recorded one. */
|
|
599
649
|
| "resume.principal_mismatch"
|
|
650
|
+
/** The `resume.principal_mismatch` rung's twin on the partition: the resume config carries a NON-EMPTY `isolationScope` that
|
|
651
|
+
* differs from the {@link Checkpoint.isolationScope} recorded at the suspend mint. The isolation scope keys the resumed leg's
|
|
652
|
+
* working state (registry domain, offload namespace, scheduler, later parks), so running it in another one would move all of
|
|
653
|
+
* them. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the recorded value, or omit the field to inherit it.
|
|
654
|
+
* A row that records none (its partition was its principal) skips the check; `""` reads as absence on both sides. */
|
|
655
|
+
| "resume.isolation_scope_mismatch"
|
|
600
656
|
/** design/380 O1③ (placement identity continuity — the `resume.principal_mismatch` rung's twin
|
|
601
657
|
* on the placement axis): the resume supplied trusted internals whose EXPLICIT
|
|
602
658
|
* `placementRoot` differs from the {@link CheckpointState.placementRootSessionId} recorded at
|
|
@@ -617,8 +673,18 @@ export declare class CheckpointError extends Error {
|
|
|
617
673
|
* not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
618
674
|
* re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
|
|
619
675
|
* the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
|
|
620
|
-
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
|
|
676
|
+
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
|
|
677
|
+
* The two arms are told apart by `detail.reason`: `live_leg_contradicts_row` / `not_a_verifier_card` ({@link CheckpointErrorReason}). */
|
|
621
678
|
| "resume.composition_mismatch"
|
|
679
|
+
/** The own-lists twin of `resume.composition_mismatch`: the delegation lane handed trusted internals whose `ownToolLists`
|
|
680
|
+
* digest is not the {@link CheckpointState.ownToolLists} digest recorded at the suspend mint — the parked agent's name resolves
|
|
681
|
+
* now to a definition with other tool lists (a request's own definition parked under a name a built-in or deployment definition
|
|
682
|
+
* also carries), and continuing would run the leg on that definition's tool face. A live record beside a row that records no
|
|
683
|
+
* readable digest is refused too: the row cannot say which lists it ran under. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
684
|
+
* resume it where the name resolves to the definition it was parked under, or expire it. A resume that hands no live record (a
|
|
685
|
+
* host resume, a workflow leg) checks nothing. The two arms are told apart by `detail.reason`: `live_lists_contradict_row` /
|
|
686
|
+
* `row_records_no_lists` ({@link CheckpointErrorReason}). */
|
|
687
|
+
| "resume.agent_definition_mismatch"
|
|
622
688
|
/** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
|
|
623
689
|
* explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
|
|
624
690
|
* answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
|
|
@@ -627,7 +693,9 @@ export declare class CheckpointError extends Error {
|
|
|
627
693
|
* deployment's wait hint when it gave one — the #449 G1 carrier); the explicit `terminal` arm
|
|
628
694
|
* has ALREADY settled the row out of `pending` via the single-shot `expire` CAS (reaper
|
|
629
695
|
* parity) before this throw — the token is NOT redeemable, by the deployment's own permanent
|
|
630
|
-
* verdict (a dead binding must not be redialed forever).
|
|
696
|
+
* verdict (a dead binding must not be redialed forever). The permanent arm states who settled the row
|
|
697
|
+
* in `detail.settler` ({@link ResumePreflightSettler}: this refusal's expire, a concurrent actor, or nobody — the row
|
|
698
|
+
* moved and is `pending` again); the retry-later arm carries no `settler`. */
|
|
631
699
|
| "resume.preflight_rejected"
|
|
632
700
|
/** The resume carried a claim holder ({@link ResolveExpectation.holder}) and lost its CAS while the row is still the one it
|
|
633
701
|
* validated — same scope, `pending`, the same generation — so the holder was not the deployment's current grant: nothing was
|
|
@@ -683,6 +751,9 @@ export declare class CheckpointError extends Error {
|
|
|
683
751
|
* (`code` remains the only REQUIRED discriminant), which is exactly why the obligation to SPELL it
|
|
684
752
|
* is a gate rather than a type: see the closed set's own doc. */
|
|
685
753
|
reason?: CheckpointErrorReason;
|
|
754
|
+
/** On the permanent arms of `resume.preflight_rejected` (the deployment's `terminal` verdict) — who settled the row ({@link ResumePreflightSettler}).
|
|
755
|
+
* Absent on every retry-later arm of that code and on every other code. */
|
|
756
|
+
settler?: ResumePreflightSettler;
|
|
686
757
|
/** On a `version_newer` refusal of a v10 row: the reader-requirement words the row lists that this worker lacks
|
|
687
758
|
* (sorted, display only). Absent on every other arm. */
|
|
688
759
|
requires?: readonly string[];
|
|
@@ -73,7 +73,7 @@ export const MAX_SUPPORTED_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.requirements
|
|
|
73
73
|
export function checkpointVersionOf(cp) {
|
|
74
74
|
return cp.version ?? 0;
|
|
75
75
|
}
|
|
76
|
-
export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
|
|
76
|
+
export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.language_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
|
|
77
77
|
export const isCheckpointConfigRefusalCode = (word) => CHECKPOINT_CONFIG_REFUSAL_CODES.some((w) => w === word);
|
|
78
78
|
export class CheckpointError extends Error {
|
|
79
79
|
code;
|
|
@@ -22,7 +22,14 @@ export declare function checkpointRevOf(cp: Pick<Checkpoint, "rev">): number;
|
|
|
22
22
|
* 2-valued enum can ABA back to a prior value while the winner changed (round-2 BLOCKER fix). An absent
|
|
23
23
|
* expectation opts out of the guard entirely.
|
|
24
24
|
*/
|
|
25
|
-
export declare function checkpointOccMatches(cp: Checkpoint, expect?: ResolveExpectation): boolean;
|
|
25
|
+
export declare function checkpointOccMatches(cp: Checkpoint, expect?: Pick<ResolveExpectation, "rev">): boolean;
|
|
26
|
+
/**
|
|
27
|
+
* The generation a WON resolve gives the row it consumed: one above the generation the resolver read ({@link checkpointRevOf}), because
|
|
28
|
+
* every won resolve and every reopen bumps the counter by exactly one. It is the claimer's generation — the one value its compensation
|
|
29
|
+
* (`CheckpointStore.reopen`, `expect.rev`) carries so that only the claim that consumed the row can give it back: a delayed or foreign
|
|
30
|
+
* reopen finds a later generation (another resumer reopened and claimed again) and loses, instead of un-consuming a newer claim.
|
|
31
|
+
*/
|
|
32
|
+
export declare function checkpointClaimRevOf(read: Pick<Checkpoint, "rev">): number;
|
|
26
33
|
/**
|
|
27
34
|
* The deployment's judge of a claim holder, handed to an in-tree store (`holderIsCurrent`): `true` while the grant `holder` names is
|
|
28
35
|
* the current one, `false` once it is not. Exactly `true` is current; any answer that is not a boolean — a promise from an async judge
|
|
@@ -4,6 +4,9 @@ export function checkpointRevOf(cp) {
|
|
|
4
4
|
export function checkpointOccMatches(cp, expect) {
|
|
5
5
|
return expect === undefined || checkpointRevOf(cp) === expect.rev;
|
|
6
6
|
}
|
|
7
|
+
export function checkpointClaimRevOf(read) {
|
|
8
|
+
return checkpointRevOf(read) + 1;
|
|
9
|
+
}
|
|
7
10
|
export function checkpointHolderMatches(expect, holderIsCurrent) {
|
|
8
11
|
if (expect?.holder === undefined)
|
|
9
12
|
return true;
|