deepline 0.1.119 → 0.1.121

package/dist/bundling-sources/shared_libs/play-runtime/ctx-contract.ts

@@ -0,0 +1,261 @@
+export interface BatchResult {
+  rowId: number;
+  rowKey?: string | null;
+  result: unknown | null;
+}
+
+export interface MapExecutionFrame {
+  mapInvocationId: string;
+  mapNodeId?: string | null;
+  logicalNamespace: string;
+  artifactTableNamespace: string;
+  status: 'running' | 'suspended' | 'completed' | 'failed';
+  totalRows: number;
+  completedRowKeys: string[];
+  pendingRowKeys: string[];
+  activeBoundaryId?: string | null;
+  startedAt: number;
+  updatedAt: number;
+}
+
+export interface PlayRowUpdate {
+  key: string;
+  rowId: number;
+  tableNamespace?: string | null;
+  status?: 'running' | 'completed' | 'failed';
+  stage?: string | null;
+  provider?: string | null;
+  error?: string | null;
+  dataPatch?: Record<string, unknown>;
+  cellMetaPatch?: Record<
+    string,
+    {
+      status:
+        | 'queued'
+        | 'running'
+        | 'completed'
+        | 'failed'
+        | 'cached'
+        | 'missed'
+        | 'skipped';
+      stage?: string | null;
+      provider?: string | null;
+      error?: string | null;
+      producer?: {
+        kind: 'play' | 'tool' | 'code';
+        id?: string | null;
+        displayName?: string | null;
+        playId?: string | null;
+        toolId?: string | null;
+        runId?: string | null;
+      } | null;
+      reused?: boolean;
+      completedAt?: number;
+      staleAt?: number | null;
+      staleAfterSeconds?: number | null;
+    }
+  >;
+}
+
+export type PlayExecutionEvent =
+  | {
+      type: 'map.preparing';
+      mapInvocationId: string;
+      mapNodeId?: string | null;
+      logicalNamespace: string;
+      artifactTableNamespace: string;
+      totalRows: number;
+      completedRows: number;
+      pendingRows: number;
+      at: number;
+    }
+  | {
+      type: 'map.started';
+      mapInvocationId: string;
+      mapNodeId?: string | null;
+      logicalNamespace: string;
+      artifactTableNamespace: string;
+      totalRows: number;
+      completedRows: number;
+      pendingRows: number;
+      at: number;
+    }
+  | {
+      type: 'map.progress';
+      mapInvocationId: string;
+      mapNodeId?: string | null;
+      logicalNamespace: string;
+      artifactTableNamespace: string;
+      completedRows: number;
+      failedRows: number;
+      totalRows?: number;
+      at: number;
+    }
+  | {
+      type: 'map.row.updated';
+      mapInvocationId: string;
+      mapNodeId?: string | null;
+      logicalNamespace: string;
+      artifactTableNamespace: string;
+      rowKey: string;
+      rowStatus?: PlayRowUpdate['status'];
+      fieldName?: string | null;
+      stage?: string | null;
+      provider?: string | null;
+      at: number;
+    }
+  | {
+      type: 'map.completed' | 'map.suspended' | 'map.resumed' | 'map.failed';
+      mapInvocationId: string;
+      mapNodeId?: string | null;
+      logicalNamespace: string;
+      artifactTableNamespace: string;
+      completedRows: number;
+      failedRows: number;
+      totalRows?: number;
+      at: number;
+    };
+
+export interface PlayCheckpoint {
+  completedBatches: Record<string, BatchResult[]>;
+  completedToolBatches: Record<
+    string,
+    Record<string, { done: true; result: unknown | null }>
+  >;
+  resolvedWaterfalls: Record<string, Record<string, unknown>>;
+  resolvedBoundaries?: Record<
+    string,
+    | {
+        kind: 'sleep';
+        delayMs: number;
+        completedAt?: number;
+        scope?: {
+          type: 'workflow' | 'map_row';
+          tableNamespace?: string;
+          rowKey?: string;
+          rowIndex?: number;
+          fieldName?: string;
+        };
+      }
+    | {
+        kind: 'integration_event';
+        eventKey: string;
+        timeoutMs: number;
+        provider?: string;
+        toolId?: string;
+        messageRef?: {
+          channel: string;
+          ts: string;
+        };
+        output?: unknown;
+        completedAt?: number;
+      }
+    | {
+        kind: 'fetch';
+        url: string;
+        method: string;
+        output?: unknown;
+        completedAt?: number;
+      }
+    | {
+        kind: 'step';
+        stepId: string;
+        output?: unknown;
+        completedAt?: number;
+      }
+  >;
+  mapFrames?: Record<string, MapExecutionFrame>;
+}
+
+export interface PlayStepRowResult {
+  rowId: number;
+  status: 'completed' | 'failed' | 'missed' | 'skipped';
+  success: boolean;
+  provider?: string;
+  value?: unknown;
+  error?: string | null;
+}
+
+export type PlayStep =
+  | { type: 'start'; trigger?: string; description?: string }
+  | { type: 'csv_load'; arg?: string; rows?: number; description?: string }
+  | {
+      type: 'dataset';
+      items: number;
+      fields?: string[];
+      substeps: PlayDatasetSubstep[];
+      description?: string;
+    }
+  | {
+      type: 'waterfall';
+      tool?: string;
+      providers?: string[];
+      id?: string;
+      output?: string;
+      minResults?: number;
+      steps?: Array<{
+        id: string;
+        kind?: 'tool' | 'code';
+        toolId?: string;
+        results: PlayStepRowResult[];
+      }>;
+      results: PlayStepRowResult[];
+      description?: string;
+    }
+  | {
+      type: 'tool';
+      toolId: string;
+      results: PlayStepRowResult[];
+      description?: string;
+    }
+  | {
+      type: 'play_call';
+      playId: string;
+      results?: PlayStepRowResult[];
+      nestedSteps: PlayStep[];
+      description?: string;
+    }
+  | {
+      type: 'run_javascript';
+      alias: string;
+      results: PlayStepRowResult[];
+      description?: string;
+    }
+  | { type: 'return'; outputRows: number; description?: string };
+
+export type PlayDatasetSubstep =
+  | {
+      type: 'waterfall';
+      tool?: string;
+      providers?: string[];
+      id?: string;
+      output?: string;
+      minResults?: number;
+      steps?: Array<{
+        id: string;
+        kind?: 'tool' | 'code';
+        toolId?: string;
+        results: PlayStepRowResult[];
+      }>;
+      results: PlayStepRowResult[];
+      description?: string;
+    }
+  | {
+      type: 'tool';
+      toolId: string;
+      results: PlayStepRowResult[];
+      description?: string;
+    }
+  | {
+      type: 'play_call';
+      playId: string;
+      results?: PlayStepRowResult[];
+      nestedSteps: PlayStep[];
+      description?: string;
+    }
+  | {
+      type: 'run_javascript';
+      alias: string;
+      results: PlayStepRowResult[];
+      description?: string;
+    };