deepline 0.3.328 → 0.3.329

package/dist/{client-wiWPZhnI.d.mts → client-D5XOQKsA.d.mts}

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
 import { z } from 'zod';
-import { g as PlayCompilerManifest, ai as ToolResultBilling } from './compiler-manifest-9TkZ_ykI.mjs';
+import { g as PlayCompilerManifest, aj as ToolResultBilling } from './compiler-manifest-82q4jtfQ.mjs';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 
 declare const playPathSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
@@ -1472,6 +1472,25 @@ interface ToolPricingSummary {
     summary: string | null;
     /** Additional user-facing pricing notes. */
     details: string[];
+    /** Estimated prices for listed single-unit configurations, not a charge ceiling. */
+    estimatedRange?: {
+        minCreditsPerUnit: number;
+        maxCreditsPerUnit: number;
+        scope: string;
+        configurations: {
+            name: string;
+            creditsPerUnit: number;
+        }[];
+    };
+    /** Historical customer charge, not a guaranteed rate or provider tariff. */
+    observedReference?: {
+        creditsPerCall: number;
+        usdPerCall: number | null;
+        source: 'observed';
+        observedAt: string;
+        sampleSize: number;
+        inputMode: string;
+    };
 }
 /** A discoverable provider, returned by {@link DeeplineClient.listProviders}. */
 interface ProviderDefinition {

package/dist/{client-DHq8dJ56.d.ts → client-l-IoLh8Z.d.ts}

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
 import { z } from 'zod';
-import { g as PlayCompilerManifest, ai as ToolResultBilling } from './compiler-manifest-9TkZ_ykI.js';
+import { g as PlayCompilerManifest, aj as ToolResultBilling } from './compiler-manifest-82q4jtfQ.js';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
 
 declare const playPathSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
@@ -1472,6 +1472,25 @@ interface ToolPricingSummary {
     summary: string | null;
     /** Additional user-facing pricing notes. */
     details: string[];
+    /** Estimated prices for listed single-unit configurations, not a charge ceiling. */
+    estimatedRange?: {
+        minCreditsPerUnit: number;
+        maxCreditsPerUnit: number;
+        scope: string;
+        configurations: {
+            name: string;
+            creditsPerUnit: number;
+        }[];
+    };
+    /** Historical customer charge, not a guaranteed rate or provider tariff. */
+    observedReference?: {
+        creditsPerCall: number;
+        usdPerCall: number | null;
+        source: 'observed';
+        observedAt: string;
+        sampleSize: number;
+        inputMode: string;
+    };
 }
 /** A discoverable provider, returned by {@link DeeplineClient.listProviders}. */
 interface ProviderDefinition {

package/dist/{compiler-manifest-9TkZ_ykI.d.mts → compiler-manifest-82q4jtfQ.d.mts}

@@ -615,6 +615,9 @@ interface PlayDataset<T> extends AsyncIterable<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.
+     * No argument loads the complete current handle within the memory cap or
+     * throws. A numeric limit loads only a prefix, not proof of completeness.
+     * Materializing a tool-result list does not fetch more provider pages.
      */
     materialize(options?: number | PlayDatasetMaterializeOptions): Promise<T[]>;
     toJSON(): {
@@ -696,8 +699,33 @@ type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
 };
 type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
     keys: Partial<Record<TKey, string>> & Record<string, string>;
+    /**
+     * Editions 1–9: dataset handle, not a JavaScript array. Edition 10 uses
+     * BasicToolResultListAccessor instead; its .get() returns an ordinary array.
+     * Pass it to ctx.dataset, use first() or async iteration, or await
+     * get().materialize() for the complete current list within the memory cap.
+     * materialize(n) and peek(n) return a prefix; none fetch provider pages.
+     */
     get(): PlayDataset<T>;
 };
+/** Edition-10 getter: ordinary data, not a dataset or a promise. */
+type BasicToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListAccessor<T, TKey>, 'get'> & {
+    /** Complete resident response list. Throws for a lazy or incomplete list. */
+    get(): T[];
+};
+type BasicToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> = Omit<ToolExecuteResultBase<TResult, TMeta>, 'extractedLists'> & {
+    extractedLists: Record<string, BasicToolResultListAccessor>;
+};
+type BasicToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {
+    extractedValues: {
+        [K in keyof TExtracted]: ToolResultTargetAccessor<TExtracted[K]>;
+    };
+    extractedLists: {
+        [K in keyof TLists]: BasicToolResultListAccessor<TLists[K]>;
+    };
+};
+/** Public source-SDK result for new Plays; receipts retain the canonical form. */
+type BasicToolExecuteResult<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>>> = BasicToolExecuteResultBase<TResult, TMeta> & BasicToolExecuteResultAccessors<TExtracted, TLists>;
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
     /** @deprecated Use declared getters or toolResponse.rawV2. */
     raw: TData;
@@ -746,23 +774,22 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
 /**
  * Canonical result returned by Deepline tool execution.
  *
- * The top-level object is Deepline-owned execution metadata and semantic
- * extraction state. The canonical provider response lives under
- * `toolResponse.rawV2`. Response metadata lives under `toolResponse.meta`. Semantic single-value
- * getters live under `extractedValues.<name>.get()`, and list getters live
- * under `extractedLists.<name>.get()`.
+ * Provider data: `toolResponse.rawV2`; metadata: `toolResponse.meta`.
+ * Single-value getters: `extractedValues.<name>.get()`; lists: `extractedLists.<name>.get()`.
  *
- * Use extractors first when a tool contract exposes them. Use list getters for
- * row-shaped data. Use `toolResponse.rawV2` for provider-specific fields or
- * debugging. Inspect the observed response before selecting a nested field;
- * provider envelopes are preserved, including pagination and sibling resources.
- * This is parsed, scrubbed data, not the original HTTP bytes or headers.
+ * Prefer declared getters. New Plays (edition 10) receive ordinary arrays from
+ * list `.get()` synchronously; persist explicitly with ctx.dataset. Lazy or
+ * incomplete lists throw: use readList(result, path) for explicit dataset access.
+ * Provider pagination requires a separate request; getters never fetch it.
+ * Historical editions 1–9 retain PlayDataset getters and async materialize/peek;
+ * missing getters never mean empty results. Inspect rawV2 for debugging: parsed,
+ * scrubbed envelopes, pagination and siblings, not HTTP bytes or headers.
  *
  * @sdkReference runtime 200
  */
 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>;
 
-declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9];
+declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 type PlaySqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
 type PlayStandardWebhookHeaderFamily = 'standard' | 'svix';
@@ -1235,7 +1262,7 @@ type PlayAuthoringRunScope = {
     readonly id: string;
 };
 /** The complete customer-authored `ctx` Interface shared by every Adapter. */
-interface PlayAuthoringRuntimeContext {
+interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' = 'dataset'> {
     /**
      * Load a staged CSV file as a durable dataset handle.
      * @sdkReference runtime 040 ctx.csv(path, options)
@@ -1245,7 +1272,7 @@ interface PlayAuthoringRuntimeContext {
      * Create a persisted row dataset and define durable output columns.
      * @sdkReference runtime 060 ctx.dataset(key, items)
      */
-    dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext>;
+    dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext<TListGetter>>;
     /** @deprecated `ctx.map(...)` was replaced by `ctx.dataset(...)`. */
     map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: PlayAuthoringDatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;
     /**
@@ -1258,7 +1285,7 @@ interface PlayAuthoringRuntimeContext {
          * Execute a provider tool through the terminal-result cache contract.
          * @sdkReference runtime 150 ctx.tools.execute(request)
          */
-        execute<TOutput = PlayLooseObject>(request: PlayToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = PlayLooseObject>(request: PlayToolExecutionRequest): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     };
     customerDb: {
         query<TRow extends object = Record<string, unknown>>(statement: PlaySqlQuery | string, options?: PlayAuthoringCustomerDbQueryOptions): Promise<TRow[]>;
@@ -1266,12 +1293,12 @@ interface PlayAuthoringRuntimeContext {
     /** Shorthand for one managed tool call. */
     tool<TOutput = PlayLooseObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
         description?: string;
-    }): Promise<ToolExecuteResult<TOutput>>;
+    }): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     /**
      * Execute one reusable step program against a scalar input.
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: PlayAuthoringRunnableStepProgram<TOutput, PlayAuthoringRuntimeContext> & {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: PlayAuthoringRunnableStepProgram<TOutput, PlayAuthoringRuntimeContext<TListGetter>> & {
         readonly __inputType?: (input: TInput) => void;
     }, input: TInput, options?: PlayAuthoringRunStepsOptions): Promise<TOutput>;
     /**
@@ -3283,4 +3310,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { type DeeplineGetterValue as $, type AsyncPlayRunRef as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, type PlayAuthoringInputContract as D, type PlayRunId as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, PLAY_ARTIFACT_KINDS as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DeeplineError as S, type ToolExecuteResult as T, ToolExecutionError as U, type ToolExecutionErrorOptions as V, CtxFetchHttpError as W, DEEPLINE_EXTRACTOR_TARGETS as X, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as Y, type DeeplineEmailStatusGetterValue as Z, type DeeplineExtractorTarget as _, type PlayArtifactCompatibility as a, type DeeplineGetterValueMap as a0, JOB_CHANGE_STATUS_VALUES as a1, type JobChangeStatus as a2, PHONE_STATUS_VALUES as a3, type PhoneStatus as a4, type PlayDataset as a5, type PlayDatasetInput as a6, type PreviousCell as a7, ProviderTransientError as a8, type ProviderTransientErrorCategory as a9, type ProviderUnavailableError as aa, type ProviderUnavailableReason as ab, type ToolExecutionErrorCategory as ac, type ToolExecutionErrorOrigin as ad, type ToolExecutionFailureV1 as ae, type ToolExecutionNetworkKind as af, type ToolExecutionNetworkScope as ag, type ToolExecutionPublicDetails as ah, type ToolResultBilling as ai, getProviderUnavailableReason as aj, isDeeplineExtractorTarget as ak, isProviderUnavailable as al, isProviderWaterfallUnavailableError as am, type PlayBundleArtifact as b, type PlayImportPolicy as c, type PlayPackageImport as d, type PlayRuntimeFeature as e, type PlaySandboxRuntimeDeclaration as f, type PlayCompilerManifest as g, type PlayArtifactKind as h, type PlayAuthoringColumnMap as i, type PlayAuthoringColumnResolver as j, type PlayAuthoringRuntimeContext as k, type PlayAuthoringConditionalStepResolver as l, type PlayAuthoringCsvInput as m, type PlayAuthoringCsvOptions as n, type PlayAuthoringDatasetBuilder as o, type PlayAuthoringDatasetColumnDefinition as p, type PlayAuthoringDatasetColumnRunInput as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringAsyncCallOptions as x, type PlayAuthoringBindings as y, type PlayAuthoringCallExecution as z };
+export { type DeeplineEmailStatusGetterValue as $, type AsyncPlayRunRef as A, type BasicToolExecuteResult as B, type PlayAuthoringCallExecution as C, type PlayAuthoringCallOptions as D, type PlayAuthoringFetchResponse as E, type PlayAuthoringInputContract as F, type PlayRunId as G, type PlayAuthoringStepProgramStep as H, type PlayAuthoringRuntimeStepOptions as I, type PlaySqlListenerDeclaration as J, type PlaySqlListenerEvent as K, type PlaySqlListenerOperation as L, type PlaySqlQuery as M, type PlayAuthoringStepOptions as N, type PlayAuthoringStepProgram as O, PLAY_ARTIFACT_KINDS as P, type PlayAuthoringStepProgramResolver as Q, type PlayAuthoringStepResolver as R, type PlayToolExecutionRequest as S, type ToolExecuteResult as T, type PlayAuthoringStepProgramOptions as U, DeeplineError as V, ToolExecutionError as W, type ToolExecutionErrorOptions as X, CtxFetchHttpError as Y, DEEPLINE_EXTRACTOR_TARGETS as Z, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as _, type PlayArtifactCompatibility as a, type DeeplineExtractorTarget as a0, type DeeplineGetterValue as a1, type DeeplineGetterValueMap as a2, JOB_CHANGE_STATUS_VALUES as a3, type JobChangeStatus as a4, PHONE_STATUS_VALUES as a5, type PhoneStatus as a6, type PlayDatasetInput as a7, type PreviousCell as a8, ProviderTransientError as a9, type ProviderTransientErrorCategory as aa, type ProviderUnavailableError as ab, type ProviderUnavailableReason as ac, type ToolExecutionErrorCategory as ad, type ToolExecutionErrorOrigin as ae, type ToolExecutionFailureV1 as af, type ToolExecutionNetworkKind as ag, type ToolExecutionNetworkScope as ah, type ToolExecutionPublicDetails as ai, type ToolResultBilling as aj, getProviderUnavailableReason as ak, isDeeplineExtractorTarget as al, isProviderUnavailable as am, isProviderWaterfallUnavailableError as an, type PlayBundleArtifact as b, type PlayImportPolicy as c, type PlayPackageImport as d, type PlayRuntimeFeature as e, type PlaySandboxRuntimeDeclaration as f, type PlayCompilerManifest as g, type PlayArtifactKind as h, type PlayDataset as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type PlayAuthoringReferenceLike as s, type PlayReturnObject as t, type PlayAuthoringDefineConfig as u, type PlayAuthoringDefinedPlay as v, type PlayAuthoringFetchOptions as w, type PlayAuthoringFileInput as x, type PlayAuthoringAsyncCallOptions as y, type PlayAuthoringBindings as z };

package/dist/{compiler-manifest-9TkZ_ykI.d.ts → compiler-manifest-82q4jtfQ.d.ts}

@@ -615,6 +615,9 @@ interface PlayDataset<T> extends AsyncIterable<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.
+     * No argument loads the complete current handle within the memory cap or
+     * throws. A numeric limit loads only a prefix, not proof of completeness.
+     * Materializing a tool-result list does not fetch more provider pages.
      */
     materialize(options?: number | PlayDatasetMaterializeOptions): Promise<T[]>;
     toJSON(): {
@@ -696,8 +699,33 @@ type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
 };
 type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
     keys: Partial<Record<TKey, string>> & Record<string, string>;
+    /**
+     * Editions 1–9: dataset handle, not a JavaScript array. Edition 10 uses
+     * BasicToolResultListAccessor instead; its .get() returns an ordinary array.
+     * Pass it to ctx.dataset, use first() or async iteration, or await
+     * get().materialize() for the complete current list within the memory cap.
+     * materialize(n) and peek(n) return a prefix; none fetch provider pages.
+     */
     get(): PlayDataset<T>;
 };
