deepline 0.1.277 → 0.1.278

package/dist/bundling-sources/sdk/src/release.ts

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.277',
+  version: '0.1.278',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -1225,6 +1225,16 @@ export class PlayContextImpl {
   private readonly executionScope: RunExecutionScope;
   private logBuffer: string[] = [];
   private checkpoint: PlayCheckpoint;
+  /**
+   * Durable tool receipts are the replay/cache authority for the execution
+   * paths the host supports. Keeping the same completed result in this
+   * checkpoint retained every provider payload for the lifetime of a run and
+   * copied it again while serializing the terminal. Paths without a matching
+   * receipt API keep the legacy checkpoint cache so local/in-process replay
+   * and bulk-only hosts' direct calls still work.
+   */
+  private readonly durableMappedToolResultsBackedByReceipts: boolean;
+  private readonly durableDirectToolResultsBackedByReceipts: boolean;
   private steps: PlayStep[] = [];
   private explicitMapInvocationKeys = new Set<string>();
   /** The map step currently being built — substeps go here instead of top-level. */
@@ -1383,6 +1393,24 @@ export class PlayContextImpl {
   constructor(options: ContextOptions) {
     this.#options = options;
     this.checkpoint = options.checkpoint ?? emptyCheckpoint();
+    this.durableMappedToolResultsBackedByReceipts = Boolean(
+      (options.claimRuntimeStepReceipt || options.claimRuntimeStepReceipts) &&
+        (options.getRuntimeStepReceipt || options.getRuntimeStepReceipts) &&
+        (options.completeRuntimeStepReceipt ||
+          options.completeRuntimeStepReceipts),
+    );
+    this.durableDirectToolResultsBackedByReceipts = Boolean(
+      options.claimRuntimeStepReceipt &&
+        options.getRuntimeStepReceipt &&
+        options.completeRuntimeStepReceipt,
+    );
+    if (this.durableDirectToolResultsBackedByReceipts) {
+      // A resumed durable runner may receive a legacy checkpoint containing
+      // full tool results. Drop that redundant copy immediately and recover
+      // through the receipt store below. Bulk-only receipt contexts retain the
+      // checkpoint because direct tool calls cannot use the bulk claim path.
+      this.checkpoint.completedToolBatches = {};
+    }
     // The governance play id keys durable ctx receipts (durableCtxKey), the
     // cycle guard, and per-parent child-call counters. It must be the STABLE
     // play name — not the per-run workflow id — so receipts written by one
@@ -3077,16 +3105,25 @@ export class PlayContextImpl {
   private getCachedToolResult(
     toolId: string,
     rowCacheKey: string,
+    path: 'mapped' | 'direct' = 'mapped',
   ): ToolBatchResult | undefined {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return undefined;
+    }
     return this.checkpoint.completedToolBatches[toolId]?.[rowCacheKey];
   }
 
   private getCachedToolResultCandidate(
     toolId: string,
     rowCacheKeys: readonly string[],
+    path: 'mapped' | 'direct' = 'mapped',
   ): { cacheKey: string; result: ToolBatchResult } | null {
     for (const rowCacheKey of rowCacheKeys) {
-      const cached = this.getCachedToolResult(toolId, rowCacheKey);
+      const cached = this.getCachedToolResult(toolId, rowCacheKey, path);
       if (cached?.done) {
         return { cacheKey: rowCacheKey, result: cached };
       }
@@ -3098,7 +3135,15 @@ export class PlayContextImpl {
     toolId: string,
     rowCacheKey: string,
     result: unknown | null,
+    path: 'mapped' | 'direct' = 'mapped',
   ): void {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return;
+    }
     if (!this.checkpoint.completedToolBatches[toolId]) {
       this.checkpoint.completedToolBatches[toolId] = {};
     }
@@ -6349,7 +6394,11 @@ export class PlayContextImpl {
           ? null
           : toolCachePolicy.force
             ? null
-            : this.getCachedToolResultCandidate(toolId, checkpointCacheKeys);
+            : this.getCachedToolResultCandidate(
+                toolId,
+                checkpointCacheKeys,
+                'direct',
+              );
         if (cached) {
           this.log(`Calling tool: ${toolId} recovered from checkpoint`);
           return await this.wrapToolExecutionResult({
@@ -6429,13 +6478,7 @@ export class PlayContextImpl {
           }),
         });
         if (cacheableToolResult) {
-          this.checkpoint.completedToolBatches[toolId] = {
-            ...(this.checkpoint.completedToolBatches[toolId] ?? {}),
-            [directCacheKey]: {
-              done: true,
-              result: wrapped,
-            },
-          };
+          this.cacheToolResult(toolId, directCacheKey, wrapped, 'direct');
           this.#options.onBatchComplete?.(this.checkpoint);
         }
         return wrapped;
@@ -7348,23 +7391,27 @@ export class PlayContextImpl {
     const toolSettlements = await Promise.allSettled(
       [...byTool.entries()].map(async ([toolId, requests]) => {
         this.log(`Executing tool batch ${toolId}: ${requests.length} calls`);
-        const liveStepResults = new Map<string, unknown>();
+        const successfulLiveStepCallIds = new Set<string>();
 
         const recordToolStep = (stepRequests: ToolCallRequest[]): void => {
           if (stepRequests.length === 0) return;
           const stepResults: PlayStepRowResult[] = stepRequests.map((req) => {
-            const hasLiveResult = liveStepResults.has(req.callId);
-            const result = hasLiveResult
-              ? liveStepResults.get(req.callId)
-              : this.getCachedToolResult(toolId, req.cacheKey)?.result;
+            const success =
+              successfulLiveStepCallIds.has(req.callId) ||
+              this.getCachedToolResult(toolId, req.cacheKey)?.result != null;
             return {
               rowId: req.rowId,
-              status: result != null ? 'completed' : 'failed',
-              success: result != null,
-              value: result,
-              error: result != null ? null : 'Tool call failed',
+              status: success ? 'completed' : 'failed',
+              success,
+              error: success ? null : 'Tool call failed',
             };
           });
+          // Step traces are lifecycle observability, not a second row/receipt
+          // store. Keep only call ids long enough to record their bounded
+          // status preview.
+          for (const request of stepRequests) {
+            successfulLiveStepCallIds.delete(request.callId);
+          }
           const toolStep = {
             type: 'tool' as const,
             toolId,
@@ -7643,6 +7690,7 @@ export class PlayContextImpl {
             });
             this.cacheToolResult(toolId, request.cacheKey, wrapped);
             for (const waitingRequest of requestsForKey) {
+              successfulLiveStepCallIds.add(waitingRequest.callId);
               const resolver = this.toolCallResolvers.get(
                 waitingRequest.callId,
               );
@@ -7822,7 +7870,9 @@ export class PlayContextImpl {
                   execution?.jobId,
                   execution?.meta,
                 );
-                liveStepResults.set(owner.callId, result);
+                if (result != null) {
+                  successfulLiveStepCallIds.add(owner.callId);
+                }
                 resolveLiveFollowers(owner, result);
                 recordToolStep([owner]);
                 this.#options.onBatchComplete?.(this.checkpoint);
@@ -8110,7 +8160,9 @@ export class PlayContextImpl {
                     index += 1
                   ) {
                     const request = entry.request.memberRequests[index]!;
-                    liveStepResults.set(request.callId, resolvedResults[index]);
+                    if (resolvedResults[index] != null) {
+                      successfulLiveStepCallIds.add(request.callId);
+                    }
                     resolveLiveFollowers(request, resolvedResults[index]);
                   }
                 }
@@ -8150,7 +8202,9 @@ export class PlayContextImpl {
                 for (let index = 0; index < entries.length; index += 1) {
                   const entry = entries[index]!;
                   const result = resolvedResults[index];
-                  liveStepResults.set(entry.request.callId, result);
+                  if (result != null) {
+                    successfulLiveStepCallIds.add(entry.request.callId);
+                  }
                   resolveLiveFollowers(entry.request, result);
                   entry.resolve(result);
                 }

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.277",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.277",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.js

@@ -438,7 +438,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.277",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.277",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.277",
+  "version": "0.1.278",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {