deepline 0.1.28 → 0.1.30

package/dist/index.d.mts

@@ -847,11 +847,41 @@ type RunsLogsResult = {
     hasMore: boolean;
     entries: string[];
 };
+type PlaySheetRow = {
+    key?: string;
+    status?: string;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type PlaySheetRowsResult = {
+    rows: PlaySheetRow[];
+    summary?: {
+        stats?: {
+            total?: number;
+            queued?: number;
+            running?: number;
+            completed?: number;
+            failed?: number;
+            [key: string]: unknown;
+        };
+        columns?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    customerDbUrl?: string;
+    deltaCursor?: number;
+};
 type RunsNamespace = {
     get: (runId: string) => Promise<PlayStatus>;
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
     logs: (runId: string, options?: RunsLogsOptions) => Promise<RunsLogsResult>;
+    exportDatasetRows: (input: {
+        playName: string;
+        tableNamespace: string;
+        runId?: string;
+        limit?: number;
+        offset?: number;
+    }) => Promise<PlaySheetRowsResult>;
     stop: (runId: string, options?: {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
@@ -1248,6 +1278,13 @@ declare class DeeplineClient {
      * ```
      */
     getRunLogs(runId: string, options?: RunsLogsOptions): Promise<RunsLogsResult>;
+    getPlaySheetRows(input: {
+        playName: string;
+        tableNamespace: string;
+        runId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<PlaySheetRowsResult>;
     /**
      * Stop a run by id using the public runs resource model.
      *
@@ -1401,8 +1438,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.28";
-declare const SDK_API_CONTRACT = "2026-05-runs-v2";
+declare const SDK_VERSION = "0.1.30";
+declare const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
 
 /**
  * Base error class for all Deepline SDK errors.
@@ -1915,6 +1952,9 @@ interface DeeplinePlayRuntimeContext {
     tool<TOutput = LoosePlayObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
         description?: string;
     }): Promise<ToolExecuteResult<TOutput>>;
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
+        description?: string;
+    }): Promise<TOutput>;
     step<T>(id: string, run: () => T | Promise<T>): Promise<T>;
     fetch(key: string, url: string | URL, init?: RequestInit): Promise<{
         ok: boolean;

package/dist/index.d.ts

@@ -847,11 +847,41 @@ type RunsLogsResult = {
     hasMore: boolean;
     entries: string[];
 };
+type PlaySheetRow = {
+    key?: string;
+    status?: string;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type PlaySheetRowsResult = {
+    rows: PlaySheetRow[];
+    summary?: {
+        stats?: {
+            total?: number;
+            queued?: number;
+            running?: number;
+            completed?: number;
+            failed?: number;
+            [key: string]: unknown;
+        };
+        columns?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    customerDbUrl?: string;
+    deltaCursor?: number;
+};
 type RunsNamespace = {
     get: (runId: string) => Promise<PlayStatus>;
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
     logs: (runId: string, options?: RunsLogsOptions) => Promise<RunsLogsResult>;
+    exportDatasetRows: (input: {
+        playName: string;
+        tableNamespace: string;
+        runId?: string;
+        limit?: number;
+        offset?: number;
+    }) => Promise<PlaySheetRowsResult>;
     stop: (runId: string, options?: {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
@@ -1248,6 +1278,13 @@ declare class DeeplineClient {
      * ```
      */
     getRunLogs(runId: string, options?: RunsLogsOptions): Promise<RunsLogsResult>;
+    getPlaySheetRows(input: {
+        playName: string;
+        tableNamespace: string;
+        runId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<PlaySheetRowsResult>;
     /**
      * Stop a run by id using the public runs resource model.
      *
@@ -1401,8 +1438,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.28";
-declare const SDK_API_CONTRACT = "2026-05-runs-v2";
+declare const SDK_VERSION = "0.1.30";
+declare const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
 
 /**
  * Base error class for all Deepline SDK errors.
@@ -1915,6 +1952,9 @@ interface DeeplinePlayRuntimeContext {
     tool<TOutput = LoosePlayObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
         description?: string;
     }): Promise<ToolExecuteResult<TOutput>>;
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
+        description?: string;
+    }): Promise<TOutput>;
     step<T>(id: string, run: () => T | Promise<T>): Promise<T>;
     fetch(key: string, url: string | URL, init?: RequestInit): Promise<{
         ok: boolean;

package/dist/index.js

@@ -241,8 +241,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.28";
-var SDK_API_CONTRACT = "2026-05-runs-v2";
+var SDK_VERSION = "0.1.30";
+var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -651,6 +651,7 @@ var DeeplineClient = class {
       list: (options2) => this.listRuns(options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
+      exportDatasetRows: (input) => this.getPlaySheetRows(input),
       stop: (runId, options2) => this.stopRun(runId, options2)
     };
   }
@@ -678,7 +679,7 @@ var DeeplineClient = class {
     const target = play.reference || play.name;
     if (options?.csvInput) {
       const inputField = typeof options.csvInput.inputField === "string" && options.csvInput.inputField.trim() ? options.csvInput.inputField.trim() : "csv";
-      return `deepline plays run ${target} --${inputField} leads.csv --watch`;
+      return `deepline plays run ${target} --input '${JSON.stringify({ [inputField]: "leads.csv" })}' --watch`;
     }
     return `deepline plays run ${target} --input '{...}' --watch`;
   }
@@ -1338,6 +1339,19 @@ var DeeplineClient = class {
       entries
     };
   }
+  async getPlaySheetRows(input) {
+    const params = new URLSearchParams({
+      tableNamespace: input.tableNamespace,
+      limit: String(input.limit ?? 5e3),
+      offset: String(input.offset ?? 0)
+    });
+    if (input.runId?.trim()) {
+      params.set("runId", input.runId.trim());
+    }
+    return await this.http.get(
+      `/api/v2/plays/${encodeURIComponent(input.playName)}/sheet?${params.toString()}`
+    );
+  }
   /**
    * Stop a run by id using the public runs resource model.
    *

package/dist/index.mjs

@@ -195,8 +195,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.28";
-var SDK_API_CONTRACT = "2026-05-runs-v2";
+var SDK_VERSION = "0.1.30";
+var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -605,6 +605,7 @@ var DeeplineClient = class {
       list: (options2) => this.listRuns(options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
+      exportDatasetRows: (input) => this.getPlaySheetRows(input),
       stop: (runId, options2) => this.stopRun(runId, options2)
     };
   }
@@ -632,7 +633,7 @@ var DeeplineClient = class {
     const target = play.reference || play.name;
     if (options?.csvInput) {
       const inputField = typeof options.csvInput.inputField === "string" && options.csvInput.inputField.trim() ? options.csvInput.inputField.trim() : "csv";
-      return `deepline plays run ${target} --${inputField} leads.csv --watch`;
+      return `deepline plays run ${target} --input '${JSON.stringify({ [inputField]: "leads.csv" })}' --watch`;
     }
     return `deepline plays run ${target} --input '{...}' --watch`;
   }
@@ -1292,6 +1293,19 @@ var DeeplineClient = class {
       entries
     };
   }
+  async getPlaySheetRows(input) {
+    const params = new URLSearchParams({
+      tableNamespace: input.tableNamespace,
+      limit: String(input.limit ?? 5e3),
+      offset: String(input.offset ?? 0)
+    });
+    if (input.runId?.trim()) {
+      params.set("runId", input.runId.trim());
+    }
+    return await this.http.get(
+      `/api/v2/plays/${encodeURIComponent(input.playName)}/sheet?${params.toString()}`
+    );
+  }
   /**
    * Stop a run by id using the public runs resource model.
    *

package/dist/repo/apps/play-runner-workers/src/runtime/dataset-handles.ts

@@ -24,8 +24,18 @@ type DatasetChunkReader<T extends DatasetRow> = (
   chunkSize: number,
 ) => AsyncIterable<T[]>;
 
+export type WorkerDatasetCapabilities = {
+  storage: 'materialized' | 'runtime_sheet' | 'csv_stream' | 'iterable';
+  chunkReadable: boolean;
+  pageBacked: boolean;
+  replayable: boolean;
+  countHint: number | null;
+  materialization: 'bounded' | 'in_memory';
+};
+
 const datasetChunkReaders = new WeakMap<object, DatasetChunkReader<DatasetRow>>();
 const datasetCountHints = new WeakMap<object, number | null>();
+const datasetCapabilities = new WeakMap<object, WorkerDatasetCapabilities>();
 
 function cloneRow<T extends DatasetRow>(row: T): T {
   return { ...row };
@@ -35,12 +45,14 @@ function registerChunkReader<T extends DatasetRow>(
   dataset: PlayDataset<T>,
   reader: DatasetChunkReader<T>,
   countHint: number | null,
+  capabilities: Omit<WorkerDatasetCapabilities, 'countHint'>,
 ): PlayDataset<T> {
   datasetChunkReaders.set(
     dataset as object,
     reader as DatasetChunkReader<DatasetRow>,
   );
   datasetCountHints.set(dataset as object, countHint);
+  datasetCapabilities.set(dataset as object, { ...capabilities, countHint });
   return dataset;
 }
 
@@ -95,6 +107,13 @@ export function createMaterializedDatasetHandle<T extends DatasetRow>(input: {
       }
     },
     Math.max(0, Math.floor(input.count ?? materializedRows.length)),
+    {
+      storage: 'materialized',
+      chunkReadable: true,
+      pageBacked: false,
+      replayable: true,
+      materialization: 'in_memory',
+    },
   );
 }
 
@@ -208,7 +227,13 @@ export function createPersistedDatasetHandle<T extends DatasetRow>(input: {
         }) as AsyncIterable<T>,
     },
   });
-  return registerChunkReader(dataset, (chunkSize) => readChunks(chunkSize), count);
+  return registerChunkReader(dataset, (chunkSize) => readChunks(chunkSize), count, {
+    storage: 'runtime_sheet',
+    chunkReadable: true,
+    pageBacked: true,
+    replayable: true,
+    materialization: 'bounded',
+  });
 }
 
 export function createCsvDatasetHandle<T extends DatasetRow>(input: {
@@ -333,7 +358,13 @@ export function createCsvDatasetHandle<T extends DatasetRow>(input: {
         }) as AsyncIterable<T>,
     },
   });
-  return registerChunkReader(dataset, (chunkSize) => readChunks(chunkSize), null);
+  return registerChunkReader(dataset, (chunkSize) => readChunks(chunkSize), null, {
+    storage: 'csv_stream',
+    chunkReadable: true,
+    pageBacked: false,
+    replayable: true,
+    materialization: 'bounded',
+  });
 }
 
 export function createInlineDatasetHandle<T extends DatasetRow>(
@@ -363,6 +394,35 @@ export function datasetRowCountHint<T extends DatasetRow>(
   return null;
 }
 
+export function datasetHandleCapabilities<T extends DatasetRow>(
+  input: WorkerDatasetInput<T>,
+): WorkerDatasetCapabilities {
+  if (Array.isArray(input)) {
+    return {
+      storage: 'materialized',
+      chunkReadable: true,
+      pageBacked: false,
+      replayable: true,
+      countHint: input.length,
+      materialization: 'in_memory',
+    };
+  }
+  if (isPlayDataset<T>(input)) {
+    const capabilities = datasetCapabilities.get(input as object);
+    if (capabilities) {
+      return capabilities;
+    }
+  }
+  return {
+    storage: 'iterable',
+    chunkReadable: false,
+    pageBacked: false,
+    replayable: false,
+    countHint: null,
+    materialization: 'bounded',
+  };
+}
+
 export function isDatasetHandle<T extends DatasetRow>(
   value: unknown,
 ): value is WorkerDatasetHandle<T> {

package/dist/repo/sdk/src/client.ts

@@ -127,11 +127,43 @@ export type RunsLogsResult = {
   entries: string[];
 };
 
+export type PlaySheetRow = {
+  key?: string;
+  status?: string;
+  data?: Record<string, unknown>;
+  [key: string]: unknown;
+};
+
+export type PlaySheetRowsResult = {
+  rows: PlaySheetRow[];
+  summary?: {
+    stats?: {
+      total?: number;
+      queued?: number;
+      running?: number;
+      completed?: number;
+      failed?: number;
+      [key: string]: unknown;
+    };
+    columns?: Record<string, unknown>;
+    [key: string]: unknown;
+  };
+  customerDbUrl?: string;
+  deltaCursor?: number;
+};
+
 export type RunsNamespace = {
   get: (runId: string) => Promise<PlayStatus>;
   list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
   tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
   logs: (runId: string, options?: RunsLogsOptions) => Promise<RunsLogsResult>;
+  exportDatasetRows: (input: {
+    playName: string;
+    tableNamespace: string;
+    runId?: string;
+    limit?: number;
+    offset?: number;
+  }) => Promise<PlaySheetRowsResult>;
   stop: (
     runId: string,
     options?: { reason?: string },
@@ -333,6 +365,7 @@ export class DeeplineClient {
       list: (options) => this.listRuns(options),
       tail: (runId, options) => this.tailRun(runId, options),
       logs: (runId, options) => this.getRunLogs(runId, options),
+      exportDatasetRows: (input) => this.getPlaySheetRows(input),
       stop: (runId, options) => this.stopRun(runId, options),
     };
   }
@@ -381,7 +414,7 @@ export class DeeplineClient {
         options.csvInput.inputField.trim()
           ? options.csvInput.inputField.trim()
           : 'csv';
-      return `deepline plays run ${target} --${inputField} leads.csv --watch`;
+      return `deepline plays run ${target} --input '${JSON.stringify({ [inputField]: 'leads.csv' })}' --watch`;
     }
     return `deepline plays run ${target} --input '{...}' --watch`;
   }
@@ -1282,6 +1315,26 @@ export class DeeplineClient {
     };
   }
 
+  async getPlaySheetRows(input: {
+    playName: string;
+    tableNamespace: string;
+    runId?: string;
+    limit?: number;
+    offset?: number;
+  }): Promise<PlaySheetRowsResult> {
+    const params = new URLSearchParams({
+      tableNamespace: input.tableNamespace,
+      limit: String(input.limit ?? 5000),
+      offset: String(input.offset ?? 0),
+    });
+    if (input.runId?.trim()) {
+      params.set('runId', input.runId.trim());
+    }
+    return await this.http.get<PlaySheetRowsResult>(
+      `/api/v2/plays/${encodeURIComponent(input.playName)}/sheet?${params.toString()}`,
+    );
+  }
+
   /**
    * Stop a run by id using the public runs resource model.
    *

package/dist/repo/sdk/src/play.ts

@@ -408,6 +408,11 @@ export interface DeeplinePlayRuntimeContext {
     input: Record<string, unknown>,
     options?: { description?: string },
   ): Promise<ToolExecuteResult<TOutput>>;
+  runSteps<TInput extends Record<string, unknown>, TOutput>(
+    program: StepProgram<TInput, any, TOutput>,
+    input: TInput,
+    options?: { description?: string },
+  ): Promise<TOutput>;
   step<T>(id: string, run: () => T | Promise<T>): Promise<T>;
   fetch(
     key: string,

package/dist/repo/sdk/src/version.ts

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.1.28";
-export const SDK_API_CONTRACT = "2026-05-runs-v2";
+export const SDK_VERSION = "0.1.30";
+export const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {