deepline 0.1.210 → 0.1.212

package/dist/index.d.mts

@@ -431,6 +431,16 @@ type PlayRunActionPackage = {
     runId: string;
     datasetPath: string;
     format: 'csv';
+} | {
+    kind: 'deepline_run_logs';
+    runId: string;
+    view: 'failed' | 'tail';
+    limit: number;
+    command: string;
+    api: {
+        method: 'GET';
+        path: string;
+    };
 };
 /**
  * Compact canonical package for an inspected play run.
@@ -460,11 +470,30 @@ interface PlayRunPackage {
     steps: Array<Record<string, unknown>>;
     /** Named output summaries, including dataset handles and scalar outputs. */
     outputs: Record<string, Record<string, unknown>>;
+    /** Every durable Dataset Handle explicitly registered by this run. */
+    datasets?: Array<{
+        kind: 'dataset';
+        datasetId?: string;
+        path: string;
+        tableNamespace?: string;
+        rowCount?: number;
+        recovered?: true;
+        preview?: Record<string, unknown>;
+        actions?: Record<string, PlayRunActionPackage>;
+    }>;
+    /** Small retained tail of customer and runtime logs; fetch the full stream through `runs.logs`. */
+    logs?: {
+        tail: string[];
+        totalCount: number;
+        returnedCount: number;
+        truncated?: boolean;
+    };
     /** Follow-up actions a caller can perform against the run. */
     next?: {
         inspect?: PlayRunActionPackage;
         export?: PlayRunActionPackage;
         query?: PlayRunActionPackage;
+        logs?: PlayRunActionPackage;
     };
 }
 /**
@@ -490,6 +519,8 @@ interface PlayStatus {
     apiVersion?: number;
     /** Saved play name for this run, when available. */
     name?: string;
+    /** Exact saved revision launched for this run, when applicable. */
+    revisionId?: string;
     /** Alias for `name` used by run/result APIs. */
     playName?: string;
     /** Dashboard URL for inspecting the play and its run output in the app. */
@@ -524,6 +555,26 @@ interface PlayStatus {
     } | null;
     /** Structured follow-up actions for inspect/query/export. */
     next?: PlayRunPackage['next'] | Record<string, unknown>;
