deepline 0.1.93 → 0.1.95

package/dist/index.d.mts

@@ -1194,6 +1194,10 @@ type EnrichStepCommand = {
     alias: string;
     tool: string;
     operation?: string;
+    play?: {
+        ref: string;
+        mode?: 'scalar';
+    };
     payload: Record<string, unknown>;
     extract_js?: string;
     run_if_js?: string;
@@ -1638,6 +1642,7 @@ declare class DeeplineClient {
     compileEnrichPlan(input: {
         plan_args?: string[];
         config?: unknown;
+        native_play_materialization?: 'macro' | 'inline_prebuilt';
     }): Promise<{
         config: EnrichCompiledConfig;
     }>;
@@ -1812,6 +1817,56 @@ declare class DeeplineClient {
      * ```
      */
     listPlayRuns(playName: string): Promise<PlayRunListItem[]>;
+    /** List the org's workflows. `GET /api/v2/workflows`. */
+    listWorkflows(options?: {
+        limit?: number;
+    }): Promise<{
+        workflows: Array<{
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+        }>;
+    }>;
+    /**
+     * Fetch a single workflow (including its published-revision config — the
+     * input to `compileWorkflowConfigToPlay`). `GET /api/v2/workflows/:id`.
+     */
+    getWorkflow(id: string): Promise<{
+        workflow: {
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+            current_published_revision: {
+                version: number;
+                config: unknown;
+            } | null;
+        } | null;
+        validation?: unknown;
+    }>;
+    /** Delete a workflow. `DELETE /api/v2/workflows/:id`. */
+    deleteWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow off. `POST /api/v2/workflows/:id/disable`. */
+    disableWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow back on. `POST /api/v2/workflows/:id/enable`. */
+    enableWorkflow(id: string): Promise<unknown>;
+    /** Create/update a workflow from config. `POST /api/v2/workflows/apply`. */
+    applyWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Validate a workflow config without saving. `POST /api/v2/workflows/lint`. */
+    lintWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Fetch live workflow request schemas. `GET /api/v2/workflows/schema`. */
+    getWorkflowSchema(subject?: string): Promise<unknown>;
+    /** Queue a workflow run. `POST /api/v2/workflows/call`. */
+    callWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** List a workflow's runs. `GET /api/v2/workflows/:id/runs`. */
+    listWorkflowRuns(id: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    /** Fetch one workflow run. `GET /api/v2/workflows/:id/runs/:runId`. */
+    getWorkflowRun(id: string, runId: string): Promise<unknown>;
+    /** Cancel a workflow run. `POST /api/v2/workflows/:id/runs/:runId/cancel`. */
+    cancelWorkflowRun(id: string, runId: string): Promise<unknown>;
     /**
      * Get a run by id using the public runs resource model.
      *
@@ -2226,107 +2281,6 @@ declare const PROD_URL = "https://code.deepline.com";
  */
 declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
 
-interface PlayR2FileRef {
-    storageKind: 'r2';
-    storageKey: string;
-    logicalPath: string;
-    fileName: string;
-    contentHash: string;
-    contentType: string;
-    bytes: number;
-}
-type PlayExecutionFileRef = PlayR2FileRef;
-
-declare const PLAY_DATASET_BRAND: unique symbol;
-type PlayDatasetKind = 'csv' | 'map';
-type PlayDatasetBacking = {
-    storage: 'neon_sheet';
-    sheet: {
-        playName: string;
-        tableNamespace: string;
-    };
-} | {
-    storage: 'r2_file';
-    file: PlayExecutionFileRef;
-};
-type PlayDatasetWorkProgressSummary = {
-    total: number;
-    executed: number;
-    reused: number;
-    skipped: number;
-    pending: number;
-    failed: number;
-    degraded?: boolean;
-    duplicates?: {
-        exact?: number;
-        semantic?: number;
-        rejected?: number;
-    };
-};
-type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
-type PlayDatasetTransformOptions = {
-    key?: string;
-    sourceLabel?: string | null;
-};
-/**
- * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
- *
- * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
- * rows, usually backed by persisted sheet storage, and carries metadata such as
- * dataset kind, dataset id, table namespace, count, and preview rows.
- *
- * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
- * Deepline keeps row progress, retries, memory use, and table output under
- * runtime control. Use `count()` and `peek()` for bounded inspection. Use
- * `materialize(limit)` or async iteration only when the dataset is intentionally
- * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
- *
- * @sdkReference runtime 190
- */
-interface PlayDataset<T> extends AsyncIterable<T> {
-    readonly [PLAY_DATASET_BRAND]: true;
-    /** Dataset kind. */
-    readonly datasetKind: PlayDatasetKind;
-    /** Dataset id. */
-    readonly datasetId: string;
-    /** Backing store info. */
-    readonly backing?: PlayDatasetBacking;
-    /** Display label. */
-    readonly sourceLabel?: string | null;
-    /** Runtime table name. */
-    readonly tableNamespace?: string | null;
-    /** Row count. */
-    count(): Promise<number>;
-    /** Preview rows. */
-    peek(limit?: number): Promise<T[]>;
-    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
-    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    /**
-     * Explicit escape hatch for bounded result sets.
-     * Large datasets should flow by handle through Neon-backed storage, not
-     * through worker memory as giant arrays.
-     */
-    materialize(limit?: number): Promise<T[]>;
-    toJSON(): {
-        kind: 'dataset';
-        datasetKind: PlayDatasetKind;
-        datasetId: string;
-        count: number;
-        backing?: PlayDatasetBacking;
-        sourceLabel?: string | null;
-        tableNamespace?: string | null;
-        columns?: string[];
-        _metadata?: {
-            workProgress?: PlayDatasetWorkProgressSummary;
-        };
-        preview: T[];
-    };
-}
-
 type EmailStatusVerdict = 'send' | 'send_with_caution' | 'verify_next' | 'hold' | 'drop';
 type EmailStatusValue = 'valid' | 'invalid' | 'catch_all' | 'valid_catch_all' | 'unknown' | 'do_not_mail' | 'spamtrap' | 'abuse' | 'disposable';
 type EmailDeliverability = 'high' | 'medium' | 'low' | 'unknown';
@@ -2503,7 +2457,7 @@ declare const DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS: {
 };
 type DeeplineExtractorTarget = keyof typeof DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS;
 declare const DEEPLINE_EXTRACTOR_TARGETS: DeeplineExtractorTarget[];
-type DeeplineEmailStatusGetterValue = EmailStatus | EmailStatusValue;
+type DeeplineEmailStatusGetterValue = EmailStatus;
 type DeeplineGetterValueMap = {
     id: string;
     name: string;
@@ -2528,7 +2482,7 @@ type DeeplineGetterValueMap = {
     status: string;
     job_change: JobChangeGetterValue;
     job_change_status: JobChangeStatus;
-    email_status: DeeplineEmailStatusGetterValue;
+    email_status: EmailStatus;
     phone_status: PhoneStatus;
 };
 type DeeplineGetterValue<TTarget extends DeeplineExtractorTarget = DeeplineExtractorTarget> = DeeplineGetterValueMap[TTarget];
@@ -2622,6 +2576,107 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
+interface PlayR2FileRef {
+    storageKind: 'r2';
+    storageKey: string;
+    logicalPath: string;
+    fileName: string;
+    contentHash: string;
+    contentType: string;
+    bytes: number;
+}
+type PlayExecutionFileRef = PlayR2FileRef;
+
+declare const PLAY_DATASET_BRAND: unique symbol;
+type PlayDatasetKind = 'csv' | 'map';
+type PlayDatasetBacking = {
+    storage: 'neon_sheet';
+    sheet: {
+        playName: string;
+        tableNamespace: string;
+    };
+} | {
+    storage: 'r2_file';
+    file: PlayExecutionFileRef;
+};
+type PlayDatasetWorkProgressSummary = {
+    total: number;
+    executed: number;
+    reused: number;
+    skipped: number;
+    pending: number;
+    failed: number;
+    degraded?: boolean;
+    duplicates?: {
+        exact?: number;
+        semantic?: number;
+        rejected?: number;
+    };
+};
+type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
+type PlayDatasetTransformOptions = {
+    key?: string;
+    sourceLabel?: string | null;
+};
+/**
+ * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
+ *
+ * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
+ * rows, usually backed by persisted sheet storage, and carries metadata such as
+ * dataset kind, dataset id, table namespace, count, and preview rows.
+ *
+ * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
+ * Deepline keeps row progress, retries, memory use, and table output under
+ * runtime control. Use `count()` and `peek()` for bounded inspection. Use
+ * `materialize(limit)` or async iteration only when the dataset is intentionally
+ * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
+ * `.toArray()`, or other array aliases; those hide the runtime cost of loading
+ * persisted rows into memory.
+ *
+ * @sdkReference runtime 190
+ */
+interface PlayDataset<T> extends AsyncIterable<T> {
+    readonly [PLAY_DATASET_BRAND]: true;
+    /** Dataset kind. */
+    readonly datasetKind: PlayDatasetKind;
+    /** Dataset id. */
+    readonly datasetId: string;
+    /** Backing store info. */
+    readonly backing?: PlayDatasetBacking;
+    /** Display label. */
+    readonly sourceLabel?: string | null;
+    /** Runtime table name. */
+    readonly tableNamespace?: string | null;
+    /** Row count. */
+    count(): Promise<number>;
+    /** Preview rows. */
+    peek(limit?: number): Promise<T[]>;
+    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
+    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    /**
+     * Explicit escape hatch for bounded result sets.
+     * Large datasets should flow by handle through Neon-backed storage, not
+     * through worker memory as giant arrays.
+     */
+    materialize(limit?: number): Promise<T[]>;
+    toJSON(): {
+        kind: 'dataset';
+        datasetKind: PlayDatasetKind;
+        datasetId: string;
+        count: number;
+        backing?: PlayDatasetBacking;
+        sourceLabel?: string | null;
+        tableNamespace?: string | null;
+        columns?: string[];
+        _metadata?: {
+            workProgress?: PlayDatasetWorkProgressSummary;
+        };
+        preview: T[];
+    };
+}
+
 /**
  * Previous durable cell value passed to object-column resolvers.
  *

package/dist/index.d.ts

@@ -1194,6 +1194,10 @@ type EnrichStepCommand = {
     alias: string;
     tool: string;
     operation?: string;
+    play?: {
+        ref: string;
+        mode?: 'scalar';
+    };
     payload: Record<string, unknown>;
     extract_js?: string;
     run_if_js?: string;
@@ -1638,6 +1642,7 @@ declare class DeeplineClient {
     compileEnrichPlan(input: {
         plan_args?: string[];
         config?: unknown;
+        native_play_materialization?: 'macro' | 'inline_prebuilt';
     }): Promise<{
         config: EnrichCompiledConfig;
     }>;
@@ -1812,6 +1817,56 @@ declare class DeeplineClient {
      * ```
      */
     listPlayRuns(playName: string): Promise<PlayRunListItem[]>;
+    /** List the org's workflows. `GET /api/v2/workflows`. */
+    listWorkflows(options?: {
+        limit?: number;
+    }): Promise<{
+        workflows: Array<{
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+        }>;
+    }>;
+    /**
+     * Fetch a single workflow (including its published-revision config — the
+     * input to `compileWorkflowConfigToPlay`). `GET /api/v2/workflows/:id`.
+     */
+    getWorkflow(id: string): Promise<{
+        workflow: {
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+            current_published_revision: {
+                version: number;
+                config: unknown;
+            } | null;
+        } | null;
+        validation?: unknown;
+    }>;
+    /** Delete a workflow. `DELETE /api/v2/workflows/:id`. */
+    deleteWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow off. `POST /api/v2/workflows/:id/disable`. */
+    disableWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow back on. `POST /api/v2/workflows/:id/enable`. */
+    enableWorkflow(id: string): Promise<unknown>;
+    /** Create/update a workflow from config. `POST /api/v2/workflows/apply`. */
+    applyWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Validate a workflow config without saving. `POST /api/v2/workflows/lint`. */
+    lintWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Fetch live workflow request schemas. `GET /api/v2/workflows/schema`. */
+    getWorkflowSchema(subject?: string): Promise<unknown>;
+    /** Queue a workflow run. `POST /api/v2/workflows/call`. */
+    callWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** List a workflow's runs. `GET /api/v2/workflows/:id/runs`. */
+    listWorkflowRuns(id: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    /** Fetch one workflow run. `GET /api/v2/workflows/:id/runs/:runId`. */
+    getWorkflowRun(id: string, runId: string): Promise<unknown>;
+    /** Cancel a workflow run. `POST /api/v2/workflows/:id/runs/:runId/cancel`. */
+    cancelWorkflowRun(id: string, runId: string): Promise<unknown>;
     /**
      * Get a run by id using the public runs resource model.
      *
@@ -2226,107 +2281,6 @@ declare const PROD_URL = "https://code.deepline.com";
  */
 declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
 
-interface PlayR2FileRef {
-    storageKind: 'r2';
-    storageKey: string;
-    logicalPath: string;
-    fileName: string;
-    contentHash: string;
-    contentType: string;
-    bytes: number;
-}
-type PlayExecutionFileRef = PlayR2FileRef;
-
-declare const PLAY_DATASET_BRAND: unique symbol;
-type PlayDatasetKind = 'csv' | 'map';
-type PlayDatasetBacking = {
-    storage: 'neon_sheet';
-    sheet: {
-        playName: string;
-        tableNamespace: string;
-    };
-} | {
-    storage: 'r2_file';
-    file: PlayExecutionFileRef;
-};
-type PlayDatasetWorkProgressSummary = {
-    total: number;
-    executed: number;
-    reused: number;
-    skipped: number;
-    pending: number;
-    failed: number;
-    degraded?: boolean;
-    duplicates?: {
-        exact?: number;
-        semantic?: number;
-        rejected?: number;
-    };
-};
-type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
-type PlayDatasetTransformOptions = {
-    key?: string;
-    sourceLabel?: string | null;
-};
-/**
- * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
- *
- * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
- * rows, usually backed by persisted sheet storage, and carries metadata such as
- * dataset kind, dataset id, table namespace, count, and preview rows.
- *
- * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
- * Deepline keeps row progress, retries, memory use, and table output under
- * runtime control. Use `count()` and `peek()` for bounded inspection. Use
- * `materialize(limit)` or async iteration only when the dataset is intentionally
- * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
- *
- * @sdkReference runtime 190
- */
-interface PlayDataset<T> extends AsyncIterable<T> {
-    readonly [PLAY_DATASET_BRAND]: true;
-    /** Dataset kind. */
-    readonly datasetKind: PlayDatasetKind;
-    /** Dataset id. */
-    readonly datasetId: string;
-    /** Backing store info. */
-    readonly backing?: PlayDatasetBacking;
-    /** Display label. */
-    readonly sourceLabel?: string | null;
-    /** Runtime table name. */
-    readonly tableNamespace?: string | null;
-    /** Row count. */
-    count(): Promise<number>;
-    /** Preview rows. */
-    peek(limit?: number): Promise<T[]>;
-    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
-    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    /**
-     * Explicit escape hatch for bounded result sets.
-     * Large datasets should flow by handle through Neon-backed storage, not
-     * through worker memory as giant arrays.
-     */
-    materialize(limit?: number): Promise<T[]>;
-    toJSON(): {
-        kind: 'dataset';
-        datasetKind: PlayDatasetKind;
-        datasetId: string;
-        count: number;
-        backing?: PlayDatasetBacking;
-        sourceLabel?: string | null;
-        tableNamespace?: string | null;
-        columns?: string[];
-        _metadata?: {
-            workProgress?: PlayDatasetWorkProgressSummary;
-        };
-        preview: T[];
-    };
-}
-
 type EmailStatusVerdict = 'send' | 'send_with_caution' | 'verify_next' | 'hold' | 'drop';
 type EmailStatusValue = 'valid' | 'invalid' | 'catch_all' | 'valid_catch_all' | 'unknown' | 'do_not_mail' | 'spamtrap' | 'abuse' | 'disposable';
 type EmailDeliverability = 'high' | 'medium' | 'low' | 'unknown';
@@ -2503,7 +2457,7 @@ declare const DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS: {
 };
 type DeeplineExtractorTarget = keyof typeof DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS;
 declare const DEEPLINE_EXTRACTOR_TARGETS: DeeplineExtractorTarget[];
-type DeeplineEmailStatusGetterValue = EmailStatus | EmailStatusValue;
+type DeeplineEmailStatusGetterValue = EmailStatus;
 type DeeplineGetterValueMap = {
     id: string;
     name: string;
@@ -2528,7 +2482,7 @@ type DeeplineGetterValueMap = {
     status: string;
     job_change: JobChangeGetterValue;
     job_change_status: JobChangeStatus;
-    email_status: DeeplineEmailStatusGetterValue;
+    email_status: EmailStatus;
     phone_status: PhoneStatus;
 };
 type DeeplineGetterValue<TTarget extends DeeplineExtractorTarget = DeeplineExtractorTarget> = DeeplineGetterValueMap[TTarget];
@@ -2622,6 +2576,107 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
+interface PlayR2FileRef {
+    storageKind: 'r2';
+    storageKey: string;
+    logicalPath: string;
+    fileName: string;
+    contentHash: string;
+    contentType: string;
+    bytes: number;
+}
+type PlayExecutionFileRef = PlayR2FileRef;
+
+declare const PLAY_DATASET_BRAND: unique symbol;
+type PlayDatasetKind = 'csv' | 'map';
+type PlayDatasetBacking = {
+    storage: 'neon_sheet';
+    sheet: {
+        playName: string;
+        tableNamespace: string;
+    };
+} | {
+    storage: 'r2_file';
+    file: PlayExecutionFileRef;
+};
+type PlayDatasetWorkProgressSummary = {
+    total: number;
+    executed: number;
+    reused: number;
+    skipped: number;
+    pending: number;
+    failed: number;
+    degraded?: boolean;
+    duplicates?: {
+        exact?: number;
+        semantic?: number;
+        rejected?: number;
+    };
+};
+type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
+type PlayDatasetTransformOptions = {
+    key?: string;
+    sourceLabel?: string | null;
+};
+/**
+ * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
+ *
+ * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
+ * rows, usually backed by persisted sheet storage, and carries metadata such as
+ * dataset kind, dataset id, table namespace, count, and preview rows.
+ *
+ * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
+ * Deepline keeps row progress, retries, memory use, and table output under
+ * runtime control. Use `count()` and `peek()` for bounded inspection. Use
+ * `materialize(limit)` or async iteration only when the dataset is intentionally
+ * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
+ * `.toArray()`, or other array aliases; those hide the runtime cost of loading
+ * persisted rows into memory.
+ *
+ * @sdkReference runtime 190
+ */
+interface PlayDataset<T> extends AsyncIterable<T> {
+    readonly [PLAY_DATASET_BRAND]: true;
+    /** Dataset kind. */
+    readonly datasetKind: PlayDatasetKind;
+    /** Dataset id. */
+    readonly datasetId: string;
+    /** Backing store info. */
+    readonly backing?: PlayDatasetBacking;
+    /** Display label. */
+    readonly sourceLabel?: string | null;
+    /** Runtime table name. */
+    readonly tableNamespace?: string | null;
+    /** Row count. */
+    count(): Promise<number>;
+    /** Preview rows. */
+    peek(limit?: number): Promise<T[]>;
+    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
+    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    /**
+     * Explicit escape hatch for bounded result sets.
+     * Large datasets should flow by handle through Neon-backed storage, not
+     * through worker memory as giant arrays.
+     */
+    materialize(limit?: number): Promise<T[]>;
+    toJSON(): {
+        kind: 'dataset';
+        datasetKind: PlayDatasetKind;
+        datasetId: string;
+        count: number;
+        backing?: PlayDatasetBacking;
+        sourceLabel?: string | null;
+        tableNamespace?: string | null;
+        columns?: string[];
+        _metadata?: {
+            workProgress?: PlayDatasetWorkProgressSummary;
+        };
+        preview: T[];
+    };
+}
+
 /**
  * Previous durable cell value passed to object-column resolvers.
  *