@sema-agent/core 7.59.0 → 7.60.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +564 -0
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +2 -1
- package/dist/agents/agent-transcript-tool.js +3 -1
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/cumulative-stats.js +0 -1
- package/dist/agents/inherited-tool-pool.d.ts +26 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +13 -2
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +3 -1
- package/dist/agents/send-message-tool.d.ts +8 -19
- package/dist/agents/send-message-tool.js +11 -38
- package/dist/agents/subagent.d.ts +51 -17
- package/dist/agents/subagent.js +117 -78
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/allow-entry.d.ts +2 -0
- package/dist/core/allow-entry.js +3 -1
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +63 -12
- package/dist/core/background-agent-store.d.ts +10 -1
- package/dist/core/background-agent-store.js +3 -2
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-store.d.ts +8 -13
- package/dist/core/checkpoint-store.js +4 -3
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +4 -5
- package/dist/core/engine-notice.d.ts +58 -15
- package/dist/core/frame-settlement.d.ts +5 -0
- package/dist/core/frame-settlement.js +4 -0
- package/dist/core/gate-fold.js +7 -5
- package/dist/core/gate-lanes.js +39 -8
- package/dist/core/governance-codes.d.ts +9 -1
- package/dist/core/governance-codes.js +12 -0
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +39 -56
- package/dist/core/hooks.js +123 -77
- package/dist/core/image-admission.d.ts +104 -51
- package/dist/core/image-admission.js +170 -46
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/locked-config.d.ts +54 -3
- package/dist/core/locked-config.js +81 -50
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-failure.d.ts +9 -3
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-seat.d.ts +92 -0
- package/dist/core/mcp-host-seat.js +131 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +7 -2
- package/dist/core/mcp-server-spec.d.ts +38 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp.d.ts +17 -6
- package/dist/core/mcp.js +67 -55
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +45 -11
- package/dist/core/memory-engine/sync-client.js +82 -11
- package/dist/core/memory-engine/sync-report.d.ts +103 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +4 -2
- package/dist/core/mode-policy.d.ts +9 -1
- package/dist/core/mode-policy.js +11 -1
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +65 -0
- package/dist/core/mods/agent-stations.js +105 -0
- package/dist/core/mods/kernel/dispatch.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +10 -4
- package/dist/core/mods/kernel/events.js +10 -6
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/stations.d.ts +51 -59
- package/dist/core/mods/stations.js +32 -42
- package/dist/core/mods/tool-call.d.ts +10 -4
- package/dist/core/mods/tool-call.js +28 -12
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/own-property-receipt.d.ts +3 -0
- package/dist/core/own-property-receipt.js +3 -0
- package/dist/core/park-selfcheck.js +8 -8
- package/dist/core/peer-seat.d.ts +63 -8
- package/dist/core/peer-seat.js +179 -34
- package/dist/core/permission-rule-consent.d.ts +0 -21
- package/dist/core/permission-rule-consent.js +1 -2
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +7 -6
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +146 -98
- package/dist/core/remote-env.js +113 -14
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +6 -1
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/assemble-result.d.ts +0 -5
- package/dist/core/runner/assemble-result.js +0 -1
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/construction-doors.js +5 -0
- package/dist/core/runner/contracts.d.ts +62 -41
- package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +3 -4
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/permission-rule-lanes.js +1 -1
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +3 -3
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +4 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +14 -9
- package/dist/core/runner/prepare-delegation-surface.d.ts +5 -3
- package/dist/core/runner/prepare-delegation-surface.js +4 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
- package/dist/core/runner/prepare-gate-stations.js +4 -3
- package/dist/core/runner/prepare-hands-readface.d.ts +3 -1
- package/dist/core/runner/prepare-hands-readface.js +15 -7
- package/dist/core/runner/prepare-inherited-gate.d.ts +5 -4
- package/dist/core/runner/prepare-inherited-gate.js +9 -5
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +3 -5
- package/dist/core/runner/prepare-park-ask.js +3 -8
- package/dist/core/runner/prepare-policy-chain.d.ts +5 -4
- package/dist/core/runner/prepare-policy-chain.js +120 -108
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -1
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
- package/dist/core/runner/prepare-suspend-saga.js +5 -7
- package/dist/core/runner/prepare-task.js +41 -27
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +4 -3
- package/dist/core/runner/prepare-wiring-manifest.js +32 -18
- package/dist/core/runner/prepare-workspace-restore.js +3 -3
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/retired-runner-deps.js +4 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +1 -1
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +3 -1
- package/dist/core/runner/run-identity-wiring.js +1 -1
- package/dist/core/runner/run-leg.js +26 -28
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +16 -10
- package/dist/core/runner/run-settle-and-teardown.js +5 -1
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-turn-boundary.js +12 -7
- package/dist/core/runner/runtask.d.ts +7 -4
- package/dist/core/runner/runtask.js +19 -11
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/tool-disclosure.js +0 -2
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/turn-attachments.d.ts +3 -5
- package/dist/core/runner/turn-attachments.js +3 -16
- package/dist/core/runner-deps.d.ts +31 -18
- package/dist/core/secret-env.d.ts +3 -2
- package/dist/core/session-policy-store.d.ts +9 -2
- package/dist/core/session-policy-store.js +16 -1
- package/dist/core/session-store.d.ts +3 -2
- package/dist/core/session-store.js +50 -11
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +18 -2
- package/dist/core/task-notification.d.ts +88 -5
- package/dist/core/task-notification.js +130 -7
- package/dist/core/task-registry-agent.d.ts +18 -12
- package/dist/core/task-registry-agent.js +18 -6
- package/dist/core/task-registry-monitor.d.ts +7 -0
- package/dist/core/task-registry-monitor.js +28 -1
- package/dist/core/task-registry-shared.d.ts +38 -3
- package/dist/core/task-registry-shared.js +21 -7
- package/dist/core/task-registry-workflow.js +1 -1
- package/dist/core/task-registry.d.ts +50 -35
- package/dist/core/task-registry.js +64 -23
- package/dist/core/task-result.d.ts +3 -12
- package/dist/core/task-spec.d.ts +3 -6
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/tool-catalog-entries.js +1 -1
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +4 -3
- package/dist/core/tool-name-aliases.d.ts +19 -0
- package/dist/core/tool-name-aliases.js +54 -2
- package/dist/core/tool-policy.d.ts +5 -4
- package/dist/core/tool-policy.js +1 -1
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +88 -5
- package/dist/core/tool-result-store.js +51 -12
- package/dist/core/tool-spec.d.ts +20 -4
- package/dist/core/trace.d.ts +0 -1
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +14 -6
- package/dist/engine/execution-env/node-execution-env.d.ts +7 -2
- package/dist/engine/execution-env/node-execution-env.js +12 -1
- package/dist/engine/harness/agent-harness.d.ts +1 -1
- package/dist/engine/harness/agent-harness.js +8 -4
- package/dist/engine/harness/types.d.ts +112 -29
- package/dist/engine/loop/agent-loop.d.ts +12 -12
- package/dist/engine/loop/agent-loop.js +153 -21
- package/dist/engine/loop/types.d.ts +9 -2
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/index.d.ts +22 -14
- package/dist/index.js +15 -10
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/orchestration/run-workflow-tool.d.ts +9 -3
- package/dist/orchestration/run-workflow-tool.js +59 -29
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +25 -4
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +3 -1
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +19 -14
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +3 -1
- package/dist/stores/file/index.d.ts +4 -3
- package/dist/stores/file/index.js +17 -8
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +3 -1
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +3 -1
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +3 -1
- package/dist/stores/file/session-store.d.ts +1 -1
- package/dist/stores/file/session-store.js +3 -1
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +20 -2
- package/dist/stores/file/tool-result-store.js +74 -6
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +3 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -11
- package/dist/stores/file/workflow-journal-store.js +3 -2
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
- package/dist/tools/fs/fs-bash-background-text.js +1 -0
- package/dist/tools/fs/fs-bash.d.ts +8 -4
- package/dist/tools/fs/fs-bash.js +26 -35
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +26 -21
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +11 -13
- package/dist/tools/fs/fs-shared.js +11 -7
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +14 -8
- package/dist/tools/fs/index.js +8 -4
- package/dist/tools/fs/read-floor.d.ts +44 -1
- package/dist/tools/fs/read-floor.js +35 -0
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +3 -3
- package/dist/tools/fs/search.js +4 -4
- package/dist/tools/monitor.d.ts +5 -4
- package/dist/tools/monitor.js +15 -8
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/package.json +4 -2
- package/test/export-surface.snapshot.json +75 -21
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import { Type } from "typebox";
|
|
2
2
|
import { defineTool, errorResult } from "../core/tools.js";
|
|
3
3
|
import { governanceBaselineError, governanceBaselineProblem } from "./governance-baseline-validity.js";
|
|
4
|
+
import { formatWorkflowRun, WORKFLOW_RECORD_WHOLE } from "../core/task-registry-shared.js";
|
|
5
|
+
import { persistTaskArtifact } from "../core/tool-result-store.js";
|
|
6
|
+
import { oweTerminalDelivery, resolveCompletionSink } from "../core/task-notification.js";
|
|
4
7
|
import { egressText, egressThrownText, boundedRedactedSummary } from "../core/untrusted-egress.js";
|
|
5
8
|
import { withDelegationProvenance } from "../core/tool-policy.js";
|
|
6
9
|
import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "../agents/launch-receipt-contract.js";
|
|
@@ -53,13 +56,31 @@ function completionSummary(name, run) {
|
|
|
53
56
|
? "; resume found NO journal entries — nothing replayed, the whole script re-ran live"
|
|
54
57
|
: `; resume: replayed ${run.resume.replayed} of ${run.resume.journalEntries} journaled results`;
|
|
55
58
|
return (`workflow${cleanName ? ` "${cleanName}"` : ""} completed${elapsed} — agents ${done}/${run.agents.length} done` +
|
|
56
|
-
`${failed > 0 ? ` (${failed} failed)` : ""}${resumeClause}
|
|
59
|
+
`${failed > 0 ? ` (${failed} failed)` : ""}${resumeClause}`);
|
|
60
|
+
}
|
|
61
|
+
const WORKFLOW_NOTIFY_ROWS_MAX = 5;
|
|
62
|
+
function workflowRecordTeach(run, artifact) {
|
|
63
|
+
const notDone = run.agents.filter((a) => a.status !== "completed");
|
|
64
|
+
const rows = notDone
|
|
65
|
+
.slice(0, WORKFLOW_NOTIFY_ROWS_MAX)
|
|
66
|
+
.map((a) => `${a.label}: ${a.status}${a.errorMessage !== undefined ? ` — ${boundedRedactedSummary(a.errorMessage, 160)}` : ""}`);
|
|
67
|
+
const rowsTeach = notDone.length === 0
|
|
68
|
+
? ""
|
|
69
|
+
: `Agents that did not complete (${notDone.length} of ${run.agents.length}${notDone.length > rows.length ? `, first ${rows.length} shown` : ""}): ${rows.join("; ")}. `;
|
|
70
|
+
const recordTeach = artifact.kind === "stored"
|
|
71
|
+
? `Full record (the result and every agent's row): read it with ReadToolResult (ref "${artifact.ref}") before assuming an empty or unexpected result.`
|
|
72
|
+
: artifact.kind === "unconfirmed"
|
|
73
|
+
? "The full record (the result and every agent's row) could not be stored (the write failed or went unconfirmed), so no ref can read it back; TaskOutput reads it where mounted."
|
|
74
|
+
: "The full record (the result and every agent's row) is not stored behind a ref (no offload store); TaskOutput reads it where mounted.";
|
|
75
|
+
return `${rowsTeach}${recordTeach}`;
|
|
57
76
|
}
|
|
58
77
|
function completionIdFromRejection(err) {
|
|
78
|
+
return workflowRunOfRejection(err)?.completionId;
|
|
79
|
+
}
|
|
80
|
+
function workflowRunOfRejection(err) {
|
|
59
81
|
if (err === null || (typeof err !== "object" && typeof err !== "function"))
|
|
60
82
|
return undefined;
|
|
61
|
-
|
|
62
|
-
return run?.completionId;
|
|
83
|
+
return err.workflowRun;
|
|
63
84
|
}
|
|
64
85
|
function workflowUsageBlock(run) {
|
|
65
86
|
const agents = run.agents;
|
|
@@ -79,19 +100,19 @@ function workflowUsageBlock(run) {
|
|
|
79
100
|
...(run.endedAt !== undefined ? { duration_ms: run.endedAt - run.startedAt } : {}),
|
|
80
101
|
};
|
|
81
102
|
}
|
|
82
|
-
function workflowDiagnostics(runId, journalRef, resumeMiss) {
|
|
103
|
+
function workflowDiagnostics(runId, journalRef, resumeMiss, record) {
|
|
83
104
|
const journalTeach = journalRef === undefined
|
|
84
105
|
? ""
|
|
85
106
|
: journalRef.includes("://")
|
|
86
|
-
? ` Full journal: ${journalRef}.`
|
|
87
|
-
: ` Full journal: ${journalRef} (a deployment data path —
|
|
107
|
+
? ` Full journal (the step log resumeFromRunId replays): ${journalRef}.`
|
|
108
|
+
: ` Full journal (the step log resumeFromRunId replays): ${journalRef} (a deployment data path — it may be outside the paths Read can reach).`;
|
|
88
109
|
const resumeMissTeach = resumeMiss
|
|
89
110
|
? ` NOTE: this was a resume, but the prior run's journal was not usable under this scope — verify the runId and that this deployment wires a journalStore; the results above are from a full live re-run.`
|
|
90
111
|
: "";
|
|
91
|
-
return (
|
|
112
|
+
return ((record ?? "") +
|
|
92
113
|
journalTeach +
|
|
93
114
|
resumeMissTeach +
|
|
94
|
-
` To continue after editing the script: re-invoke with resumeFromRunId: "${runId}" (completed agents replay from the journal; only new/changed calls run).`);
|
|
115
|
+
` To continue after editing the script: re-invoke with resumeFromRunId: "${runId}" (completed agents replay from the journal; only new/changed calls run).`).trimStart();
|
|
95
116
|
}
|
|
96
117
|
const SCRIPT_ERROR_CODES = new Set([
|
|
97
118
|
"workflow.script_error",
|
|
@@ -109,11 +130,11 @@ function failureSummary(err, runId) {
|
|
|
109
130
|
if (code === WORKFLOW_AGENT_PARKED_ERROR_CODE) {
|
|
110
131
|
const msg = typeof e?.message === "string" ? egressText("same-principal", e.message) : "";
|
|
111
132
|
return (`workflow parked (${code}): ${msg.length > 200 ? `${msg.slice(0, 200)}…` : msg} — it did not fail and is not finished` +
|
|
112
|
-
(runId ? `;
|
|
133
|
+
(runId ? `; the diagnostics below name its record (the parked agent's row reads status "parked")` : "") +
|
|
113
134
|
`; do not re-issue the same call — once the approval is decided, the deployment resumes this run${runId ? ` (resumeFromRunId: "${runId}")` : ""} and the script continues from the parked call`);
|
|
114
135
|
}
|
|
115
136
|
const guide = runId
|
|
116
|
-
? `;
|
|
137
|
+
? `; which agents failed is in the diagnostics below; after fixing, re-invoke with resumeFromRunId: "${runId}" (completed agents replay from the journal)`
|
|
117
138
|
: "";
|
|
118
139
|
if (code && SCRIPT_ERROR_CODES.has(code) && typeof e?.message === "string") {
|
|
119
140
|
const msg = egressText("same-principal", e.message);
|
|
@@ -480,6 +501,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
480
501
|
let handle;
|
|
481
502
|
const workflowTaskId = d.taskRegistry?.mintTaskId("workflow");
|
|
482
503
|
const autoModeReview = ctx.autoModeReview ?? d.autoModeReview?.();
|
|
504
|
+
const agentStations = ctx.agentStations ?? d.agentStations?.();
|
|
483
505
|
const centerFromCtx = ctx.centerArtifactDigest !== undefined;
|
|
484
506
|
const parentCenterArtifactDigest = centerFromCtx ? ctx.centerArtifactDigest : d.parentCenterArtifactDigest?.();
|
|
485
507
|
const parentCenterSourceRevision = centerFromCtx ? ctx.centerSourceRevision : d.parentCenterSourceRevision?.();
|
|
@@ -545,6 +567,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
545
567
|
? { inheritedGate: (ctx.inheritedGateForChildren ?? d.inheritedGateForChildren)() }
|
|
546
568
|
: {}),
|
|
547
569
|
...(autoModeReview !== undefined ? { autoModeReview } : {}),
|
|
570
|
+
...(agentStations !== undefined ? { agentStations } : {}),
|
|
548
571
|
}, { workflowDepth: d.workflowDepth, ...((ctx.toolSelector?.layers ?? d.parentToolCeiling) !== undefined ? { toolCeiling: (ctx.toolSelector?.layers ?? d.parentToolCeiling) } : {}) });
|
|
549
572
|
}
|
|
550
573
|
catch (err) {
|
|
@@ -582,6 +605,8 @@ async function mountRunWorkflowTool(d) {
|
|
|
582
605
|
},
|
|
583
606
|
});
|
|
584
607
|
}
|
|
608
|
+
const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
|
|
609
|
+
oweTerminalDelivery(completionSink, { task_id: runId, task_type: "workflow" });
|
|
585
610
|
{
|
|
586
611
|
let notified = false;
|
|
587
612
|
const fire = (notification) => {
|
|
@@ -589,7 +614,7 @@ async function mountRunWorkflowTool(d) {
|
|
|
589
614
|
return;
|
|
590
615
|
notified = true;
|
|
591
616
|
try {
|
|
592
|
-
|
|
617
|
+
completionSink?.(notification, { priority: "next" });
|
|
593
618
|
}
|
|
594
619
|
catch {
|
|
595
620
|
}
|
|
@@ -613,8 +638,14 @@ async function mountRunWorkflowTool(d) {
|
|
|
613
638
|
}))
|
|
614
639
|
.catch(() => { });
|
|
615
640
|
};
|
|
641
|
+
const recordOf = async (run) => {
|
|
642
|
+
const artifact = await persistTaskArtifact(d.taskArtifacts, runId, formatWorkflowRun(run, WORKFLOW_RECORD_WHOLE).content);
|
|
643
|
+
if (artifact.kind === "stored")
|
|
644
|
+
d.taskRegistry?.recordArtifactRef(runId, artifact.ref, 0);
|
|
645
|
+
return workflowRecordTeach(run, artifact);
|
|
646
|
+
};
|
|
616
647
|
handle.done
|
|
617
|
-
.then((res) => fire({
|
|
648
|
+
.then(async (res) => fire({
|
|
618
649
|
task_id: runId,
|
|
619
650
|
task_type: "workflow",
|
|
620
651
|
...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}),
|
|
@@ -622,17 +653,22 @@ async function mountRunWorkflowTool(d) {
|
|
|
622
653
|
summary: completionSummary(meta.name, res.run),
|
|
623
654
|
result: boundedRedactedSummary(res.result, 4000),
|
|
624
655
|
usage: workflowUsageBlock(res.run),
|
|
625
|
-
diagnostics: workflowDiagnostics(runId, d.journalStore?.locator?.(runId, res.run.scope), res.run.resume?.journalEntries === 0),
|
|
656
|
+
diagnostics: workflowDiagnostics(runId, d.journalStore?.locator?.(runId, res.run.scope), res.run.resume?.journalEntries === 0, await recordOf(res.run).catch(() => "This run's record could not be read.")),
|
|
626
657
|
completionId: res.run.completionId,
|
|
627
|
-
}), (err) =>
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
658
|
+
}), async (err) => {
|
|
659
|
+
const carried = workflowRunOfRejection(err);
|
|
660
|
+
const failedRun = (carried?.id === runId && Array.isArray(carried.agents) ? carried : undefined) ?? (d.store !== undefined ? ((await d.store.get(runId).catch(() => null)) ?? undefined) : undefined);
|
|
661
|
+
const record = failedRun !== undefined ? await recordOf(failedRun).catch(() => "This run's record could not be read.") : "This failure carries no record of the run's agents and no run store holds one.";
|
|
662
|
+
fire({
|
|
663
|
+
task_id: runId,
|
|
664
|
+
task_type: "workflow",
|
|
665
|
+
...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}),
|
|
666
|
+
status: "failed",
|
|
667
|
+
summary: failureSummary(err, runId),
|
|
668
|
+
diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
|
|
669
|
+
...(completionIdFromRejection(err) !== undefined ? { completionId: completionIdFromRejection(err) } : {}),
|
|
670
|
+
});
|
|
671
|
+
})
|
|
636
672
|
.catch(() => { });
|
|
637
673
|
}
|
|
638
674
|
return {
|
|
@@ -645,20 +681,14 @@ async function mountRunWorkflowTool(d) {
|
|
|
645
681
|
handling: `${launchReceiptNoQuoteClause(" (the ids above, and scriptPath when present)")} ${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE}`,
|
|
646
682
|
note: (() => {
|
|
647
683
|
const pollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}" })` : undefined;
|
|
648
|
-
const blockingPollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}", block: true })` : undefined;
|
|
649
684
|
const journalRef = d.journalStore?.locator?.(runId, taskScope ?? d.scope ?? "");
|
|
650
685
|
const carries = pollExpr
|
|
651
686
|
? ` A terminal ${pollExpr} reply carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`
|
|
652
687
|
: "";
|
|
653
|
-
if (parentSpecSeat?.oneShot === true) {
|
|
654
|
-
return blockingPollExpr
|
|
655
|
-
? `This is a ONE-SHOT submission (e.g. headless \`-p\`) — there is no later turn for a background notification to land in, so do NOT end your turn expecting one. Actively wait instead: ${blockingPollExpr}. If it is still running after the wait, wait again (bounded) rather than ending the turn, or write out your best available answer now if you are near your own time budget.${carries}`
|
|
656
|
-
: "This is a one-shot submission (e.g. headless `-p`) and no poll path is available — the workflow's outcome may not be recoverable after this turn ends.";
|
|
657
|
-
}
|
|
658
688
|
if (d.notifier) {
|
|
659
689
|
return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll unless the user asks for progress.${carries}`;
|
|
660
690
|
}
|
|
661
|
-
if (
|
|
691
|
+
if (completionSink) {
|
|
662
692
|
return `The workflow runs asynchronously. Its completion is injected into THIS session if it is still active; if you have ended your turn and hear nothing, ${pollExpr ? `poll ${pollExpr}` : "there is no poll path wired"}.${carries}`;
|
|
663
693
|
}
|
|
664
694
|
return pollExpr
|
|
@@ -92,7 +92,7 @@ export interface WorkflowAgentSpec extends ScriptClampSeats {
|
|
|
92
92
|
* restricting value, an add-only row through the row's script and entry laws. A row marked inherited-only (its
|
|
93
93
|
* restricting value switches off an operator-side record) is outside this set and is stripped like any other key.
|
|
94
94
|
*/
|
|
95
|
-
export declare const WHITELIST_KEYS: readonly ("
|
|
95
|
+
export declare const WHITELIST_KEYS: readonly ("thinking" | "systemPrompt" | "objective" | "images" | "limits" | ScriptSeat | "modelName")[];
|
|
96
96
|
/**
|
|
97
97
|
* #505 ② — ACCEPTED ALIAS SPELLINGS on the spec: `alias → the {@link WHITELIST_KEYS} member it means`.
|
|
98
98
|
*
|
|
@@ -5,6 +5,7 @@ import { CLAMP_SET, SCRIPT_SEATS } from "../core/child-clamp-seats.js";
|
|
|
5
5
|
import { WorkflowScriptError } from "./workflow-meta.js";
|
|
6
6
|
import { uuidv7 } from "../engine/session/uuid.js";
|
|
7
7
|
import { retiredCheckpointStoreNull } from "../core/checkpoint-store.js";
|
|
8
|
+
import { catalogModel } from "../core/roles.js";
|
|
8
9
|
import { thrownText } from "../core/thrown-value.js";
|
|
9
10
|
export class WorkflowModelNotAllowedError extends Error {
|
|
10
11
|
modelName;
|
|
@@ -98,7 +99,7 @@ export function resolveModelName(name, allowlist, models) {
|
|
|
98
99
|
if (!allowlist.includes(name)) {
|
|
99
100
|
throw new WorkflowModelNotAllowedError(name, `not in the workflow model allowlist [${allowlist.join(", ")}]`);
|
|
100
101
|
}
|
|
101
|
-
const model =
|
|
102
|
+
const model = catalogModel(name, models, "workflowModelAllowlist");
|
|
102
103
|
if (!model) {
|
|
103
104
|
throw new WorkflowModelNotAllowedError(name, "allowed by name but not present in RunnerDeps.models");
|
|
104
105
|
}
|
|
@@ -582,6 +582,10 @@ export interface RunWorkflowOptions {
|
|
|
582
582
|
autoModeReview?: {
|
|
583
583
|
decider: import("../core/auto-mode.js").AutoModeDecider;
|
|
584
584
|
};
|
|
585
|
+
/** The host leg's agent stations: each script-spawned child raises `agent.spawn` on the host's bus (as a workflow
|
|
586
|
+
* agent) before it starts — the delegation lane raises it at its own pre-launch point. ABSENT ⇒ nothing is raised.
|
|
587
|
+
* TRUSTED: never a script/model argument. */
|
|
588
|
+
agentStations?: import("../core/mods/agent-stations.js").AgentStations;
|
|
585
589
|
/** F7/B7 (CC pretty.js:446478): PRE-REGISTER the script's `meta.phases` as pending progress groups at run
|
|
586
590
|
* start — the plan is visible before execution; `phase(title)` adopts the matching pending entry. */
|
|
587
591
|
phases?: ReadonlyArray<{
|
|
@@ -23,6 +23,8 @@ import { delimitUntrusted } from "../core/untrusted-text.js";
|
|
|
23
23
|
import { OUTPUT_TOOL_NAME } from "../core/tool-catalog-entries.js";
|
|
24
24
|
import { deniedToolNamesOf, judgeHostToolCeiling } from "../core/runner/sub-agent-deny-lists.js";
|
|
25
25
|
import { namesEveryTool } from "../agents/tool-filter.js";
|
|
26
|
+
import { definitionAllowTools, withDefinitionServers } from "../agents/inherited-tool-pool.js";
|
|
27
|
+
import { snapshotAndValidateMcpEntries } from "../core/locked-config.js";
|
|
26
28
|
import { compileOutputSchema } from "../core/runner/strict-output-schema.js";
|
|
27
29
|
import { WorkflowBudgetExceededError, WorkflowNestingError, WorkflowAgentBlockedError, WorkflowAgentParkedError, WorkflowAgentSchemaError, WorkflowAgentStalledError, WorkflowMaxAgentsError, WORKFLOW_SPAWN_BLOCKED_ERROR_CODE } from "./workflow-types.js";
|
|
28
30
|
import { WorkflowScriptError } from "./workflow-meta.js";
|
|
@@ -121,8 +123,13 @@ export function applyWorkflowAgentType(spec, agentType, registry) {
|
|
|
121
123
|
out.memory = def.memory;
|
|
122
124
|
if (out.memoryPersistenceCapable === undefined && def.memoryPersistenceCapable !== undefined)
|
|
123
125
|
out.memoryPersistenceCapable = def.memoryPersistenceCapable;
|
|
126
|
+
const declared = def.mcp;
|
|
127
|
+
const ownServers = declared !== undefined ? snapshotAndValidateMcpEntries(declared, `AgentDefinition.mcp of ${JSON.stringify(def.name.slice(0, 80))}`) : undefined;
|
|
128
|
+
if (ownServers !== undefined && ownServers.length > 0)
|
|
129
|
+
out.mcp = withDefinitionServers(out.mcp !== undefined ? snapshotAndValidateMcpEntries(out.mcp) : undefined, ownServers);
|
|
124
130
|
if (def.allowTools !== undefined || def.denyTools !== undefined) {
|
|
125
|
-
const
|
|
131
|
+
const written = definitionAllowTools({ allowTools: def.allowTools, ...(ownServers !== undefined ? { mcp: ownServers } : {}) });
|
|
132
|
+
const allow = written !== undefined && !written.some(namesEveryTool) ? written : undefined;
|
|
126
133
|
const perType = createAllowDenyPolicy({ ...(allow ? { allow } : {}), ...(def.denyTools ? { deny: deniedToolNamesOf(`workflow agentType "${def.name}"`, def.denyTools) } : {}) });
|
|
127
134
|
out.toolPolicy = out.toolPolicy ? combinePolicies(out.toolPolicy, perType) : perType;
|
|
128
135
|
}
|
|
@@ -1572,7 +1579,21 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1572
1579
|
const model = workflowModelLabel(specForLabel, modelCatalog);
|
|
1573
1580
|
return { label, phase, phaseInstance, groupId, inheritedModelSnap, inheritedModelRef: inheritedModelPick?.modelRef, inheritedModelError, inheritedThinkingSnap, callKey, prompt, model };
|
|
1574
1581
|
};
|
|
1575
|
-
const reviewSpawnBeforeLaunch = async (lane, label, callKey, runSpec, effectiveSignal) => {
|
|
1582
|
+
const reviewSpawnBeforeLaunch = async (lane, label, callKey, runSpec, effectiveSignal, agentType, driven) => {
|
|
1583
|
+
if (opts.agentStations?.listens("agent.spawn") === true && !driven) {
|
|
1584
|
+
const verdict = await opts.agentStations.spawn({
|
|
1585
|
+
toolCallId: opts.parentToolCallId ?? callKey,
|
|
1586
|
+
prompt: typeof runSpec.objective === "string" ? runSpec.objective : "",
|
|
1587
|
+
description: label,
|
|
1588
|
+
subagentType: agentType ?? "general-purpose",
|
|
1589
|
+
...(typeof runSpec.model === "string" ? { model: runSpec.model } : typeof runSpec.model === "object" && runSpec.model !== null ? { model: runSpec.model.id } : {}),
|
|
1590
|
+
background: false,
|
|
1591
|
+
fork: false,
|
|
1592
|
+
workflow: true,
|
|
1593
|
+
}, effectiveSignal);
|
|
1594
|
+
if (!verdict.go)
|
|
1595
|
+
throw new WorkflowAgentBlockedError(label, "extension", verdict.reason);
|
|
1596
|
+
}
|
|
1576
1597
|
const review = opts.autoModeReview;
|
|
1577
1598
|
if (review === undefined)
|
|
1578
1599
|
return runSpec;
|
|
@@ -1863,7 +1884,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
1863
1884
|
? { ...seatedSpec, ...authInherit, ...parkInherit, signal: effectiveSignal, outputSchema: agentOpts.schema }
|
|
1864
1885
|
: { ...seatedSpec, ...authInherit, ...parkInherit, signal: effectiveSignal };
|
|
1865
1886
|
judgeHostCeiling(preReviewSpec);
|
|
1866
|
-
const runSpec = await reviewSpawnBeforeLaunch("ctx.agent", label, callKey, preReviewSpec, effectiveSignal);
|
|
1887
|
+
const runSpec = await reviewSpawnBeforeLaunch("ctx.agent", label, callKey, preReviewSpec, effectiveSignal, agentOpts.agentType, drive !== undefined);
|
|
1867
1888
|
const enrichedForward = opts.onForwardEvent !== undefined
|
|
1868
1889
|
? (e) => {
|
|
1869
1890
|
opts.onForwardEvent(e.type === "task_progress" || e.type === "task_started" ? { ...e, workflowRunId: runId, workflowAgentLabel: label } : e);
|
|
@@ -2251,7 +2272,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
|
|
|
2251
2272
|
: { ...seatedSpec, ...authInherit, ...parkInherit, signal: effectiveSignal };
|
|
2252
2273
|
const preReviewSpec = childSessionId !== undefined ? { ...baseRunSpec, sessionId: childSessionId } : baseRunSpec;
|
|
2253
2274
|
judgeHostCeiling(preReviewSpec);
|
|
2254
|
-
const runSpec = await reviewSpawnBeforeLaunch("ctx.agentStream", label, callKey, preReviewSpec, effectiveSignal);
|
|
2275
|
+
const runSpec = await reviewSpawnBeforeLaunch("ctx.agentStream", label, callKey, preReviewSpec, effectiveSignal, agentOpts.agentType, drive !== undefined);
|
|
2255
2276
|
const enrichedForwardS = opts.onForwardEvent !== undefined
|
|
2256
2277
|
? (e) => {
|
|
2257
2278
|
opts.onForwardEvent(e.type === "task_progress" || e.type === "task_started" ? { ...e, workflowRunId: runId, workflowAgentLabel: label } : e);
|
|
@@ -44,13 +44,6 @@ export declare const MEMORY_SAFETY = "## Memory\nWhen you save a durable note to
|
|
|
44
44
|
* Name-free for the same reason as {@link MEMORY_SAFETY} — see the note there.
|
|
45
45
|
*/
|
|
46
46
|
export declare const MEMORY_HYGIENE = "What's worth saving \u2014 organize by topic, not by when it happened:\n- who the user is \u2014 role, expertise, durable preferences;\n- guidance the user gave on HOW to work \u2014 corrections and confirmed approaches, with the reason why;\n- ongoing goals or constraints that aren't derivable from the code or its history;\n- pointers to external resources (URLs, dashboards, tickets).\n\nHygiene:\n- Convert relative dates (\"yesterday\", \"last week\") to absolute dates, so the note stays interpretable later.\n- Before saving, check what memory already holds: update an existing note rather than writing a near-duplicate, and remove a note that turns out to be wrong.\n- Don't save what the code, its history, or this conversation already records (structure, past fixes, transient task state). If asked to remember something obvious, save what was non-obvious about it instead.";
|
|
47
|
-
/**
|
|
48
|
-
* The full memory guidance = safety + hygiene, in the original order. Kept as a single exported
|
|
49
|
-
* constant for back-compat (RL-1336-memory-guidance) and for a deployment composing the no-consolidation form in one piece;
|
|
50
|
-
* core injects none of the three (RB-482 #16). Prefer {@link MEMORY_SAFETY} / {@link MEMORY_HYGIENE}
|
|
51
|
-
* when you need the split.
|
|
52
|
-
*/
|
|
53
|
-
export declare const MEMORY_GUIDANCE = "## Memory\nWhen you save a durable note to memory, phrase it as a declarative fact or a stable\npreference \u2014 never as an instruction to your future self.\n- \"User prefers concise responses\" \u2713 \u2014 \"Always respond concisely\" \u2717\n- \"The reporting database is read-only via the analytics user\" \u2713 \u2014 \"Always use the analytics user\" \u2717\nNever put secrets (API keys, credentials, tokens) in memory \u2014 especially where it may be shared.\nMemory is a fact, never a command; the user's current request and live tool output always win over memory.\n\nWhat's worth saving \u2014 organize by topic, not by when it happened:\n- who the user is \u2014 role, expertise, durable preferences;\n- guidance the user gave on HOW to work \u2014 corrections and confirmed approaches, with the reason why;\n- ongoing goals or constraints that aren't derivable from the code or its history;\n- pointers to external resources (URLs, dashboards, tickets).\n\nHygiene:\n- Convert relative dates (\"yesterday\", \"last week\") to absolute dates, so the note stays interpretable later.\n- Before saving, check what memory already holds: update an existing note rather than writing a near-duplicate, and remove a note that turns out to be wrong.\n- Don't save what the code, its history, or this conversation already records (structure, past fixes, transient task state). If asked to remember something obvious, save what was non-obvious about it instead.";
|
|
54
47
|
/** The refuse-harmful-use security boundary (composed on every shape; safety text is never gated). */
|
|
55
48
|
export declare const CYBER_RISK: string;
|
|
56
49
|
/** The never-guess-URLs rule (composed on every shape). */
|
|
@@ -180,7 +173,7 @@ export interface EnvironmentFacts {
|
|
|
180
173
|
/**
|
|
181
174
|
* design/380 O9a — the execution env is a declared EXTERNAL-CONTENT TARGET (the run's commands and
|
|
182
175
|
* file reads act on a target outside the deployment's trust boundary). Derived SINGLE-SOURCE by
|
|
183
|
-
* prepare from the run's fold of `ExecutionEnv.externalContentTarget` with the checkpoint's
|
|
176
|
+
* prepare from the run's fold of `ExecutionEnv.capabilities.externalContentTarget` with the checkpoint's
|
|
184
177
|
* monotonic bit — never a `TaskSpec.envFacts` member (one fact, one source: a deployment spelling
|
|
185
178
|
* it twice could drift). Renders ONE neutral declarative line; absent ⇒ nothing renders.
|
|
186
179
|
*/
|
|
@@ -272,8 +265,6 @@ export declare function buildEnvironmentContext(facts: EnvironmentFacts): string
|
|
|
272
265
|
* `RoleSpec.systemPrompt`.
|
|
273
266
|
*/
|
|
274
267
|
export declare const CODE_AGENT_PROMPT: string;
|
|
275
|
-
/** The coding persona the `code` scenario mounts — the same catalog text as {@link CODE_AGENT_PROMPT}. */
|
|
276
|
-
export declare const CODE_SYSTEM_PROMPT: string;
|
|
277
268
|
/** One labelled block of the assembled stable prompt — the unit of the `prompt.assembled` trace manifest. */
|
|
278
269
|
export interface PromptBlock {
|
|
279
270
|
/** Stable identifier (e.g. `role.base`, `harness.context`, `memory.safety`, `mcp.instructions`). */
|
package/dist/prompts/default.js
CHANGED
|
@@ -23,7 +23,6 @@ Hygiene:
|
|
|
23
23
|
- Convert relative dates ("yesterday", "last week") to absolute dates, so the note stays interpretable later.
|
|
24
24
|
- Before saving, check what memory already holds: update an existing note rather than writing a near-duplicate, and remove a note that turns out to be wrong.
|
|
25
25
|
- Don't save what the code, its history, or this conversation already records (structure, past fixes, transient task state). If asked to remember something obvious, save what was non-obvious about it instead.`;
|
|
26
|
-
export const MEMORY_GUIDANCE = `${MEMORY_SAFETY}\n\n${MEMORY_HYGIENE}`;
|
|
27
26
|
export const CYBER_RISK = catalogText("core/security.cyber-risk");
|
|
28
27
|
export const URL_SAFETY = catalogText("core/security.url-safety");
|
|
29
28
|
export const SUMMARIZE_TOOL_RESULTS = catalogText("core/harness.tool-result-retention");
|
|
@@ -177,4 +176,3 @@ export function buildEnvironmentContext(facts) {
|
|
|
177
176
|
return sections.join("\n\n");
|
|
178
177
|
}
|
|
179
178
|
export const CODE_AGENT_PROMPT = catalogText("core/role.base", "code");
|
|
180
|
-
export const CODE_SYSTEM_PROMPT = CODE_AGENT_PROMPT;
|
|
@@ -17,7 +17,7 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
|
|
|
17
17
|
/** RB-145: this instance's own close latch — the refcount belongs to the DIRECTORY, not to callers. */
|
|
18
18
|
private closed;
|
|
19
19
|
private get rows();
|
|
20
|
-
constructor(root: string,
|
|
20
|
+
constructor(root: string, options?: FileBackgroundAgentStoreOptions);
|
|
21
21
|
/**
|
|
22
22
|
* RB-60 (2026-07-25, red probe): the composite key must be INJECTIVE — `get`/`update` no longer re-check
|
|
23
23
|
* scope, so tenant isolation rests entirely on this function. A SPACE separator is not injective
|
|
@@ -3,6 +3,7 @@ import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, assertBackgr
|
|
|
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
|
+
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
6
7
|
const isAgentRow = (x) => x !== null && typeof x === "object" && typeof x.handle === "string" && typeof x.scope === "string";
|
|
7
8
|
const agentLedgers = new SharedLedgerTable({
|
|
8
9
|
label: "background-agent ledger",
|
|
@@ -30,7 +31,8 @@ export class FileBackgroundAgentStore {
|
|
|
30
31
|
get rows() {
|
|
31
32
|
return this.ledger.rows;
|
|
32
33
|
}
|
|
33
|
-
constructor(root,
|
|
34
|
+
constructor(root, options) {
|
|
35
|
+
const opts = receiveOptions(options, "FileBackgroundAgentStore");
|
|
34
36
|
assertAdoptionBootGate(root, "FileBackgroundAgentStore");
|
|
35
37
|
this.fsyncEnabled = opts.fsync !== false;
|
|
36
38
|
this.compactEvery = opts.compactEvery ?? 1000;
|
|
@@ -1,9 +1,91 @@
|
|
|
1
1
|
import { type ExecutionOutcomeRecordWord } from "../../core/checkpoint-execution-record.js";
|
|
2
2
|
import { type HolderJudge } from "../../core/checkpoint-generation.js";
|
|
3
|
-
import { type Checkpoint, type PendingSteerInput, type CheckpointFaultMode, type CheckpointStore, type CheckpointSummary, type CheckpointToken, type ReopenReason, type ResolveExpectation, type ResumeOutcome } from "../../core/checkpoint-store.js";
|
|
3
|
+
import { type Checkpoint, type PendingSteerEntry, type PendingSteerInput, type CheckpointFaultMode, type CheckpointStore, type CheckpointSummary, type CheckpointToken, type ReopenReason, type ResolveExpectation, type ResumeOutcome } from "../../core/checkpoint-store.js";
|
|
4
4
|
import type { GateOutcome } from "../../core/gate-outcome.js";
|
|
5
5
|
import { type CheckpointDeleteGuard, type CheckpointOverdueCursor, type CheckpointOverdueQuery, type CheckpointPage, type CheckpointRowRead, type CheckpointSessionCursor, type CheckpointSessionQuery } from "../../core/checkpoint-queries.js";
|
|
6
|
+
import type { AssertAllKeysHandled } from "../../core/ask-origin.js";
|
|
6
7
|
import { type CorruptReadInfo } from "./corrupt-read-sink.js";
|
|
8
|
+
/**
|
|
9
|
+
* design/80 §2.4 — THE LOAD-BEARING file store: a {@link CheckpointStore} whose once-only CAS is
|
|
10
|
+
* behaviorally IDENTICAL to {@link import("../../core/checkpoint-store.js").InMemoryCheckpointStore}.
|
|
11
|
+
*
|
|
12
|
+
* **The decisive simplification (§2.4): the local binary is ONE process, one Node event loop.** So the
|
|
13
|
+
* multi-process file-locking literature (per-op `flock`, `O_EXCL` lockfiles) buys nothing — there is NO
|
|
14
|
+
* per-operation lock. Correctness instead rests on three things, exactly mirroring the in-memory store:
|
|
15
|
+
*
|
|
16
|
+
* 1. **In-process async mutex per token** — a `Map<token, Promise>` serialization chain (the SAME shape as
|
|
17
|
+
* `TtlSessionStore.pending`): `resolve`/`reopen`/`expire`/`setPendingSteer`/`put` on a given token chain
|
|
18
|
+
* behind one another, so no two interleaved async tasks can both read `pending` and both commit.
|
|
19
|
+
* 2. **Authoritative state = an in-memory `Map<token, Checkpoint>`**, rebuilt by replaying
|
|
20
|
+
* `checkpoints.jsonl` (+ a compacted `snapshot`) at boot, last-writer-wins by event order (the latest
|
|
21
|
+
* event's status / resolvedOutcome / reopenReason / rev win — the "authoritative fields outside the blob"
|
|
22
|
+
* rule Pg implements with columns).
|
|
23
|
+
* 3. **Commit ordering = appendLine the event + fsync BEFORE flipping the in-memory map** — so a crash can
|
|
24
|
+
* never leave "memory says resolved, disk says pending". A crash *before* the fsync'd append replays as
|
|
25
|
+
* `pending` (a retry can still win); a crash *after* replays as `resolved` (a retry is a no-op `false`).
|
|
26
|
+
* This matches the `testInjectFault` `resolve-before-commit` / `resolve-after-commit` contract exactly.
|
|
27
|
+
*
|
|
28
|
+
* The CAS predicate is byte-for-byte the in-memory one: `row && row.scope === scope && row.status ===
|
|
29
|
+
* 'pending'` plus the `expect.rev` OCC; `setPendingSteer` runs {@link validatePendingSteer} FIRST (before
|
|
30
|
+
* the row lookup); the winner comes from {@link winnerFromOutcome}. NO per-operation flock.
|
|
31
|
+
*
|
|
32
|
+
* **What makes premise 1 true (and what used to only assume it):** the CONSTRUCTOR takes a coarse
|
|
33
|
+
* cross-process writer fence on the ledger directory (`root/checkpoints/LOCK`, via
|
|
34
|
+
* {@link import("./fs-atomic.js").acquireStoreDirLock}) — a second OS process over the same data root is
|
|
35
|
+
* refused loudly ({@link import("./fs-atomic.js").FileStoreLockError}, code `store.dir_in_use`) instead
|
|
36
|
+
* of quietly replaying a private view. Instances INSIDE this process share that fence exactly as they
|
|
37
|
+
* share the authority (refcounted; the last {@link FileCheckpointStore.close} drops it), and a lock left
|
|
38
|
+
* by a dead pid is pruned as stale, so a crash never needs manual cleanup. Before this the doc named a
|
|
39
|
+
* fence this class never took — `FileStorageBackend`'s `root/LOCK` — which meant nothing at all for the
|
|
40
|
+
* direct construction the root export invites: two processes each won the once-only CAS on the same
|
|
41
|
+
* token (approval AND refusal both reported as the winner), and the process that had never loaded the
|
|
42
|
+
* other's rows erased them at its next compaction, with no error on either side.
|
|
43
|
+
*/
|
|
44
|
+
/** One persisted ledger event. The replay folds these in order into the authoritative map. */
|
|
45
|
+
type LedgerEvent = {
|
|
46
|
+
t: "put";
|
|
47
|
+
token: string;
|
|
48
|
+
cp: Checkpoint;
|
|
49
|
+
} | {
|
|
50
|
+
t: "resolve";
|
|
51
|
+
token: string;
|
|
52
|
+
rev: number;
|
|
53
|
+
resolvedOutcome?: Checkpoint["resolvedOutcome"];
|
|
54
|
+
} | {
|
|
55
|
+
t: "reopen";
|
|
56
|
+
token: string;
|
|
57
|
+
rev: number;
|
|
58
|
+
reason: ReopenReason;
|
|
59
|
+
}
|
|
60
|
+
/** The execution-outcome record (CheckpointRow.executionOutcome): written once per row by
|
|
61
|
+
* `recordExecutionOutcome`; the replay sets both columns together. A binary released before this kind
|
|
62
|
+
* refuses the replay at the discriminator fence below while the event is still in the live ledger;
|
|
63
|
+
* once compaction has folded it into a snapshot row, that older binary reads the row with a field it
|
|
64
|
+
* does not know and its `reopen` (the pre-record predicate) ignores it — the same rollback shape the
|
|
65
|
+
* queue event above documents, disclosed in the release notes rather than fenced here. */
|
|
66
|
+
| {
|
|
67
|
+
t: "execution";
|
|
68
|
+
token: string;
|
|
69
|
+
gate: GateOutcome;
|
|
70
|
+
atMs: number;
|
|
71
|
+
} | {
|
|
72
|
+
t: "expire";
|
|
73
|
+
token: string;
|
|
74
|
+
}
|
|
75
|
+
/** The row is gone (`deleteSessionCheckpoints`): the replay removes it from the map, and the next compaction writes no line for it. A
|
|
76
|
+
* binary released before this kind refuses the replay at the discriminator fence while the event is in the live ledger; once a
|
|
77
|
+
* compaction has folded it away the directory reads on that binary again — the store-format note the release carries. */
|
|
78
|
+
| {
|
|
79
|
+
t: "delete";
|
|
80
|
+
token: string;
|
|
81
|
+
}
|
|
82
|
+
/** design/171 §5.3 — one APPENDED queue entry, carrying the `seq` the append minted so the replay is
|
|
83
|
+
* deterministic and never re-runs the bound checks an already-committed append passed. */
|
|
84
|
+
| {
|
|
85
|
+
t: "steer_append";
|
|
86
|
+
token: string;
|
|
87
|
+
entry: PendingSteerEntry;
|
|
88
|
+
};
|
|
7
89
|
export interface FileCheckpointStoreOptions {
|
|
8
90
|
/** This store's half of {@link import("./shared-ledger.js").LedgerPaths.onCorruptRead}. */
|
|
9
91
|
onCorruptRead?: (info: CorruptReadInfo) => void;
|
|
@@ -21,6 +103,48 @@ export interface FileCheckpointStoreOptions {
|
|
|
21
103
|
/** The judge of a resolve's claim holder ({@link HolderJudge}); with it the store declares `fence = { holder: true }`. */
|
|
22
104
|
holderIsCurrent?: HolderJudge;
|
|
23
105
|
}
|
|
106
|
+
/**
|
|
107
|
+
* Every event kind this reader understands — the ledger's CLOSED SET, exported so a program that reads a `checkpoints.jsonl` itself judges
|
|
108
|
+
* a line against the words the store folds, not a copy of them. Kept as a VALUE (not just the type union) because the fence below judges
|
|
109
|
+
* DECODED JSON, which no compile-time union can vouch for.
|
|
110
|
+
*
|
|
111
|
+
* Total BOTH ways at compile time ({@link CheckpointLedgerKindsAreTheEventUnion}): a plain `Set<LedgerEvent["t"]>` would have accepted a list
|
|
112
|
+
* that silently forgot a member, and the failure shape of that drift is worse than the bug the fence fixes — a future release adding a
|
|
113
|
+
* supported kind (union arm, switch case, writer) but not this list would DURABLY append the event and only then have the replay refuse
|
|
114
|
+
* it: the write is on disk, memory is stale, and every later replay of that directory refuses the store. Forgetting a word, or listing
|
|
115
|
+
* one the union does not have, fails to compile.
|
|
116
|
+
*/
|
|
117
|
+
export declare const CHECKPOINT_LEDGER_EVENT_KINDS: readonly ["put", "resolve", "reopen", "execution", "expire", "delete", "steer_append"];
|
|
118
|
+
export type CheckpointLedgerEventKind = (typeof CHECKPOINT_LEDGER_EVENT_KINDS)[number];
|
|
119
|
+
/** The fence over {@link CHECKPOINT_LEDGER_EVENT_KINDS}: `never` while the list and the event union name the same words. */
|
|
120
|
+
export type CheckpointLedgerKindsAreTheEventUnion = AssertAllKeysHandled<Exclude<LedgerEvent["t"], CheckpointLedgerEventKind> | Exclude<CheckpointLedgerEventKind, LedgerEvent["t"]>>;
|
|
121
|
+
export interface ReadCheckpointLedgerOptions {
|
|
122
|
+
/** This reader's half of {@link FileCheckpointStoreOptions.onCorruptRead}: told of every snapshot row / ledger event dropped as damage. */
|
|
123
|
+
onCorruptRead?: (info: CorruptReadInfo) => void;
|
|
124
|
+
}
|
|
125
|
+
/** What {@link readCheckpointLedger} answers: the rows the ledger folds to, or no reading at all. */
|
|
126
|
+
export type CheckpointLedgerReading = {
|
|
127
|
+
/** The directory held still for one whole read. */
|
|
128
|
+
readonly settled: true;
|
|
129
|
+
/** token → row, folded exactly as a store would fold it: fresh objects, owned by the caller, shared with no store. */
|
|
130
|
+
readonly rows: ReadonlyMap<string, Checkpoint>;
|
|
131
|
+
/** Ledger events folded over the snapshot (zero right after a compaction). */
|
|
132
|
+
readonly events: number;
|
|
133
|
+
} | {
|
|
134
|
+
/** The snapshot kept being replaced under the read (a writer compacting, three reads running): no verdict — the last read is not offered in its place. */
|
|
135
|
+
readonly settled: false;
|
|
136
|
+
};
|
|
137
|
+
/**
|
|
138
|
+
* Read a data root's checkpoint ledger WITHOUT opening the store — for a program that must know what the ledger holds beside (or instead of) a
|
|
139
|
+
* running worker: a drain check asking whether a parked row still needs this engine's rows, an operator tool. It takes no writer fence
|
|
140
|
+
* (`checkpoints/LOCK` is neither created nor consulted, so it neither contends with a live store nor is refused by one), opens no append
|
|
141
|
+
* handle, and creates nothing — not the directory either: a root with no ledger reads as no rows. The fold is the store's own
|
|
142
|
+
* (`applyCheckpointEvent` through the same discriminator fence), so a ledger event kind this binary does not know refuses the read exactly as
|
|
143
|
+
* it refuses the store's replay (`checkpoint.unsupported_version`, `detail.reason` `ledger_event_unknown`); {@link CHECKPOINT_LEDGER_EVENT_KINDS}
|
|
144
|
+
* is the word list that fence judges by. A root whose adoption is in flight is refused as the store refuses it. Beside a compacting writer
|
|
145
|
+
* the read is bracketed (see {@link readLedgerSettled}) and is `settled: false` rather than a view that never existed.
|
|
146
|
+
*/
|
|
147
|
+
export declare function readCheckpointLedger(root: string, opts?: ReadCheckpointLedgerOptions): CheckpointLedgerReading;
|
|
24
148
|
export declare class FileCheckpointStore implements CheckpointStore {
|
|
25
149
|
/** design/173 §2.3 — honest declaration on the restart-survival axis the vocabulary claims: rows
|
|
26
150
|
* live on disk (fsync'd append log) and survive a process restart. Multi-replica coordination is
|
|
@@ -57,7 +181,7 @@ export declare class FileCheckpointStore implements CheckpointStore {
|
|
|
57
181
|
private readonly ledgerPath;
|
|
58
182
|
/** Present exactly when the store was built with a session head read (`FileCheckpointStoreOptions.sessionHeadOf`). */
|
|
59
183
|
readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
|
|
60
|
-
constructor(root: string,
|
|
184
|
+
constructor(root: string, options?: FileCheckpointStoreOptions);
|
|
61
185
|
/** Serialize an op behind any in-flight op on the same token (the in-process per-token async mutex). */
|
|
62
186
|
private withLock;
|
|
63
187
|
/**
|
|
@@ -106,3 +230,4 @@ export declare class FileCheckpointStore implements CheckpointStore {
|
|
|
106
230
|
*/
|
|
107
231
|
close(): void;
|
|
108
232
|
}
|
|
233
|
+
export {};
|
|
@@ -1,21 +1,14 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
2
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
3
|
+
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
3
4
|
import { checkpointExecutionRecorded, executionRecordDisposition, ExecutionOutcomeConflictError, } from "../../core/checkpoint-execution-record.js";
|
|
4
5
|
import { checkpointHolderMatches, checkpointOccMatches, checkpointRevOf } from "../../core/checkpoint-generation.js";
|
|
5
6
|
import { appendPendingSteer, CheckpointError, checkpointRowMatches, encodeAtFidelity, summarizeCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
|
|
6
7
|
import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
|
|
7
|
-
import { SharedLedgerTable } from "./shared-ledger.js";
|
|
8
|
+
import { readLedgerSettled, SharedLedgerTable } from "./shared-ledger.js";
|
|
8
9
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
9
|
-
const
|
|
10
|
-
|
|
11
|
-
resolve: true,
|
|
12
|
-
reopen: true,
|
|
13
|
-
execution: true,
|
|
14
|
-
expire: true,
|
|
15
|
-
delete: true,
|
|
16
|
-
steer_append: true,
|
|
17
|
-
};
|
|
18
|
-
const KNOWN_CHECKPOINT_LEDGER_EVENTS = new Set(Object.keys(CHECKPOINT_LEDGER_EVENT_REGISTRY));
|
|
10
|
+
export const CHECKPOINT_LEDGER_EVENT_KINDS = Object.freeze(["put", "resolve", "reopen", "execution", "expire", "delete", "steer_append"]);
|
|
11
|
+
const KNOWN_CHECKPOINT_LEDGER_EVENTS = new Set(CHECKPOINT_LEDGER_EVENT_KINDS);
|
|
19
12
|
function applyCheckpointEvent(cps, ev) {
|
|
20
13
|
if (!KNOWN_CHECKPOINT_LEDGER_EVENTS.has(ev.t)) {
|
|
21
14
|
throw new CheckpointError("checkpoint.unsupported_version", `file checkpoint ledger: unrecognised event kind "${String(ev.t)}" — ` +
|
|
@@ -69,7 +62,7 @@ const isCheckpointRow = (x) => x !== null &&
|
|
|
69
62
|
typeof x.token === "string" &&
|
|
70
63
|
typeof x.scope === "string" &&
|
|
71
64
|
typeof x.status === "string";
|
|
72
|
-
const
|
|
65
|
+
const checkpointLedgerModel = {
|
|
73
66
|
label: "checkpoint ledger",
|
|
74
67
|
keyOf: (cp) => cp.token,
|
|
75
68
|
apply: applyCheckpointEvent,
|
|
@@ -84,7 +77,18 @@ const checkpointLedgers = new SharedLedgerTable({
|
|
|
84
77
|
return false;
|
|
85
78
|
return ev.t === "put" ? isCheckpointRow(ev.cp) : true;
|
|
86
79
|
},
|
|
87
|
-
}
|
|
80
|
+
};
|
|
81
|
+
const checkpointLedgers = new SharedLedgerTable(checkpointLedgerModel);
|
|
82
|
+
export function readCheckpointLedger(root, opts = {}) {
|
|
83
|
+
assertAdoptionBootGate(root, "readCheckpointLedger");
|
|
84
|
+
const dir = join(root, "checkpoints");
|
|
85
|
+
const read = readLedgerSettled({
|
|
86
|
+
ledgerPath: join(dir, "checkpoints.jsonl"),
|
|
87
|
+
snapshotPath: join(dir, "checkpoints.snapshot.jsonl"),
|
|
88
|
+
...(opts.onCorruptRead !== undefined ? { onCorruptRead: guardCorruptSink(opts.onCorruptRead) } : {}),
|
|
89
|
+
}, checkpointLedgerModel);
|
|
90
|
+
return read.settled ? { settled: true, rows: read.rows, events: read.events } : { settled: false };
|
|
91
|
+
}
|
|
88
92
|
export class FileCheckpointStore {
|
|
89
93
|
durability = "durable";
|
|
90
94
|
fidelity = "json";
|
|
@@ -100,7 +104,8 @@ export class FileCheckpointStore {
|
|
|
100
104
|
fault = null;
|
|
101
105
|
discloseCorrupt;
|
|
102
106
|
ledgerPath;
|
|
103
|
-
constructor(root,
|
|
107
|
+
constructor(root, options) {
|
|
108
|
+
const opts = receiveOptions(options, "FileCheckpointStore");
|
|
104
109
|
assertAdoptionBootGate(root, "FileCheckpointStore");
|
|
105
110
|
this.fsyncEnabled = opts.fsync !== false;
|
|
106
111
|
this.holderIsCurrent = opts.holderIsCurrent;
|
|
@@ -173,7 +173,7 @@ export declare class FileFileHistoryStore implements FileHistoryStore {
|
|
|
173
173
|
* A tie is then decided by the entry id, which IS commit order for engine-minted uuidv7 ids.
|
|
174
174
|
*/
|
|
175
175
|
private nextCommittedAt;
|
|
176
|
-
constructor(root: string,
|
|
176
|
+
constructor(root: string, options?: FileFileHistoryStoreOptions);
|
|
177
177
|
/**
|
|
178
178
|
* The RETENTION pass, run after a boundary file is published (design/381 §片2 — see
|
|
179
179
|
* {@link FileHistoryStore.reap} for why the backend owns this rather than the host).
|
|
@@ -8,6 +8,7 @@ import { atomicWriteFile, ensureDir, sanitizePathComponent, sanitizeScope, write
|
|
|
8
8
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
9
9
|
import { isAbsoluteForFamily } from "../../tools/fs/safety.js";
|
|
10
10
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
11
|
+
import { receiveOptions } from "../../core/own-property-receipt.js";
|
|
11
12
|
function trackedDigest(rows) {
|
|
12
13
|
const canonical = [...rows]
|
|
13
14
|
.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
|
|
@@ -155,7 +156,8 @@ export class FileFileHistoryStore {
|
|
|
155
156
|
this.lastCommittedAt = Math.max(Date.now(), this.lastCommittedAt + 1);
|
|
156
157
|
return this.lastCommittedAt;
|
|
157
158
|
}
|
|
158
|
-
constructor(root,
|
|
159
|
+
constructor(root, options) {
|
|
160
|
+
const opts = receiveOptions(options, "FileFileHistoryStore");
|
|
159
161
|
assertAdoptionBootGate(root, "FileFileHistoryStore");
|
|
160
162
|
this.boundaryKeep = resolveFileHistoryRetention("FileFileHistoryStore", opts?.retention);
|
|
161
163
|
this.base = join(root, "file-history");
|