@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { Static, TSchema } from "typebox";
|
|
2
|
+
import type { RenderedLocale } from "../../prompt-assembly/catalog/schema.js";
|
|
2
3
|
import type { AssistantMessage, AssistantMessageEvent, DocumentContent, ImageContent, Message, Model, RowRewrittenBy, SimpleStreamOptions, StreamFn as LlmStreamFn, TextContent, Tool, ToolResultMessage } from "../llm/index.js";
|
|
3
4
|
/**
|
|
4
5
|
* Stream function used by the agent loop.
|
|
@@ -91,6 +92,10 @@ export interface BeforeToolCallResult {
|
|
|
91
92
|
details?: unknown;
|
|
92
93
|
updatedInput?: unknown;
|
|
93
94
|
haltRemaining?: HaltRemainingDirective;
|
|
95
|
+
/** Without `block`: the command sandbox plan the gate minted for the call it let go, on the input it judged. It rides
|
|
96
|
+
* the call to its execution, which runs under it (`runWithCommandSandboxPlan`); every start the execution makes reads
|
|
97
|
+
* it there and nowhere else. Absent ⇒ the execution runs under no plan. */
|
|
98
|
+
sandboxPlan?: import("../../core/command-sandbox-dispatch.js").CommandSandboxPlan;
|
|
94
99
|
}
|
|
95
100
|
/**
|
|
96
101
|
* The settlement {@link BeforeToolCallResult.haltRemaining} instructs the loop to apply to each
|
|
@@ -103,6 +108,17 @@ export interface HaltRemainingDirective {
|
|
|
103
108
|
reason: string;
|
|
104
109
|
details?: Record<string, unknown>;
|
|
105
110
|
}
|
|
111
|
+
/**
|
|
112
|
+
* How a cut turn settles, as the one who cut it reads it: the text each tool call the cut kept from starting is answered
|
|
113
|
+
* with (static, the prefix cache's discipline), whether the interruption marker row follows the turn, and what the cut does
|
|
114
|
+
* to a foreground command the engine is allowed to move aside (the deployment armed it and the command is eligible): `true`
|
|
115
|
+
* moves it into the background, still running, `false` ends it with its call.
|
|
116
|
+
*/
|
|
117
|
+
export interface TurnCutSettlement {
|
|
118
|
+
readonly neverStartedText: string;
|
|
119
|
+
readonly marker: boolean;
|
|
120
|
+
readonly movesArmedCommandAside: boolean;
|
|
121
|
+
}
|
|
106
122
|
/**
|
|
107
123
|
* Partial override returned from `afterToolCall`.
|
|
108
124
|
*
|
|
@@ -246,6 +262,10 @@ export interface LoopTruncatedOutputRecovery {
|
|
|
246
262
|
* `toolUse` but carries ZERO parseable tool calls (the brain dropped truncated/invalid ones) used to
|
|
247
263
|
* end the run silently mid-task. When enabled, inject a synthetic retry nudge and run another turn,
|
|
248
264
|
* up to `maxRetries` times IN A ROW (a turn whose tool calls parsed clears the count; CC: up to twice).
|
|
265
|
+
* The same budget bounds a model that keeps calling a tool the roster does not mount: a turn whose every
|
|
266
|
+
* call is answered `tool.not_found` counts while it misses the same names as the streak's last such turn
|
|
267
|
+
* (no nudge — its results name the roster), a miss under other names starts the count over, a name the
|
|
268
|
+
* next turn's roster mounts is no miss, and the exhausted exit is the same `malformed_tool_use_exhausted`.
|
|
249
269
|
* Absent ⇒ OFF (pre-S2 behavior).
|
|
250
270
|
*/
|
|
251
271
|
export interface LoopMalformedToolUseRecovery {
|
|
@@ -494,6 +514,15 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
|
|
|
494
514
|
* Contract: must not throw or reject. Return [] when no follow-up messages are available.
|
|
495
515
|
*/
|
|
496
516
|
getFollowUpMessages?: () => Promise<AgentMessage[]>;
|
|
517
|
+
/**
|
|
518
|
+
* The answer already given to a follow-up message (an extension's `{ reply }` to the input it carries): a drain that hands
|
|
519
|
+
* back exactly such a message opens a turn that is this answer — the message enters, the answer is its assistant row, and no
|
|
520
|
+
* model is asked. `undefined` (the default) for every other message. Synchronous; must not throw.
|
|
521
|
+
*/
|
|
522
|
+
answerOf?: (message: AgentMessage) => {
|
|
523
|
+
readonly text: string;
|
|
524
|
+
readonly by: string;
|
|
525
|
+
} | undefined;
|
|
497
526
|
/**
|
|
498
527
|
* design/373 S1 — the TURN-scoped interrupt seat. The loop publishes each main turn's own
|
|
499
528
|
* AbortController here BEFORE its pre-request injection re-check (the linearization the
|
|
@@ -503,15 +532,21 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
|
|
|
503
532
|
* simply rides the next boundary drain, mirroring the upstream form (only an in-flight request is
|
|
504
533
|
* ever aborted). Aborting the published controller cancels THIS turn only: the loop reconciles
|
|
505
534
|
* (real results for work that finished, paired never-started results for calls that never began,
|
|
506
|
-
* the
|
|
507
|
-
* wins: when both fire, the loop takes the run-terminal path.
|
|
535
|
+
* and the row {@link noteTurnCutConsumed} answers) and the run CONTINUES at the next boundary. The
|
|
536
|
+
* run-level signal always wins: when both fire, the loop takes the run-terminal path.
|
|
508
537
|
*/
|
|
509
538
|
publishTurnInterruptSeat?: (seat: AbortController | undefined) => void;
|
|
510
539
|
/** The loop's REPORT that the published seat's cut settled its turn (stream / batch / recovery arms), called
|
|
511
540
|
* SYNCHRONOUSLY at the judgment point (before any settlement await, retracted or not) with the very controller
|
|
512
541
|
* {@link publishTurnInterruptSeat} published (checked against the host's LAST-published seat). Never for a
|
|
513
|
-
* run-level abort (the run signal wins) nor a normal ending.
|
|
514
|
-
|
|
542
|
+
* run-level abort (the run signal wins) nor a normal ending. Answers how the cut settles — the row of whoever cut
|
|
543
|
+
* the seat; `undefined` ⇒ the loop's own row ({@link TurnCutSettlement}, the user interrupt's). */
|
|
544
|
+
noteTurnCutConsumed?: (seat: AbortController) => TurnCutSettlement | undefined;
|
|
545
|
+
/** The loop's report that a turn opened — every turn, the one whose answer is already given (it publishes no seat) and a
|
|
546
|
+
* resumed batch's settlement turn included — before its seat is published. A host's record of "this turn's cut was
|
|
547
|
+
* settled" is per turn; this is where a turn begins. `opensAt` is the length of the run's message delta (the array the
|
|
548
|
+
* loop returns) at that moment: the turn's own messages are the ones from that index on. */
|
|
549
|
+
noteTurnOpened?: (opensAt: number) => void;
|
|
515
550
|
/**
|
|
516
551
|
* design/373 S1 — the pre-request re-check (the level half of the immediate-class contract):
|
|
517
552
|
* called once per turn, after the interrupt seat above is published and before the provider
|
|
@@ -605,6 +640,9 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
|
|
|
605
640
|
/** The run's image processor seat (`RunnerDeps.imageProcessor`, read through `resolveImageProcessor`): the tool-result seat
|
|
606
641
|
* admits every result's images with it. Absent ⇒ detect sharp, as on the deployment seat. */
|
|
607
642
|
imageProcessor?: import("../../core/image-downsample.js").ImageDownsampler | false;
|
|
643
|
+
/** Where the tool-result seat keeps the bytes of a media block it refused for its size: the run's offload store and session
|
|
644
|
+
* (`ToolResultBytesSeat`). Absent, or a store with no byte arm ⇒ the placeholder says the bytes were not kept. */
|
|
645
|
+
toolResultBytes?: import("../../core/tool-result-bytes.js").ToolResultBytesSeat;
|
|
608
646
|
/** Told the decoded size of an admitted result image that goes to the model over the soft target with no processor
|
|
609
647
|
* (`firstUnprocessedOverTarget`) — the run's once-per-run operator account. Advisory: a throwing sink changes nothing. */
|
|
610
648
|
onImageUnprocessed?: (bytes: number) => void;
|
|
@@ -850,6 +888,7 @@ export interface AgentContext {
|
|
|
850
888
|
messages: AgentMessage[];
|
|
851
889
|
/** Tools available for this run. */
|
|
852
890
|
tools?: AgentTool[];
|
|
891
|
+
promptLocale?: RenderedLocale;
|
|
853
892
|
}
|
|
854
893
|
/**
|
|
855
894
|
* Events emitted by the Agent for UI updates.
|
|
@@ -20,9 +20,11 @@ export interface NodeLspManagerOptions {
|
|
|
20
20
|
servers?: Record<string, string | null>;
|
|
21
21
|
/** Injectable spawn (tests supply a fake server; default = {@link defaultLspSpawn} over `child_process.spawn`). */
|
|
22
22
|
spawn?: LspSpawn;
|
|
23
|
-
/**
|
|
24
|
-
*
|
|
25
|
-
*
|
|
23
|
+
/** Variables the host hands the language server: a grant laid over the per-spawn scrubbed inheritance (the tool shell's
|
|
24
|
+
* `shellEnv` sense; default spawn environment = `hostChildEnv("scrub", env)`, composed at every spawn). Grant entries pass
|
|
25
|
+
* as written; inherited entries equal to the engine's own credentials by name or value are withheld at every spawn, as are
|
|
26
|
+
* credential-shaped names the grant does not re-supply. Omitted (or `null`) ⇒ the scrubbed inheritance alone. A grant the
|
|
27
|
+
* composition refuses throws at construction; one refusable later fails that spawn (`lsp_spawn_error`, not cached). Unread when {@link spawn} is supplied. */
|
|
26
28
|
env?: Record<string, string>;
|
|
27
29
|
/** #1081 — the withheld-keys notice sink, SAME shared once-per-process latch/code as the shell-exec
|
|
28
30
|
* site's `NodeExecutionEnv.onNotice`. Absent ⇒ console only. Unread when {@link spawn} is supplied. */
|
|
@@ -11,7 +11,7 @@ import { TransportLspSession } from "../../core/lsp-session.js";
|
|
|
11
11
|
import { StdioLspTransport } from "./stdio-lsp-transport.js";
|
|
12
12
|
import { MAX_LSP_FILE_BYTES, SharedAbortScope, settleOnAbort } from "../../core/lsp.js";
|
|
13
13
|
import { asThrownError, thrownText } from "../../core/thrown-value.js";
|
|
14
|
-
import { announceSecretEnvScrub,
|
|
14
|
+
import { announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem } from "../../core/secret-env.js";
|
|
15
15
|
export const DEFAULT_LSP_SERVERS = {
|
|
16
16
|
typescript: "typescript-language-server --stdio",
|
|
17
17
|
javascript: "typescript-language-server --stdio",
|
|
@@ -69,7 +69,15 @@ export class NodeLspManager {
|
|
|
69
69
|
disposed = false;
|
|
70
70
|
constructor(opts = {}) {
|
|
71
71
|
this.servers = { ...DEFAULT_LSP_SERVERS, ...opts.servers };
|
|
72
|
-
|
|
72
|
+
if (opts.spawn != null)
|
|
73
|
+
this.spawnFn = opts.spawn;
|
|
74
|
+
else {
|
|
75
|
+
const grant = opts.env ?? undefined;
|
|
76
|
+
const grantProblem = hostChildEnvProblem("scrub", grant);
|
|
77
|
+
if (grantProblem !== undefined)
|
|
78
|
+
throw new Error(`NodeLspManager: ${grantProblem}`);
|
|
79
|
+
this.spawnFn = lspSpawnWithEnv(grant, opts.onNotice);
|
|
80
|
+
}
|
|
73
81
|
this.readTextFn = opts.readText ?? defaultLspReadText;
|
|
74
82
|
this.resolveRootFn = opts.resolveRoot ?? defaultResolveRoot;
|
|
75
83
|
this.log = opts.log ?? (() => { });
|
|
@@ -349,16 +357,12 @@ export function lspSpawnOptions(cwd) {
|
|
|
349
357
|
: { cwd, stdio: ["pipe", "pipe", "ignore"] };
|
|
350
358
|
}
|
|
351
359
|
export const defaultLspSpawn = (command, args, cwd, signal) => lspSpawnWithEnv(undefined)(command, args, cwd, signal);
|
|
352
|
-
const lspSpawnWithEnv = (
|
|
360
|
+
const lspSpawnWithEnv = (grant, onNotice) => (command, args, cwd, signal) => new Promise((resolve, reject) => {
|
|
353
361
|
let child;
|
|
354
362
|
try {
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
scrubbedEnv = inheritedHostEnv("scrub", findings);
|
|
359
|
-
announceSecretEnvScrub(onNotice, findings);
|
|
360
|
-
}
|
|
361
|
-
child = spawn(command, args, { ...lspSpawnOptions(cwd), env: scrubbedEnv });
|
|
363
|
+
const { env, withheld } = hostChildEnv("scrub", grant);
|
|
364
|
+
announceSecretEnvScrub(onNotice, withheld);
|
|
365
|
+
child = spawn(command, args, { ...lspSpawnOptions(cwd), env });
|
|
362
366
|
}
|
|
363
367
|
catch (e) {
|
|
364
368
|
return reject(asThrownError(e));
|
|
@@ -3,6 +3,7 @@ import { leafIdAfterEntry } from "./storage-base.js";
|
|
|
3
3
|
import { parseSessionTimestampMs } from "./timestamps.js";
|
|
4
4
|
import { flattenableUserText, normalizeEngineSegments } from "../../core/untrusted-text.js";
|
|
5
5
|
import { isRunOrigin } from "../../core/run-origin.js";
|
|
6
|
+
import { readBundledAttachments } from "../../core/attachment-source.js";
|
|
6
7
|
import { readStoredPromptEpoch } from "../../prompt-assembly/epoch.js";
|
|
7
8
|
import { MAX_MINTED_TOOL_RESULT_REF_CHARS } from "../../core/tool-result-store.js";
|
|
8
9
|
import { PERSISTED_OUTPUT_REFS_MAX_ENTRIES, SKILL_RETENTION_PER_SKILL_MAX_CHARS, SKILL_RETENTION_TOTAL_MAX_CHARS, } from "../compaction/utils.js";
|
|
@@ -310,6 +311,14 @@ function normalizeEngineProvenanceStamp(message, preserveActorAssertions = false
|
|
|
310
311
|
if (m.engineMinted === true && m.provenance === "engine-note") {
|
|
311
312
|
delete m.engineMinted;
|
|
312
313
|
}
|
|
314
|
+
if (m.attachments !== undefined) {
|
|
315
|
+
const flat = flattenableUserText(m.content);
|
|
316
|
+
const kept = m.engineMinted === true && flat !== undefined ? readBundledAttachments(m.attachments, flat.length) : undefined;
|
|
317
|
+
if (kept !== undefined)
|
|
318
|
+
m.attachments = [...kept];
|
|
319
|
+
else
|
|
320
|
+
delete m.attachments;
|
|
321
|
+
}
|
|
313
322
|
if (m.enginePrefixChars !== undefined &&
|
|
314
323
|
!(typeof m.enginePrefixChars === "number" && Number.isInteger(m.enginePrefixChars) && m.enginePrefixChars > 0)) {
|
|
315
324
|
delete m.enginePrefixChars;
|
|
@@ -1,8 +1,14 @@
|
|
|
1
1
|
import { type Session, type SessionCreateOptions, type SessionForkOptions, type SessionHead, type SessionMetadata, type SessionRepo, type SessionRow, type SessionRowExpectation, type SessionRowRead, type SessionTreeEntry } from "../harness/types.js";
|
|
2
|
+
import { type SessionRepoRowCells } from "./row-cells.js";
|
|
2
3
|
export declare class InMemorySessionRepo implements SessionRepo<SessionMetadata, SessionCreateOptions> {
|
|
3
4
|
private rows;
|
|
4
5
|
/** Each row's last touch (epoch ms). */
|
|
5
6
|
private touched;
|
|
7
|
+
/** Who holds the rows' occupant cells ({@link SessionRepoRowCells}): `"engine"` (absent) — this repo; `"host"` — the host's store. */
|
|
8
|
+
readonly rowCells: SessionRepoRowCells;
|
|
9
|
+
constructor(options?: {
|
|
10
|
+
readonly rowCells?: SessionRepoRowCells;
|
|
11
|
+
});
|
|
6
12
|
create(options?: SessionCreateOptions): Promise<Session>;
|
|
7
13
|
open(metadata: SessionMetadata): Promise<Session>;
|
|
8
14
|
/** The row's head off the one row that IS it: every cell comes from that row, so a delete and re-create of the id while this reads
|
|
@@ -32,6 +38,7 @@ export declare class InMemorySessionRepo implements SessionRepo<SessionMetadata,
|
|
|
32
38
|
preserveActorAssertions?: boolean;
|
|
33
39
|
expect?: SessionRowExpectation;
|
|
34
40
|
}): Promise<SessionHead>;
|
|
35
|
-
/** Lay a row down under its id: one storage, one session over it, the metadata
|
|
41
|
+
/** Lay a row down under its id: one storage, one session over it, and the metadata as this repo holds it ({@link heldRowCells}),
|
|
42
|
+
* frozen — every write that lays a row down comes through here, so no row holds a cell its mode does not. */
|
|
36
43
|
private lay;
|
|
37
44
|
}
|
|
@@ -2,22 +2,30 @@ import { SessionError } from "../harness/types.js";
|
|
|
2
2
|
import { validateEntriesForImport } from "./import-validate.js";
|
|
3
3
|
import { InMemorySessionStorage } from "./memory-storage.js";
|
|
4
4
|
import { resolveLeafId } from "./storage-base.js";
|
|
5
|
-
import { assertForkTarget, createSessionId, createTimestamp, forkRowCells, frozenRow, getEntriesToFork, headOfSession, importRowCells, incarnationCell, ownerCell, rowExpectationMissed,
|
|
5
|
+
import { assertForkTarget, createSessionId, createTimestamp, forkRowCells, frozenRow, getEntriesToFork, headOfSession, importRowCells, incarnationCell, ownerCell, rowExpectationMissed, sessionHeadOf, toSession } from "./repo-utils.js";
|
|
6
|
+
import { heldRowCells, heldRowMatches, readSessionRepoRowCells } from "./row-cells.js";
|
|
7
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
8
|
+
const IN_MEMORY_SESSION_REPO_OPTION_KEYS = optionKeys()({ rowCells: 0 });
|
|
6
9
|
export class InMemorySessionRepo {
|
|
7
10
|
rows = new Map();
|
|
8
11
|
touched = new Map();
|
|
12
|
+
rowCells;
|
|
13
|
+
constructor(options) {
|
|
14
|
+
const opts = receiveOptions(options, "InMemorySessionRepo", IN_MEMORY_SESSION_REPO_OPTION_KEYS);
|
|
15
|
+
this.rowCells = readSessionRepoRowCells("InMemorySessionRepo options", opts.rowCells);
|
|
16
|
+
}
|
|
9
17
|
async create(options = {}) {
|
|
10
18
|
if (options.id !== undefined) {
|
|
11
19
|
const existing = this.rows.get(options.id);
|
|
12
20
|
if (existing)
|
|
13
21
|
return existing.session;
|
|
14
22
|
}
|
|
15
|
-
const metadata =
|
|
23
|
+
const metadata = {
|
|
16
24
|
id: options.id ?? createSessionId(),
|
|
17
25
|
createdAt: createTimestamp(),
|
|
18
26
|
...incarnationCell(undefined),
|
|
19
27
|
...ownerCell(options.owner),
|
|
20
|
-
}
|
|
28
|
+
};
|
|
21
29
|
return this.lay(metadata, []).session;
|
|
22
30
|
}
|
|
23
31
|
async open(metadata) {
|
|
@@ -36,7 +44,7 @@ export class InMemorySessionRepo {
|
|
|
36
44
|
if (row === undefined)
|
|
37
45
|
return undefined;
|
|
38
46
|
const entries = await row.storage.getEntries();
|
|
39
|
-
return { metadata: row.metadata, head:
|
|
47
|
+
return { metadata: row.metadata, head: sessionHeadOf(row.metadata, resolveLeafId(entries)), entries };
|
|
40
48
|
}
|
|
41
49
|
async list() {
|
|
42
50
|
return [...this.rows.entries()].map(([id, row]) => {
|
|
@@ -50,7 +58,7 @@ export class InMemorySessionRepo {
|
|
|
50
58
|
}
|
|
51
59
|
async delete(metadata, expect) {
|
|
52
60
|
const row = this.rows.get(metadata.id);
|
|
53
|
-
if (!
|
|
61
|
+
if (!heldRowMatches(this.rowCells, expect, row?.metadata, () => row.storage.logMarkNow()))
|
|
54
62
|
throw rowExpectationMissed(metadata.id, "delete");
|
|
55
63
|
this.rows.delete(metadata.id);
|
|
56
64
|
this.touched.delete(metadata.id);
|
|
@@ -59,11 +67,11 @@ export class InMemorySessionRepo {
|
|
|
59
67
|
assertForkTarget(sourceMetadata.id, options.id);
|
|
60
68
|
const source = await this.open(sourceMetadata);
|
|
61
69
|
const forkedEntries = await getEntriesToFork(source.getStorage(), options);
|
|
62
|
-
const metadata =
|
|
70
|
+
const metadata = {
|
|
63
71
|
id: options.id ?? createSessionId(),
|
|
64
72
|
createdAt: createTimestamp(),
|
|
65
73
|
...forkRowCells(await source.getMetadata(), options.owner),
|
|
66
|
-
}
|
|
74
|
+
};
|
|
67
75
|
return this.lay(metadata, forkedEntries).session;
|
|
68
76
|
}
|
|
69
77
|
async exportEntries(sessionId) {
|
|
@@ -76,13 +84,13 @@ export class InMemorySessionRepo {
|
|
|
76
84
|
ownerCell(owner);
|
|
77
85
|
const validated = validateEntriesForImport(entries, options);
|
|
78
86
|
const prior = this.rows.get(sessionId);
|
|
79
|
-
if (!
|
|
87
|
+
if (!heldRowMatches(this.rowCells, options?.expect, prior?.metadata, () => prior.storage.logMarkNow()))
|
|
80
88
|
throw rowExpectationMissed(sessionId, "import");
|
|
81
|
-
const metadata =
|
|
82
|
-
|
|
83
|
-
return { owner: metadata.owner ?? null, incarnation: metadata.incarnation, leafId: resolveLeafId(validated) };
|
|
89
|
+
const { metadata } = this.lay(importRowCells(sessionId, owner, prior?.metadata, createTimestamp()), validated);
|
|
90
|
+
return sessionHeadOf(metadata, resolveLeafId(validated));
|
|
84
91
|
}
|
|
85
|
-
lay(
|
|
92
|
+
lay(given, entries) {
|
|
93
|
+
const metadata = frozenRow(heldRowCells(this.rowCells, given));
|
|
86
94
|
const storage = new InMemorySessionStorage({ metadata, entries });
|
|
87
95
|
const row = { session: toSession(storage), storage, metadata };
|
|
88
96
|
this.rows.set(metadata.id, row);
|
|
@@ -10,6 +10,9 @@ export declare function incarnationCell(existing: Pick<SessionMetadata, "incarna
|
|
|
10
10
|
* occupant, silently; a cell that is there but is not a token (`""`, a non-string) is an unknown occupant too and `disclose`
|
|
11
11
|
* is told once with the cell's shape (never its value). The cell never makes this throw; a throw from `disclose` propagates. */
|
|
12
12
|
export declare function readIncarnationCell(raw: unknown, disclose: (detail: string) => void): string | undefined;
|
|
13
|
+
/** What a value that is not a name (a non-empty string) is, said by its shape — an empty string, or a non-string by its kind. A
|
|
14
|
+
* disclosure of a bad cell or member says this, never the value (the value may be a secret and always reaches a log). */
|
|
15
|
+
export declare function notANameShape(raw: unknown): string;
|
|
13
16
|
/**
|
|
14
17
|
* THE reading of "do two readings of one session id's occupant cell (`SessionMetadata.incarnation`) name one occupant": each side is
|
|
15
18
|
* decoded as {@link readIncarnationCell} decodes a stored cell — a non-empty string is the token, anything else (absent, `""`, a
|
|
@@ -44,8 +47,15 @@ export declare function sessionRowMatches(expect: SessionRowExpectation | undefi
|
|
|
44
47
|
readonly owner?: string | null;
|
|
45
48
|
readonly incarnation?: string | undefined;
|
|
46
49
|
} | undefined, logNow: () => SessionLogMark): boolean;
|
|
50
|
+
/** The one shape reading of a {@link SessionRowExpectation} — the judge above reads through it, and so does a door that takes one from a
|
|
51
|
+
* caller before any write: a value not of the shape is a `TypeError` naming the member. */
|
|
52
|
+
export declare function readRowExpectation(expect: unknown): SessionRowExpectation;
|
|
47
53
|
/** The refusal of a conditional row write whose expectation the row does not meet: nothing was written. */
|
|
48
54
|
export declare function rowExpectationMissed(sessionId: string, what: string): SessionError;
|
|
55
|
+
/** The {@link SessionHead} of a row: the metadata's owner and occupant and the given leaf — the bundled repos' ONE construction of a head. The
|
|
56
|
+
* occupant key is laid down only when the row has a token: a host-held row and a row that predates the cell answer a head with no
|
|
57
|
+
* `incarnation` member at all (not one holding `undefined`), so "has the key" and "has an occupant" are one reading. */
|
|
58
|
+
export declare function sessionHeadOf(meta: Pick<SessionMetadata, "owner" | "incarnation">, leafId: string | null): SessionHead;
|
|
49
59
|
/** The {@link SessionHead} a session object shows: its metadata's owner and occupant and its storage's leaf, off that one object. */
|
|
50
60
|
export declare function headOfSession(session: Session): Promise<SessionHead>;
|
|
51
61
|
/** The {@link SessionMetadata.owner} cell the write creating a row records: `owner` (a principal name, or `null`; `undefined` = none
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { SessionError, } from "../harness/types.js";
|
|
2
2
|
import { StoredSession } from "./session.js";
|
|
3
3
|
import { uuidv7 } from "./uuid.js";
|
|
4
|
-
import { principalNameFault, principalNameOf } from "../../core/principal-name.js";
|
|
4
|
+
import { PRINCIPAL_NAME_SPELLING, principalNameFault, principalNameOf } from "../../core/principal-name.js";
|
|
5
5
|
import { receiptRefusal } from "../../core/own-property-receipt.js";
|
|
6
6
|
import { randomUUID } from "node:crypto";
|
|
7
7
|
export function createSessionId() {
|
|
@@ -17,9 +17,12 @@ export function readIncarnationCell(raw, disclose) {
|
|
|
17
17
|
return raw;
|
|
18
18
|
if (raw === undefined || raw === null)
|
|
19
19
|
return undefined;
|
|
20
|
-
disclose(`the incarnation cell holds ${
|
|
20
|
+
disclose(`the incarnation cell holds ${notANameShape(raw)} — read as an unknown occupant`);
|
|
21
21
|
return undefined;
|
|
22
22
|
}
|
|
23
|
+
export function notANameShape(raw) {
|
|
24
|
+
return raw === "" ? "an empty string" : nonStringShape(raw);
|
|
25
|
+
}
|
|
23
26
|
function isOccupantToken(raw) {
|
|
24
27
|
return typeof raw === "string" && raw !== "";
|
|
25
28
|
}
|
|
@@ -47,7 +50,7 @@ export function sessionRowMatches(expect, row, logNow) {
|
|
|
47
50
|
const now = logNow();
|
|
48
51
|
return now.length === want.log.length && now.lastEntryId === want.log.lastEntryId;
|
|
49
52
|
}
|
|
50
|
-
function readRowExpectation(expect) {
|
|
53
|
+
export function readRowExpectation(expect) {
|
|
51
54
|
if (typeof expect !== "object" || expect === null)
|
|
52
55
|
throw new TypeError(`a session row expectation must be an object { row, log? }, got ${expect === null ? "null" : typeof expect}`);
|
|
53
56
|
const { row, log } = expect;
|
|
@@ -76,9 +79,12 @@ function readLogMark(log) {
|
|
|
76
79
|
export function rowExpectationMissed(sessionId, what) {
|
|
77
80
|
return new SessionError("conflict", `session ${sessionId} is not the row the ${what} expected (it was deleted, created again, or written since it was read) — nothing was written; read the row again`);
|
|
78
81
|
}
|
|
82
|
+
export function sessionHeadOf(meta, leafId) {
|
|
83
|
+
return { owner: meta.owner ?? null, ...(meta.incarnation !== undefined ? { incarnation: meta.incarnation } : {}), leafId };
|
|
84
|
+
}
|
|
79
85
|
export async function headOfSession(session) {
|
|
80
86
|
const meta = await session.getMetadata();
|
|
81
|
-
return
|
|
87
|
+
return sessionHeadOf(meta, await session.getStorage().getLeafId());
|
|
82
88
|
}
|
|
83
89
|
function notAnOwnerShape(raw) {
|
|
84
90
|
return typeof raw === "string" ? principalNameFault(raw) : nonStringShape(raw);
|
|
@@ -88,7 +94,7 @@ export function ownerCell(owner) {
|
|
|
88
94
|
return { owner: null };
|
|
89
95
|
const name = principalNameOf(owner);
|
|
90
96
|
if (name === undefined)
|
|
91
|
-
throw new TypeError(`session owner must be a principal name (
|
|
97
|
+
throw new TypeError(`session owner must be a principal name (${PRINCIPAL_NAME_SPELLING}) or null (anonymous), got ${notAnOwnerShape(owner)}`);
|
|
92
98
|
return { owner: name };
|
|
93
99
|
}
|
|
94
100
|
export function importRowCells(sessionId, owner, existing, createdAt) {
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { SessionLogMark, SessionRowExpectation } from "../harness/types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Who holds a session row's two occupant cells, {@link SessionMetadata.incarnation} and {@link SessionMetadata.forkedFromIncarnation}:
|
|
4
|
+
* - `"engine"` — the repo does: it mints the token in the write that creates a row, keeps it on every later write, and hands both cells
|
|
5
|
+
* out on every read of the row (its sessions' metadata, its head, its listing). The default of every bundled repo.
|
|
6
|
+
* - `"host"` — the host does, in a store of its own: the repo is a content repo. No write of it lays either cell down, no read of it
|
|
7
|
+
* hands either out (a cell a row holds from an earlier engine-mode write is not read), and a conditional write is judged on the
|
|
8
|
+
* owner and the log alone ({@link heldRowMatches}). The occupant every engine leg compares ({@link sameOccupant}) is then the
|
|
9
|
+
* one the session store the host builds over the repo puts on the metadata its sessions answer and on its head read; a store
|
|
10
|
+
* that hands this repo's rows out as they stand hands out rows naming no occupant, so `TtlSessionStore` refuses such a repo.
|
|
11
|
+
*
|
|
12
|
+
* One reading ({@link readSessionRepoRowCells}) and two laws: what a row holds ({@link heldRowCells}) and what a write may expect of it
|
|
13
|
+
* ({@link heldRowMatches}). A repo reads its mode once and calls those two wherever a row is laid down, read back or judged.
|
|
14
|
+
*/
|
|
15
|
+
export type SessionRepoRowCells = "engine" | "host";
|
|
16
|
+
/** THE reading of a repo's {@link SessionRepoRowCells}: absent is `"engine"` (the cells are the repo's, as they always were); a value
|
|
17
|
+
* outside the two words is refused `config.invalid_argument` naming `where`, never read as either. */
|
|
18
|
+
export declare function readSessionRepoRowCells(where: string, raw: unknown): SessionRepoRowCells;
|
|
19
|
+
/** The row as a repo of `mode` holds it — what it writes and what it reads back: in `"engine"` mode the row as given; in `"host"` mode
|
|
20
|
+
* the row without its two occupant cells, whatever the row was given or read with. */
|
|
21
|
+
export declare function heldRowCells<T extends {
|
|
22
|
+
readonly incarnation?: unknown;
|
|
23
|
+
readonly forkedFromIncarnation?: unknown;
|
|
24
|
+
}>(mode: SessionRepoRowCells, row: T): Omit<T, "incarnation" | "forkedFromIncarnation">;
|
|
25
|
+
/** {@link sessionRowMatches} as a repo of `mode` judges it. In `"host"` mode the row holds no occupant cell, so the owner and (when the log
|
|
26
|
+
* binds) the log are what is judged, and an expectation that names an occupant token is refused (a `TypeError`): that question is the
|
|
27
|
+
* host's, and this repo cannot answer it — read as a miss it would say the row was written since, read as a match it would say the
|
|
28
|
+
* occupant was checked. An expectation that is not of the shape {@link SessionRowExpectation} is refused as `sessionRowMatches` refuses it. */
|
|
29
|
+
export declare function heldRowMatches(mode: SessionRepoRowCells, expect: SessionRowExpectation | undefined, row: {
|
|
30
|
+
readonly owner?: string | null;
|
|
31
|
+
readonly incarnation?: string | undefined;
|
|
32
|
+
} | undefined, logNow: () => SessionLogMark): boolean;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { readRowExpectation, sessionRowMatches } from "./repo-utils.js";
|
|
2
|
+
import { receiptRefusal } from "../../core/own-property-receipt.js";
|
|
3
|
+
import { describeRejectedValue } from "../../core/tool-search-setting.js";
|
|
4
|
+
export function readSessionRepoRowCells(where, raw) {
|
|
5
|
+
if (raw === undefined || raw === "engine")
|
|
6
|
+
return "engine";
|
|
7
|
+
if (raw === "host")
|
|
8
|
+
return "host";
|
|
9
|
+
throw receiptRefusal(`${where}.rowCells must be "engine" (the repo holds a row's occupant cells) or "host" (the host holds them) when given (got ${describeRejectedValue(raw)})`);
|
|
10
|
+
}
|
|
11
|
+
export function heldRowCells(mode, row) {
|
|
12
|
+
if (mode === "engine")
|
|
13
|
+
return row;
|
|
14
|
+
const { incarnation: _incarnation, forkedFromIncarnation: _forkedFromIncarnation, ...rest } = row;
|
|
15
|
+
return rest;
|
|
16
|
+
}
|
|
17
|
+
export function heldRowMatches(mode, expect, row, logNow) {
|
|
18
|
+
if (mode === "host" && expect !== undefined) {
|
|
19
|
+
const want = readRowExpectation(expect);
|
|
20
|
+
if (want.row !== null && want.row.incarnation !== undefined) {
|
|
21
|
+
throw new TypeError(`a session row expectation names an occupant (row.incarnation) to a repo whose occupant cells the host holds (rowCells "host") — this repo judges a conditional write on the row's owner and log; leave the occupant out and judge it in the host's own store`);
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
return sessionRowMatches(expect, row, logNow);
|
|
25
|
+
}
|