@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type MemoryAnnouncement, type MemoryGovernanceDocName, type MemoryGovernanceDocs } from "./types.js";
|
|
1
|
+
import { type MemoryAnnouncement, type MemoryAttribution, type MemoryGovernanceDocName, type MemoryGovernanceDocs } from "./types.js";
|
|
2
2
|
import type { AssertAllKeysHandled } from "../ask-origin.js";
|
|
3
3
|
import { physicalPathOfExisting } from "../physical-path.js";
|
|
4
4
|
/** Cursor sidecar for the design/84 Seam B pair on the FileBackend (`{ [scope]: cursor }`). B3: control plane. */
|
|
@@ -279,9 +279,9 @@ export declare const canonicalize: typeof physicalPathOfExisting;
|
|
|
279
279
|
/** True iff `child` (canonicalized) is `root` or inside it. */
|
|
280
280
|
export declare function isContainedIn(root: string, child: string): boolean;
|
|
281
281
|
/** The codes the store's physical form refuses an act with — the whole family, one closed set: {@link TARGET_OUTSIDE_STORE},
|
|
282
|
-
* {@link SCOPE_HOME_NOT_DIRECTORY}, {@link CONTROL_PLANE_LINKS_UNSUPPORTED} and {@link
|
|
282
|
+
* {@link SCOPE_HOME_NOT_DIRECTORY}, {@link CONTROL_PLANE_LINKS_UNSUPPORTED}, {@link CONTROL_PLANE_STRAYS} and {@link STORE_ROOT_SENSITIVE}. Each is a plain `Error` carrying `code` and a
|
|
283
283
|
* `detail` ({@link StoreFormRefusalDetail}). */
|
|
284
|
-
export declare const STORE_FORM_REFUSAL_CODES: readonly ["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays"];
|
|
284
|
+
export declare const STORE_FORM_REFUSAL_CODES: readonly ["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays", "memory.store_root_sensitive"];
|
|
285
285
|
export type StoreFormRefusalCode = (typeof STORE_FORM_REFUSAL_CODES)[number];
|
|
286
286
|
/** The code an act on a store path is refused with when it would land outside the store ({@link landsOutsideStore}). */
|
|
287
287
|
export declare const TARGET_OUTSIDE_STORE = "memory.target_outside_store";
|
|
@@ -294,6 +294,9 @@ export declare const CONTROL_PLANE_LINKS_UNSUPPORTED = "memory.control_plane_lin
|
|
|
294
294
|
* store over the engine's own control plane, and that control plane still holds carrier records (`controlPlaneStraysRefusal`;
|
|
295
295
|
* #3484, C-R1119 HB-5): records nobody reads would launder what they recorded, so they are adopted first. */
|
|
296
296
|
export declare const CONTROL_PLANE_STRAYS = "memory.control_plane_strays";
|
|
297
|
+
/** The code a store root (or the control plane beside it) that lies inside a path the write guard protects is refused with, before anything is
|
|
298
|
+
* created there ({@link assertStoreRootsNotSensitive}): a library written under `~/.ssh` is a library an escalation vector holds. */
|
|
299
|
+
export declare const STORE_ROOT_SENSITIVE = "memory.store_root_sensitive";
|
|
297
300
|
/** What a scope home can be besides a real directory (an `lstat` verdict). */
|
|
298
301
|
export declare const SCOPE_HOME_FORMS: readonly ["symlink", "file", "other"];
|
|
299
302
|
export type ScopeHomeForm = (typeof SCOPE_HOME_FORMS)[number];
|
|
@@ -309,14 +312,20 @@ export type HomeFormPhraseCoversEveryForm = AssertAllKeysHandled<Exclude<ScopeHo
|
|
|
309
312
|
* `form` is present on {@link SCOPE_HOME_NOT_DIRECTORY} only; `controlDir`, `recorded` and `now` are present
|
|
310
313
|
* together on a moved store root only ({@link storeRootMovedRefusal}): the control plane whose root anchor
|
|
311
314
|
* refused (the `controlDir` to hand {@link reanchorMemoryStoreRoot}), the physical root the anchor records,
|
|
312
|
-
* and where the root resolves now
|
|
315
|
+
* and where the root resolves now; `row` and `of` are present on {@link STORE_ROOT_SENSITIVE} only: the table row the root lands on
|
|
316
|
+
* (a pattern of the write guard's list, as written) and which root it is (`path` is that root's spelling). */
|
|
313
317
|
export type StoreFormRefusalDetail = {
|
|
314
318
|
readonly path: string;
|
|
315
319
|
readonly form?: ScopeHomeForm;
|
|
316
320
|
readonly controlDir?: string;
|
|
317
321
|
readonly recorded?: string;
|
|
318
322
|
readonly now?: string;
|
|
323
|
+
readonly row?: string;
|
|
324
|
+
readonly of?: StoreRootKind;
|
|
319
325
|
};
|
|
326
|
+
/** Which root a {@link STORE_ROOT_SENSITIVE} refusal is about: the store's own directory, the control plane beside it, or the memory engine root a
|
|
327
|
+
* deployment's host verbs keep their own lock under. */
|
|
328
|
+
export type StoreRootKind = "store" | "control_plane" | "engine_root";
|
|
320
329
|
/** A refusal the store's physical form earns: a plain `Error` (never the control-plane-damage class —
|
|
321
330
|
* the engine's own account is intact, the layout it was handed is not the layout it needs) carrying a
|
|
322
331
|
* `code` and a `detail`. */
|
|
@@ -348,6 +357,9 @@ export declare function scopeHomeRefusal(form: ScopeHomeForm, path: string): Sto
|
|
|
348
357
|
/** Seat 4 — the control plane at `path` is on a file system that refused a hard link (`fault`: the error code `link`
|
|
349
358
|
* answered, when it named one). The store publishes every control object with `link`, so it is not opened there. */
|
|
350
359
|
export declare function controlPlaneLinksRefusal(path: string, fault: string | undefined): StoreFormRefusal;
|
|
360
|
+
/** Seat 6 — a store root (`of: "store"`) or its control plane (`of: "control_plane"`) that lies inside a path the write guard's table protects
|
|
361
|
+
* (`row`: the row it lands on). Not opened and nothing created: the sentence names the row, never the path (`detail.path` is the spelling). */
|
|
362
|
+
export declare function storeRootSensitiveRefusal(of: StoreRootKind, path: string, row: string): StoreFormRefusal;
|
|
351
363
|
/** Seat 5 — an engine whose backend carries a governance store of its own over a control plane (`path`) that still holds
|
|
352
364
|
* that carrier's records from before (`strays`: the documents, and the count of entries per object kind): the engine
|
|
353
365
|
* reads its records through the carrier, so these would be read by nobody — a pollution marker, a hold, a capture
|
|
@@ -387,6 +399,22 @@ export declare const ROOT_ANCHOR_FILE = "root-anchor.json";
|
|
|
387
399
|
/** What an ABSENT anchor means: a control plane holding nothing records the root (a first open); one already
|
|
388
400
|
* holding a store backfills while the arm is open and refuses once it is not. */
|
|
389
401
|
export declare function absentAnchorReading(controlPlaneHoldsStore: boolean, backfillArmOpen?: boolean): "record" | "backfill" | "refuse";
|
|
402
|
+
/**
|
|
403
|
+
* THE judgment of where one root of a memory store may live: not inside a path the write guard's table protects (`sensitiveRowOf` — the
|
|
404
|
+
* `.ssh` / `.aws` / key-file rows of `RECOMMENDED_SENSITIVE_PATTERNS`, the one table, no second list). A library kept under `~/.ssh` is written by
|
|
405
|
+
* the engine's own file I/O, which no write guard sees — the guard judges the model's tool calls, not the store — so the root is a
|
|
406
|
+
* configuration fact to refuse, not a write to gate. Read on the root's spelling and on where it physically lands NOW (a link on its prefix, a
|
|
407
|
+
* missing tail rejoined, as {@link landingPathOf} reads it; never kept between calls — a link retargeted since the last open is read again); a
|
|
408
|
+
* root that cannot be placed is judged on its spelling and says what is wrong at the act that needs it. Throws {@link storeRootSensitiveRefusal}.
|
|
409
|
+
*/
|
|
410
|
+
export declare function assertRootNotSensitive(of: StoreRootKind, root: string): void;
|
|
411
|
+
/**
|
|
412
|
+
* The store's two roots through that judgment: its directory and its control plane. Run at the head of {@link anchorStoreRoot}, which every opener
|
|
413
|
+
* (a file backend's construction, an engine's mount) and every anchored face passes before it creates a root or writes under one — and by
|
|
414
|
+
* {@link effectiveControlRootOf} before the one-shot move of a legacy control plane, which is the one write that precedes the anchor head. The
|
|
415
|
+
* transaction lock ({@link tryStoreTxnLock}) judges the plane itself, for the faces that make it before they read the anchor.
|
|
416
|
+
*/
|
|
417
|
+
export declare function assertStoreRootsNotSensitive(dir: string, controlDir: string): void;
|
|
390
418
|
/** Options of {@link anchorStoreRoot}. */
|
|
391
419
|
export interface AnchorStoreRootOptions {
|
|
392
420
|
/** Where `memory.root_anchor_backfilled` goes. */
|
|
@@ -576,8 +604,10 @@ export declare function writeFileNoFollow(path: string, content: string): void;
|
|
|
576
604
|
* write that could not be ATTEMPTED must not read as one that chose not to). `O_EXCL | O_CREAT` is the
|
|
577
605
|
* atomic form — an `existsSync`-then-write pair is a TOCTOU with exactly the window this closes — and
|
|
578
606
|
* it refuses a symlink at the final component on its own (POSIX `EEXIST` on a link, dangling or not),
|
|
579
|
-
* so the twin's no-follow property is kept without a second check.
|
|
580
|
-
|
|
607
|
+
* so the twin's no-follow property is kept without a second check. `mode` is the created file's
|
|
608
|
+
* permission bits (under the process umask): a caller putting bytes back into a seat it vacated passes
|
|
609
|
+
* the vacated file's, so the seat's permissions are what they were. */
|
|
610
|
+
export declare function writeFileNoReplace(path: string, content: string, mode?: number): "written" | "kept";
|
|
581
611
|
/** THE minter of every staging name the engine puts beside a plane file while it is displaced:
|
|
582
612
|
* `<owner>.staging-<ms>-<pid>-<seq>`. One grammar for every site, so one recognizer
|
|
583
613
|
* ({@link stagingNamePattern}) knows the names the engine can have left beside a seat. */
|
|
@@ -585,8 +615,9 @@ export declare function mintStagingName(owner: string, now: () => number): strin
|
|
|
585
615
|
/** The grammar {@link mintStagingName} and {@link claimStaging} write, as a recognizer — of ONE owner's
|
|
586
616
|
* generations when `owner` is given; otherwise of every staging name an engine has minted beside a seat,
|
|
587
617
|
* for the two owners it mints them for: an instruction hold (`hold-<ms>-<12 hex>`) and a crash-residue
|
|
588
|
-
* capture (`<
|
|
589
|
-
*
|
|
618
|
+
* capture (`<16 hex>-residue-<entry id>.md`, {@link quarantineObjectNameOf}), whose clock-named
|
|
619
|
+
* `<ms>-residue-<id>.md` of earlier releases — and the `<ms>-residue-<id>.md.staging` of 7.55.0 and earlier
|
|
620
|
+
* — are included (a name already on disk does not lose its owner with an upgrade). A prefix or a bare
|
|
590
621
|
* `.staging-` suffix would adopt any name a writer chose on the strength of its spelling. Minted and
|
|
591
622
|
* recognised side by side so the two cannot drift. */
|
|
592
623
|
export declare function stagingNamePattern(owner?: string): RegExp;
|
|
@@ -654,18 +685,34 @@ export type QuarantineObjects = Pick<import("./types.js").MemoryGovernanceObject
|
|
|
654
685
|
* no readable object explains (a store that fails, an entry that is no object, a name the store refuses) is the put's
|
|
655
686
|
* own and is thrown. The File store's synchronous paths take its twin, `putFileControlObjectOnce` (`control-objects.ts`). */
|
|
656
687
|
export declare function putControlObjectOnce(objects: Pick<import("./types.js").MemoryGovernanceObjects, "putObject" | "getObject">, kind: import("./types.js").MemoryControlObjectKind, name: string, bytes: Uint8Array): Promise<"created" | "existed">;
|
|
657
|
-
/** The name
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
*
|
|
661
|
-
*
|
|
662
|
-
* is
|
|
688
|
+
/** The longest name a store keeps an object under, in UTF-8 bytes — one file name on the file systems the File store runs on. */
|
|
689
|
+
export declare const CONTROL_OBJECT_NAME_MAX_BYTES = 255;
|
|
690
|
+
/** The name of a `quarantine` object, one spelling for every copy the engine keeps there (#2877, C-R983 K2):
|
|
691
|
+
* `<the first 16 hex digits of the SHA-256 of its bytes>-<label>`. The name is a function of the bytes and of what
|
|
692
|
+
* they are a copy of, never of when they were kept, so the same bytes contained again (a withheld file the model
|
|
693
|
+
* writes back at every harvest) meet the copy that already stands and keep no second one. `content` is the bytes, or
|
|
694
|
+
* their SHA-256 in hex when the writer holds only that (a hold's row). The label is the last segment of `source` —
|
|
695
|
+
* the suspect file's path, or a bare label for a copy that has no plane path — with each character that is no part of
|
|
696
|
+
* a legal object name or would read as more than one line (a `\`, legal in a POSIX file name; a NUL; any other control
|
|
697
|
+
* character) spelled as the percent form of its UTF-8 bytes ({@link labelCharSpelled}), and cut between spellings where
|
|
698
|
+
* the name would pass `CONTROL_OBJECT_NAME_MAX_BYTES − 2` bytes (room for a numbered capture name, `.1` … `.9`): a file
|
|
699
|
+
* whose own name is as long as a file name can be still gets its copy, and two copies of the same bytes under one long
|
|
700
|
+
* label still meet. */
|
|
701
|
+
export declare function quarantineObjectNameOf(content: Uint8Array | {
|
|
702
|
+
readonly sha256: string;
|
|
703
|
+
}, source: string): string;
|
|
704
|
+
/** The name a copy is tried under on `attempt` (0…10): its {@link quarantineObjectNameOf} first, then suffixed. Two
|
|
705
|
+
* different copies can share a base (a digest-prefix collision, or a name something else was planted under), so a
|
|
706
|
+
* capture is written ONCE (a standing name is never replaced) and suffixed when the name holds other bytes; bounded —
|
|
707
|
+
* after the numbered tries, one last name keyed by pid+counter (unique within this process) either lands or the
|
|
708
|
+
* capture fails. */
|
|
663
709
|
export declare function quarantineCaptureName(base: string, attempt: number): string;
|
|
664
|
-
/**
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
*
|
|
668
|
-
|
|
710
|
+
/** Keep `content` — the already-read bytes of the suspect file at `source`, or of the copy `source` labels (its text,
|
|
711
|
+
* or the raw bytes of a file read as they lie) — as a `quarantine` object of the governance store. A capture name
|
|
712
|
+
* holding exactly these bytes already keeps them: the capture answers that name and writes nothing (one copy however
|
|
713
|
+
* often the same bytes are contained). A name holding other bytes is passed over to the next of the capture names
|
|
714
|
+
* ({@link quarantineCaptureName}). */
|
|
715
|
+
export declare function captureIntoQuarantine(objects: QuarantineObjects, source: string, content: string | Uint8Array): Promise<QuarantineCapture>;
|
|
669
716
|
/** The governance store's quarantine objects, as an erasure finds and removes them. A reader that must see damage hands
|
|
670
717
|
* in the store's damage-visible view (`standingControlObjectsOf`, `consolidation.ts`): for the File store its listing
|
|
671
718
|
* names every entry standing in the kind's directory; any other store's listing is its own (KL-3466-c). */
|
|
@@ -1133,6 +1180,11 @@ export interface LineageContribution {
|
|
|
1133
1180
|
* challenge (the account travels with the entry). Absence = unmarked content — the sweeps'
|
|
1134
1181
|
* domain (older vintages read as unmarked, the conservative side). */
|
|
1135
1182
|
marked?: true;
|
|
1183
|
+
/** `"overlap"` ⇔ this session never committed the entry: it was another live writer of the layer
|
|
1184
|
+
* while a committing session's window ran, so the bytes may be its ({@link MemoryAttribution}).
|
|
1185
|
+
* Such a row carries no incarnation (it binds every occupant of the id). Absent ⇔ the session
|
|
1186
|
+
* committed the entry — an overlap landing on that row later keeps it so ({@link landContribution}). */
|
|
1187
|
+
attribution?: Extract<MemoryAttribution, "overlap">;
|
|
1136
1188
|
}
|
|
1137
1189
|
/** One staged (pre-commit) row: an entry this transaction WOULD commit. `kind: "latch-only"` marks
|
|
1138
1190
|
* a bundle-import SYNTHETIC latch row (design/178 v2-c §1): it withholds the id on the model-visible
|
|
@@ -1149,6 +1201,11 @@ export interface LineagePendingRow {
|
|
|
1149
1201
|
* at the read face). Absence = the row's content is unmarked (older vintages included) — the
|
|
1150
1202
|
* conservative side: an unmarked row of a marked session is challenged. */
|
|
1151
1203
|
marked?: true;
|
|
1204
|
+
/** The session this row is a contribution of, when it is not the transaction's own: another live
|
|
1205
|
+
* writer of the layer in the committing window. Present ⇔ `attribution` is `"overlap"`; the row then
|
|
1206
|
+
* promotes under this session with no incarnation. */
|
|
1207
|
+
sessionId?: string;
|
|
1208
|
+
attribution?: Extract<MemoryAttribution, "overlap">;
|
|
1152
1209
|
}
|
|
1153
1210
|
/** One staged transaction: rows land BEFORE `applyPatches`; the commit credential lands after it
|
|
1154
1211
|
* succeeds; promotion consumes both. A pending txn without a credential is the crash window —
|
|
@@ -1253,7 +1310,8 @@ export declare function releaseImportLatch(store: MemoryGovernanceDocs & Pick<im
|
|
|
1253
1310
|
* corrupt ledger (integrity unknown ≠ no latch). */
|
|
1254
1311
|
export declare function lineageLatchedIds(docs: MemoryGovernanceDocs): Promise<Set<string>>;
|
|
1255
1312
|
/** Every committed contribution of `sessionId` (the pollution-retroaction sweep input, and the
|
|
1256
|
-
* erasure lane's sessionId-selector resolver
|
|
1313
|
+
* erasure lane's sessionId-selector resolver, which keeps only the rows without `attribution` — the
|
|
1314
|
+
* entries the session committed, never those it was only an overlap writer of). Throws on a corrupt ledger. Lookups are
|
|
1257
1315
|
* OWN-property (the twin law {@link lineageAccountOfEntry} states): a prototype-member sessionId
|
|
1258
1316
|
* such as "constructor" indexes truthy on EVERY plain object, so a bare lookup would attribute
|
|
1259
1317
|
* the WHOLE committed set to it — behind the erasure selector that phantom is a whole-store
|
|
@@ -1268,6 +1326,7 @@ export declare function lineageContributionsOfSession(docs: MemoryGovernanceDocs
|
|
|
1268
1326
|
lastRev: string;
|
|
1269
1327
|
lastAt: number;
|
|
1270
1328
|
marked?: true;
|
|
1329
|
+
attribution?: "overlap";
|
|
1271
1330
|
}>>;
|
|
1272
1331
|
/** design/178 v2-a §1.3 — the BY-ENTRY lineage account, from ONE parse of the ledger (the
|
|
1273
1332
|
* by-session read's transpose; the committed set is keyed by entryId, so the index is O(1) after
|
|
@@ -1284,6 +1343,7 @@ export declare function lineageAccountOfEntry(docs: MemoryGovernanceDocs, entryI
|
|
|
1284
1343
|
sessionId: string;
|
|
1285
1344
|
lastRev: string;
|
|
1286
1345
|
lastAt: number;
|
|
1346
|
+
attribution?: "overlap";
|
|
1287
1347
|
}>;
|
|
1288
1348
|
pendingLatched: boolean;
|
|
1289
1349
|
}>;
|
|
@@ -1299,9 +1359,10 @@ export declare function clearLineageForEntries(docs: MemoryGovernanceDocs, entry
|
|
|
1299
1359
|
* can never write a deleted id's lineage row back (the read and the clear being two separate
|
|
1300
1360
|
* lock spans was exactly the interleave that both missed a landing contributor and then erased
|
|
1301
1361
|
* the record of having missed it).
|
|
1302
|
-
* Struck pending rows contribute
|
|
1303
|
-
*
|
|
1304
|
-
*
|
|
1362
|
+
* Struck pending rows contribute to the returned set the session the commit path would promote them
|
|
1363
|
+
* under — their own `sessionId` (an overlap row: another live writer's), else their txn's — EXCEPT
|
|
1364
|
+
* rows carrying the structural `kind: "latch-only"` seat (an import protocol's synthetic latch is not
|
|
1365
|
+
* a contributing session; the row is still struck). Returns id → contributing session ids
|
|
1305
1366
|
* (committed ∪ struck). NON-durable by design: a crash between the caller's journal close and this
|
|
1306
1367
|
* call loses the return set — the caller's replay re-runs it idempotently and its attestation
|
|
1307
1368
|
* carries the chain's pre-captured set (honest downgrade, never a fabricated rebuild).
|
|
@@ -1334,6 +1395,7 @@ export declare function importLineageCommitted(docs: MemoryGovernanceDocs, rows:
|
|
|
1334
1395
|
lastRev: string;
|
|
1335
1396
|
lastAt: number;
|
|
1336
1397
|
marked?: true;
|
|
1398
|
+
attribution?: "overlap";
|
|
1337
1399
|
}>): Promise<LineageImportDivergence[]>;
|
|
1338
1400
|
/** Full-ledger read (tests / host observability). Throws on corruption. */
|
|
1339
1401
|
export declare function readLineageRecord(docs: MemoryGovernanceDocs): Promise<{
|
|
@@ -1555,9 +1617,9 @@ export declare function writeAllSync(fd: number, data: string): void;
|
|
|
1555
1617
|
* is not fsync'd (stores/file/fs-atomic.ts has the dir-fsync variant for stores that need it), so
|
|
1556
1618
|
* a crash in that window can resurface the old content. Sidecars tolerate that (they are rebuilt
|
|
1557
1619
|
* or re-derived); do not route data that can't through here. Throws on failure (fail-closed: a
|
|
1558
|
-
* sidecar that cannot be written must not be silently skipped). The tmp file is
|
|
1559
|
-
*
|
|
1560
|
-
* never a file this write truncates or writes through. */
|
|
1620
|
+
* sidecar that cannot be written must not be silently skipped). The tmp file is opened by the one
|
|
1621
|
+
* exclusive opener ({@link openExclusiveTemp}): a name already standing there (a link or a file somebody placed)
|
|
1622
|
+
* is skipped for a fresh one, never a file this write truncates or writes through. */
|
|
1561
1623
|
export declare function atomicWriteFileSync(path: string, data: string): void;
|
|
1562
1624
|
/** Content-gated {@link atomicWriteFileSync} for a DERIVED/control-plane file: a byte-identical
|
|
1563
1625
|
* rewrite (the common case on a repeat mount over an unchanged store) is skipped entirely, so the
|
|
@@ -5,7 +5,9 @@ import { createHash, randomUUID } from "node:crypto";
|
|
|
5
5
|
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
6
6
|
import { MEMORY_GOVERNANCE_DOC_NAMES, MEMORY_ORIGIN_CAUSES } from "./types.js";
|
|
7
7
|
import { parseEntryFile } from "./frontmatter.js";
|
|
8
|
+
import { openExclusiveTemp } from "../exclusive-temp.js";
|
|
8
9
|
import { physicalPathOf, physicalPathOfExisting, priorCallerCasedPathOf } from "../physical-path.js";
|
|
10
|
+
import { sensitiveRowOf } from "../sensitive-path-policy.js";
|
|
9
11
|
import { thrownLabel, thrownText } from "../thrown-value.js";
|
|
10
12
|
import { egressText } from "../untrusted-egress.js";
|
|
11
13
|
import { optionKeys, receiveMembers } from "../own-property-receipt.js";
|
|
@@ -168,7 +170,7 @@ export function recordProjectIdHint(configRoot, repoRoot, projectId) {
|
|
|
168
170
|
if (hints[key] === projectId.toLowerCase())
|
|
169
171
|
return;
|
|
170
172
|
hints[key] = projectId.toLowerCase();
|
|
171
|
-
|
|
173
|
+
ensureDirExists(configRoot);
|
|
172
174
|
atomicWriteFileSync(path, `${JSON.stringify(hints, null, 2)}\n`);
|
|
173
175
|
}
|
|
174
176
|
catch {
|
|
@@ -199,8 +201,10 @@ export function effectiveControlRootOf(dir, opts = {}) {
|
|
|
199
201
|
if (opts.controlDir !== undefined)
|
|
200
202
|
return opts.controlDir;
|
|
201
203
|
const configRoot = resolveMemoryEngineRoot();
|
|
204
|
+
const control = deriveControlPlaneDir(configRoot, dir);
|
|
205
|
+
assertStoreRootsNotSensitive(dir, control);
|
|
202
206
|
adoptCanonicalKeyedControlDir(configRoot, dir, opts.onIncident);
|
|
203
|
-
return
|
|
207
|
+
return control;
|
|
204
208
|
}
|
|
205
209
|
export function resolveMemoryEngineRoot(explicit) {
|
|
206
210
|
const raw = explicit ?? process.env.AGENT_DATA_DIR ?? join(homedir(), ".ai-agent");
|
|
@@ -749,17 +753,23 @@ export function isContainedIn(root, child) {
|
|
|
749
753
|
const c = canonicalize(child);
|
|
750
754
|
return c === r || c.startsWith(`${r}${sep}`);
|
|
751
755
|
}
|
|
752
|
-
export const STORE_FORM_REFUSAL_CODES = Object.freeze(["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays"]);
|
|
756
|
+
export const STORE_FORM_REFUSAL_CODES = Object.freeze(["memory.target_outside_store", "memory.scope_home_not_directory", "memory.control_plane_links_unsupported", "memory.control_plane_strays", "memory.store_root_sensitive"]);
|
|
753
757
|
export const TARGET_OUTSIDE_STORE = "memory.target_outside_store";
|
|
754
758
|
export const SCOPE_HOME_NOT_DIRECTORY = "memory.scope_home_not_directory";
|
|
755
759
|
export const CONTROL_PLANE_LINKS_UNSUPPORTED = "memory.control_plane_links_unsupported";
|
|
756
760
|
export const CONTROL_PLANE_STRAYS = "memory.control_plane_strays";
|
|
761
|
+
export const STORE_ROOT_SENSITIVE = "memory.store_root_sensitive";
|
|
757
762
|
export const SCOPE_HOME_FORMS = Object.freeze(["symlink", "file", "other"]);
|
|
758
763
|
const SCOPE_HOME_FORM_PHRASE = {
|
|
759
764
|
symlink: "a symbolic link",
|
|
760
765
|
file: "a regular file",
|
|
761
766
|
other: "a special file",
|
|
762
767
|
};
|
|
768
|
+
const STORE_ROOT_WORDS = {
|
|
769
|
+
store: { what: "memory store root", remedy: "point the memory engine root (memoryEngineDir, or the file backend's directory) at a directory outside it" },
|
|
770
|
+
control_plane: { what: "memory control plane", remedy: "point the data root (AGENT_DATA_DIR, or the backend's controlDir) at a directory outside it" },
|
|
771
|
+
engine_root: { what: "memory engine root", remedy: "point the memory engine root (memoryEngineDir, or AGENT_DATA_DIR) at a directory outside it" },
|
|
772
|
+
};
|
|
763
773
|
function storeFormRefusal(code, sentence, detail) {
|
|
764
774
|
const e = new Error(`${code}: ${sentence}`);
|
|
765
775
|
e.code = code;
|
|
@@ -781,6 +791,10 @@ export function scopeHomeRefusal(form, path) {
|
|
|
781
791
|
export function controlPlaneLinksRefusal(path, fault) {
|
|
782
792
|
return storeFormRefusal(CONTROL_PLANE_LINKS_UNSUPPORTED, `the memory control plane is on a file system that cannot make hard links (link answered ${fault ?? "an error with no code"}) — the store publishes its control objects (quarantine copies, held files, pollution markers) with link, so it is not opened and no entry or control object was written; move the control plane (controlDir, or the memory engine root) to a volume that supports hard links`, { path });
|
|
783
793
|
}
|
|
794
|
+
export function storeRootSensitiveRefusal(of, path, row) {
|
|
795
|
+
const { what, remedy } = STORE_ROOT_WORDS[of];
|
|
796
|
+
return storeFormRefusal(STORE_ROOT_SENSITIVE, `the ${what} is inside a path the write guard protects (its \`${row}\` row) — a library kept there is a library that path's escalation vector holds, so it is refused (fail-closed) and nothing was created or written; ${remedy}`, { path, row, of });
|
|
797
|
+
}
|
|
784
798
|
export function controlPlaneStraysRefusal(path, strays) {
|
|
785
799
|
const named = [...strays.docs.map((d) => `the ${d} document`), ...Object.entries(strays.objects).map(([kind, n]) => `${n} ${kind} entr${n === 1 ? "y" : "ies"}`)];
|
|
786
800
|
return storeFormRefusal(CONTROL_PLANE_STRAYS, `the memory backend carries its own governance store, and the engine's control plane still holds that store's records from before (${named.join(", ")}) — they would be read by nobody, so the engine is not opened and nothing was written; adopt them into the carrier first (adoptReplicaControlPlane(detail.path, <the backend's governance store>), which removes each one it hands over), then reopen`, { path });
|
|
@@ -893,7 +907,25 @@ function writeStoreRootAnchor(controlDir, lock, token, anchor) {
|
|
|
893
907
|
assertSidecarLockOwnership(lock, token, "memory store root anchor", "strict");
|
|
894
908
|
atomicWriteFileSync(join(controlDir, ROOT_ANCHOR_FILE), `${JSON.stringify(anchor, null, 2)}\n`);
|
|
895
909
|
}
|
|
910
|
+
export function assertRootNotSensitive(of, root) {
|
|
911
|
+
const spellings = [resolve(root)];
|
|
912
|
+
try {
|
|
913
|
+
const landed = landingPathOf(root);
|
|
914
|
+
if (landed !== spellings[0])
|
|
915
|
+
spellings.push(landed);
|
|
916
|
+
}
|
|
917
|
+
catch {
|
|
918
|
+
}
|
|
919
|
+
const row = sensitiveRowOf(spellings);
|
|
920
|
+
if (row !== undefined)
|
|
921
|
+
throw storeRootSensitiveRefusal(of, root, row);
|
|
922
|
+
}
|
|
923
|
+
export function assertStoreRootsNotSensitive(dir, controlDir) {
|
|
924
|
+
assertRootNotSensitive("store", dir);
|
|
925
|
+
assertRootNotSensitive("control_plane", controlDir);
|
|
926
|
+
}
|
|
896
927
|
export function anchorStoreRoot(dir, controlDir, opts = {}) {
|
|
928
|
+
assertStoreRootsNotSensitive(dir, controlDir);
|
|
897
929
|
const anchor = readStoreRootAnchor(controlDir, dir);
|
|
898
930
|
if (anchor !== undefined)
|
|
899
931
|
return judgeAgainstAnchor(dir, controlDir, anchor);
|
|
@@ -925,19 +957,20 @@ export const TXN_LOCK_STALE_MS = 30_000;
|
|
|
925
957
|
const TXN_LOCK_WAIT_MS = 15_000;
|
|
926
958
|
const TXN_LOCK_STEAL_GRACE_MS = 250;
|
|
927
959
|
export function tryStoreTxnLock(controlDir, opts) {
|
|
960
|
+
assertRootNotSensitive("control_plane", controlDir);
|
|
928
961
|
const lockDir = join(controlDir, STORE_TXN_LOCK_DIR);
|
|
929
962
|
const ownerPath = join(lockDir, "owner");
|
|
930
963
|
const staleMs = opts.staleMs ?? TXN_LOCK_STALE_MS;
|
|
931
964
|
const faultText = (err) => err.code ?? "io error";
|
|
932
965
|
const tryMkdir = () => {
|
|
933
966
|
try {
|
|
934
|
-
mkdirSync(controlDir, { recursive: true });
|
|
967
|
+
mkdirSync(controlDir, { recursive: true, mode: 0o700 });
|
|
935
968
|
}
|
|
936
969
|
catch (err) {
|
|
937
970
|
throw new ControlPlaneCorruptError(`memory control-plane root could not be created (${faultText(err)}) at ${controlDir} — a lock-acquisition fault is not contention (fail-closed)`, { cause: err });
|
|
938
971
|
}
|
|
939
972
|
try {
|
|
940
|
-
mkdirSync(lockDir);
|
|
973
|
+
mkdirSync(lockDir, { mode: 0o700 });
|
|
941
974
|
return true;
|
|
942
975
|
}
|
|
943
976
|
catch (err) {
|
|
@@ -1005,7 +1038,7 @@ export function tryStoreTxnLock(controlDir, opts) {
|
|
|
1005
1038
|
}
|
|
1006
1039
|
const token = randomUUID();
|
|
1007
1040
|
try {
|
|
1008
|
-
const fd = openSync(ownerPath, "
|
|
1041
|
+
const fd = openSync(ownerPath, "wx", 0o600);
|
|
1009
1042
|
try {
|
|
1010
1043
|
writeAllSync(fd, token);
|
|
1011
1044
|
fsyncSync(fd);
|
|
@@ -1210,10 +1243,10 @@ export function writeFileNoFollow(path, content) {
|
|
|
1210
1243
|
if (names > 1)
|
|
1211
1244
|
atomicWriteFileSync(path, content);
|
|
1212
1245
|
}
|
|
1213
|
-
export function writeFileNoReplace(path, content) {
|
|
1246
|
+
export function writeFileNoReplace(path, content, mode = 0o644) {
|
|
1214
1247
|
let fd;
|
|
1215
1248
|
try {
|
|
1216
|
-
fd = openSync(path, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW,
|
|
1249
|
+
fd = openSync(path, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW, mode);
|
|
1217
1250
|
}
|
|
1218
1251
|
catch (err) {
|
|
1219
1252
|
if (err.code === "EEXIST")
|
|
@@ -1235,7 +1268,7 @@ export function mintStagingName(owner, now) {
|
|
|
1235
1268
|
}
|
|
1236
1269
|
export function stagingNamePattern(owner) {
|
|
1237
1270
|
const head = owner === undefined
|
|
1238
|
-
? String.raw `(?:hold-\d+-[0-9a-f]{12}\.staging-\d+-\d+-\d
|
|
1271
|
+
? String.raw `(?:hold-\d+-[0-9a-f]{12}\.staging-\d+-\d+-\d+|(?:\d+|[0-9a-f]{16})-residue-[^/]+\.md\.staging(?:-\d+-\d+-\d+)?)`
|
|
1239
1272
|
: String.raw `${owner.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\.staging-\d+-\d+-\d+`;
|
|
1240
1273
|
return new RegExp(String.raw `^${head}(?:\.claim-\d+-\d+)*$`);
|
|
1241
1274
|
}
|
|
@@ -1340,20 +1373,40 @@ export async function putControlObjectOnce(objects, kind, name, bytes) {
|
|
|
1340
1373
|
return "existed";
|
|
1341
1374
|
}
|
|
1342
1375
|
}
|
|
1376
|
+
export const CONTROL_OBJECT_NAME_MAX_BYTES = 255;
|
|
1377
|
+
export function quarantineObjectNameOf(content, source) {
|
|
1378
|
+
const digest = content instanceof Uint8Array ? createHash("sha256").update(content).digest("hex") : content.sha256;
|
|
1379
|
+
const head = `${digest.slice(0, 16)}-`;
|
|
1380
|
+
let room = CONTROL_OBJECT_NAME_MAX_BYTES - 2 - Buffer.byteLength(head, "utf8");
|
|
1381
|
+
let label = "";
|
|
1382
|
+
for (const char of basename(source)) {
|
|
1383
|
+
const spelled = labelCharSpelled(char);
|
|
1384
|
+
room -= Buffer.byteLength(spelled, "utf8");
|
|
1385
|
+
if (room < 0)
|
|
1386
|
+
break;
|
|
1387
|
+
label += spelled;
|
|
1388
|
+
}
|
|
1389
|
+
return head + label;
|
|
1390
|
+
}
|
|
1391
|
+
function labelCharSpelled(char) {
|
|
1392
|
+
if (!/[\p{Cc}\\]/u.test(char))
|
|
1393
|
+
return char;
|
|
1394
|
+
return [...Buffer.from(char, "utf8")].map((byte) => `%${byte.toString(16).toUpperCase().padStart(2, "0")}`).join("");
|
|
1395
|
+
}
|
|
1343
1396
|
export function quarantineCaptureName(base, attempt) {
|
|
1344
1397
|
return attempt === 0 ? base : attempt < 10 ? `${base}.${attempt}` : `${base}.${process.pid}.${quarantineSeq++}`;
|
|
1345
1398
|
}
|
|
1346
|
-
export function
|
|
1347
|
-
|
|
1348
|
-
|
|
1349
|
-
export async function captureIntoQuarantine(objects, path, content, now) {
|
|
1350
|
-
const bytes = new TextEncoder().encode(content);
|
|
1351
|
-
const base = quarantineCaptureBase(path, now);
|
|
1399
|
+
export async function captureIntoQuarantine(objects, source, content) {
|
|
1400
|
+
const bytes = typeof content === "string" ? new TextEncoder().encode(content) : content;
|
|
1401
|
+
const base = quarantineObjectNameOf(bytes, source);
|
|
1352
1402
|
try {
|
|
1353
1403
|
for (let attempt = 0; attempt <= 10; attempt++) {
|
|
1354
1404
|
const name = quarantineCaptureName(base, attempt);
|
|
1355
1405
|
if ((await putControlObjectOnce(objects, "quarantine", name, bytes)) === "created")
|
|
1356
1406
|
return { name };
|
|
1407
|
+
const standing = await objects.getObject("quarantine", name);
|
|
1408
|
+
if (standing !== undefined && Buffer.from(standing).equals(bytes))
|
|
1409
|
+
return { name };
|
|
1357
1410
|
}
|
|
1358
1411
|
return { failed: "quarantine copy failed: every capture name already stands" };
|
|
1359
1412
|
}
|
|
@@ -1617,11 +1670,11 @@ export function acquireSidecarLock(lockDir, opts = {}) {
|
|
|
1617
1670
|
};
|
|
1618
1671
|
for (;;) {
|
|
1619
1672
|
try {
|
|
1620
|
-
mkdirSync(lockDir);
|
|
1673
|
+
mkdirSync(lockDir, { mode: 0o700 });
|
|
1621
1674
|
const token = mintToken();
|
|
1622
1675
|
let fd;
|
|
1623
1676
|
try {
|
|
1624
|
-
fd = openSync(join(lockDir, "owner"), "
|
|
1677
|
+
fd = openSync(join(lockDir, "owner"), "wx", 0o600);
|
|
1625
1678
|
writeAllSync(fd, token);
|
|
1626
1679
|
}
|
|
1627
1680
|
catch {
|
|
@@ -2426,6 +2479,15 @@ export function readStrictSidecar(controlDir, fileName, what) {
|
|
|
2426
2479
|
}
|
|
2427
2480
|
return readStrictSidecarRaw(file, what);
|
|
2428
2481
|
}
|
|
2482
|
+
function landContribution(sessions, sessionId, incoming) {
|
|
2483
|
+
const standing = Object.prototype.hasOwnProperty.call(sessions, sessionId) ? sessions[sessionId] : undefined;
|
|
2484
|
+
if (incoming.attribution !== undefined && standing !== undefined && standing.attribution === undefined) {
|
|
2485
|
+
const { attribution: _overlap, ...asWriter } = incoming;
|
|
2486
|
+
sessions[sessionId] = asWriter;
|
|
2487
|
+
return;
|
|
2488
|
+
}
|
|
2489
|
+
sessions[sessionId] = incoming;
|
|
2490
|
+
}
|
|
2429
2491
|
function coerceLineage(raw) {
|
|
2430
2492
|
if (raw === undefined) {
|
|
2431
2493
|
return { version: 1, committed: Object.create(null), pending: Object.create(null) };
|
|
@@ -2453,6 +2515,9 @@ function coerceLineage(raw) {
|
|
|
2453
2515
|
if (!isIncarnationSeat(row.incarnation)) {
|
|
2454
2516
|
throw badShape(`committed[${JSON.stringify(entryId)}][${JSON.stringify(sid)}] incarnation`);
|
|
2455
2517
|
}
|
|
2518
|
+
if (row.attribution !== undefined && row.attribution !== "overlap") {
|
|
2519
|
+
throw badShape(`committed[${JSON.stringify(entryId)}][${JSON.stringify(sid)}] attribution`);
|
|
2520
|
+
}
|
|
2456
2521
|
}
|
|
2457
2522
|
}
|
|
2458
2523
|
for (const [txnId, t] of Object.entries(r.pending)) {
|
|
@@ -2468,6 +2533,9 @@ function coerceLineage(raw) {
|
|
|
2468
2533
|
const p = row;
|
|
2469
2534
|
if (!p || typeof p !== "object" || typeof p.entryId !== "string" || typeof p.rev !== "string")
|
|
2470
2535
|
throw badShape(`pending[${JSON.stringify(txnId)}] row`);
|
|
2536
|
+
if ((p.sessionId === undefined) !== (p.attribution === undefined) || (p.sessionId !== undefined && (typeof p.sessionId !== "string" || p.sessionId.length === 0)) || (p.attribution !== undefined && p.attribution !== "overlap")) {
|
|
2537
|
+
throw badShape(`pending[${JSON.stringify(txnId)}] row attribution`);
|
|
2538
|
+
}
|
|
2471
2539
|
if (p.kind !== undefined && p.kind !== "latch-only")
|
|
2472
2540
|
throw badShape(`pending[${JSON.stringify(txnId)}] row kind`);
|
|
2473
2541
|
if (p.marked !== undefined && p.marked !== true)
|
|
@@ -2515,6 +2583,12 @@ export async function recordLineageCredential(docs, txnId, appliedIds, now) {
|
|
|
2515
2583
|
return { next: rec, result: undefined };
|
|
2516
2584
|
});
|
|
2517
2585
|
}
|
|
2586
|
+
function promotedContribution(txn, row, at) {
|
|
2587
|
+
const marked = row.marked === true ? { marked: true } : {};
|
|
2588
|
+
if (row.sessionId !== undefined)
|
|
2589
|
+
return { sessionId: row.sessionId, contribution: { lastRev: row.rev, lastAt: at, ...marked, attribution: "overlap" } };
|
|
2590
|
+
return { sessionId: txn.sessionId, contribution: { lastRev: row.rev, lastAt: at, ...marked, ...(txn.incarnation !== undefined ? { incarnation: txn.incarnation } : {}) } };
|
|
2591
|
+
}
|
|
2518
2592
|
export async function promoteLineagePending(docs, txnId) {
|
|
2519
2593
|
return docs.updateDoc("lineage", coerceLineage, (rec) => {
|
|
2520
2594
|
const txn = rec.pending[txnId];
|
|
@@ -2530,8 +2604,9 @@ export async function promoteLineagePending(docs, txnId) {
|
|
|
2530
2604
|
if (!applied.has(row.entryId))
|
|
2531
2605
|
continue;
|
|
2532
2606
|
const sessions = (rec.committed[row.entryId] ??= Object.create(null));
|
|
2533
|
-
|
|
2534
|
-
|
|
2607
|
+
const promotion = promotedContribution(txn, row, at);
|
|
2608
|
+
landContribution(sessions, promotion.sessionId, promotion.contribution);
|
|
2609
|
+
promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
|
|
2535
2610
|
}
|
|
2536
2611
|
delete rec.pending[txnId];
|
|
2537
2612
|
return { next: rec, result: promoted };
|
|
@@ -2556,8 +2631,9 @@ export async function adjudicateLineagePending(docs, txnId, action, now) {
|
|
|
2556
2631
|
if (applied !== undefined && !applied.has(row.entryId))
|
|
2557
2632
|
continue;
|
|
2558
2633
|
const sessions = (rec.committed[row.entryId] ??= Object.create(null));
|
|
2559
|
-
|
|
2560
|
-
|
|
2634
|
+
const promotion = promotedContribution(txn, row, at);
|
|
2635
|
+
landContribution(sessions, promotion.sessionId, promotion.contribution);
|
|
2636
|
+
promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
|
|
2561
2637
|
}
|
|
2562
2638
|
delete rec.pending[txnId];
|
|
2563
2639
|
return { next: rec, result: promoted };
|
|
@@ -2578,8 +2654,9 @@ export async function reconcileLineage(docs) {
|
|
|
2578
2654
|
if (!applied.has(row.entryId))
|
|
2579
2655
|
continue;
|
|
2580
2656
|
const sessions = (rec.committed[row.entryId] ??= Object.create(null));
|
|
2581
|
-
|
|
2582
|
-
|
|
2657
|
+
const promotion = promotedContribution(txn, row, txn.credential.at);
|
|
2658
|
+
landContribution(sessions, promotion.sessionId, promotion.contribution);
|
|
2659
|
+
promoted.push({ entryId: row.entryId, sessionId: promotion.sessionId, rev: row.rev, ...(row.marked === true ? { marked: true } : {}) });
|
|
2583
2660
|
}
|
|
2584
2661
|
delete rec.pending[txnId];
|
|
2585
2662
|
changed = true;
|
|
@@ -2658,14 +2735,14 @@ export async function lineageContributionsOfSession(docs, sessionId, asking) {
|
|
|
2658
2735
|
const c = Object.prototype.hasOwnProperty.call(sessions, sessionId) ? sessions[sessionId] : undefined;
|
|
2659
2736
|
if (c === undefined || !sessionRecordBindsIncarnation(c.incarnation, asking))
|
|
2660
2737
|
continue;
|
|
2661
|
-
out.push({ entryId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.marked === true ? { marked: true } : {}) });
|
|
2738
|
+
out.push({ entryId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.marked === true ? { marked: true } : {}), ...(c.attribution !== undefined ? { attribution: c.attribution } : {}) });
|
|
2662
2739
|
}
|
|
2663
2740
|
return out;
|
|
2664
2741
|
}
|
|
2665
2742
|
export async function lineageAccountOfEntry(docs, entryId) {
|
|
2666
2743
|
const rec = coerceLineage(await docs.readDoc("lineage"));
|
|
2667
2744
|
const sessions = Object.prototype.hasOwnProperty.call(rec.committed, entryId) ? rec.committed[entryId] : undefined;
|
|
2668
|
-
const contributors = sessions === undefined ? [] : Object.entries(sessions).map(([sessionId, c]) => ({ sessionId, lastRev: c.lastRev, lastAt: c.lastAt }));
|
|
2745
|
+
const contributors = sessions === undefined ? [] : Object.entries(sessions).map(([sessionId, c]) => ({ sessionId, lastRev: c.lastRev, lastAt: c.lastAt, ...(c.attribution !== undefined ? { attribution: c.attribution } : {}) }));
|
|
2669
2746
|
let pendingLatched = false;
|
|
2670
2747
|
for (const txn of Object.values(rec.pending)) {
|
|
2671
2748
|
if (txn.rows.some((r) => r.entryId === entryId)) {
|
|
@@ -2718,7 +2795,7 @@ export async function captureAndClearLineageForEntries(docs, entryIds) {
|
|
|
2718
2795
|
}
|
|
2719
2796
|
changed = true;
|
|
2720
2797
|
if (row.kind !== "latch-only")
|
|
2721
|
-
add(row.entryId, txn.sessionId);
|
|
2798
|
+
add(row.entryId, row.sessionId ?? txn.sessionId);
|
|
2722
2799
|
}
|
|
2723
2800
|
txn.rows = keep;
|
|
2724
2801
|
}
|
|
@@ -2738,7 +2815,7 @@ export async function importLineageCommitted(docs, rows) {
|
|
|
2738
2815
|
const sessions = (rec.committed[row.entryId] ??= Object.create(null));
|
|
2739
2816
|
const standing = Object.prototype.hasOwnProperty.call(sessions, row.sessionId) ? sessions[row.sessionId] : undefined;
|
|
2740
2817
|
if (standing === undefined || row.lastAt > standing.lastAt) {
|
|
2741
|
-
sessions
|
|
2818
|
+
landContribution(sessions, row.sessionId, { lastRev: row.lastRev, lastAt: row.lastAt, ...(row.marked === true ? { marked: true } : {}), ...(row.attribution === "overlap" ? { attribution: "overlap" } : {}) });
|
|
2742
2819
|
changed = true;
|
|
2743
2820
|
continue;
|
|
2744
2821
|
}
|
|
@@ -3099,8 +3176,7 @@ export function writeAllSync(fd, data) {
|
|
|
3099
3176
|
}
|
|
3100
3177
|
export function atomicWriteFileSync(path, data) {
|
|
3101
3178
|
ensureDirExists(dirname(path));
|
|
3102
|
-
const tmp = join(dirname(path),
|
|
3103
|
-
const fd = openSync(tmp, O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW, 0o600);
|
|
3179
|
+
const { fd, path: tmp } = openExclusiveTemp(join(dirname(path), ATOMIC_WRITE_TMP_PREFIX));
|
|
3104
3180
|
try {
|
|
3105
3181
|
writeAllSync(fd, data);
|
|
3106
3182
|
fsyncSync(fd);
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
2
|
import { MemoryEngine } from "./engine.js";
|
|
3
3
|
import { derivePersonalControlDir, derivePersonalMemoryDir, directoryPinOf, judgeMemoryStoreSeat, memoryPlaneStore, memoryScopePlaneOf, mergeErasureAttestations, refuseMemoryStoreInput } from "./dual-root.js";
|
|
4
|
-
import { acquireStoreTxnLock, assertStoreTxnLockOwnership, ControlPlaneCorruptError, renewStoreTxnLock, resolveMemoryEngineRoot, storeHoldsRecord, storeOpenArtifactFault, TXN_LOCK_STALE_MS } from "./layout.js";
|
|
4
|
+
import { acquireStoreTxnLock, assertRootNotSensitive, assertStoreTxnLockOwnership, ControlPlaneCorruptError, renewStoreTxnLock, resolveMemoryEngineRoot, storeHoldsRecord, storeOpenArtifactFault, TXN_LOCK_STALE_MS } from "./layout.js";
|
|
5
5
|
import { captureErasureInput, erasureRequestInvalid, erasureSelectHash } from "./file-backend.js";
|
|
6
6
|
import { canonicalExpectedScopes } from "./export-bundle.js";
|
|
7
|
-
import { thrownLabel, thrownText } from "../thrown-value.js";
|
|
7
|
+
import { isEngineCodeShape, thrownLabel, thrownText } from "../thrown-value.js";
|
|
8
8
|
import { chooseSessionWriteHome } from "./session-write-home.js";
|
|
9
9
|
const FACE = "createMemoryDeployment";
|
|
10
10
|
export const MEMORY_DEPLOYMENT_ERASURE_LOCK_DIR = ".memory-erasure-judge";
|
|
@@ -48,6 +48,7 @@ export function createMemoryDeployment(input) {
|
|
|
48
48
|
refuseMemoryStoreInput(FACE, "the backend publishes no control plane (controlPlaneRoot) — a session's memory facts then live in per-project control planes no deployment-wide reading can name", backend);
|
|
49
49
|
}
|
|
50
50
|
const engineRoot = resolveMemoryEngineRoot(input.memoryEngineDir);
|
|
51
|
+
assertRootNotSensitive("engine_root", engineRoot);
|
|
51
52
|
const pinned = directoryPinOf(backend) !== undefined;
|
|
52
53
|
const seatOf = (plane, store) => {
|
|
53
54
|
const controlDir = controlOf(store);
|
|
@@ -208,12 +209,11 @@ async function anchorOf(store, requestId) {
|
|
|
208
209
|
return undefined;
|
|
209
210
|
throw coded("eraseMemoryEntries: another store of this deployment has an erasure-evidence face but no anchor read (erasureAnchorOf), so whether it already executed this requestId cannot be judged — nothing was deleted", "memory.erasure_evidence_unavailable");
|
|
210
211
|
}
|
|
211
|
-
const ERRNO_CODE = /^E[A-Z0-9]+$/;
|
|
212
212
|
function personalOpenFault(err, mount) {
|
|
213
213
|
if (err instanceof ControlPlaneCorruptError)
|
|
214
214
|
return err;
|
|
215
215
|
const code = err?.code;
|
|
216
|
-
if (typeof code === "string" &&
|
|
216
|
+
if (typeof code === "string" && isEngineCodeShape(code))
|
|
217
217
|
return err;
|
|
218
218
|
return new ControlPlaneCorruptError(`the personal plane's memory store at ${mount} could not be opened (${typeof code === "string" ? code : thrownLabel(err)}): ${thrownText(err)}`, { cause: err });
|
|
219
219
|
}
|