@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
|
@@ -7,7 +7,10 @@ const G = SESSION_RULES_GRAMMAR;
|
|
|
7
7
|
const A = "KitToolA";
|
|
8
8
|
const B = "KitToolB";
|
|
9
9
|
const fresh = () => `kit-2151-${randomUUID()}`;
|
|
10
|
+
const declared = (rules) => ({ ...rules, grammar: G });
|
|
11
|
+
const replayed = (row) => ({ ...row, grammar: row.grammar ?? 0 });
|
|
10
12
|
const isLoosenRefusal = (e) => e instanceof SessionPolicyError && e.code === "loosen_forbidden";
|
|
13
|
+
const isGrammarRequired = (e) => e instanceof SessionPolicyError && e.code === "grammar_required";
|
|
11
14
|
async function partOf(store, sessionId) {
|
|
12
15
|
const row = await store.getRules(sessionId, OWNER);
|
|
13
16
|
assert.ok(row !== null, "the row the case wrote must read back");
|
|
@@ -20,18 +23,18 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
|
|
|
20
23
|
run("a non-operator write over no row stamps an EMPTY operator part — the owner takes its own deny back", async () => {
|
|
21
24
|
const store = make();
|
|
22
25
|
const sid = fresh();
|
|
23
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] });
|
|
26
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
|
|
24
27
|
assert.deepEqual(await partOf(store, sid), { grammar: G });
|
|
25
|
-
const back = await store.putRules(sid, OWNER, {});
|
|
28
|
+
const back = await store.putRules(sid, OWNER, declared({}));
|
|
26
29
|
assert.equal(back.toolDeny, undefined);
|
|
27
30
|
assert.deepEqual(await partOf(store, sid), { grammar: G });
|
|
28
31
|
});
|
|
29
32
|
run("an operator write's whole value is the operator's: no part on the row, and the owner's drop of its entry is refused with nothing written", async () => {
|
|
30
33
|
const store = make();
|
|
31
34
|
const sid = fresh();
|
|
32
|
-
const stored = await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
35
|
+
const stored = await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
33
36
|
assert.equal(await partOf(store, sid), undefined);
|
|
34
|
-
await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
|
|
37
|
+
await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
|
|
35
38
|
const row = await store.getRules(sid, OWNER);
|
|
36
39
|
assert.equal(row?.rev, stored.rev);
|
|
37
40
|
assert.deepEqual(row?.toolDeny, [A]);
|
|
@@ -39,42 +42,42 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
|
|
|
39
42
|
run("an owner write over an operator row carries the operator's buckets as its part — above them it adds and takes back, below them it is refused", async () => {
|
|
40
43
|
const store = make();
|
|
41
44
|
const sid = fresh();
|
|
42
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
43
|
-
await store.putRules(sid, OWNER, { toolDeny: [A, B] });
|
|
45
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
46
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A, B] }));
|
|
44
47
|
assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
|
|
45
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] });
|
|
48
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
|
|
46
49
|
assert.deepEqual((await store.getRules(sid, OWNER))?.toolDeny, [A]);
|
|
47
|
-
await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
|
|
50
|
+
await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
|
|
48
51
|
assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
|
|
49
52
|
});
|
|
50
53
|
run("the same entry from both writers: once an operator write carries it, the owner's drop is refused", async () => {
|
|
51
54
|
const store = make();
|
|
52
55
|
const sid = fresh();
|
|
53
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] });
|
|
54
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
55
|
-
await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
|
|
56
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }));
|
|
57
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
58
|
+
await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
|
|
56
59
|
assert.deepEqual((await store.getRules(sid, OWNER))?.toolDeny, [A]);
|
|
57
60
|
});
|
|
58
61
|
run("a part handed in with the value is no authority: the stored part is the judge's", async () => {
|
|
59
62
|
const store = make();
|
|
60
63
|
const sid = fresh();
|
|
61
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
62
|
-
const forged = { toolDeny: [A, B], operatorRules: { grammar: G } };
|
|
64
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
65
|
+
const forged = { toolDeny: [A, B], grammar: G, operatorRules: { grammar: G } };
|
|
63
66
|
await store.putRules(sid, OWNER, forged);
|
|
64
67
|
assert.deepEqual(await partOf(store, sid), { toolDeny: [A], grammar: G });
|
|
65
|
-
await assert.rejects(store.putRules(sid, OWNER, {}), isLoosenRefusal);
|
|
68
|
+
await assert.rejects(store.putRules(sid, OWNER, declared({})), isLoosenRefusal);
|
|
66
69
|
});
|
|
67
70
|
run("allowDirs: the owner's own confinement is the owner's to remove; an operator's is not", async () => {
|
|
68
71
|
const store = make();
|
|
69
72
|
const own = fresh();
|
|
70
|
-
await store.putRules(own, OWNER, { allowDirs: ["/work/src"] });
|
|
71
|
-
await store.putRules(own, OWNER, {});
|
|
73
|
+
await store.putRules(own, OWNER, declared({ allowDirs: ["/work/src"] }));
|
|
74
|
+
await store.putRules(own, OWNER, declared({}));
|
|
72
75
|
assert.equal((await store.getRules(own, OWNER))?.allowDirs, undefined);
|
|
73
76
|
const operators = fresh();
|
|
74
|
-
await store.putRules(operators, OWNER, { allowDirs: ["/work"] }, { operator: true });
|
|
75
|
-
await store.putRules(operators, OWNER, { allowDirs: ["/work/src"] });
|
|
76
|
-
await store.putRules(operators, OWNER, { allowDirs: ["/work"] });
|
|
77
|
-
await assert.rejects(store.putRules(operators, OWNER, {}), isLoosenRefusal);
|
|
77
|
+
await store.putRules(operators, OWNER, declared({ allowDirs: ["/work"] }), { operator: true });
|
|
78
|
+
await store.putRules(operators, OWNER, declared({ allowDirs: ["/work/src"] }));
|
|
79
|
+
await store.putRules(operators, OWNER, declared({ allowDirs: ["/work"] }));
|
|
80
|
+
await assert.rejects(store.putRules(operators, OWNER, declared({})), isLoosenRefusal);
|
|
78
81
|
assert.deepEqual((await store.getRules(operators, OWNER))?.allowDirs, ["/work"]);
|
|
79
82
|
});
|
|
80
83
|
run("a stored row replayed by a non-operator onto a fresh or erased key keeps who may take what back (an import's replay)", async () => {
|
|
@@ -82,35 +85,36 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
|
|
|
82
85
|
const exported = async (sid) => {
|
|
83
86
|
const records = store.listBySession !== undefined ? await store.listBySession(sid) : [{ principal: OWNER, rules: (await store.getRules(sid, OWNER)) }];
|
|
84
87
|
assert.equal(records.length, 1);
|
|
85
|
-
return records[0].rules;
|
|
88
|
+
return replayed(records[0].rules);
|
|
86
89
|
};
|
|
87
90
|
const opSid = fresh();
|
|
88
|
-
await store.putRules(opSid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
91
|
+
await store.putRules(opSid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
89
92
|
const opRow = await exported(opSid);
|
|
90
|
-
const
|
|
91
|
-
await store.putRules(
|
|
92
|
-
await assert.rejects(store.putRules(
|
|
93
|
+
const replay = fresh();
|
|
94
|
+
await store.putRules(replay, OWNER, opRow);
|
|
95
|
+
await assert.rejects(store.putRules(replay, OWNER, declared({})), isLoosenRefusal);
|
|
93
96
|
const mixedSid = fresh();
|
|
94
|
-
await store.putRules(mixedSid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
95
|
-
await store.putRules(mixedSid, OWNER, { toolDeny: [A, B] });
|
|
97
|
+
await store.putRules(mixedSid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
98
|
+
await store.putRules(mixedSid, OWNER, declared({ toolDeny: [A, B] }));
|
|
96
99
|
const mixed = await exported(mixedSid);
|
|
97
100
|
const target = fresh();
|
|
98
101
|
await store.putRules(target, OWNER, mixed);
|
|
99
102
|
assert.deepEqual(await partOf(store, target), { toolDeny: [A], grammar: G });
|
|
100
|
-
await store.putRules(target, OWNER, { toolDeny: [A] });
|
|
101
|
-
await assert.rejects(store.putRules(target, OWNER, {}), isLoosenRefusal);
|
|
103
|
+
await store.putRules(target, OWNER, declared({ toolDeny: [A] }));
|
|
104
|
+
await assert.rejects(store.putRules(target, OWNER, declared({})), isLoosenRefusal);
|
|
102
105
|
if (store.deleteBySession !== undefined) {
|
|
103
|
-
await store.deleteBySession(
|
|
104
|
-
await store.putRules(
|
|
105
|
-
await assert.rejects(store.putRules(
|
|
106
|
+
await store.deleteBySession(replay);
|
|
107
|
+
await store.putRules(replay, OWNER, opRow);
|
|
108
|
+
await assert.rejects(store.putRules(replay, OWNER, declared({})), isLoosenRefusal);
|
|
106
109
|
}
|
|
107
110
|
});
|
|
108
111
|
run("a value built on the no-row record (`{ rev: 0 }`, what a read of an unwritten key answers) is written now: the owner takes back what it added through it", async () => {
|
|
109
112
|
const store = make();
|
|
110
113
|
const sid = fresh();
|
|
111
|
-
|
|
114
|
+
const noRowRecord = { rev: 0, toolDeny: [A], grammar: G };
|
|
115
|
+
await store.putRules(sid, OWNER, noRowRecord);
|
|
112
116
|
assert.deepEqual(await partOf(store, sid), { grammar: G });
|
|
113
|
-
const back = await store.putRules(sid, OWNER, {});
|
|
117
|
+
const back = await store.putRules(sid, OWNER, declared({}));
|
|
114
118
|
assert.equal(back.toolDeny, undefined);
|
|
115
119
|
});
|
|
116
120
|
run("the part rides the session's enumeration (an export carries who may take what back)", async () => {
|
|
@@ -118,13 +122,30 @@ export async function sessionPolicyStoreContract(make, runAssertion) {
|
|
|
118
122
|
if (store.listBySession === undefined)
|
|
119
123
|
return;
|
|
120
124
|
const sid = fresh();
|
|
121
|
-
await store.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true });
|
|
122
|
-
await store.putRules(sid, OWNER, { toolDeny: [A, B] });
|
|
125
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
126
|
+
await store.putRules(sid, OWNER, declared({ toolDeny: [A, B] }));
|
|
123
127
|
const records = await store.listBySession(sid);
|
|
124
128
|
assert.equal(records.length, 1);
|
|
125
129
|
const read = readSessionRulesShape(records[0].rules);
|
|
126
130
|
assert.ok(!("fault" in read));
|
|
127
131
|
assert.deepEqual(read.rules.operatorRules, { toolDeny: [A], grammar: G });
|
|
128
132
|
});
|
|
133
|
+
run("a write that declares no grammar is refused `grammar_required` with nothing written — on a fresh key, as an operator, and over a row", async () => {
|
|
134
|
+
const store = make();
|
|
135
|
+
const undeclaredStore = store;
|
|
136
|
+
const sid = fresh();
|
|
137
|
+
await assert.rejects(undeclaredStore.putRules(sid, OWNER, { toolDeny: [A] }), isGrammarRequired);
|
|
138
|
+
await assert.rejects(undeclaredStore.putRules(sid, OWNER, { toolDeny: [A] }, { operator: true }), isGrammarRequired);
|
|
139
|
+
assert.equal(await store.getRules(sid, OWNER), null);
|
|
140
|
+
const stored = await store.putRules(sid, OWNER, declared({ toolDeny: [A] }), { operator: true });
|
|
141
|
+
const { grammar: _stamp, ...unstamped } = stored;
|
|
142
|
+
void _stamp;
|
|
143
|
+
await assert.rejects(undeclaredStore.putRules(sid, OWNER, unstamped, { operator: true }), isGrammarRequired);
|
|
144
|
+
const stampSaysNothing = { ...stored, grammar: undefined };
|
|
145
|
+
await assert.rejects(undeclaredStore.putRules(sid, OWNER, stampSaysNothing, { operator: true }), isGrammarRequired);
|
|
146
|
+
const row = await store.getRules(sid, OWNER);
|
|
147
|
+
assert.equal(row?.rev, stored.rev);
|
|
148
|
+
assert.deepEqual(row?.toolDeny, [A]);
|
|
149
|
+
});
|
|
129
150
|
await settle();
|
|
130
151
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { strict as assert } from "node:assert";
|
|
2
|
-
import { sessionLogMarkOf } from "../../internal/harness.js";
|
|
2
|
+
import { readSessionRepoRowCells, sessionLogMarkOf } from "../../internal/harness.js";
|
|
3
3
|
import { TtlSessionStore } from "../session-store.js";
|
|
4
4
|
import { beginContract } from "./contract-harness.js";
|
|
5
5
|
const SESSION_ENTRY = (id, parentId) => ({
|
|
@@ -12,6 +12,7 @@ const SESSION_ENTRY = (id, parentId) => ({
|
|
|
12
12
|
export async function sessionRepoContract(make, runAssertion) {
|
|
13
13
|
const { run, settle } = beginContract(runAssertion);
|
|
14
14
|
const A = "0198fa00-0000-7000-8000-00000000000a";
|
|
15
|
+
const cellsOf = (repo) => readSessionRepoRowCells("the repo under the session repo contract", repo.rowCells);
|
|
15
16
|
run("RB-360 create({id}) on an id that ALREADY has history is an idempotent REOPEN — never a wipe", async () => {
|
|
16
17
|
const repo = make();
|
|
17
18
|
const sess = await repo.create({ id: A });
|
|
@@ -198,7 +199,7 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
198
199
|
assert.equal(again.owner, "kit-alice", "the owner changes only through a write of the row");
|
|
199
200
|
assert.equal(again.incarnation, token);
|
|
200
201
|
if (repo.headOf !== undefined)
|
|
201
|
-
assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", incarnation: token, leafId: null });
|
|
202
|
+
assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", ...(token === undefined ? {} : { incarnation: token }), leafId: null });
|
|
202
203
|
});
|
|
203
204
|
run("headOf (where the repo answers it): no row ⇒ undefined; a row ⇒ its owner, occupant and active leaf, as open() reads them", async () => {
|
|
204
205
|
const repo = make();
|
|
@@ -210,12 +211,17 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
210
211
|
await sess.getStorage().appendEntry(SESSION_ENTRY("e2", "e1"));
|
|
211
212
|
await sess.getStorage().setLeafId("e1");
|
|
212
213
|
const opened = await repo.open({ id: A, createdAt: "" });
|
|
213
|
-
|
|
214
|
+
{
|
|
215
|
+
const inc = (await opened.getMetadata()).incarnation;
|
|
216
|
+
assert.deepEqual(await repo.headOf(A), { owner: "kit-alice", ...(inc === undefined ? {} : { incarnation: inc }), leafId: await opened.getStorage().getLeafId() });
|
|
217
|
+
}
|
|
214
218
|
await repo.delete({ id: A, createdAt: "" });
|
|
215
219
|
assert.equal(await repo.headOf(A), undefined, "a deleted row has no head");
|
|
216
220
|
});
|
|
217
221
|
run("the store over a repo: a row replaced behind a cached session (deleted, then created again naming another owner) — the store's next acquire serves the new row, never the cached transcript", async () => {
|
|
218
222
|
const repo = make();
|
|
223
|
+
if (cellsOf(repo) === "host")
|
|
224
|
+
return;
|
|
219
225
|
const store = new TtlSessionStore({ repo });
|
|
220
226
|
try {
|
|
221
227
|
if (store.headOf === undefined)
|
|
@@ -297,7 +303,13 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
297
303
|
assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head } })), "conflict", "the row was deleted since the read");
|
|
298
304
|
assert.equal(await logIds(repo, A), undefined, "and no row was created");
|
|
299
305
|
await repo.create({ id: A, owner: "kit-alice" });
|
|
300
|
-
|
|
306
|
+
if (cellsOf(repo) === "engine") {
|
|
307
|
+
assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head } })), "conflict", "the row was created again: another occupant, same owner");
|
|
308
|
+
}
|
|
309
|
+
else {
|
|
310
|
+
assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: before.head, log: sessionLogMarkOf(before.entries) } })), "conflict", "the row was created again: its log is not the one read");
|
|
311
|
+
await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: { row: { owner: "kit-alice", incarnation: "kit-occupant" } } }), TypeError, "an expectation naming an occupant, to a repo that holds none");
|
|
312
|
+
}
|
|
301
313
|
assert.deepEqual(await logIds(repo, A), [], "the new row's log is untouched");
|
|
302
314
|
const noShape = { row: before.head, log: "a mark of no shape" };
|
|
303
315
|
await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: noShape }), TypeError, "an expectation of no shape is refused, never read as none");
|
|
@@ -315,7 +327,13 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
315
327
|
assert.deepEqual(await logIds(repo, A), ["e1", "e2"]);
|
|
316
328
|
await repo.delete({ id: A, createdAt: "" });
|
|
317
329
|
await repo.create({ id: A, owner: "kit-alice" });
|
|
318
|
-
|
|
330
|
+
if (cellsOf(repo) === "engine") {
|
|
331
|
+
assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, { row: read.head })), "conflict", "another occupant under the id: not deleted");
|
|
332
|
+
}
|
|
333
|
+
else {
|
|
334
|
+
assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, { row: read.head, log: sessionLogMarkOf(read.entries) })), "conflict", "the row created again under the id: its log is not the one read, not deleted");
|
|
335
|
+
await assert.rejects(() => repo.delete({ id: A, createdAt: "" }, { row: { owner: "kit-alice", incarnation: "kit-occupant" } }), TypeError, "an expectation naming an occupant, to a repo that holds none");
|
|
336
|
+
}
|
|
319
337
|
assert.deepEqual(await logIds(repo, A), [], "the new occupant stands");
|
|
320
338
|
const current = (await repo.readRow(A));
|
|
321
339
|
await (await repo.open({ id: A, createdAt: "" })).getStorage().appendEntry(SESSION_ENTRY("f1", null));
|
|
@@ -327,6 +345,8 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
327
345
|
});
|
|
328
346
|
run("the store over a repo answers headOf exactly when the repo does: present ⇒ the repo's own answer; absent ⇒ no headOf on the store, which still works", async () => {
|
|
329
347
|
const repo = make();
|
|
348
|
+
if (cellsOf(repo) === "host")
|
|
349
|
+
return;
|
|
330
350
|
const store = new TtlSessionStore({ repo });
|
|
331
351
|
try {
|
|
332
352
|
assert.equal(typeof store.headOf, typeof repo.headOf === "function" ? "function" : "undefined");
|
|
@@ -355,5 +375,110 @@ export async function sessionRepoContract(make, runAssertion) {
|
|
|
355
375
|
over.dispose();
|
|
356
376
|
}
|
|
357
377
|
});
|
|
378
|
+
run("the occupant cells by mode: an engine repo writes a row's occupant on create, fork (the source's as forkedFromIncarnation) and an import onto an absent id, and every read hands it out; a host repo writes neither cell and no read hands either out", async () => {
|
|
379
|
+
const repo = make();
|
|
380
|
+
const B = "0198fa00-0000-7000-8000-00000000000b";
|
|
381
|
+
const C = "0198fa00-0000-7000-8000-00000000000c";
|
|
382
|
+
const src = await repo.create({ id: A, owner: "kit-alice" });
|
|
383
|
+
await src.getStorage().appendEntry(SESSION_ENTRY("e1", null));
|
|
384
|
+
const forked = await repo.fork({ id: A, createdAt: "" }, { id: B });
|
|
385
|
+
const createdMeta = await src.getMetadata();
|
|
386
|
+
const forkedMeta = await forked.getMetadata();
|
|
387
|
+
const created = [["the session create returned", createdMeta], ["the session fork returned", forkedMeta]];
|
|
388
|
+
assert.equal(forkedMeta.forkedFrom, A, "the lineage's id is the repo's in either mode");
|
|
389
|
+
const imported = repo.importEntries === undefined ? undefined : await repo.importEntries(C, "kit-alice", [SESSION_ENTRY("e1", null)]);
|
|
390
|
+
const ids = imported === undefined ? [A, B] : [A, B, C];
|
|
391
|
+
const metasOf = async (id) => {
|
|
392
|
+
const out = [[`open(${id})`, await (await repo.open({ id, createdAt: "" })).getMetadata()]];
|
|
393
|
+
const listed = (await repo.list()).find((m) => m.id === id);
|
|
394
|
+
assert.ok(listed !== undefined, `list() answers row ${id}`);
|
|
395
|
+
out.push([`list() row ${id}`, listed]);
|
|
396
|
+
if (repo.readRow !== undefined)
|
|
397
|
+
out.push([`readRow(${id}).metadata`, (await repo.readRow(id)).metadata]);
|
|
398
|
+
return out;
|
|
399
|
+
};
|
|
400
|
+
const headsOf = async (id) => {
|
|
401
|
+
const out = [];
|
|
402
|
+
if (repo.headOf !== undefined)
|
|
403
|
+
out.push([`headOf(${id})`, (await repo.headOf(id))]);
|
|
404
|
+
if (repo.readRow !== undefined)
|
|
405
|
+
out.push([`readRow(${id}).head`, (await repo.readRow(id)).head]);
|
|
406
|
+
if (imported !== undefined && id === C)
|
|
407
|
+
out.push(["the head the import answered", imported]);
|
|
408
|
+
return out;
|
|
409
|
+
};
|
|
410
|
+
if (cellsOf(repo) === "engine") {
|
|
411
|
+
const tokenA = createdMeta.incarnation;
|
|
412
|
+
const tokenB = forkedMeta.incarnation;
|
|
413
|
+
assert.ok(typeof tokenA === "string" && tokenA !== "", "create writes the row's occupant");
|
|
414
|
+
assert.ok(typeof tokenB === "string" && tokenB !== "" && tokenB !== tokenA, "a fork row is an occupant of its own");
|
|
415
|
+
assert.equal(forkedMeta.forkedFromIncarnation, tokenA, "and records the source's occupant as its lineage");
|
|
416
|
+
const want = new Map([[A, tokenA], [B, tokenB]]);
|
|
417
|
+
if (imported !== undefined) {
|
|
418
|
+
assert.ok(typeof imported.incarnation === "string" && imported.incarnation !== "" && imported.incarnation !== tokenA && imported.incarnation !== tokenB, "an import onto an absent id writes an occupant of its own");
|
|
419
|
+
want.set(C, imported.incarnation);
|
|
420
|
+
}
|
|
421
|
+
for (const id of ids) {
|
|
422
|
+
for (const [what, meta] of await metasOf(id))
|
|
423
|
+
assert.equal(meta.incarnation, want.get(id), `${what} hands out the row's occupant`);
|
|
424
|
+
for (const [what, head] of await headsOf(id))
|
|
425
|
+
assert.equal(head.incarnation, want.get(id), `${what} hands out the row's occupant`);
|
|
426
|
+
}
|
|
427
|
+
for (const [what, meta] of await metasOf(B))
|
|
428
|
+
assert.equal(meta.forkedFromIncarnation, tokenA, `${what} hands out the fork's lineage occupant`);
|
|
429
|
+
return;
|
|
430
|
+
}
|
|
431
|
+
for (const [what, meta] of created) {
|
|
432
|
+
assert.equal(meta.incarnation, undefined, `${what}: no occupant`);
|
|
433
|
+
assert.equal(meta.forkedFromIncarnation, undefined, `${what}: no lineage occupant`);
|
|
434
|
+
}
|
|
435
|
+
for (const id of ids) {
|
|
436
|
+
for (const [what, meta] of await metasOf(id)) {
|
|
437
|
+
assert.equal(meta.incarnation, undefined, `${what}: no occupant handed out`);
|
|
438
|
+
assert.equal(meta.forkedFromIncarnation, undefined, `${what}: no lineage occupant handed out`);
|
|
439
|
+
}
|
|
440
|
+
for (const [what, head] of await headsOf(id))
|
|
441
|
+
assert.equal(head.incarnation, undefined, `${what}: no occupant handed out`);
|
|
442
|
+
}
|
|
443
|
+
});
|
|
444
|
+
run("a conditional write by mode: an engine repo judges the occupant an expectation names (another ⇒ conflict); a host repo judges the owner and the log and refuses an expectation naming any occupant (a TypeError, nothing written); in either mode the row as read is written", async () => {
|
|
445
|
+
const repo = make();
|
|
446
|
+
if (repo.readRow === undefined)
|
|
447
|
+
return;
|
|
448
|
+
const sess = await repo.create({ id: A, owner: "kit-alice" });
|
|
449
|
+
await sess.getStorage().appendEntry(SESSION_ENTRY("e1", null));
|
|
450
|
+
const read = (await repo.readRow(A));
|
|
451
|
+
const named = { row: { owner: "kit-alice", incarnation: "kit-occupant" } };
|
|
452
|
+
if (cellsOf(repo) === "engine") {
|
|
453
|
+
assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, named)), "conflict", "an occupant that is not the row's: not deleted");
|
|
454
|
+
if (repo.importEntries !== undefined)
|
|
455
|
+
assert.equal(await conflictOf(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: named })), "conflict", "an occupant that is not the row's: not written");
|
|
456
|
+
}
|
|
457
|
+
else {
|
|
458
|
+
assert.equal(read.head.incarnation, undefined, "the head this repo reads names no occupant");
|
|
459
|
+
await assert.rejects(() => repo.delete({ id: A, createdAt: "" }, named), TypeError, "a delete naming an occupant");
|
|
460
|
+
if (repo.importEntries !== undefined)
|
|
461
|
+
await assert.rejects(() => repo.importEntries(A, "kit-alice", [SESSION_ENTRY("x1", null)], { expect: named }), TypeError, "an import naming an occupant");
|
|
462
|
+
const otherOwner = { row: { owner: "kit-bob", incarnation: undefined } };
|
|
463
|
+
assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, otherOwner)), "conflict", "another owner: not deleted");
|
|
464
|
+
const moved = { row: read.head, log: { length: read.entries.length + 1, lastEntryId: "kit-other" } };
|
|
465
|
+
assert.equal(await conflictOf(() => repo.delete({ id: A, createdAt: "" }, moved)), "conflict", "another log: not deleted");
|
|
466
|
+
}
|
|
467
|
+
assert.deepEqual(await logIds(repo, A), ["e1"], "the refused writes wrote nothing");
|
|
468
|
+
if (repo.importEntries !== undefined) {
|
|
469
|
+
await repo.importEntries(A, "kit-alice", [SESSION_ENTRY("n1", null)], { expect: { row: read.head, log: sessionLogMarkOf(read.entries) } });
|
|
470
|
+
assert.deepEqual(await logIds(repo, A), ["n1"], "the row and log as read: written");
|
|
471
|
+
}
|
|
472
|
+
const now = (await repo.readRow(A));
|
|
473
|
+
await repo.delete({ id: A, createdAt: "" }, { row: now.head, log: sessionLogMarkOf(now.entries) });
|
|
474
|
+
assert.equal(await logIds(repo, A), undefined, "the row and log as read: deleted");
|
|
475
|
+
});
|
|
476
|
+
run("TtlSessionStore over a repo whose host holds the occupant cells is refused at construction, coded config.invalid_argument and naming the missing occupant source — never a store whose every occupant comparison reads \"same\"", async () => {
|
|
477
|
+
const repo = make();
|
|
478
|
+
if (cellsOf(repo) === "engine")
|
|
479
|
+
return;
|
|
480
|
+
assert.throws(() => new TtlSessionStore({ repo }).dispose(), /this layer has no occupant source/);
|
|
481
|
+
assert.equal(await conflictOf(async () => new TtlSessionStore({ repo }).dispose()), "config.invalid_argument");
|
|
482
|
+
});
|
|
358
483
|
await settle();
|
|
359
484
|
}
|
|
@@ -41,7 +41,7 @@ export interface SessionStoreContractHooks {
|
|
|
41
41
|
/** Optional faces (plus the replica hook, and `requireExisting` — absent = the store rejects the option, its other
|
|
42
42
|
* legal mode) a run verified or found absent; reported per judging case, after its assertions held. */
|
|
43
43
|
onOptionalMember?: (report: {
|
|
44
|
-
member: "requireExisting" | "forget" | "fork" | "list" | "noteTaskRun" | "listPlaced" | "placements" | "headOf" | "ownership" | "replica" | "logTransfer" | "delete";
|
|
44
|
+
member: "requireExisting" | "forget" | "fork" | "list" | "noteTaskRun" | "listPlaced" | "placements" | "headOf" | "ownership" | "replica" | "logTransfer" | "delete" | "deleteUnreadable";
|
|
45
45
|
status: "verified" | "absent";
|
|
46
46
|
}) => void;
|
|
47
47
|
}
|
|
@@ -183,6 +183,7 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
183
183
|
replica: () => hooks.replica !== undefined,
|
|
184
184
|
logTransfer: (s) => hasHead(s) && typeof s.logTransfer === "object" && s.logTransfer !== null,
|
|
185
185
|
delete: (s) => hasHead(s) && typeof s.delete === "function",
|
|
186
|
+
deleteUnreadable: (s) => hasHead(s) && typeof s.deleteUnreadable === "function",
|
|
186
187
|
};
|
|
187
188
|
const faceRun = (name, needs, fn) => run(name, async (store, open) => {
|
|
188
189
|
const missing = [];
|
|
@@ -1257,6 +1258,22 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
1257
1258
|
assert.equal(await store.delete(id, { owner: null }), false);
|
|
1258
1259
|
assert.ok((await headOf(store, id)) !== undefined, "the placed row stands");
|
|
1259
1260
|
});
|
|
1261
|
+
faceRun("[deleteUnreadable] a row that reads is not unreadable: an anonymous row (and an owned one, where the store keeps owners) and an id with no row answer false and delete nothing", ["deleteUnreadable"], async (store) => {
|
|
1262
|
+
const anonymous = freshId();
|
|
1263
|
+
await append((await store.acquire(anonymous)).session, userEntry("u1", null));
|
|
1264
|
+
assert.equal(await store.deleteUnreadable(anonymous), false, "an anonymous row reads: it is not unreadable");
|
|
1265
|
+
assert.ok((await headOf(store, anonymous)) !== undefined, "the anonymous row stands");
|
|
1266
|
+
assert.deepEqual(await entryIds((await store.acquire(anonymous)).session), ["u1"], "and keeps its log");
|
|
1267
|
+
if (hasOwnership(store)) {
|
|
1268
|
+
const owned = freshId();
|
|
1269
|
+
await store.register(owned, "kit-alice");
|
|
1270
|
+
assert.equal(await store.deleteUnreadable(owned), false, "an owned row reads: it is not unreadable");
|
|
1271
|
+
assert.equal(await ownerOf(store, owned, "after the refused operator delete"), "kit-alice");
|
|
1272
|
+
}
|
|
1273
|
+
const none = freshId();
|
|
1274
|
+
assert.equal(await store.deleteUnreadable(none), false, "no row ⇒ false");
|
|
1275
|
+
assert.equal(await headOf(store, none), undefined, "and nothing is created under the id");
|
|
1276
|
+
});
|
|
1260
1277
|
await settle();
|
|
1261
1278
|
}
|
|
1262
1279
|
function firstTextBlock(entry) {
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type TaskListStore } from "../../tools/task-list.js";
|
|
2
|
+
import { type ContractAssertionRunner } from "./contract-harness.js";
|
|
3
|
+
/**
|
|
4
|
+
* The cross-backend {@link TaskListStore} contract kit (vitest-free; see `contract-harness.ts` for the runner seam). A task list has
|
|
5
|
+
* two bundled backends (`createMemoryTaskListStore`, `createFileTaskListStore`) and a deployment's own (a database twin); this kit is
|
|
6
|
+
* the semantics every one of them runs, so no backend drifts on what a valid entry is, what the list order is, or what a stored entry
|
|
7
|
+
* that does not read answers. Assertions describe landed behaviour only; the authoritative text is the `TaskListStore` contract in
|
|
8
|
+
* `src/tools/task-list.ts`. A backend that goes red here is in breach — the contract is not loosened to make it green.
|
|
9
|
+
*
|
|
10
|
+
* Tiers:
|
|
11
|
+
* - core (every backend): CRUD round trip, detached copies both ways, the entry table's write gate (absent dependency lists stored
|
|
12
|
+
* as `[]`, a present one that is no list refused), the metadata guard, `allocateId` unique and never reused, the list order (id
|
|
13
|
+
* ascending, stable), unknown-id answers, single-call atomicity under concurrent writes;
|
|
14
|
+
* - durable (`reopen` given — the backend outlives one object): cross-instance visibility and high-water mark, `mutate` as the
|
|
15
|
+
* transaction boundary, no lost update across instances;
|
|
16
|
+
* - damaged entries (`plantRow` given): an entry a foreign writer left that does not read is LISTED as its id and verdict, `get`
|
|
17
|
+
* of it refuses in {@link TASK_LIST_ROW_MALFORMED_CODE} without handing the planted bytes back, deletion by its id works, and
|
|
18
|
+
* through the tools it counts as open — it keeps blocking the task that depends on it, and no new edge to it is written.
|
|
19
|
+
* A backend with no bytes a foreign writer could damage declares `unplantable` (with its reason) instead; one of the two is
|
|
20
|
+
* required, so "forgot" never reads as "nothing to plant".
|
|
21
|
+
*/
|
|
22
|
+
export interface TaskListStoreContractHooks {
|
|
23
|
+
/** A fresh, empty store each call. */
|
|
24
|
+
readonly make: () => TaskListStore;
|
|
25
|
+
/** Another instance over the SAME backend (a restart, a second assembly). Absent = the backend is the object itself. */
|
|
26
|
+
readonly reopen?: (from: TaskListStore) => TaskListStore;
|
|
27
|
+
/** Plant one stored entry under `id` as these raw values, bypassing `set` — the shape a foreign writer leaves. */
|
|
28
|
+
readonly plantRow?: (store: TaskListStore, id: string, raw: unknown) => Promise<void> | void;
|
|
29
|
+
/** Declared instead of `plantRow`, once, by a backend that keeps no bytes a foreign writer could damage: why. */
|
|
30
|
+
readonly unplantable?: string;
|
|
31
|
+
}
|
|
32
|
+
export declare function taskListStoreContract(hooks: TaskListStoreContractHooks, runAssertion?: ContractAssertionRunner): Promise<void>;
|