deepline 0.1.46 → 0.1.48

package/dist/index.d.ts

@@ -221,6 +221,22 @@ interface CustomerDbQueryResult {
     columns: CustomerDbColumn[];
     rows: unknown[];
 }
+interface ToolPricingSummary {
+    /** User-facing pricing text for quick discovery displays. */
+    displayText: string | null;
+    /** User-facing unit the price applies to. */
+    unit: 'call' | 'result' | 'page' | 'usage' | null;
+    /** Deepline credits charged per unit, when statically knowable. */
+    creditsPerUnit: number | null;
+    /** USD equivalent charged per unit, when statically knowable. */
+    usdPerUnit: number | null;
+    /** Currency for `usdPerUnit`. */
+    currency: 'USD';
+    /** Short user-facing pricing summary for variable pricing. */
+    summary: string | null;
+    /** Additional user-facing pricing notes. */
+    details: string[];
+}
 /**
  * Summary definition of a tool, returned by {@link DeeplineClient.listTools}.
  *
@@ -255,6 +271,8 @@ interface ToolDefinition {
     inputSchema?: Record<string, unknown>;
     /** JSON Schema describing the tool's output shape. */
     outputSchema?: Record<string, unknown>;
+    /** User-facing pricing summary. Internal provider/settlement costs are intentionally omitted. */
+    pricing?: ToolPricingSummary | null;
     /** Copyable play-runtime guidance for V2 tool execution results. */
     usageGuidance?: {
         execute?: string;
@@ -327,6 +345,10 @@ interface ToolSearchResult {
     search_mode?: 'v1' | 'v2';
     search_fallback_to_category?: boolean;
     omitted_plays_hint?: string;
+    commandTemplates?: {
+        describe?: string;
+        execute?: string;
+    };
     render?: {
         sections?: Array<{
             title: string;
@@ -357,11 +379,11 @@ interface ToolMetadata extends ToolDefinition {
     asyncGetAction?: string | null;
     /** Known failure scenarios and their expected handling. */
     failureMode?: Record<string, unknown> | null;
-    /** Provider-side pricing structure. */
+    /** Sanitized pricing model for describe metadata. Provider internal prices are intentionally omitted. */
     cost?: Record<string, unknown> | null;
-    /** How many Deepline credits map to one provider pricing unit. */
+    /** Deepline credits charged for one user-visible pricing unit. */
     deeplineCreditsPerPricingUnit?: number | null;
-    /** Whether cost is billed by the provider or by Deepline. */
+    /** Whether the customer pays with Deepline credits or their own connected account. */
     billingSource?: string;
     /** Display label for the billing source. */
     billingSourceLabel?: string;
@@ -1511,7 +1533,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.46";
+declare const SDK_VERSION = "0.1.48";
 declare const SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 /**
@@ -1829,6 +1851,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> = {
@@ -1912,7 +1935,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.' });
@@ -1973,30 +1999,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.' });
@@ -2013,22 +2039,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;
@@ -2039,6 +2062,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.46";
+var SDK_VERSION = "0.1.48";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -2195,11 +2195,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 +2346,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.46";
+var SDK_VERSION = "0.1.48";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -2149,11 +2149,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 +2300,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)
     },