deepline 0.3.110 → 0.3.112

package/dist/{compiler-manifest-x14KL83E.d.ts → compiler-manifest-DfSnbCTW.d.ts}

@@ -2,295 +2,6 @@
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 
-declare const TOOL_EXECUTION_ERROR_SCHEMA_VERSION: 1;
-declare const SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS: readonly [0, 1];
-type ToolExecutionErrorSchemaVersion = (typeof SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS)[number];
-/**
- * The boundary responsible for a failed tool call.
- *
- * Use `provider` to distinguish a provider answer from caller input and
- * Deepline infrastructure. `unknown` fails closed and must not trigger a
- * waterfall fallback.
- *
- * @sdkReference errors 020
- */
-type ToolExecutionErrorOrigin = 'caller' | 'provider' | 'deepline' | 'unknown';
-/**
- * The stable reason family for a failed tool call.
- *
- * Branch on this field only after narrowing to `ToolExecutionError`. Catch
- * `ProviderTransientError` when the policy is simply “try the next read
- * provider”; it is the safer and shorter waterfall contract.
- *
- * @sdkReference errors 030
- */
-type ToolExecutionErrorCategory = 'validation' | 'authentication' | 'authorization' | 'rate_limit' | 'network' | 'upstream' | 'billing' | 'conflict' | 'internal' | 'unknown';
-/**
- * The transport failure observed when `category` is `network`.
- *
- * This is `null` for failures that are not network failures.
- *
- * @sdkReference errors 040
- */
-type ToolExecutionNetworkKind = 'timeout' | 'dns' | 'connect' | 'reset' | 'unavailable' | 'unknown';
-/**
- * The request boundary on which a network failure occurred.
- *
- * `deepline_to_provider` is provider-side. Client and runtime scopes are
- * Deepline transport failures and never qualify as provider fallthrough.
- *
- * @sdkReference errors 050
- */
-type ToolExecutionNetworkScope = 'client_to_deepline' | 'runtime_to_deepline' | 'deepline_to_provider';
-/**
- * Bounded, primitive-only diagnostics explicitly approved for customers.
- * Raw provider bodies, credentials, prompts, stacks, and causes never belong
- * in this shared API/SDK/Play contract.
- *
- * @sdkReference errors 063
- */
-type ToolExecutionPublicDetails = Readonly<Record<string, string | number | boolean | null>>;
-/**
- * Portable version-1 `tool_error` payload.
- *
- * This allowlisted shape crosses the API, runtime, and SDK boundaries.
- * `message` remains on the Error object and is deliberately not a policy
- * field.
- *
- * @sdkReference errors 064
- */
-type ToolExecutionFailureV1 = {
-    /** Payload version. */
-    schemaVersion: typeof TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
-    /** Public tool id passed to `tools.execute`. */
-    toolId: string;
-    /** Provider responsible for the operation, or `null`. */
-    provider: string | null;
-    /** Provider operation name, or `null`. */
-    operation: string | null;
-    /** Stable machine-readable failure code, or `null`. */
-    code: string | null;
-    /** Boundary responsible for the failure. */
-    origin: ToolExecutionErrorOrigin;
-    /** Stable reason family. */
-    category: ToolExecutionErrorCategory;
-    /** Whether repeating the same semantic call is delivery-safe. */
-    retryable: boolean;
-    /** HTTP status when one exists, or `null`. */
-    statusCode: number | null;
-    /** Provider or Deepline request id, or `null`. */
-    requestId: string | null;
-    /** Suggested same-call retry delay in milliseconds, or `null`. */
-    retryAfterMs: number | null;
-    /** Network failure kind, or `null`. */
-    networkKind: ToolExecutionNetworkKind | null;
-    /** Network boundary that failed, or `null`. */
-    networkScope: ToolExecutionNetworkScope | null;
-    /** Explicitly allowlisted customer diagnostics, when present. */
-    publicDetails?: ToolExecutionPublicDetails | null;
-};
-/**
- * Constructor input for a structured tool failure.
- *
- * Deepline creates these values while decoding the versioned wire payload.
- * Customer code normally reads `ToolExecutionError` fields instead of
- * constructing an error.
- *
- * @sdkReference errors 065
- */
-type ToolExecutionErrorOptions = Omit<ToolExecutionFailureV1, 'schemaVersion'> & {
-    /**
-     * Local diagnostic context inherited from DeeplineError. This is not part of
-     * the portable failure payload and is intentionally omitted by serialization.
-     */
-    details?: Record<string, unknown>;
-};
-/**
- * Provider-owned failure categories that may fall through to another read
- * provider.
- *
- * @sdkReference errors 060
- */
-type ProviderTransientErrorCategory = 'rate_limit' | 'network' | 'upstream';
-/**
- * Base error class shared by the SDK and play runtime.
- *
- * The global brand preserves `instanceof DeeplineError` when a bundled play
- * and the runtime load separate physical copies of this module.
- *
- * @sdkReference errors 010
- */
-declare class DeeplineError extends Error {
-    /** HTTP status when the failure crossed an HTTP boundary. */
-    statusCode?: number;
-    /** Stable machine-readable error code when one exists. */
-    code?: string;
-    /** Local diagnostic context; not a portable error contract. */
-    details?: Record<string, unknown>;
-    /**
-     * Construct a Deepline error.
-     *
-     * SDK and runtime code construct these errors. Application and Play code
-     * normally catches the public subclasses instead.
-     *
-     * @param message Human-readable failure summary.
-     * @param statusCode HTTP status when one exists.
-     * @param code Stable machine-readable code when one exists.
-     * @param details Local diagnostic context; never a portable error contract.
-     */
-    constructor(message: string, statusCode?: number, code?: string, details?: Record<string, unknown>);
-    static [Symbol.hasInstance](value: unknown): boolean;
-}
-/**
- * A failed `tools.execute` call with stable, allowlisted provenance.
- *
- * `retryable` means Deepline's delivery/idempotency contract says it is safe
- * to repeat the same semantic call. It does not describe durable receipt
- * repairability and does not make arbitrary side-effecting fallbacks safe.
- *
- * In a Play, catch `ProviderTransientError` to continue a read waterfall and
- * let every other `ToolExecutionError` remain loud. In an SDK client, catch
- * this base class when you need structured diagnostics for every tool failure.
- *
- * @sdkReference errors 070
- */
-declare class ToolExecutionError extends DeeplineError {
-    /** Public tool id passed to `tools.execute`. */
-    readonly toolId: string;
-    /** Provider responsible for the operation, or `null` when unattributed. */
-    readonly provider: string | null;
-    /** Provider operation name, or `null` when unavailable. */
-    readonly operation: string | null;
-    /** Boundary responsible for the failure. */
-    readonly origin: ToolExecutionErrorOrigin;
-    /** Stable reason family for policy and diagnostics. */
-    readonly category: ToolExecutionErrorCategory;
-    /**
-     * Whether repeating the same semantic call is delivery-safe.
-     *
-     * This does not mean the error may be ignored. Waterfall fallthrough is
-     * represented by `ProviderTransientError`.
-     */
-    readonly retryable: boolean;
-    /** Provider or Deepline request id, or `null` when unavailable. */
-    readonly requestId: string | null;
-    /** Suggested same-call retry delay in milliseconds, or `null`. */
-    readonly retryAfterMs: number | null;
-    /** Network failure kind, or `null` for non-network failures. */
-    readonly networkKind: ToolExecutionNetworkKind | null;
-    /** Network boundary that failed, or `null` for non-network failures. */
-    readonly networkScope: ToolExecutionNetworkScope | null;
-    /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
-    readonly publicDetails: ToolExecutionPublicDetails | null;
-    /**
-     * Construct a structured tool error.
-     *
-     * Deepline constructs this from the versioned `tool_error` payload.
-     * Application and Play code should catch it rather than create it.
-     */
-    constructor(message: string, options: ToolExecutionErrorOptions);
-    static [Symbol.hasInstance](value: unknown): boolean;
-}
-/**
- * A provider-owned transient failure that is safe to handle as an empty
- * waterfall leg. Validation, auth, billing, Deepline, and unknown failures
- * never satisfy this type.
- *
- * `retryable` remains independent: it says whether the same semantic call may
- * be repeated safely. Falling through to a different read provider depends on
- * this class, not on `retryable`.
- *
- * @sdkReference errors 080
- */
-declare class ProviderTransientError extends ToolExecutionError {
-    /** Provider attribution is guaranteed for this subtype. */
-    readonly origin: "provider";
-    /** Provider failure category that made this error eligible for fallthrough. */
-    readonly category: ProviderTransientErrorCategory;
-    /** Constructed by Deepline when a provider-owned transient failure arrives. */
-    constructor(message: string, options: Omit<ToolExecutionErrorOptions, 'origin' | 'category'> & {
-        category: ProviderTransientErrorCategory;
-    });
-    static [Symbol.hasInstance](value: unknown): boolean;
-}
-/** Why a provider cannot serve the current read request. */
-type ProviderUnavailableReason = ProviderTransientErrorCategory | 'account_capacity' | 'credentials_missing';
-/**
- * A provider failure that permits a read waterfall to try its next provider.
- * A missing provider connection is included because another provider may still
- * serve the read. Invalid credentials, caller input, and Deepline billing
- * failures remain loud.
- */
-type ProviderUnavailableError = ProviderTransientError | (ToolExecutionError & {
-    readonly origin: 'provider';
-    readonly code: 'PROVIDER_ACCOUNT_CAPACITY';
-}) | (ToolExecutionError & {
-    readonly origin: 'caller';
-    readonly code: 'INTEGRATION_CREDENTIALS_MISSING';
-});
-/**
- * Return the provider-specific reason a read cannot run right now.
- *
- * `null` means this error must stay loud: it is caller input, an invalid
- * customer credential, Deepline billing, or an internal failure. A missing
- * provider connection is different: an explicit read waterfall may continue
- * to a configured fallback and record the unavailable leg.
- */
-declare function getProviderUnavailableReason(error: unknown): ProviderUnavailableReason | null;
-/**
- * Whether a provider cannot serve this read right now.
- *
- * Use this in an explicit `catch` to advance a read-only waterfall. For
- * diagnostics, use `getProviderUnavailableReason(error)`.
- */
-declare function isProviderUnavailable(error: unknown): error is ProviderUnavailableError;
-/** @deprecated Use isProviderUnavailable. */
-declare const isProviderWaterfallUnavailableError: typeof isProviderUnavailable;
-
-/**
- * Public tool-response contracts shared by the API, SDK, Play bundler, and
- * runtime. This is a versioned response transformation contract: a change to
- * the persisted public tool-result shape must introduce a new value here and
- * have newly built Play artifacts select it. Receipt-cache revisions are
- * intentionally separate: ordinary response-contract changes do not refresh
- * durable receipts unless the response transformation changed as well.
- */
-declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
-declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
-type ToolResponseContract = typeof V2_TOOL_RESPONSE_CONTRACT | typeof RAW_V2_TOOL_RESPONSE_CONTRACT;
-
-/**
- * Previous durable cell value passed to object-column resolvers.
- *
- * The runtime supplies this when a row+column is being recomputed after a
- * previous value existed. `value` has the same type that the column returns;
- * freshness metadata lives beside it.
- *
- * @sdkReference runtime 120
- */
-type PreviousCell<Value = unknown> = {
-    /** Previous completed value for this row+column. */
-    value: Value;
-    /** Millisecond timestamp when the previous value completed. */
-    completedAt?: number;
-    /** Millisecond timestamp when the previous value becomes stale; `null` means no expiry. */
-    staleAt?: number | null;
-    /** Resolved numeric TTL in seconds for the previous value, when present. */
-    staleAfterSeconds?: number;
-};
-
-type PlaySandboxRuntimeLimits = {
-    timeoutSeconds: number;
-    memoryGiB: number;
-    cpu: number;
-    diskGiB: number;
-};
-type PlaySandboxSize = 'standard';
-type PlaySandboxRuntimeDeclaration = {
-    timeout?: string;
-    size?: PlaySandboxSize;
-};
-
 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';
