deepline 0.1.11 → 0.1.19

package/dist/index.mjs

@@ -42,6 +42,10 @@ var ConfigError = class extends DeeplineError {
 var PROD_URL = "https://code.deepline.com";
 var DEFAULT_TIMEOUT = 6e4;
 var DEFAULT_MAX_RETRIES = 3;
+var ACTIVE_DEEPLINE_ENV_FILE = ".env.deepline";
+function projectEnvStartDir() {
+  return process.env.DEEPLINE_PROJECT_ENV_DIR?.trim() || process.cwd();
+}
 function baseUrlSlug(baseUrl) {
   let url;
   try {
@@ -77,16 +81,52 @@ function parseEnvFile(filePath) {
   }
   return env;
 }
-function findNearestWorktreeEnv(startDir = process.cwd()) {
+function findNearestEnvFile(names, startDir = process.cwd()) {
   let current = resolve(startDir);
   while (true) {
-    const values = parseEnvFile(join(current, ".env.worktree"));
-    if (Object.keys(values).length > 0) return values;
+    for (const name of names) {
+      const filePath = join(current, name);
+      if (existsSync(filePath)) return filePath;
+    }
     const parent = dirname(current);
-    if (parent === current) return {};
+    if (parent === current) return null;
     current = parent;
   }
 }
+function findNearestEnv(names, startDir = process.cwd()) {
+  const filePath = findNearestEnvFile(names, startDir);
+  return filePath ? parseEnvFile(filePath) : {};
+}
+function findNearestWorktreeEnv(startDir = process.cwd()) {
+  return findNearestEnv([".env.worktree"], startDir);
+}
+function resolveProfileEnvFileNames() {
+  const explicitProfile = process.env.DEEPLINE_ENV_PROFILE?.trim() || process.env.DEEPLINE_PROFILE?.trim() || "";
+  const names = [];
+  if (explicitProfile) names.push(`.env.deepline.${explicitProfile}`);
+  const nodeEnv = process.env.NODE_ENV?.trim();
+  if (nodeEnv === "production") names.push(".env.deepline.prod");
+  else if (nodeEnv === "staging") names.push(".env.deepline.staging");
+  names.push(ACTIVE_DEEPLINE_ENV_FILE);
+  return names;
+}
+function resolveProjectAppEnvFileNames() {
+  const nodeEnv = process.env.NODE_ENV?.trim();
+  const names = [];
+  if (nodeEnv === "production") names.push(".env.prod");
+  if (nodeEnv === "staging") names.push(".env.staging");
+  names.push(".env.local", ".env");
+  return names;
+}
+function resolveBaseUrlFromEnvValues(env) {
+  return env.DEEPLINE_ORIGIN_URL?.trim() || env.DEEPLINE_API_BASE_URL?.trim() || "";
+}
+function loadProjectDeeplineEnv() {
+  return findNearestEnv(resolveProfileEnvFileNames(), projectEnvStartDir());
+}
+function loadProjectAppEnv() {
+  return findNearestEnv(resolveProjectAppEnvFileNames(), projectEnvStartDir());
+}
 function normalizeWorktreeBaseUrl(baseUrl, worktreeEnv = findNearestWorktreeEnv()) {
   const trimmed = baseUrl.trim().replace(/\/$/, "");
   if (!trimmed) return trimmed;
@@ -123,6 +163,10 @@ function autoDetectBaseUrl() {
   if (envOrigin) return normalizeWorktreeBaseUrl(envOrigin);
   const envBase = process.env.DEEPLINE_API_BASE_URL?.trim();
   if (envBase) return normalizeWorktreeBaseUrl(envBase);
+  const projectDeeplineBaseUrl = resolveBaseUrlFromEnvValues(loadProjectDeeplineEnv());
+  if (projectDeeplineBaseUrl) return normalizeWorktreeBaseUrl(projectDeeplineBaseUrl);
+  const projectAppBaseUrl = resolveBaseUrlFromEnvValues(loadProjectAppEnv());
+  if (projectAppBaseUrl) return normalizeWorktreeBaseUrl(projectAppBaseUrl);
   const worktreeBaseUrl = resolveWorktreeBaseUrl();
   if (worktreeBaseUrl) return worktreeBaseUrl;
   const globalEnv = loadGlobalCliEnv();
@@ -134,7 +178,9 @@ function resolveConfig(options) {
   const requestedBaseUrl = options?.baseUrl?.trim() || autoDetectBaseUrl();
   const baseUrl = normalizeWorktreeBaseUrl(requestedBaseUrl);
   const cliEnv = loadCliEnv(baseUrl);
-  const apiKey = options?.apiKey?.trim() || process.env.DEEPLINE_API_KEY?.trim() || cliEnv.DEEPLINE_API_KEY || "";
+  const projectDeeplineEnv = loadProjectDeeplineEnv();
+  const projectAppEnv = loadProjectAppEnv();
+  const apiKey = options?.apiKey?.trim() || process.env.DEEPLINE_API_KEY?.trim() || projectDeeplineEnv.DEEPLINE_API_KEY || projectAppEnv.DEEPLINE_API_KEY || cliEnv.DEEPLINE_API_KEY || "";
   if (!apiKey) {
     throw new ConfigError(
       `No API key found. Set DEEPLINE_API_KEY env var, pass apiKey option, or run: deepline auth register`
@@ -149,8 +195,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.11";
-var SDK_API_CONTRACT = "2026-04-plays-v1";
+var SDK_VERSION = "0.1.19";
+var SDK_API_CONTRACT = "2026-05-runs-v2";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -343,8 +389,12 @@ var HttpClient = class {
    * @param path - API path
    * @param body - Request body (will be JSON-serialized)
    */
-  async post(path, body) {
-    return this.request(path, { method: "POST", body });
+  async post(path, body, headers) {
+    return this.request(path, {
+      method: "POST",
+      body,
+      headers
+    });
   }
   /**
    * Send a DELETE request.
@@ -424,6 +474,10 @@ function sleep(ms) {
 
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
+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 : "";
@@ -453,6 +507,7 @@ function mapLegacyTemporalStatus(status) {
 var DeeplineClient = class {
   http;
   config;
+  runs;
   /**
    * @param options - Optional overrides for API key, base URL, timeout, and retries.
    * @throws {@link ConfigError} if no API key can be resolved from any source.
@@ -460,6 +515,13 @@ var DeeplineClient = class {
   constructor(options) {
     this.config = resolveConfig(options);
     this.http = new HttpClient(this.config);
+    this.runs = {
+      get: (runId) => this.getRunStatus(runId),
+      list: (options2) => this.listRuns(options2),
+      tail: (runId, options2) => this.tailRun(runId, options2),
+      logs: (runId, options2) => this.getRunLogs(runId, options2),
+      stop: (runId, options2) => this.stopRun(runId, options2)
+    };
   }
   /** The resolved base URL this client is targeting (e.g. `"http://localhost:3000"`). */
   get baseUrl() {
@@ -476,12 +538,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 +570,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,
@@ -531,6 +610,31 @@ var DeeplineClient = class {
     );
     return res.tools;
   }
+  /**
+   * Search available tools using Deepline's ranked backend search.
+   *
+   * This is the same discovery surface used by the legacy CLI: it ranks across
+   * tool metadata, categories, agent guidance, and input schema fields.
+   */
+  async searchTools(options = {}) {
+    const params = new URLSearchParams();
+    const query = options.query?.trim() ?? "";
+    params.set("q", query);
+    params.set(
+      "include_search_debug",
+      options.includeSearchDebug ? "true" : "false"
+    );
+    params.set("search_mode", options.searchMode ?? "v2");
+    if (options.categories?.trim()) {
+      params.set("categories", options.categories.trim());
+    }
+    if (options.searchTerms?.trim()) {
+      params.set("search_terms", options.searchTerms.trim());
+    }
+    return this.http.get(
+      `/api/v2/integrations/list?${params.toString()}`
+    );
+  }
   /**
    * Get detailed metadata for a single tool.
    *
@@ -559,55 +663,24 @@ 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}.
+   * Execute a tool and return the standard execution envelope.
    *
-   * @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
-   *
-   * @example
-   * ```typescript
-   * const company = await client.executeTool('test_company_search', {
-   *   domain: 'stripe.com',
-   * });
-   * console.log(company); // { name: "Stripe", industry: "Financial Services", ... }
-   * ```
-   */
-  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);
-   * ```
+   * 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 executeToolRaw(toolId, input) {
+  async executeTool(toolId, input, options) {
+    const headers = options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : void 0;
     return this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
-      { payload: input }
+      { payload: input },
+      headers
     );
   }
+  async executeToolRaw(toolId, input, options) {
+    return this.executeTool(toolId, input, options);
+  }
   async queryCustomerDb(input) {
     return this.http.post("/api/v2/db/query", {
       sql: input.sql,
@@ -656,6 +729,7 @@ var DeeplineClient = class {
       ...request.revisionId ? { revisionId: request.revisionId } : {},
       ...request.artifactStorageKey ? { artifactStorageKey: request.artifactStorageKey } : {},
       ...request.sourceCode ? { sourceCode: request.sourceCode } : {},
+      ...request.sourceFiles ? { sourceFiles: request.sourceFiles } : {},
       ..."staticPipeline" in request ? { staticPipeline: request.staticPipeline } : {},
       ...request.artifactHash ? { artifactHash: request.artifactHash } : {},
       ...request.graphHash ? { graphHash: request.graphHash } : {},
@@ -680,6 +754,7 @@ var DeeplineClient = class {
       ...request.revisionId ? { revisionId: request.revisionId } : {},
       ...request.artifactStorageKey ? { artifactStorageKey: request.artifactStorageKey } : {},
       ...request.sourceCode ? { sourceCode: request.sourceCode } : {},
+      ...request.sourceFiles ? { sourceFiles: request.sourceFiles } : {},
       ..."staticPipeline" in request ? { staticPipeline: request.staticPipeline } : {},
       ...request.artifactHash ? { artifactHash: request.artifactHash } : {},
       ...request.graphHash ? { graphHash: request.graphHash } : {},
@@ -716,6 +791,7 @@ var DeeplineClient = class {
     const compilerManifest = input.compilerManifest ?? await this.compilePlayManifest({
       name: input.name,
       sourceCode: input.sourceCode,
+      sourceFiles: input.sourceFiles,
       artifact: input.artifact
     });
     return this.http.post("/api/v2/plays/artifacts", {
@@ -730,6 +806,7 @@ var DeeplineClient = class {
         compilerManifest: artifact.compilerManifest ?? await this.compilePlayManifest({
           name: artifact.name,
           sourceCode: artifact.sourceCode,
+          sourceFiles: artifact.sourceFiles,
           artifact: artifact.artifact
         })
       }))
@@ -756,11 +833,13 @@ var DeeplineClient = class {
     const compilerManifest = input.compilerManifest ?? await this.compilePlayManifest({
       name: input.name,
       sourceCode: input.sourceCode,
+      sourceFiles: input.sourceFiles,
       artifact: input.artifact
     });
     const registeredArtifact = await this.registerPlayArtifact({
       name: input.name,
       sourceCode: input.sourceCode,
+      sourceFiles: input.sourceFiles,
       artifact: input.artifact,
       compilerManifest,
       publish: false
@@ -820,11 +899,13 @@ var DeeplineClient = class {
     const compilerManifest = options?.compilerManifest ?? await this.compilePlayManifest({
       name,
       sourceCode,
+      sourceFiles: options?.sourceFiles,
       artifact
     });
     const registeredArtifact = await this.registerPlayArtifact({
       name,
       sourceCode,
+      sourceFiles: options?.sourceFiles,
       artifact,
       compilerManifest,
       publish: false
@@ -1008,6 +1089,112 @@ var DeeplineClient = class {
     );
     return response.runs ?? [];
   }
+  /**
+   * Get a run by id using the public runs resource model.
+   *
+   * This is the SDK equivalent of:
+   *
+   * ```bash
+   * deepline runs get <run-id> --json
+   * ```
+   */
+  async getRunStatus(runId) {
+    const response = await this.http.get(
+      `/api/v2/runs/${encodeURIComponent(runId)}`
+    );
+    return normalizePlayStatus(response);
+  }
+  /**
+   * List play runs using the public runs resource model.
+   *
+   * This is the SDK equivalent of:
+   *
+   * ```bash
+   * deepline runs list --play <play-name> --status failed --json
+   * ```
+   */
+  async listRuns(options) {
+    const playName = options.play.trim();
+    if (!playName) {
+      throw new Error("runs.list requires options.play.");
+    }
+    const params = new URLSearchParams({ play: playName });
+    const status = options.status?.trim();
+    if (status) {
+      params.set("status", status);
+    }
+    const response = await this.http.get(
+      `/api/v2/runs?${params.toString()}`
+    );
+    return response.runs ?? [];
+  }
+  /**
+   * Fetch the lightweight tail status for a run using the public runs resource model.
+   *
+   * This is the SDK equivalent of:
+   *
+   * ```bash
+   * deepline runs tail <run-id> --json
+   * ```
+   */
+  async tailRun(runId, options) {
+    const afterLogIndex = typeof options?.afterLogIndex === "number" ? options.afterLogIndex : typeof options?.cursor === "number" ? options.cursor : typeof options?.cursor === "string" && options.cursor.trim() ? Number(options.cursor) : void 0;
+    const params = new URLSearchParams();
+    if (Number.isFinite(afterLogIndex)) {
+      params.set("afterLogIndex", String(Number(afterLogIndex)));
+    }
+    if (typeof options?.waitMs === "number") {
+      params.set("waitMs", String(options.waitMs));
+    }
+    if (options?.terminalOnly) {
+      params.set("terminalOnly", "true");
+    }
+    const suffix = params.toString() ? `?${params.toString()}` : "";
+    const response = await this.http.get(
+      `/api/v2/runs/${encodeURIComponent(runId)}/tail${suffix}`
+    );
+    return normalizePlayStatus(response);
+  }
+  /**
+   * Fetch persisted logs for a run using the public runs resource model.
+   *
+   * This is the SDK equivalent of:
+   *
+   * ```bash
+   * deepline runs logs <run-id> --limit 200 --json
+   * ```
+   */
+  async getRunLogs(runId, options) {
+    const status = await this.getRunStatus(runId);
+    const logs = status.progress?.logs ?? [];
+    const limit = typeof options?.limit === "number" && Number.isFinite(options.limit) ? Math.max(0, Math.trunc(options.limit)) : 200;
+    const entries = logs.slice(Math.max(0, logs.length - limit));
+    return {
+      runId: status.runId,
+      totalCount: logs.length,
+      returnedCount: entries.length,
+      firstSequence: logs.length === 0 ? null : logs.length - entries.length + 1,
+      lastSequence: logs.length === 0 ? null : logs.length,
+      truncated: logs.length > entries.length,
+      hasMore: logs.length > entries.length,
+      entries
+    };
+  }
+  /**
+   * Stop a run by id using the public runs resource model.
+   *
+   * This is the SDK equivalent of:
+   *
+   * ```bash
+   * deepline runs stop <run-id> --reason "stale lock" --json
+   * ```
+   */
+  async stopRun(runId, options) {
+    return this.http.post(
+      `/api/v2/runs/${encodeURIComponent(runId)}/stop`,
+      options?.reason ? { reason: options.reason } : {}
+    );
+  }
   async listPlays() {
     const response = await this.http.get(
       "/api/v2/plays"
@@ -1224,258 +1411,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 +1549,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 +1559,12 @@ 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,
+        { includeToolMetadata: true }
+      )
     };
   }
   get plays() {
@@ -1840,6 +1767,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 +1919,6 @@ export {
   RateLimitError,
   SDK_API_CONTRACT,
   SDK_VERSION,
-  createToolCallResult,
   defineInput,
   definePlay,
   defineWorkflow,
@@ -1864,4 +1931,3 @@ export {
   writeCsvOutputFile,
   writeJsonOutputFile
 };
-//# sourceMappingURL=index.mjs.map