deepline 0.1.47 → 0.1.49

package/dist/index.d.mts

@@ -1032,7 +1032,11 @@ declare class DeeplineClient {
      * console.log(`Found ${searchTools.length} search tools`);
      * ```
      */
-    listTools(): Promise<ToolDefinition[]>;
+    listTools(options?: {
+        categories?: string;
+        grep?: string;
+        grepMode?: 'all' | 'any' | 'phrase';
+    }): Promise<ToolDefinition[]>;
     /**
      * Search available tools using Deepline's ranked backend search.
      *
@@ -1392,7 +1396,11 @@ declare class DeeplineClient {
     stopRun(runId: string, options?: {
         reason?: string;
     }): Promise<StopPlayRunResult>;
-    listPlays(): Promise<PlayListItem[]>;
+    listPlays(options?: {
+        origin?: 'prebuilt' | 'owned';
+        grep?: string;
+        grepMode?: 'all' | 'any' | 'phrase';
+    }): Promise<PlayListItem[]>;
     searchPlays(options: {
         query: string;
         origin?: 'prebuilt' | 'owned';
@@ -1533,7 +1541,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.47";
+declare const SDK_VERSION = "0.1.49";
 declare const SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 /**
@@ -1851,6 +1859,7 @@ type ToolExecutionRequest = {
     tool: string;
     input: Record<string, unknown>;
     description?: string;
+    staleAfterSeconds?: number;
 };
 type StepResolver<Row, Value> = (row: Row, ctx: DeeplinePlayRuntimeContext, index: number) => Value | Promise<Value>;
 type ConditionalStepResolver<Row, Value, Else = null> = {
@@ -1934,7 +1943,10 @@ type CsvOptions = {
  *   const enriched = await ctx
  *     .map('companies', [{ domain: 'a.com' }, { domain: 'b.com' }])
  *     .step('company', (row, rowCtx) =>
- *       rowCtx.tool('company_search', 'test_company_search', { domain: row.domain }, {
+ *       rowCtx.tools.execute({
+ *         id: 'company_search',
+ *         tool: 'test_company_search',
+ *         input: { domain: row.domain },
  *         description: 'Look up company details by domain.',
  *       }))
  *     .run({ description: 'Look up company details.' });
@@ -1995,30 +2007,30 @@ interface DeeplinePlayRuntimeContext {
      *
      * @example Single tool per row
      * ```typescript
-   * const results = await ctx
-   *   .map('companies', leads)
-   *   .step('company', (row, ctx) =>
-   *     ctx.tools.execute({
-   *       id: 'company_search',
-   *       tool: 'test_company_search',
-   *       input: { domain: row.domain },
-   *       description: 'Look up company details by domain.',
-   *     }))
+     * const results = await ctx
+     *   .map('companies', leads)
+     *   .step('company', (row, ctx) =>
+     *     ctx.tools.execute({
+     *       id: 'company_search',
+     *       tool: 'test_company_search',
+     *       input: { domain: row.domain },
+     *       description: 'Look up company details by domain.',
+     *     }))
      *   .run({ description: 'Look up companies.' });
      * // [{ domain: 'stripe.com', company: { name: 'Stripe', ... } }, ...]
      * ```
      *
      * @example Multiple columns with pre/post logic
      * ```typescript
-   * const results = await ctx
-   *   .map('leads', leads)
-   *   .step('company', (row, ctx) =>
-   *     ctx.tools.execute({
-   *       id: 'company_search',
-   *       tool: 'test_company_search',
-   *       input: { domain: row.domain },
-   *       description: 'Look up company details by domain.',
-   *     }))
+     * const results = await ctx
+     *   .map('leads', leads)
+     *   .step('company', (row, ctx) =>
+     *     ctx.tools.execute({
+     *       id: 'company_search',
+     *       tool: 'test_company_search',
+     *       input: { domain: row.domain },
+     *       description: 'Look up company details by domain.',
+     *     }))
      *   .step('score', (row) =>
      *     row.company?.employeeCount > 100 ? 'enterprise' : 'smb')
      *   .run({ description: 'Enrich leads.' });
@@ -2035,22 +2047,19 @@ interface DeeplinePlayRuntimeContext {
          * @param request.input - Tool-specific input parameters
          * @returns The tool's output
          */
-        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest & {
+            staleAfterSeconds?: number;
+        }): Promise<ToolExecuteResult<TOutput>>;
     };
-    /**
-     * Execute a single tool by stable step key and tool ID.
-     *
-     * Shorthand for `ctx.tools.execute(...)`; this is the preferred spelling in
-     * row-level step programs.
-     */
-    tool<TOutput = LoosePlayObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
-        description?: string;
-    }): Promise<ToolExecuteResult<TOutput>>;
     runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
-    step<T>(id: string, run: () => T | Promise<T>): Promise<T>;
-    fetch(key: string, url: string | URL, init?: RequestInit): Promise<{
+    step<T>(id: string, run: () => T | Promise<T>, options?: {
+        staleAfterSeconds?: number;
+    }): Promise<T>;
+    fetch(key: string, url: string | URL, init?: RequestInit, options?: {
+        staleAfterSeconds?: number;
+    }): Promise<{
         ok: boolean;
         status: number;
         statusText: string;
@@ -2061,6 +2070,7 @@ interface DeeplinePlayRuntimeContext {
     }>;
     runPlay(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: {
         description?: string;
+        staleAfterSeconds?: number;
     }): Promise<Record<string, unknown>>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.

package/dist/index.d.ts

@@ -1032,7 +1032,11 @@ declare class DeeplineClient {
      * console.log(`Found ${searchTools.length} search tools`);
      * ```
      */
-    listTools(): Promise<ToolDefinition[]>;
+    listTools(options?: {
+        categories?: string;
+        grep?: string;
+        grepMode?: 'all' | 'any' | 'phrase';
+    }): Promise<ToolDefinition[]>;
     /**
      * Search available tools using Deepline's ranked backend search.
      *
@@ -1392,7 +1396,11 @@ declare class DeeplineClient {
     stopRun(runId: string, options?: {
         reason?: string;
     }): Promise<StopPlayRunResult>;
-    listPlays(): Promise<PlayListItem[]>;
+    listPlays(options?: {
+        origin?: 'prebuilt' | 'owned';
+        grep?: string;
+        grepMode?: 'all' | 'any' | 'phrase';
+    }): Promise<PlayListItem[]>;
     searchPlays(options: {
         query: string;
         origin?: 'prebuilt' | 'owned';
@@ -1533,7 +1541,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.47";
+declare const SDK_VERSION = "0.1.49";
 declare const SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 /**
@@ -1851,6 +1859,7 @@ type ToolExecutionRequest = {
     tool: string;
     input: Record<string, unknown>;
     description?: string;
+    staleAfterSeconds?: number;
 };
 type StepResolver<Row, Value> = (row: Row, ctx: DeeplinePlayRuntimeContext, index: number) => Value | Promise<Value>;
 type ConditionalStepResolver<Row, Value, Else = null> = {
@@ -1934,7 +1943,10 @@ type CsvOptions = {
  *   const enriched = await ctx
  *     .map('companies', [{ domain: 'a.com' }, { domain: 'b.com' }])
  *     .step('company', (row, rowCtx) =>
- *       rowCtx.tool('company_search', 'test_company_search', { domain: row.domain }, {
+ *       rowCtx.tools.execute({
+ *         id: 'company_search',
+ *         tool: 'test_company_search',
+ *         input: { domain: row.domain },
  *         description: 'Look up company details by domain.',
  *       }))
  *     .run({ description: 'Look up company details.' });
@@ -1995,30 +2007,30 @@ interface DeeplinePlayRuntimeContext {
      *
      * @example Single tool per row
      * ```typescript
-   * const results = await ctx
-   *   .map('companies', leads)
-   *   .step('company', (row, ctx) =>
-   *     ctx.tools.execute({
-   *       id: 'company_search',
-   *       tool: 'test_company_search',
-   *       input: { domain: row.domain },
-   *       description: 'Look up company details by domain.',
-   *     }))
+     * const results = await ctx
+     *   .map('companies', leads)
+     *   .step('company', (row, ctx) =>
+     *     ctx.tools.execute({
+     *       id: 'company_search',
+     *       tool: 'test_company_search',
+     *       input: { domain: row.domain },
+     *       description: 'Look up company details by domain.',
+     *     }))
      *   .run({ description: 'Look up companies.' });
      * // [{ domain: 'stripe.com', company: { name: 'Stripe', ... } }, ...]
      * ```
      *
      * @example Multiple columns with pre/post logic
      * ```typescript
-   * const results = await ctx
-   *   .map('leads', leads)
-   *   .step('company', (row, ctx) =>
-   *     ctx.tools.execute({
-   *       id: 'company_search',
-   *       tool: 'test_company_search',
-   *       input: { domain: row.domain },
-   *       description: 'Look up company details by domain.',
-   *     }))
+     * const results = await ctx
+     *   .map('leads', leads)
+     *   .step('company', (row, ctx) =>
+     *     ctx.tools.execute({
+     *       id: 'company_search',
+     *       tool: 'test_company_search',
+     *       input: { domain: row.domain },
+     *       description: 'Look up company details by domain.',
+     *     }))
      *   .step('score', (row) =>
      *     row.company?.employeeCount > 100 ? 'enterprise' : 'smb')
      *   .run({ description: 'Enrich leads.' });
@@ -2035,22 +2047,19 @@ interface DeeplinePlayRuntimeContext {
          * @param request.input - Tool-specific input parameters
          * @returns The tool's output
          */
-        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest): Promise<ToolExecuteResult<TOutput>>;
+        execute<TOutput = LoosePlayObject>(request: ToolExecutionRequest & {
+            staleAfterSeconds?: number;
+        }): Promise<ToolExecuteResult<TOutput>>;
     };
-    /**
-     * Execute a single tool by stable step key and tool ID.
-     *
-     * Shorthand for `ctx.tools.execute(...)`; this is the preferred spelling in
-     * row-level step programs.
-     */
-    tool<TOutput = LoosePlayObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
-        description?: string;
-    }): Promise<ToolExecuteResult<TOutput>>;
     runSteps<TInput extends Record<string, unknown>, TOutput>(program: StepProgram<TInput, any, TOutput>, input: TInput, options?: {
         description?: string;
     }): Promise<TOutput>;
-    step<T>(id: string, run: () => T | Promise<T>): Promise<T>;
-    fetch(key: string, url: string | URL, init?: RequestInit): Promise<{
+    step<T>(id: string, run: () => T | Promise<T>, options?: {
+        staleAfterSeconds?: number;
+    }): Promise<T>;
+    fetch(key: string, url: string | URL, init?: RequestInit, options?: {
+        staleAfterSeconds?: number;
+    }): Promise<{
         ok: boolean;
         status: number;
         statusText: string;
@@ -2061,6 +2070,7 @@ interface DeeplinePlayRuntimeContext {
     }>;
     runPlay(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: {
         description?: string;
+        staleAfterSeconds?: number;
     }): Promise<Record<string, unknown>>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.

package/dist/index.js

@@ -215,7 +215,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.47";
+var SDK_VERSION = "0.1.49";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -735,9 +735,18 @@ var DeeplineClient = class {
    * console.log(`Found ${searchTools.length} search tools`);
    * ```
    */
-  async listTools() {
+  async listTools(options) {
+    const params = new URLSearchParams();
+    if (options?.categories?.trim()) {
+      params.set("categories", options.categories.trim());
+    }
+    if (options?.grep?.trim()) {
+      params.set("grep", options.grep.trim());
+      params.set("grep_mode", options.grepMode ?? "all");
+    }
+    const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
-      "/api/v2/tools"
+      `/api/v2/tools${suffix}`
     );
     return res.tools;
   }
@@ -1372,9 +1381,17 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
-  async listPlays() {
+  async listPlays(options) {
+    const params = new URLSearchParams();
+    if (options?.origin) params.set("origin", options.origin);
+    if (options?.grep?.trim()) {
+      params.set("grep", options.grep.trim());
+      params.set("grep_mode", options.grepMode ?? "all");
+      params.set("limit", "60");
+    }
+    const suffix = params.toString() ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      "/api/v2/plays"
+      `/api/v2/plays${suffix}`
     );
     return response.plays ?? [];
   }
@@ -1620,7 +1637,7 @@ function toV2RawToolOutputPath(path) {
   if (normalized === "toolResponse.raw" || normalized.startsWith("toolResponse.raw.")) {
     return normalized;
   }
-  const rawPath = normalized.replace(/^result\.data\.?/, "").replace(/^result\.?/, "").replace(/^data\.?/, "").replace(/^\./, "");
+  const rawPath = normalized.replace(/^result\.data\.?/, "").replace(/^result(?:\.|$)/, "").replace(/^data\.?/, "").replace(/^\./, "");
   return rawPath ? `toolResponse.raw.${rawPath}` : "toolResponse.raw";
 }
 function isMeaningfulValue(value) {
@@ -1672,7 +1689,30 @@ function valuesAtSegments(current, segments, path = []) {
     return valuesAtSegments(current[segment], rest, [...path, segment]);
   }
   if (!isRecord2(current)) return [];
-  return valuesAtSegments(current[segment], rest, [...path, segment]);
+  const directMatches = valuesAtSegments(current[segment], rest, [
+    ...path,
+    segment
+  ]);
+  if (directMatches.length > 0 || typeof segment !== "string") {
+    return directMatches;
+  }
+  {
+    for (let end = segments.length; end > 1; end -= 1) {
+      const literalSegments = segments.slice(0, end);
+      if (!literalSegments.every((entry) => typeof entry === "string")) {
+        continue;
+      }
+      const literalKey = literalSegments.join(".");
+      if (!Object.prototype.hasOwnProperty.call(current, literalKey)) {
+        continue;
+      }
+      return valuesAtSegments(current[literalKey], segments.slice(end), [
+        ...path,
+        literalKey
+      ]);
+    }
+  }
+  return directMatches;
 }
 function getValuesAtPath(root, path) {
   return valuesAtSegments(root, parsePath(path)).map((entry) => entry.value);
@@ -1696,7 +1736,7 @@ function toV2RawToolOutputPathPreservingProviderData(path) {
   if (normalized === "toolResponse.raw" || normalized.startsWith("toolResponse.raw.")) {
     return normalized;
   }
-  const rawPath = normalized.replace(/^result\.?/, "").replace(/^\./, "");
+  const rawPath = normalized.replace(/^result(?:\.|$)/, "").replace(/^\./, "");
   return rawPath ? `toolResponse.raw.${rawPath}` : "toolResponse.raw";
 }
 function candidateResultPaths(path) {
@@ -1870,6 +1910,11 @@ function deriveListKeys(input) {
     for (const rawPath of paths) {
       const path = String(rawPath || "").trim().replace(/^\./, "");
       if (!path) continue;
+      const firstRow = input.rows[0];
+      if (firstRow && Object.prototype.hasOwnProperty.call(firstRow, path)) {
+        keys[target] = path;
+        break;
+      }
       for (const resultPath of candidateResultPaths(path)) {
         const directPrefix = `${listPrefix}.`;
         if (resultPath.startsWith(directPrefix)) {
@@ -2195,11 +2240,9 @@ var DeeplineContext = class {
       get: (toolId) => this.client.getTool(toolId),
       /** Execute a tool and return the standard execution envelope. */
       execute: async (toolId, input) => {
-        const response = await this.client.executeTool(
-          toolId,
-          input,
-          { includeToolMetadata: true }
-        );
+        const response = await this.client.executeTool(toolId, input, {
+          includeToolMetadata: true
+        });
         return toolExecutionEnvelopeToResult(toolId, response);
       }
     };
@@ -2348,9 +2391,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response) {
     metadata: {
       toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
       extractors: extractorDescriptorRecord(toolMetadata.extractors),
-      targetGetters: stringArrayRecord(
-        toolMetadata.targetGetters
-      ),
+      targetGetters: stringArrayRecord(toolMetadata.targetGetters),
       listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
       listIdentityGetters: stringArrayRecord(toolMetadata.listIdentityGetters)
     },

package/dist/index.mjs

@@ -169,7 +169,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.47";
+var SDK_VERSION = "0.1.49";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -689,9 +689,18 @@ var DeeplineClient = class {
    * console.log(`Found ${searchTools.length} search tools`);
    * ```
    */
-  async listTools() {
+  async listTools(options) {
+    const params = new URLSearchParams();
+    if (options?.categories?.trim()) {
+      params.set("categories", options.categories.trim());
+    }
+    if (options?.grep?.trim()) {
+      params.set("grep", options.grep.trim());
+      params.set("grep_mode", options.grepMode ?? "all");
+    }
+    const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
-      "/api/v2/tools"
+      `/api/v2/tools${suffix}`
     );
     return res.tools;
   }
@@ -1326,9 +1335,17 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
-  async listPlays() {
+  async listPlays(options) {
+    const params = new URLSearchParams();
+    if (options?.origin) params.set("origin", options.origin);
+    if (options?.grep?.trim()) {
+      params.set("grep", options.grep.trim());
+      params.set("grep_mode", options.grepMode ?? "all");
+      params.set("limit", "60");
+    }
+    const suffix = params.toString() ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      "/api/v2/plays"
+      `/api/v2/plays${suffix}`
     );
     return response.plays ?? [];
   }
@@ -1574,7 +1591,7 @@ function toV2RawToolOutputPath(path) {
   if (normalized === "toolResponse.raw" || normalized.startsWith("toolResponse.raw.")) {
     return normalized;
   }
-  const rawPath = normalized.replace(/^result\.data\.?/, "").replace(/^result\.?/, "").replace(/^data\.?/, "").replace(/^\./, "");
+  const rawPath = normalized.replace(/^result\.data\.?/, "").replace(/^result(?:\.|$)/, "").replace(/^data\.?/, "").replace(/^\./, "");
   return rawPath ? `toolResponse.raw.${rawPath}` : "toolResponse.raw";
 }
 function isMeaningfulValue(value) {
@@ -1626,7 +1643,30 @@ function valuesAtSegments(current, segments, path = []) {
     return valuesAtSegments(current[segment], rest, [...path, segment]);
   }
   if (!isRecord2(current)) return [];
-  return valuesAtSegments(current[segment], rest, [...path, segment]);
+  const directMatches = valuesAtSegments(current[segment], rest, [
+    ...path,
+    segment
+  ]);
+  if (directMatches.length > 0 || typeof segment !== "string") {
+    return directMatches;
+  }
+  {
+    for (let end = segments.length; end > 1; end -= 1) {
+      const literalSegments = segments.slice(0, end);
+      if (!literalSegments.every((entry) => typeof entry === "string")) {
+        continue;
+      }
+      const literalKey = literalSegments.join(".");
+      if (!Object.prototype.hasOwnProperty.call(current, literalKey)) {
+        continue;
+      }
+      return valuesAtSegments(current[literalKey], segments.slice(end), [
+        ...path,
+        literalKey
+      ]);
+    }
+  }
+  return directMatches;
 }
 function getValuesAtPath(root, path) {
   return valuesAtSegments(root, parsePath(path)).map((entry) => entry.value);
@@ -1650,7 +1690,7 @@ function toV2RawToolOutputPathPreservingProviderData(path) {
   if (normalized === "toolResponse.raw" || normalized.startsWith("toolResponse.raw.")) {
     return normalized;
   }
-  const rawPath = normalized.replace(/^result\.?/, "").replace(/^\./, "");
+  const rawPath = normalized.replace(/^result(?:\.|$)/, "").replace(/^\./, "");
   return rawPath ? `toolResponse.raw.${rawPath}` : "toolResponse.raw";
 }
 function candidateResultPaths(path) {
@@ -1824,6 +1864,11 @@ function deriveListKeys(input) {
     for (const rawPath of paths) {
       const path = String(rawPath || "").trim().replace(/^\./, "");
       if (!path) continue;
+      const firstRow = input.rows[0];
+      if (firstRow && Object.prototype.hasOwnProperty.call(firstRow, path)) {
+        keys[target] = path;
+        break;
+      }
       for (const resultPath of candidateResultPaths(path)) {
         const directPrefix = `${listPrefix}.`;
         if (resultPath.startsWith(directPrefix)) {
@@ -2149,11 +2194,9 @@ var DeeplineContext = class {
       get: (toolId) => this.client.getTool(toolId),
       /** Execute a tool and return the standard execution envelope. */
       execute: async (toolId, input) => {
-        const response = await this.client.executeTool(
-          toolId,
-          input,
-          { includeToolMetadata: true }
-        );
+        const response = await this.client.executeTool(toolId, input, {
+          includeToolMetadata: true
+        });
         return toolExecutionEnvelopeToResult(toolId, response);
       }
     };
@@ -2302,9 +2345,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response) {
     metadata: {
       toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
       extractors: extractorDescriptorRecord(toolMetadata.extractors),
-      targetGetters: stringArrayRecord(
-        toolMetadata.targetGetters
-      ),
+      targetGetters: stringArrayRecord(toolMetadata.targetGetters),
       listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
       listIdentityGetters: stringArrayRecord(toolMetadata.listIdentityGetters)
     },

package/dist/repo/apps/play-runner-workers/src/coordinator-entry.ts

@@ -2408,12 +2408,15 @@ export class RuntimeApi extends WorkerEntrypoint<CoordinatorEnv, undefined> {
         { status: 403, headers: { 'content-type': 'application/json' } },
       );
     }
-    const apiBaseUrl =
+    const configuredApiBaseUrl =
       typeof this.env.DEEPLINE_API_BASE_URL === 'string' &&
       this.env.DEEPLINE_API_BASE_URL.trim()
         ? this.env.DEEPLINE_API_BASE_URL.trim()
         : 'https://code.deepline.com';
-    const target = new URL(incoming.pathname + incoming.search, apiBaseUrl);
+    const target = new URL(
+      incoming.pathname + incoming.search,
+      configuredApiBaseUrl,
+    );
     const forwarded = new Request(target.toString(), request);
     const bypassToken = this.env.VERCEL_PROTECTION_BYPASS_TOKEN;
     if (typeof bypassToken === 'string' && bypassToken) {