deepline 0.1.202 → 0.1.203

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.203',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.202',
+    latest: '0.1.203',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

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/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/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.203",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.203",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -18315,6 +18315,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 +18594,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 +21850,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 +21967,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 +22147,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 +22229,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 +22275,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 +22315,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 +22349,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.203",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.203",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -18344,6 +18344,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 +18623,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 +21879,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 +21996,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 +22176,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 +22258,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 +22304,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 +22344,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 +22378,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.203",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.203",
     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.203",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.202",
+    latest: "0.1.203",
     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.203",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {