deepline 0.2.50 → 0.2.52

package/dist/bundling-sources/sdk/src/client.ts

@@ -711,6 +711,7 @@ export type MonitorListEntry = {
   webhook_state?: string;
   last_received_event?: string | null;
   bound_plays?: Array<Record<string, unknown>>;
+  consumer_health_truncated?: boolean;
   [key: string]: unknown;
 };
 
@@ -726,6 +727,8 @@ export type MonitorsListResult = {
   is_truncated?: boolean;
   next_cursor?: string | null;
   status_filter_applied?: string;
+  status_summary?: Array<{ status: string; count: number }>;
+  include_consumers?: boolean;
   [key: string]: unknown;
 };
 
@@ -737,6 +740,8 @@ export type MonitorsListOptions = {
   /** Page past a truncated result using a prior response's `next_cursor`. */
   cursor?: string;
   compact?: boolean;
+  /** Include bounded current SQL-listener delivery/run health (requires limit <= 20). */
+  includeConsumers?: boolean;
 };
 
 /**
@@ -814,9 +819,9 @@ export type MonitorsNamespace = {
     definition: MonitorDefinition,
     options?: { dryRun?: boolean },
   ) => Promise<MonitorDeployResult>;
-  /** List deployed monitors (active by default). */
+  /** List deployed monitors (active by default). `includeConsumers` requires a limit of 20 or fewer. */
   list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
-  /** Fetch one deployed monitor by public key (without dependents). */
+  /** Fetch one deployed monitor by public key with bounded current listener health. */
   get: (key: string) => Promise<MonitorDetail>;
   /**
    * Test a deployed monitor. `validationOnly` safely verifies the callback
@@ -825,7 +830,7 @@ export type MonitorsNamespace = {
   test: (
     key: string,
     payload: Record<string, unknown>,
-    options?: { validationOnly?: boolean },
+    options?: { validationOnly?: boolean; dispatch?: boolean },
   ) => Promise<MonitorTestResult>;
   validate: (key: string) => Promise<MonitorValidateResult>;
   /** List the published plays depending on one monitor's output streams. */
