deepline 0.1.173 → 0.1.175

package/dist/bundling-sources/apps/play-runner-workers/src/coordinator-entry.ts

@@ -103,6 +103,7 @@ export type PlayWorkflowParams = {
   executionPlan?: ExecutionPlan | null;
   childPlayManifests?: PlayRuntimeManifestMap | null;
   playCallGovernance?: PlayCallGovernanceSnapshot | null;
+  forceToolRefresh?: boolean | null;
   preloadedDbSessions?: PreloadedRuntimeDbSession[] | null;
   preloadedDbSessionRef?: {
     runId: string;
@@ -2214,6 +2215,7 @@ function buildChildWorkflowParams(input: {
     executorToken: childToken,
     baseUrl,
     integrationMode: normalizeIntegrationMode(body.integrationMode),
+    forceToolRefresh: body.forceToolRefresh === true,
     orgId,
     userEmail: typeof body.userEmail === 'string' ? body.userEmail : '',
     userId: typeof body.userId === 'string' ? body.userId : null,
@@ -2274,6 +2276,7 @@ function runRequestFromPlayWorkflowParams(
     executionPlan: params.executionPlan ?? null,
     childPlayManifests: params.childPlayManifests ?? null,
     playCallGovernance: params.playCallGovernance ?? null,
+    force: params.forceToolRefresh === true,
     preloadedDbSessions: params.preloadedDbSessions ?? null,
     inlineChildRunRegistered:
       params.runtimeBackend === 'cf_workflows_dynamic_worker_inline_child',
@@ -3435,6 +3438,18 @@ async function coordinatorRouteFetch(
     }
     return new Response('ok', { status: 200, headers });
   }
+  if (url.pathname === '/internal-token/probe') {
+    const authError = authorizeCoordinatorControlRequest({ request, env });
+    if (authError) return authError;
+    return Response.json({
+      ok: true,
+      deployMarker: env.DEEPLINE_COORDINATOR_DEPLOY_MARKER ?? null,
+      runtimeDeployVersion:
+        env.CF_VERSION_METADATA?.id ??
+        env.DEEPLINE_COORDINATOR_DEPLOY_MARKER ??
+        null,
+    });
+  }
   if (url.pathname === '/warmup/submit') {
     const authError = authorizeCoordinatorControlRequest({ request, env });
     if (authError) return authError;

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

@@ -270,6 +270,7 @@ type RunRequest = {
   playName: string;
   graphHash?: string | null;
   userEmail: string | null;
+  force?: boolean | null;
   runtimeInput: Record<string, unknown>;
   /** Optional inline CSV rows (for plays where ctx.csv was passed inline data). */
   inlineCsv?: { name: string; rows: Record<string, unknown>[] } | null;
@@ -1857,7 +1858,9 @@ class WorkerToolBatchScheduler {
         id,
         cacheKey: receiptKey,
         receiptKey,
-        force: options?.force === true,
+        force:
+          options?.force === true ||
+          !!this.req.force,
         receiptWaitMaxAttempts: resolveRuntimeToolReceiptWaitMaxAttempts(
           typeof runtimeOptions?.receiptWaitMs === 'number'
             ? { max_wait_ms: runtimeOptions.receiptWaitMs }
@@ -4088,6 +4091,7 @@ async function prepareMapRows(input: {
   rows: Record<string, unknown>[];
   inputOffset: number;
   outputFields: string[];
+  force?: boolean;
 }): Promise<{
   inserted: number;
   skipped: number;
@@ -4109,6 +4113,7 @@ async function prepareMapRows(input: {
     }),
     rows,
     inputOffset: input.inputOffset,
+    ...(input.force ? { force: true } : {}),
   });
   for (const timing of result.timings ?? []) {
     const phase =
@@ -4682,9 +4687,7 @@ function createMinimalWorkerCtx(
       return formatMapProgressMessage(completed, input.total);
     };
     const formatMapProcessingMessage = (rowsToExecute: number) =>
-      rowsToExecute > 0
-        ? `Processing ${rowsToExecute.toLocaleString()} rows`
-        : null;
+      rowsToExecute > 0 ? `${rowsToExecute.toLocaleString()} rows` : null;
     const formatMapExecutionHeartbeatMessage = (input: {
       rowsToExecute: number;
       startedRows: number;
@@ -4698,7 +4701,7 @@ function createMinimalWorkerCtx(
       const waitingRows = Math.max(0, rowsToExecute - startedRows);
       const parts = [
         activeRows > 0 ? `${activeRows.toLocaleString()} active` : null,
-        waitingRows > 0 ? `${waitingRows.toLocaleString()} waiting` : null,
+        waitingRows > 0 ? `${waitingRows.toLocaleString()} queued` : null,
         completedRows > 0 ? `${completedRows.toLocaleString()} done` : null,
       ].filter((part): part is string => Boolean(part));
       const base =
@@ -4889,6 +4892,7 @@ function createMinimalWorkerCtx(
           ...mapRowOutcomeRuntimeFields({ key: rowKey }),
         })),
         inputOffset: baseOffset + chunkStart,
+        force: !!req.force,
       });
       recordRunnerPerfTrace({
         req,
@@ -5366,7 +5370,9 @@ function createMinimalWorkerCtx(
                         request.input,
                         workflowStep,
                         {
-                          force: request.force === true,
+                          force:
+                            request.force === true ||
+                            !!req.force,
                           staleAfterSeconds: request.staleAfterSeconds,
                         },
                       );
@@ -6354,7 +6360,9 @@ function createMinimalWorkerCtx(
           request.input,
           workflowStep,
           {
-            force: request.force === true,
+            force:
+              request.force === true ||
+              !!req.force,
             staleAfterSeconds: request.staleAfterSeconds,
           },
           {
@@ -6500,6 +6508,7 @@ function createMinimalWorkerCtx(
                   callbackBaseUrl: req.callbackUrl,
                   baseUrl: req.baseUrl,
                   integrationMode: req.integrationMode ?? null,
+                  forceToolRefresh: req.force === true,
                   parentExecutorToken: req.executorToken,
                   userEmail: req.userEmail ?? '',
                   profile: 'workers_edge',
@@ -7956,6 +7965,7 @@ function runRequestFromWorkflowParams(
     runtimeInput: isRecord(params.input)
       ? (params.input as Record<string, unknown>)
       : {},
+    force: params.forceToolRefresh === true,
     inlineCsv: isInlineCsv(params.inlineCsv) ? params.inlineCsv : null,
     inputFiles:
       inputFile && inputStorageKey

package/dist/bundling-sources/sdk/src/client.ts

@@ -127,6 +127,26 @@ function isTransientCompileManifestError(error: unknown): boolean {
   );
 }
 
+function requireCompileManifestResponse(
+  response: { compilerManifest?: PlayCompilerManifest } | null | undefined,
+  playName: string,
+): PlayCompilerManifest {
+  const compilerManifest = response?.compilerManifest;
+  if (
+    !compilerManifest ||
+    typeof compilerManifest !== 'object' ||
+    Array.isArray(compilerManifest)
+  ) {
+    throw new DeeplineError(
+      `Compile manifest response did not include compilerManifest for ${playName}.`,
+      502,
+      'API_RESPONSE_INVALID',
+      { response: response ?? null },
+    );
+  }
+  return compilerManifest;
+}
+
 async function mapWithConcurrency<T, U>(
   items: T[],
   concurrency: number,
@@ -1265,6 +1285,7 @@ export class DeeplineClient {
    */
   async startPlayRun(request: StartPlayRunRequest): Promise<PlayRunStart> {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post<Record<string, unknown>>(
       '/api/v2/plays/run',
       {
@@ -1299,6 +1320,7 @@ export class DeeplineClient {
           ? { packagedFiles: request.packagedFiles }
           : {}),
         ...(request.force ? { force: true } : {}),
+        ...(forceToolRefresh ? { forceToolRefresh: true } : {}),
         ...(typeof request.waitForCompletionMs === 'number'
           ? { waitForCompletionMs: request.waitForCompletionMs }
           : {}),
@@ -1328,6 +1350,7 @@ export class DeeplineClient {
     options?: { signal?: AbortSignal },
   ): AsyncGenerator<PlayLiveEvent> {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...(request.name ? { name: request.name } : {}),
       ...(request.revisionId ? { revisionId: request.revisionId } : {}),
@@ -1360,6 +1383,7 @@ export class DeeplineClient {
         ? { packagedFiles: request.packagedFiles }
         : {}),
       ...(request.force ? { force: true } : {}),
+      ...(forceToolRefresh ? { forceToolRefresh: true } : {}),
       ...(typeof request.waitForCompletionMs === 'number'
         ? { waitForCompletionMs: request.waitForCompletionMs }
         : {}),
@@ -1544,7 +1568,7 @@ export class DeeplineClient {
         const response = await this.http.post<{
           compilerManifest: PlayCompilerManifest;
         }>('/api/v2/plays/compile-manifest', input);
-        return response.compilerManifest;
+        return requireCompileManifestResponse(response, input.name);
       } catch (error) {
         const delayMs = retryDelays[attempt];
         if (delayMs === undefined || !isTransientCompileManifestError(error)) {
@@ -1610,6 +1634,7 @@ export class DeeplineClient {
     inputFile?: PlayStagedFileRef | null;
     packagedFiles?: PlayStagedFileRef[];
     force?: boolean;
+    forceToolRefresh?: boolean;
   }): Promise<PlayRunStart> {
     const compilerManifest =
       input.compilerManifest ??
@@ -1645,6 +1670,7 @@ export class DeeplineClient {
         ? { packagedFiles: input.packagedFiles }
         : {}),
       ...(input.force ? { force: true } : {}),
+      ...(input.forceToolRefresh ? { forceToolRefresh: true } : {}),
     });
   }
 
@@ -1686,6 +1712,7 @@ export class DeeplineClient {
       inputFile?: PlayStagedFileRef | null;
       packagedFiles?: PlayStagedFileRef[];
       force?: boolean;
+      forceToolRefresh?: boolean;
     },
   ): Promise<PlayRunStart> {
     const runtimeInput = options?.input ? { ...options.input } : {};
@@ -1746,6 +1773,7 @@ export class DeeplineClient {
         ? { packagedFiles: options.packagedFiles }
         : {}),
       ...(options?.force ? { force: true } : {}),
+      ...(options?.forceToolRefresh ? { forceToolRefresh: true } : {}),
     });
   }
 
@@ -2838,6 +2866,8 @@ export class DeeplineClient {
       packagedFiles?: PlayStagedFileRef[];
       /** Compatibility flag; active sibling runs are allowed. */
       force?: boolean;
+      /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+      forceToolRefresh?: boolean;
     },
   ): Promise<PlayRunResult> {
     const { workflowId } = await this.submitPlay(code, csvPath, name, {
@@ -2848,6 +2878,7 @@ export class DeeplineClient {
       inputFile: options?.inputFile,
       packagedFiles: options?.packagedFiles,
       force: options?.force,
+      forceToolRefresh: options?.forceToolRefresh,
     });
     const start = Date.now();
     const state: PlayLiveStatusState = {

package/dist/bundling-sources/sdk/src/plays/harness-stub.ts

@@ -225,6 +225,7 @@ export async function harnessStartSheetDataset(input: {
   rows: Array<Record<string, unknown>>;
   runId: string;
   inputOffset?: number;
+  force?: boolean;
   userEmail?: string | null;
 }): Promise<{
   inserted: number;

package/dist/bundling-sources/sdk/src/release.ts

@@ -104,10 +104,10 @@ export const SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: '0.1.173',
+  version: '0.1.175',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.173',
+    latest: '0.1.175',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/bundling-sources/sdk/src/types.ts

@@ -998,6 +998,8 @@ export interface StartPlayRunRequest {
   packagedFiles?: unknown[];
   /** Compatibility flag; active sibling runs are allowed. */
   force?: boolean;
+  /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+  forceToolRefresh?: boolean;
   /** Optionally let the start request wait briefly and return a terminal result. */
   waitForCompletionMs?: number;
   /**

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -1579,7 +1579,9 @@ export class PlayContextImpl {
     staleAfterSeconds?: number | null;
   } {
     return {
-      force: options?.force === true,
+      force:
+        options?.force === true ||
+        this.#options.cachePolicy?.forceToolRefresh === true,
       staleAfterSeconds: options?.staleAfterSeconds ?? null,
     };
   }
@@ -2152,6 +2154,8 @@ export class PlayContextImpl {
           playId: this.#options.playId,
           runId: this.#options.runId,
           staticPipeline: this.#options.staticPipeline,
+          forceRefresh:
+            this.#options.cachePolicy?.forceToolRefresh === true,
         },
       );
       resolvedTableNamespace = normalizeTableNamespace(
@@ -3454,7 +3458,7 @@ export class PlayContextImpl {
           ? null
           : this.getCachedToolResult(toolId, directCacheKey);
         if (cached?.done) {
-          this.log(`Calling tool: ${toolId} recovered from checkpoint`);
+          this.log(`Tool cache hit: ${toolId} exact payload`);
           return await this.wrapToolExecutionResult({
             toolId,
             status: cached.result == null ? 'no_result' : 'completed',
@@ -3465,7 +3469,11 @@ export class PlayContextImpl {
             }),
           });
         }
-        this.log(`Calling tool: ${toolId}`);
+        this.log(
+          toolCachePolicy.force
+            ? `Calling tool: ${toolId} (force)`
+            : `Calling tool: ${toolId}`,
+        );
         const execution = await this.callToolExecutionAPI(toolId, input, {
           timeoutMs: options?.timeoutMs,
         });
@@ -3513,7 +3521,7 @@ export class PlayContextImpl {
         ? null
         : this.getCachedToolResult(toolId, toolResultCacheKey);
       if (cached?.done) {
-        this.log(`  Row ${rowId} ${toolId}: recovered from checkpoint`);
+        this.log(`  Row ${rowId} ${toolId}: cache hit exact payload`);
         return await this.wrapToolExecutionResult({
           toolId,
           status: cached.result == null ? 'no_result' : 'completed',
@@ -3582,7 +3590,7 @@ export class PlayContextImpl {
         staleAfterSeconds: toolCachePolicy.staleAfterSeconds,
         markSkipped: () => {
           this.log(
-            `ctx.tools.execute(${toolId}): no-op due completed receipt ${toolRequestIdentity} (label: ${normalizedKey})`,
+            `Tool cache hit: ${toolId} exact payload (${normalizedKey}:${toolRequestIdentity})`,
           );
         },
         onClaimedResult: (output, receiptKey) =>
@@ -4303,7 +4311,9 @@ export class PlayContextImpl {
         const pendingRequests: ToolCallRequest[] = [];
         const recoveredRequests: ToolCallRequest[] = [];
         for (const req of requests) {
-          const cached = this.getCachedToolResult(toolId, req.cacheKey);
+          const cached = req.force
+            ? undefined
+            : this.getCachedToolResult(toolId, req.cacheKey);
           if (cached?.done) {
             this.log(`  Row ${req.rowId} ${toolId}: recovered from checkpoint`);
             const resolver = this.toolCallResolvers.get(req.callId);

package/dist/bundling-sources/shared_libs/play-runtime/ctx-types.ts

@@ -410,6 +410,10 @@ export interface ContextOptions {
   checkpoint?: PlayCheckpoint;
   /** Enables durable boundary replay such as ctx.sleep() resumptions. */
   durableBoundaries?: boolean;
+  /** Run-level cache policy. forceToolRefresh bypasses ctx.tools.execute receipts. */
+  cachePolicy?: {
+    forceToolRefresh?: boolean;
+  };
   /** Called after each durable batch completes — for Temporal heartbeating. */
   onBatchComplete?: (checkpoint: PlayCheckpoint) => void;
   /** Called when the runtime emits a new execution log line. */
@@ -435,6 +439,7 @@ export interface ContextOptions {
       playId?: string;
       runId?: string;
       staticPipeline?: PlayStaticPipeline | null;
+      forceRefresh?: boolean;
     },
   ) => Promise<MapStartResult>;
   /**

package/dist/bundling-sources/shared_libs/play-runtime/durable-call-cache.ts

@@ -58,21 +58,15 @@ export function buildDurableToolCallCacheKey(input: {
   const orgId = input.orgId?.trim() || 'org';
   const playId = input.playId.trim();
   if (!playId) {
-    throw new Error(
-      'Durable tool call cache key requires a non-empty play id.',
-    );
+    throw new Error('Missing durable tool play id.');
   }
   const toolId = input.toolId.trim();
   if (!toolId) {
-    throw new Error(
-      'Durable tool call cache key requires a non-empty tool id.',
-    );
+    throw new Error('Missing durable tool id.');
   }
-  const providerActionVersion = input.providerActionVersion?.trim();
-  if (!providerActionVersion) {
-    throw new Error(
-      'Durable tool call cache key requires a provider action version.',
-    );
+  const p = input.providerActionVersion?.trim();
+  if (!p) {
+    throw new Error('Missing durable tool action version.');
   }
   const digest = sha256Hex(
     stableStringify({
@@ -83,7 +77,7 @@ export function buildDurableToolCallCacheKey(input: {
       normalizedToolId: normalizeTableNamespace(toolId),
       requestInput: input.requestInput,
       authScopeDigest: input.authScopeDigest ?? null,
-      providerActionVersion,
+      providerActionVersion: p,
       cachePolicyVersion:
         input.cachePolicyVersion ?? DURABLE_CALL_CACHE_POLICY_VERSION,
       staleBucket: durableCacheStaleBucket({

package/dist/bundling-sources/shared_libs/play-runtime/protocol.ts

@@ -23,6 +23,7 @@ export interface PlayRunnerContextConfig {
   userEmail?: string;
   convexUrl?: string;
   staticPipeline?: PlayStaticPipeline | null;
+  forceToolRefresh?: boolean | null;
   /**
    * Controls how scoped Postgres sessions enter the runner. `preloaded` means
    * the launch config carries short-lived encrypted sessions minted before

package/dist/bundling-sources/shared_libs/play-runtime/runtime-api.ts

@@ -2224,7 +2224,10 @@ async function prepareRuntimeSheetDatasetRows(
     normalizedTableNamespace: string;
     physicalInsertColumnsSql: string;
     physicalInsertValuesSql: string;
+    physicalRefreshSetSql: string;
+    physicalUpsertSetSql: string;
     outputPhysicalColumns: PhysicalSheetColumnProjection[];
+    force?: boolean;
   },
 ): Promise<{ inserted: number; pendingKeys: string[] }> {
   let inserted = 0;
@@ -2259,10 +2262,14 @@ async function prepareRuntimeSheetDatasetRows(
           UPDATE ${sheetTable(session)} AS target
           SET _input_index = input_rows._input_index,
               _updated_at = now(),
-              _version = ${nextRuntimeSheetVersionExpression(session)}
+              _version = ${nextRuntimeSheetVersionExpression(session)}${input.physicalRefreshSetSql}
           FROM input_rows
           WHERE target._key = input_rows._key
-            AND target._input_index IS DISTINCT FROM input_rows._input_index
+            AND target._status <> 'stale'
+            AND (
+              $7::boolean
+              OR target._input_index IS DISTINCT FROM input_rows._input_index
+            )
           RETURNING target._key
         ),
         inserted_rows AS (
@@ -2274,7 +2281,7 @@ async function prepareRuntimeSheetDatasetRows(
             _run_id = EXCLUDED._run_id,
             _input_index = EXCLUDED._input_index,
             _updated_at = now(),
-            _version = ${nextRuntimeSheetVersionExpression(session)}
+            _version = ${nextRuntimeSheetVersionExpression(session)}${input.physicalUpsertSetSql}
           WHERE ${sheetTable(session)}._status = 'stale'
           RETURNING _key
         ),
@@ -2375,6 +2382,7 @@ async function prepareRuntimeSheetDatasetRows(
         input.runId,
         input.normalizedPlayName,
         input.normalizedTableNamespace,
+        input.force === true,
       ],
     );
     inserted += Number(rows[0]?.inserted_count ?? 0);
@@ -2398,30 +2406,35 @@ async function buildRuntimeSheetDatasetStartResult(
     runId: string;
     inserted: number;
     pendingKeys: string[];
+    force?: boolean;
     timings?: RuntimeSheetTiming[];
   },
 ): Promise<PrepareRuntimeSheetResult> {
+  const datasetFields = input.sheetContract.columns.flatMap((column) =>
+    column.source === 'datasetColumn' && typeof column.field === 'string'
+      ? [column.field]
+      : [],
+  );
+  const buildFreshPendingRows = () => {
+    return input.rowEntries.map((entry) => {
+      const row: Record<string, unknown> = {
+        ...sanitizePostgresJsonValue(entry.row),
+        __deeplineRowKey: entry.key,
+      };
+      for (const field of datasetFields) {
+        if (!Object.prototype.hasOwnProperty.call(row, field)) {
+          row[field] = null;
+        }
+      }
+      return row;
+    });
+  };
+
   if (input.inserted === input.rowEntries.length) {
-    const datasetFields = input.sheetContract.columns.flatMap((column) =>
-      column.source === 'datasetColumn' && typeof column.field === 'string'
-        ? [column.field]
-        : [],
-    );
     return {
       inserted: input.inserted,
       skipped: input.sourceRowsLength - input.rowEntries.length,
-      pendingRows: input.rowEntries.map((entry) => {
-        const row: Record<string, unknown> = {
-          ...sanitizePostgresJsonValue(entry.row),
-          __deeplineRowKey: entry.key,
-        };
-        for (const field of datasetFields) {
-          if (!Object.prototype.hasOwnProperty.call(row, field)) {
-            row[field] = null;
-          }
-        }
-        return row;
-      }),
+      pendingRows: buildFreshPendingRows(),
       completedRows: [],
       tableNamespace: input.tableNamespace,
     };
@@ -2434,7 +2447,24 @@ async function buildRuntimeSheetDatasetStartResult(
     runId: input.runId,
     normalizedPlayName: input.normalizedPlayName,
     normalizedTableNamespace: input.normalizedTableNamespace,
+    outputFields: input.force === true ? datasetFields : [],
   });
+  if (pendingKeys.size > 0) {
+    input.timings?.push({
+      phase: 'mark_rows_pending_for_recompute',
+      ms: Date.now() - startedAt,
+      rows: pendingKeys.size,
+    });
+  }
+  if (input.force === true) {
+    return {
+      inserted: input.inserted,
+      skipped: input.sourceRowsLength - input.rowEntries.length,
+      pendingRows: buildFreshPendingRows(),
+      completedRows: [],
+      tableNamespace: input.tableNamespace,
+    };
+  }
   const persistedRows = await readRuntimeRowsByKey(
     client,
     session,
@@ -2444,13 +2474,6 @@ async function buildRuntimeSheetDatasetStartResult(
   const persistedRowsByKey = new Map(
     persistedRows.map((row) => [row.key, row.data]),
   );
-  if (pendingKeys.size > 0) {
-    input.timings?.push({
-      phase: 'mark_rows_pending_for_recompute',
-      ms: Date.now() - startedAt,
-      rows: pendingKeys.size,
-    });
-  }
   const buildMergedRow = (entry: RuntimeDatasetRowEntry) => {
     const merged = { ...entry.row };
     for (const [field, value] of Object.entries(
@@ -2489,12 +2512,14 @@ async function markRuntimeRowsPendingForRecompute(
     runId: string;
     normalizedPlayName: string;
     normalizedTableNamespace: string;
+    outputFields?: string[];
   },
 ): Promise<void> {
   if (input.keys.length === 0) return;
+  const outputFields = [...new Set(input.outputFields ?? [])];
   await client.query(
     `WITH target_rows AS (
-       SELECT _key, _status
+       SELECT _key, _status, _cell_meta
          FROM ${sheetTable(session)}
         WHERE _key = ANY($1::text[])
         FOR UPDATE
@@ -2511,7 +2536,8 @@ async function markRuntimeRowsPendingForRecompute(
            target._status <> 'pending'
            OR target._run_id IS DISTINCT FROM $2::text
          )
-       RETURNING target_rows._status AS previous_status
+       RETURNING target_rows._status AS previous_status,
+                 target_rows._cell_meta AS previous_cell_meta
      ),
      summary_counts AS (
        SELECT
@@ -2520,6 +2546,18 @@ async function markRuntimeRowsPendingForRecompute(
          count(*) FILTER (WHERE previous_status = 'running')::int AS running_to_pending
        FROM updated
      ),
+     column_delta_counts AS (
+       SELECT field_values.field,
+              count(*) FILTER (
+                WHERE previous_cell_meta -> field_values.field ->> 'status' = 'completed'
+              )::int AS completed_to_pending,
+              count(*) FILTER (
+                WHERE previous_cell_meta -> field_values.field ->> 'status' = 'failed'
+              )::int AS failed_to_pending
+         FROM updated
+         JOIN unnest($5::text[]) AS field_values(field) ON true
+        GROUP BY field_values.field
+     ),
      summary_delta AS (
        INSERT INTO ${summaryTable(session)} AS target (play_name, table_namespace, total, queued, running, completed, failed)
        SELECT
@@ -2547,6 +2585,27 @@ async function markRuntimeRowsPendingForRecompute(
          })},
          _updated_at = now()
        RETURNING 1
+     ),
+     column_summary_delta AS (
+       INSERT INTO ${columnSummaryTable(session)} AS target (
+         play_name,
+         table_namespace,
+         field,
+         completed,
+         failed
+       )
+       SELECT $3::text,
+              $4::text,
+              field,
+              -completed_to_pending,
+              -failed_to_pending
+         FROM column_delta_counts
+        WHERE completed_to_pending > 0 OR failed_to_pending > 0
+       ON CONFLICT (play_name, table_namespace, field) DO UPDATE SET
+         completed = GREATEST(target.completed + EXCLUDED.completed, 0),
+         failed = GREATEST(target.failed + EXCLUDED.failed, 0),
+         _updated_at = now()
+       RETURNING 1
      )
      SELECT 1`,
     [
@@ -2554,6 +2613,7 @@ async function markRuntimeRowsPendingForRecompute(
       input.runId,
       input.normalizedPlayName,
       input.normalizedTableNamespace,
+      outputFields,
     ],
   );
 }
@@ -3237,6 +3297,7 @@ export async function startRuntimeSheetDataset(
     rows: Record<string, unknown>[];
     runId: string;
     inputOffset?: number;
+    force?: boolean;
   },
 ): Promise<PrepareRuntimeSheetResult> {
   const totalStartedAt = Date.now();
@@ -3334,6 +3395,24 @@ export async function startRuntimeSheetDataset(
           .map((column) => `payload -> ${quoteLiteral(column)}`)
           .join(', ')}`
       : '';
+  const physicalRefreshSetSql =
+    physicalColumns.length > 0
+      ? `, ${physicalColumns
+          .map(
+            (column) =>
+              `${quoteIdentifier(column)} = input_rows.payload -> ${quoteLiteral(column)}`,
+          )
+          .join(', ')}`
+      : '';
+  const physicalUpsertSetSql =
+    physicalColumns.length > 0
+      ? `, ${physicalColumns
+          .map(
+            (column) =>
+              `${quoteIdentifier(column)} = EXCLUDED.${quoteIdentifier(column)}`,
+          )
+          .join(', ')}`
+      : '';
   const outputPhysicalColumns = outputPhysicalSheetColumnProjections(
     input.sheetContract,
   );
@@ -3364,15 +3443,26 @@ export async function startRuntimeSheetDataset(
         normalizedTableNamespace,
         physicalInsertColumnsSql,
         physicalInsertValuesSql,
+        physicalRefreshSetSql:
+          input.force === true ? physicalRefreshSetSql : '',
+        physicalUpsertSetSql,
         outputPhysicalColumns,
+        force: input.force === true,
       });
+      const effectivePrepared = input.force
+        ? {
+            inserted: prepared.inserted,
+            pendingKeys: rowEntries.map((entry) => entry.key),
+          }
+        : prepared;
       timings.push({
         phase: 'prepare_rows_sql',
         ms: Date.now() - prepareStartedAt,
         rows: rowEntries.length,
         chunks: chunks.length,
-        inserted: prepared.inserted,
-        pending: prepared.pendingKeys.length,
+        inserted: effectivePrepared.inserted,
+        pending: effectivePrepared.pendingKeys.length,
+        ...(input.force ? { force: true } : {}),
       });
       const buildStartedAt = Date.now();
       const built = await buildRuntimeSheetDatasetStartResult(client, session, {
@@ -3384,7 +3474,8 @@ export async function startRuntimeSheetDataset(
         normalizedTableNamespace,
         runId: input.runId,
         timings,
-        ...prepared,
+        force: input.force === true,
+        ...effectivePrepared,
       });
       timings.push({
         phase: 'build_result',

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backend.ts

@@ -83,6 +83,8 @@ export type PlaySchedulerSubmitInput = {
   artifactHash: string;
   graphHash: string;
   input: Record<string, unknown>;
+  /** Run-level --force cache bypass for dataset rows and ctx.tools.execute receipts. */
+  forceToolRefresh?: boolean | null;
   inputFile?: {
     name?: string;
     path?: string;

package/dist/cli/index.js

@@ -622,10 +622,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.173",
+  version: "0.1.175",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.173",
+    latest: "0.1.175",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2134,6 +2134,18 @@ function isTransientCompileManifestError(error) {
     message
   );
 }
+function requireCompileManifestResponse(response, playName) {
+  const compilerManifest = response?.compilerManifest;
+  if (!compilerManifest || typeof compilerManifest !== "object" || Array.isArray(compilerManifest)) {
+    throw new DeeplineError(
+      `Compile manifest response did not include compilerManifest for ${playName}.`,
+      502,
+      "API_RESPONSE_INVALID",
+      { response: response ?? null }
+    );
+  }
+  return compilerManifest;
+}
 async function mapWithConcurrency(items, concurrency, mapper) {
   const results = new Array(items.length);
   let nextIndex = 0;
@@ -2674,6 +2686,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2694,6 +2707,7 @@ var DeeplineClient = class {
         ...request.inputFile ? { inputFile: request.inputFile } : {},
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
+        ...forceToolRefresh ? { forceToolRefresh: true } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to workers_edge; tests and runtime probes that want a
@@ -2717,6 +2731,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2735,6 +2750,7 @@ var DeeplineClient = class {
       ...request.inputFile ? { inputFile: request.inputFile } : {},
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
+      ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {}
@@ -2836,7 +2852,7 @@ var DeeplineClient = class {
     for (let attempt = 0; ; attempt += 1) {
       try {
         const response = await this.http.post("/api/v2/plays/compile-manifest", input2);
-        return response.compilerManifest;
+        return requireCompileManifestResponse(response, input2.name);
       } catch (error) {
         const delayMs = retryDelays[attempt];
         if (delayMs === void 0 || !isTransientCompileManifestError(error)) {
@@ -2906,7 +2922,8 @@ var DeeplineClient = class {
       ...input2.input ? { input: input2.input } : {},
       ...input2.inputFile ? { inputFile: input2.inputFile } : {},
       ...input2.packagedFiles?.length ? { packagedFiles: input2.packagedFiles } : {},
-      ...input2.force ? { force: true } : {}
+      ...input2.force ? { force: true } : {},
+      ...input2.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -2979,7 +2996,8 @@ var DeeplineClient = class {
       ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
       ...options?.inputFile ? { inputFile: options.inputFile } : {},
       ...options?.packagedFiles?.length ? { packagedFiles: options.packagedFiles } : {},
-      ...options?.force ? { force: true } : {}
+      ...options?.force ? { force: true } : {},
+      ...options?.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -3861,7 +3879,8 @@ var DeeplineClient = class {
       compilerManifest: options?.compilerManifest,
       inputFile: options?.inputFile,
       packagedFiles: options?.packagedFiles,
-      force: options?.force
+      force: options?.force,
+      forceToolRefresh: options?.forceToolRefresh
     });
     const start = Date.now();
     const state = {
@@ -13345,7 +13364,7 @@ async function handleFileBackedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true } : {},
+    ...options.force ? { force: true, forceToolRefresh: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -13504,7 +13523,7 @@ async function handleNamedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true } : {},
+    ...options.force ? { force: true, forceToolRefresh: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -14690,9 +14709,9 @@ Notes:
   a fire-and-forget run id.
   The play page opens in your browser as soon as the run starts; use --no-open
   to only print the URL.
-  Concurrent runs for the same play are allowed. --force is accepted for
-  compatibility, but it does not cancel active sibling runs or bypass completed
-  reuse.
+  Concurrent runs for the same play are allowed.
+  --force bypasses durable dataset/tool cache reuse for this run.
+  It does not cancel active sibling runs.
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
@@ -14743,7 +14762,7 @@ Examples:
   ).option("--watch", "Compatibility alias; run waits by default").option("--wait", "Compatibility alias; run waits by default").option("--no-wait", "Start the run and return immediately").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
-  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Compatibility flag; active sibling runs are allowed").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
+  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Bypass durable dataset/tool cache reuse").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
     "afterAll",
     `
 Pass-through input flags:

package/dist/cli/index.mjs

@@ -607,10 +607,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.173",
+  version: "0.1.175",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.173",
+    latest: "0.1.175",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2119,6 +2119,18 @@ function isTransientCompileManifestError(error) {
     message
   );
 }
+function requireCompileManifestResponse(response, playName) {
+  const compilerManifest = response?.compilerManifest;
+  if (!compilerManifest || typeof compilerManifest !== "object" || Array.isArray(compilerManifest)) {
+    throw new DeeplineError(
+      `Compile manifest response did not include compilerManifest for ${playName}.`,
+      502,
+      "API_RESPONSE_INVALID",
+      { response: response ?? null }
+    );
+  }
+  return compilerManifest;
+}
 async function mapWithConcurrency(items, concurrency, mapper) {
   const results = new Array(items.length);
   let nextIndex = 0;
@@ -2659,6 +2671,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2679,6 +2692,7 @@ var DeeplineClient = class {
         ...request.inputFile ? { inputFile: request.inputFile } : {},
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
+        ...forceToolRefresh ? { forceToolRefresh: true } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to workers_edge; tests and runtime probes that want a
@@ -2702,6 +2716,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2720,6 +2735,7 @@ var DeeplineClient = class {
       ...request.inputFile ? { inputFile: request.inputFile } : {},
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
+      ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {}
@@ -2821,7 +2837,7 @@ var DeeplineClient = class {
     for (let attempt = 0; ; attempt += 1) {
       try {
         const response = await this.http.post("/api/v2/plays/compile-manifest", input2);
-        return response.compilerManifest;
+        return requireCompileManifestResponse(response, input2.name);
       } catch (error) {
         const delayMs = retryDelays[attempt];
         if (delayMs === void 0 || !isTransientCompileManifestError(error)) {
@@ -2891,7 +2907,8 @@ var DeeplineClient = class {
       ...input2.input ? { input: input2.input } : {},
       ...input2.inputFile ? { inputFile: input2.inputFile } : {},
       ...input2.packagedFiles?.length ? { packagedFiles: input2.packagedFiles } : {},
-      ...input2.force ? { force: true } : {}
+      ...input2.force ? { force: true } : {},
+      ...input2.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -2964,7 +2981,8 @@ var DeeplineClient = class {
       ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
       ...options?.inputFile ? { inputFile: options.inputFile } : {},
       ...options?.packagedFiles?.length ? { packagedFiles: options.packagedFiles } : {},
-      ...options?.force ? { force: true } : {}
+      ...options?.force ? { force: true } : {},
+      ...options?.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -3846,7 +3864,8 @@ var DeeplineClient = class {
       compilerManifest: options?.compilerManifest,
       inputFile: options?.inputFile,
       packagedFiles: options?.packagedFiles,
-      force: options?.force
+      force: options?.force,
+      forceToolRefresh: options?.forceToolRefresh
     });
     const start = Date.now();
     const state = {
@@ -13372,7 +13391,7 @@ async function handleFileBackedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true } : {},
+    ...options.force ? { force: true, forceToolRefresh: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -13531,7 +13550,7 @@ async function handleNamedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true } : {},
+    ...options.force ? { force: true, forceToolRefresh: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -14717,9 +14736,9 @@ Notes:
   a fire-and-forget run id.
   The play page opens in your browser as soon as the run starts; use --no-open
   to only print the URL.
-  Concurrent runs for the same play are allowed. --force is accepted for
-  compatibility, but it does not cancel active sibling runs or bypass completed
-  reuse.
+  Concurrent runs for the same play are allowed.
+  --force bypasses durable dataset/tool cache reuse for this run.
+  It does not cancel active sibling runs.
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
@@ -14770,7 +14789,7 @@ Examples:
   ).option("--watch", "Compatibility alias; run waits by default").option("--wait", "Compatibility alias; run waits by default").option("--no-wait", "Start the run and return immediately").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
-  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Compatibility flag; active sibling runs are allowed").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
+  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Bypass durable dataset/tool cache reuse").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
     "afterAll",
     `
 Pass-through input flags:

package/dist/index.d.mts

@@ -940,6 +940,8 @@ interface StartPlayRunRequest {
     packagedFiles?: unknown[];
     /** Compatibility flag; active sibling runs are allowed. */
     force?: boolean;
+    /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+    forceToolRefresh?: boolean;
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**
@@ -1690,6 +1692,7 @@ declare class DeeplineClient {
         inputFile?: PlayStagedFileRef | null;
         packagedFiles?: PlayStagedFileRef[];
         force?: boolean;
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunStart>;
     /**
      * Register a bundled play artifact and start a run from the live revision.
@@ -1725,6 +1728,7 @@ declare class DeeplineClient {
         inputFile?: PlayStagedFileRef | null;
         packagedFiles?: PlayStagedFileRef[];
         force?: boolean;
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunStart>;
     /**
      * Upload files to the staging area for use in play runs.
@@ -2176,6 +2180,8 @@ declare class DeeplineClient {
         packagedFiles?: PlayStagedFileRef[];
         /** Compatibility flag; active sibling runs are allowed. */
         force?: boolean;
+        /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunResult>;
     /**
      * Published plans plus the caller's active plan: prices, monthly grant

package/dist/index.d.ts

@@ -940,6 +940,8 @@ interface StartPlayRunRequest {
     packagedFiles?: unknown[];
     /** Compatibility flag; active sibling runs are allowed. */
     force?: boolean;
+    /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+    forceToolRefresh?: boolean;
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**
@@ -1690,6 +1692,7 @@ declare class DeeplineClient {
         inputFile?: PlayStagedFileRef | null;
         packagedFiles?: PlayStagedFileRef[];
         force?: boolean;
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunStart>;
     /**
      * Register a bundled play artifact and start a run from the live revision.
@@ -1725,6 +1728,7 @@ declare class DeeplineClient {
         inputFile?: PlayStagedFileRef | null;
         packagedFiles?: PlayStagedFileRef[];
         force?: boolean;
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunStart>;
     /**
      * Upload files to the staging area for use in play runs.
@@ -2176,6 +2180,8 @@ declare class DeeplineClient {
         packagedFiles?: PlayStagedFileRef[];
         /** Compatibility flag; active sibling runs are allowed. */
         force?: boolean;
+        /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
+        forceToolRefresh?: boolean;
     }): Promise<PlayRunResult>;
     /**
      * Published plans plus the caller's active plan: prices, monthly grant

package/dist/index.js

@@ -421,10 +421,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.173",
+  version: "0.1.175",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.173",
+    latest: "0.1.175",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1933,6 +1933,18 @@ function isTransientCompileManifestError(error) {
     message
   );
 }
+function requireCompileManifestResponse(response, playName) {
+  const compilerManifest = response?.compilerManifest;
+  if (!compilerManifest || typeof compilerManifest !== "object" || Array.isArray(compilerManifest)) {
+    throw new DeeplineError(
+      `Compile manifest response did not include compilerManifest for ${playName}.`,
+      502,
+      "API_RESPONSE_INVALID",
+      { response: response ?? null }
+    );
+  }
+  return compilerManifest;
+}
 async function mapWithConcurrency(items, concurrency, mapper) {
   const results = new Array(items.length);
   let nextIndex = 0;
@@ -2473,6 +2485,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2493,6 +2506,7 @@ var DeeplineClient = class {
         ...request.inputFile ? { inputFile: request.inputFile } : {},
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
+        ...forceToolRefresh ? { forceToolRefresh: true } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to workers_edge; tests and runtime probes that want a
@@ -2516,6 +2530,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2534,6 +2549,7 @@ var DeeplineClient = class {
       ...request.inputFile ? { inputFile: request.inputFile } : {},
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
+      ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {}
@@ -2635,7 +2651,7 @@ var DeeplineClient = class {
     for (let attempt = 0; ; attempt += 1) {
       try {
         const response = await this.http.post("/api/v2/plays/compile-manifest", input);
-        return response.compilerManifest;
+        return requireCompileManifestResponse(response, input.name);
       } catch (error) {
         const delayMs = retryDelays[attempt];
         if (delayMs === void 0 || !isTransientCompileManifestError(error)) {
@@ -2705,7 +2721,8 @@ var DeeplineClient = class {
       ...input.input ? { input: input.input } : {},
       ...input.inputFile ? { inputFile: input.inputFile } : {},
       ...input.packagedFiles?.length ? { packagedFiles: input.packagedFiles } : {},
-      ...input.force ? { force: true } : {}
+      ...input.force ? { force: true } : {},
+      ...input.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -2778,7 +2795,8 @@ var DeeplineClient = class {
       ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
       ...options?.inputFile ? { inputFile: options.inputFile } : {},
       ...options?.packagedFiles?.length ? { packagedFiles: options.packagedFiles } : {},
-      ...options?.force ? { force: true } : {}
+      ...options?.force ? { force: true } : {},
+      ...options?.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -3660,7 +3678,8 @@ var DeeplineClient = class {
       compilerManifest: options?.compilerManifest,
       inputFile: options?.inputFile,
       packagedFiles: options?.packagedFiles,
-      force: options?.force
+      force: options?.force,
+      forceToolRefresh: options?.forceToolRefresh
     });
     const start = Date.now();
     const state = {

package/dist/index.mjs

@@ -351,10 +351,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.173",
+  version: "0.1.175",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.173",
+    latest: "0.1.175",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1863,6 +1863,18 @@ function isTransientCompileManifestError(error) {
     message
   );
 }
+function requireCompileManifestResponse(response, playName) {
+  const compilerManifest = response?.compilerManifest;
+  if (!compilerManifest || typeof compilerManifest !== "object" || Array.isArray(compilerManifest)) {
+    throw new DeeplineError(
+      `Compile manifest response did not include compilerManifest for ${playName}.`,
+      502,
+      "API_RESPONSE_INVALID",
+      { response: response ?? null }
+    );
+  }
+  return compilerManifest;
+}
 async function mapWithConcurrency(items, concurrency, mapper) {
   const results = new Array(items.length);
   let nextIndex = 0;
@@ -2403,6 +2415,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2423,6 +2436,7 @@ var DeeplineClient = class {
         ...request.inputFile ? { inputFile: request.inputFile } : {},
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
+        ...forceToolRefresh ? { forceToolRefresh: true } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to workers_edge; tests and runtime probes that want a
@@ -2446,6 +2460,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2464,6 +2479,7 @@ var DeeplineClient = class {
       ...request.inputFile ? { inputFile: request.inputFile } : {},
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
+      ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {}
@@ -2565,7 +2581,7 @@ var DeeplineClient = class {
     for (let attempt = 0; ; attempt += 1) {
       try {
         const response = await this.http.post("/api/v2/plays/compile-manifest", input);
-        return response.compilerManifest;
+        return requireCompileManifestResponse(response, input.name);
       } catch (error) {
         const delayMs = retryDelays[attempt];
         if (delayMs === void 0 || !isTransientCompileManifestError(error)) {
@@ -2635,7 +2651,8 @@ var DeeplineClient = class {
       ...input.input ? { input: input.input } : {},
       ...input.inputFile ? { inputFile: input.inputFile } : {},
       ...input.packagedFiles?.length ? { packagedFiles: input.packagedFiles } : {},
-      ...input.force ? { force: true } : {}
+      ...input.force ? { force: true } : {},
+      ...input.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -2708,7 +2725,8 @@ var DeeplineClient = class {
       ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
       ...options?.inputFile ? { inputFile: options.inputFile } : {},
       ...options?.packagedFiles?.length ? { packagedFiles: options.packagedFiles } : {},
-      ...options?.force ? { force: true } : {}
+      ...options?.force ? { force: true } : {},
+      ...options?.forceToolRefresh ? { forceToolRefresh: true } : {}
     });
   }
   /**
@@ -3590,7 +3608,8 @@ var DeeplineClient = class {
       compilerManifest: options?.compilerManifest,
       inputFile: options?.inputFile,
       packagedFiles: options?.packagedFiles,
-      force: options?.force
+      force: options?.force,
+      forceToolRefresh: options?.forceToolRefresh
     });
     const start = Date.now();
     const state = {

package/package.json

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