deepline 0.2.53 → 0.2.55

package/dist/index.mjs

@@ -689,7 +689,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.53",
+  version: "0.2.55",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1624,7 +1624,7 @@ function createSecretRedactionContext(initialValues = []) {
     if (value.length >= 4) exactSecrets.add(value);
   }
   for (const value of initialValues) register(value);
-  function redactString(value) {
+  function redactString2(value) {
     let output = value;
     for (const secret of exactSecrets) {
       output = output.replace(
@@ -1645,7 +1645,7 @@ function createSecretRedactionContext(initialValues = []) {
     return redactSecretLikeString(output);
   }
   function redact(value) {
-    if (typeof value === "string") return redactString(value);
+    if (typeof value === "string") return redactString2(value);
     if (Array.isArray(value)) return value.map((entry) => redact(entry));
     if (value && typeof value === "object") {
       return Object.fromEntries(
@@ -1658,7 +1658,7 @@ function createSecretRedactionContext(initialValues = []) {
     return value;
   }
   function redactKnownSecrets(value) {
-    if (typeof value === "string") return redactString(value);
+    if (typeof value === "string") return redactString2(value);
     if (Array.isArray(value)) {
       return value.map((entry) => redactKnownSecrets(entry));
     }
@@ -1674,7 +1674,7 @@ function createSecretRedactionContext(initialValues = []) {
   }
   return {
     register,
-    redactString,
+    redactString: redactString2,
     redactKnownSecrets,
     redact
   };
@@ -1694,12 +1694,334 @@ var RUNNER_POST_TERMINAL_DIAGNOSTIC_MAX_BYTES = 64 * 1024;
 // ../shared_libs/play-runtime/ledger-safe-payload.ts
 var ledgerIngressRedactor = createSecretRedactionContext();
 
-// ../shared_libs/play-runtime/activity-observation.ts
+// ../shared_libs/play-runtime/docflow-node-io.ts
+var DOCFLOW_NODE_IO_LIMITS = {
+  maxPaths: 16,
+  maxDepth: 3,
+  maxObjectFields: 12,
+  maxArrayItems: 3,
+  maxStringBytes: 256,
+  maxPhaseBytes: 2e3,
+  maxErrorBytes: 512
+};
+var utf8Encoder = new TextEncoder();
+var PLAY_DATASET_BRAND = /* @__PURE__ */ Symbol.for("deepline.play.dataset");
+function ledgerSafeDocflowPreviewKey(key) {
+  if (!key.startsWith("$")) return key;
+  const stripped = key.replace(/^\$+/, "");
+  return stripped || "output";
+}
+function utf8Bytes(value) {
+  return utf8Encoder.encode(value).byteLength;
+}
+function truncateUtf8(value, maxBytes) {
+  if (utf8Bytes(value) <= maxBytes) return value;
+  let output = "";
+  for (const character of value) {
+    if (utf8Bytes(`${output}${character}\u2026`) > maxBytes) break;
+    output += character;
+  }
+  return `${output}\u2026`;
+}
+function redactString(redactor, value, key) {
+  if (!key) return redactor.redactString(value);
+  const wrapped = redactor.redact({ [key]: value });
+  return typeof wrapped[key] === "string" ? wrapped[key] : redactor.redactString(value);
+}
+function safeString(value, redactor, key) {
+  if (typeof value !== "string") return void 0;
+  return truncateUtf8(
+    redactString(redactor, value, key),
+    DOCFLOW_NODE_IO_LIMITS.maxStringBytes
+  );
+}
+function previewValue(value, input) {
+  if (value === null) return { kind: "null" };
+  if (value === void 0) return { kind: "unavailable", reason: "undefined" };
+  if (typeof value === "string") {
+    return {
+      kind: "scalar",
+      value: safeString(value, input.redactor, input.key) ?? ""
+    };
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? { kind: "scalar", value } : { kind: "unavailable", reason: "unsupported" };
+  }
+  if (typeof value === "boolean") return { kind: "scalar", value };
+  if (typeof value === "bigint") {
+    return { kind: "unavailable", reason: "bigint" };
+  }
+  if (typeof value === "function") {
+    return { kind: "unavailable", reason: "function" };
+  }
+  if (typeof value === "symbol") {
+    return { kind: "unavailable", reason: "symbol" };
+  }
+  if (typeof value !== "object") {
+    return { kind: "unavailable", reason: "unsupported" };
+  }
+  try {
+    const brand = readDataProperty(value, PLAY_DATASET_BRAND);
+    const datasetKind = readDataProperty(value, "datasetKind");
+    const datasetId = readDataProperty(value, "datasetId");
+    const tableNamespace = readDataProperty(value, "tableNamespace");
+    if (brand.ok && brand.value === true && datasetKind.ok && (datasetKind.value === "csv" || datasetKind.value === "map") && datasetId.ok && typeof datasetId.value === "string") {
+      return {
+        kind: "dataset",
+        datasetId: safeString(datasetId.value, input.redactor, "datasetId") ?? "dataset",
+        datasetKind: datasetKind.value,
+        tableNamespace: tableNamespace.ok && tableNamespace.value === null ? null : tableNamespace.ok ? safeString(
+          tableNamespace.value,
+          input.redactor,
+          "tableNamespace"
+        ) : void 0
+      };
+    }
+    const kind = readDataProperty(value, "kind");
+    const count = readDataProperty(value, "count");
+    const preview = readDataProperty(value, "preview");
+    if (kind.ok && kind.value === "dataset" && datasetKind.ok && (datasetKind.value === "csv" || datasetKind.value === "map") && datasetId.ok && typeof datasetId.value === "string" && count.ok && typeof count.value === "number" && preview.ok && Array.isArray(preview.value)) {
+      return {
+        kind: "dataset",
+        datasetId: safeString(datasetId.value, input.redactor, "datasetId") ?? "dataset",
+        datasetKind: datasetKind.value,
+        tableNamespace: tableNamespace.ok && tableNamespace.value === null ? null : tableNamespace.ok ? safeString(
+          tableNamespace.value,
+          input.redactor,
+          "tableNamespace"
+        ) : void 0,
+        rowCount: Math.max(0, Math.floor(count.value))
+      };
+    }
+  } catch {
+    return { kind: "unavailable", reason: "access_error" };
+  }
+  if (input.ancestors.has(value)) {
+    return { kind: "unavailable", reason: "cycle" };
+  }
+  if (input.depth >= DOCFLOW_NODE_IO_LIMITS.maxDepth) {
+    return { kind: "unavailable", reason: "depth" };
+  }
+  input.ancestors.add(value);
+  try {
+    if (Array.isArray(value)) {
+      const items = [];
+      for (let index = 0; index < Math.min(value.length, DOCFLOW_NODE_IO_LIMITS.maxArrayItems); index += 1) {
+        const descriptor = Object.getOwnPropertyDescriptor(
+          value,
+          String(index)
+        );
+        items.push(
+          descriptor && "value" in descriptor ? previewValue(descriptor.value, {
+            ...input,
+            depth: input.depth + 1
+          }) : { kind: "unavailable", reason: "access_error" }
+        );
+      }
+      return {
+        kind: "array",
+        items,
+        totalItems: value.length,
+        ...value.length > items.length ? { truncated: true } : {}
+      };
+    }
+    let descriptors;
+    try {
+      descriptors = Object.getOwnPropertyDescriptors(value);
+    } catch {
+      return { kind: "unavailable", reason: "access_error" };
+    }
+    const entries = Object.entries(descriptors).filter(
+      ([, descriptor]) => descriptor.enumerable
+    );
+    const selected = entries.slice(0, DOCFLOW_NODE_IO_LIMITS.maxObjectFields);
+    const fields = {};
+    for (const [key, descriptor] of selected) {
+      const safeKey = truncateUtf8(
+        ledgerSafeDocflowPreviewKey(input.redactor.redactString(key)),
+        DOCFLOW_NODE_IO_LIMITS.maxStringBytes
+      );
+      fields[safeKey] = "value" in descriptor ? previewValue(descriptor.value, {
+        ...input,
+        depth: input.depth + 1,
+        key
+      }) : { kind: "unavailable", reason: "access_error" };
+    }
+    return {
+      kind: "object",
+      fields,
+      totalFields: entries.length,
+      ...entries.length > selected.length ? { truncated: true } : {}
+    };
+  } catch {
+    return { kind: "unavailable", reason: "access_error" };
+  } finally {
+    input.ancestors.delete(value);
+  }
+}
+function readDataProperty(value, property) {
+  if ((typeof value !== "object" || value === null) && typeof value !== "function") {
+    return { ok: false };
+  }
+  try {
+    let owner = value;
+    while (owner) {
+      const descriptor = Object.getOwnPropertyDescriptor(owner, property);
+      if (descriptor) {
+        return "value" in descriptor ? { ok: true, value: descriptor.value } : { ok: false };
+      }
+      owner = Object.getPrototypeOf(owner);
+    }
+  } catch {
+    return { ok: false };
+  }
+  return { ok: false };
+}
+function buildPlayDocflowNodeErrorPreview(error, redactor = createSecretRedactionContext()) {
+  try {
+    const message = error instanceof Error ? error.message : String(error);
+    return truncateUtf8(
+      redactor.redactString(message),
+      DOCFLOW_NODE_IO_LIMITS.maxErrorBytes
+    );
+  } catch {
+    return "Non-Error value thrown (message unavailable)";
+  }
+}
 function isRecord3(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
+function normalizePreview(value, depth) {
+  if (!isRecord3(value) || typeof value.kind !== "string") return null;
+  if (value.kind === "null") return { kind: "null" };
+  if (value.kind === "scalar") {
+    if (typeof value.value === "string" || typeof value.value === "boolean" || typeof value.value === "number" && Number.isFinite(value.value)) {
+      return previewValue(value.value, {
+        depth: 0,
+        ancestors: /* @__PURE__ */ new WeakSet(),
+        redactor: createSecretRedactionContext()
+      });
+    }
+    return null;
+  }
+  if (value.kind === "unavailable") {
+    const reason = value.reason;
+    return typeof reason === "string" && [
+      "undefined",
+      "function",
+      "symbol",
+      "bigint",
+      "cycle",
+      "depth",
+      "access_error",
+      "limit",
+      "unsupported"
+    ].includes(reason) ? {
+      kind: "unavailable",
+      reason
+    } : null;
+  }
+  if (value.kind === "dataset") {
+    const datasetId = safeString(
+      value.datasetId,
+      createSecretRedactionContext(),
+      "datasetId"
+    );
+    if (!datasetId || value.datasetKind !== "csv" && value.datasetKind !== "map") {
+      return null;
+    }
+    return {
+      kind: "dataset",
+      datasetId,
+      datasetKind: value.datasetKind,
+      ...value.tableNamespace === null ? { tableNamespace: null } : typeof value.tableNamespace === "string" ? {
+        tableNamespace: safeString(
+          value.tableNamespace,
+          createSecretRedactionContext(),
+          "tableNamespace"
+        )
+      } : {},
+      ...typeof value.rowCount === "number" && Number.isFinite(value.rowCount) ? { rowCount: Math.max(0, Math.floor(value.rowCount)) } : {}
+    };
+  }
+  if (depth >= DOCFLOW_NODE_IO_LIMITS.maxDepth) {
+    return { kind: "unavailable", reason: "depth" };
+  }
+  if (value.kind === "array" && Array.isArray(value.items)) {
+    const items = value.items.slice(0, DOCFLOW_NODE_IO_LIMITS.maxArrayItems).map((item) => normalizePreview(item, depth + 1)).filter((item) => item !== null);
+    const totalItems = typeof value.totalItems === "number" && Number.isFinite(value.totalItems) ? Math.max(items.length, Math.floor(value.totalItems)) : items.length;
+    return {
+      kind: "array",
+      items,
+      totalItems,
+      ...value.truncated === true || totalItems > items.length ? { truncated: true } : {}
+    };
+  }
+  if (value.kind === "object" && isRecord3(value.fields)) {
+    const fields = {};
+    for (const [key, field] of Object.entries(value.fields).slice(
+      0,
+      DOCFLOW_NODE_IO_LIMITS.maxObjectFields
+    )) {
+      const normalized = normalizePreview(field, depth + 1);
+      if (normalized) fields[ledgerSafeDocflowPreviewKey(key)] = normalized;
+    }
+    const totalFields = typeof value.totalFields === "number" && Number.isFinite(value.totalFields) ? Math.max(Object.keys(fields).length, Math.floor(value.totalFields)) : Object.keys(fields).length;
+    return {
+      kind: "object",
+      fields,
+      totalFields,
+      ...value.truncated === true || totalFields > Object.keys(fields).length ? { truncated: true } : {}
+    };
+  }
+  return null;
+}
+function normalizePlayDocflowNodeIoState(value) {
+  if (!isRecord3(value)) return void 0;
+  const attempt = typeof value.attempt === "number" && Number.isFinite(value.attempt) ? Math.max(0, Math.floor(value.attempt)) : 0;
+  const normalizeMap = (raw) => {
+    if (!isRecord3(raw)) return void 0;
+    const output = {};
+    for (const [path, preview] of Object.entries(raw).slice(
+      0,
+      DOCFLOW_NODE_IO_LIMITS.maxPaths
+    )) {
+      const normalized = normalizePreview(preview, 0);
+      if (!normalized) continue;
+      const safePath = ledgerSafeDocflowPreviewKey(path);
+      const candidate = { ...output, [safePath]: normalized };
+      if (utf8Bytes(JSON.stringify(candidate)) > DOCFLOW_NODE_IO_LIMITS.maxPhaseBytes) {
+        break;
+      }
+      output[safePath] = normalized;
+    }
+    return output;
+  };
+  const inputs = normalizeMap(value.inputs);
+  const outputs = normalizeMap(value.outputs);
+  const error = typeof value.error === "string" ? buildPlayDocflowNodeErrorPreview(value.error) : value.error === null ? null : void 0;
+  return {
+    attempt,
+    ...typeof value.invocationId === "string" && value.invocationId.trim() ? {
+      invocationId: truncateUtf8(
+        value.invocationId.trim(),
+        DOCFLOW_NODE_IO_LIMITS.maxStringBytes
+      )
+    } : {},
+    ...inputs ? { inputs } : {},
+    ...outputs ? { outputs } : {},
+    ...value.inputsTruncated === true ? { inputsTruncated: true } : {},
+    ...value.outputsTruncated === true ? { outputsTruncated: true } : {},
+    ...error !== void 0 ? { error } : {}
+  };
+}
+
+// ../shared_libs/play-runtime/activity-observation.ts
+function isRecord4(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
 function isPlayActivityObservation(value) {
-  if (!isRecord3(value) || value.schemaVersion !== 1 || typeof value.activityId !== "string" || !value.activityId.trim() || typeof value.observedAt !== "number" || !Number.isFinite(value.observedAt) || !isRecord3(value.target) || !isRecord3(value.state)) {
+  if (!isRecord4(value) || value.schemaVersion !== 1 || typeof value.activityId !== "string" || !value.activityId.trim() || typeof value.observedAt !== "number" || !Number.isFinite(value.observedAt) || !isRecord4(value.target) || !isRecord4(value.state)) {
     return false;
   }
   const targetKinds = /* @__PURE__ */ new Set([
@@ -1969,9 +2291,30 @@ function projectPlayRunActivity(input) {
   return projection(fallback, now, normalizedStatus !== "waiting");
 }
 
+// ../shared_libs/play-runtime/cell-provenance.ts
+function finiteNonNegativeInteger2(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    return null;
+  }
+  return Math.trunc(value);
+}
+function nonEmptyString(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+function normalizeDatasetBornFrom(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value;
+  const table = nonEmptyString(record.table);
+  const rowCountIn = finiteNonNegativeInteger2(record.rowCountIn);
+  if (!table || rowCountIn === null) return null;
+  return { table, rowCountIn };
+}
+
 // ../shared_libs/play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
@@ -2067,21 +2410,21 @@ function createEmptyPlayRunLedgerSnapshot(input) {
   };
 }
 function normalizePlayRunLedgerSnapshot(value, fallback) {
-  if (!isRecord4(value)) {
+  if (!isRecord5(value)) {
     return createEmptyPlayRunLedgerSnapshot(fallback);
   }
   const orderedStepIds = Array.isArray(value.orderedStepIds) ? value.orderedStepIds.filter(
     (entry) => typeof entry === "string" && Boolean(entry.trim())
   ) : [];
-  const rawSteps = isRecord4(value.stepsById) ? value.stepsById : {};
+  const rawSteps = isRecord5(value.stepsById) ? value.stepsById : {};
   const stepsById = {};
   for (const [stepId, rawStep] of Object.entries(rawSteps)) {
-    if (!stepId.trim() || !isRecord4(rawStep)) continue;
+    if (!stepId.trim() || !isRecord5(rawStep)) continue;
     const rawStatus = normalizeStepStatus(rawStep.status);
     if (!rawStatus) continue;
     const completedAt = finiteNumber(rawStep.completedAt);
     const status = rawStatus === "running" && completedAt !== null ? "completed" : rawStatus;
-    const rawProgress = isRecord4(rawStep.progress) ? rawStep.progress : null;
+    const rawProgress = isRecord5(rawStep.progress) ? rawStep.progress : null;
     stepsById[stepId] = {
       stepId,
       label: optionalString(rawStep.label),
@@ -2097,11 +2440,12 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       progress: rawProgress ? normalizeStepProgress(rawProgress) : null
     };
   }
-  const rawDatasets = isRecord4(value.datasetsById) ? value.datasetsById : {};
+  const rawDatasets = isRecord5(value.datasetsById) ? value.datasetsById : {};
   const datasetsById = {};
   for (const [datasetId, rawDataset] of Object.entries(rawDatasets)) {
-    if (!datasetId.trim() || !isRecord4(rawDataset)) continue;
+    if (!datasetId.trim() || !isRecord5(rawDataset)) continue;
     const phase = rawDataset.phase === "available" || rawDataset.phase === "failed" ? rawDataset.phase : "registered";
+    const datasetBornFrom = normalizeDatasetBornFrom(rawDataset.bornFrom);
     datasetsById[datasetId] = {
       datasetId,
       path: optionalString(rawDataset.path) ?? `datasets.${datasetId}`,
@@ -2111,10 +2455,14 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       succeededRows: Math.max(0, finiteNumber(rawDataset.succeededRows) ?? 0),
       failedRows: Math.max(0, finiteNumber(rawDataset.failedRows) ?? 0),
       complete: rawDataset.complete === true,
+      // ADR 0019 birth survives the snapshot round trip. A partial record is
+      // dropped rather than half-admitted, so a dataset either states where its
+      // rows came from or says nothing.
+      ...datasetBornFrom ? { bornFrom: datasetBornFrom } : {},
       updatedAt: finiteNumber(rawDataset.updatedAt) ?? 0
     };
   }
-  const rawActivities = isRecord4(value.activitiesById) ? value.activitiesById : {};
+  const rawActivities = isRecord5(value.activitiesById) ? value.activitiesById : {};
   const activitiesById = {};
   for (const [activityId, rawActivity] of Object.entries(rawActivities)) {
     if (activityId.trim() && isPlayActivityObservation(rawActivity) && rawActivity.activityId === activityId) {
@@ -2191,7 +2539,8 @@ function normalizeStepProgress(value) {
     } : {},
     ...finiteNumber(value.startedAt) !== null ? { startedAt: finiteNumber(value.startedAt) } : {},
     ...finiteNumber(value.completedAt) !== null ? { completedAt: finiteNumber(value.completedAt) } : {},
-    ...finiteNumber(value.updatedAt) !== null ? { updatedAt: finiteNumber(value.updatedAt) } : {}
+    ...finiteNumber(value.updatedAt) !== null ? { updatedAt: finiteNumber(value.updatedAt) } : {},
+    ...normalizePlayDocflowNodeIoState(value.nodeIo) ? { nodeIo: normalizePlayDocflowNodeIoState(value.nodeIo) } : {}
   };
 }
 
@@ -2263,18 +2612,18 @@ function normalizePlayRunLiveStatus(value) {
 function isTerminalPlayRunLiveStatus(status) {
   return isTerminalPlayRunLifecycleStatus(status);
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 function extractTerminalRunLogTail(result) {
-  if (!isRecord5(result) || !isRecord5(result._metadata)) {
+  if (!isRecord6(result) || !isRecord6(result._metadata)) {
     return null;
   }
   const runLogTail = result._metadata.runLogTail;
-  if (!isRecord5(runLogTail) || !Array.isArray(runLogTail.tail)) {
+  if (!isRecord6(runLogTail) || !Array.isArray(runLogTail.tail)) {
     return null;
   }
   const logTail = runLogTail.tail.filter(
@@ -2310,11 +2659,13 @@ function buildSnapshotFromLedger(snapshot) {
       artifactTableNamespace: step.progress.artifactTableNamespace ?? step.artifactTableNamespace ?? null,
       startedAt: step.startedAt ?? null,
       completedAt: step.completedAt ?? null,
-      updatedAt: step.progress.updatedAt ?? step.updatedAt ?? null
+      updatedAt: step.progress.updatedAt ?? step.updatedAt ?? null,
+      nodeIo: step.progress.nodeIo
     } : null,
     startedAt: step.startedAt ?? null,
     completedAt: step.completedAt ?? null,
-    updatedAt: step.updatedAt ?? null
+    updatedAt: step.updatedAt ?? null,
+    ...step.progress?.nodeIo ? { nodeIo: step.progress.nodeIo } : {}
   }));
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
   const rowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) && Object.keys(snapshot.stepsById).length > 0 ? summarizeRunRowOutcomes(snapshot) : null;
@@ -3064,8 +3415,17 @@ function resolvePlayRunRuntimeSelection(request) {
   const configuredToken = process.env.DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN?.trim();
   if (!configured) {
     if (configuredNamespace || configuredToken) {
+      const present = [];
+      if (configuredNamespace) present.push("DEEPLINE_RUNTIME_NAMESPACE");
+      if (configuredToken) present.push("DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN");
+      const isPlural = present.length > 1;
       throw new DeeplineError(
-        "DEEPLINE_RUNTIME_ENVIRONMENT=preview and DEEPLINE_RUNTIME_NAMESPACE are required when runtime selection configuration is present.",
+        [
+          `Incomplete play runtime selection: ${present.join(" and ")} ${isPlural ? "are" : "is"} set but DEEPLINE_RUNTIME_ENVIRONMENT is not.`,
+          "Preview routing requires DEEPLINE_RUNTIME_ENVIRONMENT=preview together with DEEPLINE_RUNTIME_NAMESPACE; the token alone authorizes nothing.",
+          `If you did not export ${isPlural ? "these" : "this"} yourself, ${isPlural ? "they were" : "it was"} most likely auto-loaded from a .env or .env.local in the current directory (bun loads those automatically, and in a git worktree .env.local is usually a symlink to the main checkout).`,
+          `To run against the app-native runtime, clear ${isPlural ? "them" : "it"} for this command: ${present.map((name) => `${name}=`).join(" ")} <your deepline command>`
+        ].join("\n"),
         void 0,
         "INVALID_RUNTIME_ENVIRONMENT"
       );
@@ -3233,7 +3593,7 @@ function requireTargetBillingIdempotencyKey(value) {
   }
   return normalized;
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isPrebuiltPlayDescription(play) {
@@ -3405,7 +3765,7 @@ function updatePlayLiveStatusState(state, event) {
   }
   const runId = typeof payload.runId === "string" && payload.runId ? payload.runId : isPlayRunPackage(payload) ? payload.run.id : state.runId;
   const status = normalizeLiveStatus(payload.status) ?? (isPlayRunPackage(payload) ? normalizeLiveStatus(payload.run.status) : null) ?? state.status;
-  const progressPayload = isRecord6(payload.progress) ? payload.progress : {};
+  const progressPayload = isRecord7(payload.progress) ? payload.progress : {};
   if (event.type === "play.run.final_status" && state.logs.length === 0 && state.lastLogSeq === 0) {
     const payloadLogs = readStringArray(payload.logs);
     const progressLogs = readStringArray(progressPayload.logs);
@@ -3548,9 +3908,9 @@ var DeeplineClient = class {
     return fields.length > 0 ? { fields } : schema;
   }
   schemaMetadata(schema, key) {
-    if (!isRecord6(schema)) return null;
+    if (!isRecord7(schema)) return null;
     const value = schema[key];
-    return isRecord6(value) ? value : null;
+    return isRecord7(value) ? value : null;
   }
   playRunCommand(play, options) {
     const target = play.reference || play.name;
@@ -3599,7 +3959,7 @@ var DeeplineClient = class {
       aliases,
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
-      staticPipeline: isRecord6(play.staticPipeline) ? play.staticPipeline : isRecord6(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord6(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
+      staticPipeline: isRecord7(play.staticPipeline) ? play.staticPipeline : isRecord7(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord7(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
       ...csvInput ? { csvInput } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand,
@@ -6063,7 +6423,7 @@ function isDeeplineExtractorTarget(value) {
 }
 
 // ../shared_libs/plays/dataset.ts
-var PLAY_DATASET_BRAND = /* @__PURE__ */ Symbol.for("deepline.play.dataset");
+var PLAY_DATASET_BRAND2 = /* @__PURE__ */ Symbol.for("deepline.play.dataset");
 var NODE_INSPECT_CUSTOM = /* @__PURE__ */ Symbol.for("nodejs.util.inspect.custom");
 var residentRowsByDataset = /* @__PURE__ */ new WeakMap();
 var DEFAULT_MATERIALIZE_LIMIT = 1e4;
@@ -6090,7 +6450,7 @@ function inferPreviewColumns(rows) {
   return columns.size > 0 ? [...columns] : void 0;
 }
 var DeferredPlayDataset = class {
-  [PLAY_DATASET_BRAND] = true;
+  [PLAY_DATASET_BRAND2] = true;
   datasetKind;
   datasetId;
   backing;
@@ -6600,7 +6960,7 @@ var TARGET_FALLBACK_KEYS = {
   status: [/^email_status$/i, /^status$/i],
   email_status: [/^email_status$/i, /^status$/i]
 };
-function isRecord7(value) {
+function isRecord8(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function toV2RawToolOutputPath(path) {
@@ -6660,7 +7020,7 @@ function valuesAtSegments(current, segments, path = []) {
     if (!Array.isArray(current)) return [];
     return valuesAtSegments(current[segment], rest, [...path, segment]);
   }
-  if (!isRecord7(current)) return [];
+  if (!isRecord8(current)) return [];
   const directMatches = valuesAtSegments(current[segment], rest, [
     ...path,
     segment
@@ -6690,7 +7050,7 @@ function getValuesAtPath(root, path) {
   return valuesAtSegments(root, parsePath(path)).map((entry) => entry.value);
 }
 function toResultEnvelope(value) {
-  if (isRecord7(value) && "data" in value) {
+  if (isRecord8(value) && "data" in value) {
     const envelope = { data: value.data };
     if ("meta" in value) envelope.meta = value.meta;
     return envelope;
@@ -6743,7 +7103,7 @@ function getAtPath(root, path) {
       current = current[segment];
       continue;
     }
-    if (!isRecord7(current)) return void 0;
+    if (!isRecord8(current)) return void 0;
     current = current[segment];
   }
   return current;
@@ -6760,7 +7120,7 @@ function normalizeString(value) {
 }
 function normalizeRows(value) {
   if (!Array.isArray(value)) return null;
-  return value.map((entry) => isRecord7(entry) ? entry : { value: entry });
+  return value.map((entry) => isRecord8(entry) ? entry : { value: entry });
 }
 function findFirstTargetByPath(result, paths) {
   for (const path of paths ?? []) {
@@ -6819,7 +7179,7 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
     }
     return null;
   }
-  if (!isRecord7(result)) return null;
+  if (!isRecord8(result)) return null;
   const patterns = TARGET_FALLBACK_KEYS[target] ?? [
     new RegExp(`^${target}$`, "i")
   ];
@@ -6879,7 +7239,7 @@ function normalizeJobChangeStatus(value) {
 function firstExperienceDate(value) {
   if (!Array.isArray(value)) return null;
   for (const entry of value) {
-    if (!isRecord7(entry)) continue;
+    if (!isRecord8(entry)) continue;
     const date = normalizeString(
       entry.start_date ?? entry.started_at ?? entry.startDate
     );
@@ -6888,10 +7248,10 @@ function firstExperienceDate(value) {
   return null;
 }
 function normalizeJobChange(value) {
-  const record = isRecord7(value) ? value : {};
-  const nested = isRecord7(record.job_change) ? record.job_change : record;
-  const output = isRecord7(nested.output) ? nested.output : nested;
-  const person = isRecord7(output.person) ? output.person : {};
+  const record = isRecord8(value) ? value : {};
+  const nested = isRecord8(record.job_change) ? record.job_change : record;
+  const output = isRecord8(nested.output) ? nested.output : nested;
+  const person = isRecord8(output.person) ? output.person : {};
   const status = normalizeJobChangeStatus(
     output.status ?? output.job_change_status ?? output.job_changed ?? output.changed
   );
@@ -7265,7 +7625,7 @@ function attachToolResultListDataset(result, input) {
     root = replaceAtPath(root, candidate, serialized.preview);
     break;
   }
-  if (isRecord7(root) && isRecord7(root.toolResponse) && Object.prototype.hasOwnProperty.call(root.toolResponse, "raw")) {
+  if (isRecord8(root) && isRecord8(root.toolResponse) && Object.prototype.hasOwnProperty.call(root.toolResponse, "raw")) {
     result.toolResponse.raw = root.toolResponse.raw;
     result.toolOutput.raw = root.toolResponse.raw;
   }
@@ -7283,7 +7643,7 @@ function replaceAtPath(root, path, replacement) {
       copy[segment] = replace(copy[segment], index + 1);
       return copy;
     }
-    if (!isRecord7(current)) return current;
+    if (!isRecord8(current)) return current;
     return {
       ...current,
       [segment]: replace(current[segment], index + 1)
@@ -7627,11 +7987,11 @@ var Deepline = class {
     return new DeeplineContext(options);
   }
 };
-function isRecord8(value) {
+function isRecord9(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function stringArrayRecord(value) {
-  if (!isRecord8(value)) return {};
+  if (!isRecord9(value)) return {};
   return Object.fromEntries(
     Object.entries(value).map(([key, paths]) => [
       key,
@@ -7643,7 +8003,7 @@ function stringArray(value) {
   return Array.isArray(value) ? value.map(String) : [];
 }
 function emailStatusExtractorConfig(value) {
-  if (!isRecord8(value)) return void 0;
+  if (!isRecord9(value)) return void 0;
   const readPaths = (key) => {
     const paths = stringArray(value[key]).map((path) => path.trim()).filter(Boolean);
     return paths.length > 0 ? paths : void 0;
@@ -7670,7 +8030,7 @@ function emailStatusExtractorConfig(value) {
     const paths = readPaths(key);
     if (paths) config[key] = paths;
   }
-  if (isRecord8(value.statusMap)) {
+  if (isRecord9(value.statusMap)) {
     config.statusMap = value.statusMap;
   }
   if (Array.isArray(value.rules)) {
@@ -7679,10 +8039,10 @@ function emailStatusExtractorConfig(value) {
   return config;
 }
 function extractorDescriptorRecord(value) {
-  if (!isRecord8(value)) return {};
+  if (!isRecord9(value)) return {};
   return Object.fromEntries(
     Object.entries(value).flatMap(([key, descriptor]) => {
-      if (!isRecord8(descriptor)) return [];
+      if (!isRecord9(descriptor)) return [];
       const paths = stringArray(descriptor.paths).map((path) => path.trim()).filter(Boolean);
       if (paths.length === 0) return [];
       const transforms = stringArray(descriptor.transforms).map((transform) => transform.trim()).filter(Boolean);
@@ -7704,16 +8064,16 @@ function extractorDescriptorRecord(value) {
 }
 function rowsFromUnknown(value) {
   if (!Array.isArray(value)) return [];
-  return value.map((row) => isRecord8(row) ? row : { value: row });
+  return value.map((row) => isRecord9(row) ? row : { value: row });
 }
-function finiteNonNegativeInteger2(value) {
+function finiteNonNegativeInteger3(value) {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
     return null;
   }
   return Math.floor(value);
 }
 function finitePositiveInteger(value) {
-  const integer = finiteNonNegativeInteger2(value);
+  const integer = finiteNonNegativeInteger3(value);
   return integer !== null && integer > 0 ? integer : null;
 }
 function stableHash(value) {
@@ -7726,9 +8086,9 @@ function stableHash(value) {
 }
 function attachSdkQueryResultDatasetResult(toolId, result, options) {
   if (!options || !isQueryResultDatasetTool(toolId)) return result;
-  const raw = isRecord8(result.toolResponse.raw) ? result.toolResponse.raw : null;
-  const dataset = isRecord8(raw?.dataset) ? raw.dataset : null;
-  const totalRows = finiteNonNegativeInteger2(dataset?.total_rows);
+  const raw = isRecord9(result.toolResponse.raw) ? result.toolResponse.raw : null;
+  const dataset = isRecord9(raw?.dataset) ? raw.dataset : null;
+  const totalRows = finiteNonNegativeInteger3(dataset?.total_rows);
   const sql = typeof options.input.sql === "string" ? options.input.sql : typeof options.input.query === "string" ? options.input.query : typeof raw?.sql === "string" ? raw.sql : null;
   if (!dataset || totalRows === null || !sql) {
     return result;
@@ -7759,7 +8119,7 @@ function attachSdkQueryResultDatasetResult(toolId, result, options) {
         } : {}
       }
     });
-    const pageRaw = isRecord8(response.toolResponse?.raw) ? response.toolResponse.raw : null;
+    const pageRaw = isRecord9(response.toolResponse?.raw) ? response.toolResponse.raw : null;
     return rowsFromUnknown(pageRaw?.rows);
   };
   const collectRows = async (limit) => {
@@ -7814,8 +8174,8 @@ function attachSdkQueryResultDatasetResult(toolId, result, options) {
 function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   const raw = response.toolResponse?.raw ?? null;
   const meta = response.toolResponse?.meta;
-  const metadata = isRecord8(response._metadata) ? response._metadata.tool : null;
-  const toolMetadata = isRecord8(metadata) ? metadata : {};
+  const metadata = isRecord9(response._metadata) ? response._metadata.tool : null;
+  const toolMetadata = isRecord9(metadata) ? metadata : {};
   return attachSdkQueryResultDatasetResult(
     fallbackToolId,
     createToolExecuteResult({
@@ -7823,7 +8183,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
       jobId: typeof response.job_id === "string" ? response.job_id : void 0,
       result: {
         data: raw,
-        ...isRecord8(meta) ? { meta } : {}
+        ...isRecord9(meta) ? { meta } : {}
       },
       metadata: {
         toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
@@ -7839,7 +8199,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
         cached: false,
         source: "live"
       },
-      meta: isRecord8(response.meta) ? response.meta : void 0
+      meta: isRecord9(response.meta) ? response.meta : void 0
     }),
     options
   );