+/** Edition-10 getter: ordinary data, not a dataset or a promise. */
+type BasicToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListAccessor<T, TKey>, 'get'> & {
+    /** Complete resident response list. Throws for a lazy or incomplete list. */
+    get(): T[];
+};
+type BasicToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> = Omit<ToolExecuteResultBase<TResult, TMeta>, 'extractedLists'> & {
+    extractedLists: Record<string, BasicToolResultListAccessor>;
+};
+type BasicToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {
+    extractedValues: {
+        [K in keyof TExtracted]: ToolResultTargetAccessor<TExtracted[K]>;
+    };
+    extractedLists: {
+        [K in keyof TLists]: BasicToolResultListAccessor<TLists[K]>;
+    };
+};
+/** Public source-SDK result for new Plays; receipts retain the canonical form. */
+type BasicToolExecuteResult<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>>> = BasicToolExecuteResultBase<TResult, TMeta> & BasicToolExecuteResultAccessors<TExtracted, TLists>;
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
     /** @deprecated Use declared getters or toolResponse.rawV2. */
     raw: TData;
@@ -746,23 +774,22 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
 /**
  * Canonical result returned by Deepline tool execution.
  *
- * The top-level object is Deepline-owned execution metadata and semantic
- * extraction state. The canonical provider response lives under
- * `toolResponse.rawV2`. Response metadata lives under `toolResponse.meta`. Semantic single-value
- * getters live under `extractedValues.<name>.get()`, and list getters live
- * under `extractedLists.<name>.get()`.
+ * Provider data: `toolResponse.rawV2`; metadata: `toolResponse.meta`.
+ * Single-value getters: `extractedValues.<name>.get()`; lists: `extractedLists.<name>.get()`.
  *
- * Use extractors first when a tool contract exposes them. Use list getters for
- * row-shaped data. Use `toolResponse.rawV2` for provider-specific fields or
- * debugging. Inspect the observed response before selecting a nested field;
- * provider envelopes are preserved, including pagination and sibling resources.
- * This is parsed, scrubbed data, not the original HTTP bytes or headers.
+ * Prefer declared getters. New Plays (edition 10) receive ordinary arrays from
+ * list `.get()` synchronously; persist explicitly with ctx.dataset. Lazy or
+ * incomplete lists throw: use readList(result, path) for explicit dataset access.
+ * Provider pagination requires a separate request; getters never fetch it.
+ * Historical editions 1–9 retain PlayDataset getters and async materialize/peek;
+ * missing getters never mean empty results. Inspect rawV2 for debugging: parsed,
+ * scrubbed envelopes, pagination and siblings, not HTTP bytes or headers.
  *
  * @sdkReference runtime 200
  */
 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>;
 
-declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9];
+declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 type PlaySqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
 type PlayStandardWebhookHeaderFamily = 'standard' | 'svix';
@@ -1235,7 +1262,7 @@ type PlayAuthoringRunScope = {
     readonly id: string;
 };
 /** The complete customer-authored `ctx` Interface shared by every Adapter. */
