deepline 0.1.107 → 0.1.109

package/dist/cli/index.js

@@ -238,22 +238,24 @@ var SDK_RELEASE = {
   // preflight (existence, data rows, quotes, duplicate headers), HTML error
   // scrubbing, and word-boundary watch truncation.
   // 0.1.103 ships the refined SDK CLI command surface.
-  // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
+  // 0.1.104 shipped the retired Postgres scheduler suspension/billing parity and runtime worker hardening.
   // 0.1.105 ships the billing catalog surface: billing plans, subscribe,
   // subscription status/cancel, invoices, and the client.billing namespace.
   // 0.1.106 ships play cell provenance metadata and v2 preview retry hardening.
   // 0.1.107 ships the v2 quickstart command, the deepline-plays-quickstart
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
-  version: "0.1.107",
+  // 0.1.108 ships explicit dataset column/tool recompute policy and removes
+  // the SDK enrich generator's one-second stale policy.
+  version: "0.1.109",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.107",
+    latest: "0.1.109",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
       {
         command: "enrich",
-        minimumSupported: "0.1.106",
+        minimumSupported: "0.1.108",
         reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
       }
     ],
@@ -269,6 +271,7 @@ var SDK_API_CONTRACT = SDK_RELEASE.apiContract;
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
 var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
 var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
+var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
 // src/http.ts
@@ -337,6 +340,10 @@ var HttpClient = class {
     if (workerCallbackUrl?.trim()) {
       headers[WORKER_CALLBACK_URL_OVERRIDE_HEADER] = workerCallbackUrl.trim();
     }
+    const runtimeSchedulerSchema = typeof process !== "undefined" ? process.env?.DEEPLINE_RUNTIME_SCHEDULER_SCHEMA : void 0;
+    if (runtimeSchedulerSchema?.trim()) {
+      headers[RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER] = runtimeSchedulerSchema.trim();
+    }
     const syntheticRun = typeof process !== "undefined" ? process.env?.DEEPLINE_SYNTHETIC_RUN : void 0;
     if (syntheticRun && syntheticRun.trim() && syntheticRun.trim() !== "0") {
       headers[SYNTHETIC_RUN_HEADER] = "1";
@@ -543,8 +550,19 @@ var HttpClient = class {
       headers
     });
   }
+  /**
+   * Send a PATCH request with a JSON body.
+   *
+   * @typeParam T - Expected response body type
+   * @param path - API path
+   * @param body - JSON-serializable request body
+   */
   async patch(path, body, headers) {
-    return this.request(path, { method: "PATCH", body, headers });
+    return this.request(path, {
+      method: "PATCH",
+      body,
+      headers
+    });
   }
   /**
    * Send a DELETE request.
@@ -857,6 +875,8 @@ function normalizeStepProgress(value) {
         value.artifactTableNamespace
       )
     } : {},
+    ...finiteNumber(value.startedAt) !== null ? { startedAt: finiteNumber(value.startedAt) } : {},
+    ...finiteNumber(value.completedAt) !== null ? { completedAt: finiteNumber(value.completedAt) } : {},
     ...finiteNumber(value.updatedAt) !== null ? { updatedAt: finiteNumber(value.updatedAt) } : {}
   };
 }
@@ -893,6 +913,35 @@ function normalizePlayRunLiveStatus(value) {
 function isTerminalPlayRunLiveStatus(status) {
   return status === "completed" || status === "failed" || status === "cancelled" || status === "terminated" || status === "timed_out";
 }
+function isRecord2(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function finiteNumber2(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function extractTerminalRunLogTail(result) {
+  if (!isRecord2(result) || !isRecord2(result._metadata)) {
+    return null;
+  }
+  const runLogTail = result._metadata.runLogTail;
+  if (!isRecord2(runLogTail) || !Array.isArray(runLogTail.tail)) {
+    return null;
+  }
+  const logTail = runLogTail.tail.filter(
+    (line) => typeof line === "string" && line.trim().length > 0
+  );
+  if (logTail.length === 0) {
+    return null;
+  }
+  const totalLogCount = Math.max(
+    finiteNumber2(runLogTail.totalLogCount) ?? logTail.length,
+    logTail.length
+  );
+  return {
+    logTail: logTail.slice(-LOG_TAIL_LIMIT),
+    totalLogCount
+  };
+}
 function buildSnapshotFromLedger(snapshot) {
   const nodeStates = snapshot.orderedStepIds.map((stepId) => snapshot.stepsById[stepId]).filter((step) => Boolean(step)).map((step) => ({
     nodeId: step.stepId,
@@ -939,6 +988,14 @@ function buildPlayRunStatusSnapshot(input2) {
     updatedAt: input2.run.updatedAt ?? null,
     finishedAt: input2.run.finishedAt ?? null
   });
+  const terminalRunLogTail = extractTerminalRunLogTail(input2.run.result);
+  if (terminalRunLogTail && terminalRunLogTail.totalLogCount > ledgerSnapshot.totalLogCount) {
+    return buildSnapshotFromLedger({
+      ...ledgerSnapshot,
+      logTail: terminalRunLogTail.logTail,
+      totalLogCount: terminalRunLogTail.totalLogCount
+    });
+  }
   return buildSnapshotFromLedger(ledgerSnapshot);
 }
 function makeRunStreamEvent(input2) {
@@ -1533,7 +1590,7 @@ function chunkRegisterPlayArtifacts(artifacts) {
   return chunks;
 }
 var RUN_LOGS_PAGE_LIMIT = 1e3;
-function isRecord2(value) {
+function isRecord3(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isPrebuiltPlayDescription(play) {
@@ -1635,7 +1692,7 @@ function updatePlayLiveStatusState(state, event) {
   }
   const runId = typeof payload.runId === "string" && payload.runId ? payload.runId : isPlayRunPackage(payload) ? payload.run.id : state.runId;
   const status = normalizeLiveStatus(payload.status) ?? (isPlayRunPackage(payload) ? normalizeLiveStatus(payload.run.status) : null) ?? state.status;
-  const progressPayload = isRecord2(payload.progress) ? payload.progress : {};
+  const progressPayload = isRecord3(payload.progress) ? payload.progress : {};
   if (event.type === "play.run.final_status" && state.logs.length === 0 && state.lastLogSeq === 0) {
     const payloadLogs = readStringArray(payload.logs);
     const progressLogs = readStringArray(progressPayload.logs);
@@ -1748,9 +1805,9 @@ var DeeplineClient = class {
     return fields.length > 0 ? { fields } : schema;
   }
   schemaMetadata(schema, key) {
-    if (!isRecord2(schema)) return null;
+    if (!isRecord3(schema)) return null;
     const value = schema[key];
-    return isRecord2(value) ? value : null;
+    return isRecord3(value) ? value : null;
   }
   playRunCommand(play, options) {
     const target = play.reference || play.name;
@@ -1797,7 +1854,7 @@ var DeeplineClient = class {
       aliases,
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
-      staticPipeline: isRecord2(play.staticPipeline) ? play.staticPipeline : isRecord2(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord2(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
+      staticPipeline: isRecord3(play.staticPipeline) ? play.staticPipeline : isRecord3(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord3(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
       ...csvInput ? { csvInput } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand: runCommand2,
@@ -5291,14 +5348,14 @@ function sanitizeCsvProjectionInfo(input2) {
   const rows = input2.rows.map(stripCsvProjectionFields);
   return { rows, columns };
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isSerializedDataset(value) {
-  return isRecord3(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);
 }
 function isPackagedDatasetOutput(value) {
-  return isRecord3(value) && value.kind === "dataset" && isRecord3(value.preview) && Array.isArray(value.preview.rows);
+  return isRecord4(value) && value.kind === "dataset" && isRecord4(value.preview) && Array.isArray(value.preview.rows);
 }
 function pathParts(path) {
   return path.split(".").map((part) => part.trim()).filter(Boolean);
@@ -5306,7 +5363,7 @@ function pathParts(path) {
 function valueAtPath(root, path) {
   let cursor = root;
   for (const part of pathParts(path)) {
-    if (!isRecord3(cursor)) {
+    if (!isRecord4(cursor)) {
       return void 0;
     }
     cursor = cursor[part];
@@ -5314,17 +5371,17 @@ function valueAtPath(root, path) {
   return cursor;
 }
 function totalRowsForDataset(result, datasetPath) {
-  const metadata = isRecord3(result._metadata) ? result._metadata : null;
+  const metadata = isRecord4(result._metadata) ? result._metadata : null;
   const parentPath = datasetPath.split(".").slice(0, -1).join(".");
   const parent = parentPath ? valueAtPath({ result }, parentPath) : result;
-  return metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count ?? (isRecord3(parent) ? parent.totalRows ?? parent.rowCount ?? parent.count : void 0) ?? result.totalRows ?? result.rowCount ?? result.count;
+  return metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count ?? (isRecord4(parent) ? parent.totalRows ?? parent.rowCount ?? parent.count : void 0) ?? result.totalRows ?? result.rowCount ?? result.count;
 }
 function rowArray(value) {
   if (!Array.isArray(value)) {
     return null;
   }
   const rows = value.filter(
-    (row) => isRecord3(row)
+    (row) => isRecord4(row)
   );
   return rows.length === value.length ? rows : null;
 }
@@ -5348,7 +5405,7 @@ function inferColumns(rows) {
   return columns;
 }
 function columnsFromDatasetSummary(summary) {
-  if (!isRecord3(summary) || !isRecord3(summary.columnStats)) {
+  if (!isRecord4(summary) || !isRecord4(summary.columnStats)) {
     return [];
   }
   return Object.keys(summary.columnStats).filter((column) => column);
@@ -5377,7 +5434,7 @@ function canonicalRowsInfoFromCandidate(input2) {
   }
   if (isPackagedDatasetOutput(candidate.value)) {
     const rawRows = rowArray(candidate.value.preview?.rows) ?? [];
-    const totalRows2 = readNumber(candidate.value.preview?.totalRows) ?? readNumber(candidate.value.rowCount) ?? rawRows.length;
+    const totalRows2 = readNumber(candidate.value.rowCount) ?? readNumber(candidate.value.preview?.totalRows) ?? rawRows.length;
     const explicitColumns = Array.isArray(candidate.value.columns) ? candidate.value.columns.filter(
       (column) => typeof column === "string"
     ) : [];
@@ -5438,7 +5495,7 @@ function collectDatasetCandidates(input2) {
     });
     return;
   }
-  if (!isRecord3(input2.value)) {
+  if (!isRecord4(input2.value)) {
     return;
   }
   for (const [key, child] of Object.entries(input2.value)) {
@@ -5455,12 +5512,12 @@ function collectDatasetCandidates(input2) {
   }
 }
 function collectCanonicalRowsInfos(statusOrResult) {
-  const root = isRecord3(statusOrResult) ? statusOrResult : null;
-  const result = isRecord3(root?.result) ? root.result : root;
+  const root = isRecord4(statusOrResult) ? statusOrResult : null;
+  const result = isRecord4(root?.result) ? root.result : root;
   if (!result) {
     return [];
   }
-  const metadata = isRecord3(result._metadata) ? result._metadata : null;
+  const metadata = isRecord4(result._metadata) ? result._metadata : null;
   const totalFromMetadata = metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count;
   const candidates = [
     {
@@ -5484,8 +5541,8 @@ function collectCanonicalRowsInfos(statusOrResult) {
       total: totalFromMetadata ?? result.totalRows ?? result.rowCount ?? result.count
     }
   ];
-  if (isRecord3(result.output)) {
-    const outputMetadata = isRecord3(result.output._metadata) ? result.output._metadata : null;
+  if (isRecord4(result.output)) {
+    const outputMetadata = isRecord4(result.output._metadata) ? result.output._metadata : null;
     const outputTotalFromMetadata = outputMetadata?.totalRows ?? outputMetadata?.rowCount ?? outputMetadata?.count;
     candidates.push(
       {
@@ -5512,14 +5569,14 @@ function collectCanonicalRowsInfos(statusOrResult) {
   }
   if (Array.isArray(result.steps)) {
     result.steps.forEach((step, index) => {
-      if (!isRecord3(step) || !isRecord3(step.output)) {
+      if (!isRecord4(step) || !isRecord4(step.output)) {
         return;
       }
       const source = typeof step.output.path === "string" ? step.output.path : typeof step.id === "string" ? `steps.${step.id}.output` : `steps.${index}.output`;
       candidates.push({
         source,
         value: step.output,
-        total: step.output.rowCount ?? (isRecord3(step.output.preview) ? step.output.preview.totalRows : void 0) ?? (isRecord3(step.progress) ? step.progress.total : void 0)
+        total: step.output.rowCount ?? (isRecord4(step.output.preview) ? step.output.preview.totalRows : void 0) ?? (isRecord4(step.progress) ? step.progress.total : void 0)
       });
     });
   }
@@ -5546,15 +5603,15 @@ function collectCanonicalRowsInfos(statusOrResult) {
   return infos;
 }
 function collectPackagedStepDatasetCandidates(statusOrResult) {
-  const root = isRecord3(statusOrResult) ? statusOrResult : null;
+  const root = isRecord4(statusOrResult) ? statusOrResult : null;
   if (!root) {
     return [];
   }
-  const pkg = isRecord3(root.package) ? root.package : root;
+  const pkg = isRecord4(root.package) ? root.package : root;
   const steps = Array.isArray(pkg.steps) ? pkg.steps : [];
   const candidates = [];
   for (const step of steps) {
-    if (!isRecord3(step) || !isRecord3(step.output)) {
+    if (!isRecord4(step) || !isRecord4(step.output)) {
       continue;
     }
     const output2 = step.output;
@@ -5568,14 +5625,14 @@ function collectPackagedStepDatasetCandidates(statusOrResult) {
     candidates.push({
       source,
       value: output2,
-      total: output2.rowCount ?? (isRecord3(output2.preview) ? output2.preview.totalRows : void 0) ?? (isRecord3(step.progress) ? step.progress.total : void 0)
+      total: output2.rowCount ?? (isRecord4(output2.preview) ? output2.preview.totalRows : void 0) ?? (isRecord4(step.progress) ? step.progress.total : void 0)
     });
   }
   return candidates;
 }
 function collectSerializedDatasetRowsInfos(statusOrResult) {
-  const root = isRecord3(statusOrResult) ? statusOrResult : null;
-  const result = isRecord3(root?.result) ? root.result : root;
+  const root = isRecord4(statusOrResult) ? statusOrResult : null;
+  const result = isRecord4(root?.result) ? root.result : root;
   const candidates = [];
   if (result) {
     collectDatasetCandidates({
@@ -5611,17 +5668,17 @@ function percentText(numerator, denominator) {
   return datasetSummaryPercentText(numerator, denominator);
 }
 function isDatasetExecutionStatsInput(value) {
-  return isRecord3(value) && isRecord3(value.columnStats) && Object.values(value.columnStats).every(isRecord3);
+  return isRecord4(value) && isRecord4(value.columnStats) && Object.values(value.columnStats).every(isRecord4);
 }
 function extractDatasetExecutionStats(statusOrResult) {
-  if (!isRecord3(statusOrResult)) {
+  if (!isRecord4(statusOrResult)) {
     return null;
   }
   const direct = statusOrResult.dataset_execution_stats;
   if (isDatasetExecutionStatsInput(direct)) {
     return direct;
   }
-  const nested = isRecord3(statusOrResult.result) ? statusOrResult.result.dataset_execution_stats : null;
+  const nested = isRecord4(statusOrResult.result) ? statusOrResult.result.dataset_execution_stats : null;
   return isDatasetExecutionStatsInput(nested) ? nested : null;
 }
 function countPercentText(count, denominator) {
@@ -5662,13 +5719,13 @@ function summarizeSampleValue(value, depth = 0) {
   if (typeof parsed === "number" || typeof parsed === "boolean") return parsed;
   if (depth >= 3) {
     if (Array.isArray(parsed)) return [];
-    if (isRecord3(parsed)) return {};
+    if (isRecord4(parsed)) return {};
     return compactScalar(parsed);
   }
   if (Array.isArray(parsed)) {
     return parsed.slice(0, 3).map((item) => summarizeSampleValue(item, depth + 1));
   }
-  if (isRecord3(parsed)) {
+  if (isRecord4(parsed)) {
     const out = {};
     for (const [key, nested] of Object.entries(parsed)) {
       if (["__dl", "meta", "metadata"].includes(key)) {
@@ -5699,7 +5756,7 @@ function compactCell(value) {
     }
     return `[${parsed.length} items]`;
   }
-  if (isRecord3(parsed)) {
+  if (isRecord4(parsed)) {
     for (const key of ["matched_result", "output"]) {
       if (parsed[key] !== null && parsed[key] !== void 0 && parsed[key] !== "") {
         return compactCell(parsed[key]);
@@ -7469,16 +7526,19 @@ var PLAY_DEDUP_BACKENDS = {
 var PLAY_SCHEDULER_BACKENDS = {
   temporal: "temporal",
   cfWorkflows: "cf-workflows",
+  /**
+   * 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: "postgres",
+  hatchet: "hatchet",
   inProcess: "in-process"
 };
 
 // ../shared_libs/play-runtime/providers.ts
 var PLAY_RUNTIME_PROVIDER_IDS = {
   workersEdge: "workers_edge",
-  postgresFast: "postgres_fast",
-  postgresFastSandbox: "postgres_fast_sandbox",
-  postgresFastWorkers: "postgres_fast_workers",
+  hatchet: "hatchet",
   local: "local"
 };
 var PLAY_RUNTIME_PROVIDERS = {
@@ -7490,29 +7550,13 @@ var PLAY_RUNTIME_PROVIDERS = {
     artifactKind: PLAY_ARTIFACT_KINDS.esmWorkers,
     label: "Cloudflare Dynamic Workflows + Dynamic Workers + DO dedup"
   },
-  postgres_fast: {
-    id: PLAY_RUNTIME_PROVIDER_IDS.postgresFast,
-    scheduler: PLAY_SCHEDULER_BACKENDS.postgres,
+  hatchet: {
+    id: PLAY_RUNTIME_PROVIDER_IDS.hatchet,
+    scheduler: PLAY_SCHEDULER_BACKENDS.hatchet,
     runner: PLAY_RUNTIME_BACKENDS.daytona,
     dedup: PLAY_DEDUP_BACKENDS.durableObject,
     artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "BETA: Postgres Scheduler + warm sandbox runner + DO dedup"
-  },
-  postgres_fast_sandbox: {
-    id: PLAY_RUNTIME_PROVIDER_IDS.postgresFastSandbox,
-    scheduler: PLAY_SCHEDULER_BACKENDS.postgres,
-    runner: PLAY_RUNTIME_BACKENDS.daytona,
-    dedup: PLAY_DEDUP_BACKENDS.durableObject,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "BETA: Postgres Scheduler + warm sandbox runner + DO dedup"
-  },
-  postgres_fast_workers: {
-    id: PLAY_RUNTIME_PROVIDER_IDS.postgresFastWorkers,
-    scheduler: PLAY_SCHEDULER_BACKENDS.postgres,
-    runner: PLAY_RUNTIME_BACKENDS.cloudflareWorkers,
-    dedup: PLAY_DEDUP_BACKENDS.durableObject,
-    artifactKind: PLAY_ARTIFACT_KINDS.esmWorkers,
-    label: "Experimental Postgres Scheduler + Queue/DO-woken Workers + DO dedup"
+    label: "Hatchet scheduler + one-shot Daytona runner + DO dedup"
   },
   local: {
     id: PLAY_RUNTIME_PROVIDER_IDS.local,
@@ -8024,17 +8068,17 @@ function parsePositiveInteger2(value, flagName) {
   }
   return parsed;
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringValue(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function extractionEntries(value) {
-  if (Array.isArray(value)) return value.filter(isRecord4);
-  if (!isRecord4(value)) return [];
+  if (Array.isArray(value)) return value.filter(isRecord5);
+  if (!isRecord5(value)) return [];
   return Object.entries(value).map(
-    ([name, entry]) => isRecord4(entry) ? { name, ...entry } : { name }
+    ([name, entry]) => isRecord5(entry) ? { name, ...entry } : { name }
   );
 }
 var PlayBootstrapError = class extends Error {
@@ -8454,7 +8498,7 @@ function readCsvSampleRows(sample) {
     relax_column_count: true,
     trim: true
   });
-  return Array.isArray(parsedRows) ? parsedRows.filter(isRecord4) : [];
+  return Array.isArray(parsedRows) ? parsedRows.filter(isRecord5) : [];
 }
 function readSourceCsvColumnSpecs(csvPath) {
   const sample = readCsvSample(csvPath);
@@ -8487,16 +8531,16 @@ function packagedCsvPathForPlay(csvPath) {
   return portablePath.startsWith(".") ? portablePath : `./${portablePath}`;
 }
 function getterNamesFromTool(tool, kind) {
-  const usageGuidance = isRecord4(tool?.usageGuidance) ? tool.usageGuidance : {};
-  const resultGuidance = isRecord4(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord4(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
+  const usageGuidance = isRecord5(tool?.usageGuidance) ? tool.usageGuidance : {};
+  const resultGuidance = isRecord5(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord5(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
   const key = kind === "list" ? "extractedLists" : "extractedValues";
   const snakeKey = kind === "list" ? "extracted_lists" : "extracted_values";
   return extractionEntries(resultGuidance[key] ?? resultGuidance[snakeKey]).map((entry) => stringValue(entry.name)).filter(Boolean);
 }
 function targetGettersFromTool(tool) {
-  const record = isRecord4(tool) ? tool : {};
+  const record = isRecord5(tool) ? tool : {};
   const raw = record.targetGetters ?? record.target_getters;
-  if (!isRecord4(raw)) return {};
+  if (!isRecord5(raw)) return {};
   const entries = [];
   for (const [target, value] of Object.entries(raw)) {
     const paths = Array.isArray(value) ? value.map((path) => typeof path === "string" ? path.trim() : "").filter(Boolean) : [];
@@ -8517,10 +8561,10 @@ function listRowCandidateKeysFromTool(tool) {
   return [...keys].sort();
 }
 function inputPropertyNames(schema) {
-  if (!isRecord4(schema)) return [];
-  if (isRecord4(schema.properties)) return Object.keys(schema.properties);
+  if (!isRecord5(schema)) return [];
+  if (isRecord5(schema.properties)) return Object.keys(schema.properties);
   if (Array.isArray(schema.fields)) {
-    return schema.fields.filter(isRecord4).map((field) => stringValue(field.name)).filter(Boolean);
+    return schema.fields.filter(isRecord5).map((field) => stringValue(field.name)).filter(Boolean);
   }
   return [];
 }
@@ -8534,7 +8578,7 @@ function schemaFieldDetails(schema) {
   return { required, optional };
 }
 function jsonSchemaTypeExpression(schema) {
-  if (!isRecord4(schema)) return "unknown";
+  if (!isRecord5(schema)) return "unknown";
   const type = schema.type;
   if (Array.isArray(type)) {
     return type.map((entry) => jsonSchemaTypeExpression({ ...schema, type: entry })).join(" | ");
@@ -8564,7 +8608,7 @@ function jsonSchemaTypeExpression(schema) {
   }
 }
 function objectPropertySchema(schema, property) {
-  return isRecord4(schema) && isRecord4(schema.properties) ? schema.properties[property] : null;
+  return isRecord5(schema) && isRecord5(schema.properties) ? schema.properties[property] : null;
 }
 function playOutputHasField(schema, field) {
   return objectPropertySchema(schema, field) != null;
@@ -8740,14 +8784,14 @@ ${indent2.slice(2)}}`;
 }
 function requiredPlayInputFields(play) {
   const schema = play?.inputSchema;
-  if (!isRecord4(schema)) return [];
+  if (!isRecord5(schema)) return [];
   if (Array.isArray(schema.required)) {
     return schema.required.filter(
       (value) => typeof value === "string"
     );
   }
   if (Array.isArray(schema.fields)) {
-    return schema.fields.filter(isRecord4).filter(
+    return schema.fields.filter(isRecord5).filter(
       (field) => field.required === true && typeof field.name === "string"
     ).map((field) => String(field.name));
   }
@@ -8928,7 +8972,7 @@ function validateBootstrapRoutes(input2) {
   }
 }
 function staticPipelineSubsteps(pipeline) {
-  if (!isRecord4(pipeline)) return [];
+  if (!isRecord5(pipeline)) return [];
   return [
     ...extractionEntries(pipeline.stages),
     ...extractionEntries(pipeline.substeps)
@@ -8936,7 +8980,7 @@ function staticPipelineSubsteps(pipeline) {
 }
 function playUsesMapBackedRuntime(play) {
   const pipeline = play?.staticPipeline;
-  if (!isRecord4(pipeline)) return false;
+  if (!isRecord5(pipeline)) return false;
   if (stringValue(pipeline.tableNamespace)) return true;
   return staticPipelineSubsteps(pipeline).some((substep) => {
     if (stringValue(substep.type) === "map") return true;
@@ -8945,7 +8989,7 @@ function playUsesMapBackedRuntime(play) {
       aliases: [],
       runCommand: "",
       examples: [],
-      staticPipeline: isRecord4(substep.pipeline) ? substep.pipeline : null
+      staticPipeline: isRecord5(substep.pipeline) ? substep.pipeline : null
     });
   });
 }
@@ -10507,10 +10551,12 @@ function playStatusValue(value) {
   return value === "queued" || value === "running" || value === "waiting" || value === "completed" || value === "failed" || value === "cancelled" ? value : null;
 }
 function getRunRecordFromPackage(value) {
-  if (!isPlayRunPackageValue(value)) {
+  const nestedPackage = value.package;
+  const playRunPackage = isPlayRunPackageValue(value) ? value : isPlayRunPackageValue(nestedPackage) ? nestedPackage : null;
+  if (!playRunPackage) {
     return null;
   }
-  const run = value.run;
+  const run = playRunPackage.run;
   return run && typeof run === "object" && !Array.isArray(run) ? run : null;
 }
 function getRunIdFromLiveEvent(event) {
@@ -10540,10 +10586,12 @@ function getFinalStatusFromLiveEvent(event) {
     return null;
   }
   const runId = typeof payload.runId === "string" ? payload.runId : typeof packageRun?.id === "string" ? packageRun.id : "";
+  const error = typeof payload.error === "string" ? payload.error : typeof packageRun?.error === "string" ? packageRun.error : void 0;
   return {
     ...payload,
     runId,
-    status
+    status,
+    ...error ? { error } : {}
   };
 }
 function getLogLinesFromLiveEvent(event) {
@@ -11862,7 +11910,16 @@ function withTerminalPlayIdentity(status, playName) {
 function compactPlayStatus(status) {
   const packaged = getPlayRunPackage(status);
   if (packaged) {
-    return packaged;
+    const error2 = selectRunErrorForDisplay(status) ?? (typeof status.error === "string" ? String(status.error) : null);
+    if (!error2) {
+      return packaged;
+    }
+    const run = packaged.run && typeof packaged.run === "object" ? packaged.run : null;
+    return {
+      ...packaged,
+      error: error2,
+      ...run ? { run: { ...run, error: error2 } } : {}
+    };
   }
   const rowsInfo = extractCanonicalRowsInfo(status);
   const result = status && typeof status === "object" ? status.result : null;
@@ -12202,10 +12259,17 @@ function writePlayResult(status, jsonOutput, options) {
 ` }
   );
 }
-function playRunPackageStepCount(pkg) {
-  if (!pkg) return 0;
-  const steps = pkg.steps;
-  return Array.isArray(steps) ? steps.length : 0;
+function playRunPackageTextLedgerIncomplete(pkg) {
+  if (!pkg) return true;
+  const steps = readRecordArray(pkg.steps);
+  if (steps.length === 0) return true;
+  for (const step of steps) {
+    if (step.kind !== "dataset" || step.status !== "completed") continue;
+    const output2 = readRecord(step.output);
+    if (!output2 || typeof output2.rowCount !== "number") return true;
+    if (!readRecord(output2.summary)) return true;
+  }
+  return false;
 }
 async function resolvePlayRunOutputStatus(input2) {
   const runId = input2.status.runId;
@@ -12214,7 +12278,7 @@ async function resolvePlayRunOutputStatus(input2) {
   }
   const streamedPackage = getPlayRunPackage(input2.status);
   const refreshForFullJson = input2.fullJson && streamedPackage !== null;
-  const streamedTextPackageIncomplete = !input2.jsonOutput && input2.status.status === "completed" && playRunPackageStepCount(streamedPackage) === 0;
+  const streamedTextPackageIncomplete = !input2.jsonOutput && input2.status.status === "completed" && playRunPackageTextLedgerIncomplete(streamedPackage);
   if (!refreshForFullJson && !streamedTextPackageIncomplete) {
     return input2.status;
   }
@@ -12222,7 +12286,7 @@ async function resolvePlayRunOutputStatus(input2) {
     billing: false,
     full: input2.fullJson
   });
-  for (let attempt = 0; attempt < 3 && streamedTextPackageIncomplete && refreshedStatus.status === "completed" && playRunPackageStepCount(getPlayRunPackage(refreshedStatus)) === 0; attempt += 1) {
+  for (let attempt = 0; attempt < 3 && streamedTextPackageIncomplete && refreshedStatus.status === "completed" && playRunPackageTextLedgerIncomplete(getPlayRunPackage(refreshedStatus)); attempt += 1) {
     await sleep5(250);
     refreshedStatus = await input2.client.getPlayStatus(runId, {
       billing: false,
@@ -12531,7 +12595,7 @@ function extractPlayValidationErrors(value) {
   if (value instanceof DeeplineError) {
     return extractPlayValidationErrors(value.details);
   }
-  if (!isRecord5(value)) {
+  if (!isRecord6(value)) {
     return [];
   }
   const directErrors = stringArrayField(value, "errors");
@@ -12744,7 +12808,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; postgres_fast is BETA (opt-in per run, never the default).\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotency, tool call id, 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; hatchet is the durable Daytona-backed preview runtime.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotency, tool call id, and ctx.dataset guidance.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -12889,7 +12953,7 @@ function shouldUseLocalOnlyPlayCheck() {
   const value = process.env.DEEPLINE_PLAY_CHECK_LOCAL_ONLY?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes" || value === "on";
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringValue2(value) {
@@ -12899,14 +12963,14 @@ function asArray(value) {
   return Array.isArray(value) ? value : [];
 }
 function extractionEntries2(value) {
-  if (Array.isArray(value)) return value.filter(isRecord5);
-  if (!isRecord5(value)) return [];
+  if (Array.isArray(value)) return value.filter(isRecord6);
+  if (!isRecord6(value)) return [];
   return Object.entries(value).map(
-    ([name, entry]) => isRecord5(entry) ? { name, ...entry } : { name }
+    ([name, entry]) => isRecord6(entry) ? { name, ...entry } : { name }
   );
 }
 function firstRawPath(entry) {
-  const details = isRecord5(entry.details) ? entry.details : {};
+  const details = isRecord6(entry.details) ? entry.details : {};
   const paths = [
     ...asArray(details.rawToolOutputPaths),
     ...asArray(details.raw_tool_output_paths),
@@ -12924,12 +12988,12 @@ function checkHintRawPath(value) {
 function collectStaticPipelineToolIds(staticPipeline) {
   const seen = /* @__PURE__ */ new Set();
   const visitPipeline = (pipeline) => {
-    if (!isRecord5(pipeline)) return;
+    if (!isRecord6(pipeline)) return;
     for (const step of [
       ...asArray(pipeline.stages),
       ...asArray(pipeline.substeps)
     ]) {
-      if (!isRecord5(step)) continue;
+      if (!isRecord6(step)) continue;
       if (step.type === "tool") {
         const toolId = stringValue2(step.toolId) || stringValue2(step.tool);
         if (toolId) seen.add(toolId);
@@ -12943,9 +13007,9 @@ function collectStaticPipelineToolIds(staticPipeline) {
   return [...seen].sort();
 }
 function toolGetterHintFromMetadata(toolId, tool) {
-  const usageGuidance = isRecord5(tool.usageGuidance) ? tool.usageGuidance : {};
-  const resultGuidance = isRecord5(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord5(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
-  const toolResponse = isRecord5(resultGuidance.toolResponse) ? resultGuidance.toolResponse : isRecord5(resultGuidance.tool_response) ? resultGuidance.tool_response : {};
+  const usageGuidance = isRecord6(tool.usageGuidance) ? tool.usageGuidance : {};
+  const resultGuidance = isRecord6(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord6(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
+  const toolResponse = isRecord6(resultGuidance.toolResponse) ? resultGuidance.toolResponse : isRecord6(resultGuidance.tool_response) ? resultGuidance.tool_response : {};
   const lists = extractionEntries2(
     resultGuidance.extractedLists ?? resultGuidance.extracted_lists
   ).map((entry) => ({
@@ -14270,6 +14334,40 @@ async function handlePlayDescribe(args) {
     );
     return 2;
   }
+  if (isFileTarget(playName) || looksLikeFilePath(playName)) {
+    const message = "Local play files can be checked and run, but describe only supports saved/prebuilt play references.";
+    const definedName = isFileTarget(playName) ? (() => {
+      try {
+        return extractPlayName(
+          (0, import_node_fs10.readFileSync)((0, import_node_path12.resolve)(playName), "utf-8"),
+          playName
+        );
+      } catch {
+        return null;
+      }
+    })() : null;
+    const next = [
+      `deepline plays check ${playName}`,
+      ...definedName ? [`deepline plays describe <workspace>/${definedName}`] : []
+    ];
+    if (argsWantJson(args)) {
+      process.stdout.write(
+        `${JSON.stringify({
+          ok: false,
+          error: { message },
+          next
+        })}
+`
+      );
+    } else {
+      console.error(message);
+      console.error(`Try: ${next[0]}`);
+      if (next[1]) {
+        console.error(`Or after publishing/running: ${next[1]}`);
+      }
+    }
+    return 2;
+  }
   const client2 = new DeeplineClient();
   await assertCanonicalNamedPlayReference(client2, playName);
   const play = await client2.describePlay(
@@ -15351,6 +15449,18 @@ function getterFromLegacyExtractJs(extractJs, fallbackAlias) {
   return null;
 }
 
+// src/cli/enrich-compat-adapter.ts
+var ENRICH_COMPAT_DEFAULT_PLAY_NAME = "deepline-enrich-v1-compat";
+var ENRICH_COMPAT_DEFAULT_MAP_NAME = "deepline_enrich_rows";
+var ENRICH_COMPAT_METADATA_CELL_POLICY_SOURCE = "{ recompute: true }";
+function buildEnrichCompatibilityPlan(options = {}) {
+  return {
+    playName: options.playName?.trim() || ENRICH_COMPAT_DEFAULT_PLAY_NAME,
+    mapName: options.mapName?.trim() || ENRICH_COMPAT_DEFAULT_MAP_NAME,
+    metadataCellPolicySource: ENRICH_COMPAT_METADATA_CELL_POLICY_SOURCE
+  };
+}
+
 // src/cli/user-code-safety.ts
 var FORBIDDEN = [
   // Non-deterministic — breaks replay.
@@ -15491,7 +15601,7 @@ function renderIdiomaticExecuteStep(command, options) {
     `    tool: ${tool},`,
     `    input: ${input2} as any,`,
     `    description: ${stringLiteral((command.description ?? "").trim() || `Run ${command.alias} via ${command.tool}.`)},`,
-    ...options.force ? [`    staleAfterSeconds: 1,`] : [],
+    ...options.force ? [`    force: true,`] : [],
     `  });`,
     `  return ${extraction};`,
     `}`
@@ -15522,18 +15632,18 @@ function renderPlayStep(command, options) {
   const runIfJs = command.run_if_js ? `(row) => { const input = row; const context = row;
 ${indent(renderJavascriptBody(command.run_if_js), 6)}
     }` : "null";
-  const runIfLines = command.run_if_js ? [`  const __dlRunIf = ${runIfJs};`, `  if (!__dlRunIf(row)) return null;`] : [];
-  const playOptions = [
-    `      description: ${stringLiteral(command.description ?? command.alias)}`,
-    ...options.force ? [`      staleAfterSeconds: 1`] : []
-  ].join(",\n");
+  const runIfLines = command.run_if_js ? [
+    `  const __dlRunIf = ${runIfJs};`,
+    `  if (!__dlRunIf(templateRow)) return null;`
+  ] : [];
   return [
     `async (row, stepCtx) => {`,
     ...options.precheck ? [`  if (${options.precheck}) return null;`] : [],
+    `  const templateRow = __dlPrepareEnrichRow(row, [${alias}]);`,
     ...runIfLines,
-    `  const payload = __dlTemplate(${payload}, row) as Record<string, unknown>;`,
+    `  const payload = __dlTemplate(${payload}, templateRow) as Record<string, unknown>;`,
     `  const result = await stepCtx.runPlay(${callId}, ${playRef}, payload, {`,
-    playOptions,
+    `      description: ${stringLiteral(command.description ?? command.alias)}`,
     `  });`,
     `  return __dlPlayResultValue(${alias}, result);`,
     `}`
@@ -15550,12 +15660,17 @@ function renderJavascriptBody(source) {
   }
   return source;
 }
-function renderColumnStep(alias, resolverSource, force) {
+function renderColumnStep(alias, resolverSource, options = {}) {
   const resolver = indent(resolverSource, 8);
+  const optionFields = [
+    ...options.recompute === true ? ["recompute: true"] : [],
+    ...options.recomputeOnError === true ? ["recomputeOnError: true"] : []
+  ];
+  const optionSource = optionFields.length > 0 ? `{ ${optionFields.join(", ")} }` : null;
   return [
     `      .withColumn(${stringLiteral(alias)},`,
-    force ? `${resolver},` : resolver,
-    ...force ? [`        { staleAfterSeconds: 1 }`] : [],
+    `${resolver}${optionSource ? "," : ""}`,
+    ...optionSource ? [`        ${optionSource},`] : [],
     `      )`
   ].join("\n");
 }
@@ -15604,15 +15719,38 @@ function collectMetadataColumns(commands, waterfallGroupId) {
   }
   return columns;
 }
-function renderMetadataColumnStep(config) {
+function collectGeneratedAliases(commands) {
+  const aliases = [];
+  const addAlias = (alias) => {
+    if (alias && !aliases.includes(alias)) {
+      aliases.push(alias);
+    }
+  };
+  for (const command of commands) {
+    if (isWaterfall(command)) {
+      const before = aliases.length;
+      collectGeneratedAliases(command.commands).forEach(addAlias);
+      if (aliases.length > before) {
+        addAlias(command.with_waterfall);
+        addAlias(`${command.with_waterfall}_source`);
+      }
+      continue;
+    }
+    if (!command.disabled) {
+      addAlias(command.alias);
+    }
+  }
+  return aliases;
+}
+function renderMetadataColumnStep(config, policySource) {
   const columns = collectMetadataColumns(config.commands);
   if (Object.keys(columns).length === 0) {
     return "";
   }
   return [
     `      .withColumn('_metadata',`,
-    `        (row) => __dlMergeMetadata(row._metadata, ${stableJson({ columns })}),`,
-    `        { staleAfterSeconds: 1 }`,
+    `        (row) => __dlMergeMetadata(__dlMetadataFromRow(row), ${stableJson({ columns })}),`,
+    `        ${policySource},`,
     `      )`
   ].join("\n");
 }
@@ -15639,7 +15777,7 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
         inlineRunJavascript,
         idiomaticGetters
       }),
-      force
+      { recompute: force, recomputeOnError: true }
     );
   }).filter((line) => line !== null);
   const aliases = activeChildren.map((nested) => nested.alias);
@@ -15655,21 +15793,19 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
   }
   return [
     ...columnSteps,
-    renderColumnStep(
-      command.with_waterfall,
-      `(row) => ${returnExpr}`,
-      forceParent
-    ),
+    renderColumnStep(command.with_waterfall, `(row) => ${returnExpr}`, {
+      recompute: forceParent
+    }),
     renderColumnStep(
       `${command.with_waterfall}_source`,
       typeof command.min_results === "number" ? `(row) => __dlContributingAliases(row, ${stableJson(aliases)})` : `(row) => __dlFirstMeaningfulAlias(row, ${stableJson(aliases)})`,
-      forceParent
+      { recompute: forceParent }
     )
   ];
 }
 function compileEnrichConfigToPlaySource(config, options = {}) {
-  const playName = options.playName ?? "deepline-enrich-v1-compat";
-  const mapName = options.mapName ?? "deepline_enrich_rows";
+  const compatibility = buildEnrichCompatibilityPlan(options);
+  const { playName, mapName } = compatibility;
   const inlineRunJavascript = options.inlineRunJavascript ?? false;
   const idiomaticGetters = options.idiomaticGetters ?? false;
   const forceAliases = new Set(
@@ -15700,18 +15836,30 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
           inlineRunJavascript,
           idiomaticGetters
         }),
-        force
+        { recompute: force, recomputeOnError: true }
       )
     );
   });
   const columnStepSource = columnSteps.length > 0 ? columnSteps.join("\n") : `      .withColumn('noop', () => null)`;
-  const metadataColumnSource = renderMetadataColumnStep(config);
+  const metadataColumnSource = renderMetadataColumnStep(
+    config,
+    compatibility.metadataCellPolicySource
+  );
+  const generatedAliases = collectGeneratedAliases(config.commands);
   const body = [
     `export default definePlay(${stringLiteral(playName)}, async (ctx, input: EnrichInput) => {`,
     `  const sourceRows = await ctx.csv<Record<string, unknown>>(input.file);`,
     `  const rowStart = __dlNonNegativeInteger(input.rowStart, 0);`,
     `  const rowEndExclusive = Number.isFinite(input.rowEnd) ? Math.max(rowStart, __dlWholeNumber(input.rowEnd, rowStart) + 1) : undefined;`,
-    `  const rows = sourceRows.slice(rowStart, rowEndExclusive, { key: 'deepline_enrich_selected_rows', sourceLabel: 'Selected enrich rows' });`,
+    `  const rows: Array<Record<string, unknown>> = [];`,
+    `  let sourceRowIndex = 0;`,
+    `  for await (const row of sourceRows) {`,
+    `    if (rowEndExclusive !== undefined && sourceRowIndex >= rowEndExclusive) break;`,
+    `    if (sourceRowIndex >= rowStart) {`,
+    `      rows.push(__dlPrepareEnrichRow(row, ${stableJson(generatedAliases)}));`,
+    `    }`,
+    `    sourceRowIndex += 1;`,
+    `  }`,
     `  const enriched = await ctx`,
     `    .dataset(${stringLiteral(mapName)}, rows)`,
     columnStepSource,
@@ -15797,6 +15945,18 @@ function helperSource() {
     `  return null;`,
     `}`,
     ``,
+    `function __dlMetadataFromRow(row: Record<string, unknown>): unknown {`,
+    `  const direct = __dlParseMetadata(row._metadata);`,
+    `  if (direct) return direct;`,
+    `  const relocated = __dlParseMetadata(row.metadata);`,
+    `  if (relocated) return relocated;`,
+    `  const dotted = __dlParseMetadata(row['metadata.columns']);`,
+    `  if (dotted) return { columns: dotted };`,
+    `  const underscored = __dlParseMetadata(row.metadata__columns);`,
+    `  if (underscored) return { columns: underscored };`,
+    `  return row._metadata;`,
+    `}`,
+    ``,
     `function __dlMergeMetadata(existing: unknown, patch: Record<string, unknown>): Record<string, unknown> {`,
     `  const base = __dlParseMetadata(existing) ?? {};`,
     `  const baseColumns = __dlRecord(base.columns) ? base.columns : {};`,
@@ -15830,17 +15990,55 @@ function helperSource() {
     `  return parts;`,
     `}`,
     ``,
+    `function __dlNormalizeHeader(value: string): string {`,
+    `  return value.trim().replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');`,
+    `}`,
+    ``,
+    `function __dlOwnStringKeys(record: Record<string, unknown>): string[] {`,
+    `  return Object.keys(record);`,
+    `}`,
+    ``,
+    `function __dlReadOwnField(record: Record<string, unknown>, key: string): unknown {`,
+    `  return record[key];`,
+    `}`,
+    ``,
+    `function __dlGetNormalizedKey(record: Record<string, unknown>, part: string): string | null {`,
+    `  const normalized = __dlNormalizeHeader(part);`,
+    `  for (const key of __dlOwnStringKeys(record)) {`,
+    `    if (__dlNormalizeHeader(key) === normalized) return key;`,
+    `  }`,
+    `  return null;`,
+    `}`,
+    ``,
+    `function __dlGetRecordField(record: Record<string, unknown>, part: string): { found: boolean; value: unknown } {`,
+    `  if (part in record) return { found: true, value: record[part] };`,
+    `  const normalizedKey = __dlGetNormalizedKey(record, part);`,
+    `  if (normalizedKey) return { found: true, value: __dlReadOwnField(record, normalizedKey) };`,
+    `  const projectedValues = record.__deeplineCsvProjectedValues;`,
+    `  if (projectedValues && typeof projectedValues === 'object' && !Array.isArray(projectedValues)) {`,
+    `    const projectedRecord = projectedValues as Record<string, unknown>;`,
+    `    if (part in projectedRecord) return { found: true, value: projectedRecord[part] };`,
+    `    const projectedKey = __dlGetNormalizedKey(projectedRecord, part);`,
+    `    if (projectedKey) return { found: true, value: __dlReadOwnField(projectedRecord, projectedKey) };`,
+    `  }`,
+    `  const data = record.data;`,
+    `  if (data && typeof data === 'object' && !Array.isArray(data)) {`,
+    `    const dataRecord = data as Record<string, unknown>;`,
+    `    if (part in dataRecord) return { found: true, value: dataRecord[part] };`,
+    `    const dataKey = __dlGetNormalizedKey(dataRecord, part);`,
+    `    if (dataKey) return { found: true, value: __dlReadOwnField(dataRecord, dataKey) };`,
+    `  }`,
+    `  return { found: false, value: undefined };`,
+    `}`,
+    ``,
     `function __dlGetByPath(root: unknown, path: string): unknown {`,
     `  let cursor = root;`,
     `  for (const part of __dlPathParts(path)) {`,
     `    if (!cursor || typeof cursor !== 'object') return undefined;`,
     `    const record = cursor as Record<string, unknown>;`,
-    `    if (part in record) {`,
-    `      cursor = record[part];`,
-    `      continue;`,
-    `    }`,
-    `    const data = record.data;`,
-    `    cursor = data && typeof data === 'object' ? (data as Record<string, unknown>)[part] : undefined;`,
+    `    const field = __dlGetRecordField(record, part);`,
+    `    if (!field.found) return undefined;`,
+    `    cursor = field.value;`,
     `  }`,
     `  return cursor;`,
     `}`,
@@ -15871,6 +16069,64 @@ function helperSource() {
     `  return status === 'error' || status === 'failed' || (typeof record.error === 'string' && record.error.trim() !== '') || (typeof resultError === 'string' && resultError.trim() !== '');`,
     `}`,
     ``,
+    `function __dlGeneratedCellError(value: unknown): boolean {`,
+    `  if (typeof value === 'string') {`,
+    `    const lower = value.trim().toLowerCase();`,
+    `    if (!lower) return false;`,
+    `    if (lower.startsWith('error:') || lower.includes(': error:') || lower.includes('"error"')) return true;`,
+    `    try {`,
+    `      return __dlGeneratedCellError(JSON.parse(value));`,
+    `    } catch {`,
+    `      return false;`,
+    `    }`,
+    `  }`,
+    `  if (!__dlRecord(value)) return false;`,
+    `  const status = typeof value.status === 'string' ? value.status.toLowerCase() : '';`,
+    `  if (status === 'error' || status === 'failed') return true;`,
+    `  if (typeof value.error === 'string' && value.error.trim() !== '') return true;`,
+    `  const raw = __dlGetByPath(value, 'toolResponse.raw') ?? __dlGetByPath(value, 'toolOutput.raw');`,
+    `  if (raw !== undefined && raw !== value && __dlGeneratedCellError(raw)) return true;`,
+    `  const result = value.result;`,
+    `  return result !== undefined && result !== value && __dlGeneratedCellError(result);`,
+    `}`,
+    ``,
+    `function __dlStripErroredGeneratedColumns(row: Record<string, unknown>, aliases: string[]): Record<string, unknown> {`,
+    `  let next: Record<string, unknown> | null = null;`,
+    `  for (const alias of aliases) {`,
+    `    for (const key of __dlAliasCandidates(alias)) {`,
+    `      if (key in row && __dlGeneratedCellError(row[key])) {`,
+    `        if (next === null) next = { ...row };`,
+    `        delete next[key];`,
+    `      }`,
+    `    }`,
+    `  }`,
+    `  return next ?? row;`,
+    `}`,
+    ``,
+    `function __dlTemplateContext(row: Record<string, unknown>): Record<string, unknown> {`,
+    `  const context: Record<string, unknown> = {};`,
+    `  const projectedValues = row.__deeplineCsvProjectedValues;`,
+    `  if (__dlRecord(projectedValues)) {`,
+    `    for (const [key, value] of Object.entries(projectedValues)) context[key] = value;`,
+    `  }`,
+    `  for (const [key, value] of Object.entries(row)) {`,
+    `    if (key.startsWith('__deepline')) continue;`,
+    `    context[key] = value;`,
+    `  }`,
+    `  return context;`,
+    `}`,
+    ``,
+    `function __dlPrepareEnrichRow(row: Record<string, unknown>, aliases: string[]): Record<string, unknown> {`,
+    `  const cleaned = __dlStripErroredGeneratedColumns(row, aliases);`,
+    `  const templateContext = __dlTemplateContext(cleaned);`,
+    `  return {`,
+    `    ...templateContext,`,
+    `    ...cleaned,`,
+    `    __deeplineCsvProjectedFields: Object.keys(templateContext),`,
+    `    __deeplineCsvProjectedValues: templateContext,`,
+    `  };`,
+    `}`,
+    ``,
     `function __dlRawToolOutput(result: unknown): unknown {`,
     `  if (!result || typeof result !== 'object') return result;`,
     `  const record = result as Record<string, unknown>;`,
@@ -16281,7 +16537,7 @@ function helperSource() {
     `    tool: input.tool,`,
     `    input: payload,`,
     `    ...(input.description ? { description: input.description } : {}),`,
-    `    ...(input.force ? { staleAfterSeconds: 1 } : {}),`,
+    `    ...(input.force ? { force: true } : {}),`,
     `  });`,
     `  return __dlExtract(input.alias, result, input.row, input.extract, Boolean(input.legacyEnvelope));`,
     `}`
@@ -16908,7 +17164,7 @@ async function resolveWatchedGeneratedPlayStatus(input2) {
   }
   return input2.client.runs.get(runId, { full: true });
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 async function captureStdout(run, options = {}) {
@@ -16956,12 +17212,12 @@ async function writeOutputCsv(outputPath, status, options) {
   if (!rowsInfo) {
     throw new Error("The generated play did not return row-shaped output.");
   }
-  if (!rowsInfo.complete && options?.client) {
+  if (options?.client) {
     rowsInfo = await fetchBackingRowsForCsvExport({
       client: options.client,
       status,
       rowsInfo
-    }) ?? rowsInfo;
+    }).catch(() => null) ?? rowsInfo;
   }
   assertCompleteRowsForCsvExport(rowsInfo, status, outputPath);
   const merged = mergeRowsForCsvExport(rowsInfo.rows, options);
@@ -16977,10 +17233,14 @@ async function writeOutputCsv(outputPath, status, options) {
     csvStringFromRows(merged.rows, columns),
     "utf8"
   );
+  const sourceCsvRows = options?.sourceCsvPath ? readCsvRows(options.sourceCsvPath).length : null;
   return {
+    sourceCsvRows,
+    selectedRows: rowsInfo.totalRows,
+    enrichedRows: rowsInfo.rows.length,
     rows: merged.rows.length,
     path: (0, import_node_path13.resolve)(outputPath),
-    enrichedRows: rowsInfo.rows
+    enrichedDataRows: rowsInfo.rows
   };
 }
 function recordField(value, key) {
@@ -17061,12 +17321,12 @@ function collectHardFailureAliases(config) {
 }
 function cellFailureError(value) {
   const parsed = parseMaybeJsonObject(value);
-  if (!isRecord6(parsed)) {
+  if (!isRecord7(parsed)) {
     return null;
   }
   const status = typeof parsed.status === "string" ? parsed.status.trim().toLowerCase() : "";
   const directError = typeof parsed.error === "string" ? parsed.error.trim() : typeof parsed.last_error === "string" ? parsed.last_error.trim() : "";
-  const result = isRecord6(parsed.result) ? parsed.result : null;
+  const result = isRecord7(parsed.result) ? parsed.result : null;
   const resultError = typeof result?.error === "string" ? result.error.trim() : typeof result?.message === "string" ? result.message.trim() : "";
   if (!directError && !resultError && status !== "error" && status !== "failed") {
     return null;
@@ -17132,6 +17392,136 @@ function collectEnrichFailureJobs(input2) {
   });
   return jobs;
 }
+function parseExecutionCount(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Math.max(0, Math.trunc(value));
+  }
+  if (typeof value !== "string") {
+    return null;
+  }
+  const match = value.trim().match(/^(\d+)\s*\//);
+  return match?.[1] ? Number.parseInt(match[1], 10) : null;
+}
+function executionSummaryText(count, total) {
+  const percent = total > 0 ? Math.round(count / total * 100) : 0;
+  return `${count}/${total} (${percent}%)`;
+}
+function collectColumnStats(status) {
+  const summaries = [];
+  const visit = (value) => {
+    if (Array.isArray(value)) {
+      value.forEach(visit);
+      return;
+    }
+    if (!isRecord7(value)) {
+      return;
+    }
+    if (isRecord7(value.columnStats)) {
+      summaries.push(value.columnStats);
+    }
+    Object.values(value).forEach(visit);
+  };
+  visit(status);
+  return summaries;
+}
+function firstAliasExecutionCounts(input2) {
+  const aliases = collectConfigScalarAliasOrder(input2.config);
+  const summaries = collectColumnStats(input2.status);
+  for (const alias of aliases) {
+    const stat4 = summaries.map((summary) => summary[alias]).find(isRecord7);
+    if (!stat4) continue;
+    if (input2.forceAliases.has(normalizeAlias2(alias))) {
+      return { executed: input2.selectedRows, reused: 0 };
+    }
+    const execution = isRecord7(stat4.execution) ? stat4.execution : null;
+    if (!execution) continue;
+    return {
+      executed: parseExecutionCount(execution["completed:executed"]),
+      reused: parseExecutionCount(execution["completed:reused"])
+    };
+  }
+  return { executed: null, reused: null };
+}
+function rewriteEnrichJsonStatus(input2) {
+  const selectedRows = input2.output?.selectedRows ?? extractCanonicalRowsInfo(input2.status)?.totalRows ?? 0;
+  const failedRows = new Set(
+    input2.failureReport?.jobs.map((job) => job.row_id) ?? []
+  ).size;
+  const executionCounts = firstAliasExecutionCounts({
+    status: input2.status,
+    config: input2.config,
+    forceAliases: input2.forceAliases,
+    selectedRows
+  });
+  const forcedAliases = new Set(
+    collectConfigScalarAliasOrder(input2.config).filter((alias) => input2.forceAliases.has(normalizeAlias2(alias))).map((alias) => alias)
+  );
+  const rewrite = (value) => {
+    if (Array.isArray(value)) {
+      return value.map(rewrite);
+    }
+    if (!isRecord7(value)) {
+      return value;
+    }
+    const next = {};
+    for (const [key, entry] of Object.entries(value)) {
+      next[key] = rewrite(entry);
+    }
+    if (isRecord7(next.progress)) {
+      next.progress = {
+        ...next.progress,
+        ...selectedRows > 0 ? { total: selectedRows } : {},
+        ...executionCounts.executed !== null ? { executed: executionCounts.executed } : {},
+        ...executionCounts.reused !== null ? { reused: executionCounts.reused } : {},
+        ...failedRows > 0 ? { failed: failedRows, pending: 0 } : {}
+      };
+    }
+    if (isRecord7(next.summary)) {
+      const rowCounts = isRecord7(next.summary.rowCounts) ? next.summary.rowCounts : null;
+      if (failedRows > 0) {
+        next.summary = {
+          ...next.summary,
+          rowCounts: {
+            ...rowCounts ?? {},
+            persisted: selectedRows,
+            succeeded: Math.max(0, selectedRows - failedRows),
+            failed: failedRows
+          }
+        };
+      }
+    }
+    if (isRecord7(next.columnStats) && selectedRows > 0) {
+      const columnStats = { ...next.columnStats };
+      for (const alias of forcedAliases) {
+        const stat4 = isRecord7(columnStats[alias]) ? columnStats[alias] : null;
+        const execution = isRecord7(stat4?.execution) ? stat4.execution : null;
+        if (!stat4 || !execution) continue;
+        columnStats[alias] = {
+          ...stat4,
+          execution: {
+            ...execution,
+            "completed:executed": executionSummaryText(
+              selectedRows,
+              selectedRows
+            ),
+            "completed:reused": executionSummaryText(0, selectedRows)
+          }
+        };
+      }
+      next.columnStats = columnStats;
+    }
+    return next;
+  };
+  const rewritten = rewrite(input2.status);
+  if (failedRows === 0 || !isRecord7(rewritten)) {
+    return rewritten;
+  }
+  return {
+    ...rewritten,
+    ...rewritten.status === "completed" ? { status: "failed" } : {},
+    ...isRecord7(rewritten.run) && rewritten.run.status === "completed" ? { run: { ...rewritten.run, status: "failed" } } : {}
+  };
+}
 function summarizeFailedJobError(value) {
   const text = String(value ?? "").trim();
   return text.length > 500 ? `${text.slice(0, 497)}...` : text;
@@ -17400,11 +17790,11 @@ function normalizeEnrichRowsForCsvExport(rows) {
 }
 function legacyMetadataFromRow(row) {
   const direct = parseLegacyMetadataCell(row._metadata);
-  if (direct && isRecord6(direct.columns)) {
+  if (direct && isRecord7(direct.columns)) {
     return direct;
   }
   const relocated = parseLegacyMetadataCell(row.metadata);
-  if (relocated && isRecord6(relocated.columns)) {
+  if (relocated && isRecord7(relocated.columns)) {
     return relocated;
   }
   const flattenedColumns = parseLegacyMetadataCell(row["metadata.columns"]);
@@ -17421,7 +17811,7 @@ function legacyMetadataFromRow(row) {
 }
 function parseLegacyMetadataCell(value) {
   const parsed = parseMaybeJsonObject(value);
-  if (isRecord6(parsed)) {
+  if (isRecord7(parsed)) {
     return parsed;
   }
   if (typeof value !== "string") {
@@ -17438,12 +17828,12 @@ function parseLegacyMetadataCell(value) {
   for (const candidate of candidates) {
     try {
       const decoded = JSON.parse(candidate);
-      if (isRecord6(decoded)) {
+      if (isRecord7(decoded)) {
         return decoded;
       }
       if (typeof decoded === "string") {
         const nested = JSON.parse(decoded);
-        if (isRecord6(nested)) {
+        if (isRecord7(nested)) {
           return nested;
         }
       }
@@ -17453,8 +17843,8 @@ function parseLegacyMetadataCell(value) {
   return null;
 }
 function mergeLegacyMetadataRecords(base, enriched) {
-  const baseColumns = isRecord6(base.columns) ? base.columns : null;
-  const enrichedColumns = isRecord6(enriched.columns) ? enriched.columns : null;
+  const baseColumns = isRecord7(base.columns) ? base.columns : null;
+  const enrichedColumns = isRecord7(enriched.columns) ? enriched.columns : null;
   const merged = {
     ...base,
     ...enriched
@@ -17656,7 +18046,7 @@ function registerEnrichCommand(program) {
         sourceCsvPath,
         rows
       }) : null;
-      const rowsForFailureReport = exportResult?.enrichedRows ?? extractCanonicalRowsInfo(status)?.rows ?? [];
+      const rowsForFailureReport = exportResult?.enrichedDataRows ?? extractCanonicalRowsInfo(status)?.rows ?? [];
       if (options.json) {
         const failureReport2 = await maybeEmitEnrichFailureReport({
           config,
@@ -17665,10 +18055,22 @@ function registerEnrichCommand(program) {
           client: client2,
           outputPath: exportResult?.path ?? outputPath ?? null
         });
+        const run = rewriteEnrichJsonStatus({
+          status,
+          config,
+          forceAliases,
+          output: exportResult,
+          failureReport: failureReport2
+        });
         printJson({
           ok: !failureReport2,
-          run: status,
-          output: exportResult ? { rows: exportResult.rows, path: exportResult.path } : null,
+          run,
+          output: exportResult ? {
+            sourceCsvRows: exportResult.sourceCsvRows,
+            selectedRows: exportResult.selectedRows,
+            enrichedRows: exportResult.enrichedRows,
+            path: exportResult.path
+          } : null,
           ...failureReport2 ? {
             failure_report: {
               path: failureReport2.path,
@@ -17688,7 +18090,7 @@ function registerEnrichCommand(program) {
         );
         const waterfallSummaryLines = buildEnrichWaterfallSummaryLines(
           config,
-          exportResult.enrichedRows
+          exportResult.enrichedDataRows
         );
         if (waterfallSummaryLines.length > 0) {
           process.stdout.write(`${waterfallSummaryLines.join("\n")}
@@ -17755,6 +18157,129 @@ Examples:
   ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option("--json", "Emit JSON output").action(handleFeedback);
 }
 
+// src/cli/commands/legacy-noops.ts
+var SESSION_SUBCOMMANDS = [
+  "start",
+  "status",
+  "output",
+  "alert",
+  "usage",
+  "limit",
+  "render",
+  "send"
+];
+var BACKEND_SUBCOMMANDS = [
+  "start",
+  "stop",
+  "status",
+  "refresh-runtime",
+  "sync-runtime"
+];
+function legacyNoopEnvelope(input2) {
+  const command = [
+    "deepline",
+    input2.family,
+    input2.subcommand
+  ].filter(Boolean).join(" ");
+  const subject = input2.family === "session" ? "Legacy Session UI/playground command" : "Legacy local playground backend command";
+  const note = input2.family === "session" ? "The SDK CLI does not manage the legacy Python Session UI. This command is accepted for backwards compatibility and intentionally does nothing." : "The SDK CLI does not start or stop the legacy Python local playground backend. This command is accepted for backwards compatibility and intentionally does nothing.";
+  return {
+    ok: true,
+    noop: true,
+    command,
+    compatibility: {
+      family: "legacy_python_cli",
+      sdk_behavior: "noop"
+    },
+    render: {
+      sections: [
+        {
+          title: subject,
+          lines: [note]
+        }
+      ]
+    }
+  };
+}
+function printLegacyNoop(input2) {
+  printCommandEnvelope(legacyNoopEnvelope(input2), { json: input2.options.json });
+}
+function legacySubcommandFromArgv(family) {
+  const args = process.argv.slice(2);
+  const familyIndex = args.indexOf(family);
+  const nextToken = familyIndex >= 0 ? args[familyIndex + 1] : void 0;
+  return nextToken && !nextToken.startsWith("-") ? nextToken : void 0;
+}
+function addLegacyNoopSubcommand(parent, family, subcommand, description) {
+  parent.command(subcommand).description(description).allowUnknownOption(true).allowExcessArguments(true).option("--json", "Emit JSON output").argument("[args...]").action((_args, options) => {
+    printLegacyNoop({ family, subcommand, options });
+  });
+}
+function registerLegacyNoopCommands(program) {
+  const session = program.command("session").description(
+    "Compatibility no-ops for legacy Python Session UI commands."
+  ).allowUnknownOption(true).allowExcessArguments(true).option("--json", "Emit JSON output").argument("[args...]").addHelpText(
+    "after",
+    `
+Notes:
+  The SDK CLI accepts singular session commands from older agent skills so they
+  do not fail, but it does not manage the legacy Python Session UI.
+  Use "deepline sessions send" or "deepline sessions render" for real SDK
+  transcript workflows.
+
+Examples:
+  deepline session start --steps '["Inspect CSV","Run pilot"]'
+  deepline session status --message "Running pilot"
+  deepline session output --csv ./results.csv --label "Results"
+	`
+  ).action((args, options) => {
+    void args;
+    printLegacyNoop({
+      family: "session",
+      subcommand: legacySubcommandFromArgv("session"),
+      options
+    });
+  });
+  for (const subcommand of SESSION_SUBCOMMANDS) {
+    addLegacyNoopSubcommand(
+      session,
+      "session",
+      subcommand,
+      `Accept legacy "deepline session ${subcommand}" as an SDK no-op.`
+    );
+  }
+  const backend = program.command("backend").description(
+    "Compatibility no-ops for legacy Python local backend commands."
+  ).allowUnknownOption(true).allowExcessArguments(true).option("--json", "Emit JSON output").argument("[args...]").addHelpText(
+    "after",
+    `
+Notes:
+  The SDK CLI uses the configured Deepline host and V2 play runtime. It does not
+  start, stop, or refresh the legacy Python local playground backend.
+
+Examples:
+  deepline backend start
+  deepline backend stop --just-backend
+  deepline backend status --json
+	`
+  ).action((args, options) => {
+    void args;
+    printLegacyNoop({
+      family: "backend",
+      subcommand: legacySubcommandFromArgv("backend"),
+      options
+    });
+  });
+  for (const subcommand of BACKEND_SUBCOMMANDS) {
+    addLegacyNoopSubcommand(
+      backend,
+      "backend",
+      subcommand,
+      `Accept legacy "deepline backend ${subcommand}" as an SDK no-op.`
+    );
+  }
+}
+
 // src/cli/commands/org.ts
 async function fetchOrganizations(http, apiKey) {
   return http.post("/api/v2/auth/cli/organizations", { api_key: apiKey });
@@ -19657,11 +20182,13 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
     "deeplineUsdPerPricingUnit",
     "deepline_usd_per_pricing_unit"
   );
-  const starterScript = seedToolListScript({
-    toolId,
-    payload: samplePayloadForInputFields(inputFields),
-    rows: []
-  });
+  const starterScript = extractedLists.length > 0 ? starterScriptJson(
+    seedToolListScript({
+      toolId,
+      payload: samplePayloadForInputFields(inputFields),
+      rows: []
+    })
+  ) : null;
   return {
     schemaVersion: 1,
     toolId,
@@ -19687,20 +20214,12 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
       extractedValues
     },
     executeCommand: `deepline tools execute ${toolId} --input '{...}' --json`,
-    starterScript: {
-      path: starterScript.path,
-      sourceCode: starterScript.sourceCode,
-      projectDir: starterScript.projectDir,
-      copyToProject: {
-        macosLinux: starterScript.macCopyCommand,
-        windowsPowerShell: starterScript.windowsCopyCommand
-      }
-    }
+    ...starterScript ? { starterScript } : {}
   };
 }
 function extractionContractEntries(entries) {
   return entries.flatMap((entry) => {
-    if (!isRecord7(entry)) return [];
+    if (!isRecord8(entry)) return [];
     const name = stringField(entry, "name");
     const expression = stringField(entry, "expression");
     return name && expression ? [{ name, expression }] : [];
@@ -19708,8 +20227,8 @@ function extractionContractEntries(entries) {
 }
 function printCompactToolContract(tool, requestedToolId) {
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const cost = isRecord7(contract.cost) ? contract.cost : {};
-  const getters = isRecord7(contract.getters) ? contract.getters : {};
+  const cost = isRecord8(contract.cost) ? contract.cost : {};
+  const getters = isRecord8(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
@@ -19726,7 +20245,7 @@ function printCompactToolContract(tool, requestedToolId) {
     console.log("");
     console.log("Inputs:");
     for (const field of inputFields) {
-      if (!isRecord7(field)) continue;
+      if (!isRecord8(field)) continue;
       const name = stringField(field, "name");
       if (!name) continue;
       const required = field.required ? "*" : "";
@@ -19739,7 +20258,7 @@ function printCompactToolContract(tool, requestedToolId) {
   }
   console.log("");
   printToolExamplesOnly(tool, requestedToolId, { includeSamples: false });
-  const starterScript = isRecord7(contract.starterScript) ? contract.starterScript : {};
+  const starterScript = isRecord8(contract.starterScript) ? contract.starterScript : {};
   const starterPath = stringField(starterScript, "path");
   if (starterPath) {
     console.log("");
@@ -19753,14 +20272,14 @@ function printCompactToolContract(tool, requestedToolId) {
     console.log("Getters:");
     if (listGetters.length) console.log("Lists:");
     for (const entry of listGetters) {
-      if (isRecord7(entry))
+      if (isRecord8(entry))
         console.log(
           `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
     }
     if (valueGetters.length) console.log("Values:");
     for (const entry of valueGetters) {
-      if (isRecord7(entry))
+      if (isRecord8(entry))
         console.log(
           `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -19773,7 +20292,7 @@ function printCompactToolContract(tool, requestedToolId) {
 }
 function printToolPricingOnly(tool, requestedToolId, options = {}) {
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const cost = isRecord7(contract.cost) ? contract.cost : {};
+  const cost = isRecord8(contract.cost) ? contract.cost : {};
   const pricingModel = stringField(cost, "pricingModel") || "unknown";
   const billingMode = stringField(cost, "billingMode") || "unknown";
   const unit = pricingModel === "per_page" ? "page" : pricingModel === "per_result" ? "result" : pricingModel === "fixed" ? "call" : pricingModel.replace(/^per_/, "") || "unit";
@@ -19793,7 +20312,7 @@ function printToolSchemaOnly(tool, requestedToolId) {
   }
   console.log("Inputs:");
   for (const field of inputFields) {
-    if (!isRecord7(field)) continue;
+    if (!isRecord8(field)) continue;
     const name = stringField(field, "name");
     if (!name) continue;
     const required = field.required ? "*" : "";
@@ -19819,10 +20338,10 @@ function printToolExamplesOnly(tool, requestedToolId, options = {}) {
     `  input: ${JSON.stringify(sampleInput || {}, null, 2).replace(/\n/g, "\n  ")},`
   );
   console.log("});");
-  const getters = isRecord7(contract.getters) ? contract.getters : {};
+  const getters = isRecord8(contract.getters) ? contract.getters : {};
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
-  const firstGetter = [...valueGetters, ...listGetters].find(isRecord7);
+  const firstGetter = [...valueGetters, ...listGetters].find(isRecord8);
   if (firstGetter) {
     const name = stringField(firstGetter, "name") || "value";
     const expression = stringField(firstGetter, "expression");
@@ -19839,7 +20358,7 @@ function printToolExamplesOnly(tool, requestedToolId, options = {}) {
 }
 function printToolGettersOnly(tool, requestedToolId) {
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const getters = isRecord7(contract.getters) ? contract.getters : {};
+  const getters = isRecord8(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   console.log(`Getters: ${contract.toolId}`);
@@ -19852,7 +20371,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   if (listGetters.length) {
     console.log("Lists:");
     for (const entry of listGetters) {
-      if (isRecord7(entry))
+      if (isRecord8(entry))
         console.log(
           `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -19861,7 +20380,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   if (valueGetters.length) {
     console.log("Values:");
     for (const entry of valueGetters) {
-      if (isRecord7(entry))
+      if (isRecord8(entry))
         console.log(
           `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -19887,7 +20406,7 @@ function sampleValueForField(field) {
 function samplePayloadForInputFields(fields) {
   return Object.fromEntries(
     fields.slice(0, 4).flatMap((field) => {
-      if (!isRecord7(field)) return [];
+      if (!isRecord8(field)) return [];
       const name = stringField(field, "name");
       if (!name) return [];
       return [[name, sampleValueForField(field)]];
@@ -19912,11 +20431,24 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
   const inputFields = toolInputFieldsForDisplay(
     recordField2(tool, "inputSchema", "input_schema")
   );
-  const starterScript = seedToolListScript({
-    toolId,
-    payload: samplePayloadForInputFields(inputFields),
-    rows: []
-  });
+  const usageGuidance = usageGuidanceWithAccessDefaults(
+    recordField2(tool, "usageGuidance", "usage_guidance")
+  );
+  const toolExecutionResult = recordField2(
+    usageGuidance,
+    "toolExecutionResult",
+    "tool_execution_result"
+  );
+  const extractedLists = extractionContractEntries(
+    arrayField(toolExecutionResult, "extractedLists", "extracted_lists")
+  );
+  const starterScript = extractedLists.length > 0 ? starterScriptJson(
+    seedToolListScript({
+      toolId,
+      payload: samplePayloadForInputFields(inputFields),
+      rows: []
+    })
+  ) : null;
   const {
     cost: _cost,
     deeplineCreditsPerPricingUnit: _deeplineCreditsPerPricingUnit,
@@ -19936,9 +20468,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
     toolId,
     provider: tool.provider,
     displayName: tool.displayName,
-    usageGuidance: usageGuidanceWithAccessDefaults(
-      recordField2(tool, "usageGuidance", "usage_guidance")
-    ),
+    usageGuidance,
     runtimeOutputHelp: {
       contract: "tools describe shows declared schema and Deepline getters; it is not an observed provider response.",
       getterScope: "extractedValues/extractedLists .get() only works for declared Deepline getters listed in usageGuidance.toolExecutionResult.",
@@ -19949,15 +20479,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
       forPlayGetterBugs: "Run a tiny play, inspect `deepline runs get <run-id> --full --json`, and export returned dataset handles with `deepline runs export`. Backing tables exist only for ctx.map(...).run(...) stages that actually executed.",
       executeOutputFields: "tools execute JSON may include output_preview for this direct probe only; play debugging uses run output and returned dataset handles."
     },
-    starterScript: {
-      path: starterScript.path,
-      sourceCode: starterScript.sourceCode,
-      projectDir: starterScript.projectDir,
-      copyToProject: {
-        macosLinux: starterScript.macCopyCommand,
-        windowsPowerShell: starterScript.windowsCopyCommand
-      }
-    }
+    ...starterScript ? { starterScript } : {}
   };
 }
 function usageGuidanceWithAccessDefaults(usageGuidance) {
@@ -20001,12 +20523,12 @@ function formatListedToolCost(tool) {
 }
 function toolInputFieldsForDisplay(inputSchema) {
   if (Array.isArray(inputSchema.fields))
-    return inputSchema.fields.filter(isRecord7);
-  const jsonSchema = isRecord7(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
-  const properties = isRecord7(jsonSchema.properties) ? jsonSchema.properties : {};
+    return inputSchema.fields.filter(isRecord8);
+  const jsonSchema = isRecord8(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+  const properties = isRecord8(jsonSchema.properties) ? jsonSchema.properties : {};
   const required = Array.isArray(jsonSchema.required) ? new Set(jsonSchema.required.map(String)) : /* @__PURE__ */ new Set();
   return Object.entries(properties).map(([name, value]) => {
-    const property = isRecord7(value) ? value : {};
+    const property = isRecord8(value) ? value : {};
     return {
       name,
       type: typeof property.type === "string" ? property.type : "unknown",
@@ -20035,15 +20557,15 @@ function printJsonPreview(label, payload) {
 }
 function samplePayload(samples, key) {
   const entry = samples[key];
-  if (!isRecord7(entry)) return void 0;
+  if (!isRecord8(entry)) return void 0;
   return Object.prototype.hasOwnProperty.call(entry, "payload") ? entry.payload : entry;
 }
 function commandEnvelopeFromRawResponse(rawResponse) {
-  return isRecord7(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
+  return isRecord8(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
 }
 function listExtractorPathsFromUsageGuidance(tool) {
   const toolExecutionResult = tool.usageGuidance?.toolExecutionResult;
-  const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord7(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
+  const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord8(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
   return extractedLists.flatMap((entry) => {
     const paths = entry.details?.candidatePaths ?? entry.details?.rawToolOutputPaths;
     if (!Array.isArray(paths)) return [];
@@ -20059,7 +20581,7 @@ function formatDecimal(value) {
 function formatUsd(value) {
   return `$${formatDecimal(value)}`;
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringField(source, ...keys) {
@@ -20086,7 +20608,7 @@ function arrayField(source, ...keys) {
 function recordField2(source, ...keys) {
   for (const key of keys) {
     const value = source[key];
-    if (isRecord7(value)) return value;
+    if (isRecord8(value)) return value;
   }
   return {};
 }
@@ -20152,7 +20674,7 @@ function parseJsonObjectArgument(raw, flagName) {
     }
     throw invalidJsonError(flagName, message);
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     throw invalidJsonError(flagName, "expected an object.");
   }
   return parsed;
@@ -20211,6 +20733,17 @@ function shellQuote2(value) {
 function powerShellQuote(value) {
   return `'${value.replace(/'/g, "''")}'`;
 }
+function starterScriptJson(script) {
+  return {
+    path: script.path,
+    sourceCode: script.sourceCode,
+    projectDir: script.projectDir,
+    copyToProject: {
+      macosLinux: script.macCopyCommand,
+      windowsPowerShell: script.windowsCopyCommand
+    }
+  };
+}
 function seedToolListScript(input2) {
   const stem = safeFileStem(input2.toolId);
   const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
@@ -20275,7 +20808,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     kind: summaryEntries.length > 0 ? "object" : "raw",
     summary: input2.summary
   };
-  const envelopeHasCanonicalOutput = isRecord7(envelope.toolResponse) && Object.prototype.hasOwnProperty.call(envelope.toolResponse, "raw");
+  const envelopeHasCanonicalOutput = isRecord8(envelope.toolResponse) && Object.prototype.hasOwnProperty.call(envelope.toolResponse, "raw");
   const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote2(JSON.stringify(input2.params))} --json`;
   const actions = input2.listConversion ? [
     {
@@ -20384,7 +20917,7 @@ async function executeTool(args) {
       {
         ...baseEnvelope,
         local: {
-          ...isRecord7(baseEnvelope.local) ? baseEnvelope.local : {},
+          ...isRecord8(baseEnvelope.local) ? baseEnvelope.local : {},
           payload_file: jsonPath
         }
       },
@@ -21144,10 +21677,6 @@ var command_compatibility_default = {
     label: "a legacy Python CLI workflow command",
     sdk_alternative: "Use `deepline plays ...` in the SDK CLI."
   },
-  backend: {
-    family: "python",
-    label: "a legacy Python CLI playground backend command"
-  },
   events: {
     family: "python",
     label: "a legacy Python CLI event command"
@@ -21376,7 +21905,11 @@ var import_node_os11 = require("os");
 var import_node_path19 = require("path");
 var CHECK_TIMEOUT_MS2 = 3e3;
 var SDK_SKILL_NAME = "deepline-plays";
-var SDK_SKILL_NAMES = [SDK_SKILL_NAME, "deepline-plays-quickstart"];
+var SDK_SKILL_NAMES = [
+  SDK_SKILL_NAME,
+  "deepline-plays-feedback",
+  "deepline-plays-quickstart"
+];
 var attemptedSync = false;
 function shouldSkipSkillsSync() {
   const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
@@ -21598,7 +22131,9 @@ async function syncSdkSkillsIfNeeded(baseUrl) {
   if (!update?.needsUpdate && !hasStaleInstalledSkill || !update?.remoteVersion) {
     return;
   }
-  writeSdkSkillsStatusLine("SDK skills changed; syncing Deepline SDK skills...");
+  writeSdkSkillsStatusLine(
+    "SDK skills changed; syncing Deepline SDK skills..."
+  );
   const installed = await runSkillsInstall(baseUrl);
   if (!installed) return;
   if (installedSdkSkillHasStalePositionalExecuteExamples()) {
@@ -21638,6 +22173,19 @@ function shouldDeferSkillsSyncForCommand() {
   const subcommand = args[1];
   return (command === "play" || command === "plays") && subcommand === "run" && args.includes("--json");
 }
+function isLegacyNoopInvocation() {
+  const command = process.argv.slice(2)[0];
+  return command === "session" || command === "backend";
+}
+function topLevelCommandKnown(program, commandName) {
+  const normalized = commandName.trim();
+  if (!normalized || normalized.startsWith("-")) {
+    return true;
+  }
+  return program.commands.some(
+    (command) => command.name() === normalized || command.aliases().includes(normalized)
+  );
+}
 async function runPlayRunnerHealthCheck() {
   const dir = await (0, import_promises7.mkdtemp)((0, import_node_path20.join)((0, import_node_os12.tmpdir)(), "deepline-health-play-"));
   const file = (0, import_node_path20.join)(dir, "health-check.play.ts");
@@ -21857,7 +22405,7 @@ Exit codes:
 `
   );
   program.hook("preAction", async (_thisCommand, actionCommand) => {
-    if (actionCommand.name() === "version" || actionCommand.name() === "update") {
+    if (actionCommand.name() === "version" || actionCommand.name() === "update" || isLegacyNoopInvocation()) {
       return;
     }
     if (printStartupPhase) {
@@ -21874,9 +22422,7 @@ Exit codes:
     if (compatibility.error) {
       return;
     }
-    const relaunched = await maybeAutoUpdateAndRelaunch(
-      compatibility.response
-    );
+    const relaunched = await maybeAutoUpdateAndRelaunch(compatibility.response);
     if (relaunched) {
       return;
     }
@@ -21904,6 +22450,7 @@ Exit codes:
   registerCsvCommands(program);
   registerDbCommands(program);
   registerFeedbackCommands(program);
+  registerLegacyNoopCommands(program);
   registerUpdateCommand(program);
   registerQuickstartCommands(program);
   program.command("preflight").description("Run compact health, auth, and Deepline billing checks.").option("--json", "Force JSON output.").addHelpText(
@@ -22004,6 +22551,20 @@ Examples:
     process.exitCode = 2;
     return;
   }
+  const requestedTopLevelCommand = process.argv.slice(2)[0] ?? "";
+  if (!topLevelCommandKnown(program, requestedTopLevelCommand)) {
+    console.error(`error: unknown command '${requestedTopLevelCommand}'`);
+    const hint = commandCompatibilityHint(
+      "sdk",
+      requestedTopLevelCommand,
+      autoDetectBaseUrl()
+    );
+    if (hint && !process.argv.includes("--json")) {
+      console.error(hint);
+    }
+    process.exitCode = 2;
+    return;
+  }
   try {
     await program.parseAsync(process.argv);
     recordCliTrace({