@@ -4531,6 +4536,7 @@ export class DeeplineClient {
       params.set('limit', String(options.limit));
     if (options?.cursor) params.set('cursor', options.cursor);
     if (options?.compact) params.set('compact', 'true');
+    if (options?.includeConsumers) params.set('include_consumers', 'true');
     const query = params.toString();
     // Single interpolation only — see availableMonitors: a nested template in
     // the path confuses the SDK/API contract path extractor.
@@ -4552,7 +4558,7 @@ export class DeeplineClient {
   async testMonitorWebhook(
     key: string,
     payload: Record<string, unknown>,
-    options?: { validationOnly?: boolean },
+    options?: { validationOnly?: boolean; dispatch?: boolean },
   ): Promise<MonitorTestResult> {
     return this.http.request<MonitorTestResult>(
       `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
@@ -4560,7 +4566,11 @@ export class DeeplineClient {
         method: 'POST',
         body: {
           payload,
-          ...(options?.validationOnly ? { mode: 'validation_only' } : {}),
+          ...(options?.validationOnly
+            ? { mode: 'validation_only' }
+            : options?.dispatch
+              ? { mode: 'dispatch' }
+              : {}),
         },
       },
     );

package/dist/bundling-sources/sdk/src/release.ts

@@ -160,7 +160,7 @@ export const SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: '0.2.50',
+  version: '0.2.52',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/sdk/src/types.ts

@@ -1343,12 +1343,31 @@ export interface PlayCheckSqlListenerTrigger {
   };
 }
 
+/**
+ * The input delivered to a SQL-listener Play invocation. One changed Customer
+ * DB row starts one run with this top-level event object; it is not an events
+ * array or a polling batch.
+ */
+export interface PlayCheckSqlListenerEventSummary {
+  delivery: 'one_event_per_matched_row';
+  fields: Array<
+    | 'tool'
+    | 'stream'
+    | 'operation'
+    | 'before'
+    | 'after'
+    | 'changedAt'
+    | 'metadata'
+  >;
+}
+
 /**
  * Concise summary of the trigger bindings the server recognized for a play.
  * Only present triggers are populated.
  */
 export interface PlayCheckTriggersSummary {
   sqlListeners?: PlayCheckSqlListenerTrigger[];
+  sqlListenerEvent?: PlayCheckSqlListenerEventSummary;
   cron?: { schedule: string; timezone?: string };
   webhook?: true;
 }

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -157,6 +157,7 @@ import {
   validatePlayAuthoringField,
   type PlayAuthoringContractEdition,
   type PlaySqlQuery,
+  type PlayAuthoringRunScope,
   type PlayAuthoringRuntimeContext,
 } from '../plays/authoring-contract';
 import {
@@ -1338,6 +1339,7 @@ type ScalarPlayAuthoringRuntimeContext = Pick<
   PlayAuthoringRuntimeContext,
   | 'tools'
   | 'customerDb'
+  | 'run'
   | 'tool'
   | 'step'
   | 'fetch'
@@ -3332,6 +3334,10 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     return this.currentExecutionScope.logical.runId;
   }
 
+  get run(): PlayAuthoringRunScope {
+    return { id: this.currentRunId };
+  }
+
   private get currentReceiptOwnerRunId(): string {
     return this.currentExecutionScope.receipt.ownerRunId;
   }

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -68,6 +68,7 @@ export const PLAY_AUTHORING_CONTRACT_ISSUE_CODES = [
   'play_authoring_dynamic_identity_unvalidated',
   'play_authoring_fetch_secret_requires_tls',
   'play_authoring_fetch_idempotency_required',
+  'play_authoring_fetch_key_reused_in_loop',
   'play_authoring_binding_invalid',
   'play_authoring_input_schema_unresolved',
 ] as const;
@@ -215,8 +216,23 @@ export type PlayTriggerSqlListenerSummary = {
   operations: string[];
   where?: PlaySqlListenerWhere;
 };
+/** Author-facing shape of one SQL-listener invocation. */
+export type PlayTriggerSqlListenerEventSummary = {
+  delivery: 'one_event_per_matched_row';
+  fields: Array<
+    | 'tool'
+    | 'stream'
+    | 'operation'
+    | 'before'
+    | 'after'
+    | 'changedAt'
+    | 'metadata'
+  >;
+};
 export type PlayTriggersSummary = {
   sqlListeners?: PlayTriggerSqlListenerSummary[];
+  /** Present when the play has at least one sqlListener trigger. */
+  sqlListenerEvent?: PlayTriggerSqlListenerEventSummary;
   cron?: { schedule: string; timezone?: string };
   webhook?: true;
 };
@@ -237,6 +253,18 @@ export function derivePlayTriggersSummary(
         ? { where: listener.where as PlaySqlListenerWhere }
         : {}),
     }));
+    summary.sqlListenerEvent = {
+      delivery: 'one_event_per_matched_row',
+      fields: [
+        'tool',
+        'stream',
+        'operation',
+        'before',
+        'after',
+        'changedAt',
+        'metadata',
+      ],
+    };
   }
   if (bindings.cron?.schedule) {
     summary.cron = bindings.cron.timezone
@@ -652,6 +680,7 @@ export const PLAY_AUTHORING_RUNTIME_CONTEXT_MEMBERS = [
   'dataset',
   'fetch',
   'log',
+  'run',
   'runPlay',
   'runSteps',
   'secrets',
@@ -743,6 +772,31 @@ export type PlayAuthoringRunStepsOptions = {
   description?: string;
 };
 
+/**
+ * Stable identity of the currently executing Play invocation.
+ *
+ * The id is unchanged while Deepline resumes or retries the same durable run.
+ * A separately submitted run intentionally receives a new id.
+ */
+export type PlayAuthoringRunScope = {
+  readonly id: string;
+};
+
+/** Factual authoring guidance rendered into SDK and offline-agent references. */
+export const PLAY_AUTHORING_DOCUMENTATION = {
+  fetchBatching: {
+    warning:
+      'A static ctx.fetch key inside a loop is a warning because every iteration must still have distinct method, URL, body, or safe headers. One durable receipt must never stand in for every request.',
+    guidance:
+      'Keep the static fetch label. For a mutating batch, make the body distinct and use a replay-stable external Idempotency-Key such as `${ctx.run.id}:signals:${batchIndex}`.',
+  },
+  runId: {
+    semantics:
+      'ctx.run.id is stable while Deepline retries or resumes one durable run. A separately submitted run receives a new id.',
+    use: 'Use it when deriving an external idempotency key for a sequence of batches.',
+  },
+} as const;
+
 /** The complete customer-authored `ctx` Interface shared by every Adapter. */
 export interface PlayAuthoringRuntimeContext {
   /**
@@ -776,6 +830,12 @@ export interface PlayAuthoringRuntimeContext {
     >,
   ): never;
 
+  /**
+   * Identity for this durable run. Use this to build a replay-stable external
+   * idempotency key, for example when posting a sequence of batches.
+   */
+  readonly run: PlayAuthoringRunScope;
+
   tools: {
     /**
      * Execute a provider tool through the durable receipt contract.
@@ -2294,6 +2354,7 @@ export const PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   '  csv<T = Record<string, unknown>>(path: string | CsvInput<T & object>, options?: CsvOptions): Promise<PlayDataset<T>>;',
   '  dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): DatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object>;',
   '  map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: DatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;',
+  '  readonly run: { readonly id: string };',
   `  runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: { description?: ${cloudReferenceType('ctx.runSteps.options.description')} }): Promise<TOutput>;`,
   '  tools: { execute<K extends string>(request: ToolExecutionRequest<K>): Promise<ToolExecutionOutput<K>> };',
   `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { maxRows?: ${cloudReferenceType('ctx.customerDb.query.options.maxRows')}; timeoutMs?: ${cloudReferenceType('ctx.customerDb.query.options.timeoutMs')} }): Promise<TRow[]> };`,

package/dist/cli/index.js

@@ -1044,7 +1044,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.50",
+  version: "0.2.52",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -6034,6 +6034,7 @@ var DeeplineClient = class {
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
     if (options?.compact) params.set("compact", "true");
+    if (options?.includeConsumers) params.set("include_consumers", "true");
     const query = params.toString();
     const suffix = query ? `?${query}` : "";
     return this.http.request(
@@ -6055,7 +6056,7 @@ var DeeplineClient = class {
         method: "POST",
         body: {
           payload,
-          ...options?.validationOnly ? { mode: "validation_only" } : {}
+          ...options?.validationOnly ? { mode: "validation_only" } : options?.dispatch ? { mode: "dispatch" } : {}
         }
       }
     );
@@ -16170,6 +16171,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  csv<T = Record<string, unknown>>(path: string | CsvInput<T & object>, options?: CsvOptions): Promise<PlayDataset<T>>;",
   "  dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): DatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object>;",
   "  map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: DatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;",
+  "  readonly run: { readonly id: string };",
   `  runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: { description?: ${cloudReferenceType("ctx.runSteps.options.description")} }): Promise<TOutput>;`,
   "  tools: { execute<K extends string>(request: ToolExecutionRequest<K>): Promise<ToolExecutionOutput<K>> };",
   `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { maxRows?: ${cloudReferenceType("ctx.customerDb.query.options.maxRows")}; timeoutMs?: ${cloudReferenceType("ctx.customerDb.query.options.timeoutMs")} }): Promise<TRow[]> };`,
@@ -21669,6 +21671,11 @@ function printPlayTriggers(triggers) {
     const whereNote = listener.where ? " (with where filter)" : "";
     console.log(`    sqlListeners \u2192 ${target} on ${operations}${whereNote}`);
   }
+  if (triggers.sqlListenerEvent) {
+    console.log(
+      `    sqlListener input \u2192 one top-level event per matched row: ${triggers.sqlListenerEvent.fields.join(", ")}`
+    );
+  }
   if (triggers.cron) {
     const timezone = triggers.cron.timezone ? ` (${triggers.cron.timezone})` : "";
     console.log(`    cron \u2192 ${triggers.cron.schedule}${timezone}`);
@@ -23630,6 +23637,8 @@ Notes:
   without starting a run or spending Deepline credits.
   Local .play.ts checks bundle the play, validate its artifact, and stop before
   any cloud run is created.
+  SQL-listener checks echo one top-level changed-row input event under
+  recognized.triggers.sqlListenerEvent; listeners do not receive an events batch.
 
 Examples:
   deepline plays check prebuilt/name-and-domain-to-email-waterfall-batch
@@ -30860,6 +30869,20 @@ function renderDeployReplacementWarning(input2) {
   );
   return lines;
 }
+function renderDeployFilterRemovalWarning(payload) {
+  const summary = asRecord2(payload.change_summary);
+  const definition = summary ? asRecord2(summary.definition) : void 0;
+  const changed = definition && Array.isArray(definition.changed) ? definition.changed : [];
+  const removed = changed.some((raw) => {
+    const item = asRecord2(raw);
+    return asString(item?.path) === "payload.job_titles" && item?.before != null && item.after == null;
+  });
+  return removed ? [
+    "WARNING: this full deploy removes the job_titles filter.",
+    "Future findings will be unfiltered. Existing Customer DB rows are preserved.",
+    'Use `deepline monitors update <key> {"payload":{"job_titles":"..."}}` to change only the filter.'
+  ] : [];
+}
 function renderMonitorDeployCompletion(payload) {
   const monitor = asRecord2(payload.monitor);
   const key = monitor ? asString(monitor.key) : void 0;
@@ -30893,6 +30916,8 @@ function renderMonitorDeployCompletion(payload) {
     monitorKey: key
   });
   if (replacementWarning.length) lines.push("", ...replacementWarning);
+  const filterRemovalWarning = renderDeployFilterRemovalWarning(payload);
+  if (filterRemovalWarning.length) lines.push("", ...filterRemovalWarning);
   const guidance = asRecord2(payload.setup_guidance);
   if (guidance) {
     const callbackUrl = asString(guidance.callback_url);
@@ -30949,6 +30974,8 @@ function renderMonitorDeployPlan(payload) {
     completed: false
   });
   if (replacementWarning.length) lines.push("", ...replacementWarning);
+  const filterRemovalWarning = renderDeployFilterRemovalWarning(payload);
+  if (filterRemovalWarning.length) lines.push("", ...filterRemovalWarning);
   const estimate = asRecord2(payload.deploy_cost_estimate);
   const credits = estimate ? asFiniteNumber(estimate.credits) : void 0;
   if (credits !== void 0) {
@@ -31155,11 +31182,31 @@ function renderDeployedListText(payload, requestedStatus) {
     if (hasLastReceivedEvent) {
       lines.push(`    last received: ${lastReceivedEvent ?? "never"}`);
     }
+    if (Array.isArray(entry.bound_plays)) {
+      for (const rawPlay of entry.bound_plays) {
+        const play = asRecord2(rawPlay);
+        const playName = asString(play?.name) ?? "unnamed Play";
+        const health = asRecord2(play?.consumer_health);
+        const healthRequested = Boolean(play && "consumer_health" in play);
+        const state = healthRequested ? asString(health?.last_run_status) ?? "no delivery yet" : "health not requested";
+        const lastError = asString(health?.last_error);
+        lines.push(
+          `    consumer: ${playName} \u2014 ${state}${lastError ? ` (${lastError})` : ""}`
+        );
+      }
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
     `Status filter: ${applied}${requestedStatus === void 0 && applied === "active" ? " (default)" : ""} \u2014 use --status all to include disabled monitors.`
   );
+  const summary = Array.isArray(payload.status_summary) ? payload.status_summary.flatMap((raw) => {
+    const item = asRecord2(raw);
+    const status = item ? asString(item.status) : void 0;
+    const count = item ? asFiniteNumber(item.count) : void 0;
+    return status && count !== void 0 ? [`${status}: ${count}`] : [];
+  }).join("  ") : "";
+  if (summary) lines.push(`All lifecycle states: ${summary}`);
   if (payload.is_truncated === true) {
     const nextCursor = asString(payload.next_cursor);
     lines.push(
@@ -31178,7 +31225,8 @@ async function handleMonitorsList(options) {
     ...options.status ? { status: options.status } : {},
     ...options.limit ? { limit: options.limit } : {},
     ...options.cursor ? { cursor: options.cursor } : {},
-    ...options.compact ? { compact: true } : {}
+    ...options.compact ? { compact: true } : {},
+    ...options.includeConsumers ? { includeConsumers: true } : {}
   });
   printCommandEnvelope(payload, {
     json: options.json,
@@ -31241,6 +31289,10 @@ function renderMonitorGet(payload) {
   const webhook = asRecord2(payload.webhook);
   const guidance = asRecord2(payload.setup_guidance);
   const plays = dependents && Array.isArray(dependents.plays) ? dependents.plays : [];
+  const boundPlays = Array.isArray(payload.bound_plays) ? payload.bound_plays.flatMap((value) => {
+    const play = asRecord2(value);
+    return play ? [play] : [];
+  }) : [];
   const lines = [
     `Monitor: ${key}`,
     `Tool: ${tool}`,
@@ -31282,6 +31334,31 @@ function renderMonitorGet(payload) {
       `  deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
     );
   }