-interface PlayAuthoringRuntimeContext {
+interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' = 'dataset'> {
     /**
      * Load a staged CSV file as a durable dataset handle.
      * @sdkReference runtime 040 ctx.csv(path, options)
@@ -1245,7 +1272,7 @@ interface PlayAuthoringRuntimeContext {
      * Create a persisted row dataset and define durable output columns.
      * @sdkReference runtime 060 ctx.dataset(key, items)
      */
-    dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext>;
+    dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext<TListGetter>>;
     /** @deprecated `ctx.map(...)` was replaced by `ctx.dataset(...)`. */
     map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: PlayAuthoringDatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;
     /**
@@ -1258,7 +1285,7 @@ interface PlayAuthoringRuntimeContext {
          * Execute a provider tool through the terminal-result cache contract.
          * @sdkReference runtime 150 ctx.tools.execute(request)
          */
-        execute<TOutput = PlayLooseObject>(request: PlayToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = PlayLooseObject>(request: PlayToolExecutionRequest): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     };
     customerDb: {
         query<TRow extends object = Record<string, unknown>>(statement: PlaySqlQuery | string, options?: PlayAuthoringCustomerDbQueryOptions): Promise<TRow[]>;
@@ -1266,12 +1293,12 @@ interface PlayAuthoringRuntimeContext {
     /** Shorthand for one managed tool call. */
     tool<TOutput = PlayLooseObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
         description?: string;
-    }): Promise<ToolExecuteResult<TOutput>>;
+    }): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     /**
      * Execute one reusable step program against a scalar input.
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: PlayAuthoringRunnableStepProgram<TOutput, PlayAuthoringRuntimeContext> & {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: PlayAuthoringRunnableStepProgram<TOutput, PlayAuthoringRuntimeContext<TListGetter>> & {
         readonly __inputType?: (input: TInput) => void;
     }, input: TInput, options?: PlayAuthoringRunStepsOptions): Promise<TOutput>;
     /**
@@ -3283,4 +3310,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { type DeeplineGetterValue as $, type AsyncPlayRunRef as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, type PlayAuthoringInputContract as D, type PlayRunId as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, PLAY_ARTIFACT_KINDS as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DeeplineError as S, type ToolExecuteResult as T, ToolExecutionError as U, type ToolExecutionErrorOptions as V, CtxFetchHttpError as W, DEEPLINE_EXTRACTOR_TARGETS as X, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as Y, type DeeplineEmailStatusGetterValue as Z, type DeeplineExtractorTarget as _, type PlayArtifactCompatibility as a, type DeeplineGetterValueMap as a0, JOB_CHANGE_STATUS_VALUES as a1, type JobChangeStatus as a2, PHONE_STATUS_VALUES as a3, type PhoneStatus as a4, type PlayDataset as a5, type PlayDatasetInput as a6, type PreviousCell as a7, ProviderTransientError as a8, type ProviderTransientErrorCategory as a9, type ProviderUnavailableError as aa, type ProviderUnavailableReason as ab, type ToolExecutionErrorCategory as ac, type ToolExecutionErrorOrigin as ad, type ToolExecutionFailureV1 as ae, type ToolExecutionNetworkKind as af, type ToolExecutionNetworkScope as ag, type ToolExecutionPublicDetails as ah, type ToolResultBilling as ai, getProviderUnavailableReason as aj, isDeeplineExtractorTarget as ak, isProviderUnavailable as al, isProviderWaterfallUnavailableError as am, type PlayBundleArtifact as b, type PlayImportPolicy as c, type PlayPackageImport as d, type PlayRuntimeFeature as e, type PlaySandboxRuntimeDeclaration as f, type PlayCompilerManifest as g, type PlayArtifactKind as h, type PlayAuthoringColumnMap as i, type PlayAuthoringColumnResolver as j, type PlayAuthoringRuntimeContext as k, type PlayAuthoringConditionalStepResolver as l, type PlayAuthoringCsvInput as m, type PlayAuthoringCsvOptions as n, type PlayAuthoringDatasetBuilder as o, type PlayAuthoringDatasetColumnDefinition as p, type PlayAuthoringDatasetColumnRunInput as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringAsyncCallOptions as x, type PlayAuthoringBindings as y, type PlayAuthoringCallExecution as z };
+export { type DeeplineEmailStatusGetterValue as $, type AsyncPlayRunRef as A, type BasicToolExecuteResult as B, type PlayAuthoringCallExecution as C, type PlayAuthoringCallOptions as D, type PlayAuthoringFetchResponse as E, type PlayAuthoringInputContract as F, type PlayRunId as G, type PlayAuthoringStepProgramStep as H, type PlayAuthoringRuntimeStepOptions as I, type PlaySqlListenerDeclaration as J, type PlaySqlListenerEvent as K, type PlaySqlListenerOperation as L, type PlaySqlQuery as M, type PlayAuthoringStepOptions as N, type PlayAuthoringStepProgram as O, PLAY_ARTIFACT_KINDS as P, type PlayAuthoringStepProgramResolver as Q, type PlayAuthoringStepResolver as R, type PlayToolExecutionRequest as S, type ToolExecuteResult as T, type PlayAuthoringStepProgramOptions as U, DeeplineError as V, ToolExecutionError as W, type ToolExecutionErrorOptions as X, CtxFetchHttpError as Y, DEEPLINE_EXTRACTOR_TARGETS as Z, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as _, type PlayArtifactCompatibility as a, type DeeplineExtractorTarget as a0, type DeeplineGetterValue as a1, type DeeplineGetterValueMap as a2, JOB_CHANGE_STATUS_VALUES as a3, type JobChangeStatus as a4, PHONE_STATUS_VALUES as a5, type PhoneStatus as a6, type PlayDatasetInput as a7, type PreviousCell as a8, ProviderTransientError as a9, type ProviderTransientErrorCategory as aa, type ProviderUnavailableError as ab, type ProviderUnavailableReason as ac, type ToolExecutionErrorCategory as ad, type ToolExecutionErrorOrigin as ae, type ToolExecutionFailureV1 as af, type ToolExecutionNetworkKind as ag, type ToolExecutionNetworkScope as ah, type ToolExecutionPublicDetails as ai, type ToolResultBilling as aj, getProviderUnavailableReason as ak, isDeeplineExtractorTarget as al, isProviderUnavailable as am, isProviderWaterfallUnavailableError as an, type PlayBundleArtifact as b, type PlayImportPolicy as c, type PlayPackageImport as d, type PlayRuntimeFeature as e, type PlaySandboxRuntimeDeclaration as f, type PlayCompilerManifest as g, type PlayArtifactKind as h, type PlayDataset as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type PlayAuthoringReferenceLike as s, type PlayReturnObject as t, type PlayAuthoringDefineConfig as u, type PlayAuthoringDefinedPlay as v, type PlayAuthoringFetchOptions as w, type PlayAuthoringFileInput as x, type PlayAuthoringAsyncCallOptions as y, type PlayAuthoringBindings as z };

package/dist/{index-B-5_Xhud.d.mts → index-BPbW2XHF.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-9TkZ_ykI.mjs';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-82q4jtfQ.mjs';
 
 type ImportedPlayDependency = {
     filePath: string;

package/dist/{index-ykksoEyR.d.ts → index-k0rquHIm.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-9TkZ_ykI.js';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-82q4jtfQ.js';
 
 type ImportedPlayDependency = {
     filePath: string;

package/dist/index.d.mts

@@ -1,14 +1,20 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecuteToolRawOptions, b as ExecutionRecovery, c as ExecutionByKeyResult, P as PlayListItem, d as PlayDetail, e as PlayRunListItem, f as PlayRevisionSummary, g as PublishPlayVersionResult, C as ClearPlayHistoryResult, h as PlayStatus, S as StopPlayRunResult, i as DeeplineClient, R as ResolvedConfig } from './client-wiWPZhnI.mjs';
-export { j as BillingCreditPool, k as BillingInvoiceEntry, l as BillingInvoicesResult, m as BillingPaymentMethodSummary, n as BillingRecentUsageEntry, o as BillingSubscriptionCancelResult, p as BillingSubscriptionStatus, q as BillingTopUpReceipt, r as BillingTopUpResult, s as BillingUsageEvent, t as BillingUsageOptions, u as BillingUsageResult, v as ChildRunSummary, w as ClearPlayHistoryRequest, x as CreateNotificationGroupInput, y as CreateNotificationGroupResult, z as CustomerDbQueryOptions, A as CustomerDbQueryPlan, F as CustomerDbQueryResult, G as DEEPLINE_TOOL_CATEGORIES, H as DbNamespace, I as DeeplineToolCategory, J as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, K as LiveEventEnvelope, M as MONITOR_JOB_PHASES, N as MONITOR_JOB_RECONCILIATION_STATES, O as MONITOR_JOB_STATES, Q as MonitorBatchNamespace, U as MonitorCheckResult, V as MonitorDefinition, W as MonitorDeleteResult, X as MonitorDependents, Y as MonitorDeployResult, Z as MonitorDetail, _ as MonitorFleetDeactivateOptions, $ as MonitorFleetGetOptions, a0 as MonitorFleetReactivateOptions, a1 as MonitorFleetResult, a2 as MonitorFleetStatus, a3 as MonitorFleetSyncOptions, a4 as MonitorFleetWaitOptions, a5 as MonitorFleetsNamespace, a6 as MonitorJobDeployOptions, a7 as MonitorJobLogsOptions, a8 as MonitorJobPhase, a9 as MonitorJobReconciliationState, aa as MonitorJobResult, ab as MonitorJobState, ac as MonitorJobWaitOptions, ad as MonitorJobsNamespace, ae as MonitorListEntry, af as MonitorPayload, ag as MonitorReactivateResult, ah as MonitorSpec, ai as MonitorState, aj as MonitorStateFilter, ak as MonitorUpdateChangeSummary, al as MonitorUpdateResult, am as MonitorsAccessStatus, an as MonitorsAvailableOptions, ao as MonitorsAvailableResult, ap as MonitorsListOptions, aq as MonitorsListResult, ar as MonitorsNamespace, as as NormalizedRunEventQuery, at as PLAY_BOOTSTRAP_COMPANY_FIELDS, au as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_CONTACT_FIELDS, aw as PLAY_BOOTSTRAP_FINDER_KINDS, ax as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, ay as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, az as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aA as PLAY_BOOTSTRAP_SOURCE_KINDS, aB as PLAY_BOOTSTRAP_STAGE_KINDS, aC as PLAY_BOOTSTRAP_TEMPLATES, aD as PlayActivityObservation, aE as PlayActivityState, aF as PlayActivityTarget, aG as PlayBootstrapEntityKind, aH as PlayBootstrapFinderKind, aI as PlayCostEstimate, aJ as PlayCronTriggerConfig, aK as PlayLiveEvent, aL as PlayPath, aM as PlayRunActionPackage, aN as PlayRunActivityProjection, aO as PlayRunDatasetActions, aP as PlayRunPackage, aQ as PlayRunResult, aR as PlayRunStart, aS as PlaySettings, aT as PlaySettingsPatch, aU as PlaySettingsPathsPage, aV as PlaySettingsResult, aW as PlaySheetRow, aX as PlaySheetRowsResult, aY as PlayTriggerConfigUpdate, aZ as PlayTriggerConfigUpdateResult, a_ as PlayTriggerConfigView, a$ as PlayWebhookAuthConfig, b0 as PlayWebhookTriggerConfig, b1 as PlaysActivityResponse, b2 as PlaysListOptions, b3 as PlaysListPage, b4 as PublishPlayVersionRequest, b5 as RerunOptions, b6 as RerunPlayRunResult, b7 as RunChildrenPage, b8 as RunEventCountResult, b9 as RunEventField, ba as RunEventFieldDescriptor, bb as RunEventFieldOperators, bc as RunEventFieldsResult, bd as RunEventGroupValue, be as RunEventMeasure, bf as RunEventQueryCriteria, bg as RunEventQueryEvent, bh as RunEventQueryInputError, bi as RunEventQueryOptions, bj as RunEventQueryPage, bk as RunEventQueryRetention, bl as RunEventScalar, bm as RunEventSummaryOptions, bn as RunEventSummaryResult, bo as RunEventWhere, bp as RunLifecycleStatus, bq as RunToolReceiptResult, br as RunToolReceiptsResponse, bs as RunsChildrenOptions, bt as RunsEventPayload, bu as RunsEventSearchEntry, bv as RunsEventSearchOptions, bw as RunsEventSearchResult, bx as RunsEventsCountResult, by as RunsEventsCriteria, bz as RunsEventsFieldsOptions, bA as RunsEventsListOptions, bB as RunsEventsListResult, bC as RunsEventsNamespace, bD as RunsEventsSummaryOptions, bE as RunsEventsSummaryResult, bF as RunsHistoryItem, bG as RunsHistoryOptions, bH as RunsHistoryPage, bI as RunsListOptions, bJ as RunsListPage, bK as RunsLogCriteria, bL as RunsLogsCountResult, bM as RunsLogsNamespace, bN as RunsLogsOptions, bO as RunsLogsQueryOptions, bP as RunsLogsQueryResult, bQ as RunsLogsResult, bR as RunsLogsSummaryOptions, bS as RunsLogsSummaryResult, bT as RunsNamespace, bU as RunsTailOptions, bV as RunsWatchOptions, bW as SearchOptions, bX as SearchResult, bY as SearchResultItem, bZ as SearchType, b_ as StartPlayRunRequest, b$ as StopAllCandidate, c0 as StopAllPlayRunsDryRunResult, c1 as StopAllPlayRunsResult, c2 as StopAllPlayRunsStopResult, c3 as StopAllRunsOptions, c4 as ToolExecution, c5 as ToolSearchOptions, c6 as ToolSearchResult, c7 as WorkspaceCreateResult, c8 as WorkspacesNamespace, c9 as defineMonitor, ca as formatPlayBootstrapFinderKinds, cb as formatPlayBootstrapFinderKindsForSentence, cc as formatPlayBootstrapTemplates, cd as isPlayBootstrapFinderKind, ce as isPlayBootstrapTemplate, cf as isStopAllPlayRunsDryRunResult, cg as planCustomerDbQuery } from './client-wiWPZhnI.mjs';
-import { A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-9TkZ_ykI.mjs';
-export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as ToolResultBilling, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-9TkZ_ykI.mjs';
-import { b as BundledPlayFileSuccess } from './index-B-5_Xhud.mjs';
+import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecuteToolRawOptions, b as ExecutionRecovery, c as ExecutionByKeyResult, P as PlayListItem, d as PlayDetail, e as PlayRunListItem, f as PlayRevisionSummary, g as PublishPlayVersionResult, C as ClearPlayHistoryResult, h as PlayStatus, S as StopPlayRunResult, i as DeeplineClient, R as ResolvedConfig } from './client-D5XOQKsA.mjs';
+export { j as BillingCreditPool, k as BillingInvoiceEntry, l as BillingInvoicesResult, m as BillingPaymentMethodSummary, n as BillingRecentUsageEntry, o as BillingSubscriptionCancelResult, p as BillingSubscriptionStatus, q as BillingTopUpReceipt, r as BillingTopUpResult, s as BillingUsageEvent, t as BillingUsageOptions, u as BillingUsageResult, v as ChildRunSummary, w as ClearPlayHistoryRequest, x as CreateNotificationGroupInput, y as CreateNotificationGroupResult, z as CustomerDbQueryOptions, A as CustomerDbQueryPlan, F as CustomerDbQueryResult, G as DEEPLINE_TOOL_CATEGORIES, H as DbNamespace, I as DeeplineToolCategory, J as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, K as LiveEventEnvelope, M as MONITOR_JOB_PHASES, N as MONITOR_JOB_RECONCILIATION_STATES, O as MONITOR_JOB_STATES, Q as MonitorBatchNamespace, U as MonitorCheckResult, V as MonitorDefinition, W as MonitorDeleteResult, X as MonitorDependents, Y as MonitorDeployResult, Z as MonitorDetail, _ as MonitorFleetDeactivateOptions, $ as MonitorFleetGetOptions, a0 as MonitorFleetReactivateOptions, a1 as MonitorFleetResult, a2 as MonitorFleetStatus, a3 as MonitorFleetSyncOptions, a4 as MonitorFleetWaitOptions, a5 as MonitorFleetsNamespace, a6 as MonitorJobDeployOptions, a7 as MonitorJobLogsOptions, a8 as MonitorJobPhase, a9 as MonitorJobReconciliationState, aa as MonitorJobResult, ab as MonitorJobState, ac as MonitorJobWaitOptions, ad as MonitorJobsNamespace, ae as MonitorListEntry, af as MonitorPayload, ag as MonitorReactivateResult, ah as MonitorSpec, ai as MonitorState, aj as MonitorStateFilter, ak as MonitorUpdateChangeSummary, al as MonitorUpdateResult, am as MonitorsAccessStatus, an as MonitorsAvailableOptions, ao as MonitorsAvailableResult, ap as MonitorsListOptions, aq as MonitorsListResult, ar as MonitorsNamespace, as as NormalizedRunEventQuery, at as PLAY_BOOTSTRAP_COMPANY_FIELDS, au as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_CONTACT_FIELDS, aw as PLAY_BOOTSTRAP_FINDER_KINDS, ax as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, ay as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, az as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aA as PLAY_BOOTSTRAP_SOURCE_KINDS, aB as PLAY_BOOTSTRAP_STAGE_KINDS, aC as PLAY_BOOTSTRAP_TEMPLATES, aD as PlayActivityObservation, aE as PlayActivityState, aF as PlayActivityTarget, aG as PlayBootstrapEntityKind, aH as PlayBootstrapFinderKind, aI as PlayCostEstimate, aJ as PlayCronTriggerConfig, aK as PlayLiveEvent, aL as PlayPath, aM as PlayRunActionPackage, aN as PlayRunActivityProjection, aO as PlayRunDatasetActions, aP as PlayRunPackage, aQ as PlayRunResult, aR as PlayRunStart, aS as PlaySettings, aT as PlaySettingsPatch, aU as PlaySettingsPathsPage, aV as PlaySettingsResult, aW as PlaySheetRow, aX as PlaySheetRowsResult, aY as PlayTriggerConfigUpdate, aZ as PlayTriggerConfigUpdateResult, a_ as PlayTriggerConfigView, a$ as PlayWebhookAuthConfig, b0 as PlayWebhookTriggerConfig, b1 as PlaysActivityResponse, b2 as PlaysListOptions, b3 as PlaysListPage, b4 as PublishPlayVersionRequest, b5 as RerunOptions, b6 as RerunPlayRunResult, b7 as RunChildrenPage, b8 as RunEventCountResult, b9 as RunEventField, ba as RunEventFieldDescriptor, bb as RunEventFieldOperators, bc as RunEventFieldsResult, bd as RunEventGroupValue, be as RunEventMeasure, bf as RunEventQueryCriteria, bg as RunEventQueryEvent, bh as RunEventQueryInputError, bi as RunEventQueryOptions, bj as RunEventQueryPage, bk as RunEventQueryRetention, bl as RunEventScalar, bm as RunEventSummaryOptions, bn as RunEventSummaryResult, bo as RunEventWhere, bp as RunLifecycleStatus, bq as RunToolReceiptResult, br as RunToolReceiptsResponse, bs as RunsChildrenOptions, bt as RunsEventPayload, bu as RunsEventSearchEntry, bv as RunsEventSearchOptions, bw as RunsEventSearchResult, bx as RunsEventsCountResult, by as RunsEventsCriteria, bz as RunsEventsFieldsOptions, bA as RunsEventsListOptions, bB as RunsEventsListResult, bC as RunsEventsNamespace, bD as RunsEventsSummaryOptions, bE as RunsEventsSummaryResult, bF as RunsHistoryItem, bG as RunsHistoryOptions, bH as RunsHistoryPage, bI as RunsListOptions, bJ as RunsListPage, bK as RunsLogCriteria, bL as RunsLogsCountResult, bM as RunsLogsNamespace, bN as RunsLogsOptions, bO as RunsLogsQueryOptions, bP as RunsLogsQueryResult, bQ as RunsLogsResult, bR as RunsLogsSummaryOptions, bS as RunsLogsSummaryResult, bT as RunsNamespace, bU as RunsTailOptions, bV as RunsWatchOptions, bW as SearchOptions, bX as SearchResult, bY as SearchResultItem, bZ as SearchType, b_ as StartPlayRunRequest, b$ as StopAllCandidate, c0 as StopAllPlayRunsDryRunResult, c1 as StopAllPlayRunsResult, c2 as StopAllPlayRunsStopResult, c3 as StopAllRunsOptions, c4 as ToolExecution, c5 as ToolSearchOptions, c6 as ToolSearchResult, c7 as WorkspaceCreateResult, c8 as WorkspacesNamespace, c9 as defineMonitor, ca as formatPlayBootstrapFinderKinds, cb as formatPlayBootstrapFinderKindsForSentence, cc as formatPlayBootstrapTemplates, cd as isPlayBootstrapFinderKind, ce as isPlayBootstrapTemplate, cf as isStopAllPlayRunsDryRunResult, cg as planCustomerDbQuery } from './client-D5XOQKsA.mjs';
+import { T as ToolExecuteResult, B as BasicToolExecuteResult, i as PlayDataset, A as AsyncPlayRunRef$1, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, C as PlayAuthoringCallExecution, D as PlayAuthoringCallOptions, E as PlayAuthoringFetchResponse, F as PlayAuthoringInputContract, G as PlayRunId$1, H as PlayAuthoringStepProgramStep, I as PlayAuthoringRuntimeStepOptions, J as PlaySqlListenerDeclaration, K as PlaySqlListenerEvent, L as PlaySqlListenerOperation, M as PlaySqlQuery, N as PlayAuthoringStepOptions, O as PlayAuthoringStepProgram, Q as PlayAuthoringStepProgramResolver, R as PlayAuthoringStepResolver, S as PlayToolExecutionRequest, U as PlayAuthoringStepProgramOptions, V as DeeplineError, W as ToolExecutionError, X as ToolExecutionErrorOptions } from './compiler-manifest-82q4jtfQ.mjs';
+export { Y as CtxFetchHttpError, Z as DEEPLINE_EXTRACTOR_TARGETS, _ as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, $ as DeeplineEmailStatusGetterValue, a0 as DeeplineExtractorTarget, a1 as DeeplineGetterValue, a2 as DeeplineGetterValueMap, a3 as JOB_CHANGE_STATUS_VALUES, a4 as JobChangeStatus, a5 as PHONE_STATUS_VALUES, a6 as PhoneStatus, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as ToolResultBilling, ak as getProviderUnavailableReason, al as isDeeplineExtractorTarget, am as isProviderUnavailable, an as isProviderWaterfallUnavailableError } from './compiler-manifest-82q4jtfQ.mjs';
+import { b as BundledPlayFileSuccess } from './index-BPbW2XHF.mjs';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetDefinition, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 import 'zod';
 import '@sinclair/typebox';
 
+/**
+ * Read array rows out of a tool result — by selector paths, else the first
+ * declared list accessor. Companion to {@link readValue} for `extractList`.
+ */
+declare function readList(result: ToolExecuteResult | BasicToolExecuteResult, selector?: readonly string[] | string): PlayDataset<Record<string, unknown>> | Record<string, unknown>[];
+
 type PlayCallExecution = PlayAuthoringCallExecution;
 type PlayCallOptions = PlayAuthoringCallOptions;
 type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
