deepline 0.1.47 → 0.1.48

package/README.md

@@ -50,10 +50,10 @@ cd sdk && bun run build    # or: npm run sdk:build from root
 
 ## Env files
 
-| File                                 | Set by              | Contains                                  |
-| ------------------------------------ | ------------------- | ----------------------------------------- |
-| `~/.local/deepline/<host-slug>/.env` | SDK `auth register` | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY`   |
-| `.env.deepline`                      | Developer/agent     | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY`   |
+| File                                 | Set by              | Contains                                |
+| ------------------------------------ | ------------------- | --------------------------------------- |
+| `~/.local/deepline/<host-slug>/.env` | SDK `auth register` | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY` |
+| `.env.deepline`                      | Developer/agent     | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY` |
 
 The SDK CLI env contract is only `DEEPLINE_HOST_URL` and `DEEPLINE_API_KEY`.
 Do not route the SDK CLI through `.env`, `.env.local`, or `.env.worktree`.
@@ -257,27 +257,27 @@ export default definePlay('rate-limit-waterfall', async (ctx) => {
 
   const probeFallback = steps<{ lead_id: string; row_number: number }>()
     .step("primary_probe", (row, ctx) =>
-      ctx.tool({
+      ctx.tools.execute({
         id: 'rate_limit_probe',
         tool: 'test_rate_limit',
         input: {
-        key: 'redis-shared-scenario',
-        lead_id: row.lead_id,
-        row_number: row.row_number,
-      },
+          key: 'redis-shared-scenario',
+          lead_id: row.lead_id,
+          row_number: row.row_number,
+        },
         description: 'Exercise primary rate-limit behavior.',
       }))
     .step("backup_probe", when(
       (row) => !row.primary_probe,
       (row, ctx) =>
-        ctx.tool({
+        ctx.tools.execute({
           id: 'rate_limit_probe_backup',
           tool: 'test_rate_limit',
           input: {
-          key: 'redis-shared-scenario',
-          lead_id: row.lead_id,
-          row_number: row.row_number,
-        },
+            key: 'redis-shared-scenario',
+            lead_id: row.lead_id,
+            row_number: row.row_number,
+          },
           description: 'Exercise fallback rate-limit behavior.',
         }),
     ))

package/dist/cli/index.js

@@ -216,7 +216,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.47";
+var SDK_VERSION = "0.1.48";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -2795,8 +2795,10 @@ async function handleCheckout(options) {
 }
 async function handleRedeemCode(code, options) {
   const { http } = getAuthedHttpClient();
-  const payload = await http.post("/api/v2/billing/checkout/verify", { code });
-  const url = String(payload.url || "");
+  const payload = await http.post("/api/v2/billing/checkout", {
+    discountCode: code
+  });
+  const url = String(payload.url || payload.checkout_url || "");
   if (!options.json && !options.noOpen && url) openInBrowser(url);
   printCommandEnvelope({
     ...payload,

package/dist/cli/index.mjs

@@ -193,7 +193,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.47";
+var SDK_VERSION = "0.1.48";
 var SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -2777,8 +2777,10 @@ async function handleCheckout(options) {
 }
 async function handleRedeemCode(code, options) {
   const { http } = getAuthedHttpClient();
-  const payload = await http.post("/api/v2/billing/checkout/verify", { code });
-  const url = String(payload.url || "");
+  const payload = await http.post("/api/v2/billing/checkout", {
+    discountCode: code
+  });
+  const url = String(payload.url || payload.checkout_url || "");
   if (!options.json && !options.noOpen && url) openInBrowser(url);
   printCommandEnvelope({
     ...payload,

package/dist/index.d.mts

@@ -1533,7 +1533,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.47";
+declare const SDK_VERSION = "0.1.48";
 declare const SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 /**
@@ -1851,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> = {
@@ -1934,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.' });
@@ -1995,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.' });
@@ -2035,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;
@@ -2061,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.d.ts

@@ -1533,7 +1533,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.47";
+declare const SDK_VERSION = "0.1.48";
 declare const SDK_API_CONTRACT = "2026-05-stripe-promo-checkout";
 
 /**
@@ -1851,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> = {
@@ -1934,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.' });
@@ -1995,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.' });
@@ -2035,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;
@@ -2061,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.47";
+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.47";
+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)
     },