deepline 0.1.202 → 0.1.204

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

@@ -106,10 +106,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.202',
+  version: '0.1.204',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.202',
+    latest: '0.1.204',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts

@@ -325,6 +325,9 @@ export type WorkerRuntimeApiContext = {
 };
 
 const APP_RUNTIME_API_RETRY_DELAYS_MS = [100, 250, 500, 1_000] as const;
+const APP_RUNTIME_API_RECEIPT_RETRY_DELAYS_MS = [
+  250, 500, 1_000, 2_000, 4_000, 8_000, 12_000,
+] as const;
 const APP_RUNTIME_API_APPEND_RETRY_DELAYS_MS = [
   100, 250, 500, 1_000, 2_000, 4_000, 8_000,
 ] as const;
@@ -485,9 +488,33 @@ function isRetryableAppRuntimeAction(
   );
 }
 
+function isRuntimeStepReceiptAction(
+  action: RuntimeApiRequest['action'],
+): boolean {
+  return (
+    action === 'get_runtime_step_receipt' ||
+    action === 'get_runtime_step_receipts' ||
+    action === 'heartbeat_runtime_step_receipts' ||
+    action === 'claim_runtime_step_receipt' ||
+    action === 'claim_runtime_step_receipts' ||
+    action === 'mark_runtime_step_receipt_running' ||
+    action === 'mark_runtime_step_receipts_running' ||
+    action === 'mark_runtime_step_receipts_queued' ||
+    action === 'complete_runtime_step_receipt' ||
+    action === 'complete_runtime_step_receipts' ||
+    action === 'fail_runtime_step_receipt' ||
+    action === 'fail_runtime_step_receipts' ||
+    action === 'release_runtime_step_receipt' ||
+    action === 'skip_runtime_step_receipt'
+  );
+}
+
 function appRuntimeRetryDelaysForAction(
   action: RuntimeApiRequest['action'],
 ): readonly number[] {
+  if (isRuntimeStepReceiptAction(action)) {
+    return APP_RUNTIME_API_RECEIPT_RETRY_DELAYS_MS;
+  }
   return action === 'append_run_events'
     ? APP_RUNTIME_API_APPEND_RETRY_DELAYS_MS
     : APP_RUNTIME_API_RETRY_DELAYS_MS;
@@ -586,7 +613,11 @@ async function postAppRuntimeApi<TResponse>(
         await sleep(appRuntimeRetryDelayMs(body.action, attempt));
         continue;
       }
-      throw error;
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `App runtime API ${body.action} failed before receiving a response from ${resolveAppRuntimeApiUrl(context)} after ${attempt}/${maxAttempts} attempts: ${message}`,
+        { cause: error },
+      );
     }
     if (response.ok) {
       return (await response.json()) as TResponse;

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

@@ -4006,6 +4006,7 @@ export class PlayContextImpl {
           {
             baseUrl: this.#options.baseUrl!,
             executorToken: this.#options.executorToken!,
+            dbSessionStrategy: this.#options.dbSessionStrategy,
             playName: this.#options.playName!,
             userEmail: this.#options.userEmail,
             runId: this.#options.runId!,
@@ -4529,6 +4530,7 @@ export class PlayContextImpl {
               {
                 baseUrl: this.#options.baseUrl!,
                 executorToken: this.#options.executorToken!,
+                dbSessionStrategy: this.#options.dbSessionStrategy,
                 playName: this.#options.playName!,
                 userEmail: this.#options.userEmail,
                 runId: this.#options.runId!,

package/dist/bundling-sources/shared_libs/play-runtime/ctx-types.ts

@@ -473,6 +473,11 @@ export interface ContextOptions {
   /** Short-lived HMAC-signed internal token for tool callbacks. Required for cloud execution. */
   executorToken?: string;
   baseUrl?: string;
+  /**
+   * Runtime-sheet transport selected by the runner. Daytona sandboxes use the
+   * execution gateway and must never fall back to minting direct DB sessions.
+   */
+  dbSessionStrategy?: 'preloaded' | 'sandbox_public_key' | 'gateway_only';
   vercelProtectionBypassToken?: string | null;
   /** Optional per-run integration execution mode for provider calls. */
   integrationMode?: 'live' | 'eval_stub' | 'fixture';

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona.ts

@@ -42,7 +42,7 @@ const DAYTONA_OUTPUT_TAIL_CHARS = 2_000;
 const DAYTONA_COMMAND_RECOVERY_TIMEOUT_MS = 60_000;
 const DAYTONA_COMMAND_RECOVERY_POLL_MS = 2_000;
 const DAYTONA_PROGRESS_SIDECAR_POLL_MS = 1_000;
-const DAYTONA_RUNTIME_DB_CONNECT_MAX_ATTEMPTS = 2;
+const DAYTONA_RUNTIME_INITIALIZATION_MAX_ATTEMPTS = 2;
 const DAYTONA_INFRASTRUCTURE_MAX_ATTEMPTS = 2;
 const DAYTONA_UPLOAD_MAX_ATTEMPTS = 2;
 const DAYTONA_UPLOAD_ATTEMPT_DEADLINE_MS = 90_000;
@@ -113,6 +113,8 @@ export async function withDaytonaOperationDeadline<T>(input: {
 }
 const RUNTIME_POSTGRES_CONNECT_RETRY_PATTERN =
   /\bRuntime Postgres\b.*\b(connection timed out|connect timeout|ETIMEDOUT|ECONNRESET|ECONNREFUSED|Connection terminated|Connection ended unexpectedly)\b/i;
+const RUNTIME_API_TRANSPORT_RETRY_PATTERN =
+  /\bRuntime API request to .+ failed before receiving a response:\s*(?:fetch failed|connection (?:terminated|timed out|closed|reset)|ECONNRESET|ETIMEDOUT|ECONNREFUSED)\b/i;
 const DAYTONA_INFRASTRUCTURE_RETRY_PATTERN =
   /\b(?:Request failed with status code (?:408|429|500|502|503|504)|ECONNRESET|ECONNREFUSED|ETIMEDOUT|UND_ERR_CONNECT_TIMEOUT|fetch failed|socket hang up|Daytona sandbox create failed across|Daytona sandbox create did not complete)\b/i;
 
@@ -494,13 +496,22 @@ function createDaytonaFailedResult(input: {
   };
 }
 
-function isRetryableRuntimePostgresConnectFailure(
+function retryableRuntimeInitializationFailureReason(
   result: PlayRunnerResult,
-): result is Extract<PlayRunnerResult, { status: 'failed' }> {
-  return (
-    result.status === 'failed' &&
-    RUNTIME_POSTGRES_CONNECT_RETRY_PATTERN.test(result.error)
-  );
+): 'runtime_postgres_connect' | 'runtime_api_transport' | null {
+  if (result.status !== 'failed') return null;
+  if (RUNTIME_POSTGRES_CONNECT_RETRY_PATTERN.test(result.error)) {
+    return 'runtime_postgres_connect';
+  }
+  const rowsProcessed = Number(result.stats?.rowsProcessed ?? 0);
+  if (
+    rowsProcessed === 0 &&
+    result.steps.length === 0 &&
+    RUNTIME_API_TRANSPORT_RETRY_PATTERN.test(result.error)
+  ) {
+    return 'runtime_api_transport';
+  }
+  return null;
 }
 
 function isRetryableDaytonaInfrastructureFailure(error: unknown): boolean {
@@ -640,7 +651,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
         let executionAttempt = 1;
         executionAttempt <=
         Math.max(
-          DAYTONA_RUNTIME_DB_CONNECT_MAX_ATTEMPTS,
+          DAYTONA_RUNTIME_INITIALIZATION_MAX_ATTEMPTS,
           DAYTONA_INFRASTRUCTURE_MAX_ATTEMPTS,
         );
         executionAttempt += 1
@@ -868,14 +879,17 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
 
           const result = findPlayRunnerResult(events);
           if (result) {
+            const initializationRetryReason =
+              retryableRuntimeInitializationFailureReason(result);
             if (
-              executionAttempt < DAYTONA_RUNTIME_DB_CONNECT_MAX_ATTEMPTS &&
-              isRetryableRuntimePostgresConnectFailure(result)
+              result.status === 'failed' &&
+              executionAttempt < DAYTONA_RUNTIME_INITIALIZATION_MAX_ATTEMPTS &&
+              initializationRetryReason
             ) {
               emitDaytonaStage(callbacks, config.context, 'execute:retry', {
                 sandboxId: sandbox.id,
                 attempt: executionAttempt + 1,
-                reason: 'runtime_postgres_connect',
+                reason: initializationRetryReason,
                 error: result.error,
                 elapsedMs: Date.now() - startedAt,
               });

package/dist/bundling-sources/shared_libs/play-runtime/runtime-api-paths.ts

@@ -1,5 +1,7 @@
 export const PLAY_RUNTIME_API_COMPAT_PATH = '/api/v2/plays/internal/runtime';
 export const PLAY_RUNTIME_API_CURRENT_PATH = '/api/v2/internal/play-runtime';
+export const PLAY_RUNTIME_ATTEMPT_EXECUTOR_TOKEN_PATH =
+  '/api/v2/internal/play-runtime/executor-token';
 export const PLAY_RUNTIME_CHILD_EXECUTOR_TOKEN_COMPAT_PATH =
   '/api/v2/plays/internal/child-executor-token';
 export const PLAY_RUNTIME_CHILD_EXECUTOR_TOKEN_CURRENT_PATH =

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

@@ -2884,10 +2884,10 @@ async function prepareRuntimeSheetDatasetRows(
             AND (
               ${targetAttemptFenceSql}
               OR ${targetOlderForeignAttemptOwnerSql}
-              OR (
-                $11::boolean
-                AND target._status = 'failed'
-              )
+              -- Failed rows are repairable projection state, never terminal
+              -- ownership. This matches decideRuntimeSheetPrepare(): any
+              -- attempt may reclaim them, even after a newer failed attempt.
+              OR target._status = 'failed'
             )
             AND (
               target._run_id IS DISTINCT FROM $4::text
@@ -2919,14 +2919,13 @@ async function prepareRuntimeSheetDatasetRows(
                AND NOT (${existingNewerTerminalRowSql})
                AND (
                  ${existingAttemptFenceSql}
+                 -- See claimed_existing_rows: failed rows remain repairable
+                 -- across attempt ordering, while enriched rows stay fenced.
+                 OR existing._status = 'failed'
                  OR (
                    ${existingForeignAttemptOwnerSql}
                    AND COALESCE(existing._attempt_seq, 0) < $10::integer
                  )
-                 OR (
-                   $11::boolean
-                   AND existing._status = 'failed'
-                 )
                )
              )
              OR (

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.202",
+  version: "0.1.204",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.204",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -14113,7 +14113,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       --profile defaults to workers_edge, unless your local dev server exports a dev default such as absurd.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
+  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       Production defaults to workers_edge. Use --profile absurd only for an explicit Absurd run.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -16116,6 +16116,7 @@ Examples:
   deepline plays run prebuilt/person-linkedin-to-email --input '{"linkedin_url":"..."}'
   deepline plays run long-background-play --no-wait
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
+  deepline plays run my.play.ts --profile absurd
   deepline plays run my.play.ts --input @input.json --json
   deepline plays run cto-search.play.ts --limit 5
   deepline runs export <run-id> --out output.csv
@@ -18315,6 +18316,8 @@ var ENRICH_CELL_META_PATCH_FIELD = "__deeplineCellMetaPatch";
 var EXIT_SERVER2 = 5;
 var ENRICH_DEBUG_T0 = Date.now();
 var GENERATED_ENRICH_ROWS_TABLE_NAMESPACE = "deepline_enrich_rows";
+var SDK_ENRICH_TELEMETRY_TIMEOUT_MS = 1e4;
+var SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH = 2e4;
 var HEAVY_ENRICH_AUTO_BATCH_PLAYS = /* @__PURE__ */ new Set([
   "company-to-contact",
   "company-to-contact-by-role-waterfall",
@@ -18592,6 +18595,100 @@ function currentEnrichArgs() {
   const index = process.argv.findIndex((arg) => arg === "enrich");
   return index >= 0 ? process.argv.slice(index + 1) : [];
 }
+function shouldSuppressSdkEnrichTelemetry() {
+  return ["1", "true", "yes", "on"].includes(
+    String(process.env.DEEPLINE_SUPPRESS_ACTIVITY_EVENTS ?? "").trim().toLowerCase()
+  );
+}
+function shellQuoteArg(value) {
+  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function sdkEnrichCommandText(args) {
+  const command = ["deepline", "enrich", ...args].map(shellQuoteArg).join(" ");
+  if (command.length <= SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH) {
+    return command;
+  }
+  return `${command.slice(0, SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH - 3)}...`;
+}
+function countConfiguredEnrichColumns(config) {
+  const count = (commands) => commands.reduce((total, command) => {
+    if ("with_waterfall" in command) {
+      return total + count(command.commands);
+    }
+    return total + (command.disabled ? 0 : 1);
+  }, 0);
+  return count(config.commands ?? []);
+}
+function createSdkEnrichTelemetryContext(input2) {
+  if (shouldSuppressSdkEnrichTelemetry()) {
+    return null;
+  }
+  const baseUrl = input2.client.baseUrl.replace(/\/$/, "");
+  let apiKey = null;
+  try {
+    apiKey = resolveApiKeyForBaseUrl(baseUrl);
+  } catch {
+    apiKey = null;
+  }
+  return {
+    baseUrl,
+    apiKey,
+    runId: `sdk-enrich-${process.pid}-${Date.now()}`,
+    command: sdkEnrichCommandText(input2.args),
+    rowsRange: input2.rowsRange,
+    inputPath: (0, import_node_path12.basename)(input2.inputCsv),
+    startedAtMs: Date.now(),
+    rowsTargeted: input2.selectedRange.count,
+    columnsTargeted: countConfiguredEnrichColumns(input2.config)
+  };
+}
+async function emitSdkEnrichTelemetry(context, event, summary) {
+  if (!context?.apiKey) {
+    return;
+  }
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    SDK_ENRICH_TELEMETRY_TIMEOUT_MS
+  );
+  try {
+    const body = {
+      event,
+      source: "cli_enrich",
+      run_id: context.runId,
+      command: context.command,
+      input_path: context.inputPath,
+      ...context.rowsRange ? { rows_range: context.rowsRange } : {},
+      ...summary ? { summary } : {}
+    };
+    await fetch(new URL("/api/v2/telemetry/activity", context.baseUrl), {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${context.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body),
+      signal: controller.signal
+    });
+  } catch {
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function completeSdkEnrichTelemetry(context, input2) {
+  await emitSdkEnrichTelemetry(context, "enrich_completed", {
+    status: input2.status,
+    rows_targeted: context?.rowsTargeted ?? 0,
+    columns_targeted: context?.columnsTargeted ?? 0,
+    failed_jobs: Math.max(0, Math.trunc(input2.failedJobs ?? 0)),
+    skipped_cells: Math.max(0, Math.trunc(input2.skippedCells ?? 0)),
+    duration_ms: Math.max(0, Date.now() - (context?.startedAtMs ?? Date.now())),
+    rate_limits: null
+  });
+}
 async function buildPlanArgs(args) {
   const passthrough = /* @__PURE__ */ new Set([
     "--with",
@@ -21754,7 +21851,25 @@ function registerEnrichCommand(program) {
       inlineRunJavascript: true,
       failFast: options.failFast
     });
+    const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
+    const sdkEnrichTelemetry = createSdkEnrichTelemetryContext({
+      client: client2,
+      args,
+      inputCsv,
+      rowsRange: options.rows ?? (options.all ? "all" : null),
+      selectedRange,
+      config
+    });
+    let sdkEnrichTelemetryCompleted = false;
+    const completeTelemetry = async (input2) => {
+      if (sdkEnrichTelemetryCompleted) {
+        return;
+      }
+      sdkEnrichTelemetryCompleted = true;
+      await completeSdkEnrichTelemetry(sdkEnrichTelemetry, input2);
+    };
     const tempDir = await (0, import_promises3.mkdtemp)((0, import_node_path12.join)((0, import_node_os8.tmpdir)(), "deepline-enrich-play-"));
+    await emitSdkEnrichTelemetry(sdkEnrichTelemetry, "enrich_started");
     const tempPlay = (0, import_node_path12.join)(tempDir, "deepline-enrich.play.ts");
     let inPlaceTempDir = null;
     let inPlaceTempOutputPath = null;
@@ -21853,7 +21968,6 @@ function registerEnrichCommand(program) {
         });
         return { captured: captured2, status: status2, exportResult: exportResult2 };
       };
-      const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
@@ -22034,6 +22148,10 @@ function registerEnrichCommand(program) {
               });
             }
             process.exitCode = failureReport3 ? EXIT_SERVER2 : chunk.captured.result;
+            await completeTelemetry({
+              status: "failed",
+              failedJobs: failureReport3?.jobs.length ?? 1
+            });
             return;
           }
           if (chunk.exportResult) {
@@ -22112,6 +22230,10 @@ function registerEnrichCommand(program) {
         if (failureReport2) {
           process.exitCode = EXIT_SERVER2;
         }
+        await completeTelemetry({
+          status: failureReport2 ? "completed_with_failures" : "completed",
+          failedJobs: failureReport2?.jobs.length ?? 0
+        });
         return;
       }
       const { captured, status, exportResult } = await runOne({
@@ -22154,6 +22276,10 @@ function registerEnrichCommand(program) {
           });
         }
         process.exitCode = failureReport2 ? EXIT_SERVER2 : captured.result;
+        await completeTelemetry({
+          status: "failed",
+          failedJobs: failureReport2?.jobs.length ?? 1
+        });
         return;
       }
       if (options.json) {
@@ -22190,6 +22316,10 @@ function registerEnrichCommand(program) {
         if (failureReport2) {
           process.exitCode = EXIT_SERVER2;
         }
+        await completeTelemetry({
+          status: failureReport2 ? "completed_with_failures" : "completed",
+          failedJobs: failureReport2?.jobs.length ?? 0
+        });
         return;
       }
       const failureReport = await maybeEmitEnrichFailureReport({
@@ -22220,6 +22350,13 @@ function registerEnrichCommand(program) {
       if (failureReport) {
         process.exitCode = EXIT_SERVER2;
       }
+      await completeTelemetry({
+        status: failureReport ? "completed_with_failures" : "completed",
+        failedJobs: failureReport?.jobs.length ?? 0
+      });
+    } catch (error) {
+      await completeTelemetry({ status: "failed", failedJobs: 1 });
+      throw error;
     } finally {
       if (inPlaceTempDir) {
         await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.202",
+  version: "0.1.204",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.204",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -14142,7 +14142,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       --profile defaults to workers_edge, unless your local dev server exports a dev default such as absurd.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
+  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       Production defaults to workers_edge. Use --profile absurd only for an explicit Absurd run.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -16145,6 +16145,7 @@ Examples:
   deepline plays run prebuilt/person-linkedin-to-email --input '{"linkedin_url":"..."}'
   deepline plays run long-background-play --no-wait
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
+  deepline plays run my.play.ts --profile absurd
   deepline plays run my.play.ts --input @input.json --json
   deepline plays run cto-search.play.ts --limit 5
   deepline runs export <run-id> --out output.csv
@@ -18344,6 +18345,8 @@ var ENRICH_CELL_META_PATCH_FIELD = "__deeplineCellMetaPatch";
 var EXIT_SERVER2 = 5;
 var ENRICH_DEBUG_T0 = Date.now();
 var GENERATED_ENRICH_ROWS_TABLE_NAMESPACE = "deepline_enrich_rows";
+var SDK_ENRICH_TELEMETRY_TIMEOUT_MS = 1e4;
+var SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH = 2e4;
 var HEAVY_ENRICH_AUTO_BATCH_PLAYS = /* @__PURE__ */ new Set([
   "company-to-contact",
   "company-to-contact-by-role-waterfall",
@@ -18621,6 +18624,100 @@ function currentEnrichArgs() {
   const index = process.argv.findIndex((arg) => arg === "enrich");
   return index >= 0 ? process.argv.slice(index + 1) : [];
 }
+function shouldSuppressSdkEnrichTelemetry() {
+  return ["1", "true", "yes", "on"].includes(
+    String(process.env.DEEPLINE_SUPPRESS_ACTIVITY_EVENTS ?? "").trim().toLowerCase()
+  );
+}
+function shellQuoteArg(value) {
+  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function sdkEnrichCommandText(args) {
+  const command = ["deepline", "enrich", ...args].map(shellQuoteArg).join(" ");
+  if (command.length <= SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH) {
+    return command;
+  }
+  return `${command.slice(0, SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH - 3)}...`;
+}
+function countConfiguredEnrichColumns(config) {
+  const count = (commands) => commands.reduce((total, command) => {
+    if ("with_waterfall" in command) {
+      return total + count(command.commands);
+    }
+    return total + (command.disabled ? 0 : 1);
+  }, 0);
+  return count(config.commands ?? []);
+}
+function createSdkEnrichTelemetryContext(input2) {
+  if (shouldSuppressSdkEnrichTelemetry()) {
+    return null;
+  }
+  const baseUrl = input2.client.baseUrl.replace(/\/$/, "");
+  let apiKey = null;
+  try {
+    apiKey = resolveApiKeyForBaseUrl(baseUrl);
+  } catch {
+    apiKey = null;
+  }
+  return {
+    baseUrl,
+    apiKey,
+    runId: `sdk-enrich-${process.pid}-${Date.now()}`,
+    command: sdkEnrichCommandText(input2.args),
+    rowsRange: input2.rowsRange,
+    inputPath: basename2(input2.inputCsv),
+    startedAtMs: Date.now(),
+    rowsTargeted: input2.selectedRange.count,
+    columnsTargeted: countConfiguredEnrichColumns(input2.config)
+  };
+}
+async function emitSdkEnrichTelemetry(context, event, summary) {
+  if (!context?.apiKey) {
+    return;
+  }
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    SDK_ENRICH_TELEMETRY_TIMEOUT_MS
+  );
+  try {
+    const body = {
+      event,
+      source: "cli_enrich",
+      run_id: context.runId,
+      command: context.command,
+      input_path: context.inputPath,
+      ...context.rowsRange ? { rows_range: context.rowsRange } : {},
+      ...summary ? { summary } : {}
+    };
+    await fetch(new URL("/api/v2/telemetry/activity", context.baseUrl), {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${context.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body),
+      signal: controller.signal
+    });
+  } catch {
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function completeSdkEnrichTelemetry(context, input2) {
+  await emitSdkEnrichTelemetry(context, "enrich_completed", {
+    status: input2.status,
+    rows_targeted: context?.rowsTargeted ?? 0,
+    columns_targeted: context?.columnsTargeted ?? 0,
+    failed_jobs: Math.max(0, Math.trunc(input2.failedJobs ?? 0)),
+    skipped_cells: Math.max(0, Math.trunc(input2.skippedCells ?? 0)),
+    duration_ms: Math.max(0, Date.now() - (context?.startedAtMs ?? Date.now())),
+    rate_limits: null
+  });
+}
 async function buildPlanArgs(args) {
   const passthrough = /* @__PURE__ */ new Set([
     "--with",
@@ -21783,7 +21880,25 @@ function registerEnrichCommand(program) {
       inlineRunJavascript: true,
       failFast: options.failFast
     });
+    const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
+    const sdkEnrichTelemetry = createSdkEnrichTelemetryContext({
+      client: client2,
+      args,
+      inputCsv,
+      rowsRange: options.rows ?? (options.all ? "all" : null),
+      selectedRange,
+      config
+    });
+    let sdkEnrichTelemetryCompleted = false;
+    const completeTelemetry = async (input2) => {
+      if (sdkEnrichTelemetryCompleted) {
+        return;
+      }
+      sdkEnrichTelemetryCompleted = true;
+      await completeSdkEnrichTelemetry(sdkEnrichTelemetry, input2);
+    };
     const tempDir = await mkdtemp(join7(tmpdir2(), "deepline-enrich-play-"));
+    await emitSdkEnrichTelemetry(sdkEnrichTelemetry, "enrich_started");
     const tempPlay = join7(tempDir, "deepline-enrich.play.ts");
     let inPlaceTempDir = null;
     let inPlaceTempOutputPath = null;
@@ -21882,7 +21997,6 @@ function registerEnrichCommand(program) {
         });
         return { captured: captured2, status: status2, exportResult: exportResult2 };
       };
-      const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
@@ -22063,6 +22177,10 @@ function registerEnrichCommand(program) {
               });
             }
             process.exitCode = failureReport3 ? EXIT_SERVER2 : chunk.captured.result;
+            await completeTelemetry({
+              status: "failed",
+              failedJobs: failureReport3?.jobs.length ?? 1
+            });
             return;
           }
           if (chunk.exportResult) {
@@ -22141,6 +22259,10 @@ function registerEnrichCommand(program) {
         if (failureReport2) {
           process.exitCode = EXIT_SERVER2;
         }
+        await completeTelemetry({
+          status: failureReport2 ? "completed_with_failures" : "completed",
+          failedJobs: failureReport2?.jobs.length ?? 0
+        });
         return;
       }
       const { captured, status, exportResult } = await runOne({
@@ -22183,6 +22305,10 @@ function registerEnrichCommand(program) {
           });
         }
         process.exitCode = failureReport2 ? EXIT_SERVER2 : captured.result;
+        await completeTelemetry({
+          status: "failed",
+          failedJobs: failureReport2?.jobs.length ?? 1
+        });
         return;
       }
       if (options.json) {
@@ -22219,6 +22345,10 @@ function registerEnrichCommand(program) {
         if (failureReport2) {
           process.exitCode = EXIT_SERVER2;
         }
+        await completeTelemetry({
+          status: failureReport2 ? "completed_with_failures" : "completed",
+          failedJobs: failureReport2?.jobs.length ?? 0
+        });
         return;
       }
       const failureReport = await maybeEmitEnrichFailureReport({
@@ -22249,6 +22379,13 @@ function registerEnrichCommand(program) {
       if (failureReport) {
         process.exitCode = EXIT_SERVER2;
       }
+      await completeTelemetry({
+        status: failureReport ? "completed_with_failures" : "completed",
+        failedJobs: failureReport?.jobs.length ?? 0
+      });
+    } catch (error) {
+      await completeTelemetry({ status: "failed", failedJobs: 1 });
+      throw error;
     } finally {
       if (inPlaceTempDir) {
         await rm(inPlaceTempDir, { recursive: true, force: true });

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.202",
+  version: "0.1.204",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.204",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.202",
+  version: "0.1.204",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.204",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

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