deepline 0.3.50 → 0.3.52

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, D as DeeplineError, T as ToolExecutionError, i as ToolExecutionErrorOptions, 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 ToolExecuteResult, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringBindings, A as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, 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 } from './compiler-manifest-CbzdZrJj.js';
-export { S as DEEPLINE_EXTRACTOR_TARGETS, U as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, V as DeeplineEmailStatusGetterValue, W as DeeplineExtractorTarget, X as DeeplineGetterValue, Y as DeeplineGetterValueMap, Z as JOB_CHANGE_STATUS_VALUES, _ as JobChangeStatus, $ as PHONE_STATUS_VALUES, a0 as PhoneStatus, a1 as PlayDataset, a2 as PlayDatasetInput, a3 as PreviousCell, a4 as ProviderTransientError, a5 as ProviderTransientErrorCategory, a6 as ProviderUnavailableError, a7 as ProviderUnavailableReason, a8 as ToolExecutionErrorCategory, a9 as ToolExecutionErrorOrigin, aa as ToolExecutionFailureV1, ab as ToolExecutionNetworkKind, ac as ToolExecutionNetworkScope, ad as ToolExecutionPublicDetails, ae as getProviderUnavailableReason, af as isDeeplineExtractorTarget, ag as isProviderUnavailable, ah as isProviderWaterfallUnavailableError } from './compiler-manifest-CbzdZrJj.js';
+import { c as PlayCompilerManifest, 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 PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-B47AA7As.js';
+export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-B47AA7As.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -3842,153 +3842,6 @@ declare class DeeplineClient {
     }>;
 }
 
-/**
- * Bootstrap failure: this server/deployment cannot serve the subscription
- * transport. Callers fall back to the support-window SSE stream (ADR-0008).
- */
-declare class RunObserveTransportUnavailableError extends Error {
-    readonly reason: string;
-    constructor(message: string, reason: string);
-}
-
-declare const SDK_VERSION: string;
-/** @deprecated Transitional wire id for pre-major-header SDKs only. */
-declare const SDK_API_CONTRACT: string;
-
-/**
- * Thrown when the API rejects the request due to an invalid or missing API key.
- *
- * This maps to HTTP 401 responses. HTTP 403 means the caller was authenticated
- * but lacks permission, so the SDK preserves the server's API error instead.
- * The SDK never retries auth errors —
- * they fail immediately.
- *
- * Fix: run `deepline auth register` to obtain a valid key, or pass one via
- * the `apiKey` option or `DEEPLINE_API_KEY` environment variable.
- *
- * @example
- * ```typescript
- * import { AuthError } from 'deepline';
- *
- * try {
- *   await client.listTools();
- * } catch (err) {
- *   if (err instanceof AuthError) {
- *     // Redirect user to auth flow
- *   }
- * }
- * ```
- *
- * @sdkReference errors 090
- */
-declare class AuthError extends DeeplineError {
-    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
-    constructor(message?: string);
-}
-/**
- * Thrown when the API returns HTTP 429 (Too Many Requests).
- *
- * The SDK retries rate-limited requests automatically up to `maxRetries` times
- * with exponential backoff. This error is only thrown when all retries are exhausted.
- *
- * Use {@link RateLimitError.retryAfterMs} to implement your own backoff if needed.
- *
- * @example
- * ```typescript
- * import { RateLimitError } from 'deepline';
- *
- * try {
- *   await client.executeTool('dropleads_search_people', { query: 'cto' });
- * } catch (err) {
- *   if (err instanceof RateLimitError) {
- *     console.log(`Retry after ${err.retryAfterMs}ms`);
- *     await sleep(err.retryAfterMs);
- *     // retry...
- *   }
- * }
- * ```
- *
- * @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'];
-    /** Explicitly allowlisted diagnostics safe for SDK callers. */
-    readonly publicDetails: ToolExecutionError['publicDetails'];
-    /** Constructed by the SDK after a structured tool HTTP 429. */
-    constructor(message: string, options: ToolExecutionErrorOptions);
-}
-/**
- * Thrown when the SDK cannot resolve a valid configuration.
- *
- * Most commonly: no API key found in any of the resolution sources
- * (explicit option, environment variable, CLI env files).
- *
- * @example
- * ```typescript
- * import { ConfigError } from 'deepline';
- *
- * try {
- *   const client = new DeeplineClient();
- * } catch (err) {
- *   if (err instanceof ConfigError) {
- *     console.error('Run: deepline auth register');
- *   }
- * }
- * ```
- *
- * @sdkReference errors 120
- */
-declare class ConfigError extends DeeplineError {
-    /** Construct a local SDK configuration failure. */
-    constructor(message: string);
-}
-
-/** Production API base URL. */
-declare const PROD_URL = "https://code.deepline.com";
-/**
- * Resolve SDK configuration from the public SDK CLI env contract.
- */
-declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
-
 type PlayCallExecution = PlayAuthoringCallExecution;
 type PlayCallOptions = PlayAuthoringCallOptions;
 type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
