@bastani/atomic 0.9.40 → 0.9.41-alpha.2

package/dist/builtin/workflows/builtin/{chunk-qjqn389g.js → chunk-2jfst7e4.js}

@@ -4,7 +4,7 @@ import {
 
 // dist/builtin/workflows/src/authoring/workflow.ts
 import { basename } from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // dist/builtin/workflows/src/shared/budget.ts
 function validateWorkflowBudget(value, label = "budget") {
@@ -37,6 +37,59 @@ function assertWorkflowBudget(value, label = "budget") {
 // dist/builtin/workflows/src/shared/workflow-heartbeat-contract.ts
 var DEFAULT_WORKFLOW_HEARTBEAT_INTERVAL_MINUTES = 15;
 
+// dist/builtin/workflows/src/runs/shared/prompt-callsite.ts
+import { fileURLToPath } from "node:url";
+var PACKAGED_WORKFLOW_RUNTIME_ROOTS = ["/dist/builtin/workflows/src/"];
+function normalizeSlashes(path) {
+  return path.replace(/\\/g, "/");
+}
+function normalizeStackPath(framePath) {
+  let normalized = framePath;
+  if (normalized.startsWith("file://")) {
+    try {
+      normalized = fileURLToPath(normalized);
+    } catch {
+      try {
+        normalized = decodeURIComponent(new URL(normalized).pathname);
+      } catch {}
+    }
+  }
+  normalized = normalizeSlashes(normalized).replace(/^\/([A-Za-z]:\/)/, "$1");
+  return normalized;
+}
+function currentModuleRuntimeRoot() {
+  const modulePath = normalizeStackPath(fileURLToPath(import.meta.url));
+  const markers = ["packages/workflows/src/", ...PACKAGED_WORKFLOW_RUNTIME_ROOTS.map((root) => root.slice(1))];
+  for (const marker of markers) {
+    const index = modulePath.indexOf(marker);
+    if (index >= 0)
+      return modulePath.slice(0, index + marker.length);
+  }
+  return;
+}
+var CURRENT_WORKFLOW_RUNTIME_ROOT = currentModuleRuntimeRoot();
+function isWorkflowRuntimeFrame(normalizedPath) {
+  const path = normalizeSlashes(normalizedPath);
+  if (path.startsWith("packages/workflows/src/"))
+    return true;
+  if (CURRENT_WORKFLOW_RUNTIME_ROOT !== undefined && path.startsWith(CURRENT_WORKFLOW_RUNTIME_ROOT)) {
+    return true;
+  }
+  const comparable = path.startsWith("/") ? path : `/${path}`;
+  return PACKAGED_WORKFLOW_RUNTIME_ROOTS.some((runtimeRoot) => comparable.includes(runtimeRoot));
+}
+
+// dist/builtin/workflows/src/shared/workflow-source.ts
+var WORKFLOW_SOURCES = new WeakMap;
+var OWN_MODULE_PATH = normalizeStackPath(import.meta.url);
+function isWorkflowRuntimeModule(path) {
+  const normalized = normalizeStackPath(path);
+  return normalized === OWN_MODULE_PATH || isWorkflowRuntimeFrame(normalized);
+}
+function recordWorkflowSource(definition, path) {
+  WORKFLOW_SOURCES.set(definition, path);
+}
+
 // dist/builtin/workflows/src/workflows/identity.ts
 function normalizeWorkflowName(name) {
   if (!name || typeof name !== "string") {
@@ -67,7 +120,7 @@ function stackFilePath(line) {
   if (!rawPath.startsWith("file://"))
     return rawPath;
   try {
-    return fileURLToPath(rawPath);
+    return fileURLToPath2(rawPath);
   } catch {
     return;
   }
@@ -78,8 +131,10 @@ function isWorkflowAuthoringImplementationFrame(filePath) {
     return false;
   return normalized.includes("/packages/workflows/") || normalized.includes("/dist/builtin/workflows/") || normalized.includes("/.atomic/agent/extensions/workflows/");
 }
-function workflowNameFromCaller() {
-  const stack = new Error().stack;
+function callerSourcePath(entry) {
+  const capture = new Error;
+  Error.captureStackTrace(capture, entry);
+  const stack = capture.stack;
   if (stack === undefined)
     return;
   for (const line of stack.split(`
@@ -89,14 +144,18 @@ function workflowNameFromCaller() {
       continue;
     if (isWorkflowAuthoringImplementationFrame(filePath))
       continue;
-    const base = basename(filePath.replace(/\\/g, "/")).replace(/\.[cm]?[jt]sx?$/, "");
-    if (base.length > 0)
-      return base;
+    return isWorkflowRuntimeModule(filePath) ? undefined : filePath;
   }
   return;
 }
-function resolveWorkflowName(name) {
-  const resolved = name ?? workflowNameFromCaller();
+function workflowNameFromSourcePath(filePath) {
+  if (filePath === undefined)
+    return;
+  const base = basename(filePath.replace(/\\/g, "/")).replace(/\.[cm]?[jt]sx?$/, "");
+  return base.length > 0 ? base : undefined;
+}
+function resolveWorkflowName(name, sourcePath) {
+  const resolved = name ?? workflowNameFromSourcePath(sourcePath);
   if (resolved === undefined) {
     throw new TypeError("workflow: name must be provided when caller filename cannot be inferred");
   }
@@ -132,7 +191,8 @@ function workflow(spec) {
     throw new TypeError("workflow: heartbeatIntervalMinutes must be a non-negative finite number");
   }
   assertWorkflowBudget(spec.budget, "workflow: budget");
-  const name = resolveWorkflowName(spec.name);
+  const source = callerSourcePath(workflow);
+  const name = resolveWorkflowName(spec.name, source);
   const normalizedName = normalizeWorkflowName(name);
   requireNonEmptyString(normalizedName, "normalized name");
   const frozenInputs = freezeSchemaMap(spec.inputs ?? {});
@@ -154,6 +214,8 @@ function workflow(spec) {
     run
   };
   const branded = stampWorkflowDefinition(definition);
+  if (source !== undefined)
+    recordWorkflowSource(branded, source);
   return Object.freeze(branded);
 }
 

package/dist/builtin/workflows/builtin/{chunk-4bwtzyjq.js → chunk-49kkbdpr.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   parse_rubric,
   normalize_criteria,

package/dist/builtin/workflows/builtin/{chunk-qdd897wm.js → chunk-apagcs4r.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   parse_rubric,
   normalize_criteria,

package/dist/builtin/workflows/builtin/{chunk-454hz1qt.js → chunk-dcxscfnb.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   score_progress,
   classify_trend

package/dist/builtin/workflows/builtin/{chunk-bjva9j5k.js → chunk-hx8v4p97.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   stableArtifactRoot
 } from "./chunk-rc5ec5xx.js";

package/dist/builtin/workflows/builtin/{chunk-85mx6wcf.js → chunk-k5q3t7je.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 
 // dist/builtin/workflows/builtin/open-claude-design.ts
 import { Type as Type2 } from "typebox";

package/dist/builtin/workflows/builtin/{chunk-8kkv04hz.js → chunk-n2gkzkty.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   keepContext,
   REVIEWER_CALIBRATION_RULES,

package/dist/builtin/workflows/builtin/{chunk-y45tkftg.js → chunk-txbc93t6.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   keepContext,
   REVIEWER_CALIBRATION_RULES,

package/dist/builtin/workflows/builtin/{chunk-x0vvjyzg.js → chunk-w4xp1w1f.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   stableArtifactRoot
 } from "./chunk-rc5ec5xx.js";

package/dist/builtin/workflows/builtin/{chunk-5eh0brtd.js → chunk-z3pajrfs.js}

@@ -1,7 +1,7 @@
 import {
   workflow,
   withBuiltinContext
-} from "./chunk-qjqn389g.js";
+} from "./chunk-2jfst7e4.js";
 import {
   scoring_prompt_reads,
   build_scoring_prompt

package/dist/builtin/workflows/builtin/classify-and-act.js

@@ -1,8 +1,8 @@
 import {
   DEFAULT_ACTION_CATEGORIES2,
   classify_and_act_default
-} from "./chunk-bjva9j5k.js";
-import"./chunk-qjqn389g.js";
+} from "./chunk-hx8v4p97.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   DEFAULT_ACTION_CATEGORIES2 as DEFAULT_ACTION_CATEGORIES,

package/dist/builtin/workflows/builtin/fan-out-and-synthesize.js

@@ -1,7 +1,7 @@
 import {
   fan_out_and_synthesize_default
-} from "./chunk-x0vvjyzg.js";
-import"./chunk-qjqn389g.js";
+} from "./chunk-w4xp1w1f.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   fan_out_and_synthesize_default as default

package/dist/builtin/workflows/builtin/generate-and-filter.js

@@ -1,9 +1,9 @@
 import {
   generate_and_filter_default
-} from "./chunk-5eh0brtd.js";
+} from "./chunk-z3pajrfs.js";
 import"./chunk-2377r57g.js";
 import"./chunk-n1910xc4.js";
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   generate_and_filter_default as default

package/dist/builtin/workflows/builtin/goal.js

@@ -1,11 +1,11 @@
 import {
   goal_default
-} from "./chunk-y45tkftg.js";
+} from "./chunk-txbc93t6.js";
 import"./chunk-8x61e0s7.js";
 import"./chunk-2377r57g.js";
 import"./chunk-z0d03ktm.js";
 import"./chunk-n1910xc4.js";
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   goal_default as default

package/dist/builtin/workflows/builtin/index.js

@@ -1,36 +1,36 @@
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 import"./chunk-n1910xc4.js";
 import"./chunk-2377r57g.js";
 import {
   adversarial_verification_default
-} from "./chunk-qdd897wm.js";
+} from "./chunk-apagcs4r.js";
 import {
   classify_and_act_default
-} from "./chunk-bjva9j5k.js";
+} from "./chunk-hx8v4p97.js";
 import {
   fan_out_and_synthesize_default
-} from "./chunk-x0vvjyzg.js";
+} from "./chunk-w4xp1w1f.js";
 import {
   generate_and_filter_default
-} from "./chunk-5eh0brtd.js";
+} from "./chunk-z3pajrfs.js";
 import {
   goal_default
-} from "./chunk-y45tkftg.js";
+} from "./chunk-txbc93t6.js";
 import"./chunk-8x61e0s7.js";
 import"./chunk-z0d03ktm.js";
 import {
   open_claude_design_default
-} from "./chunk-85mx6wcf.js";
+} from "./chunk-k5q3t7je.js";
 import {
   loop_until_done_default
-} from "./chunk-454hz1qt.js";
+} from "./chunk-dcxscfnb.js";
 import {
   ralph_default
-} from "./chunk-8kkv04hz.js";
+} from "./chunk-n2gkzkty.js";
 import {
   tournament_default
-} from "./chunk-4bwtzyjq.js";
+} from "./chunk-49kkbdpr.js";
 export {
   adversarial_verification_default as adversarialVerification,
   classify_and_act_default as classifyAndAct,

package/dist/builtin/workflows/builtin/loop-until-done.js

@@ -1,9 +1,9 @@
 import {
   loop_until_done_default
-} from "./chunk-454hz1qt.js";
+} from "./chunk-dcxscfnb.js";
 import"./chunk-z0d03ktm.js";
 import"./chunk-n1910xc4.js";
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   loop_until_done_default as default

package/dist/builtin/workflows/builtin/open-claude-design.js

@@ -1,7 +1,7 @@
 import {
   open_claude_design_default
-} from "./chunk-85mx6wcf.js";
-import"./chunk-qjqn389g.js";
+} from "./chunk-k5q3t7je.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   open_claude_design_default as default

package/dist/builtin/workflows/builtin/ralph.js

@@ -1,11 +1,11 @@
 import {
   ralph_default
-} from "./chunk-8kkv04hz.js";
+} from "./chunk-n2gkzkty.js";
 import"./chunk-8x61e0s7.js";
 import"./chunk-2377r57g.js";
 import"./chunk-z0d03ktm.js";
 import"./chunk-n1910xc4.js";
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   ralph_default as default

package/dist/builtin/workflows/builtin/tournament.js

@@ -1,9 +1,9 @@
 import {
   tournament_default
-} from "./chunk-4bwtzyjq.js";
+} from "./chunk-49kkbdpr.js";
 import"./chunk-2377r57g.js";
 import"./chunk-n1910xc4.js";
-import"./chunk-qjqn389g.js";
+import"./chunk-2jfst7e4.js";
 import"./chunk-9cm2ckq2.js";
 export {
   tournament_default as default

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.40",
+  "version": "0.9.41-alpha.2",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [
@@ -85,7 +85,7 @@
   },
   "peerDependencies": {
     "@bastani/atomic": "*",
-    "@earendil-works/pi-tui": "^1.3.0",
+    "@earendil-works/pi-tui": "^1.4.0",
     "typebox": "*"
   },
   "peerDependenciesMeta": {

package/dist/builtin/workflows/src/authoring.d.ts

@@ -8,7 +8,7 @@ export type { RunJournalOption, RunJournalSettings } from "./durable/journal/res
 export { resolveRunJournal } from "./durable/journal/resolution.js";
 export { openSqlRunJournal, SqlRunJournal } from "./durable/journal/sqlite-run-journal.js";
 export * from "./durable/journal/types.js";
-export type { AgentSessionAdapter, CompleteAdapter, CompleteStageOpts, EffectiveBudget, GitWorktreeSetupOptions, GitWorktreeSetupResult, PromptAdapter, PromptOptions, ResolvedInputs, RunResult, RunStatus, StageAdapters, StageContext, StageExecutionMeta, StageMcpOptions, StageOptions, StageOutputOptions, StagePromptOptions, StageSendUserMessageOptions, StageSessionCreateOptions, StageSessionCreateResult, StageSessionEvent, StageSessionRuntime, StageSnapshot, StageStatus, StageUserMessageContent, StageUserMessageDelivery, ToolNodeSnapshot, WorkflowAction, WorkflowArtifact, WorkflowBudget, WorkflowChainOptions, WorkflowChildResult, WorkflowContextMode, WorkflowControlEvent, WorkflowCustomToolDefinition, WorkflowCustomUiComponent, WorkflowCustomUiFactory, WorkflowCustomUiKeybindings, WorkflowCustomUiOptions, WorkflowCustomUiOverlayHandle, WorkflowCustomUiOverlayOptions, WorkflowCustomUiTheme, WorkflowCustomUiTui, WorkflowDetails, WorkflowDetailsMode, WorkflowDetailsStatus, WorkflowExecutionMode, WorkflowExecutionPolicy, WorkflowExitOptions, WorkflowExitStatus, WorkflowInputBindings, WorkflowInputSchema, WorkflowInputSchemaMap, WorkflowInputValues, WorkflowIntercomSummary, WorkflowMaxOutput, WorkflowMcpPort, WorkflowModelAttempt, WorkflowModelCatalogPort, WorkflowModelFallbackFields, WorkflowModelInfo, WorkflowModelUsage, WorkflowModelValue, WorkflowOutputMode, WorkflowOutputSchema, WorkflowOutputSchemaMap, WorkflowOutputValues, WorkflowParallelOptions, WorkflowPersistencePort, WorkflowProgressSummary, WorkflowRunChildArgs, WorkflowRunChildOptions, WorkflowRunChildOptionsArgument, WorkflowRunOutput, WorkflowRuntimeConfig, WorkflowSerializableObject, WorkflowSerializablePrimitive, WorkflowSerializableValue, WorkflowSharedTaskDefaults, WorkflowTaskContext, WorkflowTaskContextInput, WorkflowTaskOptions, WorkflowTaskResult, WorkflowTaskSessionFields, WorkflowTaskSessionOptions, WorkflowTaskStep, WorkflowThinkingLevel, WorkflowToolContext, WorkflowToolError, WorkflowToolFailure, WorkflowToolOptions, WorkflowToolOutcome, WorkflowToolPrimitive, WorkflowToolReturnOptions, WorkflowToolSuccess, WorkflowToolThrowOptions, WorkflowUIAdapter, WorkflowUIContext, WorkflowWorktreeInputBinding, } from "./shared/authoring-contract.js";
+export type { AgentSessionAdapter, CompleteAdapter, CompleteStageOpts, EffectiveBudget, GitWorktreeSetupOptions, GitWorktreeSetupResult, PromptAdapter, PromptOptions, ResolvedInputs, RunResult, RunStatus, StageAdapters, StageContext, StageExecutionMeta, StageMcpOptions, StageOptions, StageOutputOptions, StagePromptOptions, StageSendUserMessageOptions, StageSessionCreateOptions, StageSessionCreateResult, StageSessionEvent, StageSessionRuntime, StageSnapshot, StageStatus, StageUserMessageContent, StageUserMessageDelivery, ToolNodeSnapshot, WorkflowAction, WorkflowArtifact, WorkflowBudget, WorkflowChainOptions, WorkflowChildResult, WorkflowContextMode, WorkflowControlEvent, WorkflowCustomToolDefinition, WorkflowCustomUiComponent, WorkflowCustomUiFactory, WorkflowCustomUiKeybindings, WorkflowCustomUiOptions, WorkflowCustomUiOverlayHandle, WorkflowCustomUiOverlayOptions, WorkflowCustomUiTheme, WorkflowCustomUiTui, WorkflowDetails, WorkflowDetailsMode, WorkflowDetailsStatus, WorkflowExecutionMode, WorkflowExecutionPolicy, WorkflowExitOptions, WorkflowExitStatus, WorkflowInputBindings, WorkflowInputSchema, WorkflowInputSchemaMap, WorkflowInputValues, WorkflowIntercomSummary, WorkflowMaxOutput, WorkflowMcpPort, WorkflowModelAttempt, WorkflowModelCatalogPort, WorkflowModelFallbackFields, WorkflowModelInfo, WorkflowModelUsage, WorkflowModelValue, WorkflowOutputMode, WorkflowOutputSchema, WorkflowOutputSchemaMap, WorkflowOutputValues, WorkflowParallelFailure, WorkflowParallelOptions, WorkflowPersistencePort, WorkflowProgressSummary, WorkflowRunChildArgs, WorkflowRunChildOptions, WorkflowRunChildOptionsArgument, WorkflowRunOutput, WorkflowRuntimeConfig, WorkflowSerializableObject, WorkflowSerializablePrimitive, WorkflowSerializableValue, WorkflowSharedTaskDefaults, WorkflowTaskContext, WorkflowTaskContextInput, WorkflowTaskOptions, WorkflowTaskResult, WorkflowTaskSessionFields, WorkflowTaskSessionOptions, WorkflowTaskStep, WorkflowThinkingLevel, WorkflowToolContext, WorkflowToolError, WorkflowToolFailure, WorkflowToolOptions, WorkflowToolOutcome, WorkflowToolPrimitive, WorkflowToolReturnOptions, WorkflowToolSuccess, WorkflowToolThrowOptions, WorkflowUIAdapter, WorkflowUIContext, WorkflowWorktreeInputBinding, } from "./shared/authoring-contract.js";
 import type * as AuthoringContract from "./shared/authoring-contract.js";
 import type { AuthoredWorkflowSpec as SharedAuthoredWorkflowSpec, WorkflowInputsFromSchemas, WorkflowOutputsFromSchemas, WorkflowProvidedInputsFromSchemas } from "./shared/workflow-authoring-types.js";
 export type { WorkflowInputsFromSchemas, WorkflowOutputsFromSchemas, WorkflowProvidedInputsFromSchemas, } from "./shared/workflow-authoring-types.js";

package/dist/builtin/workflows/src/durable/journal/internal.d.ts

@@ -1 +1,17 @@
+import type { RunJournal } from "./types.js";
 export declare const JOURNAL_READ_PAGE_SIZE = 256;
+/** A run's latest event. A run whose history was deleted and recorded again ends with a different event. */
+export interface RunVersion {
+    readonly seq: number;
+    readonly at: number;
+}
+/** Lets a durable backend re-read only the runs that changed; kept off the public journal shape. */
+export interface RunJournalVersions {
+    /** Moves whenever any connection, in this process or another, commits a change to the journal's store. */
+    changeToken(): Promise<string>;
+    /** Every listed run with its latest event; a run with no events has version `{ seq: 0, at: 0 }`. */
+    runVersions(): Promise<ReadonlyMap<string, RunVersion>>;
+}
+export declare function registerRunJournalVersions(journal: RunJournal, versions: RunJournalVersions): void;
+/** Change tracking for a journal that registered it; other journals are re-read in full. */
+export declare function runJournalVersions(journal: RunJournal): RunJournalVersions | undefined;

package/dist/builtin/workflows/src/durable/journal/legacy-journal-tables.d.ts

@@ -14,6 +14,13 @@ type LegacyEventRow = SqliteRow & {
     [c.payload]: string;
     [c.at]: number;
 };
+export type RunVersionRow = SqliteRow & {
+    [c.runId]: string;
+    [c.seq]: number;
+    [c.at]: number;
+};
+/** `seq` and `at` of the latest event of `${runs}.run_id`, through the `(run_id, seq)` primary key. */
+export declare function latestEventColumns(events: string, runs: string): string;
 /**
  * Runs recorded before #3682, kept in the unprefixed `meta`/`runs`/`events`/`leases` tables.
  *
@@ -32,6 +39,8 @@ export declare class LegacyJournalRuns {
         cwd?: string;
     }): Promise<LegacyRunRow[]>;
     find(executor: SqliteExecutor, runId: string): Promise<LegacyRunRow | undefined>;
+    /** Latest event of each pending legacy run; the legacy tables are never modified. */
+    versions(executor: SqliteExecutor): Promise<RunVersionRow[]>;
     /** Events of an unconverted legacy run, read in place. */
     events(executor: SqliteExecutor, runId: string, fromSeq: number, limit: number): Promise<LegacyEventRow[]>;
     eventByKey(executor: SqliteExecutor, runId: string, key: string): Promise<LegacyEventRow | undefined>;

package/dist/builtin/workflows/src/durable/journal/sql-run-journal.d.ts

@@ -22,6 +22,12 @@ export declare class SqlRunJournal implements RunJournal {
     listRuns(filter?: {
         cwd?: string;
     }): Promise<readonly RunSummary[]>;
+    /**
+     * `data_version` moves when another connection commits and `total_changes()` when this one writes; the
+     * table aggregates also catch run changes if the adapter does not serve every statement from one connection.
+     */
+    private changeToken;
+    private runVersions;
     private requireRun;
     /** Whether this run exists only in the legacy tables, whose events are then read in place. */
     private isUnconvertedLegacyRun;