deepline 0.1.56 → 0.1.57

package/dist/cli/index.js

@@ -220,10 +220,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.57",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.57",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/cli/index.mjs

@@ -197,10 +197,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.57",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.57",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/index.js

@@ -216,10 +216,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.57",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.57",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

package/dist/index.mjs

@@ -170,10 +170,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.57",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.57",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }

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

@@ -130,6 +130,12 @@ import type {
   LiveNodeProgressMap,
   LiveNodeProgressSnapshot,
 } from './runtime/live-progress';
+import {
+  ToolHttpError,
+  extractErrorBilling,
+  isHardBillingToolHttpError,
+  normalizeToolHttpErrorMessage,
+} from './runtime/tool-http-errors';
 
 // The play's default export. The bundler injects this — see bundle-play-file.ts.
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -195,23 +201,6 @@ const EXECUTE_TOOL_METADATA_HEADER = 'x-deepline-include-tool-metadata';
 const EXECUTE_RESPONSE_CONTRACT_HEADER = 'x-deepline-execute-response-contract';
 const V2_EXECUTE_RESPONSE_CONTRACT = 'v2-tool-execution-result';
 
-class ToolHttpError extends Error {
-  readonly billing: Record<string, unknown> | null;
-
-  constructor(message: string, billing: Record<string, unknown> | null) {
-    super(message);
-    this.name = 'ToolHttpError';
-    this.billing = billing;
-  }
-}
-
-function formatCreditAmount(value: unknown): string {
-  if (typeof value !== 'number' || !Number.isFinite(value)) {
-    return String(value ?? '-');
-  }
-  return Number(value.toFixed(8)).toString();
-}
-
 function getStringField(value: unknown, key: string): string | null {
   if (!isRecord(value)) return null;
   const field = value[key];
@@ -227,71 +216,6 @@ function getObjectField(
   return isRecord(field) ? field : null;
 }
 
-function isInsufficientCreditsBilling(
-  billing: Record<string, unknown> | null,
-): billing is Record<string, unknown> {
-  return billing?.kind === 'insufficient_credits';
-}
-
-function formatInsufficientCreditsMessage(input: {
-  billing: Record<string, unknown>;
-  toolId: string;
-}): string {
-  const operation =
-    getStringField(input.billing, 'operation_id') ??
-    getStringField(input.billing, 'operation') ??
-    input.toolId;
-  const balance = formatCreditAmount(input.billing.balance_credits);
-  const required = formatCreditAmount(input.billing.required_credits);
-  const recommended = formatCreditAmount(
-    input.billing.recommended_add_credits ?? input.billing.needed_credits,
-  );
-  const billingUrl = getStringField(input.billing, 'billing_url');
-  const addSuffix =
-    billingUrl && recommended !== '-'
-      ? ` Add >=${recommended} at ${billingUrl}.`
-      : billingUrl
-        ? ` Add credits at ${billingUrl}.`
-        : '';
-  return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
-}
-
-function normalizeToolHttpErrorMessage(input: {
-  toolId: string;
-  status: number;
-  attempt: number;
-  maxAttempts: number;
-  bodyText: string;
-}): ToolHttpError {
-  let parsed: Record<string, unknown> | null = null;
-  try {
-    const candidate = JSON.parse(input.bodyText);
-    parsed = isRecord(candidate) ? candidate : null;
-  } catch {
-    parsed = null;
-  }
-  const billing = getObjectField(parsed, 'billing');
-  if (isInsufficientCreditsBilling(billing)) {
-    return new ToolHttpError(
-      `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${formatInsufficientCreditsMessage(
-        {
-          billing,
-          toolId: input.toolId,
-        },
-      )}`,
-      billing,
-    );
-  }
-  return new ToolHttpError(
-    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${input.bodyText.slice(0, 500)}`,
-    billing,
-  );
-}
-
-function extractErrorBilling(error: unknown): Record<string, unknown> | null {
-  return error instanceof ToolHttpError ? error.billing : null;
-}
-
 /** R2 binding injected by the Worker runtime (when present in deploy metadata). */
 type WorkerEnv = {
   PLAYS_BUCKET?: R2Bucket;
@@ -1348,7 +1272,7 @@ async function callToolDirect(
       bodyText: text,
     });
     const retryable =
-      res.status === 429 ||
+      (res.status === 429 && !isHardBillingToolHttpError(lastError)) ||
       (res.status >= 500 && WORKER_RETRY_SAFE_5XX_TOOLS.has(toolId));
     if (!retryable || attempt >= maxAttempts) {
       throw lastError;

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

@@ -0,0 +1,198 @@
+export class ToolHttpError extends Error {
+  readonly billing: Record<string, unknown> | null;
+
+  constructor(message: string, billing: Record<string, unknown> | null) {
+    super(message);
+    this.name = 'ToolHttpError';
+    this.billing = billing;
+  }
+}
+
+function formatCreditAmount(value: unknown): string {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return String(value ?? '-');
+  }
+  return Number(value.toFixed(8)).toString();
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function getStringField(value: unknown, key: string): string | null {
+  if (!isRecord(value)) return null;
+  const field = value[key];
+  return typeof field === 'string' && field.trim() ? field : null;
+}
+
+function getObjectField(
+  value: unknown,
+  key: string,
+): Record<string, unknown> | null {
+  if (!isRecord(value)) return null;
+  const field = value[key];
+  return isRecord(field) ? field : null;
+}
+
+function isInsufficientCreditsBilling(
+  billing: Record<string, unknown> | null,
+): billing is Record<string, unknown> {
+  return billing?.kind === 'insufficient_credits';
+}
+
+function isHardBillingFailurePayload(
+  payload: Record<string, unknown> | null,
+): payload is Record<string, unknown> {
+  if (!payload) return false;
+  const category = String(
+    payload.error_category ?? payload.errorCategory ?? '',
+  ).toLowerCase();
+  const code = String(payload.code ?? payload.error_code ?? '').toUpperCase();
+  const message = String(
+    payload.error ?? payload.message ?? payload.failure_description ?? '',
+  ).toLowerCase();
+  if (category === 'billing') return true;
+  if (
+    code === 'INSUFFICIENT_CREDITS' ||
+    code === 'BILLING_CAP_EXCEEDED' ||
+    code === 'MONTHLY_BILLING_LIMIT_EXCEEDED'
+  ) {
+    return true;
+  }
+  return (
+    (message.includes('billing cap') ||
+      message.includes('monthly billing limit') ||
+      message.includes('rolling 30-day organization billing cap') ||
+      message.includes('insufficient credits')) &&
+    !message.includes('rate limit')
+  );
+}
+
+function normalizeHardBillingPayload(
+  payload: Record<string, unknown>,
+): Record<string, unknown> {
+  return {
+    kind: 'billing_cap_exceeded',
+    code:
+      typeof payload.code === 'string' && payload.code.trim()
+        ? payload.code
+        : 'MONTHLY_BILLING_LIMIT_EXCEEDED',
+    error_category: 'billing',
+    failure_origin:
+      typeof payload.failure_origin === 'string' && payload.failure_origin.trim()
+        ? payload.failure_origin
+        : 'deepline_billing',
+    message:
+      typeof payload.error === 'string' && payload.error.trim()
+        ? payload.error
+        : typeof payload.message === 'string' && payload.message.trim()
+          ? payload.message
+          : 'Deepline billing cap exceeded.',
+    ...payload,
+  };
+}
+
+function formatHardBillingFailureMessage(input: {
+  billing: Record<string, unknown>;
+  toolId: string;
+  status: number;
+  attempt: number;
+  maxAttempts: number;
+}): string {
+  const code = getStringField(input.billing, 'code');
+  const message =
+    getStringField(input.billing, 'message') ??
+    getStringField(input.billing, 'error') ??
+    'Deepline billing cap exceeded.';
+  return [
+    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}:`,
+    'Deepline billing cap exceeded.',
+    'Run halted before marking remaining rows processed.',
+    code ? `code=${code}.` : '',
+    message,
+  ]
+    .filter(Boolean)
+    .join(' ');
+}
+
+function formatInsufficientCreditsMessage(input: {
+  billing: Record<string, unknown>;
+  toolId: string;
+}): string {
+  const operation =
+    getStringField(input.billing, 'operation_id') ??
+    getStringField(input.billing, 'operation') ??
+    input.toolId;
+  const balance = formatCreditAmount(input.billing.balance_credits);
+  const required = formatCreditAmount(input.billing.required_credits);
+  const recommended = formatCreditAmount(
+    input.billing.recommended_add_credits ?? input.billing.needed_credits,
+  );
+  const billingUrl = getStringField(input.billing, 'billing_url');
+  const addSuffix =
+    billingUrl && recommended !== '-'
+      ? ` Add >=${recommended} at ${billingUrl}.`
+      : billingUrl
+        ? ` Add credits at ${billingUrl}.`
+        : '';
+  return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
+}
+
+export function normalizeToolHttpErrorMessage(input: {
+  toolId: string;
+  status: number;
+  attempt: number;
+  maxAttempts: number;
+  bodyText: string;
+}): ToolHttpError {
+  let parsed: Record<string, unknown> | null = null;
+  try {
+    const candidate = JSON.parse(input.bodyText);
+    parsed = isRecord(candidate) ? candidate : null;
+  } catch {
+    parsed = null;
+  }
+  const billing = getObjectField(parsed, 'billing');
+  if (isInsufficientCreditsBilling(billing)) {
+    return new ToolHttpError(
+      `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${formatInsufficientCreditsMessage(
+        {
+          billing,
+          toolId: input.toolId,
+        },
+      )}`,
+      billing,
+    );
+  }
+  const hardBillingPayload = isHardBillingFailurePayload(billing)
+    ? normalizeHardBillingPayload(billing)
+    : isHardBillingFailurePayload(parsed)
+      ? normalizeHardBillingPayload(parsed)
+      : null;
+  if (hardBillingPayload) {
+    return new ToolHttpError(
+      formatHardBillingFailureMessage({
+        billing: hardBillingPayload,
+        toolId: input.toolId,
+        status: input.status,
+        attempt: input.attempt,
+        maxAttempts: input.maxAttempts,
+      }),
+      hardBillingPayload,
+    );
+  }
+  return new ToolHttpError(
+    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${input.bodyText.slice(0, 500)}`,
+    billing,
+  );
+}
+
+export function extractErrorBilling(
+  error: unknown,
+): Record<string, unknown> | null {
+  return error instanceof ToolHttpError ? error.billing : null;
+}
+
+export function isHardBillingToolHttpError(error: unknown): boolean {
+  return error instanceof ToolHttpError && isHardBillingFailurePayload(error.billing);
+}

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

@@ -50,10 +50,10 @@ export type SdkRelease = {
 };
 
 export const SDK_RELEASE = {
-  version: '0.1.56',
+  version: '0.1.57',
   apiContract: '2026-05-play-tool-describe-starters',
   supportPolicy: {
-    latest: '0.1.56',
+    latest: '0.1.57',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
   },

package/package.json

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