deepline 0.1.80 → 0.1.81

package/dist/repo/apps/play-runner-workers/src/runtime/tool-http-errors.ts

@@ -139,6 +139,43 @@ function formatInsufficientCreditsMessage(input: {
   return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
 }
 
+function formatPublicToolErrorPayload(input: {
+  parsed: Record<string, unknown> | null;
+  bodyText: string;
+}): string {
+  if (!input.parsed) {
+    return input.bodyText.slice(0, 500);
+  }
+
+  const selected: Record<string, unknown> = {};
+  for (const key of [
+    'error',
+    'message',
+    'code',
+    'failure_origin',
+    'error_category',
+    'failure_description',
+    'operator_hint',
+    'failure_hint',
+    'details',
+    'provider',
+    'operation',
+    'request_id',
+    'requestId',
+    'credential_source',
+    'credential_owner',
+  ]) {
+    const value = input.parsed[key];
+    if (typeof value === 'string' && value.trim()) {
+      selected[key] = value;
+    }
+  }
+
+  return JSON.stringify(
+    Object.keys(selected).length > 0 ? selected : input.parsed,
+  ).slice(0, 1_500);
+}
+
 export function normalizeToolHttpErrorMessage(input: {
   toolId: string;
   status: number;
@@ -183,7 +220,12 @@ export function normalizeToolHttpErrorMessage(input: {
     );
   }
   return new ToolHttpError(
-    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${input.bodyText.slice(0, 500)}`,
+    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${formatPublicToolErrorPayload(
+      {
+        parsed,
+        bodyText: input.bodyText,
+      },
+    )}`,
     billing,
   );
 }

package/dist/repo/sdk/src/client.ts

@@ -1297,7 +1297,7 @@ export class DeeplineClient {
     }
     const query = params.size > 0 ? `?${params.toString()}` : '';
     const response = await this.http.get<Record<string, unknown>>(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}${query}`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}${query}`,
     );
     return normalizePlayStatus(response);
   }
@@ -1320,10 +1320,10 @@ export class DeeplineClient {
       options?.lastEventId && options.lastEventId.trim()
         ? { 'Last-Event-ID': options.lastEventId.trim() }
         : undefined;
-    const params = new URLSearchParams({ stream: 'true' });
+    const params = new URLSearchParams();
     params.set('mode', options?.mode ?? 'cli');
     for await (const event of this.http.streamSse<PlayLiveEvent>(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}?${params.toString()}`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
       { signal: options?.signal, headers },
     )) {
       if (event.scope === 'play') {
@@ -1346,7 +1346,7 @@ export class DeeplineClient {
    */
   async cancelPlay(workflowId: string): Promise<void> {
     await this.http.request(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       { method: 'POST' },
     );
   }
@@ -1362,7 +1362,7 @@ export class DeeplineClient {
     options?: { reason?: string },
   ): Promise<StopPlayRunResult> {
     return this.http.post<StopPlayRunResult>(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       options?.reason ? { reason: options.reason } : {},
     );
   }
@@ -1493,7 +1493,7 @@ export class DeeplineClient {
     runId: string,
     options?: RunsLogsOptions,
   ): Promise<RunsLogsResult> {
-    const status = await this.getRunStatus(runId);
+    const status = await this.getRunStatus(runId, { full: true });
     const logs = status.progress?.logs ?? [];
     const limit =
       typeof options?.limit === 'number' && Number.isFinite(options.limit)

package/dist/repo/sdk/src/release.ts

@@ -50,10 +50,10 @@ export type SdkRelease = {
 };
 
 export const SDK_RELEASE = {
-  version: '0.1.80',
+  version: '0.1.81',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.80',
+    latest: '0.1.81',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
   },

package/dist/repo/shared_libs/play-runtime/governor/coordinator-rate-state-backend.ts

@@ -40,8 +40,8 @@ const LEASE_BLOCK_SIZE = 16;
  * of a rolled-over window. Discarding stale blocks bounds that to sub-window.
  */
 const LEASE_BLOCK_TTL_MS = 250;
-/** Cap on how long the backend will park waiting on a saturated window. */
-const MAX_ACQUIRE_WAIT_MS = 5_000;
+/** Cap one coordinator-provided sleep hint; total wait is bounded by run timeout. */
+const MAX_ACQUIRE_SLEEP_MS = 5_000;
 
 export interface CoordinatorRatePort {
   /**
@@ -123,7 +123,6 @@ export class CoordinatorRateStateBackend implements RateStateBackend {
       return noopPacingPermit();
     }
 
-    const waitStartedAt = this.now();
     while (true) {
       if (signal?.aborted) {
         throw signal.reason instanceof Error
@@ -153,13 +152,14 @@ export class CoordinatorRateStateBackend implements RateStateBackend {
         }
         return noopPacingPermit();
       }
-      // Window saturated. Park for the hint, then re-acquire. Cap total wait so
-      // a stuck bucket surfaces through the Governor's wall-clock guard instead
-      // of hanging forever.
-      if (this.now() - waitStartedAt >= MAX_ACQUIRE_WAIT_MS) {
-        return noopPacingPermit();
-      }
-      const waitMs = Math.max(1, Math.min(response.waitMs, MAX_ACQUIRE_WAIT_MS));
+      // Window saturated. Park for the hint, then re-acquire. This is not a
+      // degraded coordinator: the limiter answered and said "wait", so granting
+      // here would violate the provider request-rate contract. Overall wait is
+      // bounded by the play runtime deadline / abort signal.
+      const waitMs = Math.max(
+        1,
+        Math.min(response.waitMs, MAX_ACQUIRE_SLEEP_MS),
+      );
       await this.sleep(waitMs);
     }
   }

package/package.json

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

package/dist/repo/shared_libs/play-runtime/tool-batch-executor.ts

@@ -1,149 +0,0 @@
-export type ToolBatchItem = {
-  itemKey: string;
-  payload: Record<string, unknown>;
-  inputHash?: string | null;
-};
-
-export type ToolBatchRequest = {
-  runId: string;
-  orgId: string;
-  toolId: string;
-  operation: string;
-  provider: string;
-  items: ToolBatchItem[];
-  waterfallId?: string | null;
-  stageId?: string | null;
-  fieldName?: string | null;
-  mapName?: string | null;
-  chunkIndex?: number | null;
-  userProvidedRateLimitKey?: string | null;
-  providerBatchSize: number;
-};
-
-export type ToolBatchItemResult = {
-  itemKey: string;
-  result: unknown;
-  cached?: boolean;
-};
-
-export type ToolBatchResult = {
-  runId: string;
-  toolId: string;
-  operation: string;
-  provider: string;
-  batchCount: number;
-  itemCount: number;
-  results: ToolBatchItemResult[];
-};
-
-export type ToolBatchExecutorTransport = {
-  executeProviderBatch(input: {
-    request: ToolBatchRequest;
-    batchIndex: number;
-    idempotencyKeys: string[];
-    rateLimitKey: string;
-    items: ToolBatchItem[];
-  }): Promise<ToolBatchItemResult[]>;
-};
-
-export type ToolBatchExecutor = {
-  executeToolBatch(request: ToolBatchRequest): Promise<ToolBatchResult>;
-};
-
-export function createToolBatchExecutor(
-  transport: ToolBatchExecutorTransport,
-): ToolBatchExecutor {
-  return {
-    async executeToolBatch(request) {
-      const providerBatchSize = Math.max(
-        1,
-        Math.floor(request.providerBatchSize),
-      );
-      const batches = chunkToolBatchItems(request.items, providerBatchSize);
-      const results: ToolBatchItemResult[] = [];
-      for (let batchIndex = 0; batchIndex < batches.length; batchIndex += 1) {
-        const items = batches[batchIndex]!;
-        results.push(
-          ...(await transport.executeProviderBatch({
-            request,
-            batchIndex,
-            items,
-            rateLimitKey: buildToolBatchRateLimitKey(request),
-            idempotencyKeys: items.map((item) =>
-              buildToolBatchIdempotencyKey(request, item),
-            ),
-          })),
-        );
-      }
-      return {
-        runId: request.runId,
-        toolId: request.toolId,
-        operation: request.operation,
-        provider: request.provider,
-        batchCount: batches.length,
-        itemCount: request.items.length,
-        results,
-      };
-    },
-  };
-}
-
-export function buildToolBatchIdempotencyKey(
-  request: ToolBatchRequest,
-  item: ToolBatchItem,
-): string {
-  return [
-    request.runId,
-    request.mapName ?? '',
-    request.chunkIndex ?? '',
-    item.itemKey,
-    request.fieldName ?? '',
-    request.waterfallId ?? '',
-    request.stageId ?? '',
-    item.inputHash ?? stableToolBatchHash(item.payload),
-  ].join(':');
-}
-
-export function buildToolBatchRateLimitKey(request: ToolBatchRequest): string {
-  return [
-    request.orgId,
-    request.provider,
-    request.operation,
-    request.userProvidedRateLimitKey ?? '',
-  ].join(':');
-}
-
-function chunkToolBatchItems(
-  items: readonly ToolBatchItem[],
-  size: number,
-): ToolBatchItem[][] {
-  const chunks: ToolBatchItem[][] = [];
-  for (let index = 0; index < items.length; index += size) {
-    chunks.push(items.slice(index, index + size));
-  }
-  return chunks;
-}
-
-function stableToolBatchHash(value: unknown): string {
-  const text = stableStringify(value);
-  let hash = 2166136261;
-  for (let index = 0; index < text.length; index += 1) {
-    hash ^= text.charCodeAt(index);
-    hash = Math.imul(hash, 16777619);
-  }
-  return (hash >>> 0).toString(36);
-}
-
-function stableStringify(value: unknown): string {
-  if (value === null || typeof value !== 'object') {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) {
-    return `[${value.map(stableStringify).join(',')}]`;
-  }
-  const record = value as Record<string, unknown>;
-  return `{${Object.keys(record)
-    .sort()
-    .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
-    .join(',')}}`;
-}