+    /** Bounded terminal-failure log window requested by `runs.get`. */
+    failedLogs?: {
+        runId: string;
+        totalCount: number;
+        returnedCount: number;
+        firstSequence: number | null;
+        lastSequence: number | null;
+        truncated: boolean;
+        hasMore: boolean;
+        entries: string[];
+        view?: 'failed';
+        association?: 'terminal_failure_window' | 'retained_before_truncation';
+        warning?: string;
+        next?: {
+            logs: string;
+        };
+        logsTruncated?: boolean;
+    };
+    /** Exact ordinary `plays run` command that can rerun a failed execution. */
+    rerunCommand?: string;
 }
 type LiveEventScope = 'play' | 'agent';
 interface LiveEventEnvelope<TPayload = unknown> {
@@ -1143,6 +1194,13 @@ type EnrichStepCommand = {
     play?: {
         ref: string;
         mode?: 'scalar';
+        execution?: 'child' | 'inline';
+        inline?: {
+            exportName: string;
+            functionExpressionSource: string;
+            sourceHash: string;
+            typeImports: string[];
+        };
     };
     payload: Record<string, unknown>;
     extract_js?: string;
@@ -1210,9 +1268,20 @@ type RunsListOptions = {
     status?: string;
     limit?: number;
 };
+/** Options for `client.runs.get(...)`. */
+type RunsGetOptions = {
+    /** Return the raw status payload instead of the compact package. */
+    full?: boolean;
+    /** Attach a bounded end-of-stream window for a failed run. */
+    failedLogs?: boolean;
+    /** Requested failed-log lines to attach (default 20, hard-capped at 20). */
+    failedLogLimit?: number;
+};
 /** Streaming options for `client.runs.tail(...)`. */
 type RunsTailOptions = {
     signal?: AbortSignal;
+    /** Observe each canonical live event while `tail` waits for terminal state. */
+    onEvent?: (event: PlayLiveEvent) => void;
     /**
      * Called before each stream reconnect. Server stream windows are finite, so
      * long runs reconnect with backoff until a terminal status is observed.
@@ -1235,6 +1304,8 @@ type RunsLogsOptions = {
     limit?: number;
     /** Fetch every stored log line, paginating to the full totalCount. */
     all?: boolean;
+    /** Select the bounded failure view; truncated runs degrade explicitly. */
+    failed?: boolean;
 };
 /** Persisted log response for one play run. */
 type RunsLogsResult = {
@@ -1246,6 +1317,16 @@ type RunsLogsResult = {
     truncated: boolean;
     hasMore: boolean;
     entries: string[];
+    /** Selected public log view. */
+    view?: 'tail' | 'failed' | 'all';
+    /** Whether entries are terminal context or the last pre-truncation lines. */
+    association?: 'terminal_failure_window' | 'retained_before_truncation';
+    /** Loud explanation when the terminal failure window was not retained. */
+    warning?: string;
+    /** Exact follow-up command when the selected view is degraded. */
+    next?: {
+        logs: string;
+    };
     /**
      * True when the run crossed the Run Log Stream retention cap: `totalCount`
      * keeps counting, but stored line bodies end at a loud truncation marker.
@@ -1300,9 +1381,7 @@ type PlaySecretMetadata = {
  */
 type RunsNamespace = {
     /** Get current run status by public run id. */
-    get: (runId: string, options?: {
-        full?: boolean;
-    }) => Promise<PlayStatus>;
+    get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
     /** List runs for one play, optionally filtered by status. */
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     /** Stream run events and return the latest/terminal run status. */
@@ -2083,9 +2162,7 @@ declare class DeeplineClient {
      * deepline runs get <run-id> --json
      * ```
      */
-    getRunStatus(runId: string, options?: {
-        full?: boolean;
-    }): Promise<PlayStatus>;
+    getRunStatus(runId: string, options?: RunsGetOptions): Promise<PlayStatus>;
     /**
      * List play runs using the public runs resource model.
      *
@@ -2850,7 +2927,7 @@ interface PlayDataset<T> extends AsyncIterable<T> {
      * Large datasets should flow by handle through Neon-backed storage, not
      * through worker memory as giant arrays.
      */
-    materialize(limit?: number): Promise<T[]>;
+    materialize(options?: number | PlayDatasetMaterializeOptions): Promise<T[]>;
     toJSON(): {
         kind: 'dataset';
         datasetKind: PlayDatasetKind;
@@ -2866,6 +2943,13 @@ interface PlayDataset<T> extends AsyncIterable<T> {
         preview: T[];
     };
 }
+type PlayDatasetMaterializeScope = 'result' | 'full_persisted_dataset';
+type PlayDatasetMaterializeOptions = {
+    /** Rows returned by this operation, or every current row in its persisted dataset. */
+    scope?: PlayDatasetMaterializeScope;
+    /** Maximum number of rows to load into memory. */
+    limit?: number;
+};
 
 type ToolResultExecutionMetadata = {
     idempotent: true;
@@ -3038,6 +3122,8 @@ type PlayBindings = {
      * older clients can continue to register revisions during the migration.
      */
     description?: string;
+    /** Allow compilers to bundle this named handler directly without a child run. */
+    inline?: boolean;
     /** Optional per-run billing controls enforced by the runtime. */
     billing?: {
         /** Stop the run before a billed action would push total run credits above this cap. */

package/dist/index.d.ts

@@ -431,6 +431,16 @@ type PlayRunActionPackage = {
     runId: string;
     datasetPath: string;
     format: 'csv';
+} | {
+    kind: 'deepline_run_logs';
+    runId: string;
+    view: 'failed' | 'tail';
+    limit: number;
+    command: string;
+    api: {
+        method: 'GET';
+        path: string;
+    };
 };
 /**
  * Compact canonical package for an inspected play run.
@@ -460,11 +470,30 @@ interface PlayRunPackage {
     steps: Array<Record<string, unknown>>;
     /** Named output summaries, including dataset handles and scalar outputs. */
     outputs: Record<string, Record<string, unknown>>;
+    /** Every durable Dataset Handle explicitly registered by this run. */
+    datasets?: Array<{
+        kind: 'dataset';
+        datasetId?: string;
+        path: string;
+        tableNamespace?: string;
+        rowCount?: number;
+        recovered?: true;
+        preview?: Record<string, unknown>;
+        actions?: Record<string, PlayRunActionPackage>;
+    }>;
+    /** Small retained tail of customer and runtime logs; fetch the full stream through `runs.logs`. */
+    logs?: {
+        tail: string[];
+        totalCount: number;
+        returnedCount: number;
+        truncated?: boolean;
+    };
     /** Follow-up actions a caller can perform against the run. */
     next?: {
         inspect?: PlayRunActionPackage;
         export?: PlayRunActionPackage;
         query?: PlayRunActionPackage;
+        logs?: PlayRunActionPackage;
     };
 }
 /**
@@ -490,6 +519,8 @@ interface PlayStatus {
     apiVersion?: number;
     /** Saved play name for this run, when available. */
     name?: string;
+    /** Exact saved revision launched for this run, when applicable. */
+    revisionId?: string;
     /** Alias for `name` used by run/result APIs. */
     playName?: string;
     /** Dashboard URL for inspecting the play and its run output in the app. */
@@ -524,6 +555,26 @@ interface PlayStatus {
     } | null;
     /** Structured follow-up actions for inspect/query/export. */
     next?: PlayRunPackage['next'] | Record<string, unknown>;
+    /** Bounded terminal-failure log window requested by `runs.get`. */
+    failedLogs?: {
+        runId: string;
+        totalCount: number;
+        returnedCount: number;
+        firstSequence: number | null;
+        lastSequence: number | null;
+        truncated: boolean;
+        hasMore: boolean;
+        entries: string[];
+        view?: 'failed';
+        association?: 'terminal_failure_window' | 'retained_before_truncation';
+        warning?: string;
+        next?: {
+            logs: string;
+        };
+        logsTruncated?: boolean;
+    };
+    /** Exact ordinary `plays run` command that can rerun a failed execution. */
+    rerunCommand?: string;
 }
 type LiveEventScope = 'play' | 'agent';
 interface LiveEventEnvelope<TPayload = unknown> {
@@ -1143,6 +1194,13 @@ type EnrichStepCommand = {
     play?: {
         ref: string;
         mode?: 'scalar';
+        execution?: 'child' | 'inline';
+        inline?: {
+            exportName: string;
+            functionExpressionSource: string;
+            sourceHash: string;
+            typeImports: string[];
+        };
     };
     payload: Record<string, unknown>;
     extract_js?: string;
@@ -1210,9 +1268,20 @@ type RunsListOptions = {
     status?: string;
     limit?: number;
 };
+/** Options for `client.runs.get(...)`. */
+type RunsGetOptions = {
+    /** Return the raw status payload instead of the compact package. */
+    full?: boolean;
+    /** Attach a bounded end-of-stream window for a failed run. */
+    failedLogs?: boolean;
+    /** Requested failed-log lines to attach (default 20, hard-capped at 20). */
+    failedLogLimit?: number;
+};
 /** Streaming options for `client.runs.tail(...)`. */
 type RunsTailOptions = {
     signal?: AbortSignal;
+    /** Observe each canonical live event while `tail` waits for terminal state. */
+    onEvent?: (event: PlayLiveEvent) => void;
     /**
      * Called before each stream reconnect. Server stream windows are finite, so
      * long runs reconnect with backoff until a terminal status is observed.
@@ -1235,6 +1304,8 @@ type RunsLogsOptions = {
     limit?: number;
     /** Fetch every stored log line, paginating to the full totalCount. */
     all?: boolean;
+    /** Select the bounded failure view; truncated runs degrade explicitly. */
+    failed?: boolean;
 };
 /** Persisted log response for one play run. */
 type RunsLogsResult = {
@@ -1246,6 +1317,16 @@ type RunsLogsResult = {
     truncated: boolean;
     hasMore: boolean;
     entries: string[];
+    /** Selected public log view. */
+    view?: 'tail' | 'failed' | 'all';
+    /** Whether entries are terminal context or the last pre-truncation lines. */
+    association?: 'terminal_failure_window' | 'retained_before_truncation';
+    /** Loud explanation when the terminal failure window was not retained. */
+    warning?: string;
+    /** Exact follow-up command when the selected view is degraded. */
+    next?: {
+        logs: string;
+    };
     /**
      * True when the run crossed the Run Log Stream retention cap: `totalCount`
      * keeps counting, but stored line bodies end at a loud truncation marker.
@@ -1300,9 +1381,7 @@ type PlaySecretMetadata = {
  */
 type RunsNamespace = {
     /** Get current run status by public run id. */
-    get: (runId: string, options?: {
-        full?: boolean;
-    }) => Promise<PlayStatus>;
+    get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
     /** List runs for one play, optionally filtered by status. */
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     /** Stream run events and return the latest/terminal run status. */
@@ -2083,9 +2162,7 @@ declare class DeeplineClient {
      * deepline runs get <run-id> --json
      * ```
      */
-    getRunStatus(runId: string, options?: {
-        full?: boolean;
-    }): Promise<PlayStatus>;
+    getRunStatus(runId: string, options?: RunsGetOptions): Promise<PlayStatus>;
     /**
      * List play runs using the public runs resource model.
      *
@@ -2850,7 +2927,7 @@ interface PlayDataset<T> extends AsyncIterable<T> {
      * Large datasets should flow by handle through Neon-backed storage, not
      * through worker memory as giant arrays.
      */
-    materialize(limit?: number): Promise<T[]>;
+    materialize(options?: number | PlayDatasetMaterializeOptions): Promise<T[]>;
     toJSON(): {
         kind: 'dataset';
         datasetKind: PlayDatasetKind;
@@ -2866,6 +2943,13 @@ interface PlayDataset<T> extends AsyncIterable<T> {
         preview: T[];
     };
 }
+type PlayDatasetMaterializeScope = 'result' | 'full_persisted_dataset';
+type PlayDatasetMaterializeOptions = {
+    /** Rows returned by this operation, or every current row in its persisted dataset. */
+    scope?: PlayDatasetMaterializeScope;
+    /** Maximum number of rows to load into memory. */
+    limit?: number;
+};
 
 type ToolResultExecutionMetadata = {
     idempotent: true;
@@ -3038,6 +3122,8 @@ type PlayBindings = {
      * older clients can continue to register revisions during the migration.
      */
     description?: string;
+    /** Allow compilers to bundle this named handler directly without a child run. */
+    inline?: boolean;
     /** Optional per-run billing controls enforced by the runtime. */
     billing?: {
         /** Stop the run before a billed action would push total run credits above this cap. */