deepline 0.3.228 → 0.3.230

package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts

@@ -1,5 +1,15 @@
 import { normalizeTableNamespace } from './row-identity';
 import { sqlSafePlayColumnName } from '../play-data-plane/column-names';
+import type {
+  PlaySheetColumnSource,
+  PlaySheetColumnContract,
+  PlaySheetContract,
+} from '../play-data-plane/contracts';
+export type {
+  PlaySheetColumnSource,
+  PlaySheetColumnContract,
+  PlaySheetContract,
+} from '../play-data-plane/contracts';
 import type { PlayDocflow } from './docflow';
 
 export { sqlSafePlayColumnName };
@@ -144,32 +154,6 @@ export function deriveStaticPipelineEntryInputFields(
     : dedupeStaticFieldNames(pipeline.inputFields ?? []);
 }
 
-export type PlaySheetColumnSource =
-  | 'input'
-  | 'datasetColumn'
-  | 'waterfallStep'
-  | 'childPlayColumn';
-
-export interface PlaySheetColumnContract {
-  id: string;
-  sqlName: string;
-  source: PlaySheetColumnSource;
-  field?: string;
-  parentField?: string;
-  playId?: string;
-  waterfallId?: string;
-  outputField?: string;
-  outputSqlName?: string;
-  stepId?: string;
-  toolId?: string;
-  isRowKey?: boolean;
-}
-
-export interface PlaySheetContract {
-  tableNamespace: string;
-  columns: PlaySheetColumnContract[];
-}
-
 export type PlayStaticColumnProducerKind =
   | 'tool'
   | 'waterfall'
