deepline 0.3.279 → 0.3.280

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

@@ -11,6 +11,7 @@ import type {
 // Value import from the dependency-free module: the client is bundled into
 // authored Plays, where `zod` (the contract's schemas) cannot resolve.
 import { playTriggerConfigPath } from '../../shared_libs/plays/trigger-config-route';
+import { CSV_HEADER_MATCHING_NOTE } from './csv-header-matching.js';
 import { iterateCursorPages } from './pagination.js';
 import { playInputExampleArgs } from './plays/input-example.js';
 /**
@@ -3033,7 +3034,11 @@ export class DeeplineClient {
           : isRecord(play.liveRevision?.staticPipeline)
             ? play.liveRevision.staticPipeline
             : null,
-      ...(csvInput ? { csvInput } : {}),
+      ...(csvInput
+        ? {
+            csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE },
+          }
+        : {}),
       ...(rowOutputSchema ? { rowOutputSchema } : {}),
       runCommand,
       examples: [runCommand],

package/dist/bundling-sources/sdk/src/csv-header-matching.ts

@@ -0,0 +1,7 @@
+/**
+ * How a CSV header is matched to a play column (`normalizeCsvHeader` in the
+ * runtime). Returned with every play description that takes a CSV, because
+ * agents otherwise read the SDK source to find out whether LINKEDIN_URL matches.
+ */
+export const CSV_HEADER_MATCHING_NOTE =
+  'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';

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

@@ -200,7 +200,7 @@ export const 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.279',
+  version: '0.3.280',
   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: {

package/dist/cli/index.js

@@ -1973,6 +1973,9 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
+// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -3512,7 +3515,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.279",
+  version: "0.3.280",
   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
@@ -7366,7 +7369,9 @@ var DeeplineClient = class _DeeplineClient {
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
       staticPipeline: isRecord4(play.staticPipeline) ? play.staticPipeline : isRecord4(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord4(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? { csvInput } : {},
+      ...csvInput ? {
+        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+      } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand: runCommand2,
       examples: [runCommand2],
@@ -35525,6 +35530,21 @@ function parsePlaySearchOptions(args) {
 function playSearchDisclaimer(scope) {
   return scope === "all" ? "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts, so they are listed before plays you created. Use created-play results only when you are specifically looking for one." : "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts. Plays you created are omitted by default; add --all only when you are specifically looking for one.";
 }
+function csvColumnLines(csvInput) {
+  const rowSchema = isRecord7(csvInput.rowInputSchema) ? csvInput.rowInputSchema : {};
+  const columns = isRecord7(rowSchema.properties) ? Object.keys(rowSchema.properties) : [];
+  const required = new Set(
+    Array.isArray(rowSchema.required) ? rowSchema.required.map(String) : []
+  );
+  const defaults = isRecord7(csvInput.defaultColumns) ? csvInput.defaultColumns : {};
+  return [
+    ...columns.map((column) => {
+      const headers = [defaults[column]].flat().filter((header) => header && header !== column);
+      return `${column}${required.has(column) ? " (required)" : ""}${headers.length > 0 ? `, default header: ${headers.join(" or ")}` : ""}`;
+    }),
+    CSV_HEADER_MATCHING_NOTE
+  ];
+}
 function printPlayDescription(play) {
   const reference = formatPlayListReference(play);
   const labels = [
@@ -35545,6 +35565,12 @@ function printPlayDescription(play) {
   if (play.pinned) {
     console.log("  Pinned: yes");
   }
+  if (play.csvInput) {
+    console.log("  CSV columns:");
+    for (const line of csvColumnLines(play.csvInput)) {
+      console.log(`    ${line}`);
+    }
+  }
   if (play.toolCategories?.length) {
     console.log(`  Tool categories: ${play.toolCategories.join(", ")}`);
   }

package/dist/cli/index.mjs

@@ -1960,6 +1960,9 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
+// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -3507,7 +3510,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.279",
+  version: "0.3.280",
   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
@@ -7361,7 +7364,9 @@ var DeeplineClient = class _DeeplineClient {
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
       staticPipeline: isRecord4(play.staticPipeline) ? play.staticPipeline : isRecord4(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord4(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? { csvInput } : {},
+      ...csvInput ? {
+        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+      } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand: runCommand2,
       examples: [runCommand2],
@@ -35598,6 +35603,21 @@ function parsePlaySearchOptions(args) {
 function playSearchDisclaimer(scope) {
   return scope === "all" ? "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts, so they are listed before plays you created. Use created-play results only when you are specifically looking for one." : "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts. Plays you created are omitted by default; add --all only when you are specifically looking for one.";
 }
+function csvColumnLines(csvInput) {
+  const rowSchema = isRecord7(csvInput.rowInputSchema) ? csvInput.rowInputSchema : {};
+  const columns = isRecord7(rowSchema.properties) ? Object.keys(rowSchema.properties) : [];
+  const required = new Set(
+    Array.isArray(rowSchema.required) ? rowSchema.required.map(String) : []
+  );
+  const defaults = isRecord7(csvInput.defaultColumns) ? csvInput.defaultColumns : {};
+  return [
+    ...columns.map((column) => {
+      const headers = [defaults[column]].flat().filter((header) => header && header !== column);
+      return `${column}${required.has(column) ? " (required)" : ""}${headers.length > 0 ? `, default header: ${headers.join(" or ")}` : ""}`;
+    }),
+    CSV_HEADER_MATCHING_NOTE
+  ];
+}
 function printPlayDescription(play) {
   const reference = formatPlayListReference(play);
   const labels = [
@@ -35618,6 +35638,12 @@ function printPlayDescription(play) {
   if (play.pinned) {
     console.log("  Pinned: yes");
   }
+  if (play.csvInput) {
+    console.log("  CSV columns:");
+    for (const line of csvColumnLines(play.csvInput)) {
+      console.log(`    ${line}`);
+    }
+  }
   if (play.toolCategories?.length) {
     console.log(`  Tool categories: ${play.toolCategories.join(", ")}`);
   }

package/dist/index.js

@@ -107,6 +107,9 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
+// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -1325,7 +1328,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.279",
+  version: "0.3.280",
   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
@@ -4866,7 +4869,9 @@ var DeeplineClient = class _DeeplineClient {
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
       staticPipeline: isRecord4(play.staticPipeline) ? play.staticPipeline : isRecord4(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord4(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? { csvInput } : {},
+      ...csvInput ? {
+        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+      } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand,
       examples: [runCommand],

package/dist/index.mjs

@@ -3,6 +3,9 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
+// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -1229,7 +1232,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.279",
+  version: "0.3.280",
   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
@@ -4770,7 +4773,9 @@ var DeeplineClient = class _DeeplineClient {
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
       staticPipeline: isRecord4(play.staticPipeline) ? play.staticPipeline : isRecord4(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord4(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? { csvInput } : {},
+      ...csvInput ? {
+        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+      } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand,
       examples: [runCommand],

package/dist/install-integrity.json

@@ -6,6 +6,7 @@
     "dist/bundling-sources/sdk/src/client.ts",
     "dist/bundling-sources/sdk/src/compat.ts",
     "dist/bundling-sources/sdk/src/config.ts",
+    "dist/bundling-sources/sdk/src/csv-header-matching.ts",
     "dist/bundling-sources/sdk/src/deployment-protection.ts",
     "dist/bundling-sources/sdk/src/errors.ts",
     "dist/bundling-sources/sdk/src/gtm.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.279";
+    readonly version: "0.3.280";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.279";
+    readonly version: "0.3.280";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,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.279",
+  version: "0.3.280",
   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

package/dist/release.mjs

@@ -48,7 +48,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.279",
+  version: "0.3.280",
   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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.279",
+  "version": "0.3.280",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",