@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,6 +1,7 @@
|
|
|
1
1
|
import { closeSync, existsSync, fstatSync, openSync, readdirSync, rmSync, utimesSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, leafIdAfterEntry, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, replayLossText, resolveLeafId, rowExpectationMissed, sessionLogMarkOf,
|
|
3
|
+
import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, leafIdAfterEntry, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, replayLossText, resolveLeafId, rowExpectationMissed, sessionHeadOf, sessionLogMarkOf, heldRowCells, heldRowMatches, readSessionRepoRowCells, uuidv7, validateEntriesForImport, } from "../../internal/harness.js";
|
|
4
|
+
import { readUnreadableDeleteId, rowUnreadableNow } from "../../core/session.js";
|
|
4
5
|
import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, firstJsonlRecord, lastJsonlRecord, readJsonlRecords, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
|
|
5
6
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
6
7
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
@@ -72,14 +73,16 @@ class FileSessionStorage extends BaseSessionStorage {
|
|
|
72
73
|
this.recordEntry(entry);
|
|
73
74
|
}
|
|
74
75
|
}
|
|
75
|
-
const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
76
|
+
const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, rowCells: 0 });
|
|
76
77
|
export class FileSessionRepo {
|
|
77
78
|
dir;
|
|
78
79
|
tmpDir;
|
|
79
80
|
onCorruptRead;
|
|
80
81
|
joined = new Map();
|
|
82
|
+
rowCells;
|
|
81
83
|
constructor(root, options) {
|
|
82
84
|
const opts = receiveOptions(options, "FileSessionRepo", FILE_SESSION_REPO_OPTION_KEYS);
|
|
85
|
+
this.rowCells = readSessionRepoRowCells("FileSessionRepo options", opts.rowCells);
|
|
83
86
|
assertAdoptionBootGate(root, "FileSessionRepo");
|
|
84
87
|
this.dir = join(root, "sessions");
|
|
85
88
|
this.tmpDir = join(root, "tmp");
|
|
@@ -132,7 +135,7 @@ export class FileSessionRepo {
|
|
|
132
135
|
metaLineOf(id, first, skipped = () => "") {
|
|
133
136
|
if (first === undefined || first.kind !== "meta")
|
|
134
137
|
throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
|
|
135
|
-
const { placement: raw, ...cells } = first;
|
|
138
|
+
const { placement: raw, ...cells } = heldRowCells(this.rowCells, first);
|
|
136
139
|
const placement = readPlacementCell(raw, id);
|
|
137
140
|
return { ...cells, ...(placement !== undefined ? { placement } : {}) };
|
|
138
141
|
}
|
|
@@ -142,7 +145,7 @@ export class FileSessionRepo {
|
|
|
142
145
|
headNow(sessionId) {
|
|
143
146
|
return this.atRow(sessionId, (fd, size, meta) => {
|
|
144
147
|
const last = lastJsonlRecord(fd, size, (r) => r.kind === "entry", SESSION_LINE_JUDGE);
|
|
145
|
-
return
|
|
148
|
+
return sessionHeadOf(meta, last === undefined ? null : leafIdAfterEntry(last.entry));
|
|
146
149
|
});
|
|
147
150
|
}
|
|
148
151
|
async readRow(sessionId) {
|
|
@@ -159,7 +162,7 @@ export class FileSessionRepo {
|
|
|
159
162
|
throw err;
|
|
160
163
|
}
|
|
161
164
|
const { meta, entries } = read;
|
|
162
|
-
return { metadata: meta, head:
|
|
165
|
+
return { metadata: meta, head: sessionHeadOf(meta, resolveLeafId(entries)), entries };
|
|
163
166
|
}
|
|
164
167
|
rowOf(sessionId) {
|
|
165
168
|
const path = this.pathFor(sessionId);
|
|
@@ -239,7 +242,7 @@ export class FileSessionRepo {
|
|
|
239
242
|
if (!existsSync(path)) {
|
|
240
243
|
const owner = ownerCell(options.owner);
|
|
241
244
|
const placement = placementCellToWrite(options.placement, id, Date.now());
|
|
242
|
-
const meta = { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...incarnationCell(undefined), ...owner };
|
|
245
|
+
const meta = heldRowCells(this.rowCells, { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...incarnationCell(undefined), ...owner });
|
|
243
246
|
try {
|
|
244
247
|
writeThenLink(path, `${JSON.stringify({ kind: "meta", ...meta })}\n`);
|
|
245
248
|
}
|
|
@@ -326,14 +329,24 @@ export class FileSessionRepo {
|
|
|
326
329
|
return this.atFirstRecord(sessionId, (_fd, _size, first) => this.metaLineOf(sessionId, first).placement);
|
|
327
330
|
}
|
|
328
331
|
async delete(metadata, expect) {
|
|
329
|
-
if (expect !== undefined && !
|
|
332
|
+
if (expect !== undefined && !heldRowMatches(this.rowCells, expect, this.headNow(metadata.id), () => sessionLogMarkOf(this.read(metadata.id).entries)))
|
|
330
333
|
throw rowExpectationMissed(metadata.id, "delete");
|
|
331
|
-
|
|
334
|
+
this.removeRow(metadata.id);
|
|
335
|
+
}
|
|
336
|
+
async deleteUnreadable(sessionId) {
|
|
337
|
+
const id = readUnreadableDeleteId("SessionRepo.deleteUnreadable", sessionId);
|
|
338
|
+
if (!rowUnreadableNow(() => this.headNow(id)))
|
|
339
|
+
return false;
|
|
340
|
+
this.removeRow(id);
|
|
341
|
+
return true;
|
|
342
|
+
}
|
|
343
|
+
removeRow(id) {
|
|
344
|
+
evictSharedSessionStorage(canonicalStoreKey(this.pathFor(id)));
|
|
332
345
|
try {
|
|
333
|
-
rmSync(this.pathFor(
|
|
346
|
+
rmSync(this.pathFor(id), { force: true });
|
|
334
347
|
}
|
|
335
348
|
catch (err) {
|
|
336
|
-
throw new SessionError("storage", `session ${
|
|
349
|
+
throw new SessionError("storage", `session ${id} could not be deleted: ${thrownText(err)}`, err instanceof Error ? err : undefined);
|
|
337
350
|
}
|
|
338
351
|
}
|
|
339
352
|
async fork(sourceMetadata, options = {}) {
|
|
@@ -344,7 +357,7 @@ export class FileSessionRepo {
|
|
|
344
357
|
const createdAt = new Date().toISOString();
|
|
345
358
|
const path = this.pathFor(id);
|
|
346
359
|
const placement = placementCellToWrite(options.placement, id, Date.now());
|
|
347
|
-
const meta = { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...forkRowCells(await source.getMetadata(), options.owner) };
|
|
360
|
+
const meta = heldRowCells(this.rowCells, { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...forkRowCells(await source.getMetadata(), options.owner) });
|
|
348
361
|
const lines = [JSON.stringify({ kind: "meta", ...meta })];
|
|
349
362
|
for (const entry of forked) {
|
|
350
363
|
lines.push(JSON.stringify({ kind: "entry", entry }));
|
|
@@ -359,15 +372,15 @@ export class FileSessionRepo {
|
|
|
359
372
|
async importEntries(sessionId, owner, entries, options) {
|
|
360
373
|
const validated = validateEntriesForImport(entries, options);
|
|
361
374
|
const prior = this.rowNow(sessionId);
|
|
362
|
-
if (!
|
|
375
|
+
if (!heldRowMatches(this.rowCells, options?.expect, prior?.metadata, () => sessionLogMarkOf(prior.entries)))
|
|
363
376
|
throw rowExpectationMissed(sessionId, "import");
|
|
364
|
-
const meta = importRowCells(sessionId, owner, prior?.metadata, new Date().toISOString());
|
|
377
|
+
const meta = heldRowCells(this.rowCells, importRowCells(sessionId, owner, prior?.metadata, new Date().toISOString()));
|
|
365
378
|
evictSharedSessionStorage(canonicalStoreKey(this.pathFor(sessionId)));
|
|
366
379
|
const lines = [JSON.stringify({ kind: "meta", ...meta })];
|
|
367
380
|
for (const entry of validated) {
|
|
368
381
|
lines.push(JSON.stringify({ kind: "entry", entry }));
|
|
369
382
|
}
|
|
370
383
|
atomicWriteFile(this.tmpDir, this.pathFor(sessionId), `${lines.join("\n")}\n`);
|
|
371
|
-
return
|
|
384
|
+
return sessionHeadOf(meta, resolveLeafId(validated));
|
|
372
385
|
}
|
|
373
386
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { join, resolve } from "node:path";
|
|
2
2
|
import { readFileSync } from "node:fs";
|
|
3
|
-
import {
|
|
3
|
+
import { admitTaskListItem, listStoredTaskListEntry, readStoredTaskListItem } from "../../tools/task-list.js";
|
|
4
4
|
import { canonicalStoreKey, atomicWriteFile, ensureDir } from "./fs-atomic.js";
|
|
5
5
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
6
6
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
@@ -54,18 +54,25 @@ export function createFileTaskListStore(root, opts) {
|
|
|
54
54
|
return run;
|
|
55
55
|
};
|
|
56
56
|
const locked = lockedOn;
|
|
57
|
+
const entryOf = (doc, id) => {
|
|
58
|
+
if (!Object.prototype.hasOwnProperty.call(doc.tasks, id))
|
|
59
|
+
return undefined;
|
|
60
|
+
return snap(readStoredTaskListItem(doc.tasks[id], id, discloseEntry));
|
|
61
|
+
};
|
|
62
|
+
const discloseEntry = (reason) => disclose?.({ kind: "file", path, reason });
|
|
63
|
+
const listOf = (doc) => Object.entries(doc.tasks).map(([id, t]) => {
|
|
64
|
+
const entry = listStoredTaskListEntry(t, id, discloseEntry);
|
|
65
|
+
return "rowVerdict" in entry ? entry : snap(entry);
|
|
66
|
+
});
|
|
67
|
+
const write = (id, item) => {
|
|
68
|
+
const admitted = admitTaskListItem(item, id);
|
|
69
|
+
const doc = load();
|
|
70
|
+
doc.tasks[id] = snap(admitted);
|
|
71
|
+
save(doc);
|
|
72
|
+
};
|
|
57
73
|
const raw = {
|
|
58
|
-
get: (id) =>
|
|
59
|
-
|
|
60
|
-
return t ? snap(t) : undefined;
|
|
61
|
-
},
|
|
62
|
-
set: (id, item) => {
|
|
63
|
-
if (item.metadata)
|
|
64
|
-
assertJsonMetadata(item.metadata);
|
|
65
|
-
const doc = load();
|
|
66
|
-
doc.tasks[id] = snap(normalizeTaskShape(item));
|
|
67
|
-
save(doc);
|
|
68
|
-
},
|
|
74
|
+
get: (id) => entryOf(load(), id),
|
|
75
|
+
set: (id, item) => write(id, item),
|
|
69
76
|
delete: (id) => {
|
|
70
77
|
const doc = load();
|
|
71
78
|
if (!(id in doc.tasks))
|
|
@@ -74,7 +81,7 @@ export function createFileTaskListStore(root, opts) {
|
|
|
74
81
|
save(doc);
|
|
75
82
|
return true;
|
|
76
83
|
},
|
|
77
|
-
list: () =>
|
|
84
|
+
list: () => listOf(load()),
|
|
78
85
|
allocateId: () => {
|
|
79
86
|
const doc = load();
|
|
80
87
|
const id = String(doc.nextId);
|
|
@@ -85,17 +92,8 @@ export function createFileTaskListStore(root, opts) {
|
|
|
85
92
|
};
|
|
86
93
|
const snap = (t) => structuredClone(t);
|
|
87
94
|
return {
|
|
88
|
-
get: (id) => locked(() =>
|
|
89
|
-
|
|
90
|
-
return t ? snap(t) : undefined;
|
|
91
|
-
}),
|
|
92
|
-
set: (id, item) => locked(() => {
|
|
93
|
-
if (item.metadata)
|
|
94
|
-
assertJsonMetadata(item.metadata);
|
|
95
|
-
const doc = load();
|
|
96
|
-
doc.tasks[id] = snap(normalizeTaskShape(item));
|
|
97
|
-
save(doc);
|
|
98
|
-
}),
|
|
95
|
+
get: (id) => locked(() => entryOf(load(), id)),
|
|
96
|
+
set: (id, item) => locked(() => write(id, item)),
|
|
99
97
|
delete: (id) => locked(() => {
|
|
100
98
|
const doc = load();
|
|
101
99
|
if (!(id in doc.tasks))
|
|
@@ -104,7 +102,7 @@ export function createFileTaskListStore(root, opts) {
|
|
|
104
102
|
save(doc);
|
|
105
103
|
return true;
|
|
106
104
|
}),
|
|
107
|
-
list: () => locked(() =>
|
|
105
|
+
list: () => locked(() => listOf(load())),
|
|
108
106
|
allocateId: () => locked(() => {
|
|
109
107
|
const doc = load();
|
|
110
108
|
const id = String(doc.nextId);
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { type RetentionDeclaration } from "../../core/retention.js";
|
|
2
|
-
import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
|
|
2
|
+
import type { ToolResultBytes, ToolResultDeletionReport, ToolResultEntryKind, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
|
|
3
3
|
import { type CorruptReadInfo } from "./corrupt-read-sink.js";
|
|
4
4
|
/**
|
|
5
|
-
* design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE file per ref
|
|
5
|
+
* design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE content file per ref — `<stem>.txt` for text,
|
|
6
|
+
* `<stem>.bin` for the byte arm ({@link FileToolResultStore.putBytes}), never both — beside one owner record.
|
|
6
7
|
*
|
|
7
8
|
* `ref = tr_<sessionId>~<toolCallId>` (engine-minted, already globally unique; the separator is the
|
|
8
9
|
* backlog #119 injective form). `put` is an `O_CREAT|O_EXCL` create → on `EEXIST` it no-ops
|
|
@@ -48,11 +49,21 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
48
49
|
/** The directory a ref's files live in, and their shared stem. See {@link encodeRefFilename} for why
|
|
49
50
|
* a FOLDED name gets its own directory instead of sharing one with identity names. */
|
|
50
51
|
private locate;
|
|
52
|
+
/** The content file of `ref`'s entry of `kind` — one name per kind in {@link CONTENT_SUFFIX}, beside one owner record. */
|
|
51
53
|
private pathFor;
|
|
54
|
+
/** The cross-kind half of the write-once election: a ref whose stem already holds the OTHER kind's content file refuses this
|
|
55
|
+
* write, typed, before anything is linked — one stem, one content file. Under the data root's single writer the check and
|
|
56
|
+
* the link that follows are adjacent synchronous steps. */
|
|
57
|
+
private refuseOtherKind;
|
|
52
58
|
/** #119 — the provenance sidecar's path. Same directory and stem as {@link pathFor}, so the pair is
|
|
53
59
|
* found by one encoding step and a ref that cannot be encoded has no sidecar either. */
|
|
54
60
|
private ownerPathFor;
|
|
55
61
|
put(ref: string, content: string, provenance?: ToolResultProvenance): void;
|
|
62
|
+
/** The byte arm's write (interface: {@link ToolResultStore.putBytes}): the same election as {@link put}, the content file
|
|
63
|
+
* `<stem>.bin`, the media type in the owner record. */
|
|
64
|
+
putBytes(ref: string, bytes: Uint8Array, provenance: ToolResultProvenance, mediaType?: string): void;
|
|
65
|
+
/** The one write-once election both kinds run: refuse the other kind, link the content file, then publish the owner record. */
|
|
66
|
+
private publish;
|
|
56
67
|
/** #119 — the recorded owner, or `undefined` for an unknown ref AND for a stored-but-unowned one.
|
|
57
68
|
* Lenient by design on the READ face (see {@link readOwnerFile}). */
|
|
58
69
|
ownerOf(ref: string): ToolResultProvenance | undefined;
|
|
@@ -71,6 +82,10 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
71
82
|
offset?: number;
|
|
72
83
|
limit?: number;
|
|
73
84
|
}): ToolResultSlice | undefined;
|
|
85
|
+
/** The byte arm's read (interface: {@link ToolResultStore.bytesOf}): the `.bin` file's size, the media type its owner record
|
|
86
|
+
* carries, and its bytes when asked. `undefined` for a ref holding no bytes — and, as on {@link get}'s face, for a ref no write
|
|
87
|
+
* could store. */
|
|
88
|
+
bytesOf(ref: string): ToolResultBytes | undefined;
|
|
74
89
|
/**
|
|
75
90
|
* Erase every entry owned by `sessionId` (interface: {@link ToolResultStore.deleteBySession}). Without
|
|
76
91
|
* it a session deletion leaves this store's files on disk for the lifetime of the data root.
|
|
@@ -83,7 +98,9 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
83
98
|
* stamped one, is ignored — it narrows the same session.
|
|
84
99
|
*
|
|
85
100
|
* Both namespaces are swept: identity-named files in the store dir (refs a caller minted inside the
|
|
86
|
-
* filename charset, and everything written before the injective mint) and {@link FOLDED_SUBDIR}
|
|
101
|
+
* filename charset, and everything written before the injective mint) and {@link FOLDED_SUBDIR}; in each, only the names
|
|
102
|
+
* this store writes ({@link entryPartOf}) — a text or a byte entry is removed alike, and a staging file is never touched here
|
|
103
|
+
* (it has no owner; the age sweeps remove a dead write's).
|
|
87
104
|
*
|
|
88
105
|
* Removal order is CONTENT then SIDECAR, and it is load-bearing. Interrupted after the content unlink,
|
|
89
106
|
* the next sweep still finds the sidecar, matches the same session and converges; interrupted after a
|
|
@@ -114,10 +131,12 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
114
131
|
/**
|
|
115
132
|
* Age out the entries stored more than `maxAgeMs` before `now` (interface: {@link ToolResultStore.reap}). An entry's
|
|
116
133
|
* age is its content file's modification time: the write-once publication sets it and nothing rewrites the file.
|
|
117
|
-
* Both namespaces are swept, and only names this store writes are judged
|
|
134
|
+
* Both namespaces are swept, and only names this store writes are judged ({@link entryPartOf}): text and byte entries alike.
|
|
135
|
+
* Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
|
|
118
136
|
* record whose content is already gone — the leftover of an interrupted pass, or of a session sweep — is removed
|
|
119
|
-
* once it is past the cutoff too, and is not counted (it was not an entry)
|
|
120
|
-
*
|
|
137
|
+
* once it is past the cutoff too, and is not counted (it was not an entry); so is a staging file a write left behind when
|
|
138
|
+
* its process died between opening it and linking it (a live write's staging file is as new as the write). Synchronous: under
|
|
139
|
+
* the data root's single writer nothing interleaves with it.
|
|
121
140
|
*/
|
|
122
141
|
reap(now: number, opts?: {
|
|
123
142
|
maxAgeMs?: number;
|
|
@@ -127,7 +146,8 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
127
146
|
* content file with no owner record beside it. A present owner record keeps its entry whether it reads or not, and age is the
|
|
128
147
|
* content file's modification time, as {@link reap} reads it — so a `put` caught between its content and its owner record (its
|
|
129
148
|
* content is as new as the write) is never past a cutoff in the past. The owner record is looked for again just before the
|
|
130
|
-
* unlink, so one that landed after the listing still keeps its entry. Both namespaces; names this store writes only
|
|
149
|
+
* unlink, so one that landed after the listing still keeps its entry. Both namespaces; names this store writes only
|
|
150
|
+
* ({@link entryPartOf}), text and byte entries alike; a dead write's staging file past the cutoff goes too, uncounted, as in {@link reap}.
|
|
131
151
|
*/
|
|
132
152
|
deleteUnattributable(cutoffMs: number): number;
|
|
133
153
|
/**
|
|
@@ -149,3 +169,21 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
149
169
|
* that ref's own location is this file, else — for an identity-named entry — the stem itself. */
|
|
150
170
|
private refOfEntry;
|
|
151
171
|
}
|
|
172
|
+
/** One file of this store's, as {@link entryPartOf} reads its name. */
|
|
173
|
+
export type ToolResultEntryPart = {
|
|
174
|
+
readonly stem: string;
|
|
175
|
+
readonly part: "content";
|
|
176
|
+
readonly kind: ToolResultEntryKind;
|
|
177
|
+
} | {
|
|
178
|
+
readonly stem: string;
|
|
179
|
+
readonly part: "owner";
|
|
180
|
+
} | {
|
|
181
|
+
readonly stem: string;
|
|
182
|
+
readonly part: "staging";
|
|
183
|
+
};
|
|
184
|
+
/**
|
|
185
|
+
* THE one reading of "is this file one of this store's, and which part of which entry": every sweep and the write's path
|
|
186
|
+
* composition read names through this table and nothing else. A name it answers `undefined` for is not an entry, whatever its
|
|
187
|
+
* suffix — no sweep deletes it and no count includes it (`folded` = the {@link FOLDED_SUBDIR} namespace, whose stems are digests).
|
|
188
|
+
*/
|
|
189
|
+
export declare function entryPartOf(name: string, folded: boolean): ToolResultEntryPart | undefined;
|
|
@@ -32,19 +32,34 @@ export class FileToolResultStore {
|
|
|
32
32
|
stem: sanitizePathComponent(encoded.stem),
|
|
33
33
|
};
|
|
34
34
|
}
|
|
35
|
-
pathFor(ref) {
|
|
35
|
+
pathFor(ref, kind = "text") {
|
|
36
36
|
const { dir, stem } = this.locate(ref);
|
|
37
|
-
return join(dir, `${stem}${CONTENT_SUFFIX}`);
|
|
37
|
+
return join(dir, `${stem}${CONTENT_SUFFIX[kind]}`);
|
|
38
|
+
}
|
|
39
|
+
refuseOtherKind(ref, incoming, provenance) {
|
|
40
|
+
const other = incoming === "text" ? "bytes" : "text";
|
|
41
|
+
if (modifiedAt(this.pathFor(ref, other)) === undefined)
|
|
42
|
+
return;
|
|
43
|
+
throw new ToolResultRefConflictError(ref, this.readOwnerFile(ref, { loud: false }), provenance, { stored: other, incoming });
|
|
38
44
|
}
|
|
39
45
|
ownerPathFor(ref) {
|
|
40
46
|
const { dir, stem } = this.locate(ref);
|
|
41
47
|
return join(dir, `${stem}${OWNER_SUFFIX}`);
|
|
42
48
|
}
|
|
43
49
|
put(ref, content, provenance) {
|
|
50
|
+
this.publish(ref, "text", content, provenance, undefined);
|
|
51
|
+
}
|
|
52
|
+
putBytes(ref, bytes, provenance, mediaType) {
|
|
53
|
+
if (!(bytes instanceof Uint8Array))
|
|
54
|
+
throw new TypeError(`FileToolResultStore.putBytes: bytes must be a Uint8Array (got ${typeof bytes})`);
|
|
55
|
+
this.publish(ref, "bytes", bytes, provenance, typeof mediaType === "string" ? mediaType : undefined);
|
|
56
|
+
}
|
|
57
|
+
publish(ref, kind, content, provenance, mediaType) {
|
|
44
58
|
assertSafeToolResultRef(ref);
|
|
59
|
+
this.refuseOtherKind(ref, kind, provenance);
|
|
45
60
|
let won;
|
|
46
61
|
try {
|
|
47
|
-
writeThenLink(this.pathFor(ref), content);
|
|
62
|
+
writeThenLink(this.pathFor(ref, kind), content);
|
|
48
63
|
won = true;
|
|
49
64
|
}
|
|
50
65
|
catch (err) {
|
|
@@ -60,11 +75,11 @@ export class FileToolResultStore {
|
|
|
60
75
|
if (provenance === undefined)
|
|
61
76
|
return;
|
|
62
77
|
try {
|
|
63
|
-
this.writeOwnerFile(ref, provenance);
|
|
78
|
+
this.writeOwnerFile(ref, provenance, mediaType);
|
|
64
79
|
}
|
|
65
80
|
catch (err) {
|
|
66
81
|
if (err instanceof ToolResultRefConflictError)
|
|
67
|
-
unlinkIfAbsentOk(this.pathFor(ref));
|
|
82
|
+
unlinkIfAbsentOk(this.pathFor(ref, kind));
|
|
68
83
|
throw err;
|
|
69
84
|
}
|
|
70
85
|
}
|
|
@@ -103,9 +118,9 @@ export class FileToolResultStore {
|
|
|
103
118
|
this.disclose(ownerPath, "not-an-object: owner sidecar is present but is not an owner record — read as unowned");
|
|
104
119
|
return undefined;
|
|
105
120
|
}
|
|
106
|
-
writeOwnerFile(ref, provenance) {
|
|
121
|
+
writeOwnerFile(ref, provenance, mediaType) {
|
|
107
122
|
try {
|
|
108
|
-
writeThenLink(this.ownerPathFor(ref), JSON.stringify({ ...normalizeToolResultProvenance(provenance), ref }));
|
|
123
|
+
writeThenLink(this.ownerPathFor(ref), JSON.stringify({ ...normalizeToolResultProvenance(provenance), ref, ...(mediaType !== undefined ? { mediaType } : {}) }));
|
|
109
124
|
}
|
|
110
125
|
catch (err) {
|
|
111
126
|
if (err.code !== "EEXIST")
|
|
@@ -132,6 +147,27 @@ export class FileToolResultStore {
|
|
|
132
147
|
const content = limit != null ? full.slice(offset, offset + limit) : full.slice(offset);
|
|
133
148
|
return { content, offset, totalChars: full.length };
|
|
134
149
|
}
|
|
150
|
+
bytesOf(ref) {
|
|
151
|
+
let path;
|
|
152
|
+
try {
|
|
153
|
+
path = this.pathFor(ref, "bytes");
|
|
154
|
+
}
|
|
155
|
+
catch {
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
let size;
|
|
159
|
+
try {
|
|
160
|
+
size = statSync(path).size;
|
|
161
|
+
}
|
|
162
|
+
catch (err) {
|
|
163
|
+
if (err.code === "ENOENT")
|
|
164
|
+
return undefined;
|
|
165
|
+
throw err;
|
|
166
|
+
}
|
|
167
|
+
const record = readOwnerFileAt(this.ownerPathFor(ref));
|
|
168
|
+
const mediaType = typeof record === "string" ? undefined : record.mediaType;
|
|
169
|
+
return { byteLength: size, ...(mediaType !== undefined ? { mediaType } : {}), bytes: () => new Uint8Array(readFileSync(path)) };
|
|
170
|
+
}
|
|
135
171
|
deleteBySession(sessionId) {
|
|
136
172
|
let deleted = 0;
|
|
137
173
|
let unattributable = 0;
|
|
@@ -145,9 +181,11 @@ export class FileToolResultStore {
|
|
|
145
181
|
continue;
|
|
146
182
|
throw err;
|
|
147
183
|
}
|
|
184
|
+
const folded = dir !== this.dir;
|
|
148
185
|
const listed = new Set(names);
|
|
149
186
|
for (const name of names) {
|
|
150
|
-
|
|
187
|
+
const part = entryPartOf(name, folded);
|
|
188
|
+
if (part?.part !== "owner")
|
|
151
189
|
continue;
|
|
152
190
|
const owner = readOwnerAt(join(dir, name));
|
|
153
191
|
if (owner === "gone")
|
|
@@ -158,28 +196,28 @@ export class FileToolResultStore {
|
|
|
158
196
|
}
|
|
159
197
|
if (owner.sessionId !== sessionId)
|
|
160
198
|
continue;
|
|
161
|
-
const stem =
|
|
199
|
+
const { stem } = part;
|
|
162
200
|
const sidecarPath = join(dir, name);
|
|
163
|
-
|
|
164
|
-
unlinkIfAbsentOk(contentPath);
|
|
201
|
+
unlinkContentOf(dir, stem);
|
|
165
202
|
unlinkIfAbsentOk(sidecarPath);
|
|
166
203
|
const republished = readOwnerAt(sidecarPath);
|
|
167
204
|
if (republished === "gone") {
|
|
168
|
-
|
|
205
|
+
unlinkContentOf(dir, stem);
|
|
169
206
|
}
|
|
170
207
|
else if (republished === "damaged") {
|
|
171
208
|
unattributable++;
|
|
172
209
|
}
|
|
173
210
|
else if (republished.sessionId === sessionId) {
|
|
174
|
-
|
|
211
|
+
unlinkContentOf(dir, stem);
|
|
175
212
|
unlinkIfAbsentOk(sidecarPath);
|
|
176
213
|
}
|
|
177
214
|
deleted++;
|
|
178
215
|
}
|
|
179
216
|
for (const name of names) {
|
|
180
|
-
|
|
217
|
+
const part = entryPartOf(name, folded);
|
|
218
|
+
if (part?.part !== "content")
|
|
181
219
|
continue;
|
|
182
|
-
if (listed.has(`${
|
|
220
|
+
if (listed.has(`${part.stem}${OWNER_SUFFIX}`))
|
|
183
221
|
continue;
|
|
184
222
|
unattributable++;
|
|
185
223
|
}
|
|
@@ -203,21 +241,18 @@ export class FileToolResultStore {
|
|
|
203
241
|
}
|
|
204
242
|
const listed = new Set(names);
|
|
205
243
|
for (const name of names) {
|
|
206
|
-
const
|
|
207
|
-
if (
|
|
244
|
+
const part = entryPartOf(name, folded);
|
|
245
|
+
if (part === undefined)
|
|
208
246
|
continue;
|
|
209
|
-
|
|
210
|
-
if (!isEncodedStem(stem, folded))
|
|
211
|
-
continue;
|
|
212
|
-
if (!content && listed.has(`${stem}${CONTENT_SUFFIX}`))
|
|
247
|
+
if (part.part === "owner" && hasContentListed(listed, part.stem))
|
|
213
248
|
continue;
|
|
214
249
|
const path = join(dir, name);
|
|
215
250
|
const modified = modifiedAt(path);
|
|
216
251
|
if (modified === undefined || modified >= cutoff)
|
|
217
252
|
continue;
|
|
218
253
|
unlinkIfAbsentOk(path);
|
|
219
|
-
if (content) {
|
|
220
|
-
unlinkIfAbsentOk(join(dir, `${stem}${OWNER_SUFFIX}`));
|
|
254
|
+
if (part.part === "content") {
|
|
255
|
+
unlinkIfAbsentOk(join(dir, `${part.stem}${OWNER_SUFFIX}`));
|
|
221
256
|
removed++;
|
|
222
257
|
}
|
|
223
258
|
}
|
|
@@ -241,16 +276,20 @@ export class FileToolResultStore {
|
|
|
241
276
|
}
|
|
242
277
|
const listed = new Set(names);
|
|
243
278
|
for (const name of names) {
|
|
244
|
-
|
|
279
|
+
const part = entryPartOf(name, folded);
|
|
280
|
+
if (part === undefined || part.part === "owner")
|
|
245
281
|
continue;
|
|
246
|
-
|
|
247
|
-
if (!isEncodedStem(stem, folded) || listed.has(`${stem}${OWNER_SUFFIX}`))
|
|
282
|
+
if (part.part === "content" && listed.has(`${part.stem}${OWNER_SUFFIX}`))
|
|
248
283
|
continue;
|
|
249
284
|
const path = join(dir, name);
|
|
250
285
|
const modified = modifiedAt(path);
|
|
251
286
|
if (modified === undefined || modified >= cutoffMs)
|
|
252
287
|
continue;
|
|
253
|
-
if (
|
|
288
|
+
if (part.part === "staging") {
|
|
289
|
+
unlinkIfAbsentOk(path);
|
|
290
|
+
continue;
|
|
291
|
+
}
|
|
292
|
+
if (readOwnerAt(join(dir, `${part.stem}${OWNER_SUFFIX}`)) !== "gone")
|
|
254
293
|
continue;
|
|
255
294
|
unlinkIfAbsentOk(path);
|
|
256
295
|
removed++;
|
|
@@ -272,9 +311,11 @@ export class FileToolResultStore {
|
|
|
272
311
|
continue;
|
|
273
312
|
throw err;
|
|
274
313
|
}
|
|
314
|
+
const folded = dir !== this.dir;
|
|
275
315
|
const listed = new Set(names);
|
|
276
316
|
for (const name of names) {
|
|
277
|
-
|
|
317
|
+
const part = entryPartOf(name, folded);
|
|
318
|
+
if (part?.part !== "owner")
|
|
278
319
|
continue;
|
|
279
320
|
const owner = readOwnerFileAt(join(dir, name));
|
|
280
321
|
if (owner === "gone")
|
|
@@ -285,17 +326,15 @@ export class FileToolResultStore {
|
|
|
285
326
|
}
|
|
286
327
|
if (owner.provenance.sessionId !== sessionId)
|
|
287
328
|
continue;
|
|
288
|
-
const
|
|
289
|
-
const ref = this.refOfEntry(dir, stem, owner.ref);
|
|
329
|
+
const ref = this.refOfEntry(dir, part.stem, owner.ref);
|
|
290
330
|
if (ref === undefined)
|
|
291
331
|
unaddressable++;
|
|
292
332
|
else
|
|
293
333
|
entries.push({ ref, provenance: owner.provenance });
|
|
294
334
|
}
|
|
295
335
|
for (const name of names) {
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
if (listed.has(`${name.slice(0, -CONTENT_SUFFIX.length)}${OWNER_SUFFIX}`))
|
|
336
|
+
const part = entryPartOf(name, folded);
|
|
337
|
+
if (part?.part !== "content" || listed.has(`${part.stem}${OWNER_SUFFIX}`))
|
|
299
338
|
continue;
|
|
300
339
|
unattributable++;
|
|
301
340
|
}
|
|
@@ -317,8 +356,32 @@ export class FileToolResultStore {
|
|
|
317
356
|
return dir === this.dir && lies(stem) ? stem : undefined;
|
|
318
357
|
}
|
|
319
358
|
}
|
|
320
|
-
const CONTENT_SUFFIX = ".txt";
|
|
359
|
+
const CONTENT_SUFFIX = { text: ".txt", bytes: ".bin" };
|
|
360
|
+
const CONTENT_KINDS = Object.keys(CONTENT_SUFFIX);
|
|
321
361
|
const OWNER_SUFFIX = ".owner.json";
|
|
362
|
+
const STAGING_NAME = /^(.+)\.\d+\.[0-9a-f]{12}\.tmp$/;
|
|
363
|
+
export function entryPartOf(name, folded) {
|
|
364
|
+
const staged = STAGING_NAME.exec(name);
|
|
365
|
+
const published = staged !== null ? staged[1] : name;
|
|
366
|
+
const read = (() => {
|
|
367
|
+
if (published.endsWith(OWNER_SUFFIX))
|
|
368
|
+
return { stem: published.slice(0, -OWNER_SUFFIX.length) };
|
|
369
|
+
const kind = CONTENT_KINDS.find((k) => published.endsWith(CONTENT_SUFFIX[k]));
|
|
370
|
+
return kind === undefined ? undefined : { stem: published.slice(0, -CONTENT_SUFFIX[kind].length), kind };
|
|
371
|
+
})();
|
|
372
|
+
if (read === undefined || !isEncodedStem(read.stem, folded))
|
|
373
|
+
return undefined;
|
|
374
|
+
if (staged !== null)
|
|
375
|
+
return { stem: read.stem, part: "staging" };
|
|
376
|
+
return read.kind !== undefined ? { stem: read.stem, part: "content", kind: read.kind } : { stem: read.stem, part: "owner" };
|
|
377
|
+
}
|
|
378
|
+
function hasContentListed(listed, stem) {
|
|
379
|
+
return CONTENT_KINDS.some((k) => listed.has(`${stem}${CONTENT_SUFFIX[k]}`));
|
|
380
|
+
}
|
|
381
|
+
function unlinkContentOf(dir, stem) {
|
|
382
|
+
for (const k of CONTENT_KINDS)
|
|
383
|
+
unlinkIfAbsentOk(join(dir, `${stem}${CONTENT_SUFFIX[k]}`));
|
|
384
|
+
}
|
|
322
385
|
function parseOwnerRecord(raw) {
|
|
323
386
|
return parseOwnerFile(raw)?.provenance;
|
|
324
387
|
}
|
|
@@ -332,10 +395,10 @@ function parseOwnerFile(raw) {
|
|
|
332
395
|
}
|
|
333
396
|
})();
|
|
334
397
|
if (typeof parsed === "object" && parsed !== null) {
|
|
335
|
-
const { sessionId, taskId, ref } = parsed;
|
|
398
|
+
const { sessionId, taskId, ref, mediaType } = parsed;
|
|
336
399
|
if (typeof sessionId === "string" && (taskId === undefined || typeof taskId === "string")) {
|
|
337
400
|
const provenance = taskId === undefined ? { sessionId } : { sessionId, taskId };
|
|
338
|
-
return typeof ref === "string" ? {
|
|
401
|
+
return { provenance, ...(typeof ref === "string" ? { ref } : {}), ...(typeof mediaType === "string" ? { mediaType } : {}) };
|
|
339
402
|
}
|
|
340
403
|
}
|
|
341
404
|
return undefined;
|
|
@@ -16,6 +16,7 @@ export declare class FileWorkflowRunStore implements WorkflowRunStore {
|
|
|
16
16
|
private readonly ledger;
|
|
17
17
|
/** RB-145: this instance's own close latch — the refcount belongs to the DIRECTORY, not to callers. */
|
|
18
18
|
private closed;
|
|
19
|
+
private readonly disclose;
|
|
19
20
|
private get runs();
|
|
20
21
|
constructor(root: string, options?: FileWorkflowRunStoreOptions);
|
|
21
22
|
/** Serialize an op behind any in-flight op on the same id (the in-process per-id async mutex). */
|