deepline 0.1.88 → 0.1.89

package/dist/cli/index.js

@@ -229,10 +229,10 @@ var import_node_path2 = require("path");
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.88",
+  version: "0.1.89",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.88",
+    latest: "0.1.89",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/cli/index.mjs

@@ -206,10 +206,10 @@ import { join as join2 } from "path";
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.88",
+  version: "0.1.89",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.88",
+    latest: "0.1.89",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/index.d.mts

@@ -13,7 +13,17 @@ declare const PLAY_ARTIFACT_KINDS: {
 };
 type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
 
-interface PlayStaticPipelineSnapshot {
+/**
+ * A top-level key the play's function literally `return`s. Derived from the
+ * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
+ * so the "Returns" graph node mirrors the function's real output shape.
+ * `isDataset` is true when the key's value is a `PlayDataset` handle (a table).
+ */
+interface PlayStaticReturnField {
+    name: string;
+    isDataset: boolean;
+}
+interface PlayStaticPipeline {
     tableNamespace?: string;
     inputFields?: string[];
     rowKeyFields?: string[];
@@ -22,16 +32,22 @@ interface PlayStaticPipelineSnapshot {
     csvDescription?: string;
     datasetDescription?: string;
     fields: string[];
-    stages?: PlayStaticSubstepSnapshot[];
-    substeps: PlayStaticSubstepSnapshot[];
-    sheetContract?: PlaySheetContractSnapshot | null;
+    /**
+     * Top-level keys of the play's `return { ... }` object literal, in source
+     * order. Undefined when the terminal return isn't a statically-known object
+     * literal (bare value, dataset handle, conditional returns, etc.).
+     */
+    returnFields?: PlayStaticReturnField[];
+    stages?: PlayStaticSubstep[];
+    substeps: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
     sheetContractErrors?: string[];
 }
-type PlaySheetColumnSourceSnapshot = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
-interface PlaySheetColumnContractSnapshot {
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
     id: string;
     sqlName: string;
-    source: PlaySheetColumnSourceSnapshot;
+    source: PlaySheetColumnSource;
     field?: string;
     parentField?: string;
     playId?: string;
@@ -42,44 +58,49 @@ interface PlaySheetColumnContractSnapshot {
     toolId?: string;
     isRowKey?: boolean;
 }
-interface PlaySheetContractSnapshot {
+interface PlaySheetContract {
     tableNamespace: string;
-    columns: PlaySheetColumnContractSnapshot[];
+    columns: PlaySheetColumnContract[];
 }
-type PlayStaticColumnProducerKindSnapshot = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
-interface PlayStaticColumnProducerSnapshot {
+type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
+interface PlayStaticColumnProducer {
     id: string;
-    kind: PlayStaticColumnProducerKindSnapshot;
+    kind: PlayStaticColumnProducerKind;
     field: string;
     toolId?: string;
     playId?: string;
+    dependsOnFields?: string[];
+    staleAfterSeconds?: number;
     conditional?: boolean;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
-    steps?: PlayStaticColumnProducerSnapshot[];
-    substep: PlayStaticSubstepSnapshot;
+    sourceRange?: PlayStaticSourceRange;
+    steps?: PlayStaticColumnProducer[];
+    substep: PlayStaticSubstep;
 }
-interface PlayStaticDatasetColumnSnapshot {
+interface PlayStaticDatasetColumn {
     id: string;
-    source: PlaySheetColumnSourceSnapshot;
+    source: PlaySheetColumnSource;
     sqlName?: string;
-    producers: PlayStaticColumnProducerSnapshot[];
+    staleAfterSeconds?: number;
+    producers: PlayStaticColumnProducer[];
 }
-interface PlayStaticSourceRangeSnapshot {
+interface PlayStaticSourceRange {
     sourcePath?: string;
     startLine: number;
     endLine: number;
     startColumn: number;
     endColumn: number;
 }
-type PlayStaticSubstepMetadataSnapshot = {
+type PlayStaticSubstepMetadata = {
     conditional?: boolean;
+    dependsOnFields?: string[];
+    staleAfterSeconds?: number;
 };
-type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
+type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
     type: 'csv';
     field: string;
     path?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -90,22 +111,24 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     inputFields?: string[];
     rowKeyFields?: string[];
     outputFields?: string[];
-    columns?: PlayStaticDatasetColumnSnapshot[];
+    columns?: PlayStaticDatasetColumn[];
     waterfallIds?: string[];
-    steps?: PlayStaticSubstepSnapshot[];
-    sheetContract?: PlaySheetContractSnapshot | null;
+    steps?: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'tool';
     toolId: string;
     field: string;
+    paramsSource?: string;
+    sourceText?: string;
     description?: string;
     inLoop?: boolean;
     isEventWait?: boolean;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -124,16 +147,16 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
         paramsSource?: string;
     }>;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'step_suite';
     field: string;
-    steps: PlayStaticSubstepSnapshot[];
+    steps: PlayStaticSubstep[];
     returnSource?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -141,37 +164,40 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     playId: string;
     field: string;
     inLoop?: boolean;
-    pipeline?: PlayStaticPipelineSnapshot | null;
+    pipeline?: PlayStaticPipeline | null;
     cycleDetected?: boolean;
     resolutionError?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'control_flow';
     kind: 'conditional' | 'loop';
     field: string;
-    steps: PlayStaticSubstepSnapshot[];
+    steps: PlayStaticSubstep[];
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'run_javascript';
     alias: string;
+    sourceText?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'code';
     field: string;
+    sourceText?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 });
+
 type PlayCompilerDependencyManifest = {
     playName: string;
     /** Original source path for direct imported definePlay dependencies. */
@@ -179,7 +205,7 @@ type PlayCompilerDependencyManifest = {
     sourceHash: string;
     graphHash: string;
     artifactHash: string;
-    staticPipeline: PlayStaticPipelineSnapshot;
+    staticPipeline: PlayStaticPipeline;
 };
 type PlayCompilerManifest = {
     compilerVersion: number;
@@ -188,7 +214,7 @@ type PlayCompilerManifest = {
     graphHash: string;
     artifactHash: string;
     artifactKind?: PlayArtifactKind;
-    staticPipeline: PlayStaticPipelineSnapshot;
+    staticPipeline: PlayStaticPipeline;
     importedPlayDependencies: PlayCompilerDependencyManifest[];
 };
 

package/dist/index.d.ts

@@ -13,7 +13,17 @@ declare const PLAY_ARTIFACT_KINDS: {
 };
 type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
 
-interface PlayStaticPipelineSnapshot {
+/**
+ * A top-level key the play's function literally `return`s. Derived from the
+ * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
+ * so the "Returns" graph node mirrors the function's real output shape.
+ * `isDataset` is true when the key's value is a `PlayDataset` handle (a table).
+ */
+interface PlayStaticReturnField {
+    name: string;
+    isDataset: boolean;
+}
+interface PlayStaticPipeline {
     tableNamespace?: string;
     inputFields?: string[];
     rowKeyFields?: string[];
@@ -22,16 +32,22 @@ interface PlayStaticPipelineSnapshot {
     csvDescription?: string;
     datasetDescription?: string;
     fields: string[];
-    stages?: PlayStaticSubstepSnapshot[];
-    substeps: PlayStaticSubstepSnapshot[];
-    sheetContract?: PlaySheetContractSnapshot | null;
+    /**
+     * Top-level keys of the play's `return { ... }` object literal, in source
+     * order. Undefined when the terminal return isn't a statically-known object
+     * literal (bare value, dataset handle, conditional returns, etc.).
+     */
+    returnFields?: PlayStaticReturnField[];
+    stages?: PlayStaticSubstep[];
+    substeps: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
     sheetContractErrors?: string[];
 }
-type PlaySheetColumnSourceSnapshot = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
-interface PlaySheetColumnContractSnapshot {
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
     id: string;
     sqlName: string;
-    source: PlaySheetColumnSourceSnapshot;
+    source: PlaySheetColumnSource;
     field?: string;
     parentField?: string;
     playId?: string;
@@ -42,44 +58,49 @@ interface PlaySheetColumnContractSnapshot {
     toolId?: string;
     isRowKey?: boolean;
 }
-interface PlaySheetContractSnapshot {
+interface PlaySheetContract {
     tableNamespace: string;
-    columns: PlaySheetColumnContractSnapshot[];
+    columns: PlaySheetColumnContract[];
 }
-type PlayStaticColumnProducerKindSnapshot = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
-interface PlayStaticColumnProducerSnapshot {
+type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
+interface PlayStaticColumnProducer {
     id: string;
-    kind: PlayStaticColumnProducerKindSnapshot;
+    kind: PlayStaticColumnProducerKind;
     field: string;
     toolId?: string;
     playId?: string;
+    dependsOnFields?: string[];
+    staleAfterSeconds?: number;
     conditional?: boolean;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
-    steps?: PlayStaticColumnProducerSnapshot[];
-    substep: PlayStaticSubstepSnapshot;
+    sourceRange?: PlayStaticSourceRange;
+    steps?: PlayStaticColumnProducer[];
+    substep: PlayStaticSubstep;
 }
-interface PlayStaticDatasetColumnSnapshot {
+interface PlayStaticDatasetColumn {
     id: string;
-    source: PlaySheetColumnSourceSnapshot;
+    source: PlaySheetColumnSource;
     sqlName?: string;
-    producers: PlayStaticColumnProducerSnapshot[];
+    staleAfterSeconds?: number;
+    producers: PlayStaticColumnProducer[];
 }
-interface PlayStaticSourceRangeSnapshot {
+interface PlayStaticSourceRange {
     sourcePath?: string;
     startLine: number;
     endLine: number;
     startColumn: number;
     endColumn: number;
 }
-type PlayStaticSubstepMetadataSnapshot = {
+type PlayStaticSubstepMetadata = {
     conditional?: boolean;
+    dependsOnFields?: string[];
+    staleAfterSeconds?: number;
 };
-type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
+type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
     type: 'csv';
     field: string;
     path?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -90,22 +111,24 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     inputFields?: string[];
     rowKeyFields?: string[];
     outputFields?: string[];
-    columns?: PlayStaticDatasetColumnSnapshot[];
+    columns?: PlayStaticDatasetColumn[];
     waterfallIds?: string[];
-    steps?: PlayStaticSubstepSnapshot[];
-    sheetContract?: PlaySheetContractSnapshot | null;
+    steps?: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'tool';
     toolId: string;
     field: string;
+    paramsSource?: string;
+    sourceText?: string;
     description?: string;
     inLoop?: boolean;
     isEventWait?: boolean;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -124,16 +147,16 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
         paramsSource?: string;
     }>;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'step_suite';
     field: string;
-    steps: PlayStaticSubstepSnapshot[];
+    steps: PlayStaticSubstep[];
     returnSource?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
@@ -141,37 +164,40 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     playId: string;
     field: string;
     inLoop?: boolean;
-    pipeline?: PlayStaticPipelineSnapshot | null;
+    pipeline?: PlayStaticPipeline | null;
     cycleDetected?: boolean;
     resolutionError?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'control_flow';
     kind: 'conditional' | 'loop';
     field: string;
-    steps: PlayStaticSubstepSnapshot[];
+    steps: PlayStaticSubstep[];
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'run_javascript';
     alias: string;
+    sourceText?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 } | {
     type: 'code';
     field: string;
+    sourceText?: string;
     description?: string;
-    sourceRange?: PlayStaticSourceRangeSnapshot;
+    sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
     callPath?: string[];
 });
+
 type PlayCompilerDependencyManifest = {
     playName: string;
     /** Original source path for direct imported definePlay dependencies. */
@@ -179,7 +205,7 @@ type PlayCompilerDependencyManifest = {
     sourceHash: string;
     graphHash: string;
     artifactHash: string;
-    staticPipeline: PlayStaticPipelineSnapshot;
+    staticPipeline: PlayStaticPipeline;
 };
 type PlayCompilerManifest = {
     compilerVersion: number;
@@ -188,7 +214,7 @@ type PlayCompilerManifest = {
     graphHash: string;
     artifactHash: string;
     artifactKind?: PlayArtifactKind;
-    staticPipeline: PlayStaticPipelineSnapshot;
+    staticPipeline: PlayStaticPipeline;
     importedPlayDependencies: PlayCompilerDependencyManifest[];
 };
 

package/dist/index.js

@@ -246,10 +246,10 @@ var import_node_path2 = require("path");
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.88",
+  version: "0.1.89",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.88",
+    latest: "0.1.89",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/index.mjs

@@ -179,10 +179,10 @@ import { join as join2 } from "path";
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.88",
+  version: "0.1.89",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.88",
+    latest: "0.1.89",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

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

@@ -62,7 +62,7 @@ import {
 } from './child-play-await';
 import type { AnyBatchOperationStrategy } from '../../../shared_libs/play-runtime/batching-types';
 import {
-  adaptV2ExecuteResponseToToolResult,
+  parseToolExecuteResponse,
   createToolExecuteResult,
   deserializeToolExecuteResult,
   isSerializedToolExecuteResult,
@@ -1289,18 +1289,12 @@ async function callToolDirect(
     });
     if (res.ok) {
       const body = (await res.json()) as Record<string, unknown>;
-      const { result } = adaptV2ExecuteResponseToToolResult(body);
-      const status =
-        typeof body.status === 'string'
-          ? body.status
-          : result == null
-            ? 'no_result'
-            : 'completed';
+      const parsed = parseToolExecuteResponse(toolId, body);
       return wrapWorkerToolResult(
         toolId,
-        result,
-        parseExecuteToolMetadata(toolId, body),
-        status,
+        parsed.result,
+        parsed.metadata,
+        parsed.status,
       );
     }
 
@@ -1338,121 +1332,6 @@ async function callToolDirect(
   throw lastError ?? new Error(`tool ${toolId} failed before execution.`);
 }
 
-function parseExecuteToolMetadata(
-  toolId: string,
-  data: Record<string, unknown>,
-): ToolResultMetadataInput | null {
-  const metadata = data._metadata;
-  if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
-    return null;
-  }
-  const tool = (metadata as Record<string, unknown>).tool;
-  if (!tool || typeof tool !== 'object' || Array.isArray(tool)) return null;
-  const record = tool as Record<string, unknown>;
-  const metadataToolId =
-    typeof record.toolId === 'string' && record.toolId.trim()
-      ? record.toolId.trim()
-      : toolId;
-  return {
-    toolId: metadataToolId,
-    extractors: parseExtractorMetadata(record.extractors),
-    targetGetters: parseGetterMetadata(record.targetGetters),
-    listExtractorPaths: parseStringArray(record.listExtractorPaths),
-    listIdentityGetters: parseGetterMetadata(record.listIdentityGetters),
-  };
-}
-
-function parseExtractorMetadata(
-  value: unknown,
-): ToolResultMetadataInput['extractors'] {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return undefined;
-  }
-  const entries = Object.entries(value as Record<string, unknown>).flatMap(
-    ([key, descriptor]) => {
-      if (
-        !descriptor ||
-        typeof descriptor !== 'object' ||
-        Array.isArray(descriptor)
-      ) {
-        return [];
-      }
-      const record = descriptor as Record<string, unknown>;
-      const paths = parseStringArray(record.paths);
-      if (paths.length === 0) return [];
-      const transforms = parseStringArray(record.transforms);
-      const enumValues = parseStringArray(record.enum);
-      const overrides = parseExtractorOverrides(record.overrides);
-      return [
-        [
-          key,
-          {
-            paths,
-            ...(transforms.length > 0 ? { transforms } : {}),
-            ...(enumValues.length > 0 ? { enum: enumValues } : {}),
-            ...(overrides.length > 0 ? { overrides } : {}),
-          },
-        ],
-      ] as const;
-    },
-  );
-  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-
-function parseExtractorOverrides(
-  value: unknown,
-): NonNullable<
-  NonNullable<ToolResultMetadataInput['extractors']>[string]['overrides']
-> {
-  if (!Array.isArray(value)) return [];
-  return value.flatMap((entry) => {
-    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
-      return [];
-    }
-    const record = entry as Record<string, unknown>;
-    const paths = parseStringArray(record.paths);
-    if (paths.length === 0) return [];
-    const equals =
-      record.equals === null ||
-      typeof record.equals === 'string' ||
-      typeof record.equals === 'number' ||
-      typeof record.equals === 'boolean'
-        ? record.equals
-        : true;
-    const overrideValue = record.value;
-    if (
-      overrideValue !== null &&
-      typeof overrideValue !== 'string' &&
-      typeof overrideValue !== 'number' &&
-      typeof overrideValue !== 'boolean'
-    ) {
-      return [];
-    }
-    return [{ paths, equals, value: overrideValue }];
-  });
-}
-
-function parseGetterMetadata(
-  value: unknown,
-): Record<string, readonly string[]> | undefined {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return undefined;
-  }
-  const entries = Object.entries(value as Record<string, unknown>)
-    .map(([key, paths]) => [key, parseStringArray(paths)] as const)
-    .filter(
-      (entry): entry is readonly [string, string[]] => entry[1].length > 0,
-    );
-  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-
-function parseStringArray(value: unknown): string[] {
-  if (!Array.isArray(value)) return [];
-  return value
-    .map((entry) => (typeof entry === 'string' ? entry.trim() : ''))
-    .filter(Boolean);
-}
-
 function toolMetadataFallback(toolId: string): ToolResultMetadataInput {
   if (toolId === 'test_rate_limit') {
     return {
@@ -2956,42 +2835,71 @@ function augmentSheetContractWithDatasetFields(input: {
   outputFields?: readonly string[];
 }): PlaySheetContract {
   const outputFields = new Set(input.outputFields ?? []);
-  const existingFields = new Set(
-    input.contract.columns.flatMap((column) =>
-      typeof column.field === 'string' ? [column.field] : [],
-    ),
-  );
-  const existingSqlNames = new Set(
-    input.contract.columns.map((column) => column.sqlName),
-  );
-  const columns = [...input.contract.columns];
   const candidateFields = new Set<string>();
   for (const row of input.rows) {
     for (const field of Object.keys(row)) {
-      candidateFields.add(field);
+      if (isDatasetPayloadField(field)) {
+        candidateFields.add(field);
+      }
     }
   }
   for (const field of outputFields) {
-    candidateFields.add(field);
-  }
-  for (const field of candidateFields) {
-    if (!isDatasetPayloadField(field) || existingFields.has(field)) {
-      continue;
+    if (isDatasetPayloadField(field)) {
+      candidateFields.add(field);
     }
-    const sqlName = sqlSafePlayColumnName(field);
-    if (existingSqlNames.has(sqlName)) {
-      continue;
+  }
+
+  const existingFields = new Set<string>();
+  const existingSqlNames = new Set<string>();
+  const inputColumns: PlaySheetContract['columns'] = [];
+  const outputColumns: PlaySheetContract['columns'] = [];
+  const appendColumn = (
+    target: PlaySheetContract['columns'],
+    column: PlaySheetContract['columns'][number],
+  ) => {
+    const field = typeof column.field === 'string' ? column.field : column.id;
+    const sqlName = column.sqlName.trim();
+    if (
+      !field ||
+      !sqlName ||
+      existingFields.has(field) ||
+      existingSqlNames.has(sqlName)
+    ) {
+      return;
     }
     existingFields.add(field);
     existingSqlNames.add(sqlName);
-    columns.push({
+    target.push(column);
+  };
+
+  for (const column of input.contract.columns) {
+    const field = typeof column.field === 'string' ? column.field : column.id;
+    if (
+      column.source === 'input' &&
+      field === input.contract.tableNamespace &&
+      !candidateFields.has(field)
+    ) {
+      continue;
+    }
+    appendColumn(
+      column.source === 'input' ? inputColumns : outputColumns,
+      column,
+    );
+  }
+
+  for (const field of candidateFields) {
+    if (existingFields.has(field)) continue;
+    const sqlName = sqlSafePlayColumnName(field);
+    if (existingSqlNames.has(sqlName)) continue;
+    appendColumn(outputFields.has(field) ? outputColumns : inputColumns, {
       id: `runtime:${input.contract.tableNamespace}:${field}`,
       sqlName,
       source: outputFields.has(field) ? 'datasetColumn' : 'input',
       field,
     });
   }
-  return { ...input.contract, columns };
+
+  return { ...input.contract, columns: [...inputColumns, ...outputColumns] };
 }
 
 async function persistCompletedMapRows(input: {

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

@@ -50,10 +50,10 @@ export type SdkRelease = {
 };
 
 export const SDK_RELEASE = {
-  version: '0.1.88',
+  version: '0.1.89',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.88',
+    latest: '0.1.89',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
   },

package/dist/repo/shared_libs/play-runtime/tool-result.ts

@@ -17,7 +17,10 @@ export type {
   EmailStatusVerdict,
 } from './email-status';
 
-import { buildEmailStatus } from './email-status';
+import {
+  buildEmailStatus,
+  type EmailStatusExtractorConfig,
+} from './email-status';
 import {
   JOB_CHANGE_STATUS_VALUES,
   type JobChangeGetterValue,
@@ -56,12 +59,12 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
 
-export type V2ToolExecuteOutput = {
+type V2ToolExecuteOutput = {
   raw: unknown;
   meta?: Record<string, unknown>;
 };
 
-export function parseV2ToolExecuteOutput(
+function parseV2ToolExecuteOutput(
   data: Record<string, unknown>,
 ): V2ToolExecuteOutput | null {
   const toolResponse = data.toolResponse;
@@ -77,9 +80,10 @@ export function parseV2ToolExecuteOutput(
   return null;
 }
 
-export function adaptV2ExecuteResponseToToolResult(
-  data: Record<string, unknown>,
-): { output?: V2ToolExecuteOutput; result: unknown } {
+function adaptV2ExecuteResponseToToolResult(data: Record<string, unknown>): {
+  output?: V2ToolExecuteOutput;
+  result: unknown;
+} {
   const output = parseV2ToolExecuteOutput(data);
   if (!output) {
     return { result: data.result ?? data };
@@ -93,7 +97,195 @@ export function adaptV2ExecuteResponseToToolResult(
   };
 }
 
-export function toV2RawToolOutputPath(path: string): string {
+/**
+ * Parsed view of a raw `/api/v2/integrations/:toolId/execute` JSON body.
+ *
+ * This is the single runtime-side seam from a V2 execute response to the
+ * inputs of {@link createToolExecuteResult}. Both runner substrates (the
+ * in-process cjs runtime in `shared_libs/play-runtime/context.ts` and the
+ * Workers runtime in `apps/play-runner-workers`) must go through
+ * {@link parseToolExecuteResponse}; the intermediate envelope shapes
+ * (`toolResponse` adaptation, `_metadata.tool` parsing, status derivation)
+ * are private to this module.
+ *
+ * Boundary note: provider-specific redaction (wiza/apify/bettercontact billing
+ * fields) happens server-side in
+ * `src/lib/integrations/execute-result-normalization.ts` BEFORE the response
+ * leaves the API. This module only ever sees the already-redacted public
+ * response — do not move redaction here, it would leak provider internals
+ * into the shared runtime bundles.
+ */
+export type ParsedToolExecuteResponse = {
+  status: string;
+  jobId?: string;
+  meta?: Record<string, unknown>;
+  toolResponse?: {
+    raw?: unknown;
+    meta?: Record<string, unknown>;
+  };
+  /** Legacy `{ data, meta }` envelope consumed by createToolExecuteResult. */
+  result: unknown;
+  /** Tool extractor metadata parsed from `_metadata.tool`, if present. */
+  metadata: ToolResultMetadataInput | null;
+};
+
+export function parseToolExecuteResponse(
+  toolId: string,
+  body: Record<string, unknown>,
+): ParsedToolExecuteResponse {
+  const { result } = adaptV2ExecuteResponseToToolResult(body);
+  const status =
+    typeof body.status === 'string'
+      ? body.status
+      : result == null
+        ? 'no_result'
+        : 'completed';
+  return {
+    status,
+    jobId: typeof body.job_id === 'string' ? body.job_id : undefined,
+    meta: isRecord(body.meta) ? body.meta : undefined,
+    toolResponse: isRecord(body.toolResponse)
+      ? (body.toolResponse as ParsedToolExecuteResponse['toolResponse'])
+      : undefined,
+    result,
+    metadata: parseExecuteToolMetadata(toolId, body),
+  };
+}
+
+function parseExecuteToolMetadata(
+  toolId: string,
+  data: Record<string, unknown>,
+): ToolResultMetadataInput | null {
+  const metadata = data._metadata;
+  if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+    return null;
+  }
+  const tool = (metadata as Record<string, unknown>).tool;
+  if (!tool || typeof tool !== 'object' || Array.isArray(tool)) return null;
+  const record = tool as Record<string, unknown>;
+  const metadataToolId =
+    typeof record.toolId === 'string' && record.toolId.trim()
+      ? record.toolId
+      : toolId;
+  const readGetters = (value: unknown): Record<string, readonly string[]> => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
+    return Object.fromEntries(
+      Object.entries(value as Record<string, unknown>).flatMap(
+        ([key, paths]) => {
+          if (!Array.isArray(paths)) return [];
+          const normalized = paths.filter(
+            (path): path is string =>
+              typeof path === 'string' && path.trim().length > 0,
+          );
+          return normalized.length > 0 ? [[key, normalized]] : [];
+        },
+      ),
+    );
+  };
+  const readExtractors = (
+    value: unknown,
+  ): ToolResultMetadataInput['extractors'] => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
+    return Object.fromEntries(
+      Object.entries(value as Record<string, unknown>).flatMap(
+        ([key, entry]) => {
+          if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+            return [];
+          const recordEntry = entry as Record<string, unknown>;
+          if (!Array.isArray(recordEntry.paths)) return [];
+          const paths = recordEntry.paths.filter(
+            (path): path is string =>
+              typeof path === 'string' && path.trim().length > 0,
+          );
+          if (paths.length === 0) return [];
+          const overrides = Array.isArray(recordEntry.overrides)
+            ? recordEntry.overrides.flatMap((override) => {
+                if (
+                  !override ||
+                  typeof override !== 'object' ||
+                  Array.isArray(override)
+                ) {
+                  return [];
+                }
+                const overrideRecord = override as Record<string, unknown>;
+                const overridePaths = Array.isArray(overrideRecord.paths)
+                  ? overrideRecord.paths.filter(
+                      (path): path is string =>
+                        typeof path === 'string' && path.trim().length > 0,
+                    )
+                  : [];
+                if (overridePaths.length === 0) return [];
+                const readOverridePrimitive = (
+                  candidate: unknown,
+                ): string | number | boolean | null | undefined => {
+                  if (candidate === null) return null;
+                  if (typeof candidate === 'string') return candidate;
+                  if (typeof candidate === 'number') return candidate;
+                  if (typeof candidate === 'boolean') return candidate;
+                  return undefined;
+                };
+                const value = readOverridePrimitive(overrideRecord.value);
+                if (value === undefined) {
+                  return [];
+                }
+                const equals: string | number | boolean | null =
+                  readOverridePrimitive(overrideRecord.equals) ?? true;
+                return [{ paths: overridePaths, equals, value }];
+              })
+            : [];
+          const emailStatus =
+            recordEntry.emailStatus &&
+            typeof recordEntry.emailStatus === 'object' &&
+            !Array.isArray(recordEntry.emailStatus)
+              ? (recordEntry.emailStatus as EmailStatusExtractorConfig)
+              : undefined;
+          return [
+            [
+              key,
+              {
+                paths,
+                ...(Array.isArray(recordEntry.transforms)
+                  ? {
+                      transforms: recordEntry.transforms.filter(
+                        (transform): transform is string =>
+                          typeof transform === 'string' &&
+                          transform.trim().length > 0,
+                      ),
+                    }
+                  : {}),
+                ...(Array.isArray(recordEntry.enum)
+                  ? {
+                      enum: recordEntry.enum.filter(
+                        (value): value is string =>
+                          typeof value === 'string' && value.trim().length > 0,
+                      ),
+                    }
+                  : {}),
+                ...(overrides.length > 0 ? { overrides } : {}),
+                ...(emailStatus ? { emailStatus } : {}),
+              },
+            ],
+          ];
+        },
+      ),
+    );
+  };
+  const listExtractorPaths = Array.isArray(record.listExtractorPaths)
+    ? record.listExtractorPaths.filter(
+        (path): path is string =>
+          typeof path === 'string' && path.trim().length > 0,
+      )
+    : [];
+  return {
+    toolId: metadataToolId,
+    extractors: readExtractors(record.extractors),
+    targetGetters: readGetters(record.targetGetters),
+    listExtractorPaths,
+    listIdentityGetters: readGetters(record.listIdentityGetters),
+  };
+}
+
+function toV2RawToolOutputPath(path: string): string {
   const normalized = String(path || '')
     .trim()
     .replace(/^\./, '');
@@ -445,9 +637,7 @@ function normalizeJobChangeStatus(value: unknown): unknown {
   if (['false', 'no', 'same', 'no_change'].includes(normalized))
     return 'no_change';
   if (['left', 'left_company'].includes(normalized)) return 'left_company';
-  if (
-    (JOB_CHANGE_STATUS_VALUES as readonly string[]).includes(normalized)
-  ) {
+  if ((JOB_CHANGE_STATUS_VALUES as readonly string[]).includes(normalized)) {
     return normalized;
   }
   return 'unknown';
@@ -481,12 +671,12 @@ function normalizeJobChange(value: unknown): JobChangeGetterValue {
   return {
     status,
     date: moved
-      ? normalizeString(
+      ? (normalizeString(
           output.date ??
             output.job_change_date ??
             output.change_date ??
             output.changed_at,
-        ) ?? firstExperienceDate(person.experiences)
+        ) ?? firstExperienceDate(person.experiences))
       : null,
     new_company: moved
       ? normalizeString(

package/dist/repo/shared_libs/plays/row-identity.ts

@@ -169,19 +169,25 @@ export function normalizePlayName(value: string): string {
   return validateIdentifierPart(value, 'Play name', PLAY_NAME_MAX_LENGTH);
 }
 
+/**
+ * Normalize a play name into the leading segment of a physical sheet table name.
+ *
+ * A qualified reference like "prebuilt/name-and-domain-to-email-waterfall" folds
+ * its namespace separator into a plain identifier
+ * ("prebuilt_name_and_domain_to_email_waterfall") so the physical table reads
+ * cleanly. `validatePlaySheetTableName` enforces the 63-char Postgres identifier
+ * limit on the play + namespace combination and fails loudly when a name is
+ * genuinely too long — no opaque content digest is mixed into the table name.
+ */
 export function normalizePlayNameForSheet(value: string): string {
   if (!value.includes('/')) {
     return normalizePlayName(value);
   }
-  const digest = sha256Hex(value).slice(0, 12);
-  const normalizedReference = sanitizeIdentifierPart(
-    value.replace(/\//g, '__'),
+  return validateIdentifierPart(
+    value.replace(/\//g, '_'),
+    'Play name',
+    PLAY_NAME_MAX_LENGTH,
   );
-  const prefixLength = Math.max(1, PLAY_NAME_MAX_LENGTH - digest.length - 1);
-  const prefix =
-    normalizedReference.slice(0, prefixLength).replace(/_+$/g, '') ||
-    'qualified_play';
-  return `${prefix}_${digest}`;
 }
 
 export function normalizeTableNamespace(value: string): string {

package/package.json

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