@@ -4680,6 +4533,153 @@ declare const defineWorkflow: typeof definePlay;
  */
 declare function getDefinedPlayMetadata(value: unknown): PlayMetadata | null;
 
+/**
+ * Bootstrap failure: this server/deployment cannot serve the subscription
+ * transport. Callers fall back to the support-window SSE stream (ADR-0008).
+ */
+declare class RunObserveTransportUnavailableError extends Error {
+    readonly reason: string;
+    constructor(message: string, reason: string);
+}
+
+declare const SDK_VERSION: string;
+/** @deprecated Transitional wire id for pre-major-header SDKs only. */
+declare const SDK_API_CONTRACT: string;
+
+/**
+ * Thrown when the API rejects the request due to an invalid or missing API key.
+ *
+ * This maps to HTTP 401 responses. HTTP 403 means the caller was authenticated
+ * but lacks permission, so the SDK preserves the server's API error instead.
+ * The SDK never retries auth errors —
+ * they fail immediately.
+ *
+ * Fix: run `deepline auth register` to obtain a valid key, or pass one via
+ * the `apiKey` option or `DEEPLINE_API_KEY` environment variable.
+ *
+ * @example
+ * ```typescript
+ * import { AuthError } from 'deepline';
+ *
+ * try {
+ *   await client.listTools();
+ * } catch (err) {
+ *   if (err instanceof AuthError) {
+ *     // Redirect user to auth flow
+ *   }
+ * }
+ * ```
+ *
+ * @sdkReference errors 090
+ */
+declare class AuthError extends DeeplineError {
+    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
+    constructor(message?: string);
+}
+/**
+ * Thrown when the API returns HTTP 429 (Too Many Requests).
+ *
+ * The SDK retries rate-limited requests automatically up to `maxRetries` times
+ * with exponential backoff. This error is only thrown when all retries are exhausted.
+ *
+ * Use {@link RateLimitError.retryAfterMs} to implement your own backoff if needed.
+ *
+ * @example
+ * ```typescript
+ * import { RateLimitError } from 'deepline';
+ *
+ * try {
+ *   await client.executeTool('dropleads_search_people', { query: 'cto' });
+ * } catch (err) {
+ *   if (err instanceof RateLimitError) {
+ *     console.log(`Retry after ${err.retryAfterMs}ms`);
+ *     await sleep(err.retryAfterMs);
+ *     // retry...
+ *   }
+ * }
+ * ```
+ *
+ * @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'];
+    /** Explicitly allowlisted diagnostics safe for SDK callers. */
+    readonly publicDetails: ToolExecutionError['publicDetails'];
+    /** Constructed by the SDK after a structured tool HTTP 429. */
+    constructor(message: string, options: ToolExecutionErrorOptions);
+}
+/**
+ * Thrown when the SDK cannot resolve a valid configuration.
+ *
+ * Most commonly: no API key found in any of the resolution sources
+ * (explicit option, environment variable, CLI env files).
+ *
+ * @example
+ * ```typescript
+ * import { ConfigError } from 'deepline';
+ *
+ * try {
+ *   const client = new DeeplineClient();
+ * } catch (err) {
+ *   if (err instanceof ConfigError) {
+ *     console.error('Run: deepline auth register');
+ *   }
+ * }
+ * ```
+ *
+ * @sdkReference errors 120
+ */
+declare class ConfigError extends DeeplineError {
+    /** Construct a local SDK configuration failure. */
+    constructor(message: string);
+}
+
+/** Production API base URL. */
+declare const PROD_URL = "https://code.deepline.com";
+/**
+ * Resolve SDK configuration from the public SDK CLI env contract.
+ */
+declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
+
 /**
  * Result of converting a tool response to a list of records.
  *