@osolmaz/pi-workflows 0.16.4 → 0.16.6

package/dist/workflows/index.d.ts

@@ -1,3 +1,4 @@
+export { WorkflowRunQueueStore, type RunEventRecord, type WorkflowRunPreparationResult, type WorkflowRunQueueRecord, type WorkflowRunQueueViewRecord, type WorkflowRunReservationOptions, } from "./queue.js";
 export { agent, assistantMessage, action, checkpoint, compute, defineWorkflow, defineWorkflowRegistry, idempotentEffect, includeWorkflow, includedResult, manualEffect, isWorkflowDefinition, notify, shell, } from "./definition.js";
 export { decision, decisionEdge, type DecisionDefinition } from "./decision.js";
 export { MAX_PRESENTATION_BLOCKS, MAX_PRESENTATION_CODE_UNITS, MAX_PRESENTATION_ITEMS, MAX_PRESENTATION_STRING_CODE_UNITS, MAX_PRESENTATION_TRANSPORT_PARTS, decisionDocumentSegments, decisionPresentationDigest, decisionPresentationFingerprint, digestCanonical, humanDecisionChannelRequest, normalizeDecisionPresentation, valueDecisionPresentation, validateHumanDecisionRequestIntegrity, type DecisionDocumentSegment, } from "./decision-presentation.js";
@@ -16,4 +17,4 @@ export { estimateProgress, formatProgressLine, formatProgressReport, formatRemai
 export { MAX_CURRENT_UPDATES, MAX_UPDATE_DATA_BYTES, UPDATE_RATE_BURST, UPDATE_RATE_PER_SECOND, updateProjection, validateProgressData, validateWorkflowUpdate, } from "./updates.js";
 export { sanitizeText, stripAnsi } from "./text.js";
 export { DEFINITION_SNAPSHOT_SCHEMA, RUN_STATE_SCHEMA, SESSION_BINDING_SCHEMA, WorkflowRunStore, createDefinitionSnapshot, createRunId, listWorkflowRuns, readLastTraceEvent, readWorkflowRun, workflowStateDatabasePath, type LoadedWorkflowRun, type ReadWorkflowRunOptions, type RunWriteAuthority, } from "./store.js";
-export type { AcceptedHumanDecision, DefaultedHumanDecision, ResolvedHumanDecision, AgentNodeDefinition, AgentExpectedOutput, AgentStepCompletion, AgentStepContract, AssistantAgentNodeDefinition, AssistantMessageOutput, AssistantMessageReceipt, AgentStepExecutor, AgentStepPresentation, AgentStepRequest, AgentStepSubmission, ActionNodeDefinition, CheckpointNodeDefinition, ConversationRange, ComputeNodeDefinition, FunctionActionNodeDefinition, DecisionPresentation, DecisionPresentationBlock, DecisionPresentationBullets, DecisionPresentationFields, DecisionPresentationParagraph, DecisionPresentationPreformatted, DecisionPresentationSection, HumanDecisionAnswerSource, HumanDecisionAudience, HumanDecisionCancellationRecord, HumanDecisionChannelRequest, HumanDecisionChoice, HumanDecisionChoiceMap, HumanDecisionContinuationRecord, HumanDecisionDeliveryRecord, HumanDecisionNodeContract, HumanDecisionPrompt, HumanDecisionReceipt, HumanDecisionRequest, HumanDecisionResponse, HumanDecisionSettlementRecord, HumanDecisionSubmission, HumanDecisionTextInput, HumanDecisionTimeout, HumanDecisionTimeoutPolicy, MaybePromise, NotifyNodeDefinition, ShellActionExecution, ShellActionNodeDefinition, SubmittedAgentNodeDefinition, ShellActionResult, WorkflowActionContext, WorkflowActionReceipt, WorkflowCompositionSnapshot, WorkflowDefinition, WorkflowDefinitionSnapshot, WorkflowEdge, WorkflowExitDefinition, WorkflowExitMap, WorkflowExitOutputs, WorkflowIncludeDefinition, WorkflowIncludedResult, WorkflowInputOf, WorkflowSettingsOf, WorkflowMountedSource, WorkflowMountSnapshot, WorkflowValueParser, WorkflowEngineOptions, WorkflowNodeCommon, WorkflowNodeContext, WorkflowNodeDefinition, WorkflowNodeOutcome, WorkflowNodeResult, WorkflowNodeSnapshot, WorkflowNotificationReceipt, WorkflowNotificationRequest, WorkflowNotificationSink, WorkflowPresentationContext, WorkflowProgressData, WorkflowProgressStatus, WorkflowRunResult, WorkflowRunState, WorkflowRunStatus, WorkflowSource, WorkflowSessionBinding, WorkflowSessionEntryRecord, WorkflowSettingsSnapshot, WorkflowStepRecord, WorkflowTraceEvent, WorkflowTraceEventDraft, WorkflowUpdateInput, WorkflowUpdateReceipt, WorkflowUpdateRecord, ShellActionUpdates, ShellUpdateLine, } from "./types.js";
+export type { AcceptedHumanDecision, DefaultedHumanDecision, ResolvedHumanDecision, AgentNodeDefinition, AgentExpectedOutput, AgentStepCompletion, AgentStepContract, AssistantAgentNodeDefinition, AssistantMessageOutput, AssistantMessageReceipt, AgentStepExecutor, AgentStepPresentation, AgentStepRequest, AgentStepSubmission, ActionNodeDefinition, CheckpointNodeDefinition, ConversationRange, ComputeNodeDefinition, FunctionActionNodeDefinition, DecisionPresentation, DecisionPresentationBlock, DecisionPresentationBullets, DecisionPresentationFields, DecisionPresentationParagraph, DecisionPresentationPreformatted, DecisionPresentationSection, HumanDecisionAnswerSource, HumanDecisionAudience, HumanDecisionCancellationRecord, HumanDecisionChannelRequest, HumanDecisionChoice, HumanDecisionChoiceMap, HumanDecisionDeliveryRecord, HumanDecisionNodeContract, HumanDecisionPrompt, HumanDecisionReceipt, HumanDecisionRequest, HumanDecisionResponse, HumanDecisionSettlementRecord, HumanDecisionSubmission, HumanDecisionTextInput, HumanDecisionTimeout, HumanDecisionTimeoutPolicy, MaybePromise, NotifyNodeDefinition, ShellActionExecution, ShellActionNodeDefinition, SubmittedAgentNodeDefinition, ShellActionResult, WorkflowActionContext, WorkflowActionReceipt, WorkflowCompositionSnapshot, WorkflowDefinition, WorkflowDefinitionSnapshot, WorkflowEdge, WorkflowExitDefinition, WorkflowExitMap, WorkflowExitOutputs, WorkflowIncludeDefinition, WorkflowIncludedResult, WorkflowInputOf, WorkflowSettingsOf, WorkflowMountedSource, WorkflowMountSnapshot, WorkflowValueParser, WorkflowEngineOptions, WorkflowNodeCommon, WorkflowNodeContext, WorkflowNodeDefinition, WorkflowNodeOutcome, WorkflowNodeResult, WorkflowNodeSnapshot, WorkflowNotificationReceipt, WorkflowNotificationRequest, WorkflowNotificationSink, WorkflowProgressData, WorkflowProgressStatus, WorkflowRunResult, WorkflowRunState, WorkflowRunStatus, WorkflowSource, WorkflowSessionBinding, WorkflowSessionEntryRecord, WorkflowSettingsSnapshot, WorkflowStepRecord, WorkflowTraceEvent, WorkflowTraceEventDraft, WorkflowUpdateInput, WorkflowUpdateReceipt, WorkflowUpdateRecord, ShellActionUpdates, ShellUpdateLine, } from "./types.js";

package/dist/workflows/index.js

@@ -1,3 +1,4 @@
+export { WorkflowRunQueueStore, } from "./queue.js";
 export { agent, assistantMessage, action, checkpoint, compute, defineWorkflow, defineWorkflowRegistry, idempotentEffect, includeWorkflow, includedResult, manualEffect, isWorkflowDefinition, notify, shell, } from "./definition.js";
 export { decision, decisionEdge } from "./decision.js";
 export { MAX_PRESENTATION_BLOCKS, MAX_PRESENTATION_CODE_UNITS, MAX_PRESENTATION_ITEMS, MAX_PRESENTATION_STRING_CODE_UNITS, MAX_PRESENTATION_TRANSPORT_PARTS, decisionDocumentSegments, decisionPresentationDigest, decisionPresentationFingerprint, digestCanonical, humanDecisionChannelRequest, normalizeDecisionPresentation, valueDecisionPresentation, validateHumanDecisionRequestIntegrity, } from "./decision-presentation.js";

package/dist/workflows/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,OAAO,EACP,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,MAAM,EACN,KAAK,GACN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAA2B,MAAM,eAAe,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,kCAAkC,EAClC,gCAAgC,EAChC,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,eAAe,EACf,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,qCAAqC,GAEtC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,SAAS,EACT,6BAA6B,EAC7B,+BAA+B,GAKhC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GAGnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GAErB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GAkBxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,eAAe,EACf,2BAA2B,GAO5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,GAK1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAI1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAMtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,OAAO,EACP,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,MAAM,EACN,KAAK,GACN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAA2B,MAAM,eAAe,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,kCAAkC,EAClC,gCAAgC,EAChC,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,eAAe,EACf,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,qCAAqC,GAEtC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,SAAS,EACT,6BAA6B,EAC7B,+BAA+B,GAKhC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GAGnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GAErB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GAkBxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,eAAe,EACf,2BAA2B,GAO5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,GAK1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAI1B,MAAM,YAAY,CAAC"}

package/dist/workflows/queue.d.ts

@@ -0,0 +1,267 @@
+import { type JsonObject } from "../state/json.js";
+import { ProjectStore } from "../state/project-store.js";
+export type WorkflowRunLaunchStatus = "queued" | "starting" | "running" | "parked" | "done" | "failed" | "cancelled";
+export type WorkflowRunReservationOptions = {
+    runId: string;
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: unknown;
+    definitionDigest: string;
+    definitionSnapshot: unknown;
+    input: unknown;
+    launchOptions?: unknown;
+    originSessionId: string;
+    executionMode?: "interactive" | "headless";
+    parentRunId?: string;
+    lineageKind?: "restart";
+    restartNumber?: number;
+    parentRunRevision?: number;
+    now?: string;
+};
+export type WorkflowRunQueueViewRecord = {
+    runId: string;
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: unknown;
+    initialized: boolean;
+    definitionDigest: string;
+    runStateStatus: string;
+    paused: boolean;
+    status: WorkflowRunLaunchStatus;
+    originSessionId: string | null;
+    executionMode: "interactive" | "headless";
+    parentRunId: string | null;
+    rootRunId: string;
+    lineageKind: "restart" | null;
+    restartNumber: number;
+    parentRunRevision: number | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+};
+export type WorkflowRunQueueRecord = {
+    runId: string;
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: unknown;
+    initialized: boolean;
+    definitionDigest: string;
+    input: unknown;
+    launchOptions: unknown;
+    status: WorkflowRunLaunchStatus;
+    runnerId: string | null;
+    claimToken: string | null;
+    claimGeneration: number | null;
+    claimExpiresAt: string | null;
+    originSessionId: string | null;
+    executionMode: "interactive" | "headless";
+    parentRunId: string | null;
+    rootRunId: string;
+    lineageKind: "restart" | null;
+    restartNumber: number;
+    parentRunRevision: number | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+};
+export type WorkflowRunPreparationResult = {
+    state: "reserved";
+    run: WorkflowRunQueueRecord;
+} | {
+    state: "adopted";
+    run: WorkflowRunQueueRecord;
+};
+export type RunEventRecord = {
+    seq: number;
+    recordedAt: string;
+    runId: string;
+    workflowRef: string;
+    type: string;
+    runnerId: string | null;
+    payload: JsonObject;
+};
+export declare class WorkflowRunQueueStore extends ProjectStore {
+    private readonly workflowMessages;
+    reserveWorkflowRun(options: WorkflowRunReservationOptions): WorkflowRunQueueRecord;
+    private reserveWorkflowRunInTransaction;
+    reserveOrAdoptWorkflowRun(options: WorkflowRunReservationOptions): WorkflowRunPreparationResult;
+    getWorkflowRun(runId: string): WorkflowRunQueueRecord | undefined;
+    getWorkflowRunView(runId: string): WorkflowRunQueueViewRecord | undefined;
+    workflowRunListRevision(): {
+        total: number;
+        revision: string;
+    };
+    listWorkflowRunViews(options: {
+        offset: number;
+        limit: number;
+    }): {
+        total: number;
+        revision: string;
+        runs: WorkflowRunQueueViewRecord[];
+    };
+    workflowRunProjectPath(runId: string): string | undefined;
+    listWorkflowRuns(options?: {
+        statuses?: WorkflowRunLaunchStatus[];
+        excludeRunIds?: string[];
+        limit?: number;
+    }): WorkflowRunQueueRecord[];
+    findSessionReservation(sessionId: string): WorkflowRunQueueRecord | undefined;
+    findSessionReservationView(sessionId: string): WorkflowRunQueueViewRecord | undefined;
+    claimWorkflowRun(options: {
+        runId: string;
+        runnerId: string;
+        claimToken: string;
+        leaseMs: number;
+        now?: string;
+    }): WorkflowRunQueueRecord | undefined;
+    /** Schedule a runner that validates one pending interactive submission. */
+    claimWorkflowRunForInteractionValidation(options: {
+        runId: string;
+        runnerId: string;
+        claimToken: string;
+        leaseMs: number;
+        now?: string;
+    }): WorkflowRunQueueRecord | undefined;
+    /** Take a short server claim without scheduling a parked interactive run. */
+    claimWorkflowRunForControl(options: {
+        runId: string;
+        runnerId: string;
+        claimToken: string;
+        leaseMs: number;
+        now?: string;
+    }): WorkflowRunQueueRecord | undefined;
+    beginWorkflowRunInteractionTimeout(options: {
+        runId: string;
+        targetSessionId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    markWorkflowRunRunning(options: {
+        runId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    claimNextWorkflowRun(options: {
+        runnerId: string;
+        claimToken: string;
+        leaseMs: number;
+        now?: string;
+        excludeRunIds?: string[];
+    }): WorkflowRunQueueRecord | undefined;
+    renewWorkflowRunClaim(options: {
+        runId: string;
+        claimToken: string;
+        leaseMs: number;
+        now?: string;
+    }): boolean;
+    verifyWorkflowRunClaim(options: {
+        runId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    workflowRunAuthority(runId: string, claimToken: string): {
+        actor: {
+            type: "session" | "host";
+            id: string;
+        };
+        ownerType: "session" | "host";
+        ownerId: string;
+        token: string;
+        generation: number;
+        leaseMs: number;
+    } | undefined;
+    parkWorkflowRun(options: {
+        runId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    parkWorkflowRunForRunnerNoProgress(options: {
+        runId: string;
+        claimToken: string;
+        detail: string;
+        now?: string;
+    }): boolean;
+    pauseParkedWorkflowRun(options: {
+        runId: string;
+        now?: string;
+    }): boolean;
+    resumePausedInteraction(options: {
+        runId: string;
+        now?: string;
+    }): boolean;
+    requestWorkflowRunResume(options: {
+        runId: string;
+        now?: string;
+    }): boolean;
+    isWorkflowRunPaused(runId: string): boolean;
+    parkWorkflowRunForSourceChange(options: {
+        runId: string;
+        claimToken: string;
+        detail: string;
+        now?: string;
+    }): boolean;
+    parkWorkflowRunForAmbiguousEffect(options: {
+        runId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    failWorkflowRun(options: {
+        runId: string;
+        claimToken?: string;
+        errorCode: string;
+        errorMessage: string;
+        now?: string;
+    }): boolean;
+    cancelWorkflowRun(options: {
+        runId: string;
+        claimToken?: string;
+        now?: string;
+    }): boolean;
+    /** Cancel a nonterminal run only when its claim is absent or expired. */
+    cancelStaleWorkflowRun(options: {
+        runId: string;
+        controlId?: string;
+        claimToken?: string;
+        now?: string;
+    }): boolean;
+    deleteWorkflowRun(options: {
+        runId: string;
+        claimToken: string;
+    }): boolean;
+    completeWorkflowRun(options: {
+        runId: string;
+        claimToken: string;
+        now?: string;
+    }): boolean;
+    recordRunEvent(options: {
+        runId: string;
+        workflowRef: string;
+        type: string;
+        payload?: JsonObject;
+        runnerId?: string;
+        now?: string;
+    }): RunEventRecord;
+    listRunEventsAfter(seq: number, options?: {
+        limit?: number;
+    }): RunEventRecord[];
+    settleRunEffect(runId: string, effectType: "run.park_queue" | "run.settle_queue"): void;
+    private workflowRunRow;
+    private requireWorkflowRunRow;
+    private requireWorkflowRun;
+    private assertWorkflowRunPreparationCompatible;
+    private workflowRunViewRows;
+    private mapWorkflowRun;
+    private claimRun;
+    private claimRunInTransaction;
+    private updateClaimedRunStatus;
+    private releaseRunClaim;
+    private terminalRun;
+    private settleWorkflowRunMessages;
+    private cancelWorkflowRunDependents;
+}