@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/core/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
|
@@ -7,11 +7,20 @@ export type { ModelRole, RoleSpec, ModelRoles } from "./types.js";
|
|
|
7
7
|
export { MODEL_ROLES } from "./types.js";
|
|
8
8
|
export { bindingShown } from "./model-receipt.js";
|
|
9
9
|
/**
|
|
10
|
-
* The catalog's answer for a model word — every read of a catalog's entry: the entry's snapshot from the model door
|
|
11
|
-
* catalog
|
|
12
|
-
* the
|
|
10
|
+
* The catalog's answer for a model word — every read of a catalog's entry: the entry's snapshot from the model door, received as the
|
|
11
|
+
* catalog entry it is, with its `fallbacks` chain. An entry a caller wrote is received here, at the read, and its words are resolved
|
|
12
|
+
* over the catalog it sits in ({@link chainedRead}); a snapshot the catalog holds — an entry of a catalog the catalog door received, or
|
|
13
|
+
* of a slice or copy of one, or a key a tier expansion laid out — is handed back as itself, with the chain it was resolved with. Only
|
|
14
|
+
* the entry behind the word and the entries its chain names are read. `seat` names where the word was written; the entry is named as
|
|
15
|
+
* the catalog entry that word resolved to.
|
|
13
16
|
*/
|
|
14
17
|
export declare function catalogModel(ref: string, models: Record<string, Model> | undefined, seat: string, what?: string): Model | undefined;
|
|
18
|
+
/** Whether `ref` names an entry of this catalog: the membership half of {@link catalogModel}, for a reader that lists names
|
|
19
|
+
* and must not receive (or throw on) the entry behind each one. */
|
|
20
|
+
export declare function isCatalogEntry(ref: string, models: Record<string, Model> | undefined): boolean;
|
|
21
|
+
/** The catalog narrowed to the one word `ref`: no entry, or `ref` with the entry {@link catalogEntry} read once. A reader that
|
|
22
|
+
* answers membership and then receives the same entry reads the slice twice and the caller's table once. */
|
|
23
|
+
export declare function catalogSliceOf(ref: string, models: Record<string, Model> | undefined): Record<string, Model>;
|
|
15
24
|
/**
|
|
16
25
|
* 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
26
|
* preset's role base, the classifier seat, the deployment's subagent tier): the map a plain record whose every member is read once and
|
|
@@ -38,30 +47,20 @@ export declare const CC_MODEL_TIER_ALIASES: Readonly<Record<string, string>>;
|
|
|
38
47
|
* honest name — and passes through unchanged. Display only; routing (`expandTiers`) is untouched. */
|
|
39
48
|
export declare function resolveModelDisplayLabel(ref: string): string;
|
|
40
49
|
/**
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
* - a tier with no binding falls back DOWN {@link DEFAULT_TIER_ORDER} to the first bound tier
|
|
48
|
-
* (e.g. `max` unbound + `pro` bound ⇒ "max" resolves to the pro model — availability over strictness;
|
|
49
|
-
* the gap stays visible in the deployment's catalog audit, not silently absent);
|
|
50
|
-
* - an existing catalog key of the same name WINS (deployment SHADOW semantics, mirroring agents):
|
|
51
|
-
* a deployment that already ships a model literally named "pro" keeps it untouched;
|
|
52
|
-
* - a binding may itself be a catalog name or a Model object (resolved through `resolveModel`);
|
|
53
|
-
* an unknown binding name throws at construction (config error surfaces at boot, not first use);
|
|
54
|
-
* - `"best"` (dynamic head-of-chain alias, CC `$L` parity) resolves to the FIRST tier in
|
|
55
|
-
* {@link DEFAULT_TIER_ORDER} that carries a DIRECT binding — "the strongest model this deployment
|
|
56
|
-
* actually bound", not a fixed tier — under the same SHADOW rule (a deployment catalog key named
|
|
57
|
-
* `best` wins); with no bound known-order tier (or no tiers at all) the key stays absent and
|
|
58
|
-
* `resolveModel("best")` refuses like any unknown ref.
|
|
50
|
+
* A host's tier expansion of its own catalog ({@link expandTierKeys}, the body the catalog door expands with): without bindings
|
|
51
|
+
* (absent, or a record of none) the catalog itself; with them a new, unfrozen catalog holding the caller's own entries and, under the
|
|
52
|
+
* tier words, the snapshots of the entries the bindings name — each with its `fallbacks` chain resolved over this expansion, as the
|
|
53
|
+
* door resolves its generation's (a tier word in a chain is a key here; an entry expanded again over a replaced hop names the snapshot
|
|
54
|
+
* that carries the new one). Only the entries a binding names, and the entries their chains name, are read. A refusal names the
|
|
55
|
+
* binding seat (`tiers.<the bound tier>`).
|
|
59
56
|
*/
|
|
60
57
|
export declare function expandTiers(models: Record<string, Model> | undefined, tiers: Record<string, ModelRef> | undefined): Record<string, Model> | undefined;
|
|
61
58
|
/** Whether `models` is a catalog the catalog door made ({@link receiveModelCatalog}). */
|
|
62
59
|
export declare function isReceivedCatalog(models: Record<string, Model> | undefined): boolean;
|
|
63
|
-
/** The catalog a deps bag
|
|
64
|
-
*
|
|
60
|
+
/** The catalog door's generation of a deps bag's catalog and the tier bindings beside it: a catalog the door made (a Runner's own) as
|
|
61
|
+
* it is; any other received here by the door `new Runner` takes it through ({@link receiveModelCatalog} at `RunnerDeps`), whole, at
|
|
62
|
+
* every call (nothing is held) — so a host that judges a catalog before it hands it over meets the refusal `new Runner` gives the same
|
|
63
|
+
* catalog, and gets the generation a Runner would read. A read by word reads only what the word reaches ({@link catalogModel}). */
|
|
65
64
|
export declare function catalogOfDeps(deps: {
|
|
66
65
|
models?: Record<string, Model>;
|
|
67
66
|
tiers?: Record<string, ModelRef>;
|
|
@@ -71,7 +70,7 @@ export declare function catalogOfDeps(deps: {
|
|
|
71
70
|
* `new Runner` and at `swapDeps`. The catalog is a plain record read once; every entry with a model behind it is received by the model door
|
|
72
71
|
* now (a catalog entry no task names yet is judged as well as one a task names: a catalog is configuration, and a bad entry is a boot error,
|
|
73
72
|
* not a first-use one); the bindings are a plain record read once, every binding a word or a Model object (received), a binding a catalog
|
|
74
|
-
* key shadows included; THEN the bindings are expanded over the received catalog ({@link
|
|
73
|
+
* key shadows included; THEN the bindings are expanded over the received catalog ({@link expandTierKeys} — its marks are written on its own
|
|
75
74
|
* output, so they are never lost to a copy) and the result frozen. `field` names the door (`RunnerDeps` / `swapDeps`). Throws the first
|
|
76
75
|
* refusal; nothing is written by the caller before it returns.
|
|
77
76
|
*/
|
|
@@ -114,7 +113,7 @@ export interface ModelMention {
|
|
|
114
113
|
*
|
|
115
114
|
* **Feed it the EXPANDED table.** The allowlist this takes is the host's own, and on a deployment that
|
|
116
115
|
* configured `RunnerDeps.tiers` the host's `deps.models` is NOT what the Runner resolves against: the
|
|
117
|
-
* constructor runs {@link
|
|
116
|
+
* constructor runs {@link expandTierKeys} once and keeps the expansion PRIVATE, so tier words and CC
|
|
118
117
|
* aliases (`pro`/`flash`/`opus`/`sonnet`/`best`/…) are catalog keys inside the Runner and absent from
|
|
119
118
|
* the host's table. Passing `Object.keys(deps.models)` therefore makes a user's `@opus` silently not
|
|
120
119
|
* match — the mention falls through as ordinary text and the task quietly runs on the default role.
|