@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -3,7 +3,7 @@ import { isAbsolute, join, resolve } from "node:path";
|
|
|
3
3
|
import { anchorSpelling, canonicalizeTarget, expandHomeTilde, isAbsoluteForFamily, isWinFormPath, pathFamilyOf, writeTargetPath } from "../tools/fs/safety.js";
|
|
4
4
|
import { spelledExemptionOf } from "./write-protect.js";
|
|
5
5
|
import { compileSegmentPattern, READ_FACE_BUILTIN_DENY_TABLE, readDenyPatternRun, SEGMENT_FOLDS, segmentGuardRow } from "../tools/fs/read-deny.js";
|
|
6
|
-
import { guardHitReachClause, guardHitVia, judgePathRows } from "./path-guard-rows.js";
|
|
6
|
+
import { guardHitReachClause, guardHitVia, judgePathRows, spelledViews } from "./path-guard-rows.js";
|
|
7
7
|
import { agentConfigDirSegments, agentConfigDirTail, checkedAgentConfigDir } from "./agent-config-dir.js";
|
|
8
8
|
import { isProtectedWrite, protectivePathTargetOf } from "./tool-registry.js";
|
|
9
9
|
import { pathTargetBaseOf } from "./effective-path-target.js";
|
|
@@ -115,13 +115,21 @@ function compilePatterns(patterns) {
|
|
|
115
115
|
}
|
|
116
116
|
return out;
|
|
117
117
|
}
|
|
118
|
+
function sensitiveGuardRow(c) {
|
|
119
|
+
return segmentGuardRow(c, { faces: ["write"], polarity: "deny", exemptible: true, fold: CASE_INSENSITIVE_FS ? "host" : "exact", origin: "replacement" });
|
|
120
|
+
}
|
|
121
|
+
let recommendedRows;
|
|
122
|
+
export function sensitiveRowOf(spellings) {
|
|
123
|
+
recommendedRows ??= compilePatterns(RECOMMENDED_SENSITIVE_PATTERNS).map(sensitiveGuardRow);
|
|
124
|
+
return judgePathRows(recommendedRows, spelledViews(spellings), "tighten")?.row.name;
|
|
125
|
+
}
|
|
118
126
|
const RETIRED_SENSITIVE_PATH_POLICY_KEYS = Object.freeze({
|
|
119
127
|
dataRoot: "the data-root exemption reads the engine's one exempt root — a Runner resolves it once per leg from `RunnerDeps.memoryEngineDir` and stamps it on every request this policy judges (`ToolCallRequest.exemptRoots`); set the data root there and drop the option",
|
|
120
128
|
});
|
|
121
129
|
export function createSensitivePathPolicy(opts) {
|
|
122
130
|
assertNoRetiredKeys(opts, RETIRED_SENSITIVE_PATH_POLICY_KEYS, "createSensitivePathPolicy option");
|
|
123
131
|
const compiled = compilePatterns(opts.patterns);
|
|
124
|
-
const rowOf =
|
|
132
|
+
const rowOf = sensitiveGuardRow;
|
|
125
133
|
const guardRows = compiled.map(rowOf);
|
|
126
134
|
const configRoot = checkedAgentConfigDir(opts.agentConfigDir, "createSensitivePathPolicy agentConfigDir");
|
|
127
135
|
const configRows = configRoot === undefined ? [] : opts.patterns.flatMap((raw) => {
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import type { ExecutionEnv, Session,
|
|
1
|
+
import type { ExecutionEnv, Session, SessionCheckoutDeclared, SessionCheckoutRecord } from "../internal/harness-types.js";
|
|
2
|
+
import { type ReleasedTree } from "./git-worktree-env.js";
|
|
3
|
+
import type { WorkspaceSnapshot } from "./workspace-snapshot.js";
|
|
2
4
|
/** One declared code source: the root it is for, the repository URL (`https` only), the full commit id the session's code
|
|
3
5
|
* starts from, and a display label. */
|
|
4
6
|
export interface WorkspaceSourceDeclaration {
|
|
@@ -27,7 +29,7 @@ export interface WorkspaceDeclaration {
|
|
|
27
29
|
readonly sources?: readonly WorkspaceSourceDeclaration[];
|
|
28
30
|
}
|
|
29
31
|
/** Why a checkout cannot get a managed tree here — the probe's closed set. */
|
|
30
|
-
export declare const WORKTREE_INCAPABLE_REASONS: readonly ["git_unavailable", "not_a_repository", "bare_repository", "no_commit", "managed_parent_symlinked", "parent_not_writable", "name_in_use"];
|
|
32
|
+
export declare const WORKTREE_INCAPABLE_REASONS: readonly ["name_invalid", "git_unavailable", "not_a_repository", "bare_repository", "no_commit", "managed_parent_symlinked", "parent_not_writable", "name_in_use"];
|
|
31
33
|
export type WorktreeIncapableReason = (typeof WORKTREE_INCAPABLE_REASONS)[number];
|
|
32
34
|
/** What {@link probeWorktreeCapability} answered. `gitRoot` = the repository root the managed parent hangs at (present once
|
|
33
35
|
* the location is known to be a repository). */
|
|
@@ -38,27 +40,23 @@ export interface WorktreeCapability {
|
|
|
38
40
|
/** One human sentence for the refusal; absent when capable. */
|
|
39
41
|
readonly detail?: string;
|
|
40
42
|
}
|
|
41
|
-
|
|
42
|
-
export interface ReleasedTree {
|
|
43
|
-
readonly path: string;
|
|
44
|
-
readonly removed: boolean;
|
|
45
|
-
readonly branch?: string;
|
|
46
|
-
readonly kept?: "dirty" | "ignored" | "commits" | "unverifiable" | "requested" | "not_owned";
|
|
47
|
-
readonly detail?: string;
|
|
48
|
-
}
|
|
43
|
+
export type { ReleasedTree } from "./git-worktree-env.js";
|
|
49
44
|
/**
|
|
50
45
|
* THE shape judge of `TaskSpec.workspace` — `undefined` for an absent declaration, else the normalized declaration the record
|
|
51
|
-
* stores and every later leg is compared on.
|
|
52
|
-
*
|
|
46
|
+
* stores and every later leg is compared on. Read once as data ({@link DECLARATION_DATA}), then judged on that copy. Refused
|
|
47
|
+
* (`config.session_workspace_invalid`): a non-object, a value that is not plain data (a Proxy, an accessor, a class instance, a
|
|
48
|
+
* member that is not an enumerable data property), an unknown key, a word outside a closed set, `baseRef` / `name` without `isolation`, a name outside the managed grammar, an empty or oversized
|
|
53
49
|
* `sources`, two sources for one root, a source for the isolated task root together with `baseRef`, a declaration that declares
|
|
54
50
|
* nothing.
|
|
55
51
|
*/
|
|
56
52
|
export declare function screenWorkspaceDeclaration(value: unknown): SessionCheckoutDeclared | undefined;
|
|
57
53
|
/**
|
|
58
|
-
* THE capability judge of a managed tree for the checkout at `cwd`:
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
54
|
+
* THE capability judge of a managed tree for the checkout at `cwd`: — with `name` — that name is a managed name (the declaration's
|
|
55
|
+
* own grammar, {@link worktreeNameProblem}; a pure judgment of the argument, asked before anything is read, its `detail` the
|
|
56
|
+
* grammar's own sentence), git runs, `cwd` is inside a non-bare work tree with a commit, no level of the managed parent is a
|
|
57
|
+
* symlink, the managed parent can be written, and the name's directory and branch are free. The first failing check answers,
|
|
58
|
+
* in that order. Reads only (no git write); a host calls it before offering isolation, and a session's first leg calls it
|
|
59
|
+
* before minting.
|
|
62
60
|
*/
|
|
63
61
|
export declare function probeWorktreeCapability(env: ExecutionEnv, cwd: string, opts?: {
|
|
64
62
|
readonly name?: string;
|
|
@@ -74,6 +72,8 @@ export interface OpenSessionCheckoutInput {
|
|
|
74
72
|
readonly baseRoot: string;
|
|
75
73
|
/** The leg's `TaskSpec.additionalDirectories` (declared spellings). */
|
|
76
74
|
readonly additionalDirectories: readonly string[] | undefined;
|
|
75
|
+
/** The working directory a durable resume restores (the checkpoint's `handsCwd`); absent on a leg that resumes nothing. */
|
|
76
|
+
readonly restoredCwd?: string;
|
|
77
77
|
}
|
|
78
78
|
export interface OpenedSessionCheckout {
|
|
79
79
|
/** The leg's task root: the task root's place in the session's tree when the task root's repository is isolated, else `baseRoot`. */
|
|
@@ -82,11 +82,11 @@ export interface OpenedSessionCheckout {
|
|
|
82
82
|
readonly record?: SessionCheckoutRecord;
|
|
83
83
|
}
|
|
84
84
|
/**
|
|
85
|
-
* THE per-leg judge of a session's checkout (see the module header): reads the record,
|
|
86
|
-
* mints the allocation on the session's first leg, and answers the leg's task root. Throws a coded
|
|
87
|
-
* allocation records nothing unless everything succeeded (every path check runs before the mint; a
|
|
88
|
-
* allocation is removed while still clean only when its allocation mark is proved absent, else kept
|
|
89
|
-
* written only once everything succeeded — immediately, not at settle).
|
|
85
|
+
* THE per-leg judge of a session's checkout (see the module header): reads the record, reads the leg's declaration against it
|
|
86
|
+
* ({@link legWorkspaceOf}), mints the allocation on the session's first leg, and answers the leg's task root. Throws a coded
|
|
87
|
+
* refusal; the first leg's allocation records nothing unless everything succeeded (every path check runs before the mint; a
|
|
88
|
+
* tree minted for a refused allocation is removed while still clean only when its allocation mark is proved absent, else kept
|
|
89
|
+
* and named; the record is written only once everything succeeded — immediately, not at settle).
|
|
90
90
|
*/
|
|
91
91
|
export declare function openSessionCheckout(input: OpenSessionCheckoutInput): Promise<OpenedSessionCheckout>;
|
|
92
92
|
/**
|
|
@@ -120,7 +120,9 @@ export interface OrphanSessionTree {
|
|
|
120
120
|
readonly allocationId: string;
|
|
121
121
|
/** The commit it was minted at (its mark). */
|
|
122
122
|
readonly baseSha: string;
|
|
123
|
-
/** `unrecorded`: the host's lookup says that session does not exist, or
|
|
123
|
+
/** `unrecorded`: the host's lookup says that session does not exist, or the id now names another occupant than the one the tree
|
|
124
|
+
* was minted for (the session deleted and registered again, a log imported into a new row), or its log holds no checkout record ·
|
|
125
|
+
* `record_unreadable`:
|
|
124
126
|
* the lookup threw, the session's record cannot be read, or its log is loaded from a bounded window that may hold the record
|
|
125
127
|
* below its floor · `record_elsewhere`: the session's record holds another allocation (a first leg refused while another leg
|
|
126
128
|
* recorded kept the tree it minted). */
|
|
@@ -134,9 +136,11 @@ export interface OrphanSessionTree {
|
|
|
134
136
|
* The host's lookup of a session by id, handed to the orphan doors.
|
|
135
137
|
*
|
|
136
138
|
* @contract session_checkout.session_of.absence_is_authority — `undefined` asserts that the host's DURABLE session store holds no
|
|
137
|
-
* session with that id (a cache miss is not absence), and the lookup throws whenever it cannot tell.
|
|
138
|
-
*
|
|
139
|
-
*
|
|
139
|
+
* session with that id (a cache miss is not absence), and the lookup throws whenever it cannot tell. A session it answers is the
|
|
140
|
+
* id's CURRENT occupant: its row as the durable store holds it now, never a cached view of a row deleted since. The doors read
|
|
141
|
+
* `undefined` as "no leg of that session will take the tree back", a session of another occupant than the tree's mark names the
|
|
142
|
+
* same way (an earlier occupant's tree is an orphan, whatever the id names now), and a throw as `record_unreadable`, which neither
|
|
143
|
+
* door removes.
|
|
140
144
|
*/
|
|
141
145
|
export type OrphanSessionLookup = (sessionId: string) => Promise<Session | undefined>;
|
|
142
146
|
/**
|
|
@@ -164,5 +168,6 @@ export declare function listOrphanSessionTrees(env: ExecutionEnv, root: string,
|
|
|
164
168
|
export declare function releaseOrphanSessionTree(env: ExecutionEnv, path: string, opts: {
|
|
165
169
|
readonly sessionOf: OrphanSessionLookup;
|
|
166
170
|
}): Promise<ReleasedTree>;
|
|
167
|
-
/** The frame's
|
|
168
|
-
|
|
171
|
+
/** The frame's checkout members, present together (none when the session has no checkout): `session`, the record's cells as the
|
|
172
|
+
* leg reports them, and `declaration`, the record's normalized declaration — what every later leg sends. */
|
|
173
|
+
export declare function sessionFrameOf(record: SessionCheckoutRecord | undefined): Pick<WorkspaceSnapshot, "session" | "declaration">;
|
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { types } from "node:util";
|
|
2
3
|
import { appendSessionCheckout, readSessionCheckout } from "../engine/session/session.js";
|
|
4
|
+
import { sameOccupant } from "../engine/session/repo-utils.js";
|
|
3
5
|
import { isSensitiveRecordKey } from "@sema-agent/primitives";
|
|
4
|
-
import { managedAnchorOf, managedWorktreeBaseOf, managedWorktreeBranchOf, managedWorktreeDir, mintManagedWorktree, removeManagedWorktree, repositoryRootOf, resolveBaseCommit, shq, symlinkedLevel, WORKTREE_PARENT, worktreeNameProblem, } from "./git-worktree-env.js";
|
|
6
|
+
import { branchLeftOf, managedAnchorOf, managedWorktreeBaseOf, managedWorktreeBranchOf, managedWorktreeDir, mintManagedWorktree, removeManagedWorktree, removeTreeIfClean, repositoryRootOf, resolveBaseCommit, shq, symlinkedLevel, WORKTREE_PARENT, worktreeNameProblem, } from "./git-worktree-env.js";
|
|
7
|
+
import { describeFault, receive } from "./mods/kernel/receive.js";
|
|
5
8
|
import { strayMembersOf } from "./own-property-receipt.js";
|
|
6
9
|
import { thrownText } from "./thrown-value.js";
|
|
7
10
|
export const WORKTREE_INCAPABLE_REASONS = Object.freeze([
|
|
11
|
+
"name_invalid",
|
|
8
12
|
"git_unavailable",
|
|
9
13
|
"not_a_repository",
|
|
10
14
|
"bare_repository",
|
|
@@ -19,6 +23,23 @@ const FULL_SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
|
|
|
19
23
|
const SOURCE_MAX = 64;
|
|
20
24
|
const DECLARATION_MEMBERS = Object.freeze(["isolation", "baseRef", "name", "sources"]);
|
|
21
25
|
const SOURCE_MEMBERS = Object.freeze(["root", "remote", "sha", "ref"]);
|
|
26
|
+
const DECLARATION_DATA = Object.freeze({ accessors: "refuse", depth: 4, others: "refuse", isProxy: (v) => types.isProxy(v) });
|
|
27
|
+
const UNRESERVED_CHARACTER = /^[A-Za-z0-9\-._~]$/;
|
|
28
|
+
function canonicalEscapes(path) {
|
|
29
|
+
return path.replace(/%([0-9A-Fa-f]{2})/g, (escape, hex) => {
|
|
30
|
+
const character = String.fromCharCode(parseInt(hex, 16));
|
|
31
|
+
return UNRESERVED_CHARACTER.test(character) ? character : escape.toUpperCase();
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
function repositoryPathOf(host, path) {
|
|
35
|
+
for (;;) {
|
|
36
|
+
const bare = canonicalEscapes(path).replace(/\/{2,}/g, "/").replace(/\/+$/, "").replace(/\.git$/, "");
|
|
37
|
+
const next = bare === "" ? "" : new URL(`https://${host}${bare}`).pathname;
|
|
38
|
+
if (next === path)
|
|
39
|
+
return path;
|
|
40
|
+
path = next;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
22
43
|
function normalizeRemote(remote, at) {
|
|
23
44
|
if (typeof remote !== "string" || remote.length === 0 || remote.length > 2048)
|
|
24
45
|
throw invalid(`${at}.remote must be an https repository URL`);
|
|
@@ -40,10 +61,11 @@ function normalizeRemote(remote, at) {
|
|
|
40
61
|
throw invalid(`${at}.remote carries a credential parameter (${url.origin}); credentials never ride the declaration`);
|
|
41
62
|
}
|
|
42
63
|
}
|
|
43
|
-
const
|
|
64
|
+
const host = url.host.toLowerCase();
|
|
65
|
+
const path = repositoryPathOf(host, url.pathname);
|
|
44
66
|
if (path === "" || path === "/")
|
|
45
67
|
throw invalid(`${at}.remote names no repository (${url.origin})`);
|
|
46
|
-
return `https://${
|
|
68
|
+
return `https://${host}${path}`;
|
|
47
69
|
}
|
|
48
70
|
function screenRoot(root, at) {
|
|
49
71
|
if (root === "taskRoot")
|
|
@@ -62,7 +84,10 @@ export function screenWorkspaceDeclaration(value) {
|
|
|
62
84
|
return undefined;
|
|
63
85
|
if (value === null || typeof value !== "object" || Array.isArray(value))
|
|
64
86
|
throw invalid("must be an object");
|
|
65
|
-
const
|
|
87
|
+
const data = receive(value, DECLARATION_DATA);
|
|
88
|
+
if (!data.ok)
|
|
89
|
+
throw invalid(`must be plain data — ${describeFault(data.fault)}`);
|
|
90
|
+
const v = data.value;
|
|
66
91
|
const stray = strayMembersOf(v, { subject: "TaskSpec.workspace", unit: "member", moment: "when the leg starts" }, DECLARATION_MEMBERS);
|
|
67
92
|
if (stray !== undefined)
|
|
68
93
|
throw refusal("config.session_workspace_invalid", stray.sentence);
|
|
@@ -116,7 +141,13 @@ export function screenWorkspaceDeclaration(value) {
|
|
|
116
141
|
...(sources !== undefined ? { sources } : {}),
|
|
117
142
|
};
|
|
118
143
|
}
|
|
119
|
-
const declaredDigest = (d) => JSON.stringify(
|
|
144
|
+
const declaredDigest = (d) => JSON.stringify([d.isolation ?? null, d.baseRef ?? null, d.name ?? null, (d.sources ?? []).map((s) => [rootKey(s.root), s.remote, s.sha, s.ref ?? null])]);
|
|
145
|
+
function legWorkspaceOf(raw) {
|
|
146
|
+
if (raw === null)
|
|
147
|
+
return { kind: "none" };
|
|
148
|
+
const declared = screenWorkspaceDeclaration(raw);
|
|
149
|
+
return declared === undefined ? { kind: "inherit" } : { kind: "declared", declared };
|
|
150
|
+
}
|
|
120
151
|
async function run(env, command, cwd) {
|
|
121
152
|
try {
|
|
122
153
|
const r = await env.exec(command, { cwd });
|
|
@@ -132,6 +163,11 @@ function sessionTreeName(sessionId) {
|
|
|
132
163
|
}
|
|
133
164
|
export async function probeWorktreeCapability(env, cwd, opts) {
|
|
134
165
|
const no = (reason, detail, gitRoot) => ({ worktreeCapable: false, reason, detail, ...(gitRoot !== undefined ? { gitRoot } : {}) });
|
|
166
|
+
if (opts?.name !== undefined) {
|
|
167
|
+
const problem = worktreeNameProblem(opts.name);
|
|
168
|
+
if (problem !== undefined)
|
|
169
|
+
return no("name_invalid", problem);
|
|
170
|
+
}
|
|
135
171
|
const version = await run(env, "git --version", cwd);
|
|
136
172
|
if (version === undefined || version.exitCode !== 0)
|
|
137
173
|
return no("git_unavailable", "git cannot be run in this environment");
|
|
@@ -194,15 +230,25 @@ async function readBirthMark(env, dir) {
|
|
|
194
230
|
return text.error.code === "not_found" ? { kind: "absent" } : unreadable(`its allocation mark cannot be read (${thrownText(text.error).slice(0, 200)})`);
|
|
195
231
|
try {
|
|
196
232
|
const v = JSON.parse(text.value);
|
|
197
|
-
|
|
198
|
-
|
|
233
|
+
const occupant = v.incarnation === undefined || (typeof v.incarnation === "string" && v.incarnation !== "");
|
|
234
|
+
if (occupant && typeof v.allocationId === "string" && typeof v.sessionId === "string" && typeof v.baseSha === "string" && FULL_SHA.test(v.baseSha) && typeof v.declared === "string") {
|
|
235
|
+
const incarnation = typeof v.incarnation === "string" ? { incarnation: v.incarnation } : {};
|
|
236
|
+
return { kind: "marked", mark: { allocationId: v.allocationId, sessionId: v.sessionId, ...incarnation, baseSha: v.baseSha, declared: v.declared } };
|
|
199
237
|
}
|
|
200
238
|
}
|
|
201
239
|
catch {
|
|
202
240
|
}
|
|
203
241
|
return unreadable("its allocation mark is not a valid record");
|
|
204
242
|
}
|
|
205
|
-
const recordHoldsMark = (holder, mark) => holder.allocationId === mark.allocationId;
|
|
243
|
+
const recordHoldsMark = (holder, mark) => holder.allocationId === mark.allocationId && sameOccupant(mark.incarnation, holder.occupant);
|
|
244
|
+
async function sessionRowOf(session, unread) {
|
|
245
|
+
try {
|
|
246
|
+
return await session.getMetadata();
|
|
247
|
+
}
|
|
248
|
+
catch (err) {
|
|
249
|
+
throw refusal("workspace.checkout_unavailable", `This session's row cannot be read (${thrownText(err).slice(0, 300)}), so whose session tree is whose cannot be told; ${unread}`);
|
|
250
|
+
}
|
|
251
|
+
}
|
|
206
252
|
const overlaps = (path, top) => path === top || path.startsWith(`${top}/`) || top.startsWith(`${path === "/" ? "" : path}/`);
|
|
207
253
|
async function refuseOverlap(env, base, additional) {
|
|
208
254
|
const top = await canonicalOf(env, base);
|
|
@@ -229,33 +275,53 @@ async function placeInTree(env, root, dir) {
|
|
|
229
275
|
}
|
|
230
276
|
export async function openSessionCheckout(input) {
|
|
231
277
|
const { session, sessionId } = input;
|
|
232
|
-
const
|
|
233
|
-
const observedLeaf =
|
|
278
|
+
const leg = legWorkspaceOf(input.declaration);
|
|
279
|
+
const observedLeaf = leg.kind === "declared" ? await session.getStorage().getLeafId() : null;
|
|
234
280
|
const read = await readSessionCheckout(session, sessionId);
|
|
235
281
|
if (read.kind === "unreadable") {
|
|
236
282
|
throw refusal("workspace.checkout_unavailable", `This session's checkout record cannot be read (${read.detail}); the leg was not started rather than run outside the session's checkout.`);
|
|
237
283
|
}
|
|
238
284
|
if (read.kind === "record")
|
|
239
|
-
return reopen(input,
|
|
240
|
-
if (
|
|
285
|
+
return reopen(input, leg, read.record);
|
|
286
|
+
if (leg.kind !== "declared")
|
|
241
287
|
return { taskRoot: input.baseRoot };
|
|
288
|
+
const declared = leg.declared;
|
|
242
289
|
const forked = (await session.getMetadata()).forkedFrom !== undefined;
|
|
243
290
|
if (!forked && (await session.getStorage().findEntries("message")).length > 0) {
|
|
244
291
|
throw refusal("config.session_workspace_changed", "TaskSpec.workspace is declared on a session that already ran without it; a session's workspace is fixed by its first leg. Start a new session to work in a declared workspace.");
|
|
245
292
|
}
|
|
246
293
|
return allocate(input, declared, observedLeaf);
|
|
247
294
|
}
|
|
248
|
-
async function
|
|
295
|
+
async function treeHoldingCwd(env, cwd, record) {
|
|
296
|
+
const where = await canonicalOf(env, cwd);
|
|
297
|
+
for (const cell of record.checkouts) {
|
|
298
|
+
if (cell.dir === undefined)
|
|
299
|
+
continue;
|
|
300
|
+
const tree = await canonicalOf(env, cell.dir);
|
|
301
|
+
if (where === tree || where.startsWith(`${tree}/`))
|
|
302
|
+
return cell.dir;
|
|
303
|
+
}
|
|
304
|
+
return undefined;
|
|
305
|
+
}
|
|
306
|
+
async function reopen(input, leg, record) {
|
|
249
307
|
const env = input.env;
|
|
250
308
|
if (record.released === true) {
|
|
251
309
|
throw refusal("config.session_workspace_changed", "This session's checkout was released; a released session runs no further leg. Start a new session.");
|
|
252
310
|
}
|
|
253
|
-
if (
|
|
254
|
-
|
|
311
|
+
if (leg.kind === "none") {
|
|
312
|
+
const standing = input.restoredCwd === undefined ? undefined : await treeHoldingCwd(env, input.restoredCwd, record);
|
|
313
|
+
if (standing !== undefined) {
|
|
314
|
+
throw refusal("config.session_workspace_changed", `TaskSpec.workspace is null on a resumed leg whose pending action stands in the session's tree ${standing} (the checkpoint's working directory); it would run there while the leg reports no checkout. Resume it with the session's workspace (omit it, or send the declaration); send null on a leg that starts fresh.`);
|
|
315
|
+
}
|
|
316
|
+
return { taskRoot: input.baseRoot };
|
|
317
|
+
}
|
|
318
|
+
if (leg.kind === "declared" && declaredDigest(leg.declared) !== declaredDigest(record.declared)) {
|
|
319
|
+
throw refusal("config.session_workspace_changed", `TaskSpec.workspace differs from the declaration this session's checkout was opened under (allocation ${record.allocationId}); a session's workspace is fixed by its first leg. Omit it (the leg takes the session's), send the same declaration, send null for a leg that wants no tree, or start a new session.`);
|
|
255
320
|
}
|
|
256
321
|
for (const cell of record.checkouts)
|
|
257
322
|
if (cell.dir !== undefined)
|
|
258
323
|
await refuseOverlap(env, cell.repository, input.additionalDirectories ?? []);
|
|
324
|
+
const holder = record.checkouts.some((cell) => cell.dir !== undefined) ? { allocationId: record.allocationId, occupant: (await sessionRowOf(input.session, "the leg was not started.")).incarnation } : undefined;
|
|
259
325
|
let taskRoot = input.baseRoot;
|
|
260
326
|
for (const cell of record.checkouts) {
|
|
261
327
|
if (cell.dir === undefined)
|
|
@@ -270,8 +336,8 @@ async function reopen(input, declared, record) {
|
|
|
270
336
|
if (info.value.kind !== "directory")
|
|
271
337
|
throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer a directory; the leg was not started.`);
|
|
272
338
|
const birth = await readBirthMark(env, cell.dir);
|
|
273
|
-
if (birth.kind !== "marked" || !recordHoldsMark(
|
|
274
|
-
throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer the tree this session minted (its allocation mark is missing or names another allocation); the leg was not started. Release the session's checkout and start a new session.`);
|
|
339
|
+
if (birth.kind !== "marked" || holder === undefined || !recordHoldsMark(holder, birth.mark)) {
|
|
340
|
+
throw refusal("workspace.checkout_missing", `This session's tree ${cell.dir} is no longer the tree this session minted (its allocation mark is missing, or names another allocation or another occupant of this session id); the leg was not started. Release the session's checkout and start a new session.`);
|
|
275
341
|
}
|
|
276
342
|
if (cell.root === "taskRoot") {
|
|
277
343
|
const placed = await placeInTree(env, input.baseRoot, cell.dir);
|
|
@@ -322,6 +388,7 @@ async function allocate(input, declared, observedLeaf) {
|
|
|
322
388
|
let taskRoot = baseRoot;
|
|
323
389
|
if (declared.isolation === "worktree") {
|
|
324
390
|
const name = declared.name ?? sessionTreeName(sessionId);
|
|
391
|
+
const occupant = (await sessionRowOf(input.session, "the leg was not started.")).incarnation;
|
|
325
392
|
const probe = await probeWorktreeCapability(env, baseRoot);
|
|
326
393
|
if (!probe.worktreeCapable || probe.gitRoot === undefined) {
|
|
327
394
|
throw refusal("workspace.isolation_unavailable", `The session's tree cannot be made for ${baseRoot}: ${probe.detail ?? "the checkout cannot hold a managed tree"} (${probe.reason ?? "unknown"}). The leg was not started in the base checkout instead.`);
|
|
@@ -336,7 +403,7 @@ async function allocate(input, declared, observedLeaf) {
|
|
|
336
403
|
if (existing.ok || existing.error.code !== "not_found") {
|
|
337
404
|
const read = await readBirthMark(env, dir);
|
|
338
405
|
const birth = read.kind === "marked" ? read.mark : undefined;
|
|
339
|
-
if (birth === undefined || birth.sessionId !== sessionId) {
|
|
406
|
+
if (birth === undefined || birth.sessionId !== sessionId || !sameOccupant(birth.incarnation, occupant)) {
|
|
340
407
|
throw refusal("workspace.isolation_unavailable", `The session's tree cannot be made: a tree named "${name}" already exists at ${dir} and was not minted by this session (name_in_use). Declare another name — or, when no session's record holds that tree, release it with releaseOrphanSessionTree (listOrphanSessionTrees lists such trees).`);
|
|
341
408
|
}
|
|
342
409
|
if (birth.declared !== declaredDigest(declared)) {
|
|
@@ -378,7 +445,7 @@ async function allocate(input, declared, observedLeaf) {
|
|
|
378
445
|
return undo(`The session's tree is not at the declared commit${taskRootSource !== undefined ? ` ${taskRootSource.sha}` : ""}; the leg was not started.`, taskRootSource !== undefined ? "workspace.source_mismatch" : "workspace.isolation_unavailable");
|
|
379
446
|
}
|
|
380
447
|
const birthAt = await birthRecordPath(env, minted.worktreeDir);
|
|
381
|
-
const wrote = birthAt === undefined ? undefined : await env.writeFile(birthAt, JSON.stringify({ allocationId, sessionId, baseSha: minted.baseSha, declared: declaredDigest(declared) }));
|
|
448
|
+
const wrote = birthAt === undefined ? undefined : await env.writeFile(birthAt, JSON.stringify({ allocationId, sessionId, ...(typeof occupant === "string" && occupant !== "" ? { incarnation: occupant } : {}), baseSha: minted.baseSha, declared: declaredDigest(declared) }));
|
|
382
449
|
if (wrote === undefined || !wrote.ok)
|
|
383
450
|
return undo("The session's tree could not be marked as this session's; the leg was not started.", "workspace.isolation_unavailable");
|
|
384
451
|
tree = { dir: minted.worktreeDir, branch: minted.branch, baseSha: minted.baseSha, baseRef: taskRootSource !== undefined ? "source" : declared.baseRef ?? "fresh", allocationId };
|
|
@@ -418,8 +485,8 @@ export async function releaseSessionCheckout(env, session, opts) {
|
|
|
418
485
|
if (onExit !== "keep-if-dirty" && onExit !== "keep") {
|
|
419
486
|
throw refusal("config.invalid_argument", `releaseSessionCheckout: onExit must be "keep-if-dirty" or "keep" (a removal that discards changes is not offered)`);
|
|
420
487
|
}
|
|
421
|
-
const
|
|
422
|
-
const read = await readSessionCheckout(session,
|
|
488
|
+
const row = await sessionRowOf(session, "nothing was removed.");
|
|
489
|
+
const read = await readSessionCheckout(session, row.id);
|
|
423
490
|
if (read.kind === "unreadable")
|
|
424
491
|
throw refusal("workspace.checkout_unavailable", `This session's checkout record cannot be read (${read.detail}); nothing was removed.`);
|
|
425
492
|
if (read.kind === "none")
|
|
@@ -429,28 +496,18 @@ export async function releaseSessionCheckout(env, session, opts) {
|
|
|
429
496
|
for (const cell of record.checkouts) {
|
|
430
497
|
if (cell.dir === undefined || cell.branch === undefined)
|
|
431
498
|
continue;
|
|
432
|
-
trees.push(await releaseTree(env, { path: cell.dir, repository: cell.repository, branch: cell.branch, baseSha: cell.baseSha }, record, onExit));
|
|
499
|
+
trees.push(await releaseTree(env, { path: cell.dir, repository: cell.repository, branch: cell.branch, baseSha: cell.baseSha }, { allocationId: record.allocationId, occupant: row.incarnation }, onExit));
|
|
433
500
|
}
|
|
434
501
|
if (record.released !== true)
|
|
435
502
|
await appendSessionCheckout(session, { ...record, released: true });
|
|
436
503
|
return { trees };
|
|
437
504
|
}
|
|
438
|
-
const IGNORED_NAMED = 5;
|
|
439
|
-
function ignoredDetail(paths) {
|
|
440
|
-
const named = paths.slice(0, IGNORED_NAMED).map((p) => p.slice(0, 120)).join(", ");
|
|
441
|
-
const more = paths.length > IGNORED_NAMED ? ` and ${paths.length - IGNORED_NAMED} more` : "";
|
|
442
|
-
return `the tree holds files git ignores (${named}${more}), which removing it would delete — delete or move them, then release again`;
|
|
443
|
-
}
|
|
444
|
-
async function branchLeftOf(env, tree) {
|
|
445
|
-
const ref = await run(env, `git rev-parse --verify --quiet ${shq(`refs/heads/${tree.branch}`)}`, tree.repository);
|
|
446
|
-
return ref !== undefined && ref.exitCode === 0 ? { branch: tree.branch } : {};
|
|
447
|
-
}
|
|
448
505
|
async function goneTree(env, tree) {
|
|
449
506
|
await run(env, "git worktree prune", tree.repository);
|
|
450
|
-
return { path: tree.path, removed: true, ...(await branchLeftOf(env, tree)) };
|
|
507
|
+
return { path: tree.path, removed: true, ...(await branchLeftOf(env, tree.repository, tree.branch)) };
|
|
451
508
|
}
|
|
452
509
|
async function releaseTree(env, tree, holder, onExit) {
|
|
453
|
-
const { path, repository, branch
|
|
510
|
+
const { path, repository, branch } = tree;
|
|
454
511
|
const at = await env.fileInfo(path);
|
|
455
512
|
if (!at.ok) {
|
|
456
513
|
if (at.error.code !== "not_found")
|
|
@@ -461,30 +518,12 @@ async function releaseTree(env, tree, holder, onExit) {
|
|
|
461
518
|
const mark = await readBirthMark(env, path);
|
|
462
519
|
return mark.kind === "marked" && recordHoldsMark(holder, mark.mark);
|
|
463
520
|
};
|
|
521
|
+
const notOwned = async () => ({ path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, repository, branch)) });
|
|
464
522
|
if (!(await held()))
|
|
465
|
-
return
|
|
523
|
+
return notOwned();
|
|
466
524
|
if (onExit === "keep")
|
|
467
525
|
return { path, removed: false, kept: "requested", branch };
|
|
468
|
-
|
|
469
|
-
if (status === undefined || status.exitCode !== 0)
|
|
470
|
-
return { path, removed: false, kept: "unverifiable", branch };
|
|
471
|
-
const entries = status.stdout.split("\n").filter((line) => line !== "");
|
|
472
|
-
if (entries.some((line) => !line.startsWith("!! ")))
|
|
473
|
-
return { path, removed: false, kept: "dirty", branch };
|
|
474
|
-
if (entries.length > 0)
|
|
475
|
-
return { path, removed: false, kept: "ignored", branch, detail: ignoredDetail(entries.map((line) => line.slice(3))) };
|
|
476
|
-
const ahead = await run(env, `git rev-list --count ${shq(`${baseSha}..HEAD`)}`, path);
|
|
477
|
-
const commits = ahead !== undefined && ahead.exitCode === 0 ? Number.parseInt(ahead.stdout.trim(), 10) : Number.NaN;
|
|
478
|
-
if (!Number.isFinite(commits))
|
|
479
|
-
return { path, removed: false, kept: "unverifiable", branch };
|
|
480
|
-
if (commits > 0)
|
|
481
|
-
return { path, removed: false, kept: "commits", branch };
|
|
482
|
-
if (!(await held()))
|
|
483
|
-
return { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, tree)) };
|
|
484
|
-
const removed = await removeManagedWorktree(env, repository, path, { name: branch, baseSha }, undefined, "clean");
|
|
485
|
-
if (!removed.ok)
|
|
486
|
-
return { path, removed: false, kept: "unverifiable", branch, detail: removed.detail.trim().slice(0, 300) };
|
|
487
|
-
return { path, removed: true, ...(await branchLeftOf(env, tree)) };
|
|
526
|
+
return removeTreeIfClean(env, tree, undefined, async () => ((await held()) ? undefined : notOwned()));
|
|
488
527
|
}
|
|
489
528
|
async function standingOf(env, dir, sessionOf) {
|
|
490
529
|
const read = await readBirthMark(env, dir);
|
|
@@ -493,10 +532,14 @@ async function standingOf(env, dir, sessionOf) {
|
|
|
493
532
|
const mark = read.mark;
|
|
494
533
|
const orphan = (why, detail) => ({ kind: "orphan", mark, why, ...(detail !== undefined ? { detail: detail.slice(0, 300) } : {}) });
|
|
495
534
|
let checkout;
|
|
535
|
+
let occupant;
|
|
496
536
|
try {
|
|
497
537
|
const session = await sessionOf(mark.sessionId);
|
|
498
538
|
if (session === undefined)
|
|
499
539
|
return orphan("unrecorded");
|
|
540
|
+
occupant = (await session.getMetadata()).incarnation;
|
|
541
|
+
if (!sameOccupant(mark.incarnation, occupant))
|
|
542
|
+
return orphan("unrecorded", `the session id ${mark.sessionId} now names another occupant than the one the tree was minted for`);
|
|
500
543
|
checkout = await readSessionCheckout(session, mark.sessionId);
|
|
501
544
|
}
|
|
502
545
|
catch (err) {
|
|
@@ -507,7 +550,7 @@ async function standingOf(env, dir, sessionOf) {
|
|
|
507
550
|
if (checkout.kind === "none") {
|
|
508
551
|
return checkout.window === undefined ? orphan("unrecorded") : orphan("record_unreadable", `the session's log is loaded from a bounded window (floor ${checkout.window.floor}); a checkout record below the floor cannot be ruled out`);
|
|
509
552
|
}
|
|
510
|
-
return recordHoldsMark(checkout.record, mark) ? { kind: "held", mark } : orphan("record_elsewhere", `the session's record holds allocation ${checkout.record.allocationId}`);
|
|
553
|
+
return recordHoldsMark({ allocationId: checkout.record.allocationId, occupant }, mark) ? { kind: "held", mark } : orphan("record_elsewhere", `the session's record holds allocation ${checkout.record.allocationId}`);
|
|
511
554
|
}
|
|
512
555
|
function lookupOf(door, opts) {
|
|
513
556
|
const sessionOf = opts !== null && typeof opts === "object" ? opts.sessionOf : undefined;
|
|
@@ -539,7 +582,7 @@ export async function listOrphanSessionTrees(env, root, opts) {
|
|
|
539
582
|
const branch = managedWorktreeBranchOf(path);
|
|
540
583
|
trees.push({
|
|
541
584
|
path,
|
|
542
|
-
...(branch !== undefined ? await branchLeftOf(env,
|
|
585
|
+
...(branch !== undefined ? await branchLeftOf(env, repository, branch) : {}),
|
|
543
586
|
sessionId: mark.sessionId,
|
|
544
587
|
allocationId: mark.allocationId,
|
|
545
588
|
baseSha: mark.baseSha,
|
|
@@ -563,17 +606,22 @@ export async function releaseOrphanSessionTree(env, path, opts) {
|
|
|
563
606
|
const standing = await standingOf(env, path, sessionOf);
|
|
564
607
|
if (standing.kind === "unmarked") {
|
|
565
608
|
return standing.read.kind === "absent"
|
|
566
|
-
? { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env,
|
|
609
|
+
? { path, removed: false, kept: "not_owned", ...(await branchLeftOf(env, repository, branch)), detail: "it carries no allocation mark: it is no session tree" }
|
|
567
610
|
: { path, removed: false, kept: "unverifiable", branch, detail: standing.read.detail };
|
|
568
611
|
}
|
|
569
612
|
if (standing.kind === "held")
|
|
570
613
|
return { path, removed: false, kept: "not_owned", branch, detail: "a session's record holds this tree; releaseSessionCheckout releases it" };
|
|
571
614
|
if (standing.why === "record_unreadable")
|
|
572
615
|
return { path, removed: false, kept: "unverifiable", branch, ...(standing.detail !== undefined ? { detail: standing.detail } : {}) };
|
|
573
|
-
return releaseTree(env, { path, repository, branch, baseSha: standing.mark.baseSha }, standing.mark, "keep-if-dirty");
|
|
616
|
+
return releaseTree(env, { path, repository, branch, baseSha: standing.mark.baseSha }, { allocationId: standing.mark.allocationId, occupant: standing.mark.incarnation }, "keep-if-dirty");
|
|
574
617
|
}
|
|
618
|
+
const rootCopy = (root) => (root === "taskRoot" ? "taskRoot" : { directory: root.directory });
|
|
575
619
|
export function sessionFrameOf(record) {
|
|
576
620
|
if (record === undefined || record.checkouts.length === 0)
|
|
577
|
-
return
|
|
578
|
-
|
|
621
|
+
return {};
|
|
622
|
+
const d = record.declared;
|
|
623
|
+
return {
|
|
624
|
+
session: record.checkouts.map((cell) => ({ ...cell, root: rootCopy(cell.root), ...(cell.source !== undefined ? { source: { ...cell.source } } : {}) })),
|
|
625
|
+
declaration: { ...d, ...(d.sources !== undefined ? { sources: d.sources.map((source) => ({ ...source, root: rootCopy(source.root) })) } : {}) },
|
|
626
|
+
};
|
|
579
627
|
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { SessionError, StreamingImportValidator, importRowCells, ownerCell, sessionLogMarkOf, uuidv7 } from "../internal/harness.js";
|
|
2
2
|
import { optionKeys, receiptRefusal, receiveMembers } from "./own-property-receipt.js";
|
|
3
|
+
import { callerText } from "./caller-text.js";
|
|
3
4
|
import { thrownText } from "./thrown-value.js";
|
|
4
5
|
const EXPORT_WORDS = { subject: "SessionLogExportOptions", unit: "member", moment: "at SessionLogTransfer.exportStream" };
|
|
5
6
|
const BEGIN_WORDS = { subject: "SessionLogTransfer.beginReplace options", unit: "member", moment: "at SessionLogTransfer.beginReplace" };
|
|
@@ -21,7 +22,7 @@ function committedHead(sessionId, answer) {
|
|
|
21
22
|
function readRecord(raw, words, keys) {
|
|
22
23
|
if (typeof raw !== "object" || raw === null)
|
|
23
24
|
throw receiptRefusal(`${words.subject} must be an object, got ${raw === null ? "null" : typeof raw}`);
|
|
24
|
-
return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries
|
|
25
|
+
return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries ${callerText(stray)} — not a member this face reads (its members are ${keys.map((k) => JSON.stringify(k)).join(", ")})`));
|
|
25
26
|
}
|
|
26
27
|
function isIntegerFrom(value, floor) {
|
|
27
28
|
return typeof value === "number" && Number.isSafeInteger(value) && value >= floor;
|
|
@@ -24,6 +24,10 @@
|
|
|
24
24
|
* every station reads a row's entries in the grammar the row carries ({@link readSessionRulesShape}) — an entry keeps the meaning
|
|
25
25
|
* its writer's grammar gave it, one that grammar could not read takes this engine's, and a row whose entries the two grammars
|
|
26
26
|
* read differently is announced ({@link earlierGrammarReads}).
|
|
27
|
+
* - **a writer declares its grammar**: a write body carries the `grammar` its entries are written in, and the engine never
|
|
28
|
+
* supplies one — a body without it is refused `grammar_required` before anything is read ({@link judgeSessionRulesWrite}), a
|
|
29
|
+
* stored row handed back included (an unstamped one was stored in grammar 0, and its writer says so). An entry the writer's
|
|
30
|
+
* grammar reads as no rule is then refused as such, rather than reborn as a rule by a reading the writer never made.
|
|
27
31
|
* - **rules are read as rules or not at all**: rules whose shape cannot be read, or whose toolDeny holds an entry no grammar
|
|
28
32
|
* reads ({@link unreadableDenyEntries}), refuse every call until an operator writes them afresh — never read as fewer.
|
|
29
33
|
* - **NOT A SANDBOX**: a shell command rule reads the command line the call carries (every program run in its connector
|
|
@@ -159,12 +163,14 @@ export interface SessionRuleEntryRefusal extends AllowEntryInertDetail {
|
|
|
159
163
|
* = a non-operator write tried to relax what an operator wrote; `corrupt` = a backend could not read what it stored (a row, or the
|
|
160
164
|
* erase-surviving rev mark of {@link SessionPolicyStore.deleteBySession}) and refuses rather than read it as fewer rules or
|
|
161
165
|
* stamp an unproven rev; `invalid_shape` = the rules value is not an object of buckets, each a list of strings
|
|
162
|
-
* ({@link readSessionRulesShape}); `inert_entry` = a bucket holds an entry the entry reader reads as nothing
|
|
163
|
-
*
|
|
166
|
+
* ({@link readSessionRulesShape}); `inert_entry` = a bucket holds an entry the entry reader reads as nothing;
|
|
167
|
+
* `grammar_required` = the write body declares no rule grammar (a write names the grammar its entries are written in — the
|
|
168
|
+
* engine never supplies one; no `detail`). `detail` is present on `invalid_shape` and `inert_entry` and only on them
|
|
169
|
+
* ({@link SessionRuleShapeRefusal}, {@link SessionRuleEntryRefusal}). */
|
|
164
170
|
export declare class SessionPolicyError extends Error {
|
|
165
|
-
readonly code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry";
|
|
171
|
+
readonly code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry" | "grammar_required";
|
|
166
172
|
readonly detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined;
|
|
167
|
-
constructor(code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry", message: string, detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined);
|
|
173
|
+
constructor(code: "conflict" | "loosen_forbidden" | "corrupt" | "invalid_shape" | "inert_entry" | "grammar_required", message: string, detail?: (SessionRuleShapeRefusal | SessionRuleEntryRefusal) | undefined);
|
|
168
174
|
}
|
|
169
175
|
/** Construction options both bundled stores take. */
|
|
170
176
|
export interface SessionPolicyStoreOptions {
|
|
@@ -193,14 +199,17 @@ export interface SessionRulesRecord {
|
|
|
193
199
|
export interface SessionPolicyStore {
|
|
194
200
|
getRules(sessionId: string, principal?: string): Promise<StoredSessionRules | null>;
|
|
195
201
|
/** Write the rules for a key through the one write judge ({@link judgeSessionRulesWrite}): CAS on `expectedRev`, the
|
|
202
|
+
* declared grammar (`rules.grammar` — the rule grammar the writer wrote the entries in; absent is `grammar_required`), the
|
|
196
203
|
* shape, every entry's reading (operator writes included), then, for a non-operator write, the check against the row's
|
|
197
204
|
* operator part — each refusal a {@link SessionPolicyError}, and nothing is written. The same call is the delete port: a
|
|
198
205
|
* value without an entry takes it out of every gate that reads the row. */
|
|
199
|
-
putRules(sessionId: string, principal: string | undefined, rules:
|
|
206
|
+
putRules(sessionId: string, principal: string | undefined, rules: SessionRulesInGrammar, opts?: PutRulesOptions): Promise<StoredSessionRules>;
|
|
200
207
|
/**
|
|
201
208
|
* 2c session-sync: every (principal, rules) record for `sessionId` across ALL principals — `getRules`
|
|
202
209
|
* is per-(sessionId, principal), but a cross-backend session EXPORT must bundle the WHOLE session's policy.
|
|
203
|
-
* The importer replays each via `putRules(sessionId, record.principal, record.rules)
|
|
210
|
+
* The importer replays each via `putRules(sessionId, record.principal, record.rules)` — the record's own `grammar` stamp
|
|
211
|
+
* rides along (a record stored before the stamp has none: the importer declares it grammar 0, the reading such a row was
|
|
212
|
+
* stored under, and a write of it is otherwise refused `grammar_required`). Optional — a backend
|
|
204
213
|
* that supports cross-backend policy export implements it (local backend uses the in-memory/file impl).
|
|
205
214
|
*/
|
|
206
215
|
listBySession?(sessionId: string): Promise<SessionRulesRecord[]>;
|
|
@@ -328,7 +337,8 @@ export type EarlierGrammarReader = "no_rule" | "named_no_tool" | "grammar_revise
|
|
|
328
337
|
* audience `user` — the session's rules are what the person's calls are judged by): the message is {@link earlierGrammarAdvisory}
|
|
329
338
|
* verbatim, and `detail` carries the same facts for a machine — `bucket` (the field), `storedGrammar` (the row's), `entries` (every
|
|
330
339
|
* entry, each as `noticeRuleText` hands rule text to a notice, with its reader's word), `rewrite` (the way out: an operator write of
|
|
331
|
-
* a new value without the stored row's rev, which stamps `stampsGrammar`
|
|
340
|
+
* a new value without the stored row's rev, which stamps `stampsGrammar` — the grammar its writer declares on it, a write
|
|
341
|
+
* that declares none being refused `grammar_required`), `rulesSessionId` (whose rules — an ancestor's on a
|
|
332
342
|
* delegated child's inherited layer) and `sessionId` (the run that read them).
|
|
333
343
|
*/
|
|
334
344
|
export declare function earlierGrammarNotice(input: {
|
|
@@ -350,12 +360,15 @@ export declare function earlierGrammarAnnouncer(sink: ((entries: readonly string
|
|
|
350
360
|
/**
|
|
351
361
|
* THE ONE WRITE JUDGE every store applies before it stamps a row (both bundled stores, and a durable backend at the same point):
|
|
352
362
|
* the rules to stamp, or a {@link SessionPolicyError}, in this order — `conflict` (a stale `expectedRev` against `prior`'s rev),
|
|
353
|
-
* `
|
|
354
|
-
* in
|
|
363
|
+
* `grammar_required` (the value declares no `grammar` — read before anything else of it: the writer names the grammar its
|
|
364
|
+
* entries are written in and the engine never supplies one, so a value without the stamp is no reading at all, a stored row
|
|
365
|
+
* handed back included), `invalid_shape` ({@link normalizeRules}), `inert_entry` (an entry that reads as nothing in the grammar
|
|
366
|
+
* the rules DECLARE they are written in; operator writes included — a rule that names nothing guards nothing whoever writes
|
|
367
|
+
* it), then, for a non-operator write
|
|
355
368
|
* over a row, `loosen_forbidden` ({@link loosenReasons}) against the row's OPERATOR PART ({@link StoredSessionRules.operatorRules};
|
|
356
369
|
* absent, the whole row) — or `corrupt` when that prior cannot be read as rules, which the comparison never reads as fewer.
|
|
357
370
|
* Over no row there is no rev to compare and no tighten gate, and a judge called with `prior = null` (a host's pre-read of a
|
|
358
|
-
* value's shape and entries) answers only those
|
|
371
|
+
* value's shape and entries) answers only those three content refusals. Below what an operator wrote nothing moves; above it,
|
|
359
372
|
* a non-operator takes back what non-operator writes added. The
|
|
360
373
|
* rules to stamp carry `grammar` = {@link SESSION_RULES_GRAMMAR} — what passed the judge means the same in this engine's
|
|
361
374
|
* grammar — and, from a non-operator write, the operator part it was judged against: over no row, the value's own when it is a
|
|
@@ -419,7 +432,7 @@ export declare class InMemorySessionPolicyStore implements SessionPolicyStore {
|
|
|
419
432
|
private readonly highWater;
|
|
420
433
|
private key;
|
|
421
434
|
getRules(sessionId: string, principal?: string): Promise<StoredSessionRules | null>;
|
|
422
|
-
putRules(sessionId: string, principal: string | undefined, rules:
|
|
435
|
+
putRules(sessionId: string, principal: string | undefined, rules: SessionRulesInGrammar, opts?: PutRulesOptions): Promise<StoredSessionRules>;
|
|
423
436
|
listBySession(sessionId: string): Promise<SessionRulesRecord[]>;
|
|
424
437
|
deleteBySession(sessionId: string): Promise<void>;
|
|
425
438
|
}
|