@@ -202,7 +208,7 @@ type CsvOptions = PlayAuthoringCsvOptions;
  * });
  * ```
  */
-type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext;
+type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
 /**
  * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
  * Like `deepline plays run` and `POST /api/v2/plays/run`, it returns a run id first.
@@ -376,7 +382,7 @@ type DeeplineToolsNamespace = {
      */
     execute(toolId: string, input: Record<string, unknown>, options?: DeeplineToolCallOptions): Promise<DeeplineToolExecuteResult>;
 };
-type DeeplineToolExecuteResult = ToolExecuteResult & {
+type DeeplineToolExecuteResult = BasicToolExecuteResult & {
     /** Stable key used to recover this direct tool execution, when enabled. */
     idempotencyKey?: string;
     executionRecovery?: ExecutionRecovery;
@@ -1055,4 +1061,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, PlayDataset, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, BasicToolExecuteResult as ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, readList, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -1,14 +1,20 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecuteToolRawOptions, b as ExecutionRecovery, c as ExecutionByKeyResult, P as PlayListItem, d as PlayDetail, e as PlayRunListItem, f as PlayRevisionSummary, g as PublishPlayVersionResult, C as ClearPlayHistoryResult, h as PlayStatus, S as StopPlayRunResult, i as DeeplineClient, R as ResolvedConfig } from './client-DHq8dJ56.js';
-export { j as BillingCreditPool, k as BillingInvoiceEntry, l as BillingInvoicesResult, m as BillingPaymentMethodSummary, n as BillingRecentUsageEntry, o as BillingSubscriptionCancelResult, p as BillingSubscriptionStatus, q as BillingTopUpReceipt, r as BillingTopUpResult, s as BillingUsageEvent, t as BillingUsageOptions, u as BillingUsageResult, v as ChildRunSummary, w as ClearPlayHistoryRequest, x as CreateNotificationGroupInput, y as CreateNotificationGroupResult, z as CustomerDbQueryOptions, A as CustomerDbQueryPlan, F as CustomerDbQueryResult, G as DEEPLINE_TOOL_CATEGORIES, H as DbNamespace, I as DeeplineToolCategory, J as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, K as LiveEventEnvelope, M as MONITOR_JOB_PHASES, N as MONITOR_JOB_RECONCILIATION_STATES, O as MONITOR_JOB_STATES, Q as MonitorBatchNamespace, U as MonitorCheckResult, V as MonitorDefinition, W as MonitorDeleteResult, X as MonitorDependents, Y as MonitorDeployResult, Z as MonitorDetail, _ as MonitorFleetDeactivateOptions, $ as MonitorFleetGetOptions, a0 as MonitorFleetReactivateOptions, a1 as MonitorFleetResult, a2 as MonitorFleetStatus, a3 as MonitorFleetSyncOptions, a4 as MonitorFleetWaitOptions, a5 as MonitorFleetsNamespace, a6 as MonitorJobDeployOptions, a7 as MonitorJobLogsOptions, a8 as MonitorJobPhase, a9 as MonitorJobReconciliationState, aa as MonitorJobResult, ab as MonitorJobState, ac as MonitorJobWaitOptions, ad as MonitorJobsNamespace, ae as MonitorListEntry, af as MonitorPayload, ag as MonitorReactivateResult, ah as MonitorSpec, ai as MonitorState, aj as MonitorStateFilter, ak as MonitorUpdateChangeSummary, al as MonitorUpdateResult, am as MonitorsAccessStatus, an as MonitorsAvailableOptions, ao as MonitorsAvailableResult, ap as MonitorsListOptions, aq as MonitorsListResult, ar as MonitorsNamespace, as as NormalizedRunEventQuery, at as PLAY_BOOTSTRAP_COMPANY_FIELDS, au as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_CONTACT_FIELDS, aw as PLAY_BOOTSTRAP_FINDER_KINDS, ax as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, ay as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, az as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aA as PLAY_BOOTSTRAP_SOURCE_KINDS, aB as PLAY_BOOTSTRAP_STAGE_KINDS, aC as PLAY_BOOTSTRAP_TEMPLATES, aD as PlayActivityObservation, aE as PlayActivityState, aF as PlayActivityTarget, aG as PlayBootstrapEntityKind, aH as PlayBootstrapFinderKind, aI as PlayCostEstimate, aJ as PlayCronTriggerConfig, aK as PlayLiveEvent, aL as PlayPath, aM as PlayRunActionPackage, aN as PlayRunActivityProjection, aO as PlayRunDatasetActions, aP as PlayRunPackage, aQ as PlayRunResult, aR as PlayRunStart, aS as PlaySettings, aT as PlaySettingsPatch, aU as PlaySettingsPathsPage, aV as PlaySettingsResult, aW as PlaySheetRow, aX as PlaySheetRowsResult, aY as PlayTriggerConfigUpdate, aZ as PlayTriggerConfigUpdateResult, a_ as PlayTriggerConfigView, a$ as PlayWebhookAuthConfig, b0 as PlayWebhookTriggerConfig, b1 as PlaysActivityResponse, b2 as PlaysListOptions, b3 as PlaysListPage, b4 as PublishPlayVersionRequest, b5 as RerunOptions, b6 as RerunPlayRunResult, b7 as RunChildrenPage, b8 as RunEventCountResult, b9 as RunEventField, ba as RunEventFieldDescriptor, bb as RunEventFieldOperators, bc as RunEventFieldsResult, bd as RunEventGroupValue, be as RunEventMeasure, bf as RunEventQueryCriteria, bg as RunEventQueryEvent, bh as RunEventQueryInputError, bi as RunEventQueryOptions, bj as RunEventQueryPage, bk as RunEventQueryRetention, bl as RunEventScalar, bm as RunEventSummaryOptions, bn as RunEventSummaryResult, bo as RunEventWhere, bp as RunLifecycleStatus, bq as RunToolReceiptResult, br as RunToolReceiptsResponse, bs as RunsChildrenOptions, bt as RunsEventPayload, bu as RunsEventSearchEntry, bv as RunsEventSearchOptions, bw as RunsEventSearchResult, bx as RunsEventsCountResult, by as RunsEventsCriteria, bz as RunsEventsFieldsOptions, bA as RunsEventsListOptions, bB as RunsEventsListResult, bC as RunsEventsNamespace, bD as RunsEventsSummaryOptions, bE as RunsEventsSummaryResult, bF as RunsHistoryItem, bG as RunsHistoryOptions, bH as RunsHistoryPage, bI as RunsListOptions, bJ as RunsListPage, bK as RunsLogCriteria, bL as RunsLogsCountResult, bM as RunsLogsNamespace, bN as RunsLogsOptions, bO as RunsLogsQueryOptions, bP as RunsLogsQueryResult, bQ as RunsLogsResult, bR as RunsLogsSummaryOptions, bS as RunsLogsSummaryResult, bT as RunsNamespace, bU as RunsTailOptions, bV as RunsWatchOptions, bW as SearchOptions, bX as SearchResult, bY as SearchResultItem, bZ as SearchType, b_ as StartPlayRunRequest, b$ as StopAllCandidate, c0 as StopAllPlayRunsDryRunResult, c1 as StopAllPlayRunsResult, c2 as StopAllPlayRunsStopResult, c3 as StopAllRunsOptions, c4 as ToolExecution, c5 as ToolSearchOptions, c6 as ToolSearchResult, c7 as WorkspaceCreateResult, c8 as WorkspacesNamespace, c9 as defineMonitor, ca as formatPlayBootstrapFinderKinds, cb as formatPlayBootstrapFinderKindsForSentence, cc as formatPlayBootstrapTemplates, cd as isPlayBootstrapFinderKind, ce as isPlayBootstrapTemplate, cf as isStopAllPlayRunsDryRunResult, cg as planCustomerDbQuery } from './client-DHq8dJ56.js';
-import { A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-9TkZ_ykI.js';
-export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as ToolResultBilling, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-9TkZ_ykI.js';
-import { b as BundledPlayFileSuccess } from './index-ykksoEyR.js';
+import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecuteToolRawOptions, b as ExecutionRecovery, c as ExecutionByKeyResult, P as PlayListItem, d as PlayDetail, e as PlayRunListItem, f as PlayRevisionSummary, g as PublishPlayVersionResult, C as ClearPlayHistoryResult, h as PlayStatus, S as StopPlayRunResult, i as DeeplineClient, R as ResolvedConfig } from './client-l-IoLh8Z.js';
+export { j as BillingCreditPool, k as BillingInvoiceEntry, l as BillingInvoicesResult, m as BillingPaymentMethodSummary, n as BillingRecentUsageEntry, o as BillingSubscriptionCancelResult, p as BillingSubscriptionStatus, q as BillingTopUpReceipt, r as BillingTopUpResult, s as BillingUsageEvent, t as BillingUsageOptions, u as BillingUsageResult, v as ChildRunSummary, w as ClearPlayHistoryRequest, x as CreateNotificationGroupInput, y as CreateNotificationGroupResult, z as CustomerDbQueryOptions, A as CustomerDbQueryPlan, F as CustomerDbQueryResult, G as DEEPLINE_TOOL_CATEGORIES, H as DbNamespace, I as DeeplineToolCategory, J as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, K as LiveEventEnvelope, M as MONITOR_JOB_PHASES, N as MONITOR_JOB_RECONCILIATION_STATES, O as MONITOR_JOB_STATES, Q as MonitorBatchNamespace, U as MonitorCheckResult, V as MonitorDefinition, W as MonitorDeleteResult, X as MonitorDependents, Y as MonitorDeployResult, Z as MonitorDetail, _ as MonitorFleetDeactivateOptions, $ as MonitorFleetGetOptions, a0 as MonitorFleetReactivateOptions, a1 as MonitorFleetResult, a2 as MonitorFleetStatus, a3 as MonitorFleetSyncOptions, a4 as MonitorFleetWaitOptions, a5 as MonitorFleetsNamespace, a6 as MonitorJobDeployOptions, a7 as MonitorJobLogsOptions, a8 as MonitorJobPhase, a9 as MonitorJobReconciliationState, aa as MonitorJobResult, ab as MonitorJobState, ac as MonitorJobWaitOptions, ad as MonitorJobsNamespace, ae as MonitorListEntry, af as MonitorPayload, ag as MonitorReactivateResult, ah as MonitorSpec, ai as MonitorState, aj as MonitorStateFilter, ak as MonitorUpdateChangeSummary, al as MonitorUpdateResult, am as MonitorsAccessStatus, an as MonitorsAvailableOptions, ao as MonitorsAvailableResult, ap as MonitorsListOptions, aq as MonitorsListResult, ar as MonitorsNamespace, as as NormalizedRunEventQuery, at as PLAY_BOOTSTRAP_COMPANY_FIELDS, au as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_CONTACT_FIELDS, aw as PLAY_BOOTSTRAP_FINDER_KINDS, ax as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, ay as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, az as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aA as PLAY_BOOTSTRAP_SOURCE_KINDS, aB as PLAY_BOOTSTRAP_STAGE_KINDS, aC as PLAY_BOOTSTRAP_TEMPLATES, aD as PlayActivityObservation, aE as PlayActivityState, aF as PlayActivityTarget, aG as PlayBootstrapEntityKind, aH as PlayBootstrapFinderKind, aI as PlayCostEstimate, aJ as PlayCronTriggerConfig, aK as PlayLiveEvent, aL as PlayPath, aM as PlayRunActionPackage, aN as PlayRunActivityProjection, aO as PlayRunDatasetActions, aP as PlayRunPackage, aQ as PlayRunResult, aR as PlayRunStart, aS as PlaySettings, aT as PlaySettingsPatch, aU as PlaySettingsPathsPage, aV as PlaySettingsResult, aW as PlaySheetRow, aX as PlaySheetRowsResult, aY as PlayTriggerConfigUpdate, aZ as PlayTriggerConfigUpdateResult, a_ as PlayTriggerConfigView, a$ as PlayWebhookAuthConfig, b0 as PlayWebhookTriggerConfig, b1 as PlaysActivityResponse, b2 as PlaysListOptions, b3 as PlaysListPage, b4 as PublishPlayVersionRequest, b5 as RerunOptions, b6 as RerunPlayRunResult, b7 as RunChildrenPage, b8 as RunEventCountResult, b9 as RunEventField, ba as RunEventFieldDescriptor, bb as RunEventFieldOperators, bc as RunEventFieldsResult, bd as RunEventGroupValue, be as RunEventMeasure, bf as RunEventQueryCriteria, bg as RunEventQueryEvent, bh as RunEventQueryInputError, bi as RunEventQueryOptions, bj as RunEventQueryPage, bk as RunEventQueryRetention, bl as RunEventScalar, bm as RunEventSummaryOptions, bn as RunEventSummaryResult, bo as RunEventWhere, bp as RunLifecycleStatus, bq as RunToolReceiptResult, br as RunToolReceiptsResponse, bs as RunsChildrenOptions, bt as RunsEventPayload, bu as RunsEventSearchEntry, bv as RunsEventSearchOptions, bw as RunsEventSearchResult, bx as RunsEventsCountResult, by as RunsEventsCriteria, bz as RunsEventsFieldsOptions, bA as RunsEventsListOptions, bB as RunsEventsListResult, bC as RunsEventsNamespace, bD as RunsEventsSummaryOptions, bE as RunsEventsSummaryResult, bF as RunsHistoryItem, bG as RunsHistoryOptions, bH as RunsHistoryPage, bI as RunsListOptions, bJ as RunsListPage, bK as RunsLogCriteria, bL as RunsLogsCountResult, bM as RunsLogsNamespace, bN as RunsLogsOptions, bO as RunsLogsQueryOptions, bP as RunsLogsQueryResult, bQ as RunsLogsResult, bR as RunsLogsSummaryOptions, bS as RunsLogsSummaryResult, bT as RunsNamespace, bU as RunsTailOptions, bV as RunsWatchOptions, bW as SearchOptions, bX as SearchResult, bY as SearchResultItem, bZ as SearchType, b_ as StartPlayRunRequest, b$ as StopAllCandidate, c0 as StopAllPlayRunsDryRunResult, c1 as StopAllPlayRunsResult, c2 as StopAllPlayRunsStopResult, c3 as StopAllRunsOptions, c4 as ToolExecution, c5 as ToolSearchOptions, c6 as ToolSearchResult, c7 as WorkspaceCreateResult, c8 as WorkspacesNamespace, c9 as defineMonitor, ca as formatPlayBootstrapFinderKinds, cb as formatPlayBootstrapFinderKindsForSentence, cc as formatPlayBootstrapTemplates, cd as isPlayBootstrapFinderKind, ce as isPlayBootstrapTemplate, cf as isStopAllPlayRunsDryRunResult, cg as planCustomerDbQuery } from './client-l-IoLh8Z.js';
+import { T as ToolExecuteResult, B as BasicToolExecuteResult, i as PlayDataset, A as AsyncPlayRunRef$1, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, C as PlayAuthoringCallExecution, D as PlayAuthoringCallOptions, E as PlayAuthoringFetchResponse, F as PlayAuthoringInputContract, G as PlayRunId$1, H as PlayAuthoringStepProgramStep, I as PlayAuthoringRuntimeStepOptions, J as PlaySqlListenerDeclaration, K as PlaySqlListenerEvent, L as PlaySqlListenerOperation, M as PlaySqlQuery, N as PlayAuthoringStepOptions, O as PlayAuthoringStepProgram, Q as PlayAuthoringStepProgramResolver, R as PlayAuthoringStepResolver, S as PlayToolExecutionRequest, U as PlayAuthoringStepProgramOptions, V as DeeplineError, W as ToolExecutionError, X as ToolExecutionErrorOptions } from './compiler-manifest-82q4jtfQ.js';
+export { Y as CtxFetchHttpError, Z as DEEPLINE_EXTRACTOR_TARGETS, _ as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, $ as DeeplineEmailStatusGetterValue, a0 as DeeplineExtractorTarget, a1 as DeeplineGetterValue, a2 as DeeplineGetterValueMap, a3 as JOB_CHANGE_STATUS_VALUES, a4 as JobChangeStatus, a5 as PHONE_STATUS_VALUES, a6 as PhoneStatus, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as ToolResultBilling, ak as getProviderUnavailableReason, al as isDeeplineExtractorTarget, am as isProviderUnavailable, an as isProviderWaterfallUnavailableError } from './compiler-manifest-82q4jtfQ.js';
+import { b as BundledPlayFileSuccess } from './index-k0rquHIm.js';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetDefinition, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.js';
 import 'zod';
 import '@sinclair/typebox';
 
+/**
+ * Read array rows out of a tool result — by selector paths, else the first
+ * declared list accessor. Companion to {@link readValue} for `extractList`.
+ */
+declare function readList(result: ToolExecuteResult | BasicToolExecuteResult, selector?: readonly string[] | string): PlayDataset<Record<string, unknown>> | Record<string, unknown>[];
+
 type PlayCallExecution = PlayAuthoringCallExecution;
 type PlayCallOptions = PlayAuthoringCallOptions;
 type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
@@ -202,7 +208,7 @@ type CsvOptions = PlayAuthoringCsvOptions;
  * });
  * ```
  */
-type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext;
+type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
 /**
  * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
  * Like `deepline plays run` and `POST /api/v2/plays/run`, it returns a run id first.
@@ -376,7 +382,7 @@ type DeeplineToolsNamespace = {
      */
     execute(toolId: string, input: Record<string, unknown>, options?: DeeplineToolCallOptions): Promise<DeeplineToolExecuteResult>;
 };
-type DeeplineToolExecuteResult = ToolExecuteResult & {
+type DeeplineToolExecuteResult = BasicToolExecuteResult & {
     /** Stable key used to recover this direct tool execution, when enabled. */
     idempotencyKey?: string;
     executionRecovery?: ExecutionRecovery;
@@ -1055,4 +1061,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, PlayDataset, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, BasicToolExecuteResult as ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, readList, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };