deepline 0.1.301 → 0.1.303

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-BjopNIqx.mjs';
+import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.mjs';
+export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.mjs';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -1587,6 +1588,7 @@ type EnrichStepCommand = {
             functionExpressionSource: string;
             sourceHash: string;
             typeImports: string[];
+            runtimeImports?: string[];
         };
     };
     payload: Record<string, unknown>;
@@ -3166,43 +3168,6 @@ declare const SDK_VERSION: string;
 /** @deprecated Transitional wire id for pre-major-header SDKs only. */
 declare const SDK_API_CONTRACT: string;
 
-/**
- * Base error class for all Deepline SDK errors.
- *
- * Every error thrown by the SDK extends this class, so you can catch all
- * Deepline-specific errors with a single `catch (e) { if (e instanceof DeeplineError) }`.
- *
- * @example
- * ```typescript
- * import { DeeplineClient, DeeplineError, AuthError } from 'deepline';
- *
- * const client = new DeeplineClient();
- * try {
- *   await client.executeTool('dropleads_search_people', { query: 'cto' });
- * } catch (err) {
- *   if (err instanceof AuthError) {
- *     console.error('Bad API key — run: deepline auth register');
- *   } else if (err instanceof DeeplineError) {
- *     console.error(`API error ${err.statusCode}: ${err.message}`);
- *   }
- * }
- * ```
- */
-declare class DeeplineError extends Error {
-    /** HTTP status code from the API response, if applicable. */
-    statusCode?: number | undefined;
-    /** Machine-readable error code (e.g. `'AUTH_ERROR'`, `'RATE_LIMIT'`, `'CONFIG_ERROR'`). */
-    code?: string | undefined;
-    /** Additional context from the API response body. */
-    details?: Record<string, unknown> | undefined;
-    constructor(message: string, 
-    /** HTTP status code from the API response, if applicable. */
-    statusCode?: number | undefined, 
-    /** Machine-readable error code (e.g. `'AUTH_ERROR'`, `'RATE_LIMIT'`, `'CONFIG_ERROR'`). */
-    code?: string | undefined, 
-    /** Additional context from the API response body. */
-    details?: Record<string, unknown> | undefined);
-}
 /**
  * Thrown when the API rejects the request due to an invalid or missing API key.
  *
@@ -3224,8 +3189,11 @@ declare class DeeplineError extends Error {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 090
  */
 declare class AuthError extends DeeplineError {
+    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
     constructor(message?: string);
 }
 /**
@@ -3250,12 +3218,53 @@ declare class AuthError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 100
  */
 declare class RateLimitError extends DeeplineError {
     /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
     retryAfterMs: number;
+    /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
     constructor(retryAfterMs?: number, message?: string);
 }
+/**
+ * Tool-specific 429 preserving both historical RateLimitError catches and the
+ * structured ToolExecutionError ontology. JavaScript has one prototype chain,
+ * so this class extends RateLimitError and carries ToolExecutionError's stable
+ * cross-bundle brand.
+ *
+ * This class appears in external SDK calls after HTTP 429 retries are
+ * exhausted. It also satisfies `instanceof ToolExecutionError` and, for a
+ * provider-owned rate limit, `instanceof ProviderTransientError`. Authored
+ * Plays should use `ProviderTransientError`; they do not need this
+ * compatibility class.
+ *
+ * @sdkReference errors 110
+ */
+declare class ToolRateLimitError extends RateLimitError {
+    /** Public tool id passed to `tools.execute`. */
+    readonly toolId: string;
+    /** Provider responsible for the operation, or `null`. */
+    readonly provider: string | null;
+    /** Provider operation name, or `null`. */
+    readonly operation: string | null;
+    /** Stable machine-readable failure code when one exists. */
+    readonly code: string | undefined;
+    /** Boundary responsible for the failure. */
+    readonly origin: ToolExecutionError['origin'];
+    /** Stable reason family for policy and diagnostics. */
+    readonly category: ToolExecutionError['category'];
+    /** Whether repeating the same semantic call is delivery-safe. */
+    readonly retryable: boolean;
+    /** Provider or Deepline request id, or `null`. */
+    readonly requestId: string | null;
+    /** Network failure kind, or `null` for non-network failures. */
+    readonly networkKind: ToolExecutionError['networkKind'];
+    /** Network boundary that failed, or `null` for non-network failures. */
+    readonly networkScope: ToolExecutionError['networkScope'];
+    /** Constructed by the SDK after a structured tool HTTP 429. */
+    constructor(message: string, options: ToolExecutionErrorOptions);
+}
 /**
  * Thrown when the SDK cannot resolve a valid configuration.
  *
@@ -3274,8 +3283,11 @@ declare class RateLimitError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 120
  */
 declare class ConfigError extends DeeplineError {
+    /** Construct a local SDK configuration failure. */
     constructor(message: string);
 }
 
@@ -3666,6 +3678,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             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>>> = {
@@ -3778,6 +3792,16 @@ type PlayBindings = {
      * older clients can continue to register revisions during the migration.
      */
     description?: string;
+    /**
+     * Public behavior that must remain pinned for this play artifact.
+     *
+     * New plays default to typed tool errors (`1`). Set `toolErrorSchemaVersion`
+     * to `0` only while migrating code that depends on legacy error names,
+     * messages, or classes.
+     */
+    compatibility?: {
+        toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion;
+    };
     /** Allow compilers to bundle this named handler directly without a child run. */
     inline?: boolean;
     /** Optional per-run billing controls enforced by the runtime. */
@@ -4352,7 +4376,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 140 ctx.runPlay(key, playRef, input, options)
      */
-    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: PlayCallOptions): Promise<TOutput>;
+    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options?: PlayCallOptions): Promise<TOutput>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.
      *
@@ -4599,6 +4623,8 @@ type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = {
     bindings?: PlayBindings;
     /** Billing options. */
     billing?: PlayBindings['billing'];
+    /** Runtime compatibility override. Omit for the current typed contract. */
+    compatibility?: PlayBindings['compatibility'];
 };
 declare function steps<TInput>(): StepProgram<TInput, TInput, TInput>;
 declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boolean | Promise<boolean>, resolver: StepResolver<Row, Value>): ConditionalStepResolver<Row, Value, null>;
@@ -4639,6 +4665,8 @@ declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boole
 type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & DeeplineNamedPlay<TInput, TOutput> & {
     /** Optional trigger bindings (cron, webhook). */
     readonly bindings?: PlayBindings;
+    /** Runtime compatibility explicitly selected by the author. */
+    readonly compatibility?: PlayBindings['compatibility'];
     /** The play's name (same as `.name`). */
     readonly playName: string;
 };
@@ -4648,6 +4676,7 @@ type PlayMetadata = {
     bindings?: PlayBindings;
     inputSchema?: Record<string, unknown>;
     billing?: PlayBindings['billing'];
+    compatibility?: PlayBindings['compatibility'];
 };
 /**
  * High-level SDK context with tool shortcuts and play handles.
@@ -5043,4 +5072,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, type IngestionStorageRepairResult, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, type IngestionStorageRepairResult, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-BjopNIqx.js';
+import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.js';
+export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.js';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -1587,6 +1588,7 @@ type EnrichStepCommand = {
             functionExpressionSource: string;
             sourceHash: string;
             typeImports: string[];
+            runtimeImports?: string[];
         };
     };
     payload: Record<string, unknown>;
@@ -3166,43 +3168,6 @@ declare const SDK_VERSION: string;
 /** @deprecated Transitional wire id for pre-major-header SDKs only. */
 declare const SDK_API_CONTRACT: string;
 
-/**
- * Base error class for all Deepline SDK errors.
- *
- * Every error thrown by the SDK extends this class, so you can catch all
- * Deepline-specific errors with a single `catch (e) { if (e instanceof DeeplineError) }`.
- *
- * @example
- * ```typescript
- * import { DeeplineClient, DeeplineError, AuthError } from 'deepline';
- *
- * const client = new DeeplineClient();
- * try {
- *   await client.executeTool('dropleads_search_people', { query: 'cto' });
- * } catch (err) {
- *   if (err instanceof AuthError) {
- *     console.error('Bad API key — run: deepline auth register');
- *   } else if (err instanceof DeeplineError) {
- *     console.error(`API error ${err.statusCode}: ${err.message}`);
- *   }
- * }
- * ```
- */
-declare class DeeplineError extends Error {
-    /** HTTP status code from the API response, if applicable. */
-    statusCode?: number | undefined;
-    /** Machine-readable error code (e.g. `'AUTH_ERROR'`, `'RATE_LIMIT'`, `'CONFIG_ERROR'`). */
-    code?: string | undefined;
-    /** Additional context from the API response body. */
-    details?: Record<string, unknown> | undefined;
-    constructor(message: string, 
-    /** HTTP status code from the API response, if applicable. */
-    statusCode?: number | undefined, 
-    /** Machine-readable error code (e.g. `'AUTH_ERROR'`, `'RATE_LIMIT'`, `'CONFIG_ERROR'`). */
-    code?: string | undefined, 
-    /** Additional context from the API response body. */
-    details?: Record<string, unknown> | undefined);
-}
 /**
  * Thrown when the API rejects the request due to an invalid or missing API key.
  *
@@ -3224,8 +3189,11 @@ declare class DeeplineError extends Error {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 090
  */
 declare class AuthError extends DeeplineError {
+    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
     constructor(message?: string);
 }
 /**
@@ -3250,12 +3218,53 @@ declare class AuthError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 100
  */
 declare class RateLimitError extends DeeplineError {
     /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
     retryAfterMs: number;
+    /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
     constructor(retryAfterMs?: number, message?: string);
 }
+/**
+ * Tool-specific 429 preserving both historical RateLimitError catches and the
+ * structured ToolExecutionError ontology. JavaScript has one prototype chain,
+ * so this class extends RateLimitError and carries ToolExecutionError's stable
+ * cross-bundle brand.
+ *
+ * This class appears in external SDK calls after HTTP 429 retries are
+ * exhausted. It also satisfies `instanceof ToolExecutionError` and, for a
+ * provider-owned rate limit, `instanceof ProviderTransientError`. Authored
+ * Plays should use `ProviderTransientError`; they do not need this
+ * compatibility class.
+ *
+ * @sdkReference errors 110
+ */
+declare class ToolRateLimitError extends RateLimitError {
+    /** Public tool id passed to `tools.execute`. */
+    readonly toolId: string;
+    /** Provider responsible for the operation, or `null`. */
+    readonly provider: string | null;
+    /** Provider operation name, or `null`. */
+    readonly operation: string | null;
+    /** Stable machine-readable failure code when one exists. */
+    readonly code: string | undefined;
+    /** Boundary responsible for the failure. */
+    readonly origin: ToolExecutionError['origin'];
+    /** Stable reason family for policy and diagnostics. */
+    readonly category: ToolExecutionError['category'];
+    /** Whether repeating the same semantic call is delivery-safe. */
+    readonly retryable: boolean;
+    /** Provider or Deepline request id, or `null`. */
+    readonly requestId: string | null;
+    /** Network failure kind, or `null` for non-network failures. */
+    readonly networkKind: ToolExecutionError['networkKind'];
+    /** Network boundary that failed, or `null` for non-network failures. */
+    readonly networkScope: ToolExecutionError['networkScope'];
+    /** Constructed by the SDK after a structured tool HTTP 429. */
+    constructor(message: string, options: ToolExecutionErrorOptions);
+}
 /**
  * Thrown when the SDK cannot resolve a valid configuration.
  *
@@ -3274,8 +3283,11 @@ declare class RateLimitError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 120
  */
 declare class ConfigError extends DeeplineError {
+    /** Construct a local SDK configuration failure. */
     constructor(message: string);
 }
 
@@ -3666,6 +3678,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             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>>> = {
@@ -3778,6 +3792,16 @@ type PlayBindings = {
      * older clients can continue to register revisions during the migration.
      */
     description?: string;
+    /**
+     * Public behavior that must remain pinned for this play artifact.
+     *
+     * New plays default to typed tool errors (`1`). Set `toolErrorSchemaVersion`
+     * to `0` only while migrating code that depends on legacy error names,
+     * messages, or classes.
+     */
+    compatibility?: {
+        toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion;
+    };
     /** Allow compilers to bundle this named handler directly without a child run. */
     inline?: boolean;
     /** Optional per-run billing controls enforced by the runtime. */
@@ -4352,7 +4376,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 140 ctx.runPlay(key, playRef, input, options)
      */
-    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: PlayCallOptions): Promise<TOutput>;
+    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options?: PlayCallOptions): Promise<TOutput>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.
      *
@@ -4599,6 +4623,8 @@ type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = {
     bindings?: PlayBindings;
     /** Billing options. */
     billing?: PlayBindings['billing'];
+    /** Runtime compatibility override. Omit for the current typed contract. */
+    compatibility?: PlayBindings['compatibility'];
 };
 declare function steps<TInput>(): StepProgram<TInput, TInput, TInput>;
 declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boolean | Promise<boolean>, resolver: StepResolver<Row, Value>): ConditionalStepResolver<Row, Value, null>;
@@ -4639,6 +4665,8 @@ declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boole
 type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & DeeplineNamedPlay<TInput, TOutput> & {
     /** Optional trigger bindings (cron, webhook). */
     readonly bindings?: PlayBindings;
+    /** Runtime compatibility explicitly selected by the author. */
+    readonly compatibility?: PlayBindings['compatibility'];
     /** The play's name (same as `.name`). */
     readonly playName: string;
 };
@@ -4648,6 +4676,7 @@ type PlayMetadata = {
     bindings?: PlayBindings;
     inputSchema?: Record<string, unknown>;
     billing?: PlayBindings['billing'];
+    compatibility?: PlayBindings['compatibility'];
 };
 /**
  * High-level SDK context with tool shortcuts and play handles.
@@ -5043,4 +5072,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, type IngestionStorageRepairResult, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, type IngestionStorageRepairResult, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };