deepline 0.3.422 → 0.3.424

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /// <reference path="./text-imports.d.ts" />
-import { i as PlayAuthoringFetchResponse, T as ToolExecuteResult, B as BasicToolExecuteResult, j as PlayDataset, A as AsyncPlayRunRef$1, k as PlayAuthoringColumnMap, l as PlayAuthoringColumnResolver, m as PlayAuthoringRuntimeContext, n as PlayAuthoringConditionalStepResolver, o as PlayAuthoringCsvInput, p as PlayAuthoringCsvOptions, q as PlayAuthoringDatasetBuilder, r as PlayAuthoringDatasetColumnDefinition, s as PlayAuthoringDatasetColumnRunInput, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringAsyncCallOptions, C as PlayAuthoringBindings, D as PlayAuthoringCallExecution, E as PlayAuthoringCallOptions, F as PlayAuthoringInputContract, G as PlayRunId$1, H as PlayAuthoringStepProgramStep, I as PlayAuthoringRuntimeStepOptions, J as PlaySqlListenerDeclaration, K as PlaySqlListenerEvent, L as PlaySqlListenerOperation, M as PlaySqlQuery, N as PlayAuthoringStepOptions, O as PlayAuthoringStepProgram, Q as PlayAuthoringStepProgramResolver, R as PlayAuthoringStepResolver, S as PlayToolExecutionRequest, U as PlayAuthoringStepProgramOptions, V as DeeplineError, W as ToolExecutionError, X as ToolExecutionErrorOptions } from './compiler-manifest-lzWpbV3w.js';
-export { Y as BillingEntitlements, Z as DEEPLINE_EXTRACTOR_TARGETS, _ as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, $ as DeeplineEmailStatusGetterValue, a0 as DeeplineExtractorTarget, a1 as DeeplineGetterValue, a2 as DeeplineGetterValueMap, a3 as JOB_CHANGE_STATUS_VALUES, a4 as JobChangeStatus, a5 as PHONE_STATUS_VALUES, a6 as PhoneStatus, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as ToolResultBilling, ak as getProviderUnavailableReason, al as isDeeplineExtractorTarget, am as isProviderUnavailable, an as isProviderWaterfallUnavailableError } from './compiler-manifest-lzWpbV3w.js';
-import { b as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, c as ToolMetadata, E as ExecuteToolRawOptions, d as ExecutionRecovery, e as ExecutionByKeyResult, f as PlayListItem, g as PlayDetail, h as PlayRunListItem, i as PlayRevisionSummary, j as PublishPlayVersionResult, C as ClearPlayHistoryResult, k as PlayStatus, l as StopPlayRunResult, a as DeeplineClient, R as ResolvedConfig } from './client-vHqBm-OL.js';
-export { m as BillingCreditPool, n as BillingInvoiceEntry, o as BillingInvoicesResult, p as BillingPaymentMethodSummary, q as BillingQuoteRequest, r as BillingQuoteResult, s as BillingRecentUsageEntry, t as BillingSubscriptionCancelResult, u as BillingSubscriptionStatus, v as BillingTopUpReceipt, w as BillingTopUpResult, x as BillingUsageEvent, y as BillingUsageOptions, z as BillingUsageResult, A as ChildRunSummary, F as ClearPlayHistoryRequest, G as CreateNotificationGroupInput, H as CreateNotificationGroupResult, I as CustomerDbQueryOptions, J as CustomerDbQueryPlan, K as CustomerDbQueryResult, L as DEEPLINE_TOOL_CATEGORIES, M as DbNamespace, N as DeeplineToolCategory, O as IngestionStorageRepairResult, Q as LegacyMonitorStatusFilter, U as LiveEventEnvelope, V as MONITOR_JOB_PHASES, W as MONITOR_JOB_RECONCILIATION_STATES, X as MONITOR_JOB_STATES, Y as MonitorBatchNamespace, Z as MonitorCheckResult, _ as MonitorDefinition, $ as MonitorDeleteResult, a0 as MonitorDependents, a1 as MonitorDeployResult, a2 as MonitorDetail, a3 as MonitorFleetDeactivateOptions, a4 as MonitorFleetGetOptions, a5 as MonitorFleetReactivateOptions, a6 as MonitorFleetResult, a7 as MonitorFleetStatus, a8 as MonitorFleetSyncOptions, a9 as MonitorFleetWaitOptions, aa as MonitorFleetsNamespace, ab as MonitorJobDeployOptions, ac as MonitorJobLogsOptions, ad as MonitorJobPhase, ae as MonitorJobReconciliationState, af as MonitorJobResult, ag as MonitorJobState, ah as MonitorJobWaitOptions, ai as MonitorJobsNamespace, aj as MonitorListEntry, ak as MonitorPayload, al as MonitorReactivateResult, am as MonitorSpec, an as MonitorState, ao as MonitorStateFilter, ap as MonitorUpdateChangeSummary, aq as MonitorUpdateResult, ar as MonitorsAccessStatus, as as MonitorsAvailableOptions, at as MonitorsAvailableResult, au as MonitorsListOptions, av as MonitorsListResult, aw as MonitorsNamespace, ax as NormalizedRunEventQuery, ay as PlayActivityObservation, az as PlayActivityState, aA as PlayActivityTarget, aB as PlayCostEstimate, aC as PlayCronTriggerConfig, aD as PlayDescriptionOptions, aE as PlayLiveEvent, aF as PlayPath, aG as PlayRunActionPackage, aH as PlayRunActivityProjection, aI as PlayRunDatasetActions, aJ as PlayRunPackage, aK as PlayRunResult, aL as PlayRunRowHistoryOptions, aM as PlayRunStart, aN as PlaySettings, aO as PlaySettingsPatch, aP as PlaySettingsPathsPage, aQ as PlaySettingsResult, aR as PlaySheetRow, aS as PlaySheetRowsResult, aT as PlayTriggerConfigUpdate, aU as PlayTriggerConfigUpdateResult, aV as PlayTriggerConfigView, aW as PlayWebhookAuthConfig, aX as PlayWebhookTriggerConfig, aY as PlaysActivityResponse, aZ as PlaysListOptions, a_ as PlaysListPage, a$ as PublishPlayVersionRequest, b0 as RerunOptions, b1 as RerunPlayRunResult, b2 as RunChildrenPage, b3 as RunEventCountResult, b4 as RunEventField, b5 as RunEventFieldDescriptor, b6 as RunEventFieldOperators, b7 as RunEventFieldsResult, b8 as RunEventGroupValue, b9 as RunEventMeasure, ba as RunEventQueryCriteria, bb as RunEventQueryEvent, bc as RunEventQueryInputError, bd as RunEventQueryOptions, be as RunEventQueryPage, bf as RunEventQueryRetention, bg as RunEventScalar, bh as RunEventSummaryOptions, bi as RunEventSummaryResult, bj as RunEventWhere, bk as RunLifecycleStatus, bl as RunToolReceiptResult, bm as RunToolReceiptsResponse, bn as RunsChildrenOptions, bo as RunsEventPayload, bp as RunsEventSearchEntry, bq as RunsEventSearchOptions, br as RunsEventSearchResult, bs as RunsEventsCountResult, bt as RunsEventsCriteria, bu as RunsEventsFieldsOptions, bv as RunsEventsListOptions, bw as RunsEventsListResult, bx as RunsEventsNamespace, by as RunsEventsSummaryOptions, bz as RunsEventsSummaryResult, bA as RunsHistoryItem, bB as RunsHistoryOptions, bC as RunsHistoryPage, bD as RunsListOptions, bE as RunsListPage, bF as RunsLogCriteria, bG as RunsLogsCountResult, bH as RunsLogsNamespace, bI as RunsLogsOptions, bJ as RunsLogsQueryOptions, bK as RunsLogsQueryResult, bL as RunsLogsResult, bM as RunsLogsSummaryOptions, bN as RunsLogsSummaryResult, bO as RunsNamespace, bP as RunsTailOptions, bQ as RunsWatchOptions, bR as SearchOptions, bS as SearchResult, bT as SearchResultItem, S as SearchType, bU as StartPlayRunRequest, bV as StopAllCandidate, bW as StopAllPlayRunsDryRunResult, bX as StopAllPlayRunsResult, bY as StopAllPlayRunsStopResult, bZ as StopAllRunsOptions, b_ as ToolCategoryListing, b$ as ToolCategorySummary, c0 as ToolExecution, c1 as ToolRequestCondition, c2 as ToolRequestWarningRule, c3 as ToolSearchOptions, c4 as ToolSearchResult, c5 as WorkspaceCreateResult, c6 as WorkspacesNamespace, c7 as defineMonitor, c8 as isStopAllPlayRunsDryRunResult, c9 as planCustomerDbQuery } from './client-vHqBm-OL.js';
-import { b as BundledPlayFileSuccess } from './index-C8Cy-YTm.js';
+import { i as PlayAuthoringFetchResponse, T as ToolExecuteResult, B as BasicToolExecuteResult, j as PlayDataset, A as AsyncPlayRunRef$1, k as PlayAuthoringColumnMap, l as PlayAuthoringColumnResolver, m as PlayAuthoringRuntimeContext, n as PlayAuthoringConditionalStepResolver, o as PlayAuthoringCsvInput, p as PlayAuthoringCsvOptions, q as PlayAuthoringDatasetBuilder, r as PlayAuthoringDatasetColumnDefinition, s as PlayAuthoringDatasetColumnRunInput, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringAsyncCallOptions, C as PlayAuthoringBindings, D as PlayAuthoringCallExecution, E as PlayAuthoringCallOptions, F as PlayAuthoringInputContract, G as PlayRunId$1, H as PlayAuthoringStepProgramStep, I as PlayAuthoringRuntimeStepOptions, J as PlaySqlListenerDeclaration, K as PlaySqlListenerEvent, L as PlaySqlListenerOperation, M as PlaySqlQuery, N as PlayAuthoringStepOptions, O as PlayAuthoringStepProgram, Q as PlayAuthoringStepProgramResolver, R as PlayAuthoringStepResolver, S as PlayToolExecutionRequest, U as PlayAuthoringStepProgramOptions, V as DeeplineError, W as ToolExecutionError, X as ToolExecutionErrorOptions } from './compiler-manifest-DaFuA1ki.js';
+export { Y as BillingEntitlements, Z as DEEPLINE_EXTRACTOR_TARGETS, _ as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, $ as DeeplineEmailStatusGetterValue, a0 as DeeplineExtractorTarget, a1 as DeeplineGetterValue, a2 as DeeplineGetterValueMap, a3 as JOB_CHANGE_STATUS_VALUES, a4 as JobChangeStatus, a5 as PHONE_STATUS_VALUES, a6 as PhoneStatus, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as ToolResultBilling, ak as getProviderUnavailableReason, al as isDeeplineExtractorTarget, am as isProviderUnavailable, an as isProviderWaterfallUnavailableError } from './compiler-manifest-DaFuA1ki.js';
+import { b as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, c as ToolMetadata, E as ExecuteToolRawOptions, d as ExecutionRecovery, e as ExecutionByKeyResult, f as PlayListItem, g as PlayDetail, h as PlayRunListItem, i as PlayRevisionSummary, j as PublishPlayVersionResult, C as ClearPlayHistoryResult, k as PlayStatus, l as StopPlayRunResult, a as DeeplineClient, R as ResolvedConfig } from './client-DH-fmT69.js';
+export { m as BillingCreditPool, n as BillingInvoiceEntry, o as BillingInvoicesResult, p as BillingPaymentMethodSummary, q as BillingQuoteRequest, r as BillingQuoteResult, s as BillingRecentUsageEntry, t as BillingSubscriptionCancelResult, u as BillingSubscriptionStatus, v as BillingTopUpReceipt, w as BillingTopUpResult, x as BillingUsageEvent, y as BillingUsageOptions, z as BillingUsageResult, A as ChildRunSummary, F as ClearPlayHistoryRequest, G as CreateNotificationGroupInput, H as CreateNotificationGroupResult, I as CustomerDbQueryOptions, J as CustomerDbQueryPlan, K as CustomerDbQueryResult, L as DEEPLINE_TOOL_CATEGORIES, M as DbNamespace, N as DeeplineToolCategory, O as IngestionStorageRepairResult, Q as LegacyMonitorStatusFilter, U as LiveEventEnvelope, V as MONITOR_JOB_PHASES, W as MONITOR_JOB_RECONCILIATION_STATES, X as MONITOR_JOB_STATES, Y as MonitorBatchNamespace, Z as MonitorCheckResult, _ as MonitorDefinition, $ as MonitorDeleteResult, a0 as MonitorDependents, a1 as MonitorDeployResult, a2 as MonitorDetail, a3 as MonitorFleetDeactivateOptions, a4 as MonitorFleetGetOptions, a5 as MonitorFleetReactivateOptions, a6 as MonitorFleetResult, a7 as MonitorFleetStatus, a8 as MonitorFleetSyncOptions, a9 as MonitorFleetWaitOptions, aa as MonitorFleetsNamespace, ab as MonitorJobDeployOptions, ac as MonitorJobLogsOptions, ad as MonitorJobPhase, ae as MonitorJobReconciliationState, af as MonitorJobResult, ag as MonitorJobState, ah as MonitorJobWaitOptions, ai as MonitorJobsNamespace, aj as MonitorListEntry, ak as MonitorPayload, al as MonitorReactivateResult, am as MonitorSpec, an as MonitorState, ao as MonitorStateFilter, ap as MonitorUpdateChangeSummary, aq as MonitorUpdateResult, ar as MonitorsAccessStatus, as as MonitorsAvailableOptions, at as MonitorsAvailableResult, au as MonitorsListOptions, av as MonitorsListResult, aw as MonitorsNamespace, ax as NormalizedRunEventQuery, ay as PlayActivityObservation, az as PlayActivityState, aA as PlayActivityTarget, aB as PlayCostEstimate, aC as PlayCronTriggerConfig, aD as PlayDescriptionOptions, aE as PlayLiveEvent, aF as PlayPath, aG as PlayRunActionPackage, aH as PlayRunActivityProjection, aI as PlayRunDatasetActions, aJ as PlayRunPackage, aK as PlayRunResult, aL as PlayRunRowHistoryOptions, aM as PlayRunStart, aN as PlaySettings, aO as PlaySettingsPatch, aP as PlaySettingsPathsPage, aQ as PlaySettingsResult, aR as PlaySheetRow, aS as PlaySheetRowsResult, aT as PlayTriggerConfigUpdate, aU as PlayTriggerConfigUpdateResult, aV as PlayTriggerConfigView, aW as PlayWebhookAuthConfig, aX as PlayWebhookTriggerConfig, aY as PlaysActivityResponse, aZ as PlaysListOptions, a_ as PlaysListPage, a$ as PublishPlayVersionRequest, b0 as RerunOptions, b1 as RerunPlayRunResult, b2 as RunChildrenPage, b3 as RunEventCountResult, b4 as RunEventField, b5 as RunEventFieldDescriptor, b6 as RunEventFieldOperators, b7 as RunEventFieldsResult, b8 as RunEventGroupValue, b9 as RunEventMeasure, ba as RunEventQueryCriteria, bb as RunEventQueryEvent, bc as RunEventQueryInputError, bd as RunEventQueryOptions, be as RunEventQueryPage, bf as RunEventQueryRetention, bg as RunEventScalar, bh as RunEventSummaryOptions, bi as RunEventSummaryResult, bj as RunEventWhere, bk as RunLifecycleStatus, bl as RunToolReceiptResult, bm as RunToolReceiptsResponse, bn as RunsChildrenOptions, bo as RunsEventPayload, bp as RunsEventSearchEntry, bq as RunsEventSearchOptions, br as RunsEventSearchResult, bs as RunsEventsCountResult, bt as RunsEventsCriteria, bu as RunsEventsFieldsOptions, bv as RunsEventsListOptions, bw as RunsEventsListResult, bx as RunsEventsNamespace, by as RunsEventsSummaryOptions, bz as RunsEventsSummaryResult, bA as RunsHistoryItem, bB as RunsHistoryOptions, bC as RunsHistoryPage, bD as RunsListOptions, bE as RunsListPage, bF as RunsLogCriteria, bG as RunsLogsCountResult, bH as RunsLogsNamespace, bI as RunsLogsOptions, bJ as RunsLogsQueryOptions, bK as RunsLogsQueryResult, bL as RunsLogsResult, bM as RunsLogsSummaryOptions, bN as RunsLogsSummaryResult, bO as RunsNamespace, bP as RunsTailOptions, bQ as RunsWatchOptions, bR as SearchOptions, bS as SearchResult, bT as SearchResultItem, S as SearchType, bU as StartPlayRunRequest, bV as StopAllCandidate, bW as StopAllPlayRunsDryRunResult, bX as StopAllPlayRunsResult, bY as StopAllPlayRunsStopResult, bZ as StopAllRunsOptions, b_ as ToolCategoryListing, b$ as ToolCategorySummary, c0 as ToolExecution, c1 as ToolRequestCondition, c2 as ToolRequestWarningRule, c3 as ToolSearchOptions, c4 as ToolSearchResult, c5 as WorkspaceCreateResult, c6 as WorkspacesNamespace, c7 as defineMonitor, c8 as isStopAllPlayRunsDryRunResult, c9 as planCustomerDbQuery } from './client-DH-fmT69.js';
+import { b as BundledPlayFileSuccess } from './index-CRAScKPg.js';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetDefinition, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.js';
 import '@sinclair/typebox';
@@ -20,7 +20,7 @@ declare class CtxFetchAmbiguousWriteError extends Error {
 }
 
 /**
- * Edition 5+ `ctx.fetch` error for a non-2xx response. Its full readable body is secret-redacted; editions 1–4 retain `PlayFetchResponse { ok: false }`.
+ * Edition 5+ `deepline.fetch` error for a non-2xx response. Its full readable body is secret-redacted; editions 1–4 retain `PlayFetchResponse { ok: false }`.
  *
  * @sdkReference runtime 178 CtxFetchHttpError
  */
@@ -61,10 +61,13 @@ type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
 type FetchOptions = PlayAuthoringFetchOptions;
 type PlayFetchResponse = PlayAuthoringFetchResponse;
 /**
- * Optional Play configuration, including triggers and runtime limits.
+ * Optional Play configuration, declared once at the top of the play file as
+ * an object literal: `export const config = { ... };`. Settings: `name`
+ * (defaults to the file name), `description`, `displayName`, `cron`,
+ * `webhook`, `sqlListeners`, `runtime`, `billing`, `compatibility`. It is
+ * read without running the play, so its values must be literals.
  *
- * A play can be triggered three ways, declared as the third argument to
- * {@link definePlay}:
+ * A play can be triggered three ways:
  * - `webhook` — an inbound HTTP call (with optional legacy HMAC or Standard
  *   Webhooks signature verification).
  * - `cron` — a schedule.
@@ -73,17 +76,17 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *   (e.g. run enrichment every time a watched company posts a new job). Each
  *   listener binds to a monitor tool id + one of its output stream keys (see
  *   `deepline monitors available <id>` for a tool's streams and row columns).
- *   The changed row is delivered to the handler as the listener event's `after`.
+ *   The changed row is delivered as the listener event's `after` in the play function's input.
  *
  * The default Play runtime is 30 minutes. For bounded long-running batches, add
  * `runtime: { timeout: '90m', size: 'standard' }`; duration values are whole minutes or hours, up to `4h`.
- * It differs from `ctx.tools.execute({ timeoutMs })`, which limits one provider call.
+ * It differs from `deepline.tools.execute({ timeoutMs })`, which limits one provider call.
  *
  * @example Webhook with HMAC verification. `secretEnv` is the Deepline Secret
  * name configured with `deepline secrets set`, retained as the legacy field
  * name for SDK compatibility.
  * ```typescript
- * definePlay('webhook-handler', handler, {
+ * export const config = {
  *   webhook: {
  *     hmac: {
  *       algorithm: 'sha256',
@@ -93,12 +96,12 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *       secretEnv: 'WEBHOOK_SECRET',
  *     },
  *   },
- * });
+ * };
  * ```
  *
  * @example Svix / Standard Webhooks verification with Deepline Secrets
  * ```typescript
- * definePlay('visitor-webhook', handler, {
+ * export const config = {
  *   webhook: {
  *     auth: {
  *       type: 'standard-webhooks',
@@ -106,19 +109,17 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *       signingSecrets: ['VECTOR_WEBHOOK_SECRET'],
  *     },
  *   },
- * });
+ * };
  * ```
  *
  * @example Cron schedule
  * ```typescript
- * definePlay('nightly-sync', handler, {
- *   cron: { schedule: '0 2 * * *', timezone: 'UTC' },
- * });
+ * export const config = { cron: { schedule: '0 2 * * *', timezone: 'UTC' } };
  * ```
  *
  * @example Monitor-triggered (run a play on a monitor's output)
  * ```typescript
- * definePlay('on-new-job-opening', handler, {
+ * export const config = {
  *   sqlListeners: [
  *     {
  *       id: 'jobs',
@@ -127,19 +128,19 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *       operations: ['INSERT'],
  *     },
  *   ],
- * });
+ * };
  * ```
  *
- * @sdkReference runtime 030
+ * @sdkReference runtime 006 export const config
  */
 type PlayBindings<TInput = Record<string, unknown>> = PlayAuthoringBindings<TInput>;
 type SqlListenerOperation = PlaySqlListenerOperation;
 type SqlListenerDeclaration = PlaySqlListenerDeclaration;
 type SqlListenerEvent<T extends object = Record<string, unknown>> = PlaySqlListenerEvent<T>;
-/** @deprecated Pass a SQL string directly to ctx.customerDb.query. */
+/** @deprecated Pass a SQL string directly to deepline.customerDb.query. */
 type SqlQuery = PlaySqlQuery;
 /**
- * Keyword-style request object for `ctx.tools.execute(...)`.
+ * Keyword-style request object for `deepline.tools.execute(...)`.
  *
  * The `tool` value comes from live tool discovery. The `id` is the stable
  * logical call name used for logs, metadata, and result-cache identity. Provider
@@ -178,7 +179,7 @@ type StepProgramResolver<Input, Return> = PlayAuthoringStepProgramResolver<Input
 type PlayStepProgramStep = PlayAuthoringStepProgramStep<DeeplinePlayRuntimeContext>;
 type ColumnResolver<Row, Value> = PlayAuthoringColumnResolver<Row, Value, DeeplinePlayRuntimeContext>;
 /**
- * Builder returned by `ctx.dataset(...)` for row-level durable columns.
+ * Builder returned by `deepline.dataset(...)` for row-level durable columns.
  *
  * @sdkReference runtime 070 .dataset(...).withColumn(name, resolver).run(options)
  */
@@ -198,57 +199,98 @@ type FileInput<TMetadata = unknown> = PlayAuthoringFileInput<TMetadata>;
 type CsvInput<TRow extends object = Record<string, unknown>> = PlayAuthoringCsvInput<TRow>;
 type ColumnMap<TRow extends object> = PlayAuthoringColumnMap<TRow>;
 /**
- * Options for loading a staged CSV with `ctx.csv(...)`.
+ * Options for loading a staged CSV with `deepline.csv(...)`.
  *
  * @sdkReference runtime 050
  */
 type CsvOptions = PlayAuthoringCsvOptions;
 /**
- * Runtime context available inside a play function.
- *
- * Provides methods for calling tools, processing data, and emitting logs.
- * This context is injected by the Temporal worker — you never construct it directly.
+ * The play runtime: every member of `deepline` except `config`, `input` and
+ * `output`. Use it to type a helper module's parameter; pass `deepline` in.
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
- *   // Call a tool
- *   const company = await ctx.tools.execute({
- *     id: 'company_search',
- *     tool: 'test_company_search',
+ * // enrich.ts
+ * import type { DeeplinePlayRuntimeContext } from 'deepline';
+ *
+ * export function lookUp(deepline: DeeplinePlayRuntimeContext, domain: string) {
+ *   return deepline.tools.execute({
+ *     id: 'company',
+ *     tool: 'company_lookup',
+ *     input: { domain },
+ *     description: 'Look up the company.',
+ *   });
+ * }
+ * ```
+ */
+type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
+/**
+ * `import deepline from 'deepline'` — the play runtime. A play is a
+ * `.play.ts` file that default-exports an async function of its input; the
+ * file name is the play name. The parameter's type is the input contract and
+ * the returned object is the result. Every
+ * runtime call below is `deepline.<name>`, including inside dataset resolvers
+ * and step bodies.
+ *
+ * ```ts
+ * import deepline from 'deepline';
+ *
+ * export default async function (input: { domain: string }) {
+ *   const company = await deepline.tools.execute({
+ *     id: 'company',
+ *     tool: 'company_lookup',
  *     input: { domain: input.domain },
- *     description: 'Look up company details by domain.',
+ *     description: 'Look up the company.',
+ *     staleAfterSeconds: 0,
  *   });
+ *   return { company };
+ * }
+ * ```
  *
- *   // Fan-out: process items with named columns
- *   const enriched = await ctx
- *     .dataset('companies', [{ domain: 'a.com' }, { domain: 'b.com' }])
- *     .withColumn('company', (row, rowCtx) =>
- *       rowCtx.tools.execute({
- *         id: 'company_search',
- *         tool: 'test_company_search',
- *         input: { domain: row.domain },
- *         description: 'Look up company details by domain.',
- *       }))
- *     .run({ description: 'Look up company details.' });
- *
- *   // Load CSV data from a submitted play input field.
- *   const leads = await ctx.csv(input.csv);
- *
- *   // Emit a log line (visible in `play tail`)
- *   ctx.log(`Loaded ${await leads.count()} leads`);
+ * ```bash
+ * deepline plays run lookup.play.ts --input '{"domain":"stripe.com"}'
+ * deepline plays run -e 'deepline.log("hello"); return { ok: true };'
+ * ```
  *
- *   // Wait at least one second before continuing.
- *   await ctx.sleep(1000);
+ * Compose with `import child from './child.play'` and
+ * `await deepline.runPlay('key', child, input, { description })`, or by name.
+ * `deepline` works only in the play file; pass it to helper modules as an
+ * argument typed {@link DeeplinePlayRuntimeContext}. The file exports only
+ * the play function and, optionally, its `config`.
  *
- *   // Access submitted input through the handler's second argument.
- *   ctx.log(`Running for ${input.domain}`);
+ * @sdkReference runtime 005 deepline
+ */
+type ScriptPlayContext = DeeplinePlayRuntimeContext & {
+    /** The same settings as `export const config = { ... }`. */
+    config(config: PlayBindings & {
+        name?: string;
+    }): void;
+    /**
+     * The run's input. A play function receives it as its parameter instead;
+     * this is not called at the top of a play file.
+     */
+    input<TInput = Record<string, unknown>>(): TInput;
+    /**
+     * Sets the play's result; deepline calls after it fail. A play function
+     * returns its result instead; this is not called at the top of a play file.
+     */
+    output(result: PlayReturnObject): void;
+};
+/**
+ * Runs a play module's body with `deepline` bound to this run. The bundler
+ * wraps the module's code, and the dispatch to its default-exported play
+ * function, in this call, so the artifact keeps the runner's
+ * `(context, input) => result` contract.
  *
- *   return { company, enriched };
- * });
- * ```
+ * @internal
  */
-type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
+declare function runScriptPlay(context: DeeplinePlayRuntimeContext, input: unknown, body: () => Promise<unknown>): Promise<PlayReturnObject>;
+/**
+ * The live play runtime for a script play. Inside a run it is that run's
+ * context (bound per async flow, so concurrent rows and steps keep their own
+ * scope); anywhere else, using it is a mistake worth a clear error.
+ */
+declare const deepline: ScriptPlayContext;
 /**
  * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
  * Like `deepline plays run` and `POST /api/v2/plays/run`, it returns a run id first.
@@ -259,7 +301,8 @@ type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
  *
  * @example
  * ```typescript
- * const job: PlayJob = await ctx.play('my-play').run({ domain: 'stripe.com' });
+ * const client = await Deepline.connect();
+ * const job: PlayJob = await client.play('my-play').run({ domain: 'stripe.com' });
  *
  * // Poll status
  * const status = await job.status();
@@ -328,8 +371,8 @@ interface PlayJob<TOutput = unknown> {
  *
  * @example
  * ```typescript
- * const ctx = await Deepline.connect();
- * const play = ctx.play<{ domain: string }, Company>('company-lookup');
+ * const client = await Deepline.connect();
+ * const play = client.play<{ domain: string }, Company>('company-lookup');
  *
  * // Get play definition
  * const detail = await play.get();
@@ -402,8 +445,8 @@ type DeeplineToolCallOptions = Pick<ExecuteToolRawOptions, 'timeout' | 'idempote
  * Tool/provider operations available from a connected {@link DeeplineContext}.
  *
  * This namespace is for regular SDK callers outside a play runtime. Inside a
- * `definePlay(...)` body, use `ctx.tools.execute({ id, tool, input, ... })`
- * so provider calls become durable runtime checkpoints.
+ * play, use `deepline.tools.execute({ id, tool, input, ... })` so provider
+ * calls become durable runtime checkpoints.
  *
  * @sdkReference tools 010 DeeplineContext.tools
  */
@@ -417,7 +460,7 @@ type DeeplineToolsNamespace = {
     /**
      * Execute a provider-backed tool from a regular SDK process.
      *
-     * For durable play code, prefer `ctx.tools.execute(...)` because the play
+     * For durable play code, prefer `deepline.tools.execute(...)` because the play
      * runtime records the call under a stable id.
      */
     execute(toolId: string, input: Record<string, unknown>, options?: DeeplineToolCallOptions): Promise<DeeplineToolExecuteResult>;
@@ -447,7 +490,7 @@ type PrebuiltPlayRef = {
     readonly name: string;
 };
 type PlayReferenceLike<TInput extends Record<string, unknown> = Record<string, unknown>> = PlayAuthoringReferenceLike<TInput>;
-/** Branded durable identity returned by ctx.runPlayAsync. */
+/** Branded durable identity returned by deepline.runPlayAsync. */
 type PlayRunId = PlayRunId$1;
 /** Serializable reference to an independently scheduled Play Run. */
 type AsyncPlayRunRef = AsyncPlayRunRef$1;
@@ -457,14 +500,9 @@ type PlayAsyncCallOptions = PlayAuthoringAsyncCallOptions;
 type PlayReturnObject = PlayReturnObject$1;
 type PlayInputContract<TInput> = PlayAuthoringInputContract<TInput>;
 /**
- * Object-form play definition accepted by `definePlay(config)`.
+ * Object-form config accepted by the older `definePlay(config)` form. Files
+ * that export `definePlay(...)` keep working; new plays use {@link deepline}.
  *
- * Use this form when the input contract should be explicit at definition time
- * through `defineInput<T>(schema)`, or when configuration reads clearer as one
- * object. The shorthand `definePlay(name, fn, bindings?)` is equivalent for
- * simple file-backed plays.
- *
- * @sdkReference runtime 020
  */
 type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = PlayAuthoringDefineConfig<TInput, TOutput, DeeplinePlayRuntimeContext>;
 declare function steps<TInput>(options?: StepProgramOptions): StepProgram<TInput, TInput, TInput>;
@@ -565,7 +603,7 @@ declare class DeeplineContext {
      * Play discovery and named-play handles.
      *
      * Use `plays.list()` for discovery and `plays.get(name)` when you prefer a
-     * namespace spelling over `ctx.play(name)`.
+     * namespace spelling over `play(name)`.
      */
     get plays(): DeeplinePlaysNamespace;
     /**
@@ -573,7 +611,7 @@ declare class DeeplineContext {
      *
      * Known prebuilts are exposed by camel-cased aliases. Any other property is
      * converted into `prebuilt/<property>` so callers can pass the reference to
-     * `ctx.runPlay(...)`.
+     * `deepline.runPlay(...)` inside a play.
      */
     get prebuilt(): Record<string, PrebuiltPlayRef>;
     /**
@@ -586,7 +624,7 @@ declare class DeeplineContext {
      *
      * @example
      * ```typescript
-     * const play = ctx.play<{ domain: string }>('email-waterfall');
+     * const play = client.play<{ domain: string }>('email-waterfall');
      * const job = await play.run({ domain: 'stripe.com' });
      * const result = await job.get();
      * ```
@@ -595,8 +633,8 @@ declare class DeeplineContext {
     /**
      * Run a named or prebuilt play and wait for its output.
      *
-     * This is the high-level SDK equivalent of `ctx.play(name).runSync(input)`.
-     * Inside a Play, prefer `ctx.runPlay(key, playRef, input, options)`.
+     * This is the high-level SDK equivalent of `client.play(name).runSync(input)`.
+     * Inside a play, use `deepline.runPlay(key, playRef, input, options)`.
      * The runtime checkpoints the child run under a stable key.
      *
      * @param playOrRef - Play name or prebuilt/reference object.
@@ -646,12 +684,8 @@ declare class Deepline {
 }
 declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInputContract<TInput>;
 /**
- * Define a play — a composable TypeScript workflow for the Deepline platform.
- *
- * The returned value is both a callable function and a named Play handle.
- * The Deepline runtime calls the function with a runtime context.
- * The handle provides `.run()`, `.versions()`, `.get()`, and `.publish()` for remote lifecycle operations.
- * Plays define repeatable data pipelines. The runtime executes them durably with automatic retries and timeouts.
+ * The older play form. Files that export `definePlay(...)` keep working; new
+ * plays are scripts that use {@link deepline}.
  *
  * @typeParam TInput - The input type accepted by the play
  * @typeParam TOutput - The return type of the play
@@ -660,70 +694,6 @@ declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInput
  * @param fn - Play function.
  * @param bindings - Play configuration, including runtime limits and triggers.
  * @returns A {@link DefinedPlay} that is both callable and has lifecycle methods
- *
- * @example Basic play
- * ```typescript
- * import { definePlay } from 'deepline';
- *
- * export default definePlay('company-lookup', async (ctx, input: { domain: string }) => {
- *   ctx.log(`Searching for ${input.domain}`);
- *   const company = await ctx.tools.execute({
- *     id: 'company_search',
- *     tool: 'test_company_search',
- *     input: { domain: input.domain },
- *     description: 'Look up company details by domain.',
- *   });
- *   return company;
- * });
- * ```
- *
- * @example CSV processing play
- * ```typescript
- * export default definePlay('bulk-enrich', async (ctx, input: { csv: string }) => {
- *   const leads = await ctx.csv(input.csv);
- *   ctx.log(`Processing ${await leads.count()} rows`);
- *   const results = await ctx
- *     .dataset('companies', leads)
- *     .withColumn('company', (row, ctx) =>
- *       ctx.tools.execute({
- *         id: 'company_search',
- *         tool: 'test_company_search',
- *         input: { domain: row.domain },
- *         description: 'Look up company details by domain.',
- *       }))
- *     .run({ description: 'Enrich lead companies.' });
- *   return results;
- * });
- * ```
- *
- * @example With cron binding
- * ```typescript
- * export default definePlay('daily-report', async (ctx) => {
- *   const data = await ctx.tools.execute({
- *     id: 'crm_export',
- *     tool: 'crm_export',
- *     input: { since: 'yesterday' },
- *     description: 'Export yesterday CRM records.',
- *   });
- *   return data;
- * }, {
- *   cron: { schedule: '0 9 * * *', timezone: 'America/New_York' },
- * });
- * ```
- *
- * @example Programmatic lifecycle
- * ```typescript
- * const myPlay = definePlay('my-play', handler);
- *
- * // Get play definition:
- * const detail = await myPlay.get();
- *
- * // Run remotely:
- * const result = await myPlay.runSync({ domain: 'stripe.com' });
- *
- * // Make the current draft live:
- * await myPlay.publish();
- * ```
  */
 declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: DefinePlayConfig<TInput, TOutput>): DefinedPlay<TInput, TOutput>;
 /** @internal Contextually type unannotated monitor-event handlers as unknown. */
@@ -1102,4 +1072,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CtxFetchAmbiguousWriteError, CtxFetchHttpError, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, PlayDataset, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, BasicToolExecuteResult as ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, readList, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, BillingNamespace, ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, CtxFetchAmbiguousWriteError, CtxFetchHttpError, CustomerDbQueryOutcomeUnknownError, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCallOptions, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, ExecutionByKeyResult, ExecutionRecovery, type FetchOptions, type FileInput, type LocalPlayGraph, PROD_URL, type PlayAsyncCallOptions, type PlayBindings, type PlayCallExecution, type PlayCallOptions, PlayDataset, type PlayFetchResponse, type PlayInputContract, type PlayJob, PlayListItem, type PlayReferenceLike, PlayRevisionSummary, type PlayRunId, PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, PublishPlayVersionResult, RateLimitError, ResolvedConfig, RunObserveTransportUnavailableError, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type ScriptPlayContext, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, StopPlayRunResult, ToolDefinition, BasicToolExecuteResult as ToolExecuteResult, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, ToolMetadata, ToolRateLimitError, deepline, deepline as default, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, pinLocalPlayImports, planLocalPlayExecution, readList, resolveConfig, runIf, runScriptPlay, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };