deepline 0.1.107 → 0.1.108

package/dist/cli/index.js

@@ -244,16 +244,18 @@ var SDK_RELEASE = {
   // 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.108",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.107",
+    latest: "0.1.108",
     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."
       }
     ],
@@ -857,6 +859,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) } : {}
   };
 }
@@ -15491,7 +15495,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};`,
     `}`
@@ -15523,17 +15527,13 @@ function renderPlayStep(command, options) {
 ${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");
   return [
     `async (row, stepCtx) => {`,
     ...options.precheck ? [`  if (${options.precheck}) return null;`] : [],
     ...runIfLines,
     `  const payload = __dlTemplate(${payload}, row) 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 +15550,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,6 +15609,29 @@ function collectMetadataColumns(commands, waterfallGroupId) {
   }
   return columns;
 }
+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) {
   const columns = collectMetadataColumns(config.commands);
   if (Object.keys(columns).length === 0) {
@@ -15611,8 +15639,8 @@ function renderMetadataColumnStep(config) {
   }
   return [
     `      .withColumn('_metadata',`,
-    `        (row) => __dlMergeMetadata(row._metadata, ${stableJson({ columns })}),`,
-    `        { staleAfterSeconds: 1 }`,
+    `        (row) => __dlMergeMetadata(__dlMetadataFromRow(row), ${stableJson({ columns })}),`,
+    `        { recompute: true },`,
     `      )`
   ].join("\n");
 }
@@ -15639,7 +15667,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,15 +15683,13 @@ 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 }
     )
   ];
 }
@@ -15700,18 +15726,20 @@ 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 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 selectedRows = sourceRows.slice(rowStart, rowEndExclusive, { key: 'deepline_enrich_selected_rows', sourceLabel: 'Selected enrich rows' });`,
+    `  const rows = selectedRows.map((row) => __dlStripErroredGeneratedColumns(row, ${stableJson(generatedAliases)}), { key: 'deepline_enrich_repair_rows', sourceLabel: 'Selected enrich rows' });`,
     `  const enriched = await ctx`,
     `    .dataset(${stringLiteral(mapName)}, rows)`,
     columnStepSource,
@@ -15797,6 +15825,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 : {};`,
@@ -15871,6 +15911,40 @@ 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 __dlRawToolOutput(result: unknown): unknown {`,
     `  if (!result || typeof result !== 'object') return result;`,
     `  const record = result as Record<string, unknown>;`,
@@ -16281,7 +16355,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));`,
     `}`

package/dist/cli/index.mjs

@@ -221,16 +221,18 @@ var SDK_RELEASE = {
   // 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.108",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.107",
+    latest: "0.1.108",
     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."
       }
     ],
@@ -834,6 +836,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) } : {}
   };
 }
@@ -15508,7 +15512,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};`,
     `}`
@@ -15540,17 +15544,13 @@ function renderPlayStep(command, options) {
 ${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");
   return [
     `async (row, stepCtx) => {`,
     ...options.precheck ? [`  if (${options.precheck}) return null;`] : [],
     ...runIfLines,
     `  const payload = __dlTemplate(${payload}, row) as Record<string, unknown>;`,
     `  const result = await stepCtx.runPlay(${callId}, ${playRef}, payload, {`,
-    playOptions,
+    `      description: ${stringLiteral(command.description ?? command.alias)}`,
     `  });`,
     `  return __dlPlayResultValue(${alias}, result);`,
     `}`
@@ -15567,12 +15567,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");
 }
@@ -15621,6 +15626,29 @@ function collectMetadataColumns(commands, waterfallGroupId) {
   }
   return columns;
 }
+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) {
   const columns = collectMetadataColumns(config.commands);
   if (Object.keys(columns).length === 0) {
@@ -15628,8 +15656,8 @@ function renderMetadataColumnStep(config) {
   }
   return [
     `      .withColumn('_metadata',`,
-    `        (row) => __dlMergeMetadata(row._metadata, ${stableJson({ columns })}),`,
-    `        { staleAfterSeconds: 1 }`,
+    `        (row) => __dlMergeMetadata(__dlMetadataFromRow(row), ${stableJson({ columns })}),`,
+    `        { recompute: true },`,
     `      )`
   ].join("\n");
 }
@@ -15656,7 +15684,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);
@@ -15672,15 +15700,13 @@ 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 }
     )
   ];
 }
@@ -15717,18 +15743,20 @@ 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 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 selectedRows = sourceRows.slice(rowStart, rowEndExclusive, { key: 'deepline_enrich_selected_rows', sourceLabel: 'Selected enrich rows' });`,
+    `  const rows = selectedRows.map((row) => __dlStripErroredGeneratedColumns(row, ${stableJson(generatedAliases)}), { key: 'deepline_enrich_repair_rows', sourceLabel: 'Selected enrich rows' });`,
     `  const enriched = await ctx`,
     `    .dataset(${stringLiteral(mapName)}, rows)`,
     columnStepSource,
@@ -15814,6 +15842,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 : {};`,
@@ -15888,6 +15928,40 @@ 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 __dlRawToolOutput(result: unknown): unknown {`,
     `  if (!result || typeof result !== 'object') return result;`,
     `  const record = result as Record<string, unknown>;`,
@@ -16298,7 +16372,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));`,
     `}`

package/dist/index.d.mts

@@ -70,6 +70,8 @@ interface PlayStaticColumnProducer {
     toolId?: string;
     playId?: string;
     dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
     conditional?: boolean;
     sourceRange?: PlayStaticSourceRange;
@@ -80,6 +82,8 @@ interface PlayStaticDatasetColumn {
     id: string;
     source: PlaySheetColumnSource;
     sqlName?: string;
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
     producers: PlayStaticColumnProducer[];
 }
@@ -93,6 +97,8 @@ interface PlayStaticSourceRange {
 type PlayStaticSubstepMetadata = {
     conditional?: boolean;
     dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
@@ -2979,6 +2985,8 @@ type ToolExecutionRequest = {
     input: Record<string, unknown>;
     /** Human-readable description for logs and run inspection. */
     description?: string;
+    /** Recompute this tool call instead of reusing a durable receipt/checkpoint. */
+    force?: boolean;
     /** Numeric TTL in seconds for this tool checkpoint. */
     staleAfterSeconds?: number;
 };
@@ -3031,6 +3039,10 @@ type DatasetColumnDefinition<Row, Value> = {
     run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>;
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /** Recompute this cell on each run instead of reusing its durable value. */
+    readonly recompute?: boolean;
+    /** Recompute this cell when its durable value is an error-shaped object. */
+    readonly recomputeOnError?: boolean;
     /** Fixed or value-dependent freshness policy for this cell. */
     readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -3049,6 +3061,10 @@ type ConditionalStepResolver<Row, Value, Else = null> = {
 type StepOptions<Row, Value = unknown> = {
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /** Recompute this cell on each run instead of reusing its durable value. */
+    readonly recompute?: boolean;
+    /** Recompute this cell when its durable value is an error-shaped object. */
+    readonly recomputeOnError?: boolean;
     /** Fixed or value-dependent freshness policy for this cell. */
     readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -3069,11 +3085,13 @@ type StepProgramResolver<Input, Return> = {
 };
 type PlayStepProgramStep = {
     readonly name: string;
+    readonly recompute?: boolean;
+    readonly recomputeOnError?: boolean;
     readonly staleAfterSeconds?: StaleAfterSeconds;
     readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown>;
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;
-type StepProgramOutput<TProgram> = TProgram extends StepProgram<any, infer Output, any> ? Output : never;
+type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;
 /**
  * Builder returned by `ctx.dataset(...)` for row-level durable columns.
  *
@@ -3315,9 +3333,7 @@ interface DeeplinePlayRuntimeContext {
          *
          * @sdkReference runtime 150 ctx.tools.execute(request)
          */
-        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest & {
-            staleAfterSeconds?: number;
-        }): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
     };
     /**
      * Execute a single tool by stable step key and tool ID.
@@ -3343,7 +3359,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, unknown, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
     /**

package/dist/index.d.ts

@@ -70,6 +70,8 @@ interface PlayStaticColumnProducer {
     toolId?: string;
     playId?: string;
     dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
     conditional?: boolean;
     sourceRange?: PlayStaticSourceRange;
@@ -80,6 +82,8 @@ interface PlayStaticDatasetColumn {
     id: string;
     source: PlaySheetColumnSource;
     sqlName?: string;
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
     producers: PlayStaticColumnProducer[];
 }
@@ -93,6 +97,8 @@ interface PlayStaticSourceRange {
 type PlayStaticSubstepMetadata = {
     conditional?: boolean;
     dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
     staleAfterSeconds?: number;
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
@@ -2979,6 +2985,8 @@ type ToolExecutionRequest = {
     input: Record<string, unknown>;
     /** Human-readable description for logs and run inspection. */
     description?: string;
+    /** Recompute this tool call instead of reusing a durable receipt/checkpoint. */
+    force?: boolean;
     /** Numeric TTL in seconds for this tool checkpoint. */
     staleAfterSeconds?: number;
 };
@@ -3031,6 +3039,10 @@ type DatasetColumnDefinition<Row, Value> = {
     run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>;
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /** Recompute this cell on each run instead of reusing its durable value. */
+    readonly recompute?: boolean;
+    /** Recompute this cell when its durable value is an error-shaped object. */
+    readonly recomputeOnError?: boolean;
     /** Fixed or value-dependent freshness policy for this cell. */
     readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -3049,6 +3061,10 @@ type ConditionalStepResolver<Row, Value, Else = null> = {
 type StepOptions<Row, Value = unknown> = {
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /** Recompute this cell on each run instead of reusing its durable value. */
+    readonly recompute?: boolean;
+    /** Recompute this cell when its durable value is an error-shaped object. */
+    readonly recomputeOnError?: boolean;
     /** Fixed or value-dependent freshness policy for this cell. */
     readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -3069,11 +3085,13 @@ type StepProgramResolver<Input, Return> = {
 };
 type PlayStepProgramStep = {
     readonly name: string;
+    readonly recompute?: boolean;
+    readonly recomputeOnError?: boolean;
     readonly staleAfterSeconds?: StaleAfterSeconds;
     readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown>;
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;
-type StepProgramOutput<TProgram> = TProgram extends StepProgram<any, infer Output, any> ? Output : never;
+type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;
 /**
  * Builder returned by `ctx.dataset(...)` for row-level durable columns.
  *
@@ -3315,9 +3333,7 @@ interface DeeplinePlayRuntimeContext {
          *
          * @sdkReference runtime 150 ctx.tools.execute(request)
          */
-        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest & {
-            staleAfterSeconds?: number;
-        }): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
     };
     /**
      * Execute a single tool by stable step key and tool ID.
@@ -3343,7 +3359,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 180 ctx.runSteps(program, input, options)
      */
-    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
+    runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, unknown, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
     /**

package/dist/index.js

@@ -272,16 +272,18 @@ var SDK_RELEASE = {
   // 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.108",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.107",
+    latest: "0.1.108",
     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."
       }
     ],
@@ -885,6 +887,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) } : {}
   };
 }
@@ -4075,7 +4079,9 @@ var DeeplineStepProgram = class _DeeplineStepProgram {
           resolver: stepResolver,
           ...options?.staleAfterSeconds !== void 0 ? {
             staleAfterSeconds: options.staleAfterSeconds
-          } : {}
+          } : {},
+          ...options?.recompute === true ? { recompute: true } : {},
+          ...options?.recomputeOnError === true ? { recomputeOnError: true } : {}
         }
       ],
       this.returnResolver

package/dist/index.mjs

@@ -194,16 +194,18 @@ var SDK_RELEASE = {
   // 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.108",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.107",
+    latest: "0.1.108",
     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."
       }
     ],
@@ -807,6 +809,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) } : {}
   };
 }
@@ -3997,7 +4001,9 @@ var DeeplineStepProgram = class _DeeplineStepProgram {
           resolver: stepResolver,
           ...options?.staleAfterSeconds !== void 0 ? {
             staleAfterSeconds: options.staleAfterSeconds
-          } : {}
+          } : {},
+          ...options?.recompute === true ? { recompute: true } : {},
+          ...options?.recomputeOnError === true ? { recomputeOnError: true } : {}
         }
       ],
       this.returnResolver

package/dist/repo/apps/play-runner-workers/src/entry.ts

@@ -1959,6 +1959,8 @@ type WorkerConditionalStepResolver = {
 
 type WorkerStepProgramStep = {
   name: string;
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: AuthoredStaleAfterSeconds;
   resolver:
     | WorkerStepResolver
@@ -1993,6 +1995,49 @@ type WorkerMapOptions = {
   onRowError?: 'isolate' | 'fail';
 };
 
+function authoredCellPolicyForWorkerStep(
+  step: WorkerStepProgramStep,
+): {
+  recompute?: true;
+  recomputeOnError?: true;
+  staleAfterSeconds?: AuthoredStaleAfterSeconds;
+} | null {
+  const policy = {
+    ...(step.recompute === true ? { recompute: true as const } : {}),
+    ...(step.recomputeOnError === true
+      ? { recomputeOnError: true as const }
+      : {}),
+    ...(step.staleAfterSeconds !== undefined
+      ? { staleAfterSeconds: step.staleAfterSeconds }
+      : {}),
+  };
+  return Object.keys(policy).length > 0 ? policy : null;
+}
+
+function workerCellPoliciesFromSteps(
+  steps: readonly WorkerStepProgramStep[],
+): CellStalenessPolicyByField {
+  return Object.fromEntries(
+    steps.flatMap((step) => {
+      const policy = authoredCellPolicyForWorkerStep(step);
+      return policy
+        ? [[step.name, normalizeCellStalenessPolicy(policy)]]
+        : [];
+    }),
+  ) as CellStalenessPolicyByField;
+}
+
+function authoredWorkerCellPoliciesFromSteps(
+  steps: readonly WorkerStepProgramStep[],
+): AuthoredCellStalenessPolicyByField {
+  return Object.fromEntries(
+    steps.flatMap((step) => {
+      const policy = authoredCellPolicyForWorkerStep(step);
+      return policy ? [[step.name, policy]] : [];
+    }),
+  ) as AuthoredCellStalenessPolicyByField;
+}
+
 /**
  * Per-cell terminal state recorded by map row execution and merged into the
  * Runtime Sheet row's `_cell_meta`. 'failed' carries the cell's error message;
@@ -2983,8 +3028,8 @@ function augmentSheetContractWithDatasetFields(input: {
     const field = typeof column.field === 'string' ? column.field : column.id;
     if (
       column.source === 'input' &&
-      field === input.contract.tableNamespace &&
-      !candidateFields.has(field)
+      ((field === input.contract.tableNamespace && !candidateFields.has(field)) ||
+        outputFields.has(field))
     ) {
       continue;
     }
@@ -4696,27 +4741,10 @@ function createMinimalWorkerCtx(
           const fields = Object.fromEntries(
             program.steps.map((step) => [step.name, step.resolver]),
           );
-          const cellPolicies = Object.fromEntries(
-            program.steps.flatMap((step) =>
-              step.staleAfterSeconds === undefined
-                ? []
-                : [
-                    [
-                      step.name,
-                      normalizeCellStalenessPolicy({
-                        staleAfterSeconds: step.staleAfterSeconds,
-                      }),
-                    ],
-                  ],
-            ),
-          ) as CellStalenessPolicyByField;
-          const authoredCellPolicies = Object.fromEntries(
-            program.steps.flatMap((step) =>
-              step.staleAfterSeconds === undefined
-                ? []
-                : [[step.name, { staleAfterSeconds: step.staleAfterSeconds }]],
-            ),
-          ) as AuthoredCellStalenessPolicyByField;
+          const cellPolicies = workerCellPoliciesFromSteps(program.steps);
+          const authoredCellPolicies = authoredWorkerCellPoliciesFromSteps(
+            program.steps,
+          );
           return runMap(
             this.name,
             this.rows,
@@ -4944,27 +4972,10 @@ function createMinimalWorkerCtx(
         const fields = Object.fromEntries(
           fieldsDef.steps.map((step) => [step.name, step.resolver]),
         );
-        const cellPolicies = Object.fromEntries(
-          fieldsDef.steps.flatMap((step) =>
-            step.staleAfterSeconds === undefined
-              ? []
-              : [
-                  [
-                    step.name,
-                    normalizeCellStalenessPolicy({
-                      staleAfterSeconds: step.staleAfterSeconds,
-                    }),
-                  ],
-                ],
-          ),
-        ) as CellStalenessPolicyByField;
-        const authoredCellPolicies = Object.fromEntries(
-          fieldsDef.steps.flatMap((step) =>
-            step.staleAfterSeconds === undefined
-              ? []
-              : [[step.name, { staleAfterSeconds: step.staleAfterSeconds }]],
-          ),
-        ) as AuthoredCellStalenessPolicyByField;
+        const cellPolicies = workerCellPoliciesFromSteps(fieldsDef.steps);
+        const authoredCellPolicies = authoredWorkerCellPoliciesFromSteps(
+          fieldsDef.steps,
+        );
         return runMap(
           name,
           rows,

package/dist/repo/sdk/src/play.ts

@@ -231,6 +231,8 @@ export type ToolExecutionRequest = {
   input: Record<string, unknown>;
   /** Human-readable description for logs and run inspection. */
   description?: string;
+  /** Recompute this tool call instead of reusing a durable receipt/checkpoint. */
+  force?: boolean;
   /** Numeric TTL in seconds for this tool checkpoint. */
   staleAfterSeconds?: number;
 };
@@ -294,6 +296,10 @@ export type DatasetColumnDefinition<Row, Value> = {
   run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>;
   /** Optional row-level gate. Skipped rows produce `null` for this column. */
   readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+  /** Recompute this cell on each run instead of reusing its durable value. */
+  readonly recompute?: boolean;
+  /** Recompute this cell when its durable value is an error-shaped object. */
+  readonly recomputeOnError?: boolean;
   /** Fixed or value-dependent freshness policy for this cell. */
   readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -316,6 +322,10 @@ export type ConditionalStepResolver<Row, Value, Else = null> = {
 export type StepOptions<Row, Value = unknown> = {
   /** Optional row-level gate. Skipped rows produce `null` for this column. */
   readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+  /** Recompute this cell on each run instead of reusing its durable value. */
+  readonly recompute?: boolean;
+  /** Recompute this cell when its durable value is an error-shaped object. */
+  readonly recomputeOnError?: boolean;
   /** Fixed or value-dependent freshness policy for this cell. */
   readonly staleAfterSeconds?: StaleAfterSeconds<Value>;
 };
@@ -351,6 +361,8 @@ export type StepProgramResolver<Input, Return> = {
 
 export type PlayStepProgramStep = {
   readonly name: string;
+  readonly recompute?: boolean;
+  readonly recomputeOnError?: boolean;
   readonly staleAfterSeconds?: StaleAfterSeconds;
   readonly resolver:
     | StepResolver<Record<string, unknown>, unknown>
@@ -364,7 +376,7 @@ export type ColumnResolver<Row, Value> =
   | StepProgramResolver<Row, Value>;
 
 export type StepProgramOutput<TProgram> =
-  TProgram extends StepProgram<any, infer Output, any> ? Output : never;
+  TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;
 
 /**
  * Builder returned by `ctx.dataset(...)` for row-level durable columns.
@@ -663,7 +675,7 @@ export interface DeeplinePlayRuntimeContext {
      * @sdkReference runtime 150 ctx.tools.execute(request)
      */
     execute<TOutput = LoosePlayObject>(
-      request: ToolExecutionRequest & { staleAfterSeconds?: number },
+      request: ToolExecutionRequest,
     ): Promise<ToolExecuteResult<TOutput>>;
   };
   /**
@@ -694,7 +706,7 @@ export interface DeeplinePlayRuntimeContext {
    * @sdkReference runtime 180 ctx.runSteps(program, input, options)
    */
   runSteps<TInput extends Record<string, unknown>, TOutput>(
-    program: StepProgram<TInput, any, TOutput>,
+    program: StepProgram<TInput, unknown, TOutput>,
     input: TInput,
     options?: { description?: string },
   ): Promise<TOutput>;
@@ -1128,6 +1140,10 @@ class DeeplineStepProgram<Input, Output, ReturnValue> implements StepProgram<
                   options.staleAfterSeconds as PlayStepProgramStep['staleAfterSeconds'],
               }
             : {}),
+          ...(options?.recompute === true ? { recompute: true } : {}),
+          ...(options?.recomputeOnError === true
+            ? { recomputeOnError: true }
+            : {}),
         },
       ],
       this.returnResolver as StepResolver<
@@ -1598,7 +1614,8 @@ function emailStatusExtractorConfig(
     if (paths) config[key] = paths;
   }
   if (isRecord(value.statusMap)) {
-    config.statusMap = value.statusMap as EmailStatusExtractorConfig['statusMap'];
+    config.statusMap =
+      value.statusMap as EmailStatusExtractorConfig['statusMap'];
   }
   if (Array.isArray(value.rules)) {
     config.rules = value.rules as EmailStatusExtractorConfig['rules'];

package/dist/repo/sdk/src/release.ts

@@ -94,16 +94,18 @@ export const SDK_RELEASE = {
   // 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.108',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.107',
+    latest: '0.1.108',
     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.',
       },

package/dist/repo/sdk/src/worker-play-entry.ts

@@ -134,6 +134,10 @@ class WorkerStepProgram<Input, Output, ReturnValue> implements StepProgram<
                   options.staleAfterSeconds as PlayStepProgramStep['staleAfterSeconds'],
               }
             : {}),
+          ...(options?.recompute === true ? { recompute: true } : {}),
+          ...(options?.recomputeOnError === true
+            ? { recomputeOnError: true }
+            : {}),
         },
       ],
       this.returnResolver as StepResolver<

package/dist/repo/shared_libs/play-runtime/cell-staleness.ts

@@ -15,11 +15,15 @@ export type AuthoredStaleAfterSeconds<Value = unknown> =
 
 /** Freshness policy as written by play authors before runtime normalization. */
 export type AuthoredCellStalenessPolicy<Value = unknown> = {
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: AuthoredStaleAfterSeconds<Value>;
 };
 
 /** Runtime-normalized freshness policy stored in execution plans. */
 export type CellStalenessPolicy = {
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: number;
   dynamicStaleAfterSeconds?: boolean;
 };
@@ -53,7 +57,10 @@ export type PreviousCell<Value = unknown> = {
 };
 
 export type CellStalenessDecision =
-  | { action: 'recompute'; reason: 'missing' | 'failed' | 'stale' }
+  | {
+      action: 'recompute';
+      reason: 'missing' | 'failed' | 'forced' | 'stale';
+    }
   | { action: 'reuse'; reason: 'fresh' | 'no_policy' | 'no_expiry' };
 
 export type CellStalenessPolicyByField = Record<string, CellStalenessPolicy>;
@@ -83,15 +90,36 @@ export function validateStaleAfterSeconds(
 export function normalizeCellStalenessPolicy(
   policy: AuthoredCellStalenessPolicy | undefined,
 ): CellStalenessPolicy {
+  if (
+    policy?.recompute !== undefined &&
+    typeof policy.recompute !== 'boolean'
+  ) {
+    throw new Error('recompute must be a boolean.');
+  }
+  if (
+    policy?.recomputeOnError !== undefined &&
+    typeof policy.recomputeOnError !== 'boolean'
+  ) {
+    throw new Error('recomputeOnError must be a boolean.');
+  }
+  const recompute = policy?.recompute === true;
+  const recomputeOnError = policy?.recomputeOnError === true;
+  const flags = {
+    ...(recompute ? { recompute: true } : {}),
+    ...(recomputeOnError ? { recomputeOnError: true } : {}),
+  };
   const staleAfterSeconds = policy?.staleAfterSeconds;
   if (staleAfterSeconds === undefined) {
-    return {};
+    return flags;
   }
   if (typeof staleAfterSeconds === 'function') {
-    return { dynamicStaleAfterSeconds: true };
+    return {
+      ...flags,
+      dynamicStaleAfterSeconds: true,
+    };
   }
   validateStaleAfterSeconds(staleAfterSeconds);
-  return { staleAfterSeconds };
+  return { ...flags, staleAfterSeconds };
 }
 
 export function resolveCompletedCellStalenessMeta<Value>(input: {
@@ -162,6 +190,7 @@ export function previousCellFromValue<Value>(input: {
 
 export function shouldRecomputeCell(input: {
   hasValue: boolean;
+  value?: unknown;
   meta?: CellStalenessMeta | null;
   policy?: CellStalenessPolicy;
   nowMs?: number;
@@ -175,6 +204,17 @@ export function shouldRecomputeCell(input: {
     return { action: 'recompute', reason: 'failed' };
   }
 
+  if (input.policy?.recompute === true) {
+    return { action: 'recompute', reason: 'forced' };
+  }
+
+  if (
+    input.policy?.recomputeOnError === true &&
+    isErrorLikeCellValue(input.value)
+  ) {
+    return { action: 'recompute', reason: 'failed' };
+  }
+
   const staleAt =
     input.meta && Object.prototype.hasOwnProperty.call(input.meta, 'staleAt')
       ? input.meta.staleAt
@@ -254,7 +294,26 @@ export function cellPolicyFields(
     .filter(
       ([, policy]) =>
         policy.staleAfterSeconds !== undefined ||
-        policy.dynamicStaleAfterSeconds === true,
+        policy.dynamicStaleAfterSeconds === true ||
+        policy.recompute === true ||
+        policy.recomputeOnError === true,
     )
     .map(([field]) => field);
 }
+
+function isErrorLikeCellValue(value: unknown): boolean {
+  if (typeof value === 'string') {
+    return /(^|: )error(:|$)/i.test(value.trim());
+  }
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return false;
+  }
+  const record = value as Record<string, unknown>;
+  const raw = (record.toolResponse as { raw?: unknown } | undefined)?.raw;
+  return (
+    (raw !== undefined && isErrorLikeCellValue(raw)) ||
+    (typeof record.error === 'string' && record.error.trim().length > 0) ||
+    record.status === 'failed' ||
+    record.status === 'error'
+  );
+}

package/dist/repo/shared_libs/play-runtime/run-ledger.ts

@@ -438,6 +438,12 @@ function normalizeStepProgress(
           ),
         }
       : {}),
+    ...(finiteNumber(value.startedAt) !== null
+      ? { startedAt: finiteNumber(value.startedAt) }
+      : {}),
+    ...(finiteNumber(value.completedAt) !== null
+      ? { completedAt: finiteNumber(value.completedAt) }
+      : {}),
     ...(finiteNumber(value.updatedAt) !== null
       ? { updatedAt: finiteNumber(value.updatedAt) }
       : {}),

package/dist/repo/shared_libs/play-runtime/step-program-dataset-builder.ts

@@ -5,6 +5,8 @@ export type StepProgramDatasetOptions = {
     row: Record<string, unknown>,
     index: number,
   ) => boolean | Promise<boolean>;
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: AuthoredStaleAfterSeconds;
 };
 
@@ -48,6 +50,8 @@ function isPreviousCell(value: unknown): value is PreviousCell {
 
 export type StepProgramDatasetStep<TResolver> = {
   name: string;
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   resolver: TResolver;
   staleAfterSeconds?: AuthoredStaleAfterSeconds;
 };
@@ -133,6 +137,10 @@ export class StepProgramDatasetBuilder<
         ...(normalized.options?.staleAfterSeconds !== undefined
           ? { staleAfterSeconds: normalized.options.staleAfterSeconds }
           : {}),
+        ...(normalized.options?.recompute === true ? { recompute: true } : {}),
+        ...(normalized.options?.recomputeOnError === true
+          ? { recomputeOnError: true }
+          : {}),
       } as TStep,
     ];
     return this;

package/dist/repo/shared_libs/plays/static-pipeline.ts

@@ -32,6 +32,61 @@ export interface PlayStaticPipeline {
   sheetContractErrors?: string[];
 }
 
+function dedupeStaticFieldNames(
+  fields: Array<string | null | undefined>,
+): string[] {
+  const seen = new Set<string>();
+  const out: string[] = [];
+  for (const field of fields) {
+    const trimmed = typeof field === 'string' ? field.trim() : '';
+    if (!trimmed || seen.has(trimmed)) {
+      continue;
+    }
+    seen.add(trimmed);
+    out.push(trimmed);
+  }
+  return out;
+}
+
+export function inputFieldFromStaticCsvArg(csvArg: unknown): string | null {
+  if (typeof csvArg !== 'string') return null;
+  const match = /^input\.([A-Za-z_$][\w$]*)$/.exec(csvArg.trim());
+  return match?.[1] ?? null;
+}
+
+export function deriveStaticPipelineFileInputFields(
+  pipeline: PlayStaticPipeline | null | undefined,
+): string[] {
+  if (!pipeline) {
+    return [];
+  }
+  const explicitCsvFields = getCompiledPipelineSubsteps(pipeline)
+    .filter((substep) => substep.type === 'csv')
+    .map((substep) =>
+      substep.type === 'csv'
+        ? (inputFieldFromStaticCsvArg(substep.path) ?? substep.field)
+        : null,
+    );
+  const inferredCsvField =
+    explicitCsvFields.length > 0
+      ? null
+      : (inputFieldFromStaticCsvArg(pipeline.csvArg) ??
+        (pipeline.csvArg ? 'csv' : null));
+  return dedupeStaticFieldNames([...explicitCsvFields, inferredCsvField]);
+}
+
+export function deriveStaticPipelineEntryInputFields(
+  pipeline: PlayStaticPipeline | null | undefined,
+): string[] {
+  if (!pipeline) {
+    return [];
+  }
+  const fileInputs = deriveStaticPipelineFileInputFields(pipeline);
+  return fileInputs.length > 0
+    ? fileInputs
+    : dedupeStaticFieldNames(pipeline.inputFields ?? []);
+}
+
 export type PlaySheetColumnSource =
   | 'input'
   | 'datasetColumn'
@@ -73,6 +128,8 @@ export interface PlayStaticColumnProducer {
   toolId?: string;
   playId?: string;
   dependsOnFields?: string[];
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: number;
   conditional?: boolean;
   sourceRange?: PlayStaticSourceRange;
@@ -84,6 +141,8 @@ export interface PlayStaticDatasetColumn {
   id: string;
   source: PlaySheetColumnSource;
   sqlName?: string;
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: number;
   producers: PlayStaticColumnProducer[];
 }
@@ -275,6 +334,8 @@ export interface PlayStaticSourceRange {
 type PlayStaticSubstepMetadata = {
   conditional?: boolean;
   dependsOnFields?: string[];
+  recompute?: boolean;
+  recomputeOnError?: boolean;
   staleAfterSeconds?: number;
 };
 
@@ -600,13 +661,18 @@ function compileDatasetColumns(
     );
     if (!column) continue;
     const pipelineSubstep =
-      substep.staleAfterSeconds === undefined
+      substep.staleAfterSeconds === undefined &&
+      substep.recompute !== true &&
+      substep.recomputeOnError !== true
         ? pipelineSubsteps.find(
             (candidate) => fieldForColumnProducer(candidate) === field,
           )
         : undefined;
     const producer = columnProducerFromSubstep(
-      pipelineSubstep && pipelineSubstep.staleAfterSeconds !== undefined
+      pipelineSubstep &&
+        (pipelineSubstep.staleAfterSeconds !== undefined ||
+          pipelineSubstep.recompute === true ||
+          pipelineSubstep.recomputeOnError === true)
         ? pipelineSubstep
         : substep,
       field,
@@ -618,6 +684,15 @@ function compileDatasetColumns(
     ) {
       column.staleAfterSeconds = producer.staleAfterSeconds;
     }
+    if (column.recompute !== true && producer.recompute === true) {
+      column.recompute = true;
+    }
+    if (
+      column.recomputeOnError !== true &&
+      producer.recomputeOnError === true
+    ) {
+      column.recomputeOnError = true;
+    }
   }
 
   return [...columnsById.values()];
@@ -667,6 +742,8 @@ function columnProducerFromSubstep(
     ...(substep.dependsOnFields?.length
       ? { dependsOnFields: [...substep.dependsOnFields] }
       : {}),
+    ...(substep.recompute === true ? { recompute: true } : {}),
+    ...(substep.recomputeOnError === true ? { recomputeOnError: true } : {}),
     ...(substep.staleAfterSeconds !== undefined
       ? { staleAfterSeconds: substep.staleAfterSeconds }
       : {}),
@@ -828,7 +905,14 @@ export function compileSheetContract(pipeline: PlayStaticPipeline): {
       errors.push('Sheet contract produced an empty column id.');
       return;
     }
-    if (columns.some((existing) => existing.id === column.id)) return;
+    const existing = columns.find((candidate) => candidate.id === column.id);
+    if (existing) {
+      if (existing.source === 'input' && column.source === 'datasetColumn') {
+        existing.source = 'datasetColumn';
+        existing.field = column.field;
+      }
+      return;
+    }
     columns.push({
       ...column,
       sqlName: sqlSafePlayColumnName(column.id),

package/package.json

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