convex-effect-workflows 0.1.0

package/src/component/_generated/component.ts

@@ -0,0 +1,1216 @@
+/* eslint-disable */
+/**
+ * Generated `ComponentApi` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type { FunctionReference } from "convex/server";
+
+/**
+ * A utility for referencing a Convex component's exposed API.
+ *
+ * Useful when expecting a parameter like `components.myComponent`.
+ * Usage:
+ * ```ts
+ * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
+ *   return ctx.runQuery(component.someFile.someQuery, { ...args });
+ * }
+ * ```
+ */
+export type ComponentApi<Name extends string | undefined = string | undefined> =
+  {
+    activityCompletions: {
+      completionExists: FunctionReference<
+        "query",
+        "internal",
+        { workId: string },
+        boolean,
+        Name
+      >;
+      getActivityCompletion: FunctionReference<
+        "query",
+        "internal",
+        { workId: string },
+        any | null,
+        Name
+      >;
+      internalCreateActivityCompletion: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; stepNumber: number; workId: string },
+        null,
+        Name
+      >;
+      recordCompletion: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; stepNumber: number; workId: string },
+        boolean,
+        Name
+      >;
+    };
+    cleanup: {
+      cleanupOldExecutions: FunctionReference<
+        "mutation",
+        "internal",
+        { limit?: number; retentionDays?: number },
+        { deletedCount: number; hasMore: boolean },
+        Name
+      >;
+    };
+    clocks: {
+      scheduleDeferredWake: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          deferredName: string;
+          delayMs: number;
+          executionId: string;
+          exit?: any;
+        },
+        string,
+        Name
+      >;
+    };
+    config: {
+      getConfig: FunctionReference<
+        "query",
+        "internal",
+        {},
+        {
+          defaultLogLevel: "debug" | "info" | "warn" | "error";
+          maxInlineBytes: number;
+          maxLogDataBytes: number;
+          maxSpanAttrBytes: number;
+          retentionDays: number;
+        },
+        Name
+      >;
+      setConfig: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          defaultLogLevel?: "debug" | "info" | "warn" | "error";
+          maxInlineBytes?: number;
+          maxLogDataBytes?: number;
+          maxSpanAttrBytes?: number;
+          retentionDays?: number;
+        },
+        {
+          defaultLogLevel: "debug" | "info" | "warn" | "error";
+          maxInlineBytes: number;
+          maxLogDataBytes: number;
+          maxSpanAttrBytes: number;
+          retentionDays: number;
+        },
+        Name
+      >;
+    };
+    dashboard: {
+      executionMetrics: FunctionReference<
+        "query",
+        "internal",
+        {
+          startedAfter?: number;
+          startedBefore?: number;
+          workflowName?: string;
+        },
+        {
+          active: number;
+          avgDurationMs: number;
+          completed: number;
+          failed: number;
+          interrupted: number;
+          p50DurationMs: number;
+          p95DurationMs: number;
+          successRate: number;
+          total: number;
+        },
+        Name
+      >;
+      getExecution: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string },
+        {
+          execution: {
+            _creationTime: number;
+            _id: string;
+            completedAt?: number;
+            error?: string;
+            executionId: string;
+            generation: number;
+            lastResumedAt?: number;
+            lastSuspendedAt?: number;
+            parentExecutionId?: string;
+            payloadPreview?: any;
+            payloadRef?: string;
+            payloadSize: number;
+            resultKind?: "success" | "failure";
+            resultPreview?: any;
+            resultRef?: string;
+            runnerHandle?: string;
+            startedAt: number;
+            status:
+              | "pending"
+              | "running"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "interrupted";
+            tenantId?: string;
+            traceId: string;
+            workflowName: string;
+          };
+          logs: Array<{
+            _creationTime: number;
+            _id: string;
+            data?: any;
+            executionId: string;
+            level: "debug" | "info" | "warn" | "error";
+            message: string;
+            source: "workflow" | "activity" | "engine" | "system";
+            spanId?: string;
+            stepNumber?: number;
+            timestamp: number;
+            traceId?: string;
+          }>;
+          spans: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            attributes?: any;
+            endTime?: number;
+            error?: string;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize?: number;
+            kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+            name: string;
+            outputPreview?: any;
+            outputRef?: string;
+            outputSize?: number;
+            parentSpanId?: string;
+            spanId: string;
+            startTime: number;
+            status: "started" | "ended";
+            stepNumber?: number;
+            traceId: string;
+          }>;
+          steps: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            completedAt?: number;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            name: string;
+            resumeToken?: string;
+            runResult?:
+              | { kind: "success"; valuePreview?: any; valueRef?: string }
+              | {
+                  error: string;
+                  kind: "failed";
+                  valuePreview?: any;
+                  valueRef?: string;
+                }
+              | { kind: "canceled" };
+            signature: {
+              attempt?: number;
+              kind:
+                | "activity"
+                | "deferred"
+                | "clock"
+                | "nestedWorkflow"
+                | "system";
+              opName: string;
+              scheduleMeta?: any;
+              schemaVersion?: number;
+            };
+            spanId?: string;
+            startedAt: number;
+            state:
+              | "started"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "canceled";
+            stepNumber: number;
+            workId?: string;
+          }>;
+        } | null,
+        Name
+      >;
+      listExecutionLogs: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterLogId?: string;
+          afterTimestamp?: number;
+          executionId: string;
+          level?: "debug" | "info" | "warn" | "error";
+          limit?: number;
+          order?: "asc" | "desc";
+          source?: "workflow" | "activity" | "engine" | "system";
+          spanId?: string;
+        },
+        {
+          cursor: { logId: string; timestamp: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            data?: any;
+            executionId: string;
+            level: "debug" | "info" | "warn" | "error";
+            message: string;
+            source: "workflow" | "activity" | "engine" | "system";
+            spanId?: string;
+            stepNumber?: number;
+            timestamp: number;
+            traceId?: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutions: FunctionReference<
+        "query",
+        "internal",
+        {
+          cursorExecutionId?: string;
+          cursorStartedAt?: number;
+          limit?: number;
+          order?: "asc" | "desc";
+          startedAfter?: number;
+          startedBefore?: number;
+          status?:
+            | "pending"
+            | "running"
+            | "suspended"
+            | "completed"
+            | "failed"
+            | "interrupted";
+          tenantId?: string;
+          workflowName?: string;
+        },
+        {
+          cursor: { executionId: string; startedAt: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            completedAt?: number;
+            error?: string;
+            executionId: string;
+            generation: number;
+            lastResumedAt?: number;
+            lastSuspendedAt?: number;
+            parentExecutionId?: string;
+            payloadPreview?: any;
+            payloadRef?: string;
+            payloadSize: number;
+            resultKind?: "success" | "failure";
+            resultPreview?: any;
+            resultRef?: string;
+            runnerHandle?: string;
+            startedAt: number;
+            status:
+              | "pending"
+              | "running"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "interrupted";
+            tenantId?: string;
+            traceId: string;
+            workflowName: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutionSpans: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterSpanId?: string;
+          afterStartTime?: number;
+          executionId: string;
+          kind?: "workflow" | "activity" | "deferred" | "clock" | "system";
+          limit?: number;
+          status?: "started" | "ended";
+        },
+        {
+          cursor: { spanId: string; startTime: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            attributes?: any;
+            endTime?: number;
+            error?: string;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize?: number;
+            kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+            name: string;
+            outputPreview?: any;
+            outputRef?: string;
+            outputSize?: number;
+            parentSpanId?: string;
+            spanId: string;
+            startTime: number;
+            status: "started" | "ended";
+            stepNumber?: number;
+            traceId: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutionSteps: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterStepNumber?: number;
+          executionId: string;
+          limit?: number;
+          state?: "started" | "suspended" | "completed" | "failed" | "canceled";
+        },
+        {
+          cursor: number | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            completedAt?: number;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            name: string;
+            resumeToken?: string;
+            runResult?:
+              | { kind: "success"; valuePreview?: any; valueRef?: string }
+              | {
+                  error: string;
+                  kind: "failed";
+                  valuePreview?: any;
+                  valueRef?: string;
+                }
+              | { kind: "canceled" };
+            signature: {
+              attempt?: number;
+              kind:
+                | "activity"
+                | "deferred"
+                | "clock"
+                | "nestedWorkflow"
+                | "system";
+              opName: string;
+              scheduleMeta?: any;
+              schemaVersion?: number;
+            };
+            spanId?: string;
+            startedAt: number;
+            state:
+              | "started"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "canceled";
+            stepNumber: number;
+            workId?: string;
+          }>;
+        },
+        Name
+      >;
+    };
+    deferreds: {
+      completeDeferred: FunctionReference<
+        "mutation",
+        "internal",
+        { deferredName: string; executionId: string; exit: any },
+        null,
+        Name
+      >;
+      createDeferred: FunctionReference<
+        "mutation",
+        "internal",
+        { deferredName: string; executionId: string },
+        null,
+        Name
+      >;
+      deferredDone: FunctionReference<
+        "mutation",
+        "internal",
+        { deferredName: string; executionId: string; exit: any },
+        { changed: boolean },
+        Name
+      >;
+      deferredResult: FunctionReference<
+        "query",
+        "internal",
+        { deferredName: string; executionId: string },
+        any,
+        Name
+      >;
+      registerDeferred: FunctionReference<
+        "mutation",
+        "internal",
+        { deferredName: string; executionId: string },
+        null,
+        Name
+      >;
+    };
+    executions: {
+      completeExecution: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          error?: string;
+          executionId: string;
+          generation: number;
+          kind: "success" | "failure";
+          result?: any;
+        },
+        { changed: boolean },
+        Name
+      >;
+      createExecution: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          executionId: string;
+          parentExecutionId?: string;
+          payload: any;
+          runnerHandle?: string;
+          tenantId?: string;
+          traceId?: string;
+          workflowName: string;
+        },
+        { created: boolean; executionId: string },
+        Name
+      >;
+      getExecution: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string },
+        any,
+        Name
+      >;
+      internalPatchExecution: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; startedAt: number },
+        null,
+        Name
+      >;
+      interruptExecution: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; reason?: string },
+        { generation: number },
+        Name
+      >;
+      setExecutionRunning: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; generation: number },
+        { changed: boolean },
+        Name
+      >;
+      setExecutionSuspended: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; generation: number },
+        { changed: boolean },
+        Name
+      >;
+    };
+    journalSteps: {
+      appendJournalStep: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          attempt?: number;
+          executionId: string;
+          input: any;
+          kind: "activity" | "deferred" | "clock" | "nestedWorkflow" | "system";
+          name: string;
+          signature: {
+            attempt?: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            opName: string;
+            scheduleMeta?: any;
+            schemaVersion?: number;
+          };
+          spanId?: string;
+          stepNumber: number;
+        },
+        any,
+        Name
+      >;
+      assertReplayStepSignature: FunctionReference<
+        "query",
+        "internal",
+        {
+          executionId: string;
+          expectedSignature: {
+            attempt?: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            opName: string;
+            scheduleMeta?: any;
+            schemaVersion?: number;
+          };
+          stepNumber: number;
+        },
+        any,
+        Name
+      >;
+      completeJournalStep: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          executionId: string;
+          runResult:
+            | { kind: "success"; valuePreview?: any; valueRef?: string }
+            | {
+                error: string;
+                kind: "failed";
+                valuePreview?: any;
+                valueRef?: string;
+              }
+            | { kind: "canceled" };
+          stepNumber: number;
+        },
+        { changed: boolean },
+        Name
+      >;
+      failJournalStep: FunctionReference<
+        "mutation",
+        "internal",
+        { error: string; executionId: string; stepNumber: number },
+        { changed: boolean },
+        Name
+      >;
+      getJournalStep: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string; stepNumber: number },
+        any,
+        Name
+      >;
+      listJournalSteps: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterStepNumber?: number;
+          executionId: string;
+          limit: number;
+          state?: "started" | "suspended" | "completed" | "failed" | "canceled";
+        },
+        any,
+        Name
+      >;
+      loadJournalForExecution: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string },
+        any,
+        Name
+      >;
+      suspendJournalStep: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          executionId: string;
+          resumeToken?: string;
+          stepNumber: number;
+          workId: string;
+        },
+        { changed: boolean },
+        Name
+      >;
+    };
+    logs: {
+      appendLog: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          data?: any;
+          executionId: string;
+          level: "debug" | "info" | "warn" | "error";
+          message: string;
+          source: "workflow" | "activity" | "engine" | "system";
+          spanId?: string;
+          stepNumber?: number;
+          timestamp?: number;
+          traceId?: string;
+        },
+        null,
+        Name
+      >;
+      createLog: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          executionId: string;
+          level: "debug" | "info" | "warn" | "error";
+          message: string;
+          source: "workflow" | "activity" | "engine" | "system";
+          spanId?: string;
+          stepNumber?: number;
+          timestamp: number;
+          traceId?: string;
+        },
+        null,
+        Name
+      >;
+      listExecutionLogs: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterTimestamp?: number;
+          executionId: string;
+          level?: "debug" | "info" | "warn" | "error";
+          limit: number;
+          source?: "workflow" | "activity" | "engine" | "system";
+          spanId?: string;
+        },
+        any,
+        Name
+      >;
+      listSpanLogs: FunctionReference<
+        "query",
+        "internal",
+        { afterTimestamp?: number; limit: number; spanId: string },
+        any,
+        Name
+      >;
+    };
+    onComplete: {
+      handleActivityCompletion: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          context: {
+            executionId: string;
+            generation: number;
+            spanId?: string;
+            stepNumber: number;
+          };
+          result:
+            | { kind: "success"; returnValue: any }
+            | { error: string; kind: "failed" }
+            | { kind: "canceled" };
+          workId: string;
+        },
+        { processed: boolean; resumed: boolean; stale: boolean },
+        Name
+      >;
+    };
+    payloads: {
+      createPayload: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          data: any;
+          kind:
+            | "executionPayload"
+            | "stepInput"
+            | "stepOutput"
+            | "deferredExit"
+            | "spanInput"
+            | "spanOutput"
+            | "logData";
+        },
+        string,
+        Name
+      >;
+      getPayload: FunctionReference<
+        "query",
+        "internal",
+        { payloadId: string },
+        any,
+        Name
+      >;
+    };
+    queries: {
+      executionMetrics: FunctionReference<
+        "query",
+        "internal",
+        {
+          startedAfter?: number;
+          startedBefore?: number;
+          workflowName?: string;
+        },
+        {
+          active: number;
+          avgDurationMs: number;
+          completed: number;
+          failed: number;
+          interrupted: number;
+          p50DurationMs: number;
+          p95DurationMs: number;
+          successRate: number;
+          total: number;
+        },
+        Name
+      >;
+      getExecution: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string },
+        {
+          execution: {
+            _creationTime: number;
+            _id: string;
+            completedAt?: number;
+            error?: string;
+            executionId: string;
+            generation: number;
+            lastResumedAt?: number;
+            lastSuspendedAt?: number;
+            parentExecutionId?: string;
+            payloadPreview?: any;
+            payloadRef?: string;
+            payloadSize: number;
+            resultKind?: "success" | "failure";
+            resultPreview?: any;
+            resultRef?: string;
+            runnerHandle?: string;
+            startedAt: number;
+            status:
+              | "pending"
+              | "running"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "interrupted";
+            tenantId?: string;
+            traceId: string;
+            workflowName: string;
+          };
+          logs: Array<{
+            _creationTime: number;
+            _id: string;
+            data?: any;
+            executionId: string;
+            level: "debug" | "info" | "warn" | "error";
+            message: string;
+            source: "workflow" | "activity" | "engine" | "system";
+            spanId?: string;
+            stepNumber?: number;
+            timestamp: number;
+            traceId?: string;
+          }>;
+          spans: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            attributes?: any;
+            endTime?: number;
+            error?: string;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize?: number;
+            kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+            name: string;
+            outputPreview?: any;
+            outputRef?: string;
+            outputSize?: number;
+            parentSpanId?: string;
+            spanId: string;
+            startTime: number;
+            status: "started" | "ended";
+            stepNumber?: number;
+            traceId: string;
+          }>;
+          steps: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            completedAt?: number;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            name: string;
+            resumeToken?: string;
+            runResult?:
+              | { kind: "success"; valuePreview?: any; valueRef?: string }
+              | {
+                  error: string;
+                  kind: "failed";
+                  valuePreview?: any;
+                  valueRef?: string;
+                }
+              | { kind: "canceled" };
+            signature: {
+              attempt?: number;
+              kind:
+                | "activity"
+                | "deferred"
+                | "clock"
+                | "nestedWorkflow"
+                | "system";
+              opName: string;
+              scheduleMeta?: any;
+              schemaVersion?: number;
+            };
+            spanId?: string;
+            startedAt: number;
+            state:
+              | "started"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "canceled";
+            stepNumber: number;
+            workId?: string;
+          }>;
+        } | null,
+        Name
+      >;
+      listExecutionLogs: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterLogId?: string;
+          afterTimestamp?: number;
+          executionId: string;
+          level?: "debug" | "info" | "warn" | "error";
+          limit?: number;
+          order?: "asc" | "desc";
+          source?: "workflow" | "activity" | "engine" | "system";
+          spanId?: string;
+        },
+        {
+          cursor: { logId: string; timestamp: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            data?: any;
+            executionId: string;
+            level: "debug" | "info" | "warn" | "error";
+            message: string;
+            source: "workflow" | "activity" | "engine" | "system";
+            spanId?: string;
+            stepNumber?: number;
+            timestamp: number;
+            traceId?: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutions: FunctionReference<
+        "query",
+        "internal",
+        {
+          cursorExecutionId?: string;
+          cursorStartedAt?: number;
+          limit?: number;
+          order?: "asc" | "desc";
+          startedAfter?: number;
+          startedBefore?: number;
+          status?:
+            | "pending"
+            | "running"
+            | "suspended"
+            | "completed"
+            | "failed"
+            | "interrupted";
+          tenantId?: string;
+          workflowName?: string;
+        },
+        {
+          cursor: { executionId: string; startedAt: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            completedAt?: number;
+            error?: string;
+            executionId: string;
+            generation: number;
+            lastResumedAt?: number;
+            lastSuspendedAt?: number;
+            parentExecutionId?: string;
+            payloadPreview?: any;
+            payloadRef?: string;
+            payloadSize: number;
+            resultKind?: "success" | "failure";
+            resultPreview?: any;
+            resultRef?: string;
+            runnerHandle?: string;
+            startedAt: number;
+            status:
+              | "pending"
+              | "running"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "interrupted";
+            tenantId?: string;
+            traceId: string;
+            workflowName: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutionSpans: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterSpanId?: string;
+          afterStartTime?: number;
+          executionId: string;
+          kind?: "workflow" | "activity" | "deferred" | "clock" | "system";
+          limit?: number;
+          status?: "started" | "ended";
+        },
+        {
+          cursor: { spanId: string; startTime: number } | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            attributes?: any;
+            endTime?: number;
+            error?: string;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize?: number;
+            kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+            name: string;
+            outputPreview?: any;
+            outputRef?: string;
+            outputSize?: number;
+            parentSpanId?: string;
+            spanId: string;
+            startTime: number;
+            status: "started" | "ended";
+            stepNumber?: number;
+            traceId: string;
+          }>;
+        },
+        Name
+      >;
+      listExecutionSteps: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterStepNumber?: number;
+          executionId: string;
+          limit?: number;
+          state?: "started" | "suspended" | "completed" | "failed" | "canceled";
+        },
+        {
+          cursor: number | null;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            attempt?: number;
+            completedAt?: number;
+            executionId: string;
+            inputPreview?: any;
+            inputRef?: string;
+            inputSize: number;
+            kind:
+              | "activity"
+              | "deferred"
+              | "clock"
+              | "nestedWorkflow"
+              | "system";
+            name: string;
+            resumeToken?: string;
+            runResult?:
+              | { kind: "success"; valuePreview?: any; valueRef?: string }
+              | {
+                  error: string;
+                  kind: "failed";
+                  valuePreview?: any;
+                  valueRef?: string;
+                }
+              | { kind: "canceled" };
+            signature: {
+              attempt?: number;
+              kind:
+                | "activity"
+                | "deferred"
+                | "clock"
+                | "nestedWorkflow"
+                | "system";
+              opName: string;
+              scheduleMeta?: any;
+              schemaVersion?: number;
+            };
+            spanId?: string;
+            startedAt: number;
+            state:
+              | "started"
+              | "suspended"
+              | "completed"
+              | "failed"
+              | "canceled";
+            stepNumber: number;
+            workId?: string;
+          }>;
+        },
+        Name
+      >;
+    };
+    runner: {
+      enqueueActivity: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          activityName: string;
+          activityWorkerHandle: string;
+          attempt: number;
+          executionId: string;
+          generation: number;
+          spanId?: string;
+          stepNumber: number;
+          workflowName: string;
+          workpoolOptions?: {
+            defaultRetryBehavior?: {
+              base: number;
+              initialBackoffMs: number;
+              maxAttempts: number;
+            };
+            logLevel?: "DEBUG" | "TRACE" | "INFO" | "REPORT" | "WARN" | "ERROR";
+            maxParallelism?: number;
+            retryActionsByDefault?: boolean;
+          };
+        },
+        string,
+        Name
+      >;
+      run: FunctionReference<
+        "mutation",
+        "internal",
+        { executionId: string; generation: number },
+        { enqueued: boolean; reason?: string },
+        Name
+      >;
+    };
+    spans: {
+      createSpan: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          attempt?: number;
+          attributes?: any;
+          executionId: string;
+          input?: any;
+          kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+          name: string;
+          parentSpanId?: string;
+          spanId?: string;
+          stepNumber?: number;
+          traceId: string;
+        },
+        { created: boolean; spanId: string },
+        Name
+      >;
+      endSpan: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          attributes?: any;
+          error?: string;
+          executionId: string;
+          output?: any;
+          spanId: string;
+        },
+        { changed: boolean },
+        Name
+      >;
+      getExecutionSpan: FunctionReference<
+        "query",
+        "internal",
+        { executionId: string; spanId: string },
+        any,
+        Name
+      >;
+      internalCreateSpan: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          attempt?: number;
+          attributes?: any;
+          endTime?: number;
+          error?: string;
+          executionId: string;
+          input?: any;
+          kind: "workflow" | "activity" | "deferred" | "clock" | "system";
+          name: string;
+          output?: any;
+          parentSpanId?: string;
+          spanId?: string;
+          startTime: number;
+          status: "started" | "ended";
+          stepNumber?: number;
+          traceId: string;
+        },
+        { spanId: string },
+        Name
+      >;
+      listExecutionSpans: FunctionReference<
+        "query",
+        "internal",
+        {
+          afterStartTime?: number;
+          executionId: string;
+          kind?: "workflow" | "activity" | "deferred" | "clock" | "system";
+          limit: number;
+          status?: "started" | "ended";
+        },
+        any,
+        Name
+      >;
+    };
+  };