@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/core/retention.d.ts
CHANGED
|
@@ -63,31 +63,26 @@ export interface ManagedRetentionCapability {
|
|
|
63
63
|
cutoffMs: number;
|
|
64
64
|
}): Promise<RetentionReceipt>;
|
|
65
65
|
/** Lineage-aware transcript/session deletion: a session tree is deleted only when no live
|
|
66
|
-
* reference
|
|
67
|
-
*
|
|
68
|
-
*
|
|
66
|
+
* reference still points into it — the table's legs name each one (`liveReference`) — and the
|
|
67
|
+
* references are re-checked inside the deletion transaction, never assumed from a prior scan; an
|
|
68
|
+
* exempt row of {@link RETENTION_CASCADE} is never deleted with one. What one session's deletion
|
|
69
69
|
* erases, and in which order, is {@link RETENTION_CASCADE}'s session-tree legs. */
|
|
70
70
|
deleteExpiredSessions(input: {
|
|
71
71
|
domain: string;
|
|
72
72
|
cutoffMs: number;
|
|
73
73
|
}): Promise<RetentionReceipt>;
|
|
74
|
-
/** Delete offloaded tool results
|
|
75
|
-
*
|
|
74
|
+
/** Delete the offloaded tool results stored with no owner record that are older than the call's
|
|
75
|
+
* cutoff ({@link RETENTION_CASCADE}'s orphan leg). Nothing here reads a transcript: a fork's copied
|
|
76
|
+
* log keeps its source's refs, and once the source's entries are gone (its deletion, or this sweep)
|
|
77
|
+
* the fork keeps each result's preview, never the full output. */
|
|
76
78
|
deleteOrphanToolResults(input: {
|
|
77
79
|
domain: string;
|
|
78
80
|
cutoffMs: number;
|
|
79
81
|
}): Promise<RetentionReceipt>;
|
|
80
82
|
}
|
|
81
|
-
/**
|
|
82
|
-
*
|
|
83
|
-
|
|
84
|
-
export declare const RETENTION_CASCADE_DOMAINS: readonly ["checkpoints", "session-trees", "orphan-tool-results"];
|
|
85
|
-
/** One of {@link RETENTION_CASCADE_DOMAINS}. */
|
|
86
|
-
export type RetentionCascadeDomain = (typeof RETENTION_CASCADE_DOMAINS)[number];
|
|
87
|
-
/** @contract retention.governance_records_outlive_the_purge — the pollution marker dir, the capture
|
|
88
|
-
* opt-out record dir and the lineage ledger are governance FACTS about content that exists, not
|
|
89
|
-
* session data: deleting them makes a one-way privacy record revocable. */
|
|
90
|
-
export declare const RETENTION_CASCADE_EXEMPT: readonly ["session-pollution", "session-capture-optout", "lineage.json"];
|
|
83
|
+
/** The executor operation a cascade leg belongs to: `"checkpoints"` = `expireCheckpoints`, `"session-trees"` =
|
|
84
|
+
* `deleteExpiredSessions`, `"orphan-tool-results"` = `deleteOrphanToolResults`. */
|
|
85
|
+
export type RetentionCascadeDomain = "checkpoints" | "session-trees" | "orphan-tool-results";
|
|
91
86
|
/** The stores {@link RETENTION_CASCADE} covers, by seat name: every store member of {@link EngineStorageBackend} and the
|
|
92
87
|
* workflow-run store a deployment constructs itself. */
|
|
93
88
|
export type RetentionCascadeStores = Omit<EngineStorageBackend, "retention" | "dispose"> & {
|
|
@@ -107,35 +102,84 @@ export interface RetentionCascadeLeg<S = {
|
|
|
107
102
|
readonly step?: number;
|
|
108
103
|
/** A fence the leg's store runs before the session's first step, where the store carries it (absent there ⇒ no fence). */
|
|
109
104
|
readonly fence?: Extract<keyof S, string>;
|
|
105
|
+
/** What, on this leg's side, still points into the session and keeps its tree from being deleted by the executor. */
|
|
106
|
+
readonly liveReference?: string;
|
|
110
107
|
}
|
|
111
|
-
/** A
|
|
108
|
+
/** A row's fork column: how a fork of the session carries the rows (`"at-fork"` — copied when the fork is made;
|
|
109
|
+
* `"first-prepare"` — carried on the fork's first prepare, keyed on `SessionMetadata.forkedFrom`; `"not-carried"` — the
|
|
110
|
+
* fork starts without them), and why, as a sentence. */
|
|
111
|
+
export interface RetentionCascadeFork {
|
|
112
|
+
readonly carry: "at-fork" | "first-prepare" | "not-carried";
|
|
113
|
+
readonly why: string;
|
|
114
|
+
}
|
|
115
|
+
/** A row of {@link RETENTION_CASCADE}: the legs that erase a store's rows, or why none do — a store seat's exemption, or a
|
|
116
|
+
* governance record the memory engine's control plane holds (`heldBy`) — and the row's fork column. */
|
|
112
117
|
export type RetentionCascadeRow<S = {
|
|
113
118
|
readonly [verb: string]: unknown;
|
|
114
119
|
}> = {
|
|
115
120
|
readonly legs: readonly RetentionCascadeLeg<S>[];
|
|
121
|
+
readonly fork: RetentionCascadeFork;
|
|
116
122
|
} | {
|
|
117
123
|
readonly exempt: string;
|
|
124
|
+
readonly heldBy?: "memory-control-plane";
|
|
125
|
+
readonly fork: RetentionCascadeFork;
|
|
118
126
|
};
|
|
119
127
|
/**
|
|
120
128
|
* @contract retention.cascade_table — what deleting a session erases, as one table: every store the engine persists in has exactly one
|
|
121
|
-
* row (typed complete against {@link RetentionCascadeStores}),
|
|
122
|
-
*
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
*
|
|
126
|
-
*
|
|
129
|
+
* row (typed complete against {@link RetentionCascadeStores}), and so has each governance record the memory engine's control plane
|
|
130
|
+
* keeps beside them. A store's row is either the legs that erase its rows or an exemption naming why its rows are not session
|
|
131
|
+
* data; a leg names its executor domain (every leg belongs to exactly one of the three, and each domain has a leg), its verb, what
|
|
132
|
+
* the verb selects, for a session-tree leg its step, and what on its side still points into the session (`liveReference`). A
|
|
133
|
+
* governance record's row (`heldBy: "memory-control-plane"`) is always an exemption: the pollution markers, the capture opt-out
|
|
134
|
+
* records and the harvest lineage ledger are facts about content that exists, so deleting one with its session makes a one-way
|
|
135
|
+
* record revocable. Every row has a fork column: whether a fork of the session carries the rows when it is made, on its first
|
|
136
|
+
* prepare, or not at all, and why. A session tree is erased child sessions first; within one session every leg's fence runs
|
|
137
|
+
* before the first step, then the steps ascend and the session row's leg is last — a leg that fails leaves the row, so a retry
|
|
138
|
+
* runs the cascade again from its first step and converges. A leg that finds what it erases through another store's rows runs
|
|
139
|
+
* before that store's leg (the journals before the runs, the background agents' boxes before their rows, the forks' file-history
|
|
140
|
+
* carry before the session's history), so a retry still finds them. A workflow run
|
|
127
141
|
* started in a deleted session goes with it, journal included: a later resume of that run from another session is refused
|
|
128
142
|
* `workflow.park_truth_unreadable` with `detail.reason: "record_missing"`, the word an absent prior record already answers. The run
|
|
129
143
|
* store is what indexes runs by session, so a deployment that wires a journal store without one leaves its journals out of reach.
|
|
144
|
+
* A host's coordinator is checked against the table by {@link import("./store-contracts/session-deletion-cascade-contract.js").sessionDeletionCascadeContract}.
|
|
130
145
|
*/
|
|
131
146
|
export declare const RETENTION_CASCADE: {
|
|
147
|
+
"session-pollution": {
|
|
148
|
+
exempt: string;
|
|
149
|
+
heldBy: "memory-control-plane";
|
|
150
|
+
fork: {
|
|
151
|
+
carry: "not-carried";
|
|
152
|
+
why: string;
|
|
153
|
+
};
|
|
154
|
+
};
|
|
155
|
+
"session-capture-optout": {
|
|
156
|
+
exempt: string;
|
|
157
|
+
heldBy: "memory-control-plane";
|
|
158
|
+
fork: {
|
|
159
|
+
carry: "not-carried";
|
|
160
|
+
why: string;
|
|
161
|
+
};
|
|
162
|
+
};
|
|
163
|
+
"lineage.json": {
|
|
164
|
+
exempt: string;
|
|
165
|
+
heldBy: "memory-control-plane";
|
|
166
|
+
fork: {
|
|
167
|
+
carry: "not-carried";
|
|
168
|
+
why: string;
|
|
169
|
+
};
|
|
170
|
+
};
|
|
132
171
|
workflowJournalStore: {
|
|
133
172
|
legs: {
|
|
134
173
|
domain: "session-trees";
|
|
135
174
|
step: number;
|
|
136
175
|
verb: "deleteRun";
|
|
137
176
|
selects: string;
|
|
177
|
+
liveReference: string;
|
|
138
178
|
}[];
|
|
179
|
+
fork: {
|
|
180
|
+
carry: "not-carried";
|
|
181
|
+
why: string;
|
|
182
|
+
};
|
|
139
183
|
};
|
|
140
184
|
workflowRunStore: {
|
|
141
185
|
legs: {
|
|
@@ -143,7 +187,12 @@ export declare const RETENTION_CASCADE: {
|
|
|
143
187
|
step: number;
|
|
144
188
|
verb: "deleteBySession";
|
|
145
189
|
selects: string;
|
|
190
|
+
liveReference: string;
|
|
146
191
|
}[];
|
|
192
|
+
fork: {
|
|
193
|
+
carry: "not-carried";
|
|
194
|
+
why: string;
|
|
195
|
+
};
|
|
147
196
|
};
|
|
148
197
|
backgroundAgentStore: {
|
|
149
198
|
legs: {
|
|
@@ -151,7 +200,12 @@ export declare const RETENTION_CASCADE: {
|
|
|
151
200
|
step: number;
|
|
152
201
|
verb: "delete";
|
|
153
202
|
selects: string;
|
|
203
|
+
liveReference: string;
|
|
154
204
|
}[];
|
|
205
|
+
fork: {
|
|
206
|
+
carry: "not-carried";
|
|
207
|
+
why: string;
|
|
208
|
+
};
|
|
155
209
|
};
|
|
156
210
|
rosterStore: {
|
|
157
211
|
legs: {
|
|
@@ -160,6 +214,10 @@ export declare const RETENTION_CASCADE: {
|
|
|
160
214
|
verb: "releaseAgent";
|
|
161
215
|
selects: string;
|
|
162
216
|
}[];
|
|
217
|
+
fork: {
|
|
218
|
+
carry: "not-carried";
|
|
219
|
+
why: string;
|
|
220
|
+
};
|
|
163
221
|
};
|
|
164
222
|
checkpointStore: {
|
|
165
223
|
legs: ({
|
|
@@ -167,12 +225,18 @@ export declare const RETENTION_CASCADE: {
|
|
|
167
225
|
step: number;
|
|
168
226
|
verb: "deleteSessionCheckpoints";
|
|
169
227
|
selects: string;
|
|
228
|
+
liveReference: string;
|
|
170
229
|
} | {
|
|
171
230
|
domain: "checkpoints";
|
|
172
231
|
verb: "reap";
|
|
173
232
|
selects: string;
|
|
174
233
|
step?: undefined;
|
|
234
|
+
liveReference?: undefined;
|
|
175
235
|
})[];
|
|
236
|
+
fork: {
|
|
237
|
+
carry: "not-carried";
|
|
238
|
+
why: string;
|
|
239
|
+
};
|
|
176
240
|
};
|
|
177
241
|
toolResultStore: {
|
|
178
242
|
legs: ({
|
|
@@ -186,6 +250,10 @@ export declare const RETENTION_CASCADE: {
|
|
|
186
250
|
selects: string;
|
|
187
251
|
step?: undefined;
|
|
188
252
|
})[];
|
|
253
|
+
fork: {
|
|
254
|
+
carry: "not-carried";
|
|
255
|
+
why: string;
|
|
256
|
+
};
|
|
189
257
|
};
|
|
190
258
|
sessionPolicyStore: {
|
|
191
259
|
legs: {
|
|
@@ -194,14 +262,27 @@ export declare const RETENTION_CASCADE: {
|
|
|
194
262
|
verb: "deleteBySession";
|
|
195
263
|
selects: string;
|
|
196
264
|
}[];
|
|
265
|
+
fork: {
|
|
266
|
+
carry: "not-carried";
|
|
267
|
+
why: string;
|
|
268
|
+
};
|
|
197
269
|
};
|
|
198
270
|
fileHistoryStore: {
|
|
199
|
-
legs: {
|
|
271
|
+
legs: ({
|
|
272
|
+
domain: "session-trees";
|
|
273
|
+
step: number;
|
|
274
|
+
verb: "adoptScope";
|
|
275
|
+
selects: string;
|
|
276
|
+
} | {
|
|
200
277
|
domain: "session-trees";
|
|
201
278
|
step: number;
|
|
202
279
|
verb: "deleteBySession";
|
|
203
280
|
selects: string;
|
|
204
|
-
}[];
|
|
281
|
+
})[];
|
|
282
|
+
fork: {
|
|
283
|
+
carry: "first-prepare";
|
|
284
|
+
why: string;
|
|
285
|
+
};
|
|
205
286
|
};
|
|
206
287
|
mailboxStore: {
|
|
207
288
|
legs: ({
|
|
@@ -217,6 +298,10 @@ export declare const RETENTION_CASCADE: {
|
|
|
217
298
|
fence: "retireRecipient";
|
|
218
299
|
selects: string;
|
|
219
300
|
})[];
|
|
301
|
+
fork: {
|
|
302
|
+
carry: "not-carried";
|
|
303
|
+
why: string;
|
|
304
|
+
};
|
|
220
305
|
};
|
|
221
306
|
/**
|
|
222
307
|
* @contract retention.image_bytes_live_in_the_session_store — a transcript's image bytes have one holder, the engine's session store:
|
|
@@ -229,15 +314,25 @@ export declare const RETENTION_CASCADE: {
|
|
|
229
314
|
step: number;
|
|
230
315
|
verb: "delete";
|
|
231
316
|
selects: string;
|
|
317
|
+
liveReference: string;
|
|
232
318
|
} | {
|
|
233
319
|
domain: "checkpoints";
|
|
234
320
|
verb: "unpin";
|
|
235
321
|
selects: string;
|
|
236
322
|
step?: undefined;
|
|
323
|
+
liveReference?: undefined;
|
|
237
324
|
})[];
|
|
325
|
+
fork: {
|
|
326
|
+
carry: "at-fork";
|
|
327
|
+
why: string;
|
|
328
|
+
};
|
|
238
329
|
};
|
|
239
330
|
usageWindowStore: {
|
|
240
331
|
exempt: string;
|
|
332
|
+
fork: {
|
|
333
|
+
carry: "not-carried";
|
|
334
|
+
why: string;
|
|
335
|
+
};
|
|
241
336
|
};
|
|
242
337
|
};
|
|
243
338
|
/** One session's erasure in order — {@link RETENTION_CASCADE}'s session-tree legs, ascending by step (the one reading of the order). */
|
package/dist/core/retention.js
CHANGED
|
@@ -9,8 +9,6 @@ export function readRetentionDeclaration(name, value) {
|
|
|
9
9
|
return "managed";
|
|
10
10
|
throw codedError("config.retention_capability", `store "${name}" declares an unparseable retention value ${describeRejectedValue(value)} — expected "managed" or "none".`);
|
|
11
11
|
}
|
|
12
|
-
export const RETENTION_CASCADE_DOMAINS = Object.freeze(["checkpoints", "session-trees", "orphan-tool-results"]);
|
|
13
|
-
export const RETENTION_CASCADE_EXEMPT = Object.freeze(["session-pollution", "session-capture-optout", "lineage.json"]);
|
|
14
12
|
function deepFreeze(value) {
|
|
15
13
|
if (typeof value === "object" && value !== null) {
|
|
16
14
|
for (const member of Object.values(value))
|
|
@@ -19,40 +17,86 @@ function deepFreeze(value) {
|
|
|
19
17
|
}
|
|
20
18
|
return value;
|
|
21
19
|
}
|
|
22
|
-
|
|
23
|
-
workflowJournalStore: {
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
20
|
+
const STORE_ROWS = {
|
|
21
|
+
workflowJournalStore: {
|
|
22
|
+
legs: [{ domain: "session-trees", step: 1, verb: "deleteRun", selects: "the journal of each terminal workflow run the session started, found through the run store's listByScope session filter while the run rows still exist", liveReference: "a running workflow run the session started" }],
|
|
23
|
+
fork: { carry: "not-carried", why: "a run's journal stays keyed by the run the session started; a fork, like any other session, resumes that run only while the source's rows exist" },
|
|
24
|
+
},
|
|
25
|
+
workflowRunStore: {
|
|
26
|
+
legs: [{ domain: "session-trees", step: 2, verb: "deleteBySession", selects: "the session's terminal workflow runs in its scope; answers the run ids it deleted", liveReference: "a running workflow run the session started" }],
|
|
27
|
+
fork: { carry: "not-carried", why: "a run row stays keyed by the session that started it; a fork starts with none of its own" },
|
|
28
|
+
},
|
|
29
|
+
backgroundAgentStore: {
|
|
30
|
+
legs: [{ domain: "session-trees", step: 4, verb: "delete", selects: "each terminal row listBySession names for the session", liveReference: "a running or parked background agent of the session" }],
|
|
31
|
+
fork: { carry: "not-carried", why: "a background agent works for the session that started it; a fork starts with none" },
|
|
32
|
+
},
|
|
33
|
+
rosterStore: {
|
|
34
|
+
legs: [{ domain: "session-trees", step: 5, verb: "releaseAgent", selects: "every agent whose roster entry names the session as its session" }],
|
|
35
|
+
fork: { carry: "not-carried", why: "a roster entry names the session its agent was registered for; a fork registers its own" },
|
|
36
|
+
},
|
|
27
37
|
checkpointStore: {
|
|
28
38
|
legs: [
|
|
29
|
-
{ domain: "session-trees", step: 6, verb: "deleteSessionCheckpoints", selects: "the session's checkpoint rows in any status, guarded by the session row's owner (so it runs while the row exists)" },
|
|
39
|
+
{ domain: "session-trees", step: 6, verb: "deleteSessionCheckpoints", selects: "the session's checkpoint rows in any status, guarded by the session row's owner (so it runs while the row exists)", liveReference: "a pending checkpoint of the session" },
|
|
30
40
|
{ domain: "checkpoints", verb: "reap", selects: "the scope's pending rows whose deadline is before the call's cutoff, flipped to expired (no row is deleted)" },
|
|
31
41
|
],
|
|
42
|
+
fork: { carry: "not-carried", why: "a checkpoint is a pause of the session that parked; a fork starts with none pending" },
|
|
32
43
|
},
|
|
33
44
|
toolResultStore: {
|
|
34
45
|
legs: [
|
|
35
|
-
{ domain: "session-trees", step: 7, verb: "deleteBySession", selects: "the entries whose owner record names the session" },
|
|
46
|
+
{ domain: "session-trees", step: 7, verb: "deleteBySession", selects: "the entries whose owner record names the session — offloaded text and the bytes a tool result kept alike" },
|
|
36
47
|
{ domain: "orphan-tool-results", verb: "deleteUnattributable", selects: "the entries stored with no owner record, older than the call's cutoff" },
|
|
37
48
|
],
|
|
49
|
+
fork: { carry: "not-carried", why: "the fork's copied log keeps the source's refs, not the entries: once the source's session-tree legs ran, the fork keeps each offloaded result's preview, never the full output" },
|
|
50
|
+
},
|
|
51
|
+
sessionPolicyStore: {
|
|
52
|
+
legs: [{ domain: "session-trees", step: 8, verb: "deleteBySession", selects: "the session's permission rules" }],
|
|
53
|
+
fork: { carry: "not-carried", why: "no seat copies a session's rules into its fork; the fork's rules start empty" },
|
|
54
|
+
},
|
|
55
|
+
fileHistoryStore: {
|
|
56
|
+
legs: [
|
|
57
|
+
{ domain: "session-trees", step: 9, verb: "adoptScope", selects: "for each fork of the session (a session row whose forkedFrom names it), the session's history scope adopted into the fork's — `conflict` (already carried, or grown its own) counts as done, any other failure fails the leg, so the session's history is never deleted under a fork that has not received it" },
|
|
58
|
+
{ domain: "session-trees", step: 10, verb: "deleteBySession", selects: "the session's whole history scope (the scope is the session id): boundaries, version records, pristine baselines, and the blobs no other scope references" },
|
|
59
|
+
],
|
|
60
|
+
fork: { carry: "first-prepare", why: "the engine adopts the source's scope into the fork's on the fork's first prepare; a deletion runs that carry first (step 9), so a fork that has not prepared yet keeps its pre-fork history" },
|
|
38
61
|
},
|
|
39
|
-
sessionPolicyStore: { legs: [{ domain: "session-trees", step: 8, verb: "deleteBySession", selects: "the session's permission rules" }] },
|
|
40
|
-
fileHistoryStore: { legs: [{ domain: "session-trees", step: 9, verb: "deleteBySession", selects: "the session's whole history scope (the scope is the session id): boundaries, version records, pristine baselines, and the blobs no other scope references" }] },
|
|
41
62
|
mailboxStore: {
|
|
42
63
|
legs: [
|
|
43
64
|
{ domain: "session-trees", step: 3, verb: "drop", selects: "the box of each terminal background-agent row backgroundAgentStore.listBySession names for the session (the row's scope and handle), found through those rows while they still exist" },
|
|
44
|
-
{ domain: "session-trees", step:
|
|
65
|
+
{ domain: "session-trees", step: 11, verb: "drop", fence: "retireRecipient", selects: "the session's box (its peer session handle) in the session owner's scope; the fence is the optional retireRecipient pair's — run first, it refuses deliveries from then on, and a store without the pair (the bundled two) keeps no recipient lifecycle and has its box dropped" },
|
|
45
66
|
],
|
|
67
|
+
fork: { carry: "not-carried", why: "a box belongs to the handle it was opened for; a fork gets its own" },
|
|
46
68
|
},
|
|
47
69
|
sessionStore: {
|
|
48
70
|
legs: [
|
|
49
|
-
{ domain: "session-trees", step:
|
|
71
|
+
{ domain: "session-trees", step: 12, verb: "delete", selects: "the session's row and its whole log (a placed subagent row is its agent row's joint reap: release after a winning delete)", liveReference: "a fork of the session (a session row whose forkedFrom names it)" },
|
|
50
72
|
{ domain: "checkpoints", verb: "unpin", selects: "the session each expired checkpoint pinned" },
|
|
51
73
|
],
|
|
74
|
+
fork: { carry: "at-fork", why: "the fork copies the session's log (whole, or up to the fork point) and its row cells when it is made; deleting the source leaves the copy" },
|
|
52
75
|
},
|
|
53
|
-
usageWindowStore: {
|
|
54
|
-
|
|
55
|
-
|
|
76
|
+
usageWindowStore: {
|
|
77
|
+
exempt: "a usage-governance ledger keyed by principal: token and cost counts, no session content, bounded by the deployment's live window set",
|
|
78
|
+
fork: { carry: "not-carried", why: "keyed by principal, not by session: a fork's usage counts in the same principal's window" },
|
|
79
|
+
},
|
|
80
|
+
};
|
|
81
|
+
const GOVERNANCE_ROWS = {
|
|
82
|
+
"session-pollution": {
|
|
83
|
+
exempt: "the pollution markers: a session's record that its content carried untrusted or injected material — a fact about content that exists, not session data",
|
|
84
|
+
heldBy: "memory-control-plane",
|
|
85
|
+
fork: { carry: "not-carried", why: "read for the session id it names; a fork's harvest reads the fork's own marker" },
|
|
86
|
+
},
|
|
87
|
+
"session-capture-optout": {
|
|
88
|
+
exempt: "the capture opt-out records: a person's standing withdrawal of a session from memory capture — a fact about content that exists, not session data",
|
|
89
|
+
heldBy: "memory-control-plane",
|
|
90
|
+
fork: { carry: "not-carried", why: "the fork reads its source's record through SessionMetadata.forkedFrom at prepare and on every harvest, so the source's standing opt-out governs the copied transcript; nothing is copied" },
|
|
91
|
+
},
|
|
92
|
+
"lineage.json": {
|
|
93
|
+
exempt: "the harvest lineage ledger: which sessions contributed each memory entry, one ledger per control plane, read by the sweeps that trace a memory back to its sessions",
|
|
94
|
+
heldBy: "memory-control-plane",
|
|
95
|
+
fork: { carry: "not-carried", why: "one ledger per control plane, not per session: a fork's harvests add contributions under the fork's id" },
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
export const RETENTION_CASCADE = deepFreeze({ ...STORE_ROWS, ...GOVERNANCE_ROWS });
|
|
99
|
+
export const RETENTION_SESSION_TREE_STEPS = deepFreeze(Object.entries(STORE_ROWS)
|
|
56
100
|
.flatMap(([store, row]) => ("legs" in row ? row.legs.filter((leg) => leg.domain === "session-trees").map((leg) => ({ store, ...leg })) : []))
|
|
57
101
|
.sort((a, b) => (a.step ?? 0) - (b.step ?? 0)));
|
|
58
102
|
function codedError(code, message) {
|
|
@@ -1,13 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* ONE presence rule for a RETIRED key on a caller-supplied bag (a deps object, an options object): the key is
|
|
3
|
-
* PRESENT iff ordinary property lookup answers a defined value — prototype and non-enumerable members included,
|
|
4
|
-
* exactly what the former direct read of the seat honored; an explicit `undefined` reads as absence, as every
|
|
5
|
-
* optional seat reads. Every retired-key door reads through here so no door grows its own idea of "present";
|
|
6
|
-
* each composes its own refusal from the answer. A table row is `{ key: replacement }` — the sentence that says
|
|
7
|
-
* what replaced the seat, quoted in the refusal. A dotted key names a member of a member bag (`attachments.x`),
|
|
8
|
-
* read the same way one step at a time; a step that is not an object or a function holds nothing. A step spelled
|
|
9
|
-
* `name[]` names an array member and reads every element it holds (`skills[].manifest`: any element carrying it).
|
|
10
|
-
*/
|
|
11
1
|
/** The first retired key present on `bag`, in table order, or undefined when none is. */
|
|
12
2
|
export declare function retiredKeyOf(bag: object, table: Readonly<Record<string, string>>): {
|
|
13
3
|
key: string;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { codedRefusal } from "./thrown-value.js";
|
|
1
2
|
function presentAt(at, steps) {
|
|
2
3
|
if (steps.length === 0)
|
|
3
4
|
return at !== undefined;
|
|
@@ -22,9 +23,7 @@ export function assertNoRetiredKeys(bag, table, owner) {
|
|
|
22
23
|
throw retiredKeyRefusal(hit, owner);
|
|
23
24
|
}
|
|
24
25
|
export function retiredKeyRefusal(hit, owner) {
|
|
25
|
-
|
|
26
|
-
e.code = owner === "TaskSpec" ? "config.spec_retired_key" : "config.deps_retired_key";
|
|
27
|
-
return e;
|
|
26
|
+
return codedRefusal(owner === "TaskSpec" ? "config.spec_retired_key" : "config.deps_retired_key", `${owner}.${hit.key} is retired and is not read by this engine — ${hit.replacement}. Refused rather than ignored: a seat that is silently dropped reads to the deployment as wired.`);
|
|
28
27
|
}
|
|
29
28
|
export const RETIRED_HOOKS_REPLACEMENT = 'the callback seats are `mods` registrations now — register the extension on `RunnerDeps.mods` (a deployment\'s) or `TaskSpec.mods` (a task\'s), hung on the `classic.*` events (`classic.PreToolUse`, `classic.PostToolUse`, `classic.PostToolBatch`, `classic.UserPromptSubmit`, `classic.Stop`, `classic.SubagentStop`, …); a callback that denied is a handler answering `{ action: "deny", message }`';
|
|
30
29
|
export const RETIRED_TASK_SPEC_KEYS = Object.freeze({
|
package/dist/core/roles.d.ts
CHANGED
|
@@ -12,6 +12,12 @@ export { bindingShown } from "./model-receipt.js";
|
|
|
12
12
|
* the read). `seat` names where the word was written; the entry is named as the catalog entry that word resolved to.
|
|
13
13
|
*/
|
|
14
14
|
export declare function catalogModel(ref: string, models: Record<string, Model> | undefined, seat: string, what?: string): Model | undefined;
|
|
15
|
+
/** Whether `ref` names an entry of this catalog: the membership half of {@link catalogModel}, for a reader that lists names
|
|
16
|
+
* and must not receive (or throw on) the entry behind each one. */
|
|
17
|
+
export declare function isCatalogEntry(ref: string, models: Record<string, Model> | undefined): boolean;
|
|
18
|
+
/** The catalog narrowed to the one word `ref`: no entry, or `ref` with the entry {@link catalogEntry} read once. A reader that
|
|
19
|
+
* answers membership and then receives the same entry reads the slice twice and the caller's table once. */
|
|
20
|
+
export declare function catalogSliceOf(ref: string, models: Record<string, Model> | undefined): Record<string, Model>;
|
|
15
21
|
/**
|
|
16
22
|
* The role receipt — a role map read ONCE per operation (one public entry of this module: a task's resolution, a role's model if set, the
|
|
17
23
|
* preset's role base, the classifier seat, the deployment's subagent tier): the map a plain record whose every member is read once and
|
package/dist/core/roles.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { selectModel } from "./select-model.js";
|
|
2
2
|
import { namesRoleBase } from "../prompt-assembly/role-base.js";
|
|
3
3
|
import { readPromptRole } from "../prompt-assembly/select.js";
|
|
4
|
-
import { bindingShown, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
|
|
4
|
+
import { bindingShown, forkModelSnapshot, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
|
|
5
|
+
import { MAX_MODEL_FALLBACKS, modelFallbackRefusal, recordedFallbackChainOf, recordFallbackChain } from "./model-fallbacks.js";
|
|
5
6
|
import { describeFault, receive } from "./mods/kernel/receive.js";
|
|
6
7
|
import { CONFIG_RECEIPT_MODE, DECLARATION_RECEIPT_MODE, receiveOwnProperties } from "./own-property-receipt.js";
|
|
7
8
|
import { MODEL_ROLES } from "./types.js";
|
|
@@ -15,6 +16,16 @@ export function catalogModel(ref, models, seat, what = `${bindingShown(ref)} (a
|
|
|
15
16
|
const m = catalogEntry(ref, models);
|
|
16
17
|
return m === undefined ? undefined : receiveModel(m, seat, what);
|
|
17
18
|
}
|
|
19
|
+
export function isCatalogEntry(ref, models) {
|
|
20
|
+
return catalogEntry(ref, models) !== undefined;
|
|
21
|
+
}
|
|
22
|
+
export function catalogSliceOf(ref, models) {
|
|
23
|
+
const entry = catalogEntry(ref, models);
|
|
24
|
+
const slice = {};
|
|
25
|
+
if (entry !== undefined)
|
|
26
|
+
Object.defineProperty(slice, ref, { value: entry, enumerable: true, writable: true, configurable: true });
|
|
27
|
+
return slice;
|
|
28
|
+
}
|
|
18
29
|
const ROLE_RECORD_KEYS = new Set(["model", "select", "thinking", "promptRole", "systemPrompt"]);
|
|
19
30
|
function isBindingObject(value) {
|
|
20
31
|
return (typeof value === "object" && value !== null) || typeof value === "function";
|
|
@@ -35,7 +46,7 @@ function modelObjectAt(value, seat, binds) {
|
|
|
35
46
|
if (typeof value !== "object" || value === null || isList(value)) {
|
|
36
47
|
throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${bindingShown(value)}, not a model reference — ${binds}.`);
|
|
37
48
|
}
|
|
38
|
-
return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "");
|
|
49
|
+
return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "", binds === TIER_BINDS);
|
|
39
50
|
}
|
|
40
51
|
const ROLE_BINDS = "a role binds a catalog model name or a Model object";
|
|
41
52
|
const TIER_BINDS = "a tier binds a catalog model name or a Model object";
|
|
@@ -189,7 +200,7 @@ export function receiveModelCatalog(models, tiers, field) {
|
|
|
189
200
|
held = {};
|
|
190
201
|
for (const key of Object.keys(given)) {
|
|
191
202
|
const m = given[key];
|
|
192
|
-
Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)
|
|
203
|
+
Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)`, "", true) : m, enumerable: true, writable: true, configurable: true });
|
|
193
204
|
}
|
|
194
205
|
}
|
|
195
206
|
let bindings;
|
|
@@ -203,10 +214,60 @@ export function receiveModelCatalog(models, tiers, field) {
|
|
|
203
214
|
Object.freeze(bindings);
|
|
204
215
|
}
|
|
205
216
|
const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ? expandTiers(held, bindings) : held;
|
|
206
|
-
if (expanded !== undefined)
|
|
217
|
+
if (expanded !== undefined) {
|
|
218
|
+
resolveFallbackChains(expanded, field);
|
|
207
219
|
RECEIVED_CATALOGS.add(Object.freeze(expanded));
|
|
220
|
+
}
|
|
208
221
|
return { ...(expanded !== undefined ? { models: expanded } : {}), ...(bindings !== undefined ? { tiers: bindings } : {}) };
|
|
209
222
|
}
|
|
223
|
+
function resolveFallbackChains(catalog, field) {
|
|
224
|
+
const firstKey = new Map();
|
|
225
|
+
for (const key of Object.keys(catalog)) {
|
|
226
|
+
const entry = catalogEntry(key, catalog);
|
|
227
|
+
if (entry !== undefined)
|
|
228
|
+
firstKey.set(entry, firstKey.get(entry) ?? key);
|
|
229
|
+
}
|
|
230
|
+
const resolved = new Map();
|
|
231
|
+
for (const [entry, key] of firstKey) {
|
|
232
|
+
const words = entry.fallbacks;
|
|
233
|
+
if (words === undefined)
|
|
234
|
+
continue;
|
|
235
|
+
const seat = `${field}.models.${key}.fallbacks`;
|
|
236
|
+
if (words.length > MAX_MODEL_FALLBACKS) {
|
|
237
|
+
throw modelFallbackRefusal(seat, `${seat} names ${words.length} models — a chain holds at most ${MAX_MODEL_FALLBACKS} (more is refused, never cut).`);
|
|
238
|
+
}
|
|
239
|
+
const hops = [];
|
|
240
|
+
for (const word of words) {
|
|
241
|
+
const hop = catalogEntry(word, catalog);
|
|
242
|
+
if (hop === undefined)
|
|
243
|
+
throw modelFallbackRefusal(seat, `${seat} names ${bindingShown(word)}, which this catalog does not hold — a fallback is a catalog word.`);
|
|
244
|
+
if (hop === entry || hop.id === entry.id)
|
|
245
|
+
throw modelFallbackRefusal(seat, `${seat} names ${bindingShown(word)}, which is the model ${bindingShown(entry.id)} itself — a fallback is another model.`);
|
|
246
|
+
if (hops.some((h) => h === hop || h.id === hop.id))
|
|
247
|
+
throw modelFallbackRefusal(seat, `${seat} names ${bindingShown(word)}, the model ${bindingShown(hop.id)} a word before it already names — each hop is a different model.`);
|
|
248
|
+
hops.push(hop);
|
|
249
|
+
}
|
|
250
|
+
resolved.set(entry, hops);
|
|
251
|
+
}
|
|
252
|
+
const forks = new Map();
|
|
253
|
+
for (const [entry, hops] of resolved) {
|
|
254
|
+
const before = recordedFallbackChainOf(entry);
|
|
255
|
+
if (before === undefined)
|
|
256
|
+
recordFallbackChain(entry, hops);
|
|
257
|
+
else if (before.length !== hops.length || before.some((h, i) => h !== hops[i])) {
|
|
258
|
+
const fork = forkModelSnapshot(entry);
|
|
259
|
+
recordFallbackChain(fork, hops);
|
|
260
|
+
forks.set(entry, fork);
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
if (forks.size === 0)
|
|
264
|
+
return;
|
|
265
|
+
for (const key of Object.keys(catalog)) {
|
|
266
|
+
const fork = forks.get(Object.getOwnPropertyDescriptor(catalog, key)?.value);
|
|
267
|
+
if (fork !== undefined)
|
|
268
|
+
Object.defineProperty(catalog, key, { value: fork, writable: true, enumerable: true, configurable: true });
|
|
269
|
+
}
|
|
270
|
+
}
|
|
210
271
|
export function tierAliasVia(word, models) {
|
|
211
272
|
const via = models?.[TIER_ALIAS_VIA];
|
|
212
273
|
return via?.get(word) ?? [];
|