+  lines.push("", `Current SQL listener consumers (${boundPlays.length}):`);
+  if (boundPlays.length === 0) {
+    lines.push("  none");
+  } else {
+    for (const play of boundPlays) {
+      const name = asString(play.name) ?? "unnamed Play";
+      const listener = asString(play.listener_key);
+      const health = asRecord2(play.consumer_health);
+      const status2 = asString(health?.last_run_status) ?? "no delivery yet";
+      const lastDelivery = asFiniteNumber(health?.last_delivery_at);
+      const error = asString(health?.last_error);
+      lines.push(
+        `  ${name}${listener ? ` (listener: ${listener})` : ""}: ${status2}`
+      );
+      if (lastDelivery !== void 0) {
+        lines.push(
+          `    last delivery: ${new Date(lastDelivery).toISOString()}`
+        );
+      }
+      if (error) lines.push(`    error: ${error}`);
+    }
+  }
+  if (payload.consumer_health_truncated === true) {
+    lines.push("  Results are truncated; use --json for the returned detail.");
+  }
   lines.push("", `Dependent published plays (${plays.length}):`);
   if (plays.length === 0) {
     lines.push("  none");
@@ -31306,7 +31383,11 @@ function renderMonitorGet(payload) {
 async function handleMonitorsGet(key, options) {
   const client2 = new DeeplineClient();
   const payload = await client2.monitors.get(key);
-  const dependents = await client2.monitors.dependents(key);
+  const boundPlays = Array.isArray(payload.bound_plays) ? payload.bound_plays : null;
+  const dependents = boundPlays ? {
+    plays: boundPlays,
+    truncated: payload.consumer_health_truncated === true
+  } : await client2.monitors.dependents(key);
   const detail = { ...payload, dependents };
   printCommandEnvelope(detail, {
     json: options.json,
@@ -31319,7 +31400,8 @@ async function handleMonitorsTest(key, payload, options) {
     key,
     explicitPayload,
     {
-      validationOnly: options.dispatch !== true
+      validationOnly: options.dispatch !== true,
+      dispatch: options.dispatch === true
     }
   );
   const dispatch = options.dispatch === true;
@@ -31505,12 +31587,17 @@ Notes:
   not the page size), returned, is_truncated, and next_cursor. When is_truncated
   is true, page with --cursor <next_cursor> until it is false \u2014 a "no matching
   monitor" reuse conclusion off a truncated page deploys a duplicate paid feed.
+  The default list stays cheap: it includes the current downstream Play binding
+  metadata but does not resolve per-monitor delivery/run health. Pass
+  --include-consumers with --limit 20 or fewer to include the current
+  SQL-listener delivery/run health for each returned monitor.
 
 Examples:
   deepline monitors list
   deepline monitors list --status all --json
   deepline monitors list --status all --cursor <next_cursor> --json
   deepline monitors list --compact --json
+  deepline monitors list --include-consumers --limit 20 --json
 `
     ).option(
       "--status <status>",
@@ -31518,7 +31605,10 @@ Examples:
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"
-    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION).option(
+      "--include-consumers",
+      "Include current SQL-listener consumer health (requires --limit 20 or fewer)"
+    )
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     monitors.command("get <key>").description("Show a single deployed monitor by its public key.").addHelpText(
@@ -31568,10 +31658,11 @@ Notes:
   and optional controls (Deepline lifecycle metadata). Pass it positionally,
   via --file <path>, or
   from stdin with --file -. Does not deploy or spend credits.
-  For Deepline Native Company Radar monitors, check validates persona-filter enums and the
-  job_titles Boolean-expression grammar locally (parentheses are unsupported;
-  NOT > AND > OR).
-  Inspect the exact schema with
+  Check validates the local definition only. It does not contact an existing
+  upstream resource, prove that future events will arrive, or verify downstream
+  Play delivery. The JSON response reports this validation scope explicitly.
+  Provider-specific grammar, precedence, enum applicability, examples, and
+  update semantics are returned by the live monitor contract. Inspect it with
   \`deepline monitors available deepline_native.company_radar --json\`.
 
 Examples:
@@ -31680,7 +31771,10 @@ Examples:
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"
-    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION).option(
+      "--include-consumers",
+      "Include current SQL-listener consumer health (requires --limit 20 or fewer)"
+    )
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     deployed.command("get <key>").description("Alias of `monitors get <key>`.")

package/dist/cli/index.mjs

@@ -1030,7 +1030,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.50",
+  version: "0.2.52",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -6020,6 +6020,7 @@ var DeeplineClient = class {
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
     if (options?.compact) params.set("compact", "true");
+    if (options?.includeConsumers) params.set("include_consumers", "true");
     const query = params.toString();
     const suffix = query ? `?${query}` : "";
     return this.http.request(
@@ -6041,7 +6042,7 @@ var DeeplineClient = class {
         method: "POST",
         body: {
           payload,
-          ...options?.validationOnly ? { mode: "validation_only" } : {}
+          ...options?.validationOnly ? { mode: "validation_only" } : options?.dispatch ? { mode: "dispatch" } : {}
         }
       }
     );
@@ -16209,6 +16210,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  csv<T = Record<string, unknown>>(path: string | CsvInput<T & object>, options?: CsvOptions): Promise<PlayDataset<T>>;",
   "  dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): DatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object>;",
   "  map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: DatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;",
+  "  readonly run: { readonly id: string };",
   `  runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: { description?: ${cloudReferenceType("ctx.runSteps.options.description")} }): Promise<TOutput>;`,
   "  tools: { execute<K extends string>(request: ToolExecutionRequest<K>): Promise<ToolExecutionOutput<K>> };",
   `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { maxRows?: ${cloudReferenceType("ctx.customerDb.query.options.maxRows")}; timeoutMs?: ${cloudReferenceType("ctx.customerDb.query.options.timeoutMs")} }): Promise<TRow[]> };`,
@@ -21715,6 +21717,11 @@ function printPlayTriggers(triggers) {
     const whereNote = listener.where ? " (with where filter)" : "";
     console.log(`    sqlListeners \u2192 ${target} on ${operations}${whereNote}`);
   }
+  if (triggers.sqlListenerEvent) {
+    console.log(
+      `    sqlListener input \u2192 one top-level event per matched row: ${triggers.sqlListenerEvent.fields.join(", ")}`
+    );
+  }
   if (triggers.cron) {
     const timezone = triggers.cron.timezone ? ` (${triggers.cron.timezone})` : "";
     console.log(`    cron \u2192 ${triggers.cron.schedule}${timezone}`);
@@ -23676,6 +23683,8 @@ Notes:
   without starting a run or spending Deepline credits.
   Local .play.ts checks bundle the play, validate its artifact, and stop before
   any cloud run is created.
+  SQL-listener checks echo one top-level changed-row input event under
+  recognized.triggers.sqlListenerEvent; listeners do not receive an events batch.
 
 Examples:
   deepline plays check prebuilt/name-and-domain-to-email-waterfall-batch
@@ -30913,6 +30922,20 @@ function renderDeployReplacementWarning(input2) {
   );
   return lines;
 }
+function renderDeployFilterRemovalWarning(payload) {
+  const summary = asRecord2(payload.change_summary);
+  const definition = summary ? asRecord2(summary.definition) : void 0;
+  const changed = definition && Array.isArray(definition.changed) ? definition.changed : [];
+  const removed = changed.some((raw) => {
+    const item = asRecord2(raw);
+    return asString(item?.path) === "payload.job_titles" && item?.before != null && item.after == null;
+  });
+  return removed ? [
+    "WARNING: this full deploy removes the job_titles filter.",
+    "Future findings will be unfiltered. Existing Customer DB rows are preserved.",
+    'Use `deepline monitors update <key> {"payload":{"job_titles":"..."}}` to change only the filter.'
+  ] : [];
+}
 function renderMonitorDeployCompletion(payload) {
   const monitor = asRecord2(payload.monitor);
   const key = monitor ? asString(monitor.key) : void 0;
@@ -30946,6 +30969,8 @@ function renderMonitorDeployCompletion(payload) {
     monitorKey: key
   });
   if (replacementWarning.length) lines.push("", ...replacementWarning);
+  const filterRemovalWarning = renderDeployFilterRemovalWarning(payload);
+  if (filterRemovalWarning.length) lines.push("", ...filterRemovalWarning);
   const guidance = asRecord2(payload.setup_guidance);
   if (guidance) {
     const callbackUrl = asString(guidance.callback_url);
@@ -31002,6 +31027,8 @@ function renderMonitorDeployPlan(payload) {
     completed: false
   });
   if (replacementWarning.length) lines.push("", ...replacementWarning);
+  const filterRemovalWarning = renderDeployFilterRemovalWarning(payload);
+  if (filterRemovalWarning.length) lines.push("", ...filterRemovalWarning);
   const estimate = asRecord2(payload.deploy_cost_estimate);
   const credits = estimate ? asFiniteNumber(estimate.credits) : void 0;
   if (credits !== void 0) {
@@ -31208,11 +31235,31 @@ function renderDeployedListText(payload, requestedStatus) {
     if (hasLastReceivedEvent) {
       lines.push(`    last received: ${lastReceivedEvent ?? "never"}`);
     }
+    if (Array.isArray(entry.bound_plays)) {
+      for (const rawPlay of entry.bound_plays) {
+        const play = asRecord2(rawPlay);
+        const playName = asString(play?.name) ?? "unnamed Play";
+        const health = asRecord2(play?.consumer_health);
+        const healthRequested = Boolean(play && "consumer_health" in play);
+        const state = healthRequested ? asString(health?.last_run_status) ?? "no delivery yet" : "health not requested";
+        const lastError = asString(health?.last_error);
+        lines.push(
+          `    consumer: ${playName} \u2014 ${state}${lastError ? ` (${lastError})` : ""}`
+        );
+      }
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
     `Status filter: ${applied}${requestedStatus === void 0 && applied === "active" ? " (default)" : ""} \u2014 use --status all to include disabled monitors.`
   );
+  const summary = Array.isArray(payload.status_summary) ? payload.status_summary.flatMap((raw) => {
+    const item = asRecord2(raw);
+    const status = item ? asString(item.status) : void 0;
+    const count = item ? asFiniteNumber(item.count) : void 0;
+    return status && count !== void 0 ? [`${status}: ${count}`] : [];
+  }).join("  ") : "";
+  if (summary) lines.push(`All lifecycle states: ${summary}`);
   if (payload.is_truncated === true) {
     const nextCursor = asString(payload.next_cursor);
     lines.push(
@@ -31231,7 +31278,8 @@ async function handleMonitorsList(options) {
     ...options.status ? { status: options.status } : {},
     ...options.limit ? { limit: options.limit } : {},
     ...options.cursor ? { cursor: options.cursor } : {},
-    ...options.compact ? { compact: true } : {}
+    ...options.compact ? { compact: true } : {},
+    ...options.includeConsumers ? { includeConsumers: true } : {}
   });
   printCommandEnvelope(payload, {
     json: options.json,
@@ -31294,6 +31342,10 @@ function renderMonitorGet(payload) {
   const webhook = asRecord2(payload.webhook);
   const guidance = asRecord2(payload.setup_guidance);
   const plays = dependents && Array.isArray(dependents.plays) ? dependents.plays : [];
+  const boundPlays = Array.isArray(payload.bound_plays) ? payload.bound_plays.flatMap((value) => {
+    const play = asRecord2(value);
+    return play ? [play] : [];
+  }) : [];
   const lines = [
     `Monitor: ${key}`,
     `Tool: ${tool}`,
@@ -31335,6 +31387,31 @@ function renderMonitorGet(payload) {
       `  deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
     );
   }
