deepline 0.3.392 → 0.3.393

package/dist/cli/{chunk-3VN4FTE3.js → chunk-RDXFGPJU.js}

@@ -477,187 +477,6 @@ function extractSummaryFields(payload) {
   return {};
 }
 
-// ../plays/row-identity.ts
-var POSTGRES_IDENTIFIER_MAX_LENGTH = 63;
-var MAP_KEY_NAMESPACE_MAX_LENGTH = POSTGRES_IDENTIFIER_MAX_LENGTH;
-var SHA256_INITIAL_HASH = [
-  1779033703,
-  3144134277,
-  1013904242,
-  2773480762,
-  1359893119,
-  2600822924,
-  528734635,
-  1541459225
-];
-var SHA256_ROUND_CONSTANTS = [
-  1116352408,
-  1899447441,
-  3049323471,
-  3921009573,
-  961987163,
-  1508970993,
-  2453635748,
-  2870763221,
-  3624381080,
-  310598401,
-  607225278,
-  1426881987,
-  1925078388,
-  2162078206,
-  2614888103,
-  3248222580,
-  3835390401,
-  4022224774,
-  264347078,
-  604807628,
-  770255983,
-  1249150122,
-  1555081692,
-  1996064986,
-  2554220882,
-  2821834349,
-  2952996808,
-  3210313671,
-  3336571891,
-  3584528711,
-  113926993,
-  338241895,
-  666307205,
-  773529912,
-  1294757372,
-  1396182291,
-  1695183700,
-  1986661051,
-  2177026350,
-  2456956037,
-  2730485921,
-  2820302411,
-  3259730800,
-  3345764771,
-  3516065817,
-  3600352804,
-  4094571909,
-  275423344,
-  430227734,
-  506948616,
-  659060556,
-  883997877,
-  958139571,
-  1322822218,
-  1537002063,
-  1747873779,
-  1955562222,
-  2024104815,
-  2227730452,
-  2361852424,
-  2428436474,
-  2756734187,
-  3204031479,
-  3329325298
-];
-function stableValue(value) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => stableValue(entry));
-  }
-  if (value && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => [key, stableValue(entry)])
-    );
-  }
-  return value;
-}
-function stableStringify(value) {
-  return JSON.stringify(stableValue(value));
-}
-function rightRotate32(value, bits) {
-  return value >>> bits | value << 32 - bits;
-}
-function sha256Hex(input) {
-  const bytes = Array.from(new TextEncoder().encode(input));
-  const bitLength = bytes.length * 8;
-  bytes.push(128);
-  while (bytes.length % 64 !== 56) {
-    bytes.push(0);
-  }
-  const highBits = Math.floor(bitLength / 4294967296);
-  const lowBits = bitLength >>> 0;
-  bytes.push(
-    highBits >>> 24 & 255,
-    highBits >>> 16 & 255,
-    highBits >>> 8 & 255,
-    highBits & 255,
-    lowBits >>> 24 & 255,
-    lowBits >>> 16 & 255,
-    lowBits >>> 8 & 255,
-    lowBits & 255
-  );
-  const hash = [...SHA256_INITIAL_HASH];
-  const words = new Array(64).fill(0);
-  for (let offset = 0; offset < bytes.length; offset += 64) {
-    for (let index = 0; index < 16; index += 1) {
-      const wordOffset = offset + index * 4;
-      words[index] = (_nullishCoalesce(bytes[wordOffset], () => ( 0))) << 24 | (_nullishCoalesce(bytes[wordOffset + 1], () => ( 0))) << 16 | (_nullishCoalesce(bytes[wordOffset + 2], () => ( 0))) << 8 | (_nullishCoalesce(bytes[wordOffset + 3], () => ( 0)));
-    }
-    for (let index = 16; index < 64; index += 1) {
-      const s0 = rightRotate32(words[index - 15], 7) ^ rightRotate32(words[index - 15], 18) ^ words[index - 15] >>> 3;
-      const s1 = rightRotate32(words[index - 2], 17) ^ rightRotate32(words[index - 2], 19) ^ words[index - 2] >>> 10;
-      words[index] = words[index - 16] + s0 + words[index - 7] + s1 >>> 0;
-    }
-    let [a, b, c, d, e, f, g, h] = hash;
-    for (let index = 0; index < 64; index += 1) {
-      const s1 = rightRotate32(e, 6) ^ rightRotate32(e, 11) ^ rightRotate32(e, 25);
-      const ch = e & f ^ ~e & g;
-      const temp1 = h + s1 + ch + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
-      const s0 = rightRotate32(a, 2) ^ rightRotate32(a, 13) ^ rightRotate32(a, 22);
-      const maj = a & b ^ a & c ^ b & c;
-      const temp2 = s0 + maj >>> 0;
-      h = g;
-      g = f;
-      f = e;
-      e = d + temp1 >>> 0;
-      d = c;
-      c = b;
-      b = a;
-      a = temp1 + temp2 >>> 0;
-    }
-    hash[0] = hash[0] + a >>> 0;
-    hash[1] = hash[1] + b >>> 0;
-    hash[2] = hash[2] + c >>> 0;
-    hash[3] = hash[3] + d >>> 0;
-    hash[4] = hash[4] + e >>> 0;
-    hash[5] = hash[5] + f >>> 0;
-    hash[6] = hash[6] + g >>> 0;
-    hash[7] = hash[7] + h >>> 0;
-  }
-  return hash.map((word) => word.toString(16).padStart(8, "0")).join("");
-}
-function sanitizeIdentifierPart(value) {
-  return value.trim().replace(/[^a-z0-9]+/gi, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "").toLowerCase();
-}
-function validateIdentifierPart(rawValue, label, maxLength) {
-  const sanitized = sanitizeIdentifierPart(rawValue);
-  if (!sanitized) {
-    throw new Error(`${label} must contain a letter or number.`);
-  }
-  if (sanitized.length > maxLength) {
-    throw new Error(
-      `${label} is too long after normalization (${sanitized.length}/${maxLength}): "${sanitized}".`
-    );
-  }
-  return sanitized;
-}
-function normalizeTableNamespace(value) {
-  return validateIdentifierPart(
-    value,
-    "ctx.dataset() key",
-    MAP_KEY_NAMESPACE_MAX_LENGTH
-  );
-}
-
-
-
-
 
 
 
@@ -672,4 +491,4 @@ function normalizeTableNamespace(value) {
 
 
 
-exports.EMAIL_STATUS_JSON_SCHEMA = EMAIL_STATUS_JSON_SCHEMA; exports.buildEmailStatus = buildEmailStatus; exports.JOB_CHANGE_STATUS_VALUES = JOB_CHANGE_STATUS_VALUES; exports.JOB_CHANGE_JSON_SCHEMA = JOB_CHANGE_JSON_SCHEMA; exports.PHONE_STATUS_VALUES = PHONE_STATUS_VALUES; exports.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS; exports.DEEPLINE_EXTRACTOR_TARGETS = DEEPLINE_EXTRACTOR_TARGETS; exports.isDeeplineExtractorTarget = isDeeplineExtractorTarget; exports.stableStringify = stableStringify; exports.sha256Hex = sha256Hex; exports.normalizeTableNamespace = normalizeTableNamespace; exports.tryConvertToList = tryConvertToList; exports.projectRowOutput = projectRowOutput; exports.writeJsonOutputFile = writeJsonOutputFile; exports.writeCsvOutputFile = writeCsvOutputFile; exports.extractSummaryFields = extractSummaryFields;
+exports.EMAIL_STATUS_JSON_SCHEMA = EMAIL_STATUS_JSON_SCHEMA; exports.buildEmailStatus = buildEmailStatus; exports.JOB_CHANGE_STATUS_VALUES = JOB_CHANGE_STATUS_VALUES; exports.JOB_CHANGE_JSON_SCHEMA = JOB_CHANGE_JSON_SCHEMA; exports.PHONE_STATUS_VALUES = PHONE_STATUS_VALUES; exports.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS; exports.DEEPLINE_EXTRACTOR_TARGETS = DEEPLINE_EXTRACTOR_TARGETS; exports.isDeeplineExtractorTarget = isDeeplineExtractorTarget; exports.tryConvertToList = tryConvertToList; exports.projectRowOutput = projectRowOutput; exports.writeJsonOutputFile = writeJsonOutputFile; exports.writeCsvOutputFile = writeCsvOutputFile; exports.extractSummaryFields = extractSummaryFields;

package/dist/cli/{chunk-7E66A24V.mjs → chunk-RKMB3N7K.mjs}

@@ -12,7 +12,8 @@ var SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
   7,
   8,
   9,
-  10
+  10,
+  11
 ];
 var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
   {
@@ -74,6 +75,12 @@ var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
     compatibilityOwner: "Plays Runtime",
     newWritesEnd: null,
     readerRemoval: null
+  },
+  {
+    changed: 'CSV datasets always use source row identity and process every input occurrence, even when key or rowIdentity: "key" is supplied. Editions 1\u201310 retain their admitted row identity and completed receipts; non-CSV datasets retain explicit key deduplication.',
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
   }
 ];
 function playToolListGetterMode(edition = PLAY_AUTHORING_CONTRACT_EDITION) {
@@ -985,6 +992,22 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "Stable field or fields used for durable row identity.",
     errorMessage: "ctx.dataset run key must be a non-empty field, field list, or key function."
   },
+  "ctx.dataset.run.rowIdentity": {
+    schema: Type.Union([Type.Literal("source_row"), Type.Literal("key")]),
+    fixtures: {
+      valid: "source_row",
+      invalid: "dedupe",
+      absent: void 0,
+      unresolved: { expression: "rowIdentity" },
+      edition1: "key"
+    },
+    referenceType: "'source_row' | 'key'",
+    required: false,
+    resolution: "static-when-present",
+    issueCode: "play_authoring_dataset_option_invalid",
+    description: "Select source_row to process every input occurrence. CSV datasets default to source_row in edition 11; earlier editions retain key identity. Select key only to intentionally deduplicate business keys.",
+    errorMessage: 'ctx.dataset run rowIdentity must be "source_row" or "key".'
+  },
   "ctx.dataset.run.onRowError": {
     schema: Type.Union([Type.Literal("isolate"), Type.Literal("fail")]),
     fixtures: {
@@ -1609,7 +1632,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;",
   "export type DatasetRowKey<InputRow extends object> = (keyof InputRow & string) | readonly (keyof InputRow & string)[] | ((row: InputRow, index: number) => string | number | readonly unknown[]);",
   "export type DatasetDefinitionOptions<InputRow extends object> = { key?: DatasetRowKey<InputRow> };",
-  `export type DatasetRunOptions<InputRow extends object> = { description?: ${cloudReferenceType("ctx.dataset.run.description")}; key?: DatasetRowKey<InputRow>; onRowError?: ${cloudReferenceType("ctx.dataset.run.onRowError")}; mode?: ${cloudReferenceType("ctx.dataset.run.mode")}; undrawnColumns?: ${cloudReferenceType("ctx.dataset.run.undrawnColumns")} };`,
+  `export type DatasetRunOptions<InputRow extends object> = { description?: ${cloudReferenceType("ctx.dataset.run.description")}; key?: DatasetRowKey<InputRow>; rowIdentity?: ${cloudReferenceType("ctx.dataset.run.rowIdentity")}; onRowError?: ${cloudReferenceType("ctx.dataset.run.onRowError")}; mode?: ${cloudReferenceType("ctx.dataset.run.mode")}; undrawnColumns?: ${cloudReferenceType("ctx.dataset.run.undrawnColumns")} };`,
   "export type DatasetBuilder<InputRow extends object, OutputRow extends object> = {",
   "  withColumn<Name extends string, Value>(name: Name, resolver: ColumnResolver<OutputRow, Value>): DatasetBuilder<InputRow, OutputRow & Record<Name, Value>>;",
   "  withColumn<Name extends string, Value>(name: Name, definition: DatasetColumnDefinition<OutputRow, Value> & { readonly runIf: (row: OutputRow, index: number) => boolean | Promise<boolean> }): DatasetBuilder<InputRow, OutputRow & Record<Name, Value | null>>;",

package/dist/cli/{chunk-JSLPHFP7.js → chunk-RWHWF5ZJ.js}

@@ -49,10 +49,11 @@ 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.392",
+  version: "0.3.393",
   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
+    updatePreferences: 1,
+    skillsGuidance: 1
   },
   contracts: {
     api: {

package/dist/cli/{chunk-3FV4GBRK.mjs → chunk-STNYIMIV.mjs}

@@ -13,7 +13,7 @@ import {
   observedMaxText,
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-HGYBEAQP.mjs";
+} from "./chunk-2LGC4EFT.mjs";
 import {
   DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS,
   EMAIL_STATUS_JSON_SCHEMA,
@@ -21,18 +21,20 @@ import {
   extractSummaryFields,
   isDeeplineExtractorTarget,
   projectRowOutput,
-  stableStringify,
   tryConvertToList,
   writeCsvOutputFile,
   writeJsonOutputFile
-} from "./chunk-Y6VOGHF2.mjs";
+} from "./chunk-KZZC33PY.mjs";
 import {
   playToolListGetterMode
-} from "./chunk-7E66A24V.mjs";
+} from "./chunk-RKMB3N7K.mjs";
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-YN6YA7ZZ.mjs";
+} from "./chunk-Q26LUSQ2.mjs";
+import {
+  stableStringify
+} from "./chunk-UBKA33KY.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -46,17 +48,51 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-2G7DXFHI.mjs";
+} from "./chunk-5PRVMXKB.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-2GAHHSLB.mjs";
+} from "./chunk-LMMEAMA7.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
 
 // src/cli/commands/tools.ts
 import { Option } from "commander";
+
+// ../integration-contracts/request-warnings.ts
+function matchesToolRequestCondition(condition, payload) {
+  if ("all" in condition) {
+    return condition.all.every(
+      (entry) => matchesToolRequestCondition(entry, payload)
+    );
+  }
+  if ("any" in condition) {
+    return condition.any.some(
+      (entry) => matchesToolRequestCondition(entry, payload)
+    );
+  }
+  const value2 = payload?.[condition.field];
+  switch (condition.operator) {
+    case "equals":
+      return value2 === condition.value;
+    case "number_equals":
+      try {
+        return Number(value2) === condition.value;
+      } catch {
+        return false;
+      }
+    case "present_nonblank":
+      return typeof value2 === "string" ? value2.trim().length > 0 : value2 !== void 0 && value2 !== null;
+    default:
+      throw new Error("Unsupported tool request warning condition.");
+  }
+}
+function firstMatchingToolRequestWarning(rules, payload) {
+  return rules?.find((rule) => matchesToolRequestCondition(rule.when, payload));
+}
+
+// src/cli/commands/tools.ts
 import {
   chmodSync,
   existsSync as existsSync2,
@@ -979,6 +1015,46 @@ Output:
   exact charge. Workspace balance changes also include other callers' activity.
 `
   );
+  tools.command("connect <provider>").description(
+    "Save your provider credentials for the active workspace (owner/admin required)."
+  ).requiredOption(
+    "--credentials-file <path>",
+    "JSON object of credential field names and string values; keep this file private"
+  ).option("--json", "Emit a confirmation without credential values").action(
+    async (provider, options) => {
+      let credentials;
+      try {
+        credentials = JSON.parse(
+          readFileSync2(resolve(options.credentialsFile), "utf8")
+        );
+      } catch {
+        throw new Error(
+          "Unable to read --credentials-file as a JSON object."
+        );
+      }
+      if (!credentials || typeof credentials !== "object" || Array.isArray(credentials) || Object.keys(credentials).length === 0 || Object.values(credentials).some((value2) => typeof value2 !== "string")) {
+        throw new Error(
+          "--credentials-file must contain a nonempty JSON object of string credential values."
+        );
+      }
+      const result = await new DeeplineClient().setIntegrationCredentials(
+        provider,
+        credentials
+      );
+      if (!result.ok || result.credential_saved !== true) {
+        throw new Error(
+          "The API did not confirm that provider credentials were saved. Inspect the integration before retrying."
+        );
+      }
+      const confirmation = { provider, credential_saved: true };
+      if (shouldEmitJson(options.json))
+        console.log(JSON.stringify(confirmation));
+      else
+        console.log(
+          `Credentials saved for ${provider} in the active workspace.`
+        );
+    }
+  );
   tools.command("list [category]").description("Browse tool categories, or list every tool in a category.").addHelpText(
     "after",
     `
@@ -1112,7 +1188,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-E3DE3ZK3.mjs");
+      const { describeAnything } = await import("./describe-WT6MM2GO.mjs");
       process.exitCode = await describeAnything(
         toolId,
         {
@@ -1418,6 +1494,7 @@ function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdi
     description: tool.description,
     ...Object.keys(guidance).length > 0 ? { guidance } : {},
     categories: tool.categories,
+    ...Array.isArray(tool.requestWarnings) ? { requestWarnings: tool.requestWarnings } : {},
     ...deprecated ? {
       deprecated: true,
       callable: tool.callable !== false,
@@ -3126,6 +3203,18 @@ async function executeTool(toolId, options) {
     }
     return 2;
   }
+  if (metadata.deprecation?.message) {
+    console.error(
+      `Warning: ${parsed.toolId} is deprecated. ${metadata.deprecation.message}`
+    );
+  }
+  const requestWarning = firstMatchingToolRequestWarning(
+    metadata.requestWarnings,
+    parsed.params
+  );
+  if (requestWarning) {
+    console.error(`Warning: ${requestWarning.message}`);
+  }
   const responseIntent = parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw";
   const recovery = ToolCallRecovery.open({
     toolId: parsed.toolId,