deepline 0.1.198 → 0.1.200

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.198",
+  version: "0.1.200",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.198",
+    latest: "0.1.200",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1067,7 +1067,10 @@ var HttpClient = class {
    * @param path - API path (e.g. `"/api/v2/tools"`)
    */
   async get(path) {
-    return this.request(path, { method: "GET" });
+    return this.request(path, {
+      method: "GET",
+      retryApiErrors: true
+    });
   }
   async *streamSse(path, options) {
     const url = `${this.config.baseUrl}${path}`;
@@ -1341,7 +1344,6 @@ function resolveTimingWindow(input2) {
 // ../shared_libs/play-runtime/run-terminal-source.ts
 var PLAY_RUN_LEDGER_EVENT_SOURCES = [
   "worker",
-  "temporal",
   "convex",
   "coordinator",
   "system"
@@ -7028,7 +7030,7 @@ function isRecord4(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isSerializedDataset(value) {
-  return isRecord4(value) && value.kind === "dataset" && typeof value.count === "number" && Array.isArray(value.preview);
+  return isRecord4(value) && value.kind === "dataset" && typeof value.count === "number" && (Array.isArray(value.preview) || typeof value.tableNamespace === "string");
 }
 function isPackagedDatasetOutput(value) {
   return isRecord4(value) && value.kind === "dataset" && isRecord4(value.preview) && Array.isArray(value.preview.rows);
@@ -7089,7 +7091,7 @@ function columnsFromDatasetSummary(summary) {
 function canonicalRowsInfoFromCandidate(input2) {
   const candidate = input2;
   if (isSerializedDataset(candidate.value)) {
-    const rawRows = rowArray(candidate.value.preview) ?? [];
+    const rawRows = Array.isArray(candidate.value.preview) ? rowArray(candidate.value.preview) ?? [] : [];
     const totalRows2 = readNumber(candidate.value.count) ?? rawRows.length;
     const hasExplicitColumns = Array.isArray(candidate.value.columns) && candidate.value.columns.every((column) => typeof column === "string");
     const rawColumns = hasExplicitColumns ? candidate.value.columns : inferColumns(rawRows);
@@ -7317,6 +7319,13 @@ function collectSerializedDatasetRowsInfos(statusOrResult) {
       path: "result",
       output: candidates
     });
+    if (isRecord4(result.output)) {
+      collectDatasetCandidates({
+        value: result.output,
+        path: "result",
+        output: candidates
+      });
+    }
   }
   candidates.push(...collectPackagedStepDatasetCandidates(statusOrResult));
   const seen = /* @__PURE__ */ new Set();
@@ -10411,22 +10420,22 @@ var PLAY_DEDUP_BACKENDS = {
 
 // ../shared_libs/play-runtime/scheduler-backend.ts
 var PLAY_SCHEDULER_BACKENDS = {
-  temporal: "temporal",
   cfWorkflows: "cf-workflows",
+  /** Private legacy id retained only so old persisted rows can be interpreted. */
+  postgres: "postgres",
   /**
-   * Private legacy id retained only so old persisted rows can be interpreted.
-   * It is not a selectable scheduler backend after the Hatchet hard cutover.
+   * Postgres-native durable-execution scheduler (vendored Absurd engine). Runs
+   * on the battle-tested run-state store without an external workflow engine.
+   * Selected explicitly by the `absurd` profile.
    */
-  postgres: "postgres",
-  hatchet: "hatchet",
+  absurd: "absurd",
   inProcess: "in-process"
 };
 
 // ../shared_libs/play-runtime/providers.ts
 var PLAY_RUNTIME_PROVIDER_IDS = {
   workersEdge: "workers_edge",
-  hatchet: "hatchet",
-  local: "local"
+  absurd: "absurd"
 };
 var PLAY_RUNTIME_PROVIDERS = {
   workers_edge: {
@@ -10437,21 +10446,16 @@ var PLAY_RUNTIME_PROVIDERS = {
     artifactKind: PLAY_ARTIFACT_KINDS.esmWorkers,
     label: "Cloudflare Dynamic Workflows + Dynamic Workers + DO dedup"
   },
-  hatchet: {
-    id: PLAY_RUNTIME_PROVIDER_IDS.hatchet,
-    scheduler: PLAY_SCHEDULER_BACKENDS.hatchet,
+  absurd: {
+    id: PLAY_RUNTIME_PROVIDER_IDS.absurd,
+    scheduler: PLAY_SCHEDULER_BACKENDS.absurd,
+    // Server runs execute on Daytona; the local-dev/test shape swaps the runner
+    // axis to local_process (same as the local profile) via an explicit
+    // runtimeBackend override at submit while tests drive local_process.
     runner: PLAY_RUNTIME_BACKENDS.daytona,
     dedup: PLAY_DEDUP_BACKENDS.inMemory,
     artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Hatchet scheduler + one-shot Daytona runner + receipt-backed in-process dedup"
-  },
-  local: {
-    id: PLAY_RUNTIME_PROVIDER_IDS.local,
-    scheduler: PLAY_SCHEDULER_BACKENDS.temporal,
-    runner: PLAY_RUNTIME_BACKENDS.localProcess,
-    dedup: PLAY_DEDUP_BACKENDS.inMemory,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Local Temporal scheduler + local subprocess runner (tests)"
+    label: "Absurd (Postgres-native durable) scheduler + one-shot Daytona runner + receipt-backed in-process dedup"
   }
 };
 function defaultPlayRuntimeProvider() {
@@ -10464,7 +10468,7 @@ function resolvePlayRuntimeProvider(override) {
       return PLAY_RUNTIME_PROVIDERS[id];
     }
     throw new Error(
-      `Unknown play runtime provider "${id}". Expected one of: ${Object.keys(
+      `Unsupported play runtime provider "${id}". Expected one of: ${Object.keys(
         PLAY_RUNTIME_PROVIDERS
       ).join(", ")}.`
     );
@@ -10716,14 +10720,219 @@ function parseReferencedPlayTarget2(target) {
 function isPrebuiltReferenceTarget(target) {
   return target.trim().toLowerCase().startsWith("prebuilt/");
 }
+function buildBarePrebuiltReferenceMessage(input2) {
+  return `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`;
+}
 function buildBarePrebuiltReferenceError(input2) {
-  return new Error(
-    `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`
+  return new Error(buildBarePrebuiltReferenceMessage(input2));
+}
+function isPlayNotFoundError(error) {
+  return error instanceof DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND");
+}
+function isExplicitMissingPlayReferenceError(error) {
+  if (!(error instanceof DeeplineError)) {
+    return false;
+  }
+  if (error.statusCode !== 404 && error.code !== "PLAY_NOT_FOUND") {
+    return false;
+  }
+  return /^play not found\b/i.test(error.message.trim());
+}
+function normalizePlayReferenceForMatch(value) {
+  return value.trim().toLowerCase().replace(/^prebuilt\//, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function playReferenceMatchTokens(value) {
+  return normalizePlayReferenceForMatch(value).split("-").filter((token) => token.length > 1 && token !== "to" && token !== "and");
+}
+function playSuggestionReference(play) {
+  if (play.reference?.trim()) {
+    return play.reference.trim();
+  }
+  const ownerSlug = play.ownerSlug?.trim();
+  return ownerSlug ? `${ownerSlug}/${play.name}` : play.name;
+}
+function scorePlayReferenceSuggestion(requested, play) {
+  const parsed = parseReferencedPlayTarget2(requested);
+  const requestedTrimmed = requested.trim();
+  const requestedRef = requestedTrimmed.toLowerCase();
+  const requestedName = parsed.unqualifiedPlayName;
+  const requestedNorm = normalizePlayReferenceForMatch(requestedTrimmed);
+  const requestedNameNorm = normalizePlayReferenceForMatch(requestedName);
+  if (!requestedNorm && !requestedNameNorm) {
+    return null;
+  }
+  const reference = playSuggestionReference(play);
+  const referenceNorm = normalizePlayReferenceForMatch(reference);
+  const nameNorm = normalizePlayReferenceForMatch(play.name);
+  const candidateNamespace = reference.includes("/") ? reference.split("/")[0]?.toLowerCase() : null;
+  const requestedNamespace = parsed.ownerSlug?.toLowerCase() ?? null;
+  const aliases = (play.aliases ?? []).map(normalizePlayReferenceForMatch);
+  const searchable = [referenceNorm, nameNorm, ...aliases].filter(Boolean);
+  const requestedTokens = playReferenceMatchTokens(requestedName);
+  const candidateTokens = [
+    ...new Set(
+      [reference, play.name, ...play.aliases ?? []].flatMap(
+        playReferenceMatchTokens
+      )
+    )
+  ];
+  const hasTokenContainment = requestedTokens.length > 0 && requestedTokens.every((token) => candidateTokens.includes(token));
+  let score = 0;
+  if (reference.toLowerCase() === requestedRef) {
+    score = 120;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && nameNorm === requestedNameNorm) {
+    score = 110;
+  } else if (nameNorm === requestedNameNorm || aliases.includes(requestedNameNorm)) {
+    score = play.origin === "prebuilt" ? 100 : 95;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 85;
+  } else if (searchable.some(
+    (value) => value.includes(requestedNorm) || requestedNorm.includes(value)
+  )) {
+    score = 70;
+  } else if (requestedNameNorm && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 60;
+  } else if (hasTokenContainment) {
+    score = requestedNamespace && candidateNamespace === requestedNamespace ? 58 : 50;
+  }
+  if (score <= 0) {
+    return null;
+  }
+  if (play.origin === "prebuilt") {
+    score += 3;
+  }
+  return {
+    reference,
+    name: play.name,
+    origin: play.origin ?? null,
+    score
+  };
+}
+function rankPlayReferenceSuggestions(input2) {
+  const byReference = /* @__PURE__ */ new Map();
+  for (const play of input2.plays) {
+    const suggestion = scorePlayReferenceSuggestion(input2.requested, play);
+    if (!suggestion) continue;
+    const existing = byReference.get(suggestion.reference);
+    if (!existing || suggestion.score > existing.score) {
+      byReference.set(suggestion.reference, suggestion);
+    }
+  }
+  return [...byReference.values()].sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    if (left.origin === "prebuilt" && right.origin !== "prebuilt") return -1;
+    if (right.origin === "prebuilt" && left.origin !== "prebuilt") return 1;
+    return left.reference.localeCompare(right.reference);
+  }).slice(0, input2.limit ?? 5);
+}
+function searchQueryForMissingPlayReference(target) {
+  return parseReferencedPlayTarget2(target).unqualifiedPlayName.replace(/[-_./]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function shellQuote2(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function buildPlayReferenceNotFoundMessage(input2) {
+  const lines = [`Play not found: ${input2.requested}`];
+  if (input2.suggestions.length > 0) {
+    lines.push("", "Did you mean one of these?");
+    for (const suggestion of input2.suggestions) {
+      lines.push("", `  ${suggestion.reference}`);
+      if (input2.command === "run") {
+        lines.push(
+          `    deepline plays run ${suggestion.reference} --input '{...}' --watch`
+        );
+      } else if (input2.command === "get") {
+        lines.push(`    deepline plays get ${suggestion.reference} --json`);
+      } else if (input2.command === "check") {
+        lines.push(`    deepline plays check ${suggestion.reference} --json`);
+      } else if (input2.command === "versions") {
+        lines.push(
+          `    deepline plays versions --name ${suggestion.reference} --json`
+        );
+      } else {
+        lines.push(
+          `    deepline plays describe ${suggestion.reference} --json`
+        );
+      }
+    }
+  }
+  const searchQuery = searchQueryForMissingPlayReference(input2.requested);
+  if (searchQuery) {
+    lines.push(
+      "",
+      "Search visible plays:",
+      `  deepline plays search ${shellQuote2(searchQuery)} --all --json`
+    );
+  }
+  return lines.join("\n");
+}
+async function buildPlayReferenceNotFoundError(input2) {
+  let suggestions = [];
+  try {
+    const searchQuery = searchQueryForMissingPlayReference(input2.target);
+    const searchMatches = searchQuery ? await input2.client.searchPlays({
+      query: searchQuery,
+      scope: "all",
+      compact: true
+    }) : [];
+    const plays = searchMatches.length > 0 ? searchMatches : await input2.client.listPlays();
+    suggestions = rankPlayReferenceSuggestions({
+      requested: input2.target,
+      plays,
+      limit: 5
+    });
+  } catch {
+    suggestions = [];
+  }
+  const sourceError = input2.sourceError instanceof DeeplineError ? input2.sourceError : null;
+  const code = sourceError?.code && sourceError.code !== "API_ERROR" ? sourceError.code : "PLAY_NOT_FOUND";
+  return new DeeplineError(
+    buildPlayReferenceNotFoundMessage({
+      requested: input2.target,
+      command: input2.command,
+      suggestions
+    }),
+    sourceError?.statusCode ?? 404,
+    code,
+    sourceError?.details
   );
 }
-async function assertCanonicalNamedPlayReference(client2, target) {
+async function isMissingRunPlayReferenceError(input2) {
+  if (isExplicitMissingPlayReferenceError(input2.error)) {
+    return true;
+  }
+  if (!(input2.error instanceof DeeplineError) || input2.error.statusCode !== 404 || !/^no artifact-backed revision found for play:/i.test(
+    input2.error.message.trim()
+  )) {
+    return false;
+  }
+  try {
+    await input2.client.getPlay(parseReferencedPlayTarget2(input2.playName).playName);
+    return false;
+  } catch (lookupError) {
+    return isPlayNotFoundError(lookupError);
+  }
+}
+async function assertCanonicalNamedPlayReference(client2, target, options = {}) {
   const parsed = parseReferencedPlayTarget2(target);
-  const detail = await client2.getPlay(parsed.playName);
+  let detail;
+  try {
+    detail = await client2.getPlay(parsed.playName);
+  } catch (error) {
+    if (isPlayNotFoundError(error)) {
+      throw await buildPlayReferenceNotFoundError({
+        client: client2,
+        target,
+        command: options.command ?? "describe",
+        sourceError: error
+      });
+    }
+    throw error;
+  }
   if (detail.play.ownerType === "deepline" && !isPrebuiltReferenceTarget(target)) {
     throw buildBarePrebuiltReferenceError({
       requested: target,
@@ -13459,10 +13668,7 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return {
-        path: writeCanonicalRowsCsv(guarded2, outPath),
-        rowsInfo: guarded2
-      };
+      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
     }
     if (rowsInfo.complete) {
       const guarded2 = assertDatasetHasExportableRows({
@@ -13471,7 +13677,10 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
+      return {
+        path: writeCanonicalRowsCsv(guarded2, outPath),
+        rowsInfo: guarded2
+      };
     }
     if (attempt < attempts && retryDelayMs > 0) {
       await sleep5(retryDelayMs);
@@ -13605,17 +13814,25 @@ function normalizePlayValidationError(error) {
     error instanceof DeeplineError ? error.details : void 0
   );
 }
-function normalizePlayStartError(error, playName) {
+async function normalizePlayStartError(client2, error, playName, options = {}) {
   const activeRuns = extractActiveRunsFromError(error);
-  if (activeRuns.length === 0) {
-    return normalizePlayValidationError(error);
+  if (activeRuns.length > 0) {
+    return new DeeplineError(
+      formatActiveRunConflictError({ playName, activeRuns }),
+      error instanceof DeeplineError ? error.statusCode : 409,
+      "ACTIVE_RUN_EXISTS",
+      error instanceof DeeplineError ? error.details : void 0
+    );
   }
-  return new DeeplineError(
-    formatActiveRunConflictError({ playName, activeRuns }),
-    error instanceof DeeplineError ? error.statusCode : 409,
-    "ACTIVE_RUN_EXISTS",
-    error instanceof DeeplineError ? error.details : void 0
-  );
+  if (options.suggestMissingPlay && await isMissingRunPlayReferenceError({ client: client2, error, playName })) {
+    return buildPlayReferenceNotFoundError({
+      client: client2,
+      target: playName,
+      command: "run",
+      sourceError: error
+    });
+  }
+  return normalizePlayValidationError(error);
 }
 function renderServerResultView(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -13775,7 +13992,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; pass hatchet explicitly for Hatchet runtime comparison.\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       --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.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -14128,7 +14345,9 @@ async function handlePlayCheck(args) {
   if (!isFileTarget(options.target)) {
     const client3 = new DeeplineClient();
     try {
-      await assertCanonicalNamedPlayReference(client3, options.target);
+      await assertCanonicalNamedPlayReference(client3, options.target, {
+        command: "check"
+      });
       const play = await client3.describePlay(
         parseReferencedPlayTarget2(options.target).playName,
         { compact: true }
@@ -14398,8 +14617,8 @@ async function handleFileBackedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName);
       })
     );
     if (finalStatus.status === "completed") {
@@ -14429,8 +14648,8 @@ async function handleFileBackedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "file", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName);
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -14488,7 +14707,9 @@ async function handleNamedRun(options) {
     return traceCliSpan(
       "cli.play_load_definition",
       { targetKind: "name", playName, skipped: false },
-      () => assertCanonicalNamedPlayReference(client2, playName)
+      () => assertCanonicalNamedPlayReference(client2, playName, {
+        command: "run"
+      })
     );
   })() : (recordCliTrace({
     phase: "cli.play_load_definition",
@@ -14557,8 +14778,10 @@ async function handleNamedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName, {
+          suggestMissingPlay: true
+        });
       })
     );
     if (finalStatus.status === "completed") {
@@ -14588,8 +14811,10 @@ async function handleNamedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "name", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName, {
+        suggestMissingPlay: true
+      });
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -15028,7 +15253,9 @@ async function handlePlayGet(args) {
     }
   }
   const playName = isFileTarget(target) ? extractPlayName((0, import_node_fs10.readFileSync)((0, import_node_path11.resolve)(target), "utf-8"), (0, import_node_path11.resolve)(target)) : parseReferencedPlayTarget2(target).playName;
-  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target);
+  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target, {
+    command: "get"
+  });
   const resolvedSource = detail.play.workingRevision?.sourceCode ?? detail.play.liveRevision?.sourceCode ?? detail.play.currentRevision?.sourceCode ?? detail.play.sourceCode ?? "";
   const materializedFile = outPath ? materializeRemotePlaySource({
     target,
@@ -15110,7 +15337,9 @@ async function handlePlayVersions(args) {
   }
   const client2 = new DeeplineClient();
   const jsonOutput = argsWantJson(args);
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "versions"
+  });
   const versions = await client2.listPlayVersions(
     parseReferencedPlayTarget2(playName).playName
   );
@@ -15506,7 +15735,9 @@ async function handlePlayDescribe(args) {
     return 2;
   }
   const client2 = new DeeplineClient();
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "describe"
+  });
   const play = await client2.describePlay(
     parseReferencedPlayTarget2(playName).playName,
     {
@@ -18707,7 +18938,8 @@ async function writeOutputCsv(outputPath, status, options) {
   }
   const selectedSourceRows = selectedSourceCsvRowCount(options);
   const shouldFetchBackingRows = options?.client && shouldFetchBackingRowsForEnrichExport(rowsInfo, status, {
-    selectedSourceRows
+    selectedSourceRows,
+    expectedAliases: options?.config ? collectConfigScalarAliasOrder(options.config) : []
   });
   if (options?.client && shouldFetchBackingRows) {
     let fetchedRowsInfo = null;
@@ -18744,6 +18976,7 @@ async function writeOutputCsv(outputPath, status, options) {
   const columns = orderEnrichCsvColumns(
     dataExportColumns(merged.rows, [
       ...merged.preferredColumns,
+      ...options?.config ? collectConfigScalarAliasOrder(options.config) : [],
       ...rowsInfo.columns
     ]),
     options?.config
@@ -19401,26 +19634,39 @@ function shouldFetchBackingRowsForEnrichExport(rowsInfo, status, options = {}) {
     rowsInfo,
     status
   );
+  const isGeneratedEnrichRows = tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE;
   if (terminalStatus === "failed" || terminalStatus === "cancelled") {
-    if (tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE && rowsInfo.source !== null && typeof options.selectedSourceRows === "number" && rowsInfo.rows.length < options.selectedSourceRows) {
+    if (isGeneratedEnrichRows && rowsInfo.source !== null && typeof options.selectedSourceRows === "number" && rowsInfo.rows.length < options.selectedSourceRows) {
       return true;
     }
-    return tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE && (rowsInfo.recovered === true || hasPartialRunOutputWarning(status));
+    return isGeneratedEnrichRows && (rowsInfo.recovered === true || hasPartialRunOutputWarning(status));
   }
-  if (tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE && typeof options.selectedSourceRows === "number" && rowsInfo.rows.length < options.selectedSourceRows) {
+  if (isGeneratedEnrichRows && typeof options.selectedSourceRows === "number" && rowsInfo.rows.length < options.selectedSourceRows) {
     return true;
   }
-  if (tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE && typeof options.selectedSourceRows === "number" && options.selectedSourceRows > 0) {
+  if (isGeneratedEnrichRows && (typeof options.selectedSourceRows === "number" && options.selectedSourceRows > 0 || rowsMissingExpectedAlias(rowsInfo.rows, options.expectedAliases))) {
     return true;
   }
-  if (tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE && hasFailedRowSignal(status)) {
+  if (isGeneratedEnrichRows && hasFailedRowSignal(status)) {
     return true;
   }
   if (!rowsInfo.complete) {
-    return tableNamespace === GENERATED_ENRICH_ROWS_TABLE_NAMESPACE;
+    return isGeneratedEnrichRows;
   }
   return rowsInfo.rows.some((row) => hasLossyPreviewPlaceholder(row));
 }
+function rowsMissingExpectedAlias(rows, expectedAliases) {
+  if (rows.length === 0 || !expectedAliases?.length) {
+    return false;
+  }
+  const rowAliases = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      rowAliases.add(normalizeAlias2(key));
+    }
+  }
+  return expectedAliases.map((alias) => normalizeAlias2(alias)).filter(Boolean).some((alias) => !rowAliases.has(alias));
+}
 function hasPartialRunOutputWarning(status) {
   const warningLists = [
     recordField(status, "warnings"),
@@ -19986,6 +20232,18 @@ function collectEmptyWaterfallIssues(input2) {
     if (executionSignal === "all_condition_skipped" || executionSignal === "unknown" && waterfallChildrenAreStaticallySkipped(spec)) {
       return;
     }
+    const statsEvidence = emptyWaterfallStatsEvidence(input2.status, spec);
+    if (statsEvidence && input2.rowSetComplete && input2.outputPath) {
+      issues.push(
+        emptyWaterfallIssue({
+          spec,
+          selectedRows: statsEvidence.selectedRows,
+          runId,
+          followUpCommands
+        })
+      );
+      return;
+    }
     const logicalRows = /* @__PURE__ */ new Map();
     input2.rows.forEach((row, rowIndex) => {
       const sourceRowId = sourceRowIndexFromEnrichRow(
@@ -20007,24 +20265,34 @@ function collectEmptyWaterfallIssues(input2) {
       return;
     }
     const selectedRows = logicalRows.size;
-    const message = `Waterfall ${spec.alias} produced 0 values for ${selectedRows} selected row(s).`;
-    issues.push({
-      issue_id: `${spec.alias}-empty-waterfall`,
-      kind: "empty_waterfall",
-      severity: "needs_attention",
-      column: spec.alias,
-      selected_rows: selectedRows,
-      rows_with_value: 0,
-      rows_without_value: selectedRows,
-      message,
-      next_steps: enrichIssueNextSteps({ runId }),
-      follow_up_commands: followUpCommands,
-      ...spec.operation ? { operation: spec.operation } : {},
-      ...runId ? { run_id: runId } : {}
-    });
+    issues.push(
+      emptyWaterfallIssue({
+        spec,
+        selectedRows,
+        runId,
+        followUpCommands
+      })
+    );
   });
   return issues;
 }
+function emptyWaterfallIssue(input2) {
+  const message = `Waterfall ${input2.spec.alias} produced 0 values for ${input2.selectedRows} selected row(s).`;
+  return {
+    issue_id: `${input2.spec.alias}-empty-waterfall`,
+    kind: "empty_waterfall",
+    severity: "needs_attention",
+    column: input2.spec.alias,
+    selected_rows: input2.selectedRows,
+    rows_with_value: 0,
+    rows_without_value: input2.selectedRows,
+    message,
+    next_steps: enrichIssueNextSteps({ runId: input2.runId }),
+    follow_up_commands: input2.followUpCommands,
+    ...input2.spec.operation ? { operation: input2.spec.operation } : {},
+    ...input2.runId ? { run_id: input2.runId } : {}
+  };
+}
 function waterfallChildrenAreStaticallySkipped(spec) {
   const childAliases = spec.childAliases ?? [];
   if (childAliases.length === 0 || !spec.childRunIfJsByAlias) {
@@ -20058,14 +20326,18 @@ function waterfallExecutionSignal(status, spec) {
       const executedSummary = parseExecutionSummary(
         execution?.["completed:executed"]
       );
+      const reusedSummary = parseExecutionSummary(
+        execution?.["completed:reused"]
+      );
       const skippedConditionSummary = parseExecutionSummary(
         execution?.["skipped:condition"]
       );
       const executedCount = executedSummary?.count ?? 0;
+      const reusedCount = reusedSummary?.count ?? 0;
       const skippedConditionCount = skippedConditionSummary?.count ?? 0;
-      const totalCount = executedSummary?.total ?? skippedConditionSummary?.total;
-      const onlyConditionSkips = totalCount !== void 0 && skippedConditionCount >= totalCount && executedCount <= skippedConditionCount;
-      if (executedCount > 0 && !onlyConditionSkips || numericFailedRowSignal(execution?.failed) > 0 || numericFailedRowSignal(stat2.failed) > 0 || numericFailedRowSignal(stat2.failedRows) > 0) {
+      const totalCount = executedSummary?.total ?? reusedSummary?.total ?? skippedConditionSummary?.total;
+      const onlyConditionSkips = totalCount !== void 0 && skippedConditionCount >= totalCount && executedCount + reusedCount <= skippedConditionCount;
+      if (executedCount + reusedCount > 0 && !onlyConditionSkips || numericFailedRowSignal(execution?.failed) > 0 || numericFailedRowSignal(stat2.failed) > 0 || numericFailedRowSignal(stat2.failedRows) > 0) {
         return "executed";
       }
       if (!onlyConditionSkips) {
@@ -20078,6 +20350,48 @@ function waterfallExecutionSignal(status, spec) {
   }
   return "unknown";
 }
+function emptyWaterfallStatsEvidence(status, spec) {
+  const summaries = collectColumnStats(status);
+  const parentStats = summaries.map((summary) => summary[spec.alias]).filter(isRecord7);
+  for (const stat2 of parentStats) {
+    const nonEmpty = parseExecutionSummary(stat2.non_empty);
+    if (nonEmpty?.total && nonEmpty.count === 0) {
+      return { selectedRows: nonEmpty.total };
+    }
+  }
+  const childAliases = spec.childAliases ?? [];
+  if (childAliases.length === 0) {
+    return null;
+  }
+  let selectedRows = 0;
+  let sawStatsForEveryChild = true;
+  for (const childAlias of childAliases) {
+    const stat2 = summaries.map((summary) => summary[childAlias]).find(isRecord7);
+    if (!stat2) {
+      sawStatsForEveryChild = false;
+      break;
+    }
+    const nonEmpty = parseExecutionSummary(stat2.non_empty);
+    if ((nonEmpty?.count ?? 0) > 0) {
+      return null;
+    }
+    const execution = isRecord7(stat2.execution) ? stat2.execution : null;
+    const executed = parseExecutionSummary(execution?.["completed:executed"]);
+    const reused = parseExecutionSummary(execution?.["completed:reused"]);
+    const skipped = parseExecutionSummary(execution?.["skipped:condition"]);
+    selectedRows = Math.max(
+      selectedRows,
+      nonEmpty?.total ?? 0,
+      executed?.total ?? 0,
+      reused?.total ?? 0,
+      skipped?.total ?? 0
+    );
+  }
+  if (!sawStatsForEveryChild || selectedRows <= 0 || waterfallExecutionSignal(status, spec) === "all_condition_skipped") {
+    return null;
+  }
+  return { selectedRows };
+}
 function mergeEnrichFailureJobs(...jobGroups) {
   const merged = [];
   const seen = /* @__PURE__ */ new Set();
@@ -20897,12 +21211,34 @@ var ENRICH_FLATTENED_CONTROL_FIELDS = /* @__PURE__ */ new Set([
   "provider",
   "status"
 ]);
+var ENRICH_ALIAS_METADATA_FIELDS = /* @__PURE__ */ new Set([
+  "_metadata",
+  "metadata",
+  "metadata.columns",
+  "metadata__columns"
+]);
+function isEnrichAliasPayloadField(field) {
+  return !field.startsWith("_") && !ENRICH_FLATTENED_CONTROL_FIELDS.has(field) && !ENRICH_ALIAS_METADATA_FIELDS.has(field);
+}
 function materializeCsvCellValue(value) {
   if (value && typeof value === "object") {
     return csvSafeJsonString(value);
   }
   return value;
 }
+function compactArrayEnvelopeCompleteValue(value) {
+  if (!isRecord7(value) || value.kind !== "array") {
+    return null;
+  }
+  if (!Array.isArray(value.preview)) {
+    return null;
+  }
+  const length = typeof value.length === "number" && Number.isFinite(value.length) ? Math.max(0, Math.trunc(value.length)) : null;
+  if (length === null || length > value.preview.length) {
+    return null;
+  }
+  return value.preview.slice(0, length);
+}
 function disambiguateCompactAiInferencePayload(value) {
   const parsed = parseMaybeJsonObject(value);
   if (!isRecord7(parsed) || !cellFailureError(parsed)) {
@@ -20939,6 +21275,10 @@ function compactAiInferenceCellForCsv(value) {
 function materializeEnrichAliasCellForCsv(row, alias, options) {
   const direct = row[alias];
   if (isRecord7(direct)) {
+    const completeArray = compactArrayEnvelopeCompleteValue(direct);
+    if (completeArray) {
+      return materializeCsvCellValue(completeArray);
+    }
     if (options?.compactAiCell && direct.status === "completed" && (isRecord7(direct.result) || Object.prototype.hasOwnProperty.call(direct, "extracted_json") || typeof direct.output === "string")) {
       return materializeCsvCellValue(compactAiInferenceCellForCsv(direct));
     }
@@ -20947,7 +21287,7 @@ function materializeEnrichAliasCellForCsv(row, alias, options) {
     }
     const directCells = [];
     for (const [field, value] of Object.entries(direct)) {
-      if (ENRICH_FLATTENED_CONTROL_FIELDS.has(field)) {
+      if (!isEnrichAliasPayloadField(field)) {
         continue;
       }
       if (isNonEmptyCsvCell(value)) {
@@ -20977,7 +21317,7 @@ function materializeEnrichAliasCellForCsv(row, alias, options) {
     }
   }
   const cells = aliasFlattenedCells(row, alias).filter(({ field, value }) => {
-    if (ENRICH_FLATTENED_CONTROL_FIELDS.has(field)) {
+    if (!isEnrichAliasPayloadField(field)) {
       return false;
     }
     return isNonEmptyCsvCell(value);
@@ -24014,7 +24354,7 @@ var EXIT_AUTH2 = 1;
 var EXIT_SERVER3 = 2;
 var MAX_PROMPT_LENGTH = 8e3;
 var MAX_BODY_BYTES = 64 * 1024;
-function shellQuote2(arg) {
+function shellQuote3(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function hasClaudeBinary() {
@@ -24187,7 +24527,7 @@ async function handleQuickstart(options) {
   }
   progress.complete();
   const { prompt, workflowId } = outcome;
-  const claudeCommand = `claude ${shellQuote2(prompt)}`;
+  const claudeCommand = `claude ${shellQuote3(prompt)}`;
   const claudeAvailable = hasClaudeBinary();
   const willLaunch = options.launch !== false && !jsonOutput && interactive && claudeAvailable;
   printCommandEnvelope(
@@ -26109,7 +26449,7 @@ function parseExecuteOptions(args) {
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function shellQuote3(value) {
+function shellQuote4(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function powerShellQuote(value) {
@@ -26179,7 +26519,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     path: scriptPath,
     sourceCode: script,
     projectDir,
-    macCopyCommand: `mkdir -p ${shellQuote3(projectDir)} && cp ${shellQuote3(scriptPath)} ${shellQuote3(`${projectDir}/${fileName}`)}`,
+    macCopyCommand: `mkdir -p ${shellQuote4(projectDir)} && cp ${shellQuote4(scriptPath)} ${shellQuote4(`${projectDir}/${fileName}`)}`,
     windowsCopyCommand: `New-Item -ItemType Directory -Force -Path ${powerShellQuote(projectDir.replace(/\//g, "\\"))} | Out-Null; Copy-Item -LiteralPath ${powerShellQuote(scriptPath)} -Destination ${powerShellQuote(`${projectDir.replace(/\//g, "\\")}\\${fileName}`)}`
   };
 }
@@ -26202,7 +26542,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     envelope,
     "output"
   );
-  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote3(JSON.stringify(input2.params))} --json`;
+  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote4(JSON.stringify(input2.params))} --json`;
   const actions = input2.listConversion ? [
     {
       label: "next",
@@ -27271,7 +27611,7 @@ function hasCommand(command) {
   });
   return result.status === 0;
 }
-function shellQuote4(arg) {
+function shellQuote5(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
@@ -27279,7 +27619,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
   const npxInstall = {
     command: "npx",
     args: npxArgs,
-    manualCommand: `npx ${npxArgs.map(shellQuote4).join(" ")}`
+    manualCommand: `npx ${npxArgs.map(shellQuote5).join(" ")}`
   };
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
@@ -27287,7 +27627,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
       {
         command: "bunx",
         args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote4).join(" ")}`
+        manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
       },
       npxInstall
     ];
@@ -27454,14 +27794,14 @@ function posixShellQuote(value) {
 function windowsCmdQuote(value) {
   return `"${value.replace(/"/g, '""')}"`;
 }
-function shellQuote5(value) {
+function shellQuote6(value) {
   if (process.platform === "win32") {
     return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : windowsCmdQuote(value);
   }
   return posixShellQuote(value);
 }
 function buildSourceUpdateCommand(sourceRoot) {
-  const quotedRoot = shellQuote5(sourceRoot);
+  const quotedRoot = shellQuote6(sourceRoot);
   const cdCommand = process.platform === "win32" ? `cd /d ${quotedRoot}` : `cd ${quotedRoot}`;
   return `${cdCommand} && git fetch origin main --tags && git merge --ff-only origin/main`;
 }
@@ -27473,7 +27813,7 @@ function buildSidecarProjectConfigCommand(versionDir, nodeBin) {
     "fs.mkdirSync(dir,{recursive:true});",
     `fs.writeFileSync(path.join(dir,'package.json'),${JSON.stringify(NPM_SDK_SIDECAR_PACKAGE_JSON)});`
   ].join("");
-  return `${shellQuote5(nodeBin)} -e ${shellQuote5(script)} ${shellQuote5(versionDir)}`;
+  return `${shellQuote6(nodeBin)} -e ${shellQuote6(script)} ${shellQuote6(versionDir)}`;
 }
 function sidecarStateDir(input2) {
   const scope = input2.env.DEEPLINE_CONFIG_SCOPE?.trim();
@@ -27512,7 +27852,7 @@ function resolvePythonSidecarUpdatePlan(options) {
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
   const versionDir = (0, import_node_path19.join)(stateDir, "versions", "<version>");
-  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote5(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote5).join(" ")} ${shellQuote5(packageSpec)}`;
+  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote6(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote6).join(" ")} ${shellQuote6(packageSpec)}`;
   return {
     kind: "python-sidecar",
     stateDir,
@@ -27592,7 +27932,7 @@ function resolveUpdatePlan(options = {}) {
     command,
     args,
     ...installPrefix ? { installPrefix } : {},
-    manualCommand: `${command} ${args.map(shellQuote5).join(" ")}`
+    manualCommand: `${command} ${args.map(shellQuote6).join(" ")}`
   };
 }
 var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
@@ -27753,9 +28093,9 @@ function writeSidecarLauncher(input2) {
     input2.path,
     [
       "#!/usr/bin/env sh",
-      `export DEEPLINE_HOST_URL=${shellQuote5(input2.hostUrl)}`,
-      `export DEEPLINE_CONFIG_SCOPE=${shellQuote5(input2.scope)}`,
-      `exec ${shellQuote5(input2.nodeBin)} ${shellQuote5(input2.entryPath)} "$@"`,
+      `export DEEPLINE_HOST_URL=${shellQuote6(input2.hostUrl)}`,
+      `export DEEPLINE_CONFIG_SCOPE=${shellQuote6(input2.scope)}`,
+      `exec ${shellQuote6(input2.nodeBin)} ${shellQuote6(input2.entryPath)} "$@"`,
       ""
     ].join("\n"),
     { encoding: "utf8", mode: 493 }