deepline 0.1.106 → 0.1.108

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

@@ -270,12 +270,24 @@ var SDK_RELEASE = {
   // 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.
-  version: "0.1.106",
+  // 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.
+  // 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.106",
+    latest: "0.1.108",
     minimumSupported: "0.1.53",
-    deprecatedBelow: "0.1.53"
+    deprecatedBelow: "0.1.53",
+    commandMinimumSupported: [
+      {
+        command: "enrich",
+        minimumSupported: "0.1.108",
+        reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
+      }
+    ],
+    autoUpdatePatchLag: 2
   }
 };
 
@@ -875,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) } : {}
   };
 }
@@ -4065,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

@@ -192,12 +192,24 @@ var SDK_RELEASE = {
   // 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.
-  version: "0.1.106",
+  // 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.
+  // 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.106",
+    latest: "0.1.108",
     minimumSupported: "0.1.53",
-    deprecatedBelow: "0.1.53"
+    deprecatedBelow: "0.1.53",
+    commandMinimumSupported: [
+      {
+        command: "enrich",
+        minimumSupported: "0.1.108",
+        reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
+      }
+    ],
+    autoUpdatePatchLag: 2
   }
 };
 
@@ -797,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) } : {}
   };
 }
@@ -3987,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

@@ -1,8 +1,21 @@
 /**
  * Single source of truth for SDK release metadata.
  *
- * Edit THIS file to bump the SDK version, advance the support window, or rev
- * the SDK/API contract identifier. Everything else derives from these values:
+ * Ordinary SDK PRs do NOT bump `version` here. Patch version selection
+ * happens at publish time: on push to main, `.github/workflows/sdk-release.yml`
+ * (via `scripts/sdk-release-autobump.ts`) compares the built package against
+ * the published npm tarball and, when the content changed, stamps the next
+ * unpublished patch into `version` + `supportPolicy.latest` and publishes it
+ * in the same run.
+ *
+ * Edit THIS file by hand only for deliberate release decisions:
+ *   - minor/major version bumps (set `version` and `supportPolicy.latest`),
+ *   - `apiContract` cutovers (see `docs/sdk-runtime-compatibility.md`),
+ *   - support-window moves (`minimumSupported` / `deprecatedBelow`).
+ * The automation never touches `apiContract`, `minimumSupported`, or
+ * `deprecatedBelow`.
+ *
+ * Everything else derives from these values:
  *
  *   - `sdk/src/version.ts` re-exports `SDK_VERSION` and `SDK_API_CONTRACT`.
  *   - `src/lib/sdk/release-policy.ts` re-exports `SDK_RELEASE_POLICY`.
@@ -13,8 +26,7 @@
  *     `src/lib/sdk/api-routes.ts` and the apiContract here; the hash in
  *     `contracts/sdk-api.manifest.hash` is the invariant that lands in git.
  *
- * Human editors should ONLY touch this file when releasing or changing
- * compatibility policy. Every other location is derived and any drift is a
+ * Any drift between this file and the derived locations is a
  * `check:sdk-release-readiness` failure with a one-shot fix command.
  */
 
@@ -34,10 +46,27 @@ export type SdkSupportPolicy = {
    * warns). Advance when a release becomes the new floor.
    */
   deprecatedBelow: string;
+  /**
+   * Command-scoped support floors for SDK CLI workflows whose local behavior
+   * can break while the network API contract remains compatible.
+   */
+  commandMinimumSupported?: ReadonlyArray<{
+    command: string;
+    minimumSupported: string;
+    reason: string;
+  }>;
+  /**
+   * Ask update-capable CLIs to self-update when they are this many patch
+   * releases behind latest, even if they are not blocked yet.
+   */
+  autoUpdatePatchLag?: number;
 };
 
 export type SdkRelease = {
-  /** Version published to npm; the only place humans should bump it. */
+  /**
+   * Version published to npm. Usually stamped by the release workflow at
+   * publish time (auto-bump); edit by hand only for minor/major releases.
+   */
   version: string;
   /**
    * SDK/API contract identifier. Bump on incompatible protocol or schema
@@ -63,11 +92,24 @@ export const SDK_RELEASE = {
   // 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.
-  version: '0.1.106',
+  // 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.
+  // 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.106',
+    latest: '0.1.108',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
+    commandMinimumSupported: [
+      {
+        command: 'enrich',
+        minimumSupported: '0.1.108',
+        reason:
+          'Older SDK CLI enrich generated stale play source for the current dataset API.',
+      },
+    ],
+    autoUpdatePatchLag: 2,
   },
 } as const satisfies SdkRelease;

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<