@@ -339,13 +323,15 @@ function truncateStaticControlFlowBranchesForStorage(
     maxEmbeddedPlayCallPipelineDepth: number;
     maxStoredSubstepDepth: number;
     storedSubstepDepth: number;
+    preserveAdditiveMetadata: boolean;
   },
 ): PlayStaticControlFlowBranch[] | undefined {
   if (!branches) return undefined;
   return branches.map((branch) =>
     omitUndefinedProperties({
-      label: branch.label,
-      condition: branch.condition,
+      ...(input.preserveAdditiveMetadata
+        ? branch
+        : { label: branch.label, condition: branch.condition }),
       steps: truncateStaticSubstepsForStorage(
         branch.steps,
         nextStoredSubstepInput(input),
@@ -359,6 +345,7 @@ function nextStoredSubstepInput(input: {
   maxEmbeddedPlayCallPipelineDepth: number;
   maxStoredSubstepDepth: number;
   storedSubstepDepth: number;
+  preserveAdditiveMetadata: boolean;
 }) {
   return {
     ...input,
@@ -392,6 +379,7 @@ function truncateStaticSubstepsForStorage(
     maxEmbeddedPlayCallPipelineDepth: number;
     maxStoredSubstepDepth: number;
     storedSubstepDepth: number;
+    preserveAdditiveMetadata: boolean;
   },
 ): PlayStaticSubstep[] {
   return (substeps ?? []).map((substep) => {
@@ -431,6 +419,7 @@ function truncateStaticSubstepsForStorage(
                 input.embeddedPlayCallPipelineDepth + 1,
               maxStoredSubstepDepth: input.maxStoredSubstepDepth,
               storedSubstepDepth: input.storedSubstepDepth + 1,
+              preserveAdditiveMetadata: input.preserveAdditiveMetadata,
             })
           : nestedPipeline;
     }
@@ -479,9 +468,9 @@ function truncateStaticSubstepsForStorage(
         ...base,
         steps: base.steps?.map((step) =>
           omitUndefinedProperties({
-            id: step.id,
-            kind: step.kind,
-            toolId: step.toolId,
+            ...(input.preserveAdditiveMetadata
+              ? step
+              : { id: step.id, kind: step.kind, toolId: step.toolId }),
           }),
         ),
       });
@@ -551,6 +540,7 @@ function truncateStaticSubstepsForStorage(
         embeddedPlayCallPipelineDepth: input.embeddedPlayCallPipelineDepth + 1,
         maxStoredSubstepDepth: input.maxStoredSubstepDepth,
         storedSubstepDepth: input.storedSubstepDepth + 1,
+        preserveAdditiveMetadata: input.preserveAdditiveMetadata,
       }),
     });
   });
@@ -563,6 +553,8 @@ export function truncateStaticPipelineForStorage(
     embeddedPlayCallPipelineDepth?: number;
     maxStoredSubstepDepth?: number;
     storedSubstepDepth?: number;
+    /** Keep retained additive metadata only in the full runtime contract. */
+    preserveAdditiveMetadata?: boolean;
   } = {},
 ): PlayStaticPipeline | null | undefined {
   if (!pipeline) {
@@ -576,6 +568,7 @@ export function truncateStaticPipelineForStorage(
   const maxStoredSubstepDepth =
     options.maxStoredSubstepDepth ?? DEFAULT_MAX_STORED_SUBSTEP_DEPTH;
   const storedSubstepDepth = options.storedSubstepDepth ?? 0;
+  const preserveAdditiveMetadata = options.preserveAdditiveMetadata ?? false;
 
   return stripUndefinedDeep(
     omitUndefinedProperties({
@@ -593,12 +586,14 @@ export function truncateStaticPipelineForStorage(
         maxEmbeddedPlayCallPipelineDepth,
         maxStoredSubstepDepth,
         storedSubstepDepth,
+        preserveAdditiveMetadata,
       }),
       substeps: truncateStaticSubstepsForStorage(pipeline.substeps, {
         embeddedPlayCallPipelineDepth,
         maxEmbeddedPlayCallPipelineDepth,
         maxStoredSubstepDepth,
         storedSubstepDepth,
+        preserveAdditiveMetadata,
       }),
       sheetContract: cloneStorageSafeSheetContract(pipeline.sheetContract),
       sheetContractErrors: pipeline.sheetContractErrors
@@ -615,6 +610,8 @@ export function truncateStaticPipelineForRuntimeContract(
     // Runtime admission must preserve every dataset contract. The caller's
     // serialized artifact-size budget is the bound; a UI depth cap is not.
     maxStoredSubstepDepth: Number.POSITIVE_INFINITY,
+    maxEmbeddedPlayCallPipelineDepth: Number.POSITIVE_INFINITY,
+    preserveAdditiveMetadata: true,
   });
 }
 

package/dist/cli/index.js

@@ -3051,7 +3051,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.228",
+  version: "0.3.230",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5384,12 +5384,84 @@ function normalizeDatasetBornFrom(value) {
 
 // ../play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "cancelled",
+  "terminated",
+  "timed_out"
+]);
 function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function nonnegativeSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isWorkCounterSegmentId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function normalizePlayRunLedgerTerminalWorkCounterSegment(value) {
+  if (!isRecord5(value)) return void 0;
+  if (!nonnegativeSafeInteger(value.attempt) || !nonnegativeSafeInteger(value.invocationSeq) || value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId)) {
+    return void 0;
+  }
+  return {
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId
+  };
+}
+function hasConfirmedPlayRunLedgerWorkCounters(snapshot) {
+  const counters = snapshot.workCounters;
+  const terminal = snapshot.terminalWorkCounterSegment;
+  return Boolean(
+    isTerminalPlayRunLedgerStatus(snapshot.status) && (snapshot.terminalSource === "worker" || snapshot.terminalSource === "system") && counters?.final && counters.completeThroughAttempt && counters.consistent && terminal && counters.attempt === terminal.attempt && counters.invocationSeq === terminal.invocationSeq && counters.segmentId === terminal.segmentId && Number.isSafeInteger(
+      counters.completedLogicalCalls + counters.logicalCalls
+    ) && Number.isSafeInteger(
+      counters.completedProviderRequests + counters.providerRequests
+    ) && Number.isSafeInteger(
+      counters.completedProvider429s + counters.provider429s
+    )
+  );
+}
+function normalizeWorkCounters(value) {
+  if (!isRecord5(value)) return void 0;
+  for (const field of [
+    "attempt",
+    "invocationSeq",
+    "logicalCalls",
+    "providerRequests",
+    "provider429s",
+    "completedLogicalCalls",
+    "completedProviderRequests",
+    "completedProvider429s"
+  ]) {
+    if (!nonnegativeSafeInteger(value[field])) return void 0;
+  }
+  if (value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId) || typeof value.final !== "boolean" || typeof value.completeThroughAttempt !== "boolean" || typeof value.consistent !== "boolean") {
+    return void 0;
+  }
+  return {
+    ...value,
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId,
+    logicalCalls: value.logicalCalls,
+    providerRequests: value.providerRequests,
+    provider429s: value.provider429s,
+    final: value.final,
+    completedLogicalCalls: value.completedLogicalCalls,
+    completedProviderRequests: value.completedProviderRequests,
+    completedProvider429s: value.completedProvider429s,
+    completeThroughAttempt: value.completeThroughAttempt,
+    consistent: value.consistent
+  };
+}
 function optionalFiniteNumber(value) {
   const normalized = finiteNumber(value);
   return normalized === null ? void 0 : normalized;
@@ -5431,6 +5503,9 @@ function normalizePlayRunLedgerStatus(value) {
       return "unknown";
   }
 }
+function isTerminalPlayRunLedgerStatus(status) {
+  return TERMINAL_STATUSES.has(status);
+}
 function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
@@ -5565,6 +5640,10 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
   const error = Object.prototype.hasOwnProperty.call(value, "error") ? optionalNullableString(value.error) ?? null : fallback.error ?? null;
   const rawTail = Array.isArray(value.logTail) ? value.logTail : value.logs;
   const logTail = Array.isArray(rawTail) ? rawTail.filter((line) => typeof line === "string") : [];
+  const workCounters = normalizeWorkCounters(value.workCounters);
+  const terminalWorkCounterSegment = normalizePlayRunLedgerTerminalWorkCounterSegment(
+    value.terminalWorkCounterSegment
+  );
   return {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
@@ -5587,6 +5666,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       (activityId) => typeof activityId === "string" && Boolean(activitiesById[activityId])
     ),
     activitiesById,
+    ...workCounters ? { workCounters } : {},
+    ...terminalWorkCounterSegment ? { terminalWorkCounterSegment } : {},
     logTail: logTail.slice(-LOG_TAIL_LIMIT),
     // Snapshots persisted before totalLogCount existed only know the retained
     // tail, so the best lower bound for the cumulative count is the tail size.
@@ -5894,6 +5975,13 @@ function buildSnapshotFromLedger(snapshot) {
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
   const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
   const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
+  const workCounters = snapshot.workCounters;
+  const calls = workCounters ? {
+    logicalCalls: workCounters.completedLogicalCalls + workCounters.logicalCalls,
+    providerRequests: workCounters.completedProviderRequests + workCounters.providerRequests,
+    provider429s: workCounters.completedProvider429s + workCounters.provider429s,
+    confirmed: isTerminalPlayRunLiveStatus(liveStatus) && hasConfirmedPlayRunLedgerWorkCounters(snapshot)
+  } : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -5918,7 +6006,10 @@ function buildSnapshotFromLedger(snapshot) {
     activeActivity: snapshot.activeActivityId ? snapshot.activitiesById[snapshot.activeActivityId] ?? null : null,
     nodeStates,
     activeNodeId: snapshot.activeStepId ?? null,
-    ...rowOutcomes ? { rowOutcomes } : {}
+    ...rowOutcomes ? { rowOutcomes } : {},
+    ...calls && Object.values(calls).every(
+      (value) => typeof value === "boolean" || Number.isSafeInteger(value)
+    ) ? { calls } : {}
   };
 }
 function buildPlayRunStatusSnapshot(input2) {
@@ -25044,6 +25135,15 @@ function getProgressLinesFromLiveEvent(event) {
       `progress ${formatProgressLabel(record3.nodeId ?? progress.artifactTableNamespace)}: ${counts}${messageSuffix}`
     );
   }
+  const calls = readRecord(payload.calls);
+  const callCounts = calls ? [calls.logicalCalls, calls.providerRequests, calls.provider429s] : [];
+  if (callCounts.length === 3 && callCounts.every(
+    (count) => typeof count === "number" && Number.isSafeInteger(count) && count >= 0
+  )) {
+    lines.push(
+      `progress calls: ${formatInteger(callCounts[0])} logical, ${formatInteger(callCounts[1])} provider requests, ${formatInteger(callCounts[2])} provider 429s${calls?.confirmed === true ? "" : " (observed)"}`
+    );
+  }
   const rowOutcomes = readRowOutcomeSummary({
     rowOutcomes: payload.rowOutcomes
   });

package/dist/cli/index.mjs

@@ -3046,7 +3046,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.228",
+  version: "0.3.230",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5379,12 +5379,84 @@ function normalizeDatasetBornFrom(value) {
 
 // ../play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "cancelled",
+  "terminated",
+  "timed_out"
+]);
 function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function nonnegativeSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isWorkCounterSegmentId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function normalizePlayRunLedgerTerminalWorkCounterSegment(value) {
+  if (!isRecord5(value)) return void 0;
+  if (!nonnegativeSafeInteger(value.attempt) || !nonnegativeSafeInteger(value.invocationSeq) || value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId)) {
+    return void 0;
+  }
+  return {
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId
+  };
+}
+function hasConfirmedPlayRunLedgerWorkCounters(snapshot) {
+  const counters = snapshot.workCounters;
+  const terminal = snapshot.terminalWorkCounterSegment;
+  return Boolean(
+    isTerminalPlayRunLedgerStatus(snapshot.status) && (snapshot.terminalSource === "worker" || snapshot.terminalSource === "system") && counters?.final && counters.completeThroughAttempt && counters.consistent && terminal && counters.attempt === terminal.attempt && counters.invocationSeq === terminal.invocationSeq && counters.segmentId === terminal.segmentId && Number.isSafeInteger(
+      counters.completedLogicalCalls + counters.logicalCalls
+    ) && Number.isSafeInteger(
+      counters.completedProviderRequests + counters.providerRequests
+    ) && Number.isSafeInteger(
+      counters.completedProvider429s + counters.provider429s
+    )
+  );
+}
+function normalizeWorkCounters(value) {
+  if (!isRecord5(value)) return void 0;
+  for (const field of [
+    "attempt",
+    "invocationSeq",
+    "logicalCalls",
+    "providerRequests",
+    "provider429s",
+    "completedLogicalCalls",
+    "completedProviderRequests",
+    "completedProvider429s"
+  ]) {
+    if (!nonnegativeSafeInteger(value[field])) return void 0;
+  }
+  if (value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId) || typeof value.final !== "boolean" || typeof value.completeThroughAttempt !== "boolean" || typeof value.consistent !== "boolean") {
+    return void 0;
+  }
+  return {
+    ...value,
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId,
+    logicalCalls: value.logicalCalls,
+    providerRequests: value.providerRequests,
+    provider429s: value.provider429s,
+    final: value.final,
+    completedLogicalCalls: value.completedLogicalCalls,
+    completedProviderRequests: value.completedProviderRequests,
+    completedProvider429s: value.completedProvider429s,
+    completeThroughAttempt: value.completeThroughAttempt,
+    consistent: value.consistent
+  };
+}
 function optionalFiniteNumber(value) {
   const normalized = finiteNumber(value);
   return normalized === null ? void 0 : normalized;
@@ -5426,6 +5498,9 @@ function normalizePlayRunLedgerStatus(value) {
       return "unknown";
   }
 }
+function isTerminalPlayRunLedgerStatus(status) {
+  return TERMINAL_STATUSES.has(status);
+}
 function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
@@ -5560,6 +5635,10 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
   const error = Object.prototype.hasOwnProperty.call(value, "error") ? optionalNullableString(value.error) ?? null : fallback.error ?? null;
   const rawTail = Array.isArray(value.logTail) ? value.logTail : value.logs;
   const logTail = Array.isArray(rawTail) ? rawTail.filter((line) => typeof line === "string") : [];
+  const workCounters = normalizeWorkCounters(value.workCounters);
+  const terminalWorkCounterSegment = normalizePlayRunLedgerTerminalWorkCounterSegment(
+    value.terminalWorkCounterSegment
+  );
   return {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
@@ -5582,6 +5661,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       (activityId) => typeof activityId === "string" && Boolean(activitiesById[activityId])
     ),
     activitiesById,
+    ...workCounters ? { workCounters } : {},
+    ...terminalWorkCounterSegment ? { terminalWorkCounterSegment } : {},
     logTail: logTail.slice(-LOG_TAIL_LIMIT),
     // Snapshots persisted before totalLogCount existed only know the retained
     // tail, so the best lower bound for the cumulative count is the tail size.
@@ -5889,6 +5970,13 @@ function buildSnapshotFromLedger(snapshot) {
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
   const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
   const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
+  const workCounters = snapshot.workCounters;
+  const calls = workCounters ? {
+    logicalCalls: workCounters.completedLogicalCalls + workCounters.logicalCalls,
+    providerRequests: workCounters.completedProviderRequests + workCounters.providerRequests,
+    provider429s: workCounters.completedProvider429s + workCounters.provider429s,
+    confirmed: isTerminalPlayRunLiveStatus(liveStatus) && hasConfirmedPlayRunLedgerWorkCounters(snapshot)
+  } : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -5913,7 +6001,10 @@ function buildSnapshotFromLedger(snapshot) {
     activeActivity: snapshot.activeActivityId ? snapshot.activitiesById[snapshot.activeActivityId] ?? null : null,
     nodeStates,
     activeNodeId: snapshot.activeStepId ?? null,
-    ...rowOutcomes ? { rowOutcomes } : {}
+    ...rowOutcomes ? { rowOutcomes } : {},
+    ...calls && Object.values(calls).every(
+      (value) => typeof value === "boolean" || Number.isSafeInteger(value)
+    ) ? { calls } : {}
   };
 }
 function buildPlayRunStatusSnapshot(input2) {
@@ -25117,6 +25208,15 @@ function getProgressLinesFromLiveEvent(event) {
       `progress ${formatProgressLabel(record3.nodeId ?? progress.artifactTableNamespace)}: ${counts}${messageSuffix}`
     );
   }
+  const calls = readRecord(payload.calls);
+  const callCounts = calls ? [calls.logicalCalls, calls.providerRequests, calls.provider429s] : [];
+  if (callCounts.length === 3 && callCounts.every(
+    (count) => typeof count === "number" && Number.isSafeInteger(count) && count >= 0
+  )) {
+    lines.push(
+      `progress calls: ${formatInteger(callCounts[0])} logical, ${formatInteger(callCounts[1])} provider requests, ${formatInteger(callCounts[2])} provider 429s${calls?.confirmed === true ? "" : " (observed)"}`
+    );
+  }
   const rowOutcomes = readRowOutcomeSummary({
     rowOutcomes: payload.rowOutcomes
   });

package/dist/{compiler-manifest-Dpd2hEet.d.mts → compiler-manifest-n8ZtPv2h.d.mts}

@@ -220,6 +220,33 @@ interface PlayR2FileRef {
 }
 type PlayExecutionFileRef = PlayR2FileRef;
 
+/** Source evidence is advisory; stored values determine lossless SQL encoding. */
+interface PlayDatasetColumnTypeEvidence {
+    postgresTypeId: number;
+    valueType: 'boolean' | 'number' | 'string' | 'json';
+}
+type PlayDatasetColumnTypes = Record<string, PlayDatasetColumnTypeEvidence>;
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
+    id: string;
+    sqlName: string;
+    source: PlaySheetColumnSource;
+    field?: string;
+    parentField?: string;
+    playId?: string;
+    waterfallId?: string;
+    outputField?: string;
+    outputSqlName?: string;
+    stepId?: string;
+    toolId?: string;
+    isRowKey?: boolean;
+    typeEvidence?: PlayDatasetColumnTypeEvidence;
+}
+interface PlaySheetContract {
+    tableNamespace: string;
+    columns: PlaySheetColumnContract[];
+}
+
 declare const PLAY_DATASET_BRAND: unique symbol;
 type PlayDatasetKind = 'csv' | 'map';
 type PlayDatasetBacking = {
@@ -265,8 +292,7 @@ type PlayDatasetTransformOptions = {
  * `materialize(limit)` or async iteration only when the dataset is intentionally
  * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
  * `.toArray()`, `.length`, numeric indexing, spread, or synchronous iteration;
- * those hide the runtime cost of loading persisted rows into memory or make
- * behavior depend on whether rows happen to be resident.
+ * these hide loading costs or make behavior depend on row residency.
  *
  * @sdkReference runtime 190
  */
@@ -282,6 +308,8 @@ interface PlayDataset<T> extends AsyncIterable<T> {
     readonly sourceLabel?: string | null;
     /** Runtime table name. */
     readonly tableNamespace?: string | null;
+    /** Advisory source types; transformed fields must infer from their values. */
+    readonly columnTypes?: PlayDatasetColumnTypes;
     /** Row count. */
     count(): Promise<number>;
     /** Preview rows. */
@@ -309,6 +337,7 @@ interface PlayDataset<T> extends AsyncIterable<T> {
         sourceLabel?: string | null;
         tableNamespace?: string | null;
         columns?: string[];
+        columnTypes?: PlayDatasetColumnTypes;
         _metadata?: {
             workProgress?: PlayDatasetWorkProgressSummary;
         };
@@ -2983,25 +3012,6 @@ interface PlayStaticPipeline {
     sheetContract?: PlaySheetContract | null;
     sheetContractErrors?: string[];
 }
-type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
-interface PlaySheetColumnContract {
-    id: string;
-    sqlName: string;
-    source: PlaySheetColumnSource;
-    field?: string;
-    parentField?: string;
-    playId?: string;
-    waterfallId?: string;
-    outputField?: string;
-    outputSqlName?: string;
-    stepId?: string;
-    toolId?: string;
-    isRowKey?: boolean;
-}
-interface PlaySheetContract {
-    tableNamespace: string;
-    columns: PlaySheetColumnContract[];
-}
 type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
 interface PlayStaticColumnProducer {
     id: string;

package/dist/{compiler-manifest-Dpd2hEet.d.ts → compiler-manifest-n8ZtPv2h.d.ts}

@@ -220,6 +220,33 @@ interface PlayR2FileRef {
 }
 type PlayExecutionFileRef = PlayR2FileRef;
 
+/** Source evidence is advisory; stored values determine lossless SQL encoding. */
+interface PlayDatasetColumnTypeEvidence {
+    postgresTypeId: number;
+    valueType: 'boolean' | 'number' | 'string' | 'json';
+}
+type PlayDatasetColumnTypes = Record<string, PlayDatasetColumnTypeEvidence>;
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
+    id: string;
+    sqlName: string;
+    source: PlaySheetColumnSource;
+    field?: string;
+    parentField?: string;
+    playId?: string;
+    waterfallId?: string;
+    outputField?: string;
+    outputSqlName?: string;
+    stepId?: string;
+    toolId?: string;
+    isRowKey?: boolean;
+    typeEvidence?: PlayDatasetColumnTypeEvidence;
+}
+interface PlaySheetContract {
+    tableNamespace: string;
+    columns: PlaySheetColumnContract[];
+}
+
 declare const PLAY_DATASET_BRAND: unique symbol;
 type PlayDatasetKind = 'csv' | 'map';
 type PlayDatasetBacking = {
@@ -265,8 +292,7 @@ type PlayDatasetTransformOptions = {
  * `materialize(limit)` or async iteration only when the dataset is intentionally
  * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
  * `.toArray()`, `.length`, numeric indexing, spread, or synchronous iteration;
- * those hide the runtime cost of loading persisted rows into memory or make
- * behavior depend on whether rows happen to be resident.
+ * these hide loading costs or make behavior depend on row residency.
  *
  * @sdkReference runtime 190
  */
@@ -282,6 +308,8 @@ interface PlayDataset<T> extends AsyncIterable<T> {
     readonly sourceLabel?: string | null;
     /** Runtime table name. */
     readonly tableNamespace?: string | null;
+    /** Advisory source types; transformed fields must infer from their values. */
+    readonly columnTypes?: PlayDatasetColumnTypes;
     /** Row count. */
     count(): Promise<number>;
     /** Preview rows. */
@@ -309,6 +337,7 @@ interface PlayDataset<T> extends AsyncIterable<T> {
         sourceLabel?: string | null;
         tableNamespace?: string | null;
         columns?: string[];
+        columnTypes?: PlayDatasetColumnTypes;
         _metadata?: {
             workProgress?: PlayDatasetWorkProgressSummary;
         };
@@ -2983,25 +3012,6 @@ interface PlayStaticPipeline {
     sheetContract?: PlaySheetContract | null;
     sheetContractErrors?: string[];
 }
-type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
-interface PlaySheetColumnContract {
-    id: string;
-    sqlName: string;
-    source: PlaySheetColumnSource;
-    field?: string;
-    parentField?: string;
-    playId?: string;
-    waterfallId?: string;
-    outputField?: string;
-    outputSqlName?: string;
-    stepId?: string;
-    toolId?: string;
-    isRowKey?: boolean;
-}
-interface PlaySheetContract {
-    tableNamespace: string;
-    columns: PlaySheetColumnContract[];
-}
 type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
 interface PlayStaticColumnProducer {
     id: string;

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 /// <reference path="./text-imports.d.ts" />
 import { z } from 'zod';
-import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-Dpd2hEet.mjs';
-export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-Dpd2hEet.mjs';
+import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-n8ZtPv2h.mjs';
+export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-n8ZtPv2h.mjs';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';