deepline 0.1.11 → 0.1.12

package/dist/index.mjs

@@ -149,7 +149,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.11";
+var SDK_VERSION = "0.1.12";
 var SDK_API_CONTRACT = "2026-04-plays-v1";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -424,6 +424,9 @@ function sleep(ms) {
 
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
 function normalizePlayStatus(raw) {
   const status = typeof raw.status === "string" ? raw.status : typeof raw.temporalStatus === "string" ? mapLegacyTemporalStatus(raw.temporalStatus) : "running";
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : "";
@@ -476,12 +479,27 @@ var DeeplineClient = class {
     ).filter((field) => Boolean(field?.name)) : [];
     return fields.length > 0 ? { fields } : schema;
   }
-  playRunCommand(name) {
-    return `deepline plays run ${name} --input '{...}' --watch`;
+  schemaMetadata(schema, key) {
+    if (!isRecord(schema)) return null;
+    const value = schema[key];
+    return isRecord(value) ? value : null;
+  }
+  playRunCommand(play, options) {
+    const target = play.reference || play.name;
+    if (options?.csvInput) {
+      const inputField = typeof options.csvInput.inputField === "string" && options.csvInput.inputField.trim() ? options.csvInput.inputField.trim() : "csv";
+      return `deepline plays run ${target} --${inputField} leads.csv --watch`;
+    }
+    return `deepline plays run ${target} --input '{...}' --watch`;
   }
   summarizePlayListItem(play, options) {
     const aliases = play.aliases?.length ? play.aliases : [play.name];
-    const runCommand = this.playRunCommand(play.name);
+    const csvInput = this.schemaMetadata(play.inputSchema, "csvInput");
+    const rowOutputSchema = this.schemaMetadata(
+      play.outputSchema,
+      "rowOutputSchema"
+    );
+    const runCommand = this.playRunCommand(play, { csvInput });
     return {
       name: play.name,
       ...play.reference ? { reference: play.reference } : {},
@@ -493,6 +511,8 @@ var DeeplineClient = class {
       aliases,
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
+      ...csvInput ? { csvInput } : {},
+      ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand,
       examples: [runCommand],
       currentPublishedVersion: play.currentPublishedVersion ?? null,
@@ -559,50 +579,14 @@ var DeeplineClient = class {
     );
   }
   /**
-   * Execute a tool and return the extracted result.
-   *
-   * Sends the input payload to the tool and returns the `.result` field from the
-   * response. For the full response envelope (including job_id, credits, etc.),
-   * use {@link executeToolRaw}.
-   *
-   * @param toolId - Tool identifier (e.g. `"test_company_search"`)
-   * @param input - Tool-specific input parameters
-   * @returns The tool's output (shape varies by tool)
-   * @throws {@link DeeplineError} if the tool execution fails
+   * Execute a tool and return the standard execution envelope.
    *
-   * @example
-   * ```typescript
-   * const company = await client.executeTool('test_company_search', {
-   *   domain: 'stripe.com',
-   * });
-   * console.log(company); // { name: "Stripe", industry: "Financial Services", ... }
-   * ```
+   * The `result.data` field contains the provider payload. `result.meta`
+   * contains provider/upstream metadata such as HTTP status or paging details.
+   * Top-level fields such as `status`, `job_id`, and `billing` describe the
+   * Deepline execution.
    */
   async executeTool(toolId, input) {
-    const res = await this.http.post(
-      `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
-      { payload: input }
-    );
-    return res.result ?? res;
-  }
-  /**
-   * Execute a tool and return the full response envelope.
-   *
-   * Unlike {@link executeTool}, this returns the complete API response including
-   * `job_id`, `status`, `credits`, and the raw `result` object.
-   *
-   * @param toolId - Tool identifier
-   * @param input - Tool-specific input parameters
-   * @returns Full response with job metadata and result
-   *
-   * @example
-   * ```typescript
-   * const raw = await client.executeToolRaw('test_company_search', { domain: 'stripe.com' });
-   * console.log(`Job: ${raw.job_id}, Credits: ${raw.credits}`);
-   * console.log(`Result:`, raw.result);
-   * ```
-   */
-  async executeToolRaw(toolId, input) {
     return this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
       { payload: input }
@@ -1224,258 +1208,6 @@ var DeeplineClient = class {
   }
 };
 
-// src/tool-output.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-function isPlainObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-var EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-var PHONE_KEY_PATTERN = /(^|[_-])(phone|mobile|cell|telephone|tel)([_-]|$)|phone|mobile|telephone/i;
-function normalizeScalarString(value) {
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
-  }
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return String(value);
-  }
-  return null;
-}
-function looksLikeEmail(value) {
-  const candidate = normalizeScalarString(value);
-  if (!candidate || !EMAIL_PATTERN.test(candidate)) return null;
-  return candidate;
-}
-function looksLikePhone(value) {
-  const candidate = normalizeScalarString(value);
-  if (!candidate) return null;
-  const digits = candidate.replace(/\D/g, "");
-  if (digits.length < 7 || digits.length > 16) return null;
-  return candidate;
-}
-function findEmail(value, depth = 0) {
-  if (depth > 6) return null;
-  const direct = looksLikeEmail(value);
-  if (direct) return direct;
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      const nested = findEmail(entry, depth + 1);
-      if (nested) return nested;
-    }
-    return null;
-  }
-  if (!isPlainObject(value)) return null;
-  for (const [key, child] of Object.entries(value)) {
-    if (/email/i.test(key)) {
-      const keyed = looksLikeEmail(child);
-      if (keyed) return keyed;
-    }
-  }
-  for (const child of Object.values(value)) {
-    const nested = findEmail(child, depth + 1);
-    if (nested) return nested;
-  }
-  return null;
-}
-function findPhone(value, depth = 0) {
-  if (depth > 6) return null;
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      const nested = findPhone(entry, depth + 1);
-      if (nested) return nested;
-    }
-    return null;
-  }
-  if (!isPlainObject(value)) return null;
-  for (const [key, child] of Object.entries(value)) {
-    if (PHONE_KEY_PATTERN.test(key)) {
-      const keyed = looksLikePhone(child);
-      if (keyed) return keyed;
-    }
-  }
-  for (const child of Object.values(value)) {
-    const nested = findPhone(child, depth + 1);
-    if (nested) return nested;
-  }
-  return null;
-}
-function normalizeListExtractorPaths(paths) {
-  if (!Array.isArray(paths)) return [];
-  const seen = /* @__PURE__ */ new Set();
-  const normalized = [];
-  for (const rawPath of paths) {
-    if (typeof rawPath !== "string") continue;
-    const path = rawPath.trim();
-    if (!path) continue;
-    for (const candidate of [path, path.replace(/^result\./, "")]) {
-      if (!candidate || seen.has(candidate)) continue;
-      seen.add(candidate);
-      normalized.push(candidate);
-    }
-  }
-  return normalized;
-}
-var DeeplineToolCallResult = class {
-  constructor(value, options) {
-    this.value = value;
-    this.listExtractorPaths = normalizeListExtractorPaths(
-      options?.listExtractorPaths
-    );
-  }
-  value;
-  listExtractorPaths;
-  getEmail() {
-    return findEmail(this.value);
-  }
-  getPhone() {
-    return findPhone(this.value);
-  }
-  tryList(options) {
-    const explicitPaths = normalizeListExtractorPaths(options?.listExtractorPaths);
-    return tryConvertToList(this.value, {
-      listExtractorPaths: explicitPaths.length > 0 ? explicitPaths : this.listExtractorPaths
-    })?.rows ?? null;
-  }
-};
-function createToolCallResult(value, options) {
-  return new DeeplineToolCallResult(value, options);
-}
-function getByDottedPath(root, dottedPath) {
-  let current = root;
-  for (const segment of String(dottedPath || "").split(".").filter(Boolean)) {
-    if (!isPlainObject(current) || !(segment in current)) {
-      return null;
-    }
-    current = current[segment];
-  }
-  return current;
-}
-function normalizeRows(value) {
-  if (!Array.isArray(value)) return null;
-  return value.map((entry) => {
-    if (isPlainObject(entry)) return entry;
-    return { value: entry };
-  });
-}
-function candidateRoots(payload) {
-  const roots = [{ path: null, value: payload }];
-  if (isPlainObject(payload) && isPlainObject(payload.result)) {
-    roots.push({ path: "result", value: payload.result });
-    if (isPlainObject(payload.result.data)) {
-      roots.push({ path: "result.data", value: payload.result.data });
-    }
-  }
-  return roots;
-}
-function findBestArrayCandidate(value, pathPrefix = "", depth = 0) {
-  if (depth > 5) return null;
-  const directRows = normalizeRows(value);
-  const hasObjectRow = directRows?.some((row) => Object.keys(row).some((key) => key !== "value")) ?? false;
-  let best = directRows && directRows.length > 0 && hasObjectRow ? { path: pathPrefix, rows: directRows } : null;
-  if (!isPlainObject(value)) {
-    return best;
-  }
-  for (const [key, child] of Object.entries(value)) {
-    const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
-    const candidate = findBestArrayCandidate(child, childPath, depth + 1);
-    if (!candidate) continue;
-    if (!best || candidate.rows.length > best.rows.length) {
-      best = candidate;
-    }
-  }
-  return best;
-}
-function tryConvertToList(payload, options) {
-  const listExtractorPaths = Array.isArray(options?.listExtractorPaths) ? options?.listExtractorPaths.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [];
-  if (listExtractorPaths.length > 0) {
-    for (const root of candidateRoots(payload)) {
-      for (const extractorPath of listExtractorPaths) {
-        const resolved = getByDottedPath(root.value, extractorPath);
-        const rows = normalizeRows(resolved);
-        if (rows && rows.length > 0) {
-          const sourcePath = root.path ? `${root.path}.${extractorPath}` : extractorPath;
-          return { rows, strategy: "configured_paths", sourcePath };
-        }
-      }
-    }
-  }
-  for (const root of candidateRoots(payload)) {
-    const candidate = findBestArrayCandidate(root.value, root.path ?? "");
-    if (!candidate || candidate.rows.length === 0) continue;
-    return {
-      rows: candidate.rows,
-      strategy: "auto_detected",
-      sourcePath: candidate.path || root.path
-    };
-  }
-  return null;
-}
-function ensureOutputDir() {
-  const outputDir = join2(homedir2(), ".local", "share", "deepline", "data");
-  mkdirSync2(outputDir, { recursive: true });
-  return outputDir;
-}
-function writeJsonOutputFile(payload, stem) {
-  const outputDir = ensureOutputDir();
-  const outputPath = join2(outputDir, `${stem}_${Date.now()}.json`);
-  writeFileSync2(outputPath, JSON.stringify(payload, null, 2), "utf-8");
-  return outputPath;
-}
-function writeCsvOutputFile(rows, stem) {
-  const outputDir = ensureOutputDir();
-  const outputPath = join2(outputDir, `${stem}_${Date.now()}.csv`);
-  const seen = /* @__PURE__ */ new Set();
-  const columns = [];
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (!seen.has(key)) {
-        seen.add(key);
-        columns.push(key);
-      }
-    }
-  }
-  const escapeCell = (value) => {
-    const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
-    if (/[",\n]/.test(normalized)) {
-      return `"${normalized.replace(/"/g, '""')}"`;
-    }
-    return normalized;
-  };
-  const lines = [];
-  lines.push(columns.map(escapeCell).join(","));
-  for (const row of rows) {
-    lines.push(columns.map((column) => escapeCell(row[column])).join(","));
-  }
-  writeFileSync2(outputPath, `${lines.join("\n")}
-`, "utf-8");
-  const previewRows = rows.slice(0, 5);
-  const previewColumns = columns.slice(0, 5);
-  const preview = [
-    previewColumns.join(","),
-    ...previewRows.map((row) => previewColumns.map((column) => escapeCell(row[column])).join(","))
-  ].join("\n");
-  return {
-    path: outputPath,
-    rowCount: rows.length,
-    columns,
-    preview
-  };
-}
-function extractSummaryFields(payload) {
-  const candidates = candidateRoots(payload);
-  for (const candidate of candidates) {
-    if (!isPlainObject(candidate.value)) continue;
-    const summaryEntries = Object.entries(candidate.value).filter(([, value]) => {
-      return value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-    });
-    if (summaryEntries.length === 0) continue;
-    return Object.fromEntries(summaryEntries);
-  }
-  return {};
-}
-
 // src/play.ts
 var DeeplineConditionalStepResolver = class _DeeplineConditionalStepResolver {
   constructor(when2, run, elseValue) {
@@ -1614,12 +1346,8 @@ var DeeplineContext = class {
    * ```typescript
    * const tools = await ctx.tools.list();
    * const meta = await ctx.tools.get('apollo_people_search');
-   * const result = await ctx.tools.execute({
-   *   tool: 'test_company_search',
-   *   input: { domain: 'stripe.com' },
-   * });
-   * const rows = result.tryList({ listExtractorPaths: ['people'] });
-   * const email = result.getEmail();
+   * const companyLookup = await ctx.tools.execute('test_company_search', { domain: 'stripe.com' });
+   * const company = companyLookup.result.data;
    * ```
    */
   get tools() {
@@ -1628,16 +1356,8 @@ var DeeplineContext = class {
       list: () => this.client.listTools(),
       /** Get detailed metadata for a tool. */
       get: (toolId) => this.client.getTool(toolId),
-      /** Execute a tool and return an ergonomic result wrapper. */
-      execute: async (request) => {
-        const [metadata, value] = await Promise.all([
-          this.client.getTool(request.tool),
-          this.client.executeTool(request.tool, request.input)
-        ]);
-        return createToolCallResult(value, {
-          listExtractorPaths: metadata.listExtractorPaths ?? []
-        });
-      }
+      /** Execute a tool and return the standard execution envelope. */
+      execute: async (toolId, input) => this.client.executeTool(toolId, input)
     };
   }
   get plays() {
@@ -1840,6 +1560,147 @@ function getDefinedPlayMetadata(value) {
   }
   return candidate;
 }
+
+// src/tool-output.ts
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function getByDottedPath(root, dottedPath) {
+  let current = root;
+  for (const segment of String(dottedPath || "").split(".").filter(Boolean)) {
+    if (!isPlainObject(current) || !(segment in current)) {
+      return null;
+    }
+    current = current[segment];
+  }
+  return current;
+}
+function normalizeRows(value) {
+  if (!Array.isArray(value)) return null;
+  return value.map((entry) => {
+    if (isPlainObject(entry)) return entry;
+    return { value: entry };
+  });
+}
+function candidateRoots(payload) {
+  const roots = [{ path: null, value: payload }];
+  if (isPlainObject(payload) && isPlainObject(payload.result)) {
+    roots.push({ path: "result", value: payload.result });
+    if (isPlainObject(payload.result.data)) {
+      roots.push({ path: "result.data", value: payload.result.data });
+    }
+  }
+  return roots;
+}
+function findBestArrayCandidate(value, pathPrefix = "", depth = 0) {
+  if (depth > 5) return null;
+  const directRows = normalizeRows(value);
+  const hasObjectRow = directRows?.some((row) => Object.keys(row).some((key) => key !== "value")) ?? false;
+  let best = directRows && directRows.length > 0 && hasObjectRow ? { path: pathPrefix, rows: directRows } : null;
+  if (!isPlainObject(value)) {
+    return best;
+  }
+  for (const [key, child] of Object.entries(value)) {
+    const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
+    const candidate = findBestArrayCandidate(child, childPath, depth + 1);
+    if (!candidate) continue;
+    if (!best || candidate.rows.length > best.rows.length) {
+      best = candidate;
+    }
+  }
+  return best;
+}
+function tryConvertToList(payload, options) {
+  const listExtractorPaths = Array.isArray(options?.listExtractorPaths) ? options?.listExtractorPaths.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [];
+  if (listExtractorPaths.length > 0) {
+    for (const root of candidateRoots(payload)) {
+      for (const extractorPath of listExtractorPaths) {
+        const resolved = getByDottedPath(root.value, extractorPath);
+        const rows = normalizeRows(resolved);
+        if (rows && rows.length > 0) {
+          const sourcePath = root.path ? `${root.path}.${extractorPath}` : extractorPath;
+          return { rows, strategy: "configured_paths", sourcePath };
+        }
+      }
+    }
+  }
+  for (const root of candidateRoots(payload)) {
+    const candidate = findBestArrayCandidate(root.value, root.path ?? "");
+    if (!candidate || candidate.rows.length === 0) continue;
+    return {
+      rows: candidate.rows,
+      strategy: "auto_detected",
+      sourcePath: candidate.path || root.path
+    };
+  }
+  return null;
+}
+function ensureOutputDir() {
+  const outputDir = join2(homedir2(), ".local", "share", "deepline", "data");
+  mkdirSync2(outputDir, { recursive: true });
+  return outputDir;
+}
+function writeJsonOutputFile(payload, stem) {
+  const outputDir = ensureOutputDir();
+  const outputPath = join2(outputDir, `${stem}_${Date.now()}.json`);
+  writeFileSync2(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  return outputPath;
+}
+function writeCsvOutputFile(rows, stem) {
+  const outputDir = ensureOutputDir();
+  const outputPath = join2(outputDir, `${stem}_${Date.now()}.csv`);
+  const seen = /* @__PURE__ */ new Set();
+  const columns = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.has(key)) {
+        seen.add(key);
+        columns.push(key);
+      }
+    }
+  }
+  const escapeCell = (value) => {
+    const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
+    if (/[",\n]/.test(normalized)) {
+      return `"${normalized.replace(/"/g, '""')}"`;
+    }
+    return normalized;
+  };
+  const lines = [];
+  lines.push(columns.map(escapeCell).join(","));
+  for (const row of rows) {
+    lines.push(columns.map((column) => escapeCell(row[column])).join(","));
+  }
+  writeFileSync2(outputPath, `${lines.join("\n")}
+`, "utf-8");
+  const previewRows = rows.slice(0, 5);
+  const previewColumns = columns.slice(0, 5);
+  const preview = [
+    previewColumns.join(","),
+    ...previewRows.map((row) => previewColumns.map((column) => escapeCell(row[column])).join(","))
+  ].join("\n");
+  return {
+    path: outputPath,
+    rowCount: rows.length,
+    columns,
+    preview
+  };
+}
+function extractSummaryFields(payload) {
+  const candidates = candidateRoots(payload);
+  for (const candidate of candidates) {
+    if (!isPlainObject(candidate.value)) continue;
+    const summaryEntries = Object.entries(candidate.value).filter(([, value]) => {
+      return value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+    });
+    if (summaryEntries.length === 0) continue;
+    return Object.fromEntries(summaryEntries);
+  }
+  return {};
+}
 export {
   AuthError,
   ConfigError,
@@ -1851,7 +1712,6 @@ export {
   RateLimitError,
   SDK_API_CONTRACT,
   SDK_VERSION,
-  createToolCallResult,
   defineInput,
   definePlay,
   defineWorkflow,