deepline 0.2.55 → 0.2.57

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.55",
+  version: "0.2.57",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1613,9 +1613,26 @@ var HttpClient = class {
         if (error instanceof AuthError || error instanceof DeeplineError) {
           throw error;
         }
-        lastError = error instanceof Error ? error : new Error(String(error));
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        if (isAbortLikeError(normalized) && options?.signal?.aborted) {
+          throw new DeeplineError(
+            `Stream from ${this.config.baseUrl} was aborted by the caller.`,
+            void 0,
+            "ABORTED"
+          );
+        }
+        lastError = normalized;
       }
     }
+    if (lastError && isAbortLikeError(lastError)) {
+      throw new DeeplineError(
+        withCoworkNetworkHint(
+          `Unable to stream from ${this.config.baseUrl}. The remote stream was interrupted.`
+        ),
+        void 0,
+        "PLAY_STREAM_NETWORK_ABORTED"
+      );
+    }
     throw new DeeplineError(
       withCoworkNetworkHint(
         lastError?.message ? `Unable to stream from ${this.config.baseUrl}. ${lastError.message}` : `Unable to stream from ${this.config.baseUrl}.`
@@ -1878,6 +1895,9 @@ function streamReconnectDelayMs(attempt) {
   return Math.max(1, Math.floor(Math.random() * (cappedExponentialMs + 1)));
 }
 function isTransientPlayStreamError(error) {
+  if (error instanceof DeeplineError && error.code === "PLAY_STREAM_NETWORK_ABORTED") {
+    return true;
+  }
   if (error instanceof DeeplineError && typeof error.statusCode === "number") {
     return error.statusCode >= 500 && error.statusCode < 600;
   }
@@ -2030,6 +2050,7 @@ var RUNTIME_RECEIPT_OUTPUT_MAX_BYTES = 10 * 1024 * 1024;
 var RUNTIME_RECEIPT_COMPLETION_BUFFER_MAX_BYTES = 32 * 1024 * 1024;
 var RUNNER_TERMINAL_PUSH_MAX_BODY_BYTES = 16 * 1024 * 1024;
 var RUNTIME_RECEIPT_GATEWAY_BATCH_MAX_BYTES = 12 * 1024 * 1024;
+var RUNTIME_RECEIPT_WRITER_TARGET_BATCH_BYTES = 4 * 1024 * 1024;
 var RUNNER_POST_TERMINAL_DIAGNOSTIC_MAX_BYTES = 64 * 1024;
 
 // ../shared_libs/play-runtime/ledger-safe-payload.ts
@@ -4612,6 +4633,10 @@ var DeeplineClient = class {
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
         ...forceToolRefresh ? { forceToolRefresh: true } : {},
+        ...typeof request.maxConcurrentExternalCalls === "number" ? {
+          maxConcurrentExternalCalls: request.maxConcurrentExternalCalls
+        } : {},
+        ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to absurd; callers normally omit this field.
@@ -4664,6 +4689,8 @@ var DeeplineClient = class {
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
       ...forceToolRefresh ? { forceToolRefresh: true } : {},
+      ...typeof request.maxConcurrentExternalCalls === "number" ? { maxConcurrentExternalCalls: request.maxConcurrentExternalCalls } : {},
+      ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {},
@@ -8756,14 +8783,14 @@ function invoiceDateText(createdAt) {
 }
 function invoiceLine(entry, compact) {
   const amount = invoiceAmountText(entry.amount_cents, entry.currency);
-  const link = entry.url ?? "(no link)";
+  const link2 = entry.url ?? "(no link)";
   if (compact) {
     return [
       entry.id,
       invoiceDateText(entry.created_at),
       amount,
       entry.status,
-      link
+      link2
     ].join(" | ");
   }
   return [
@@ -8771,7 +8798,7 @@ function invoiceLine(entry, compact) {
     entry.description,
     amount,
     entry.status,
-    link
+    link2
   ].join(" | ");
 }
 async function handleInvoices(options) {
@@ -10925,7 +10952,7 @@ Examples:
 // src/cli/commands/enrich.ts
 import {
   copyFile,
-  lstat,
+  lstat as lstat2,
   mkdir as mkdir4,
   mkdtemp,
   readFile as readFile3,
@@ -10940,7 +10967,7 @@ import { basename as basename4, dirname as dirname10, extname as extname3, join
 import { Option } from "commander";
 
 // src/cli/commands/play.ts
-import { createHash as createHash4 } from "crypto";
+import { createHash as createHash4, randomUUID as randomUUID3 } from "crypto";
 import {
   existsSync as existsSync9,
   readFileSync as readFileSync8,
@@ -10949,6 +10976,13 @@ import {
   statSync as statSync3,
   writeFileSync as writeFileSync9
 } from "fs";
+import {
+  lstat,
+  link,
+  open,
+  readFile as readFileAsync,
+  unlink
+} from "fs/promises";
 import { basename as basename3, dirname as dirname9, join as join10, resolve as resolve11 } from "path";
 import { parse as parseCsvSync2 } from "csv-parse/sync";
 
@@ -16656,6 +16690,12 @@ function isDefinePlayCall(node) {
   }
   return false;
 }
+function definePlayName(node) {
+  const expression = unwrapStaticExpression(node);
+  if (!expression || expression.type !== "CallExpression") return null;
+  const first = astArray(expression.arguments)[0] ?? null;
+  return first?.type === "Literal" && typeof first.value === "string" ? first.value : null;
+}
 function listPlayFileExports(sourceCode) {
   const ast = parsePlaySourceForAnalysis(sourceCode);
   if (!ast) return null;
@@ -16705,13 +16745,24 @@ function listPlayFileExports(sourceCode) {
   if (defaultIsPlay) {
     const aliases = defaultLocalName ? [...namedExports.entries()].filter(([, local]) => local === defaultLocalName).map(([exported]) => exported) : [];
     if (defaultLocalName) aliasedLocals.add(defaultLocalName);
-    exports.push({ name: PLAY_DEFAULT_EXPORT, aliases });
+    exports.push({
+      name: PLAY_DEFAULT_EXPORT,
+      aliases,
+      playName: definePlayName(
+        defaultLocalName ? declarations.get(defaultLocalName) ?? null : defaultExpression
+      )
+    });
   }
   for (const [exportedName, localName] of namedExports) {
     if (exportedName === PLAY_DEFAULT_EXPORT) continue;
     if (aliasedLocals.has(localName)) continue;
-    if (!isDefinePlayCall(declarations.get(localName) ?? null)) continue;
-    exports.push({ name: exportedName, aliases: [] });
+    const declaration = declarations.get(localName) ?? null;
+    if (!isDefinePlayCall(declaration)) continue;
+    exports.push({
+      name: exportedName,
+      aliases: [],
+      playName: definePlayName(declaration)
+    });
   }
   return exports;
 }
@@ -17623,6 +17674,31 @@ ${hint}`;
   });
 }
 
+// ../shared_libs/play-runtime/governor/policy.ts
+var DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS = 64;
+var MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS = 256;
+var MAX_CONFIGURABLE_CONCURRENT_ROWS = 1e3;
+function resolveMaxConcurrentExternalCalls(requested) {
+  if (requested === void 0 || requested === null) {
+    return DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS;
+  }
+  if (!Number.isSafeInteger(requested) || requested < 1 || requested > MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS) {
+    throw new Error(
+      `maxConcurrentExternalCalls must be a whole number from 1 through ${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS}.`
+    );
+  }
+  return requested;
+}
+function resolveMaxConcurrentRows(requested) {
+  if (requested === void 0 || requested === null) return null;
+  if (!Number.isSafeInteger(requested) || requested < 1 || requested > MAX_CONFIGURABLE_CONCURRENT_ROWS) {
+    throw new Error(
+      `maxConcurrentRows must be a whole number from 1 through ${MAX_CONFIGURABLE_CONCURRENT_ROWS}.`
+    );
+  }
+  return requested;
+}
+
 // ../shared_libs/play-runtime/sandbox-runtime-limits.ts
 var PLAY_SANDBOX_SIZE_LIMITS = {
   standard: {
@@ -17847,6 +17923,7 @@ function stripLeadingTimestamp(line) {
 // ../shared_libs/play-runtime/fixture-behavior.ts
 var FIXTURE_BEHAVIOR_VERSION = 1;
 var FIXTURE_BEHAVIOR_RESPONSE_VERSION = 2;
+var FIXTURE_BEHAVIOR_REPLAY_VERSION = 3;
 var MAX_FIXTURE_RESPONSE_DELAY_SAMPLES = 256;
 var MAX_FIXTURE_RESPONSE_DELAY_MS = 8 * 6e4;
 var MAX_FIXTURE_RESPONSE_ERROR_MESSAGE_LENGTH = 500;
@@ -17858,7 +17935,11 @@ function validateFixtureBehavior(value) {
     return { ok: false, error: "fixtureBehavior must be a JSON object." };
   }
   const record = value;
-  const supportedKeys = record.version === FIXTURE_BEHAVIOR_RESPONSE_VERSION ? /* @__PURE__ */ new Set(["version", "responseSamples"]) : /* @__PURE__ */ new Set(["version", "responseDelaySamplesMs"]);
+  const supportedKeys = record.version === FIXTURE_BEHAVIOR_RESPONSE_VERSION || record.version === FIXTURE_BEHAVIOR_REPLAY_VERSION ? /* @__PURE__ */ new Set([
+    "version",
+    "responseSamples",
+    ...record.version === FIXTURE_BEHAVIOR_REPLAY_VERSION ? ["replayBundle"] : []
+  ]) : /* @__PURE__ */ new Set(["version", "responseDelaySamplesMs"]);
   const unknownKeys = Object.keys(record).filter(
     (key) => !supportedKeys.has(key)
   );
@@ -17868,13 +17949,13 @@ function validateFixtureBehavior(value) {
       error: `Unsupported fixtureBehavior field "${unknownKeys[0]}".`
     };
   }
-  if (record.version !== FIXTURE_BEHAVIOR_VERSION && record.version !== FIXTURE_BEHAVIOR_RESPONSE_VERSION) {
+  if (record.version !== FIXTURE_BEHAVIOR_VERSION && record.version !== FIXTURE_BEHAVIOR_RESPONSE_VERSION && record.version !== FIXTURE_BEHAVIOR_REPLAY_VERSION) {
     return {
       ok: false,
-      error: `fixtureBehavior.version must be ${FIXTURE_BEHAVIOR_VERSION} or ${FIXTURE_BEHAVIOR_RESPONSE_VERSION}.`
+      error: `fixtureBehavior.version must be ${FIXTURE_BEHAVIOR_VERSION} or ${FIXTURE_BEHAVIOR_RESPONSE_VERSION}, or ${FIXTURE_BEHAVIOR_REPLAY_VERSION}.`
     };
   }
-  if (record.version === FIXTURE_BEHAVIOR_RESPONSE_VERSION) {
+  if (record.version === FIXTURE_BEHAVIOR_RESPONSE_VERSION || record.version === FIXTURE_BEHAVIOR_REPLAY_VERSION) {
     if (!Array.isArray(record.responseSamples) || record.responseSamples.length === 0 || record.responseSamples.length > MAX_FIXTURE_RESPONSE_DELAY_SAMPLES) {
       return {
         ok: false,
@@ -17981,6 +18062,72 @@ function validateFixtureBehavior(value) {
         ...httpError ? { httpError } : {}
       });
     }
+    let replayBundle;
+    if (record.version === FIXTURE_BEHAVIOR_REPLAY_VERSION) {
+      if (!record.replayBundle || typeof record.replayBundle !== "object" || Array.isArray(record.replayBundle)) {
+        return {
+          ok: false,
+          error: "fixtureBehavior.replayBundle must be an object."
+        };
+      }
+      const replay = record.replayBundle;
+      const replayUnknownKeys = Object.keys(replay).filter(
+        (key) => key !== "bundleId" && key !== "manifestSha256" && key !== "syntheticFallbackToolIds"
+      );
+      if (replayUnknownKeys.length > 0) {
+        return {
+          ok: false,
+          error: `Unsupported fixtureBehavior.replayBundle field "${replayUnknownKeys[0]}".`
+        };
+      }
+      const digestPattern = /^[a-f0-9]{64}$/;
+      if (typeof replay.bundleId !== "string" || !digestPattern.test(replay.bundleId)) {
+        return {
+          ok: false,
+          error: "fixtureBehavior.replayBundle.bundleId must be a lowercase SHA-256 digest."
+        };
+      }
+      if (typeof replay.manifestSha256 !== "string" || !digestPattern.test(replay.manifestSha256)) {
+        return {
+          ok: false,
+          error: "fixtureBehavior.replayBundle.manifestSha256 must be a lowercase SHA-256 digest."
+        };
+      }
+      let syntheticFallbackToolIds;
+      if (replay.syntheticFallbackToolIds !== void 0) {
+        if (!Array.isArray(replay.syntheticFallbackToolIds) || replay.syntheticFallbackToolIds.length === 0 || replay.syntheticFallbackToolIds.length > 32) {
+          return {
+            ok: false,
+            error: "fixtureBehavior.replayBundle.syntheticFallbackToolIds must contain 1-32 tool ids."
+          };
+        }
+        syntheticFallbackToolIds = [];
+        for (const rawToolId of replay.syntheticFallbackToolIds) {
+          if (typeof rawToolId !== "string" || rawToolId !== rawToolId.trim().toLowerCase() || !/^[a-z0-9][a-z0-9_.-]*$/.test(rawToolId) || rawToolId.length > 250 || syntheticFallbackToolIds.includes(rawToolId)) {
+            return {
+              ok: false,
+              error: "fixtureBehavior.replayBundle.syntheticFallbackToolIds contains an invalid tool id."
+            };
+          }
+          syntheticFallbackToolIds.push(rawToolId);
+        }
+      }
+      replayBundle = {
+        bundleId: replay.bundleId,
+        manifestSha256: replay.manifestSha256,
+        ...syntheticFallbackToolIds ? { syntheticFallbackToolIds } : {}
+      };
+    }
+    if (record.version === FIXTURE_BEHAVIOR_REPLAY_VERSION) {
+      return {
+        ok: true,
+        behavior: {
+          version: FIXTURE_BEHAVIOR_REPLAY_VERSION,
+          responseSamples: samples2,
+          replayBundle
+        }
+      };
+    }
     return {
       ok: true,
       behavior: {
@@ -18073,6 +18220,114 @@ var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--debug-map-latency",
   "--debug-fixture-provider-pacing"
 ]);
+async function pathExistsIncludingSymlink(path) {
+  try {
+    await lstat(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+function runIdFileTempPath(destination) {
+  return join10(
+    dirname9(destination),
+    `.${basename3(destination)}.${process.pid}.${randomUUID3()}.tmp`
+  );
+}
+async function removeRunIdTempFile(path) {
+  try {
+    await unlink(path);
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+  }
+}
+async function preflightRunIdFile(path) {
+  const destination = resolve11(path);
+  if (await pathExistsIncludingSymlink(destination)) {
+    throw new Error(
+      `--run-id-file destination already exists: ${destination}. Choose a new path so this run cannot overwrite another run identity.`
+    );
+  }
+  const tempPath = runIdFileTempPath(destination);
+  let handle = null;
+  try {
+    handle = await open(tempPath, "wx", 384);
+    await handle.sync();
+  } catch (error) {
+    throw new Error(
+      `Cannot write --run-id-file destination ${destination}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  } finally {
+    await handle?.close();
+    await removeRunIdTempFile(tempPath);
+  }
+  return destination;
+}
+async function readRunIdFile(destination) {
+  if (!await pathExistsIncludingSymlink(destination)) {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(await readFileAsync(destination, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `--run-id-file destination contains invalid JSON: ${destination}. Refusing to overwrite it (${error instanceof Error ? error.message : String(error)}).`
+    );
+  }
+  if (!parsed || typeof parsed !== "object" || parsed.version !== 1 || typeof parsed.runId !== "string" || !parsed.runId) {
+    throw new Error(
+      `--run-id-file destination has an unsupported identity record: ${destination}. Refusing to overwrite it.`
+    );
+  }
+  return parsed;
+}
+async function writePlayRunIdFile(destination, runId) {
+  const existing = await readRunIdFile(destination);
+  if (existing) {
+    if (existing.runId === runId) return;
+    throw new Error(
+      `--run-id-file destination already records run ${existing.runId}; refusing to replace it with ${runId}: ${destination}`
+    );
+  }
+  const tempPath = runIdFileTempPath(destination);
+  let handle = null;
+  try {
+    handle = await open(tempPath, "wx", 384);
+    await handle.writeFile(
+      `${JSON.stringify({ version: 1, runId })}
+`,
+      "utf8"
+    );
+    await handle.sync();
+    await handle.close();
+    handle = null;
+    try {
+      await link(tempPath, destination);
+      const directory = await open(dirname9(destination), "r");
+      try {
+        await directory.sync();
+      } finally {
+        await directory.close();
+      }
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+      const raced = await readRunIdFile(destination);
+      if (raced?.runId === runId) return;
+      throw new Error(
+        `--run-id-file destination already records run ${raced?.runId ?? "<invalid>"}; refusing to replace it with ${runId}: ${destination}`
+      );
+    }
+  } finally {
+    await handle?.close();
+    await removeRunIdTempFile(tempPath);
+  }
+}
 function traceCliSync(phase, fields, run) {
   const startedAt = Date.now();
   try {
@@ -19477,8 +19732,8 @@ function buildPlayDashboardUrl(baseUrl, playName) {
   const encodedPlayName = encodeURIComponent(playName);
   return `${trimmedBase}/dashboard/plays/${encodedPlayName}`;
 }
-function openPlayDashboard(dashboardUrl, open) {
-  if (open && dashboardUrl) {
+function openPlayDashboard(dashboardUrl, open2) {
+  if (open2 && dashboardUrl) {
     openInBrowser(dashboardUrl);
   }
 }
@@ -19514,9 +19769,11 @@ function assertPlayWaitNotTimedOut(input2) {
     );
   }
 }
+var PLAY_DURABLE_STATUS_PROBE_INTERVAL_MS = 15e3;
 async function waitForPlayCompletionByStream(input2) {
   let lastPhase = null;
   let reconnectAttempt = 0;
+  let nextDurableProbeAt = Date.now() + PLAY_DURABLE_STATUS_PROBE_INTERVAL_MS;
   const withDashboardUrl = (status) => input2.dashboardUrl ? { ...status, dashboardUrl: input2.dashboardUrl } : status;
   const remainingWaitMs = () => input2.waitTimeoutMs === null ? null : input2.waitTimeoutMs - (Date.now() - input2.startedAt);
   const fetchTerminalStatus = async () => {
@@ -19535,6 +19792,14 @@ async function waitForPlayCompletionByStream(input2) {
   };
   const handleLiveEvent = async (event) => {
     assertPlayWaitNotTimedOut({ ...input2, lastPhase });
+    const now = Date.now();
+    if (now >= nextDurableProbeAt) {
+      nextDurableProbeAt = now + PLAY_DURABLE_STATUS_PROBE_INTERVAL_MS;
+      const durableTerminal = await fetchTerminalStatus();
+      if (durableTerminal) {
+        return durableTerminal;
+      }
+    }
     const phase = describeLiveEventPhase(event);
     if (phase) {
       lastPhase = phase;
@@ -19783,7 +20048,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
         lastKnownWorkflowId = eventRunId;
         firstRunIdMs ??= Date.now() - startedAt;
         if (runStartedNow) {
-          input2.onRunStarted?.(eventRunId);
+          await input2.onRunStarted?.(eventRunId);
         }
       }
       if (eventConfirmsPlayRunLaunch(event) && eventRunId === lastKnownWorkflowId) {
@@ -21062,6 +21327,15 @@ function buildOrdinaryPlayRunCommand(options, resolvedRevisionId) {
   }
   if (options.profile)
     parts.push("--profile", shellSingleQuote(options.profile));
+  if (options.maxConcurrentExternalCalls !== null) {
+    parts.push(
+      "--max-concurrent-external-calls",
+      String(options.maxConcurrentExternalCalls)
+    );
+  }
+  if (options.maxConcurrentRows !== null) {
+    parts.push("--max-concurrent-rows", String(options.maxConcurrentRows));
+  }
   const pinnedRevisionId = options.target.kind === "name" ? resolvedRevisionId ?? options.revisionId : null;
   if (pinnedRevisionId) {
     parts.push("--revision-id", shellSingleQuote(pinnedRevisionId));
@@ -21931,7 +22205,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--json] [--full] [--<input> value]\n       Runs use the Absurd CJS runtime.\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 '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--json] [--full] [--<input> value]\n       Runs use the Absurd CJS runtime.\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;
@@ -21942,15 +22216,18 @@ function parsePlayRunOptions(args) {
   const fullJson = args.includes("--full");
   const emitLogs = !jsonOutput || args.includes("--logs");
   const force = args.includes("--force");
-  const open = args.includes("--open");
+  const open2 = args.includes("--open");
   const debugMapLatency = args.includes("--debug-map-latency");
   const debugFixtureProviderPacing = args.includes(
     "--debug-fixture-provider-pacing"
   );
   const verboseLogs = args.includes("--logs") || debugMapLatency;
   let waitTimeoutMs = null;
+  let maxConcurrentExternalCalls = null;
+  let maxConcurrentRows = null;
   let profile = null;
   let fixtureBehavior = null;
+  let runIdFile = null;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === "--file" && args[index + 1]) {
@@ -21965,6 +22242,23 @@ function parsePlayRunOptions(args) {
       input2 = parseJsonInput(args[++index]);
       continue;
     }
+    if (arg === "--run-id-file") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("--run-id-file requires a destination path.");
+      }
+      runIdFile = value;
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--run-id-file=")) {
+      const value = arg.slice("--run-id-file=".length);
+      if (!value) {
+        throw new Error("--run-id-file requires a destination path.");
+      }
+      runIdFile = value;
+      continue;
+    }
     if (arg === "--revision-id" && args[index + 1]) {
       revisionId = args[++index];
       continue;
@@ -21979,6 +22273,41 @@ function parsePlayRunOptions(args) {
       index += 1;
       continue;
     }
+    if (arg === "--max-concurrent-external-calls") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error(
+          "--max-concurrent-external-calls requires a whole number."
+        );
+      }
+      if (!/^[1-9]\d*$/.test(value)) {
+        throw new Error(
+          "--max-concurrent-external-calls requires a positive whole number."
+        );
+      }
+      maxConcurrentExternalCalls = parsePositiveInteger3(
+        value,
+        "--max-concurrent-external-calls"
+      );
+      resolveMaxConcurrentExternalCalls(maxConcurrentExternalCalls);
+      index += 1;
+      continue;
+    }
+    if (arg === "--max-concurrent-rows") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("--max-concurrent-rows requires a whole number.");
+      }
+      if (!/^[1-9]\d*$/.test(value)) {
+        throw new Error(
+          "--max-concurrent-rows requires a positive whole number."
+        );
+      }
+      maxConcurrentRows = parsePositiveInteger3(value, "--max-concurrent-rows");
+      resolveMaxConcurrentRows(maxConcurrentRows);
+      index += 1;
+      continue;
+    }
     if (arg === "--fixture-behavior") {
       const value = args[index + 1];
       if (!value) {
@@ -22089,11 +22418,14 @@ function parsePlayRunOptions(args) {
     fullJson,
     waitTimeoutMs,
     force,
-    open,
+    maxConcurrentExternalCalls,
+    maxConcurrentRows,
+    open: open2,
     profile,
     debugMapLatency,
     debugFixtureProviderPacing,
-    fixtureBehavior
+    fixtureBehavior,
+    runIdFile
   };
 }
 function parsePlayCheckOptions(args) {
@@ -22776,6 +23108,8 @@ async function handleFileBackedRun(options, hooks) {
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
     ...options.force ? { force: true } : {},
+    ...options.maxConcurrentExternalCalls !== null ? { maxConcurrentExternalCalls: options.maxConcurrentExternalCalls } : {},
+    ...options.maxConcurrentRows !== null ? { maxConcurrentRows: options.maxConcurrentRows } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...Object.keys(testPolicyOverrides).length > 0 ? { testPolicyOverrides } : {},
     ...integrationMode ? { integrationMode } : {},
@@ -22836,6 +23170,7 @@ async function handleFileBackedRun(options, hooks) {
       throw await normalizePlayStartError(client2, error, playName);
     })
   );
+  await hooks?.onRunStarted?.(started.workflowId);
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
   openPlayDashboard(resolvedDashboardUrl, options.open);
   progress.phase("started run");
@@ -22956,6 +23291,8 @@ async function handleNamedRun(options, hooks) {
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
     ...options.force ? { force: true } : {},
+    ...options.maxConcurrentExternalCalls !== null ? { maxConcurrentExternalCalls: options.maxConcurrentExternalCalls } : {},
+    ...options.maxConcurrentRows !== null ? { maxConcurrentRows: options.maxConcurrentRows } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...Object.keys(testPolicyOverrides).length > 0 ? { testPolicyOverrides } : {},
     ...integrationMode ? { integrationMode } : {},
@@ -23021,6 +23358,7 @@ async function handleNamedRun(options, hooks) {
       });
     })
   );
+  await hooks?.onRunStarted?.(started.workflowId);
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
   openPlayDashboard(resolvedDashboardUrl, options.open);
   progress.phase("started run");
@@ -23037,10 +23375,28 @@ async function handleNamedRun(options, hooks) {
   return 0;
 }
 async function handlePlayRun(args, hooks) {
-  const options = parsePlayRunOptions(args);
+  const parsedOptions = parsePlayRunOptions(args);
+  const options = parsedOptions.runIdFile ? {
+    ...parsedOptions,
+    runIdFile: await preflightRunIdFile(parsedOptions.runIdFile)
+  } : parsedOptions;
+  const runHooks = options.runIdFile ? {
+    ...hooks,
+    onRunStarted: async (runId) => {
+      try {
+        await writePlayRunIdFile(options.runIdFile, runId);
+      } catch (error) {
+        throw new Error(
+          `Run ${runId} was accepted, but its identity could not be persisted to ${options.runIdFile}: ${error instanceof Error ? error.message : String(error)}. Inspect it with 'deepline runs get ${runId} --full --json'; do not submit a replacement run.`,
+          { cause: error }
+        );
+      }
+      await hooks?.onRunStarted?.(runId);
+    }
+  } : hooks;
   if (options.target.kind === "file") {
     if (isFileTarget(options.target.path)) {
-      return handleFileBackedRun(options, hooks);
+      return handleFileBackedRun(options, runHooks);
     }
     const resolved = resolve11(options.target.path);
     console.error(`File not found: ${resolved}`);
@@ -23062,7 +23418,7 @@ async function handlePlayRun(args, hooks) {
     }
     return 1;
   }
-  return handleNamedRun(options, hooks);
+  return handleNamedRun(options, runHooks);
 }
 function parseRunIdPositional(args, usage) {
   for (let index = 0; index < args.length; index += 1) {
@@ -24390,10 +24746,18 @@ Notes:
   next commands. --watch and --wait are accepted compatibility aliases for the
   default behavior. Use --no-wait only when you intentionally want
   a fire-and-forget run id.
+  --run-id-file writes the durable run id to a versioned JSON file as soon as
+  the server accepts the run. The destination must not already exist.
   The play page URL is printed when the run starts. Pass --open to open it in a browser.
   Concurrent runs for the same play are allowed.
   --force starts a fresh run graph without refreshing completed provider calls.
   It does not cancel active sibling runs.
+  --max-concurrent-external-calls controls the per-run provider-tool/ctx.fetch
+  resident-work ceiling. Default: ${DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS}; accepted range: 1-${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS}.
+  Provider pacing and sandbox memory limits still apply.
+  --max-concurrent-rows sets the run-wide default and ceiling for live map row
+  resolvers. Accepted range: 1-${MAX_CONFIGURABLE_CONCURRENT_ROWS}. The runtime
+  may lower it when source-row size exceeds the active-row memory budget.
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
@@ -24429,8 +24793,10 @@ Idempotent execution:
 Examples:
   deepline plays run prebuilt/person-linkedin-to-email --input '{"linkedin_url":"..."}'
   deepline plays run long-background-play --no-wait
+  deepline plays run long-background-play --run-id-file ./run-id.json
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
   deepline plays run my.play.ts --profile absurd
+  deepline plays run my.play.ts --max-concurrent-external-calls 20
   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
@@ -24446,9 +24812,18 @@ Examples:
     "--fixture-behavior <json>",
     "Internal/testing: fixture response behavior JSON object or @file path"
   ).option("--watch", "Compatibility alias; run waits by default").option("--wait", "Compatibility alias; run waits by default").option("--no-wait", "Start the run and return immediately").option(
+    "--run-id-file <path>",
+    "Atomically write the accepted run id to a new JSON file"
+  ).option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
-  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Start a fresh run graph").option("--open", "Open the play page in a browser after the run starts").option(
+  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Start a fresh run graph").option(
+    "--max-concurrent-external-calls <count>",
+    `Concurrent provider-tool and ctx.fetch executions (${DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS} default, max ${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS})`
+  ).option(
+    "--max-concurrent-rows <count>",
+    `Run-wide dataset map row resolver ceiling (max ${MAX_CONFIGURABLE_CONCURRENT_ROWS})`
+  ).option("--open", "Open the play page in a browser after the run starts").option(
     "--debug-map-latency",
     "Internal diagnostics: emit one aggregate latency profile per dataset map"
   ).option(
@@ -24487,10 +24862,16 @@ Pass-through input flags:
       ...options.profile ? ["--profile", options.profile] : [],
       ...options.fixtureBehavior ? ["--fixture-behavior", options.fixtureBehavior] : [],
       ...options.wait === false ? ["--no-wait"] : [],
+      ...options.runIdFile ? ["--run-id-file", options.runIdFile] : [],
       ...options.watch || options.wait ? ["--watch"] : [],
       ...options.logs ? ["--logs"] : [],
       ...options.tailTimeoutMs ? ["--tail-timeout-ms", options.tailTimeoutMs] : [],
       ...options.force ? ["--force"] : [],
+      ...options.maxConcurrentExternalCalls ? [
+        "--max-concurrent-external-calls",
+        options.maxConcurrentExternalCalls
+      ] : [],
+      ...options.maxConcurrentRows ? ["--max-concurrent-rows", options.maxConcurrentRows] : [],
       ...options.open ? ["--open"] : [],
       ...options.debugMapLatency ? ["--debug-map-latency"] : [],
       ...options.debugFixtureProviderPacing ? ["--debug-fixture-provider-pacing"] : [],
@@ -30266,7 +30647,7 @@ function registerEnrichCommand(program) {
     let inPlaceTempDir = null;
     let inPlaceTempOutputPath = null;
     const inPlaceFinalOutputPath = options.inPlace ? resolve12(inputCsv) : null;
-    const inPlaceCommitOutputPath = options.inPlace ? (await lstat(inputCsv)).isSymbolicLink() ? await realpath2(inputCsv) : inPlaceFinalOutputPath : null;
+    const inPlaceCommitOutputPath = options.inPlace ? (await lstat2(inputCsv)).isSymbolicLink() ? await realpath2(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
     let activeRunId2 = null;
@@ -30581,7 +30962,7 @@ import {
 import { homedir as homedir8, platform } from "os";
 import { basename as basename5, dirname as dirname11, join as join12, resolve as resolve13 } from "path";
 import { gzipSync } from "zlib";
-import { randomUUID as randomUUID3 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var UUID_IN_TEXT_RE = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i;
 var MAX_SESSION_UPLOAD_BYTES = 35e5;
@@ -30980,7 +31361,7 @@ async function uploadPayload(path, payload) {
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
-  const uploadId = randomUUID3();
+  const uploadId = randomUUID4();
   for (const session of sessions) {
     const bytes = Buffer.from(session.encodedContent, "base64");
     const chunks = [];