@@ -517,199 +228,506 @@ type PlayDatasetBacking = {
         playName: string;
         tableNamespace: string;
     };
-} | {
-    storage: 'r2_file';
-    file: PlayExecutionFileRef;
+} | {
+    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 PlayDatasetRow<TInput> = TInput extends PlayDataset<infer Row> ? Row : TInput extends ReadonlyArray<infer Row> ? Row : TInput extends Iterable<infer Row> ? Row : TInput extends AsyncIterable<infer Row> ? Row : never;
+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()`, `.length`, numeric indexing, spread, or synchronous iteration;
+ * those hide the runtime cost of loading persisted rows into memory or make
+ * behavior depend on whether rows happen to be resident.
+ *
+ * @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[]>;
+    /** First row, loading it asynchronously when necessary. */
+    first(): Promise<T | undefined>;
+    /** Row at an array-style index, loading it asynchronously when necessary. */
+    at(index: number): Promise<T | undefined>;
+    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(options?: number | PlayDatasetMaterializeOptions): 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 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;
+};
+
+/**
+ * Customer pricing reported by the execution API, never provider spend.
+ * `credits_charged` and `cost_usd` describe the price of the original call;
+ * they do not acknowledge durable handoff or wallet posting. Receipt replay
+ * preserves this observation and does not imply a new charge or fresher state.
+ */
+type ToolResultBilling = {
+    credits_charged?: number;
+    cost_usd?: number;
+    /** Missing on historical responses. Pending pricing has no final amount. */
+    pricing_status?: 'final' | 'pending';
+    settlement_status?: 'pending' | 'queued' | 'settled' | 'requires_recovery';
+    estimated_credits?: number;
+    estimated_cost_usd?: number;
+    /** Preserve additive public pricing details across runtime/deployment skew. */
+    [key: string]: unknown;
+};
+type ToolResultExecutionMetadata = {
+    idempotent: true;
+    cached: boolean;
+    source: 'live' | 'checkpoint' | 'cache' | 'in_flight' | 'source_run';
+    cacheKey?: string;
+    receiptRole?: 'owner' | 'follower';
+    receiptKey?: string;
+    attachedToReceiptKey?: string;
+};
+type ToolResultTargetMetadata = {
+    value: unknown;
+    path: string;
+};
+type ToolResultListMetadata = {
+    path: string;
+    count: number | null;
+    keys: Record<string, string>;
+};
+type ToolResultExtractorDescriptor = {
+    paths: readonly string[];
+    transforms?: readonly string[];
+    enum?: readonly string[];
+    overrides?: readonly ToolResultExtractorOverride[];
+    emailStatus?: EmailStatusExtractorConfig;
+};
+type ToolResultExtractorOverride = {
+    paths: readonly string[];
+    equals?: string | number | boolean | null;
+    value: string | number | boolean | null;
+};
+type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
+    get(): T | null;
+};
+type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
+    keys: Partial<Record<TKey, string>> & Record<string, string>;
+    get(): PlayDataset<T>;
+};
+type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
+    raw: TData;
+    /** Complete parsed and scrubbed provider response, materialized from raw-v2. */
+    rawV2?: unknown;
+    /** Durable descriptor for deriving the legacy raw view from `rawV2`. */
+    view?: 'data' | 'rawV2';
+    meta?: TMeta;
+};
+type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> = {
+    status: string;
+    job_id?: string;
+    /** Deepline-owned execution/result metadata. */
+    meta?: Record<string, unknown>;
+    billing?: ToolResultBilling;
+    toolResponse: ToolResponseEnvelope<TResult, TMeta>;
+    extractedValues: Record<string, ToolResultTargetAccessor>;
+    extractedLists: Record<string, ToolResultListAccessor>;
+    /** Convenience alias for play code. Serialized output uses toolResponse. */
+    toolOutput: ToolResponseEnvelope<TResult, TMeta>;
+    _metadata: {
+        toolId: string;
+        execution: ToolResultExecutionMetadata;
+        targets: Record<string, {
+            value: unknown;
+            path: string;
+        }>;
+        extractors?: Record<string, ToolResultExtractorDescriptor>;
+        lists: Record<string, {
+            path: string;
+            count: number | null;
+            keys: Record<string, string>;
+        }>;
+        /** Original declarations preserve semantic accessor names across replay. */
+        listExtractorPaths?: readonly string[];
+    };
 };
-type PlayDatasetWorkProgressSummary = {
-    total: number;
-    executed: number;
-    reused: number;
-    skipped: number;
-    pending: number;
-    failed: number;
-    degraded?: boolean;
-    duplicates?: {
-        exact?: number;
-        semantic?: number;
-        rejected?: number;
+type ToolExecuteResultAccessors<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]: ToolResultListAccessor<TLists[K]>;
     };
 };
-type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
-type PlayDatasetRow<TInput> = TInput extends PlayDataset<infer Row> ? Row : TInput extends ReadonlyArray<infer Row> ? Row : TInput extends Iterable<infer Row> ? Row : TInput extends AsyncIterable<infer Row> ? Row : never;
-type PlayDatasetTransformOptions = {
-    key?: string;
-    sourceLabel?: string | null;
+/**
+ * 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`; `toolResponse.raw` remains the legacy compatibility
+ * projection. Response metadata lives under `toolResponse.meta`. Semantic single-value
+ * getters live under `extractedValues.<name>.get()`, and list getters live
+ * under `extractedLists.<name>.get()`.
+ *
+ * Use extractors first when a tool contract exposes them. Use list getters for
+ * row-shaped data. Drop to `toolResponse.raw` only for provider-specific scalar
+ * fields or bounded debugging context; persisted rows may clip declared lists to
+ * previews.
+ *
+ * @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 TOOL_EXECUTION_ERROR_SCHEMA_VERSION: 1;
+declare const SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS: readonly [0, 1];
+type ToolExecutionErrorSchemaVersion = (typeof SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS)[number];
+/**
+ * The boundary responsible for a failed tool call.
+ *
+ * Use `provider` to distinguish a provider answer from caller input and
+ * Deepline infrastructure. `unknown` fails closed and must not trigger a
+ * waterfall fallback.
+ *
+ * @sdkReference errors 020
+ */
+type ToolExecutionErrorOrigin = 'caller' | 'provider' | 'deepline' | 'unknown';
+/**
+ * The stable reason family for a failed tool call.
+ *
+ * Branch on this field only after narrowing to `ToolExecutionError`. Catch
+ * `ProviderTransientError` when the policy is simply “try the next read
+ * provider”; it is the safer and shorter waterfall contract.
+ *
+ * @sdkReference errors 030
+ */
+type ToolExecutionErrorCategory = 'validation' | 'authentication' | 'authorization' | 'rate_limit' | 'network' | 'upstream' | 'billing' | 'conflict' | 'internal' | 'unknown';
+/**
+ * The transport failure observed when `category` is `network`.
+ *
+ * This is `null` for failures that are not network failures.
+ *
+ * @sdkReference errors 040
+ */
+type ToolExecutionNetworkKind = 'timeout' | 'dns' | 'connect' | 'reset' | 'unavailable' | 'unknown';
+/**
+ * The request boundary on which a network failure occurred.
+ *
+ * `deepline_to_provider` is provider-side. Client and runtime scopes are
+ * Deepline transport failures and never qualify as provider fallthrough.
+ *
+ * @sdkReference errors 050
+ */
+type ToolExecutionNetworkScope = 'client_to_deepline' | 'runtime_to_deepline' | 'deepline_to_provider';
+/**
+ * Bounded, primitive-only diagnostics explicitly approved for customers.
+ * Raw provider bodies, credentials, prompts, stacks, and causes never belong
+ * in this shared API/SDK/Play contract.
+ *
+ * @sdkReference errors 063
+ */
+type ToolExecutionPublicDetails = Readonly<Record<string, string | number | boolean | null>>;
+/**
+ * Portable version-1 `tool_error` payload.
+ *
+ * This allowlisted shape crosses the API, runtime, and SDK boundaries.
+ * `message` remains on the Error object and is deliberately not a policy
+ * field.
+ *
+ * @sdkReference errors 064
+ */
+type ToolExecutionFailureV1 = {
+    /** Payload version. */
+    schemaVersion: typeof TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
+    /** Public tool id passed to `tools.execute`. */
+    toolId: string;
+    /** Provider responsible for the operation, or `null`. */
+    provider: string | null;
+    /** Provider operation name, or `null`. */
+    operation: string | null;
+    /** Stable machine-readable failure code, or `null`. */
+    code: string | null;
+    /** Boundary responsible for the failure. */
+    origin: ToolExecutionErrorOrigin;
+    /** Stable reason family. */
+    category: ToolExecutionErrorCategory;
+    /** Whether repeating the same semantic call is delivery-safe. */
+    retryable: boolean;
+    /** HTTP status when one exists, or `null`. */
+    statusCode: number | null;
+    /** Provider or Deepline request id, or `null`. */
+    requestId: string | null;
+    /** Suggested same-call retry delay in milliseconds, or `null`. */
+    retryAfterMs: number | null;
+    /** Network failure kind, or `null`. */
+    networkKind: ToolExecutionNetworkKind | null;
+    /** Network boundary that failed, or `null`. */
+    networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted customer diagnostics, when present. */
+    publicDetails?: ToolExecutionPublicDetails | null;
+};
+/**
+ * Constructor input for a structured tool failure.
+ *
+ * Deepline creates these values while decoding the versioned wire payload.
+ * Customer code normally reads `ToolExecutionError` fields instead of
+ * constructing an error.
+ *
+ * @sdkReference errors 065
+ */
+type ToolExecutionErrorOptions = Omit<ToolExecutionFailureV1, 'schemaVersion'> & {
+    /**
+     * Local diagnostic context inherited from DeeplineError. This is not part of
+     * the portable failure payload and is intentionally omitted by serialization.
+     */
+    details?: Record<string, unknown>;
 };
 /**
- * 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.
+ * Provider-owned failure categories that may fall through to another read
+ * provider.
+ *
+ * @sdkReference errors 060
+ */
+type ProviderTransientErrorCategory = 'rate_limit' | 'network' | 'upstream';
+/**
+ * Base error class shared by the SDK and play runtime.
+ *
+ * The global brand preserves `instanceof DeeplineError` when a bundled play
+ * and the runtime load separate physical copies of this module.
+ *
+ * @sdkReference errors 010
+ */
+declare class DeeplineError extends Error {
+    /** HTTP status when the failure crossed an HTTP boundary. */
+    statusCode?: number;
+    /** Stable machine-readable error code when one exists. */
+    code?: string;
+    /** Local diagnostic context; not a portable error contract. */
+    details?: Record<string, unknown>;
+    /**
+     * Construct a Deepline error.
+     *
+     * SDK and runtime code construct these errors. Application and Play code
+     * normally catches the public subclasses instead.
+     *
+     * @param message Human-readable failure summary.
+     * @param statusCode HTTP status when one exists.
+     * @param code Stable machine-readable code when one exists.
+     * @param details Local diagnostic context; never a portable error contract.
+     */
+    constructor(message: string, statusCode?: number, code?: string, details?: Record<string, unknown>);
+    static [Symbol.hasInstance](value: unknown): boolean;
+}
+/**
+ * A failed `tools.execute` call with stable, allowlisted provenance.
+ *
+ * `retryable` means Deepline's delivery/idempotency contract says it is safe
+ * to repeat the same semantic call. It does not describe durable receipt
+ * repairability and does not make arbitrary side-effecting fallbacks safe.
+ *
+ * In a Play, catch `ProviderTransientError` to continue a read waterfall and
+ * let every other `ToolExecutionError` remain loud. In an SDK client, catch
+ * this base class when you need structured diagnostics for every tool failure.
+ *
+ * @sdkReference errors 070
+ */
+declare class ToolExecutionError extends DeeplineError {
+    /** Public tool id passed to `tools.execute`. */
+    readonly toolId: string;
+    /** Provider responsible for the operation, or `null` when unattributed. */
+    readonly provider: string | null;
+    /** Provider operation name, or `null` when unavailable. */
+    readonly operation: string | null;
+    /** Boundary responsible for the failure. */
+    readonly origin: ToolExecutionErrorOrigin;
+    /** Stable reason family for policy and diagnostics. */
+    readonly category: ToolExecutionErrorCategory;
+    /**
+     * Whether repeating the same semantic call is delivery-safe.
+     *
+     * This does not mean the error may be ignored. Waterfall fallthrough is
+     * represented by `ProviderTransientError`.
+     */
+    readonly retryable: boolean;
+    /** Provider or Deepline request id, or `null` when unavailable. */
+    readonly requestId: string | null;
+    /** Suggested same-call retry delay in milliseconds, or `null`. */
+    readonly retryAfterMs: number | null;
+    /** Network failure kind, or `null` for non-network failures. */
+    readonly networkKind: ToolExecutionNetworkKind | null;
+    /** Network boundary that failed, or `null` for non-network failures. */
+    readonly networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
+    readonly publicDetails: ToolExecutionPublicDetails | null;
+    /**
+     * Construct a structured tool error.
+     *
+     * Deepline constructs this from the versioned `tool_error` payload.
+     * Application and Play code should catch it rather than create it.
+     */
+    constructor(message: string, options: ToolExecutionErrorOptions);
+    static [Symbol.hasInstance](value: unknown): boolean;
+}
+/**
+ * A provider-owned transient failure that is safe to handle as an empty
+ * waterfall leg. Validation, auth, billing, Deepline, and unknown failures
+ * never satisfy this type.
  *
- * 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()`, `.length`, numeric indexing, spread, or synchronous iteration;
- * those hide the runtime cost of loading persisted rows into memory or make
- * behavior depend on whether rows happen to be resident.
+ * `retryable` remains independent: it says whether the same semantic call may
+ * be repeated safely. Falling through to a different read provider depends on
+ * this class, not on `retryable`.
  *
- * @sdkReference runtime 190
+ * @sdkReference errors 080
  */
-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[]>;
-    /** First row, loading it asynchronously when necessary. */
-    first(): Promise<T | undefined>;
-    /** Row at an array-style index, loading it asynchronously when necessary. */
-    at(index: number): Promise<T | undefined>;
-    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(options?: number | PlayDatasetMaterializeOptions): 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[];
-    };
+declare class ProviderTransientError extends ToolExecutionError {
+    /** Provider attribution is guaranteed for this subtype. */
+    readonly origin: "provider";
+    /** Provider failure category that made this error eligible for fallthrough. */
+    readonly category: ProviderTransientErrorCategory;
+    /** Constructed by Deepline when a provider-owned transient failure arrives. */
+    constructor(message: string, options: Omit<ToolExecutionErrorOptions, 'origin' | 'category'> & {
+        category: ProviderTransientErrorCategory;
+    });
+    static [Symbol.hasInstance](value: unknown): boolean;
 }
-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;
-    cached: boolean;
-    source: 'live' | 'checkpoint' | 'cache' | 'in_flight' | 'source_run';
-    cacheKey?: string;
-    receiptRole?: 'owner' | 'follower';
-    receiptKey?: string;
-    attachedToReceiptKey?: string;
-};
-type ToolResultTargetMetadata = {
-    value: unknown;
-    path: string;
-};
-type ToolResultListMetadata = {
-    path: string;
-    count: number | null;
-    keys: Record<string, string>;
-};
-type ToolResultExtractorDescriptor = {
-    paths: readonly string[];
-    transforms?: readonly string[];
-    enum?: readonly string[];
-    overrides?: readonly ToolResultExtractorOverride[];
-    emailStatus?: EmailStatusExtractorConfig;
-};
-type ToolResultExtractorOverride = {
-    paths: readonly string[];
-    equals?: string | number | boolean | null;
-    value: string | number | boolean | null;
-};
-type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
-    get(): T | null;
-};
-type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
-    keys: Partial<Record<TKey, string>> & Record<string, string>;
-    get(): PlayDataset<T>;
-};
-type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
-    raw: TData;
-    /** Complete parsed and scrubbed provider response, materialized from raw-v2. */
-    rawV2?: unknown;
-    /** Durable descriptor for deriving the legacy raw view from `rawV2`. */
-    view?: 'data' | 'rawV2';
-    meta?: TMeta;
-};
-type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> = {
-    status: string;
-    job_id?: string;
-    /** Deepline-owned execution/result metadata. */
-    meta?: Record<string, unknown>;
-    toolResponse: ToolResponseEnvelope<TResult, TMeta>;
-    extractedValues: Record<string, ToolResultTargetAccessor>;
-    extractedLists: Record<string, ToolResultListAccessor>;
-    /** Convenience alias for play code. Serialized output uses toolResponse. */
-    toolOutput: ToolResponseEnvelope<TResult, TMeta>;
-    _metadata: {
-        toolId: string;
-        execution: ToolResultExecutionMetadata;
-        targets: Record<string, {
-            value: unknown;
-            path: string;
-        }>;
-        extractors?: Record<string, ToolResultExtractorDescriptor>;
-        lists: Record<string, {
-            path: string;
-            count: number | null;
-            keys: Record<string, string>;
-        }>;
-        /** Original declarations preserve semantic accessor names across replay. */
-        listExtractorPaths?: readonly string[];
-    };
-};
-type ToolExecuteResultAccessors<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]: ToolResultListAccessor<TLists[K]>;
-    };
-};
+/** Why a provider cannot serve the current read request. */
+type ProviderUnavailableReason = ProviderTransientErrorCategory | 'account_capacity' | 'credentials_missing';
 /**
- * Canonical result returned by Deepline tool execution.
+ * A provider failure that permits a read waterfall to try its next provider.
+ * A missing provider connection is included because another provider may still
+ * serve the read. Invalid credentials, caller input, and Deepline billing
+ * failures remain loud.
+ */
+type ProviderUnavailableError = ProviderTransientError | (ToolExecutionError & {
+    readonly origin: 'provider';
+    readonly code: 'PROVIDER_ACCOUNT_CAPACITY';
+}) | (ToolExecutionError & {
+    readonly origin: 'caller';
+    readonly code: 'INTEGRATION_CREDENTIALS_MISSING';
+});
+/**
+ * Return the provider-specific reason a read cannot run right now.
  *
- * The top-level object is Deepline-owned execution metadata and semantic
- * extraction state. The canonical provider response lives under
- * `toolResponse.rawV2`; `toolResponse.raw` remains the legacy compatibility
- * projection. Response metadata lives under `toolResponse.meta`. Semantic single-value
- * getters live under `extractedValues.<name>.get()`, and list getters live
- * under `extractedLists.<name>.get()`.
+ * `null` means this error must stay loud: it is caller input, an invalid
+ * customer credential, Deepline billing, or an internal failure. A missing
+ * provider connection is different: an explicit read waterfall may continue
+ * to a configured fallback and record the unavailable leg.
+ */
+declare function getProviderUnavailableReason(error: unknown): ProviderUnavailableReason | null;
+/**
+ * Whether a provider cannot serve this read right now.
  *
- * Use extractors first when a tool contract exposes them. Use list getters for
- * row-shaped data. Drop to `toolResponse.raw` only for provider-specific scalar
- * fields or bounded debugging context; persisted rows may clip declared lists to
- * previews.
+ * Use this in an explicit `catch` to advance a read-only waterfall. For
+ * diagnostics, use `getProviderUnavailableReason(error)`.
+ */
+declare function isProviderUnavailable(error: unknown): error is ProviderUnavailableError;
+/** @deprecated Use isProviderUnavailable. */
+declare const isProviderWaterfallUnavailableError: typeof isProviderUnavailable;
+
+/**
+ * Public tool-response contracts shared by the API, SDK, Play bundler, and
+ * runtime. This is a versioned response transformation contract: a change to
+ * the persisted public tool-result shape must introduce a new value here and
+ * have newly built Play artifacts select it. Receipt-cache revisions are
+ * intentionally separate: ordinary response-contract changes do not refresh
+ * durable receipts unless the response transformation changed as well.
+ */
+declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
+declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
+type ToolResponseContract = typeof V2_TOOL_RESPONSE_CONTRACT | typeof RAW_V2_TOOL_RESPONSE_CONTRACT;
+
+/**
+ * Previous durable cell value passed to object-column resolvers.
  *
- * @sdkReference runtime 200
+ * The runtime supplies this when a row+column is being recomputed after a
+ * previous value existed. `value` has the same type that the column returns;
+ * freshness metadata lives beside it.
+ *
+ * @sdkReference runtime 120
  */