+  lines.push("", `Current SQL listener consumers (${boundPlays.length}):`);
+  if (boundPlays.length === 0) {
+    lines.push("  none");
+  } else {
+    for (const play of boundPlays) {
+      const name = asString(play.name) ?? "unnamed Play";
+      const listener = asString(play.listener_key);
+      const health = asRecord2(play.consumer_health);
+      const status2 = asString(health?.last_run_status) ?? "no delivery yet";
+      const lastDelivery = asFiniteNumber(health?.last_delivery_at);
+      const error = asString(health?.last_error);
+      lines.push(
+        `  ${name}${listener ? ` (listener: ${listener})` : ""}: ${status2}`
+      );
+      if (lastDelivery !== void 0) {
+        lines.push(
+          `    last delivery: ${new Date(lastDelivery).toISOString()}`
+        );
+      }
+      if (error) lines.push(`    error: ${error}`);
+    }
+  }
+  if (payload.consumer_health_truncated === true) {
+    lines.push("  Results are truncated; use --json for the returned detail.");
+  }
   lines.push("", `Dependent published plays (${plays.length}):`);
   if (plays.length === 0) {
     lines.push("  none");
@@ -31359,7 +31436,11 @@ function renderMonitorGet(payload) {
 async function handleMonitorsGet(key, options) {
   const client2 = new DeeplineClient();
   const payload = await client2.monitors.get(key);
-  const dependents = await client2.monitors.dependents(key);
+  const boundPlays = Array.isArray(payload.bound_plays) ? payload.bound_plays : null;
+  const dependents = boundPlays ? {
+    plays: boundPlays,
+    truncated: payload.consumer_health_truncated === true
+  } : await client2.monitors.dependents(key);
   const detail = { ...payload, dependents };
   printCommandEnvelope(detail, {
     json: options.json,
@@ -31372,7 +31453,8 @@ async function handleMonitorsTest(key, payload, options) {
     key,
     explicitPayload,
     {
-      validationOnly: options.dispatch !== true
+      validationOnly: options.dispatch !== true,
+      dispatch: options.dispatch === true
     }
   );
   const dispatch = options.dispatch === true;
@@ -31558,12 +31640,17 @@ Notes:
   not the page size), returned, is_truncated, and next_cursor. When is_truncated
   is true, page with --cursor <next_cursor> until it is false \u2014 a "no matching
   monitor" reuse conclusion off a truncated page deploys a duplicate paid feed.
+  The default list stays cheap: it includes the current downstream Play binding
+  metadata but does not resolve per-monitor delivery/run health. Pass
+  --include-consumers with --limit 20 or fewer to include the current
+  SQL-listener delivery/run health for each returned monitor.
 
 Examples:
   deepline monitors list
   deepline monitors list --status all --json
   deepline monitors list --status all --cursor <next_cursor> --json
   deepline monitors list --compact --json
+  deepline monitors list --include-consumers --limit 20 --json
 `
     ).option(
       "--status <status>",
@@ -31571,7 +31658,10 @@ Examples:
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"
-    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION).option(
+      "--include-consumers",
+      "Include current SQL-listener consumer health (requires --limit 20 or fewer)"
+    )
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     monitors.command("get <key>").description("Show a single deployed monitor by its public key.").addHelpText(
@@ -31621,10 +31711,11 @@ Notes:
   and optional controls (Deepline lifecycle metadata). Pass it positionally,
   via --file <path>, or
   from stdin with --file -. Does not deploy or spend credits.
-  For Deepline Native Company Radar monitors, check validates persona-filter enums and the
-  job_titles Boolean-expression grammar locally (parentheses are unsupported;
-  NOT > AND > OR).
-  Inspect the exact schema with
+  Check validates the local definition only. It does not contact an existing
+  upstream resource, prove that future events will arrive, or verify downstream
+  Play delivery. The JSON response reports this validation scope explicitly.
+  Provider-specific grammar, precedence, enum applicability, examples, and
+  update semantics are returned by the live monitor contract. Inspect it with
   \`deepline monitors available deepline_native.company_radar --json\`.
 
 Examples:
@@ -31733,7 +31824,10 @@ Examples:
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"
-    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION).option(
+      "--include-consumers",
+      "Include current SQL-listener consumer health (requires --limit 20 or fewer)"
+    )
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     deployed.command("get <key>").description("Alias of `monitors get <key>`.")

package/dist/{compiler-manifest-BPA3r-VG.d.mts → compiler-manifest-Cj3--4ZJ.d.mts}

@@ -1189,6 +1189,15 @@ type PlayAuthoringCustomerDbQueryOptions = {
 type PlayAuthoringRunStepsOptions = {
     description?: string;
 };
+/**
+ * Stable identity of the currently executing Play invocation.
+ *
+ * The id is unchanged while Deepline resumes or retries the same durable run.
+ * A separately submitted run intentionally receives a new id.
+ */
+type PlayAuthoringRunScope = {
+    readonly id: string;
+};
 /** The complete customer-authored `ctx` Interface shared by every Adapter. */
 interface PlayAuthoringRuntimeContext {
     /**
@@ -1203,6 +1212,11 @@ interface PlayAuthoringRuntimeContext {
     dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext>;
     /** @deprecated `ctx.map(...)` was replaced by `ctx.dataset(...)`. */
     map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: PlayAuthoringDatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;
+    /**
+     * Identity for this durable run. Use this to build a replay-stable external
+     * idempotency key, for example when posting a sequence of batches.
+     */
+    readonly run: PlayAuthoringRunScope;
     tools: {
         /**
          * Execute a provider tool through the durable receipt contract.

package/dist/{compiler-manifest-BPA3r-VG.d.ts → compiler-manifest-Cj3--4ZJ.d.ts}

@@ -1189,6 +1189,15 @@ type PlayAuthoringCustomerDbQueryOptions = {
 type PlayAuthoringRunStepsOptions = {
     description?: string;
 };
+/**
+ * Stable identity of the currently executing Play invocation.
+ *
+ * The id is unchanged while Deepline resumes or retries the same durable run.
+ * A separately submitted run intentionally receives a new id.
+ */
+type PlayAuthoringRunScope = {
+    readonly id: string;
+};
 /** The complete customer-authored `ctx` Interface shared by every Adapter. */
 interface PlayAuthoringRuntimeContext {
     /**
@@ -1203,6 +1212,11 @@ interface PlayAuthoringRuntimeContext {
     dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext>;
     /** @deprecated `ctx.map(...)` was replaced by `ctx.dataset(...)`. */
     map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: PlayAuthoringDatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;
+    /**
+     * Identity for this durable run. Use this to build a replay-stable external
+     * idempotency key, for example when posting a sequence of batches.
+     */
+    readonly run: PlayAuthoringRunScope;
     tools: {
         /**
          * Execute a provider tool through the durable receipt contract.

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q 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, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-BPA3r-VG.mjs';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-BPA3r-VG.mjs';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q 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, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Cj3--4ZJ.mjs';
+export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Cj3--4ZJ.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1430,12 +1430,22 @@ interface PlayCheckSqlListenerTrigger {
         after?: Record<string, Record<string, unknown>>;
     };
 }
+/**
+ * The input delivered to a SQL-listener Play invocation. One changed Customer
+ * DB row starts one run with this top-level event object; it is not an events
+ * array or a polling batch.
+ */
+interface PlayCheckSqlListenerEventSummary {
+    delivery: 'one_event_per_matched_row';
+    fields: Array<'tool' | 'stream' | 'operation' | 'before' | 'after' | 'changedAt' | 'metadata'>;
+}
 /**
  * Concise summary of the trigger bindings the server recognized for a play.
  * Only present triggers are populated.
  */
 interface PlayCheckTriggersSummary {
     sqlListeners?: PlayCheckSqlListenerTrigger[];
+    sqlListenerEvent?: PlayCheckSqlListenerEventSummary;
     cron?: {
         schedule: string;
         timezone?: string;
@@ -2082,6 +2092,7 @@ type MonitorListEntry = {
     webhook_state?: string;
     last_received_event?: string | null;
     bound_plays?: Array<Record<string, unknown>>;
+    consumer_health_truncated?: boolean;
     [key: string]: unknown;
 };
 /**
@@ -2096,6 +2107,11 @@ type MonitorsListResult = {
     is_truncated?: boolean;
     next_cursor?: string | null;
     status_filter_applied?: string;
+    status_summary?: Array<{
+        status: string;
+        count: number;
+    }>;
+    include_consumers?: boolean;
     [key: string]: unknown;
 };
 /** Options for `client.monitors.list(...)`. */
@@ -2106,6 +2122,8 @@ type MonitorsListOptions = {
     /** Page past a truncated result using a prior response's `next_cursor`. */
     cursor?: string;
     compact?: boolean;
+    /** Include bounded current SQL-listener delivery/run health (requires limit <= 20). */
+    includeConsumers?: boolean;
 };
 /**
  * Server-owned monitor payload shapes returned by the deploy/check/get/mutation
@@ -2183,9 +2201,9 @@ type MonitorsNamespace = {
     deploy: (definition: MonitorDefinition, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorDeployResult>;
-    /** List deployed monitors (active by default). */
+    /** List deployed monitors (active by default). `includeConsumers` requires a limit of 20 or fewer. */
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
-    /** Fetch one deployed monitor by public key (without dependents). */
+    /** Fetch one deployed monitor by public key with bounded current listener health. */
     get: (key: string) => Promise<MonitorDetail>;
     /**
      * Test a deployed monitor. `validationOnly` safely verifies the callback
@@ -2193,6 +2211,7 @@ type MonitorsNamespace = {
      */
     test: (key: string, payload: Record<string, unknown>, options?: {
         validationOnly?: boolean;
+        dispatch?: boolean;
     }) => Promise<MonitorTestResult>;
     validate: (key: string) => Promise<MonitorValidateResult>;
     /** List the published plays depending on one monitor's output streams. */
@@ -3527,6 +3546,7 @@ declare class DeeplineClient {
     getMonitor(key: string): Promise<MonitorDetail>;
     testMonitorWebhook(key: string, payload: Record<string, unknown>, options?: {
         validationOnly?: boolean;
+        dispatch?: boolean;
     }): Promise<MonitorTestResult>;
     setupMonitor(tool: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
     validateMonitor(key: string): Promise<MonitorValidateResult>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q 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, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-BPA3r-VG.js';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-BPA3r-VG.js';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q 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, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Cj3--4ZJ.js';
+export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Cj3--4ZJ.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1430,12 +1430,22 @@ interface PlayCheckSqlListenerTrigger {
         after?: Record<string, Record<string, unknown>>;
     };
 }
+/**
+ * The input delivered to a SQL-listener Play invocation. One changed Customer
+ * DB row starts one run with this top-level event object; it is not an events
+ * array or a polling batch.
+ */
+interface PlayCheckSqlListenerEventSummary {
+    delivery: 'one_event_per_matched_row';
+    fields: Array<'tool' | 'stream' | 'operation' | 'before' | 'after' | 'changedAt' | 'metadata'>;
+}
 /**
  * Concise summary of the trigger bindings the server recognized for a play.
  * Only present triggers are populated.
  */
 interface PlayCheckTriggersSummary {
     sqlListeners?: PlayCheckSqlListenerTrigger[];
+    sqlListenerEvent?: PlayCheckSqlListenerEventSummary;
     cron?: {
         schedule: string;
         timezone?: string;
@@ -2082,6 +2092,7 @@ type MonitorListEntry = {
     webhook_state?: string;
     last_received_event?: string | null;
     bound_plays?: Array<Record<string, unknown>>;
+    consumer_health_truncated?: boolean;
     [key: string]: unknown;
 };
 /**
@@ -2096,6 +2107,11 @@ type MonitorsListResult = {
     is_truncated?: boolean;
     next_cursor?: string | null;
     status_filter_applied?: string;
+    status_summary?: Array<{
+        status: string;
+        count: number;
+    }>;
+    include_consumers?: boolean;
     [key: string]: unknown;
 };
 /** Options for `client.monitors.list(...)`. */
@@ -2106,6 +2122,8 @@ type MonitorsListOptions = {
     /** Page past a truncated result using a prior response's `next_cursor`. */
     cursor?: string;
     compact?: boolean;
+    /** Include bounded current SQL-listener delivery/run health (requires limit <= 20). */
+    includeConsumers?: boolean;
 };
 /**
  * Server-owned monitor payload shapes returned by the deploy/check/get/mutation
@@ -2183,9 +2201,9 @@ type MonitorsNamespace = {
     deploy: (definition: MonitorDefinition, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorDeployResult>;
-    /** List deployed monitors (active by default). */
+    /** List deployed monitors (active by default). `includeConsumers` requires a limit of 20 or fewer. */
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
-    /** Fetch one deployed monitor by public key (without dependents). */
+    /** Fetch one deployed monitor by public key with bounded current listener health. */
     get: (key: string) => Promise<MonitorDetail>;
     /**
      * Test a deployed monitor. `validationOnly` safely verifies the callback
@@ -2193,6 +2211,7 @@ type MonitorsNamespace = {
      */
     test: (key: string, payload: Record<string, unknown>, options?: {
         validationOnly?: boolean;
+        dispatch?: boolean;
     }) => Promise<MonitorTestResult>;
     validate: (key: string) => Promise<MonitorValidateResult>;
     /** List the published plays depending on one monitor's output streams. */
@@ -3527,6 +3546,7 @@ declare class DeeplineClient {
     getMonitor(key: string): Promise<MonitorDetail>;
     testMonitorWebhook(key: string, payload: Record<string, unknown>, options?: {
         validationOnly?: boolean;
+        dispatch?: boolean;
     }): Promise<MonitorTestResult>;
     setupMonitor(tool: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
     validateMonitor(key: string): Promise<MonitorValidateResult>;

package/dist/index.js

@@ -763,7 +763,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.50",
+  version: "0.2.52",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5753,6 +5753,7 @@ var DeeplineClient = class {
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
     if (options?.compact) params.set("compact", "true");
+    if (options?.includeConsumers) params.set("include_consumers", "true");
     const query = params.toString();
     const suffix = query ? `?${query}` : "";
     return this.http.request(
@@ -5774,7 +5775,7 @@ var DeeplineClient = class {
         method: "POST",
         body: {
           payload,
-          ...options?.validationOnly ? { mode: "validation_only" } : {}
+          ...options?.validationOnly ? { mode: "validation_only" } : options?.dispatch ? { mode: "dispatch" } : {}
         }
       }
     );

package/dist/index.mjs

@@ -689,7 +689,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.50",
+  version: "0.2.52",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5679,6 +5679,7 @@ var DeeplineClient = class {
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
     if (options?.compact) params.set("compact", "true");
+    if (options?.includeConsumers) params.set("include_consumers", "true");
     const query = params.toString();
     const suffix = query ? `?${query}` : "";
     return this.http.request(
@@ -5700,7 +5701,7 @@ var DeeplineClient = class {
         method: "POST",
         body: {
           payload,
-          ...options?.validationOnly ? { mode: "validation_only" } : {}
+          ...options?.validationOnly ? { mode: "validation_only" } : options?.dispatch ? { mode: "dispatch" } : {}
         }
       }
     );

package/dist/install-integrity.json

@@ -215,8 +215,8 @@
     "dist/cli/index.d.ts",
     "dist/cli/index.js",
     "dist/cli/index.mjs",
-    "dist/compiler-manifest-BPA3r-VG.d.mts",
-    "dist/compiler-manifest-BPA3r-VG.d.ts",
+    "dist/compiler-manifest-Cj3--4ZJ.d.mts",
+    "dist/compiler-manifest-Cj3--4ZJ.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BPA3r-VG.mjs';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BPA3r-VG.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Cj3--4ZJ.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Cj3--4ZJ.mjs';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BPA3r-VG.js';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BPA3r-VG.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Cj3--4ZJ.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Cj3--4ZJ.js';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

package/dist/plays/bundle-play-file.mjs

@@ -3951,6 +3951,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  csv<T = Record<string, unknown>>(path: string | CsvInput<T & object>, options?: CsvOptions): Promise<PlayDataset<T>>;",
   "  dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): DatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object>;",
   "  map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: DatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;",
+  "  readonly run: { readonly id: string };",
   `  runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: { description?: ${cloudReferenceType("ctx.runSteps.options.description")} }): Promise<TOutput>;`,
   "  tools: { execute<K extends string>(request: ToolExecutionRequest<K>): Promise<ToolExecutionOutput<K>> };",
   `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { maxRows?: ${cloudReferenceType("ctx.customerDb.query.options.maxRows")}; timeoutMs?: ${cloudReferenceType("ctx.customerDb.query.options.timeoutMs")} }): Promise<TRow[]> };`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.50",
+  "version": "0.2.52",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {