@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
package/dist/shell/lex.js
CHANGED
|
@@ -617,7 +617,7 @@ const BARE_PARAMETER = /^(?:[A-Za-z_][A-Za-z0-9_]*|\d|[@*#?$!0-])/;
|
|
|
617
617
|
const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
618
618
|
const PER_ELEMENT_BODY = /^!?@|\[@\]|^![^}]*@$/;
|
|
619
619
|
const NAME_HEAD = /^[A-Za-z_][A-Za-z0-9_]*/;
|
|
620
|
-
function backtickBody(source, open) {
|
|
620
|
+
function backtickBody(source, open, inDouble = false) {
|
|
621
621
|
let body = "";
|
|
622
622
|
for (let j = open + 1; j < source.length; j++) {
|
|
623
623
|
const c = source[j];
|
|
@@ -627,7 +627,7 @@ function backtickBody(source, open) {
|
|
|
627
627
|
j++;
|
|
628
628
|
continue;
|
|
629
629
|
}
|
|
630
|
-
body += next === "$" || next === "`" || next === "\\" ? next : c + next;
|
|
630
|
+
body += next === "$" || next === "`" || next === "\\" || (inDouble && next === '"') ? next : c + next;
|
|
631
631
|
j++;
|
|
632
632
|
continue;
|
|
633
633
|
}
|
|
@@ -642,6 +642,7 @@ export function expansionsInHeredocBody(body) {
|
|
|
642
642
|
}
|
|
643
643
|
function expansionsInBody(body) {
|
|
644
644
|
const out = [];
|
|
645
|
+
const push = (x, start, last) => (out.push({ ...x, span: [start, last + 1] }), last);
|
|
645
646
|
for (let i = 0; i < body.length; i++) {
|
|
646
647
|
const ch = body[i];
|
|
647
648
|
if (ch === "\\") {
|
|
@@ -652,8 +653,7 @@ function expansionsInBody(body) {
|
|
|
652
653
|
const tick = backtickBody(body, i);
|
|
653
654
|
if (tick === undefined)
|
|
654
655
|
return undefined;
|
|
655
|
-
|
|
656
|
-
i = tick.close;
|
|
656
|
+
i = push({ expansion: { kind: "command", yields: "one", body: tick.body } }, i, tick.close);
|
|
657
657
|
continue;
|
|
658
658
|
}
|
|
659
659
|
if (ch !== "$")
|
|
@@ -663,23 +663,20 @@ function expansionsInBody(body) {
|
|
|
663
663
|
const close = substitutionBodyEnd(body, i + 1, true, 0, "document");
|
|
664
664
|
if (typeof close !== "object" || !("end" in close))
|
|
665
665
|
return undefined;
|
|
666
|
-
|
|
667
|
-
i = close.end - 1;
|
|
666
|
+
i = push({ expansion: { kind: close.arithmetic ? "arithmetic" : "command", yields: "one", body: body.slice(i + 2, close.end - 1) } }, i, close.end - 1);
|
|
668
667
|
}
|
|
669
668
|
else if (open === "[") {
|
|
670
669
|
const end = bracketExpansionEnd(body, i + 1);
|
|
671
670
|
if (end === undefined)
|
|
672
671
|
return undefined;
|
|
673
|
-
|
|
674
|
-
i = end - 1;
|
|
672
|
+
i = push({ expansion: { kind: "arithmetic", yields: "one", body: body.slice(i + 2, end - 1) } }, i, end - 1);
|
|
675
673
|
}
|
|
676
674
|
else if (open === "{") {
|
|
677
675
|
if (opensCurrentShellSubstitution(body, i + 1)) {
|
|
678
676
|
const run = currentShellSubstitutionEnd(body, i + 1, 1);
|
|
679
677
|
if (typeof run !== "object" || !("end" in run))
|
|
680
678
|
return undefined;
|
|
681
|
-
|
|
682
|
-
i = run.end - 1;
|
|
679
|
+
i = push({ expansion: { kind: "command", yields: "one", body: body.slice(run.from, run.end - 1) }, currentShell: true }, i, run.end - 1);
|
|
683
680
|
continue;
|
|
684
681
|
}
|
|
685
682
|
const end = braceExpansionEnd(body, i + 1);
|
|
@@ -687,15 +684,13 @@ function expansionsInBody(body) {
|
|
|
687
684
|
return undefined;
|
|
688
685
|
const text = body.slice(i + 2, end - 1);
|
|
689
686
|
const name = EXPANSION_NAME.exec(text)?.[1];
|
|
690
|
-
|
|
691
|
-
i = end - 1;
|
|
687
|
+
i = push({ expansion: { kind: "parameter", yields: "one", body: text, ...(name !== undefined ? { name } : {}) }, ...(UNREADABLE_EXPANSION_TEXT.test(text) ? { unresolved: "parameter_text" } : {}) }, i, end - 1);
|
|
692
688
|
}
|
|
693
689
|
else {
|
|
694
690
|
const head = BARE_PARAMETER.exec(body.slice(i + 1, i + 65))?.[0];
|
|
695
691
|
if (head === undefined)
|
|
696
692
|
continue;
|
|
697
|
-
|
|
698
|
-
i += head.length;
|
|
693
|
+
i = push({ expansion: { kind: "parameter", yields: "one", name: head } }, i, i + head.length);
|
|
699
694
|
}
|
|
700
695
|
}
|
|
701
696
|
return out;
|
|
@@ -706,9 +701,14 @@ export function substitutionsInHeredocBody(body) {
|
|
|
706
701
|
return undefined;
|
|
707
702
|
return all.flatMap(({ expansion: e, currentShell }) => (e.kind === "command" || e.kind === "arithmetic" ? [{ body: e.body ?? "", kind: e.kind, ...(currentShell === true ? { currentShell } : {}) }] : []));
|
|
708
703
|
}
|
|
709
|
-
export function
|
|
704
|
+
export function heredocRunsOf(body) {
|
|
710
705
|
const all = expansionsInHeredocBody(body);
|
|
711
|
-
|
|
706
|
+
if (all === undefined)
|
|
707
|
+
return HIDDEN_RUNS;
|
|
708
|
+
return joinRuns([/[<>]\(/.test(body) ? HIDDEN_RUNS : NO_RUNS, ...all.map((x) => (x.unresolved !== undefined ? joinRuns([HIDDEN_RUNS, expansionRunsOf(x.expansion)]) : expansionRunsOf(x.expansion)))]);
|
|
709
|
+
}
|
|
710
|
+
export function heredocBodyHidesRun(body) {
|
|
711
|
+
return runsAny(heredocRunsOf(body));
|
|
712
712
|
}
|
|
713
713
|
const SUBSTITUTION_OPENER = /\$\(|`|<\(|>\(|\$\[/;
|
|
714
714
|
export function parameterArithmeticTexts(body) {
|
|
@@ -740,15 +740,32 @@ const TRANSFORM_FORM = new RegExp(String.raw `^${PARAMETER}(?:\[(?:'[^']*'|"(?:[
|
|
|
740
740
|
const RESPELLING_TRANSFORMS = new Set(["Q", "E", "A", "K", "k", "a", "U", "u", "L"]);
|
|
741
741
|
const NAME_OR_KEY_LIST = /^![A-Za-z_][A-Za-z0-9_]*(?:[*@]|\[[@*]\])$/;
|
|
742
742
|
const PLAIN_ARITHMETIC = /^[\s\d+\-*/%&|^~!<>=?:,()]*$/;
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
743
|
+
const NO_RUNS = { lines: [], hidden: false };
|
|
744
|
+
const HIDDEN_RUNS = { lines: [], hidden: true };
|
|
745
|
+
function joinRuns(parts) {
|
|
746
|
+
return { lines: parts.flatMap((p) => p.lines), hidden: parts.some((p) => p.hidden) };
|
|
747
|
+
}
|
|
748
|
+
const runsAny = (r) => r.hidden || r.lines.length > 0;
|
|
749
|
+
export function expansionRunsOf(e) {
|
|
750
|
+
const inner = joinRuns((e.inner ?? []).map(expansionRunsOf));
|
|
751
|
+
if (e.kind === "command" || e.kind === "process")
|
|
752
|
+
return joinRuns([e.body === undefined ? HIDDEN_RUNS : { lines: [e.body], hidden: false }, inner]);
|
|
746
753
|
const body = e.body?.replace(/\\\n/g, "");
|
|
747
754
|
if (body === undefined)
|
|
748
|
-
return
|
|
755
|
+
return inner;
|
|
749
756
|
if (e.kind === "arithmetic")
|
|
750
|
-
return
|
|
751
|
-
|
|
757
|
+
return joinRuns([arithmeticTextRunsOf(body), inner]);
|
|
758
|
+
const hidden = SUBSTITUTION_OPENER.test(body) || (e.kind === "parameter" && (bodyEvaluatesText(body) || parameterRereadsValue(body))) || nestedBodyEvaluatesText(body);
|
|
759
|
+
return hidden ? joinRuns([HIDDEN_RUNS, inner]) : inner;
|
|
760
|
+
}
|
|
761
|
+
export function arithmeticTextRunsOf(text) {
|
|
762
|
+
if (arithmeticTextIsPlain(text))
|
|
763
|
+
return NO_RUNS;
|
|
764
|
+
const all = expansionsInHeredocBody(text);
|
|
765
|
+
return all === undefined ? HIDDEN_RUNS : joinRuns([HIDDEN_RUNS, ...all.map((x) => expansionRunsOf(x.expansion))]);
|
|
766
|
+
}
|
|
767
|
+
export function expansionHidesRun(e) {
|
|
768
|
+
return runsAny(expansionRunsOf(e));
|
|
752
769
|
}
|
|
753
770
|
export function assignedWords(w) {
|
|
754
771
|
const elements = w.assignment?.form === "compound" ? w.assignment.elements : undefined;
|
|
@@ -786,8 +803,11 @@ export function arithmeticTextIsPlain(text) {
|
|
|
786
803
|
export function subscriptHidesRun(w) {
|
|
787
804
|
return w.assignment?.subscript !== undefined && !arithmeticTextIsPlain(w.assignment.subscript.raw);
|
|
788
805
|
}
|
|
806
|
+
export function wordRunsOf(w) {
|
|
807
|
+
return joinRuns(assignedWords(w).flatMap((e) => [e.assignment?.form === "compound" || subscriptHidesRun(e) ? HIDDEN_RUNS : NO_RUNS, ...e.expansions.flatMap((p) => (p.expansion !== undefined ? [expansionRunsOf(p.expansion)] : []))]));
|
|
808
|
+
}
|
|
789
809
|
export function wordHidesRun(w) {
|
|
790
|
-
return
|
|
810
|
+
return runsAny(wordRunsOf(w));
|
|
791
811
|
}
|
|
792
812
|
export function namesRedirectDescriptor(next) {
|
|
793
813
|
return (next?.kind === "redirect" || next?.kind === "heredoc") && next.allocated === true;
|
|
@@ -799,18 +819,38 @@ export function literalTextOf(pieces) {
|
|
|
799
819
|
return pieces.every((q) => q.literal !== undefined) ? pieces.map((q) => q.literal).join("") : undefined;
|
|
800
820
|
}
|
|
801
821
|
export function literalHeredocBody(body) {
|
|
822
|
+
const run = heredocLiteralRun(body);
|
|
823
|
+
return run.expands ? undefined : run.text;
|
|
824
|
+
}
|
|
825
|
+
function heredocLiteralRun(text) {
|
|
802
826
|
let out = "";
|
|
803
|
-
|
|
804
|
-
|
|
827
|
+
let expands = false;
|
|
828
|
+
for (let i = 0; i < text.length; i++) {
|
|
829
|
+
const ch = text[i];
|
|
805
830
|
if (ch === "$" || ch === "`")
|
|
806
|
-
|
|
807
|
-
if (ch === "\\" && i + 1 <
|
|
808
|
-
out +=
|
|
831
|
+
expands = true;
|
|
832
|
+
if (ch === "\\" && i + 1 < text.length && "$`\\".includes(text[i + 1])) {
|
|
833
|
+
out += text[++i];
|
|
809
834
|
continue;
|
|
810
835
|
}
|
|
811
836
|
out += ch;
|
|
812
837
|
}
|
|
813
|
-
return out;
|
|
838
|
+
return { text: out, expands };
|
|
839
|
+
}
|
|
840
|
+
export function heredocBodyPieces(body) {
|
|
841
|
+
const expansions = expansionsInHeredocBody(body);
|
|
842
|
+
if (expansions === undefined)
|
|
843
|
+
return undefined;
|
|
844
|
+
const pieces = [];
|
|
845
|
+
let at = 0;
|
|
846
|
+
const literalTo = (end) => void (end > at && pieces.push({ span: [at, end], quotedBy: '"', literal: heredocLiteralRun(body.slice(at, end)).text }));
|
|
847
|
+
for (const x of expansions) {
|
|
848
|
+
literalTo(x.span[0]);
|
|
849
|
+
pieces.push({ span: x.span, quotedBy: '"', expansion: x.expansion });
|
|
850
|
+
at = x.span[1];
|
|
851
|
+
}
|
|
852
|
+
literalTo(body.length);
|
|
853
|
+
return pieces;
|
|
814
854
|
}
|
|
815
855
|
const BLANK = /[ \t]/;
|
|
816
856
|
const fail = (reason, at) => ({ parseFailure: { reason, at } });
|
|
@@ -1504,7 +1544,7 @@ function scanText(source, connectorsAreText, segments, level, list) {
|
|
|
1504
1544
|
continue;
|
|
1505
1545
|
}
|
|
1506
1546
|
if (ch === "`") {
|
|
1507
|
-
const tick = backtickBody(source, i);
|
|
1547
|
+
const tick = backtickBody(source, i, inDouble);
|
|
1508
1548
|
if (tick === undefined)
|
|
1509
1549
|
return fail("unterminated_command_substitution", i);
|
|
1510
1550
|
substitution(i, tick.close + 1, tick.body, "command");
|
|
@@ -16,6 +16,7 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
|
|
|
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 rows();
|
|
20
21
|
constructor(root: string, options?: FileBackgroundAgentStoreOptions);
|
|
21
22
|
/**
|
|
@@ -50,6 +51,10 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
|
|
|
50
51
|
status?: BackgroundAgentRecord["status"];
|
|
51
52
|
limit?: number;
|
|
52
53
|
}): Promise<BackgroundAgentRowSummary[]>;
|
|
54
|
+
listByRoot(rootSessionId: string, opts?: {
|
|
55
|
+
status?: BackgroundAgentRecord["status"];
|
|
56
|
+
limit?: number;
|
|
57
|
+
}): Promise<BackgroundAgentRowSummary[]>;
|
|
53
58
|
listScopes(): Promise<string[]>;
|
|
54
59
|
delete(handle: string, scope: string, expect?: {
|
|
55
60
|
rev: number;
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
|
-
import { BackgroundAgentStoreError,
|
|
2
|
+
import { BACKGROUND_AGENT_ROW_SHAPE, BackgroundAgentStoreError, admitBackgroundAgent, backgroundAgentReapCandidates, nextBackgroundAgentOnUpdate, receiveBackgroundAgentReapOptions, queryBackgroundAgents, readStoredBackgroundAgent, staleRunningFlip, } from "../../core/background-agent-store.js";
|
|
3
3
|
import { SharedLedgerTable } from "./shared-ledger.js";
|
|
4
4
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
5
5
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
6
6
|
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
7
7
|
import { readLedgerTuning } from "./ledger-tuning.js";
|
|
8
8
|
const FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0 });
|
|
9
|
-
const isAgentRow = (x) =>
|
|
9
|
+
const isAgentRow = (x) => BACKGROUND_AGENT_ROW_SHAPE.rowKey(x);
|
|
10
10
|
const agentLedgers = new SharedLedgerTable({
|
|
11
11
|
label: "background-agent ledger",
|
|
12
12
|
keyOf: (r) => FileBackgroundAgentStore.key(r.handle, r.scope),
|
|
@@ -30,6 +30,7 @@ export class FileBackgroundAgentStore {
|
|
|
30
30
|
compactEvery;
|
|
31
31
|
ledger;
|
|
32
32
|
closed = false;
|
|
33
|
+
disclose;
|
|
33
34
|
get rows() {
|
|
34
35
|
return this.ledger.rows;
|
|
35
36
|
}
|
|
@@ -40,11 +41,14 @@ export class FileBackgroundAgentStore {
|
|
|
40
41
|
this.fsyncEnabled = tuning.fsync;
|
|
41
42
|
this.compactEvery = tuning.compactEvery;
|
|
42
43
|
const dir = join(root, "background-agents");
|
|
44
|
+
const sink = guardCorruptSink(opts.onCorruptRead);
|
|
45
|
+
const ledgerPath = join(dir, "agents.jsonl");
|
|
46
|
+
this.disclose = sink === undefined ? undefined : (reason) => sink({ kind: "file", path: ledgerPath, reason });
|
|
43
47
|
this.ledger = agentLedgers.acquire({
|
|
44
48
|
dir,
|
|
45
49
|
tmpDir: join(root, "tmp"),
|
|
46
|
-
...(
|
|
47
|
-
ledgerPath
|
|
50
|
+
...(sink !== undefined ? { onCorruptRead: sink } : {}),
|
|
51
|
+
ledgerPath,
|
|
48
52
|
snapshotPath: join(dir, "agents.snapshot.jsonl"),
|
|
49
53
|
});
|
|
50
54
|
}
|
|
@@ -58,62 +62,43 @@ export class FileBackgroundAgentStore {
|
|
|
58
62
|
this.ledger.commit(ev, this.fsyncEnabled, this.compactEvery);
|
|
59
63
|
}
|
|
60
64
|
async put(record) {
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
}
|
|
65
|
+
const stored = structuredClone(record);
|
|
66
|
+
stored.rev = record.rev ?? 0;
|
|
64
67
|
const k = FileBackgroundAgentStore.key(record.handle, record.scope);
|
|
68
|
+
const admitted = admitBackgroundAgent(stored, { key: k });
|
|
65
69
|
return this.withLock(k, () => {
|
|
66
70
|
if (this.rows.has(k)) {
|
|
67
71
|
throw new BackgroundAgentStoreError("agent_record.already_exists", "agent record already exists");
|
|
68
72
|
}
|
|
69
|
-
|
|
70
|
-
stored.rev = record.rev ?? 0;
|
|
71
|
-
this.commit({ t: "put", k, r: stored });
|
|
73
|
+
this.commit({ t: "put", k, r: admitted });
|
|
72
74
|
});
|
|
73
75
|
}
|
|
74
76
|
async get(handle, scope) {
|
|
75
|
-
const
|
|
76
|
-
|
|
77
|
+
const k = FileBackgroundAgentStore.key(handle, scope);
|
|
78
|
+
const row = this.rows.get(k);
|
|
79
|
+
return row ? structuredClone(readStoredBackgroundAgent(row, { key: k }, this.disclose)) : null;
|
|
77
80
|
}
|
|
78
81
|
async update(handle, scope, record, expect) {
|
|
79
|
-
|
|
80
|
-
return this.withLock(k, () => {
|
|
81
|
-
const live = this.rows.get(k);
|
|
82
|
-
if (!live || live.scope !== scope || live.rev !== expect.rev)
|
|
83
|
-
return false;
|
|
84
|
-
const stored = structuredClone(record);
|
|
85
|
-
stored.handle = handle;
|
|
86
|
-
stored.scope = scope;
|
|
87
|
-
stored.rev = live.rev + 1;
|
|
88
|
-
this.commit({ t: "update", k, r: stored });
|
|
89
|
-
return true;
|
|
90
|
-
});
|
|
82
|
+
return this.updateIf(handle, scope, record, { rev: expect.rev });
|
|
91
83
|
}
|
|
92
84
|
async updateIf(handle, scope, record, expect) {
|
|
93
85
|
const k = FileBackgroundAgentStore.key(handle, scope);
|
|
94
86
|
return this.withLock(k, async () => {
|
|
95
|
-
const
|
|
96
|
-
if (
|
|
97
|
-
return false;
|
|
98
|
-
if (expect.status !== undefined && live.status !== expect.status)
|
|
87
|
+
const next = nextBackgroundAgentOnUpdate(this.rows.get(k), k, handle, scope, record, expect, this.disclose);
|
|
88
|
+
if (next === null)
|
|
99
89
|
return false;
|
|
100
|
-
|
|
101
|
-
return false;
|
|
102
|
-
if (expect.parkClaimId !== undefined && (expect.parkClaimId === null ? live.parkClaimId !== undefined : live.parkClaimId !== expect.parkClaimId))
|
|
103
|
-
return false;
|
|
104
|
-
const stored = structuredClone(record);
|
|
105
|
-
stored.handle = handle;
|
|
106
|
-
stored.scope = scope;
|
|
107
|
-
stored.rev = live.rev + 1;
|
|
108
|
-
this.commit({ t: "update", k, r: stored });
|
|
90
|
+
this.commit({ t: "update", k, r: next });
|
|
109
91
|
return true;
|
|
110
92
|
});
|
|
111
93
|
}
|
|
112
94
|
async listBySession(scope, sessionId, opts) {
|
|
113
|
-
return queryBackgroundAgents(this.rows.values(), { scope, sessionId, status: opts?.status, limit: opts?.limit });
|
|
95
|
+
return queryBackgroundAgents(this.rows.values(), { scope, sessionId, status: opts?.status, limit: opts?.limit }, this.disclose);
|
|
114
96
|
}
|
|
115
97
|
async listByScope(scope, opts) {
|
|
116
|
-
return queryBackgroundAgents(this.rows.values(), { scope, status: opts?.status, limit: opts?.limit });
|
|
98
|
+
return queryBackgroundAgents(this.rows.values(), { scope, status: opts?.status, limit: opts?.limit }, this.disclose);
|
|
99
|
+
}
|
|
100
|
+
async listByRoot(rootSessionId, opts) {
|
|
101
|
+
return queryBackgroundAgents(this.rows.values(), { root: rootSessionId, status: opts?.status, limit: opts?.limit });
|
|
117
102
|
}
|
|
118
103
|
async listScopes() {
|
|
119
104
|
return [...new Set([...this.rows.values()].map((r) => r.scope))].sort();
|
|
@@ -136,22 +121,13 @@ export class FileBackgroundAgentStore {
|
|
|
136
121
|
return 0;
|
|
137
122
|
const changed = new Set();
|
|
138
123
|
if (policy.staleRunningMaxAgeMs !== undefined) {
|
|
139
|
-
const
|
|
140
|
-
|
|
141
|
-
.map(([k]) => k);
|
|
124
|
+
const staleMs = policy.staleRunningMaxAgeMs;
|
|
125
|
+
const staleCandidates = [...this.rows.entries()].filter(([k, r]) => staleRunningFlip(r, k, scope, now, staleMs, this.disclose) !== undefined).map(([k]) => k);
|
|
142
126
|
for (const k of staleCandidates) {
|
|
143
127
|
const flipped = await this.withLock(k, () => {
|
|
144
|
-
const
|
|
145
|
-
if (
|
|
128
|
+
const next = staleRunningFlip(this.rows.get(k), k, scope, now, staleMs);
|
|
129
|
+
if (next === undefined)
|
|
146
130
|
return false;
|
|
147
|
-
const next = structuredClone(live);
|
|
148
|
-
next.status = "failed";
|
|
149
|
-
next.stoppedBy = "system";
|
|
150
|
-
next.summary = next.summary ?? STALE_RUNNING_REAP_ATTRIBUTION;
|
|
151
|
-
next.error = next.error ?? STALE_RUNNING_REAP_ATTRIBUTION;
|
|
152
|
-
next.settledAt = now;
|
|
153
|
-
next.updatedAt = now;
|
|
154
|
-
next.rev = live.rev + 1;
|
|
155
131
|
this.commit({ t: "update", k, r: next });
|
|
156
132
|
return true;
|
|
157
133
|
});
|
|
@@ -159,20 +135,18 @@ export class FileBackgroundAgentStore {
|
|
|
159
135
|
changed.add(k);
|
|
160
136
|
}
|
|
161
137
|
}
|
|
162
|
-
const terminal =
|
|
163
|
-
.filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
|
|
164
|
-
.sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
|
|
138
|
+
const terminal = backgroundAgentReapCandidates(this.rows.entries(), scope, this.disclose);
|
|
165
139
|
const doomed = new Map();
|
|
166
140
|
if (policy.maxAgeMs !== undefined) {
|
|
167
|
-
for (const
|
|
168
|
-
if (
|
|
169
|
-
doomed.set(
|
|
141
|
+
for (const r of terminal) {
|
|
142
|
+
if (r.age < now - policy.maxAgeMs)
|
|
143
|
+
doomed.set(r.key, { byAge: true });
|
|
170
144
|
}
|
|
171
145
|
}
|
|
172
146
|
if (policy.keep !== undefined) {
|
|
173
|
-
for (const
|
|
174
|
-
if (!doomed.has(
|
|
175
|
-
doomed.set(
|
|
147
|
+
for (const r of terminal.slice(Math.max(0, policy.keep))) {
|
|
148
|
+
if (!doomed.has(r.key))
|
|
149
|
+
doomed.set(r.key, { byAge: false });
|
|
176
150
|
}
|
|
177
151
|
}
|
|
178
152
|
for (const [k, why] of doomed) {
|
|
@@ -96,8 +96,8 @@ export interface FileCheckpointStoreOptions {
|
|
|
96
96
|
fsync?: boolean;
|
|
97
97
|
/** Compact the ledger into a snapshot once it exceeds this many events (then truncate). Default 1000. */
|
|
98
98
|
compactEvery?: number;
|
|
99
|
-
/** The session head read (a session store's `headOf`) {@link FileCheckpointStore.deleteSessionCheckpoints} judges its guard by
|
|
100
|
-
* without it the store has
|
|
99
|
+
/** The session head read (a session store's `headOf`) {@link FileCheckpointStore.deleteSessionCheckpoints} judges its guard by and
|
|
100
|
+
* `deleteUnreadableSessionCheckpoints` judges unreadability by; without it the store has neither member. */
|
|
101
101
|
sessionHeadOf?: (sessionId: string) => Promise<{
|
|
102
102
|
readonly owner: string | null;
|
|
103
103
|
} | undefined>;
|
|
@@ -189,6 +189,8 @@ export declare class FileCheckpointStore implements CheckpointStore {
|
|
|
189
189
|
private readonly ledgerPath;
|
|
190
190
|
/** Present exactly when the store was built with a session head read (`FileCheckpointStoreOptions.sessionHeadOf`). */
|
|
191
191
|
readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
|
|
192
|
+
/** Present exactly when {@link deleteSessionCheckpoints} is. */
|
|
193
|
+
readonly deleteUnreadableSessionCheckpoints?: (sessionId: string) => Promise<number>;
|
|
192
194
|
constructor(root: string, options?: FileCheckpointStoreOptions);
|
|
193
195
|
/** Serialize an op behind any in-flight op on the same token (the in-process per-token async mutex). */
|
|
194
196
|
private withLock;
|
|
@@ -207,7 +209,7 @@ export declare class FileCheckpointStore implements CheckpointStore {
|
|
|
207
209
|
get(token: CheckpointToken): Promise<Checkpoint | null>;
|
|
208
210
|
resolve(token: CheckpointToken, scope: string, outcome: ResumeOutcome, expect?: ResolveExpectation): Promise<boolean>;
|
|
209
211
|
recordExecutionOutcome(token: CheckpointToken, scope: string, gate: GateOutcome): Promise<ExecutionOutcomeRecordWord>;
|
|
210
|
-
reopen(token: CheckpointToken, scope: string, reason: ReopenReason): Promise<boolean>;
|
|
212
|
+
reopen(token: CheckpointToken, scope: string, reason: ReopenReason, expect?: Pick<ResolveExpectation, "rev">): Promise<boolean>;
|
|
211
213
|
setPendingSteer(token: CheckpointToken, scope: string, steer: PendingSteerInput): Promise<boolean>;
|
|
212
214
|
expire(token: CheckpointToken, scope: string): Promise<boolean>;
|
|
213
215
|
reap(scope: string, cutoff: number): Promise<number>;
|
|
@@ -6,7 +6,7 @@ import { readRetentionDeclaration } from "../../core/retention.js";
|
|
|
6
6
|
import { checkpointExecutionRecorded, executionRecordDisposition, ExecutionOutcomeConflictError, } from "../../core/checkpoint-execution-record.js";
|
|
7
7
|
import { checkpointHolderMatches, checkpointOccMatches, checkpointRevOf } from "../../core/checkpoint-generation.js";
|
|
8
8
|
import { appendPendingSteer, CheckpointError, checkpointRowMatches, encodeAtFidelity, summarizeStoredCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
|
|
9
|
-
import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
|
|
9
|
+
import { CHECKPOINT_ROW_SHAPE, checkpointDeadlinePassed, deleteSessionRowsAtStart, ownerSessionRowsDelete, unreadableSessionRowsDelete, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
|
|
10
10
|
import { readLedgerSettled, SharedLedgerTable } from "./shared-ledger.js";
|
|
11
11
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
12
12
|
const FILE_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
|
|
@@ -60,11 +60,7 @@ function applyCheckpointEvent(cps, ev) {
|
|
|
60
60
|
}
|
|
61
61
|
}
|
|
62
62
|
}
|
|
63
|
-
const isCheckpointRow = (x) => x
|
|
64
|
-
typeof x === "object" &&
|
|
65
|
-
typeof x.token === "string" &&
|
|
66
|
-
typeof x.scope === "string" &&
|
|
67
|
-
typeof x.status === "string";
|
|
63
|
+
const isCheckpointRow = (x) => CHECKPOINT_ROW_SHAPE.rowKey(x);
|
|
68
64
|
const checkpointLedgerModel = {
|
|
69
65
|
label: "checkpoint ledger",
|
|
70
66
|
keyOf: (cp) => cp.token,
|
|
@@ -131,12 +127,14 @@ export class FileCheckpointStore {
|
|
|
131
127
|
});
|
|
132
128
|
const headOf = opts.sessionHeadOf;
|
|
133
129
|
if (headOf !== undefined) {
|
|
134
|
-
|
|
130
|
+
const remove = (token, row) => this.withLock(token, () => {
|
|
135
131
|
if (this.cps.get(token) !== row)
|
|
136
132
|
return false;
|
|
137
133
|
this.commit({ t: "delete", token }, true);
|
|
138
134
|
return true;
|
|
139
|
-
})
|
|
135
|
+
});
|
|
136
|
+
this.deleteSessionCheckpoints = async (sessionId, guard) => deleteSessionRowsAtStart(this.cps, ownerSessionRowsDelete(sessionId, guard, headOf), remove);
|
|
137
|
+
this.deleteUnreadableSessionCheckpoints = async (sessionId) => deleteSessionRowsAtStart(this.cps, unreadableSessionRowsDelete(sessionId, headOf), remove);
|
|
140
138
|
}
|
|
141
139
|
}
|
|
142
140
|
withLock(token, fn) {
|
|
@@ -199,10 +197,10 @@ export class FileCheckpointStore {
|
|
|
199
197
|
return "recorded";
|
|
200
198
|
});
|
|
201
199
|
}
|
|
202
|
-
async reopen(token, scope, reason) {
|
|
200
|
+
async reopen(token, scope, reason, expect) {
|
|
203
201
|
return this.withLock(token, () => {
|
|
204
202
|
const cp = this.cps.get(token);
|
|
205
|
-
if (!checkpointRowMatches(cp, scope, "resolved") || checkpointExecutionRecorded(cp)) {
|
|
203
|
+
if (!checkpointRowMatches(cp, scope, "resolved") || !checkpointOccMatches(cp, expect) || checkpointExecutionRecorded(cp)) {
|
|
206
204
|
return false;
|
|
207
205
|
}
|
|
208
206
|
const rev = checkpointRevOf(cp) + 1;
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { type ProcessUncheckable } from "../../core/process-identity.js";
|
|
2
|
+
export { processFingerprint, isProcessLive, type ProcessFingerprint } from "../../core/process-identity.js";
|
|
1
3
|
import type { CorruptRecordRead, CorruptReplayTally } from "./corrupt-read-sink.js";
|
|
2
4
|
/**
|
|
3
5
|
* Validate an engine-minted id (sessionId / tool-result ref) before using it as a path component. These are
|
|
@@ -15,7 +17,6 @@ export declare function sanitizeScope(scope: string): string;
|
|
|
15
17
|
/** Resolve the data root (CC `getClaudeConfigHomeDir` analog): `$AGENT_DATA_DIR ?? ~/.ai-agent`,
|
|
16
18
|
* NFC-normalized, canonicalized once the dir exists. Creates the dir (0o700) if absent. */
|
|
17
19
|
export declare function resolveDataRoot(explicit?: string): string;
|
|
18
|
-
/** Ensure a directory exists with 0o700 perms (idempotent). */
|
|
19
20
|
/**
|
|
20
21
|
* Atomically CREATE `target` carrying `content` — it appears in ONE step already fully written, no empty/partial
|
|
21
22
|
* window. Fixes the create-then-write race: a reader/pruner can see a half-written
|
|
@@ -23,6 +24,7 @@ export declare function resolveDataRoot(explicit?: string): string;
|
|
|
23
24
|
* OWN dir (same FS → `link` is atomic) + fsync, then `linkSync`-publishes it; throws `EEXIST` if `target` exists.
|
|
24
25
|
*/
|
|
25
26
|
export declare function writeThenLink(target: string, content: string | Uint8Array): void;
|
|
27
|
+
/** Ensure a directory exists with 0o700 perms (idempotent). */
|
|
26
28
|
export declare function ensureDir(dir: string): void;
|
|
27
29
|
/**
|
|
28
30
|
* The 5-step atomic whole-file replace (§2.1). Skipping any of steps 3/5/6 is the classic corruption bug:
|
|
@@ -236,13 +238,36 @@ export declare class FileStoreLockError extends Error {
|
|
|
236
238
|
readonly lockPath: string;
|
|
237
239
|
/** The live owner's pid when the lock named one (absent for an unreadable lock or a lost race). */
|
|
238
240
|
readonly ownerPid?: number | undefined;
|
|
241
|
+
/**
|
|
242
|
+
* Present when the owner was NOT proven running but could not be proven gone either — the lock names a
|
|
243
|
+
* process this host cannot check (another host, another pid namespace, a record that names no namespace,
|
|
244
|
+
* no comparable start time, a process table that refused the question). The owner may still be running;
|
|
245
|
+
* nothing proves it is, so the refusal is the same `store.dir_in_use` with the cause attached, and the
|
|
246
|
+
* remedy is a person's: remove {@link lockPath} if no process uses the directory.
|
|
247
|
+
*/
|
|
248
|
+
readonly ownerUncheckable?: ProcessUncheckable | undefined;
|
|
239
249
|
readonly name = "FileStoreLockError";
|
|
240
250
|
constructor(code: FileStoreLockErrorCode, message: string,
|
|
241
251
|
/** The lock file whose acquisition was refused. */
|
|
242
252
|
lockPath: string,
|
|
243
253
|
/** The live owner's pid when the lock named one (absent for an unreadable lock or a lost race). */
|
|
244
|
-
ownerPid?: number | undefined
|
|
254
|
+
ownerPid?: number | undefined,
|
|
255
|
+
/**
|
|
256
|
+
* Present when the owner was NOT proven running but could not be proven gone either — the lock names a
|
|
257
|
+
* process this host cannot check (another host, another pid namespace, a record that names no namespace,
|
|
258
|
+
* no comparable start time, a process table that refused the question). The owner may still be running;
|
|
259
|
+
* nothing proves it is, so the refusal is the same `store.dir_in_use` with the cause attached, and the
|
|
260
|
+
* remedy is a person's: remove {@link lockPath} if no process uses the directory.
|
|
261
|
+
*/
|
|
262
|
+
ownerUncheckable?: ProcessUncheckable | undefined);
|
|
245
263
|
}
|
|
264
|
+
/** The clause every refusal of an uncheckable lock owner says, whichever store words the rest — `undefined`
|
|
265
|
+
* for a refusal whose owner was proven running (or that names no owner). */
|
|
266
|
+
export declare function uncheckableOwnerClause(err: {
|
|
267
|
+
readonly lockPath: string;
|
|
268
|
+
readonly ownerPid?: number;
|
|
269
|
+
readonly ownerUncheckable?: ProcessUncheckable;
|
|
270
|
+
}): string | undefined;
|
|
246
271
|
/**
|
|
247
272
|
* The coarse boot guard (§2.4): an `O_EXCL` owner file (`root/LOCK` for the whole data dir; one per store
|
|
248
273
|
* ledger directory via {@link acquireStoreDirLock}) that forbids two processes sharing it. A second
|
|
@@ -374,71 +399,3 @@ export declare function acquireStoreDirLock(dir: string, opts: {
|
|
|
374
399
|
label: string;
|
|
375
400
|
fileName?: string;
|
|
376
401
|
}): StoreDirLockLease;
|
|
377
|
-
/**
|
|
378
|
-
* A process identity that survives PID REUSE: a pid, WHEN that pid's process started, and the host the
|
|
379
|
-
* observation was made on.
|
|
380
|
-
*
|
|
381
|
-
* A pid alone is not an identity. The OS hands the same number out again once its holder exits, so a lock
|
|
382
|
-
* (or lease, or any other durable "who owns this" record) carrying only a pid says no more than "somebody
|
|
383
|
-
* with that number" — and after a crash, an unrelated process that inherits the number makes the dead
|
|
384
|
-
* owner's record read as a LIVE owner for as long as that process lives. Adding the START TIME makes the
|
|
385
|
-
* record falsifiable: the pid narrows the candidate to one process, the start time decides whether it is
|
|
386
|
-
* still the SAME one.
|
|
387
|
-
*
|
|
388
|
-
* The start time is carried TWICE, against two different clocks, and that is the whole robustness of the
|
|
389
|
-
* thing. Both numbers come from ONE reading of the process's elapsed time, but one is subtracted from the
|
|
390
|
-
* WALL clock and the other from the host's UPTIME — and a platform that leaves one of them unmoved when
|
|
391
|
-
* the wall clock is corrected moves the other. (Where `ps` measures elapsed time against the boot clock, a
|
|
392
|
-
* corrected wall clock shifts the derived wall-clock start and leaves the uptime-relative one alone; where
|
|
393
|
-
* it measures against a stored absolute start, it is the other way round.) A comparison that insists on
|
|
394
|
-
* BOTH before calling a record stale therefore cannot be talked into a reclaim by a clock correction —
|
|
395
|
-
* which matters because that reclaim would be of a LIVE writer's lock. See {@link isProcessLive}.
|
|
396
|
-
*
|
|
397
|
-
* Both are `null` when this host cannot produce a start time (no `ps`, a cut-down `ps` that rejects the
|
|
398
|
-
* query, a probe too slow for its own reading to be worth anything). That is a plain "unknown" — never a
|
|
399
|
-
* zero and never a guess — and every consumer treats an unobtainable fingerprint as UNFALSIFIABLE, keeping
|
|
400
|
-
* the pid-only verdict: the degrade lands on yesterday's behaviour rather than on a wrong reclaim, and
|
|
401
|
-
* says so out loud once.
|
|
402
|
-
*/
|
|
403
|
-
export interface ProcessFingerprint {
|
|
404
|
-
/** The process id the rest of the record is about. */
|
|
405
|
-
readonly pid: number;
|
|
406
|
-
/** Start of that pid's process against the WALL clock, to the second; `null` when unobtainable here. */
|
|
407
|
-
readonly startedAtMs: number | null;
|
|
408
|
-
/** The same start against this host's UPTIME (ms after boot), to the second; `null` likewise. */
|
|
409
|
-
readonly startedSinceBootMs: number | null;
|
|
410
|
-
/** The host both were read on — a fingerprint from ANOTHER host is comparable to nothing here. */
|
|
411
|
-
readonly host: string;
|
|
412
|
-
}
|
|
413
|
-
/**
|
|
414
|
-
* The fingerprint of a process: this one when called with no pid, any other pid when named.
|
|
415
|
-
*
|
|
416
|
-
* ONE derivation for both halves of the mechanism — the record a holder WRITES and the probe a later reader
|
|
417
|
-
* verifies it with — on purpose. Deriving our own start time from `process.uptime()` instead would be
|
|
418
|
-
* cheaper, but it measures from Node's own initialisation rather than from the kernel's `exec`, so a busy
|
|
419
|
-
* machine can put the two derivations seconds apart. A reader comparing across them would then read a
|
|
420
|
-
* healthy holder as stale and RECLAIM A LIVE LOCK — a strictly worse failure than the pid reuse this fixes.
|
|
421
|
-
* One derivation makes the tolerance a rounding allowance instead of a guess about bootstrap latency.
|
|
422
|
-
*
|
|
423
|
-
* The self case is memoized: our start time cannot change, the probe is a subprocess, and a lock publish is
|
|
424
|
-
* the only place that needs it — so a process pays for it at most once, whatever it opens.
|
|
425
|
-
*/
|
|
426
|
-
export declare function processFingerprint(pid?: number): ProcessFingerprint;
|
|
427
|
-
/**
|
|
428
|
-
* Is the process a record names still the one that wrote it? ONE predicate, two terms: the pid is running,
|
|
429
|
-
* AND the fingerprint has not been falsified.
|
|
430
|
-
*
|
|
431
|
-
* "Not falsified" is the load-bearing wording, and it is what every degrade lands on. A record with no
|
|
432
|
-
* `startedAtMs` (the pre-fingerprint spelling, or a host that cannot produce one), a record written on
|
|
433
|
-
* ANOTHER host (its start time was measured against a different boot — comparing it here would be
|
|
434
|
-
* arithmetic on unrelated numbers), and a probe that cannot answer all reach the same verdict: LIVE. The
|
|
435
|
-
* asymmetry is deliberate and is the whole safety argument — a false "dead" reclaims a directory out from
|
|
436
|
-
* under a working process (two writers, and the ledger loses whichever rows the loser never loaded), while
|
|
437
|
-
* a false "live" costs a refusal an operator can act on.
|
|
438
|
-
*/
|
|
439
|
-
export declare function isProcessLive(record: {
|
|
440
|
-
readonly pid: number;
|
|
441
|
-
readonly startedAtMs?: number | null;
|
|
442
|
-
readonly startedSinceBootMs?: number | null;
|
|
443
|
-
readonly host?: string | null;
|
|
444
|
-
}): boolean;
|