-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>;
+type PreviousCell<Value = unknown> = {
+    /** Previous completed value for this row+column. */
+    value: Value;
+    /** Millisecond timestamp when the previous value completed. */
+    completedAt?: number;
+    /** Millisecond timestamp when the previous value becomes stale; `null` means no expiry. */
+    staleAt?: number | null;
+    /** Resolved numeric TTL in seconds for the previous value, when present. */
+    staleAfterSeconds?: number;
+};
+
+type PlaySandboxRuntimeLimits = {
+    timeoutSeconds: number;
+    memoryGiB: number;
+    cpu: number;
+    diskGiB: number;
+};
+type PlaySandboxSize = 'standard';
+type PlaySandboxRuntimeDeclaration = {
+    timeout?: string;
+    size?: PlaySandboxSize;
+};
 
 declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
@@ -3155,4 +3173,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, type PlayArtifactKind 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 PlayBundleArtifact 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, getProviderUnavailableReason as ai, isDeeplineExtractorTarget as aj, isProviderUnavailable as ak, isProviderWaterfallUnavailableError as al, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature 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 DeeplineExtractorTarget as $, type AsyncPlayRunRef as A, type PlayAuthoringCallExecution as B, type PlayAuthoringCallOptions as C, type PlayAuthoringFetchResponse as D, type PlayAuthoringInputContract as E, type PlayRunId as F, type PlayAuthoringStepProgramStep as G, type PlayAuthoringRuntimeStepOptions as H, type PlaySqlListenerDeclaration as I, type PlaySqlListenerEvent as J, type PlaySqlListenerOperation as K, type PlaySqlQuery as L, type PlayAuthoringStepOptions as M, type PlayAuthoringStepProgram as N, type PlayAuthoringStepProgramResolver as O, type PlayArtifactKind as P, type PlayAuthoringStepResolver as Q, type PlayToolExecutionRequest as R, type PlayAuthoringStepProgramOptions as S, type ToolResultBilling as T, DeeplineError as U, ToolExecutionError as V, type ToolExecutionErrorOptions as W, CtxFetchHttpError as X, DEEPLINE_EXTRACTOR_TARGETS as Y, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as Z, type DeeplineEmailStatusGetterValue as _, type PlayBundleArtifact as a, type DeeplineGetterValue as a0, type DeeplineGetterValueMap as a1, JOB_CHANGE_STATUS_VALUES as a2, type JobChangeStatus as a3, PHONE_STATUS_VALUES as a4, type PhoneStatus as a5, type PlayDataset 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, getProviderUnavailableReason as aj, isDeeplineExtractorTarget as ak, isProviderUnavailable as al, isProviderWaterfallUnavailableError as am, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature 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 ToolExecuteResult 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 };