deepline 0.1.108 → 0.1.110

package/dist/index.d.mts

@@ -353,9 +353,9 @@ interface ToolPricingSummary {
  * schema, examples, pricing, and extraction guidance before executing.
  */
 interface ToolDefinition {
-    /** Unique tool identifier used in API calls (e.g. `"apollo_people_search"`). */
+    /** Unique tool identifier used in API calls (e.g. `"dropleads_search_people"`). */
     toolId: string;
-    /** Provider that backs this tool (e.g. `"apollo"`, `"hunter"`, `"test"`). */
+    /** Provider that backs this tool (e.g. `"hunter"`, `"dropleads"`, `"test"`). */
     provider: string;
     /** Human-readable name for display. */
     displayName: string;
@@ -369,6 +369,8 @@ interface ToolDefinition {
     operationId?: string;
     /** Alternative names that resolve to this tool. */
     operationAliases?: string[];
+    /** Explicit globally runnable play reference for play-backed catalog entries. */
+    playReference?: `prebuilt/${string}`;
     /** Whether detailed input schema is available from `tools describe`. */
     hasInputSchema?: boolean;
     /** Whether detailed output schema is available from `tools describe`. */
@@ -515,8 +517,8 @@ interface ToolSearchResult {
  *
  * @example
  * ```typescript
- * const meta = await client.getTool('apollo_people_search');
- * console.log(meta.displayName);              // "Apollo People Search"
+ * const meta = await client.getTool('dropleads_search_people');
+ * console.log(meta.displayName);              // "DropLeads People Search"
  * console.log(meta.estimatedCreditsRange);     // "1-5"
  * console.log(meta.samples);                   // { input: {...}, output: {...} }
  * ```
@@ -1101,8 +1103,9 @@ interface StartPlayRunRequest {
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**
-     * Per-run execution profile override. The server defaults to `workers_edge`;
-     * tests can pass `local` here. Most callers should leave this unset.
+     * Per-run execution profile override. The server defaults to workers_edge;
+     * tests and runtime probes can pass a different profile here. Most callers
+     * should leave this unset.
      */
     profile?: string;
 }
@@ -1462,10 +1465,12 @@ type BillingPlanEntry = {
     acquirable: boolean;
 };
 /** One usage metric published in the billing catalog. */
-type BillingMetricEntry = {
+type BillingMeterEntry = {
     id: string;
     name: string;
 };
+/** @deprecated Use BillingMeterEntry. Retained for wire/API alias compatibility. */
+type BillingMetricEntry = BillingMeterEntry;
 /** The caller's active plan as reported by the plans endpoint. */
 type BillingActivePlan = {
     plan_family_id: string;
@@ -1487,6 +1492,8 @@ type BillingPlansResult = {
     catalog_version: string;
     active_plan: BillingActivePlan;
     plans: BillingPlanEntry[];
+    meters: BillingMeterEntry[];
+    /** @deprecated Use meters. Retained for installed SDK compatibility. */
     metrics: BillingMetricEntry[];
 };
 /**
@@ -1610,12 +1617,12 @@ declare class DeeplineClient {
      * Returns everything from {@link ToolDefinition} plus pricing info, sample
      * inputs/outputs, failure modes, and cost estimates.
      *
-     * @param toolId - Tool identifier (e.g. `"apollo_people_search"`)
+     * @param toolId - Tool identifier (e.g. `"dropleads_search_people"`)
      * @returns Full tool metadata
      *
      * @example
      * ```typescript
-     * const meta = await client.getTool('apollo_people_search');
+     * const meta = await client.getTool('dropleads_search_people');
      * console.log(`Cost: ${meta.estimatedCreditsRange} credits`);
      * console.log(`Input schema:`, meta.inputSchema);
      * ```
@@ -2362,7 +2369,7 @@ declare const SDK_API_CONTRACT: string;
  *
  * const client = new DeeplineClient();
  * try {
- *   await client.executeTool('apollo_people_search', { query: 'cto' });
+ *   await client.executeTool('dropleads_search_people', { query: 'cto' });
  * } catch (err) {
  *   if (err instanceof AuthError) {
  *     console.error('Bad API key — run: deepline auth register');
@@ -2425,7 +2432,7 @@ declare class AuthError extends DeeplineError {
  * import { RateLimitError } from 'deepline';
  *
  * try {
- *   await client.executeTool('apollo_people_search', { query: 'cto' });
+ *   await client.executeTool('dropleads_search_people', { query: 'cto' });
  * } catch (err) {
  *   if (err instanceof RateLimitError) {
  *     console.log(`Retry after ${err.retryAfterMs}ms`);
@@ -2940,6 +2947,8 @@ type PlayBindings = {
         /** IANA timezone (e.g. `'America/New_York'`). Defaults to UTC. */
         timezone?: string;
     };
+    /** Customer DB row-change listeners that wake this play when published. */
+    sqlListeners?: SqlListenerDeclaration[];
     /**
      * Customer-authored play secrets this play is allowed to use at runtime.
      * Values are never bundled or exposed by the SDK; access them with
@@ -2948,6 +2957,51 @@ type PlayBindings = {
      */
     secrets?: readonly string[];
 };
+type SqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
+type SqlListenerFilterScalar = string | number | boolean | null;
+type SqlListenerFilterOperator = {
+    eq?: SqlListenerFilterScalar;
+    neq?: SqlListenerFilterScalar;
+    in?: SqlListenerFilterScalar[];
+    notIn?: SqlListenerFilterScalar[];
+    isNull?: true;
+    isNotNull?: true;
+    ilike?: string;
+};
+type SqlListenerWhere = {
+    before?: Record<string, SqlListenerFilterOperator>;
+    after?: Record<string, SqlListenerFilterOperator>;
+};
+type SqlListenerDeclaration = {
+    /** Short id unique inside this play. Deepline stores it as playName.id. */
+    id: string;
+    /** Modeled monitor tool id, for example "tamradar.company_radar". */
+    tool: string;
+    /** Stream key exposed by the modeled monitor tool, for example "company_job_openings". */
+    stream: string;
+    /** Row operations that should wake this play. Defaults to INSERT and UPDATE. */
+    operations?: SqlListenerOperation[];
+    /** Optional DB-side row filter over top-level before/after fields. */
+    where?: SqlListenerWhere;
+};
+type SqlListenerEvent<T extends object = Record<string, unknown>> = {
+    tool: string;
+    stream: string;
+    operation: SqlListenerOperation;
+    before: T | null;
+    after: T | null;
+    changedAt: string;
+    metadata: {
+        outboxId: string;
+        listenerId: string;
+        table: string;
+    };
+};
+type SqlQuery = {
+    readonly kind: 'sql.query';
+    readonly text: string;
+    readonly values: readonly unknown[];
+};
 declare const SECRET_HANDLE_BRAND: unique symbol;
 type SecretHandle = {
     readonly [SECRET_HANDLE_BRAND]: never;
@@ -3092,6 +3146,7 @@ type PlayStepProgramStep = {
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;
 type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;
+type RunnableStepProgram<TInput, TOutput> = Pick<StepProgram<TInput, never, TOutput>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;
 /**
  * Builder returned by `ctx.dataset(...)` for row-level durable columns.
  *
@@ -3335,6 +3390,13 @@ interface DeeplinePlayRuntimeContext {
          */
         execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
     };
+    /** Customer DB query namespace for play handlers. */
+    customerDb: {
+        query<TRow extends object = Record<string, unknown>>(statement: SqlQuery | string, options?: {
+            maxRows?: number;
+            timeoutMs?: number;
+        }): Promise<TRow[]>;
+    };
     /**
      * Execute a single tool by stable step key and tool ID.
      *
@@ -3359,7 +3421,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, unknown, TOutput>, input: TInput, options?: {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
     /**
@@ -3434,7 +3496,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: {
-        description?: string;
+        description: string;
         staleAfterSeconds?: number;
     }): Promise<TOutput>;
     /**
@@ -3592,6 +3654,7 @@ interface DeeplineNamedPlay<TInput = Record<string, unknown>, TOutput = unknown>
      */
     run(input: TInput, options?: {
         revisionId?: string;
+        profile?: string;
     }): Promise<PlayJob<TOutput>>;
     /**
      * Run this play and wait for completion.
@@ -3603,6 +3666,7 @@ interface DeeplineNamedPlay<TInput = Record<string, unknown>, TOutput = unknown>
      */
     runSync(input: TInput, options?: {
         revisionId?: string;
+        profile?: string;
     }): Promise<TOutput>;
 }
 /**
@@ -3762,7 +3826,7 @@ declare class DeeplineContext {
      * @example
      * ```typescript
      * const tools = await deepline.tools.list();
-     * const meta = await deepline.tools.get('apollo_people_search');
+     * const meta = await deepline.tools.get('dropleads_search_people');
      * const companyLookup = await deepline.tools.execute('test_company_search', { domain: 'stripe.com' });
      * const company = companyLookup.toolResponse.raw;
      * ```
@@ -4023,8 +4087,8 @@ type Scalar = string | number | boolean | null;
  *
  * @example Using configured paths (from tool metadata)
  * ```typescript
- * const meta = await client.getTool('apollo_people_search');
- * const result = await client.executeTool('apollo_people_search', { query: 'cto' });
+ * const meta = await client.getTool('dropleads_search_people');
+ * const result = await client.executeTool('dropleads_search_people', { query: 'cto' });
  *
  * const list = tryConvertToList(result, {
  *   listExtractorPaths: meta.listExtractorPaths,
@@ -4115,4 +4179,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 BillingSubscriptionCancelResult, type BillingSubscriptionStatus, 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, 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, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, 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 StaleAfterSeconds, 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, 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 BillingSubscriptionCancelResult, type BillingSubscriptionStatus, 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, 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, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, 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 StaleAfterSeconds, 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, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -353,9 +353,9 @@ interface ToolPricingSummary {
  * schema, examples, pricing, and extraction guidance before executing.
  */
 interface ToolDefinition {
-    /** Unique tool identifier used in API calls (e.g. `"apollo_people_search"`). */
+    /** Unique tool identifier used in API calls (e.g. `"dropleads_search_people"`). */
     toolId: string;
-    /** Provider that backs this tool (e.g. `"apollo"`, `"hunter"`, `"test"`). */
+    /** Provider that backs this tool (e.g. `"hunter"`, `"dropleads"`, `"test"`). */
     provider: string;
     /** Human-readable name for display. */
     displayName: string;
@@ -369,6 +369,8 @@ interface ToolDefinition {
     operationId?: string;
     /** Alternative names that resolve to this tool. */
     operationAliases?: string[];
+    /** Explicit globally runnable play reference for play-backed catalog entries. */
+    playReference?: `prebuilt/${string}`;
     /** Whether detailed input schema is available from `tools describe`. */
     hasInputSchema?: boolean;
     /** Whether detailed output schema is available from `tools describe`. */
@@ -515,8 +517,8 @@ interface ToolSearchResult {
  *
  * @example
  * ```typescript
- * const meta = await client.getTool('apollo_people_search');
- * console.log(meta.displayName);              // "Apollo People Search"
+ * const meta = await client.getTool('dropleads_search_people');
+ * console.log(meta.displayName);              // "DropLeads People Search"
  * console.log(meta.estimatedCreditsRange);     // "1-5"
  * console.log(meta.samples);                   // { input: {...}, output: {...} }
  * ```
@@ -1101,8 +1103,9 @@ interface StartPlayRunRequest {
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**
-     * Per-run execution profile override. The server defaults to `workers_edge`;
-     * tests can pass `local` here. Most callers should leave this unset.
+     * Per-run execution profile override. The server defaults to workers_edge;
+     * tests and runtime probes can pass a different profile here. Most callers
+     * should leave this unset.
      */
     profile?: string;
 }
@@ -1462,10 +1465,12 @@ type BillingPlanEntry = {
     acquirable: boolean;
 };
 /** One usage metric published in the billing catalog. */
-type BillingMetricEntry = {
+type BillingMeterEntry = {
     id: string;
     name: string;
 };
+/** @deprecated Use BillingMeterEntry. Retained for wire/API alias compatibility. */
+type BillingMetricEntry = BillingMeterEntry;
 /** The caller's active plan as reported by the plans endpoint. */
 type BillingActivePlan = {
     plan_family_id: string;
@@ -1487,6 +1492,8 @@ type BillingPlansResult = {
     catalog_version: string;
     active_plan: BillingActivePlan;
     plans: BillingPlanEntry[];
+    meters: BillingMeterEntry[];
+    /** @deprecated Use meters. Retained for installed SDK compatibility. */
     metrics: BillingMetricEntry[];
 };
 /**
@@ -1610,12 +1617,12 @@ declare class DeeplineClient {
      * Returns everything from {@link ToolDefinition} plus pricing info, sample
      * inputs/outputs, failure modes, and cost estimates.
      *
-     * @param toolId - Tool identifier (e.g. `"apollo_people_search"`)
+     * @param toolId - Tool identifier (e.g. `"dropleads_search_people"`)
      * @returns Full tool metadata
      *
      * @example
      * ```typescript
-     * const meta = await client.getTool('apollo_people_search');
+     * const meta = await client.getTool('dropleads_search_people');
      * console.log(`Cost: ${meta.estimatedCreditsRange} credits`);
      * console.log(`Input schema:`, meta.inputSchema);
      * ```
@@ -2362,7 +2369,7 @@ declare const SDK_API_CONTRACT: string;
  *
  * const client = new DeeplineClient();
  * try {
- *   await client.executeTool('apollo_people_search', { query: 'cto' });
+ *   await client.executeTool('dropleads_search_people', { query: 'cto' });
  * } catch (err) {
  *   if (err instanceof AuthError) {
  *     console.error('Bad API key — run: deepline auth register');
@@ -2425,7 +2432,7 @@ declare class AuthError extends DeeplineError {
  * import { RateLimitError } from 'deepline';
  *
  * try {
- *   await client.executeTool('apollo_people_search', { query: 'cto' });
+ *   await client.executeTool('dropleads_search_people', { query: 'cto' });
  * } catch (err) {
  *   if (err instanceof RateLimitError) {
  *     console.log(`Retry after ${err.retryAfterMs}ms`);
@@ -2940,6 +2947,8 @@ type PlayBindings = {
         /** IANA timezone (e.g. `'America/New_York'`). Defaults to UTC. */
         timezone?: string;
     };
+    /** Customer DB row-change listeners that wake this play when published. */
+    sqlListeners?: SqlListenerDeclaration[];
     /**
      * Customer-authored play secrets this play is allowed to use at runtime.
      * Values are never bundled or exposed by the SDK; access them with
@@ -2948,6 +2957,51 @@ type PlayBindings = {
      */
     secrets?: readonly string[];
 };
+type SqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
+type SqlListenerFilterScalar = string | number | boolean | null;
+type SqlListenerFilterOperator = {
+    eq?: SqlListenerFilterScalar;
+    neq?: SqlListenerFilterScalar;
+    in?: SqlListenerFilterScalar[];
+    notIn?: SqlListenerFilterScalar[];
+    isNull?: true;
+    isNotNull?: true;
+    ilike?: string;
+};
+type SqlListenerWhere = {
+    before?: Record<string, SqlListenerFilterOperator>;
+    after?: Record<string, SqlListenerFilterOperator>;
+};
+type SqlListenerDeclaration = {
+    /** Short id unique inside this play. Deepline stores it as playName.id. */
+    id: string;
+    /** Modeled monitor tool id, for example "tamradar.company_radar". */
+    tool: string;
+    /** Stream key exposed by the modeled monitor tool, for example "company_job_openings". */
+    stream: string;
+    /** Row operations that should wake this play. Defaults to INSERT and UPDATE. */
+    operations?: SqlListenerOperation[];
+    /** Optional DB-side row filter over top-level before/after fields. */
+    where?: SqlListenerWhere;
+};
+type SqlListenerEvent<T extends object = Record<string, unknown>> = {
+    tool: string;
+    stream: string;
+    operation: SqlListenerOperation;
+    before: T | null;
+    after: T | null;
+    changedAt: string;
+    metadata: {
+        outboxId: string;
+        listenerId: string;
+        table: string;
+    };
+};
+type SqlQuery = {
+    readonly kind: 'sql.query';
+    readonly text: string;
+    readonly values: readonly unknown[];
+};
 declare const SECRET_HANDLE_BRAND: unique symbol;
 type SecretHandle = {
     readonly [SECRET_HANDLE_BRAND]: never;
@@ -3092,6 +3146,7 @@ type PlayStepProgramStep = {
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;
 type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;
+type RunnableStepProgram<TInput, TOutput> = Pick<StepProgram<TInput, never, TOutput>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;
 /**
  * Builder returned by `ctx.dataset(...)` for row-level durable columns.
  *
@@ -3335,6 +3390,13 @@ interface DeeplinePlayRuntimeContext {
          */
         execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
     };
+    /** Customer DB query namespace for play handlers. */
+    customerDb: {
+        query<TRow extends object = Record<string, unknown>>(statement: SqlQuery | string, options?: {
+            maxRows?: number;
+            timeoutMs?: number;
+        }): Promise<TRow[]>;
+    };
     /**
      * Execute a single tool by stable step key and tool ID.
      *
@@ -3359,7 +3421,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, unknown, TOutput>, input: TInput, options?: {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
     /**
@@ -3434,7 +3496,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: {
-        description?: string;
+        description: string;
         staleAfterSeconds?: number;
     }): Promise<TOutput>;
     /**
@@ -3592,6 +3654,7 @@ interface DeeplineNamedPlay<TInput = Record<string, unknown>, TOutput = unknown>
      */
     run(input: TInput, options?: {
         revisionId?: string;
+        profile?: string;
     }): Promise<PlayJob<TOutput>>;
     /**
      * Run this play and wait for completion.
@@ -3603,6 +3666,7 @@ interface DeeplineNamedPlay<TInput = Record<string, unknown>, TOutput = unknown>
      */
     runSync(input: TInput, options?: {
         revisionId?: string;
+        profile?: string;
     }): Promise<TOutput>;
 }
 /**
@@ -3762,7 +3826,7 @@ declare class DeeplineContext {
      * @example
      * ```typescript
      * const tools = await deepline.tools.list();
-     * const meta = await deepline.tools.get('apollo_people_search');
+     * const meta = await deepline.tools.get('dropleads_search_people');
      * const companyLookup = await deepline.tools.execute('test_company_search', { domain: 'stripe.com' });
      * const company = companyLookup.toolResponse.raw;
      * ```
@@ -4023,8 +4087,8 @@ type Scalar = string | number | boolean | null;
  *
  * @example Using configured paths (from tool metadata)
  * ```typescript
- * const meta = await client.getTool('apollo_people_search');
- * const result = await client.executeTool('apollo_people_search', { query: 'cto' });
+ * const meta = await client.getTool('dropleads_search_people');
+ * const result = await client.executeTool('dropleads_search_people', { query: 'cto' });
  *
  * const list = tryConvertToList(result, {
  *   listExtractorPaths: meta.listExtractorPaths,
@@ -4115,4 +4179,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 BillingSubscriptionCancelResult, type BillingSubscriptionStatus, 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, 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, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, 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 StaleAfterSeconds, 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, 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 BillingSubscriptionCancelResult, type BillingSubscriptionStatus, 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, 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, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, 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 StaleAfterSeconds, 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, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };