deepline 0.3.406 → 0.3.408

package/dist/bundling-sources/shared_libs/play-runtime/tool-http-errors.ts

@@ -335,7 +335,13 @@ function formatInsufficientCreditsMessage(input: {
     getStringField(input.billing, 'operation_id') ??
     getStringField(input.billing, 'operation') ??
     input.toolId;
-  const balance = formatCreditAmount(input.billing.balance_credits);
+  // The explicit field is authoritative, including null. The older
+  // balance_credits field remains a fallback for already persisted errors.
+  const spendableBalance =
+    input.billing.spendable_balance_credits !== undefined
+      ? input.billing.spendable_balance_credits
+      : input.billing.balance_credits;
+  const balance = formatCreditAmount(spendableBalance);
   const required = formatCreditAmount(input.billing.required_credits);
   const recommended = formatCreditAmount(
     input.billing.recommended_add_credits ?? input.billing.needed_credits,
@@ -357,7 +363,7 @@ function formatInsufficientCreditsMessage(input: {
     typeof minimum === 'number' &&
     input.billing.required_credits === minimum
   ) {
-    return `Workspace balance ${balance} is below the ${formatCreditAmount(minimum)}-credit workspace minimum for starting a billable call (${operation}); this is a workspace-wide minimum, separate from the tool's own price.${estimatedPrice}${addSuffix}`;
+    return `Spendable workspace balance ${balance} credits is below the ${formatCreditAmount(minimum)}-credit workspace minimum for starting a billable call (${operation}); this is a workspace-wide minimum, separate from the tool's own price.${estimatedPrice} Spendable credits exclude pending spending and can be lower than the posted balance shown by billing balance.${addSuffix}`;
   }
   // A required balance above the call's estimate is headroom, not a price.
   if (
@@ -365,9 +371,9 @@ function formatInsufficientCreditsMessage(input: {
     typeof input.billing.required_credits === 'number' &&
     input.billing.required_credits > estimate
   ) {
-    return `Workspace balance ${balance} is below the ${required}-credit balance required to start ${operation}; this is a required balance, not the price.${estimatedPrice}${addSuffix}`;
+    return `Spendable workspace balance ${balance} credits is below the ${required}-credit balance required to start ${operation}; this is a required balance, not the price.${estimatedPrice} Spendable credits exclude pending spending and can be lower than the posted balance shown by billing balance.${addSuffix}`;
   }
-  return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
+  return `Spendable workspace balance ${balance} credits < required ${required} for ${operation}. Spendable credits exclude pending spending and can be lower than the posted balance shown by billing balance.${addSuffix}`;
 }
 
 /** An HTML document, as an edge proxy (Cloudflare, Vercel) serves for a 5xx. */

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -561,6 +561,16 @@ function parseExecuteToolMetadata(
     extractors: readExtractors(record.extractors),
     targetGetters: readGetters(record.targetGetters),
     listExtractorPaths,
+    ...(isRecord(record.listExtractorAliases)
+      ? {
+          listExtractorAliases: Object.fromEntries(
+            Object.entries(record.listExtractorAliases).filter(
+              (entry): entry is [string, string] =>
+                typeof entry[1] === 'string' && entry[1].length > 0,
+            ),
+          ),
+        }
+      : {}),
     listIdentityGetters: readGetters(record.listIdentityGetters),
   };
 }
@@ -725,6 +735,9 @@ function candidateResultPaths(path: string): string[] {
     providerPath,
     normalizeResultPath(path),
     toV2RawToolOutputPathPreservingProviderData(path),
+    ...(path.startsWith('result.data.')
+      ? [`toolResponse.raw.${path.slice('result.data.'.length)}`]
+      : []),
   ];
   return candidates.filter(
     (candidate, index, all) =>
@@ -1142,6 +1155,7 @@ function coerceToEnum(
 function resolveListRows(
   result: unknown,
   listExtractorPaths: readonly string[] | undefined,
+  aliases?: Readonly<Record<string, string>>,
 ): Record<string, { path: string; rows: Record<string, unknown>[] }> {
   const lists: Record<
     string,
@@ -1178,6 +1192,9 @@ function resolveListRows(
     }
     lists[listName] = resolved;
   }
+  for (const [alias, source] of Object.entries(aliases ?? {})) {
+    if (!lists[alias] && lists[source]) lists[alias] = lists[source];
+  }
   return lists;
 }
 
@@ -1546,6 +1563,7 @@ export function createToolExecuteResult<TResult = unknown>(input: {
   const resolvedLists = resolveListRows(
     resultRoot,
     input.metadata.listExtractorPaths,
+    input.metadata.listExtractorAliases,
   );
   const lists = buildLists(resolvedLists, input.metadata);
   const metadata = {
@@ -1553,6 +1571,9 @@ export function createToolExecuteResult<TResult = unknown>(input: {
     execution: input.execution,
     targets,
     listExtractorPaths: [...(input.metadata.listExtractorPaths ?? [])],
+    ...(input.metadata.listExtractorAliases
+      ? { listExtractorAliases: { ...input.metadata.listExtractorAliases } }
+      : {}),
     ...(input.metadata.extractors
       ? { extractors: input.metadata.extractors }
       : {}),
@@ -1849,6 +1870,7 @@ function serializedListRowsFromRaw(input: {
   const resolved = resolveListRows(
     { toolResponse: { raw: input.raw } },
     input.metadata.listExtractorPaths,
+    input.metadata.listExtractorAliases,
   );
   const entries = Object.entries(resolved).map(([name, list]) => [
     name,
@@ -2134,6 +2156,9 @@ function metadataInputFromToolExecuteResult(
     listExtractorPaths:
       value._metadata.listExtractorPaths ??
       Object.values(value._metadata.lists).map((list) => list.path),
+    ...(value._metadata.listExtractorAliases
+      ? { listExtractorAliases: { ...value._metadata.listExtractorAliases } }
+      : {}),
     listIdentityGetters: Object.fromEntries(
       Object.values(value._metadata.lists)
         .flatMap((list) => Object.entries(list.keys))
@@ -2479,6 +2504,53 @@ export function cloneToolExecuteResultWithExecution<TResult>(
   }) as ToolExecuteResult<TResult>;
 }
 
+/**
+ * Add current list getter declarations when replaying a result written by an
+ * older catalog. Stored declarations keep their precedence; the canonical
+ * provider response remains the source for any newly exposed getters.
+ */
+export function mergeToolExecuteResultListGetterMetadata(
+  value: ToolExecuteResult,
+  currentMetadata: Pick<
+    ToolResultMetadataInput,
+    'listExtractorPaths' | 'listExtractorAliases'
+  >,
+): ToolExecuteResult {
+  const serialized = serializeToolExecuteResult(value);
+  const storedMetadata = serialized.metadata;
+  const listExtractorPaths = [
+    ...new Set([
+      ...(storedMetadata.listExtractorPaths ?? []),
+      ...(currentMetadata.listExtractorPaths ?? []),
+    ]),
+  ];
+  const listExtractorAliases = {
+    ...(currentMetadata.listExtractorAliases ?? {}),
+    ...(storedMetadata.listExtractorAliases ?? {}),
+  };
+  const hasAliases = Object.keys(listExtractorAliases).length > 0;
+  if (
+    sameJsonValue(
+      listExtractorPaths,
+      storedMetadata.listExtractorPaths ?? [],
+    ) &&
+    sameJsonValue(
+      hasAliases ? listExtractorAliases : undefined,
+      storedMetadata.listExtractorAliases,
+    )
+  ) {
+    return value;
+  }
+  return deserializeToolExecuteResult({
+    ...serialized,
+    metadata: {
+      ...storedMetadata,
+      listExtractorPaths,
+      ...(hasAliases ? { listExtractorAliases } : {}),
+    },
+  });
+}
+
 /**
  * Native splitters return the logical source response; the historical adapter
  * stores it inside an extra `{ data }` layer. Keep that immutable receipt and

package/dist/bundling-sources/shared_libs/play-runtime/webhook-receipt-source-commit-retry.ts

@@ -0,0 +1,90 @@
+/**
+ * Retries only the idempotent Play webhook source transaction under known
+ * Convex OCC or availability failures. Keep application errors loud: this
+ * operation creates the durable delivery identity and delayed recovery work
+ * atomically, so callers may replay only this narrow boundary.
+ */
+const MAX_RETRIES = 5;
+const RETRY_BASE_MS = 25;
+const RETRY_MAX_MS = 400;
+
+function errorChainText(error: unknown): string {
+  const parts: string[] = [];
+  let current = error;
+  for (let depth = 0; depth < 4 && current instanceof Error; depth += 1) {
+    parts.push(`${current.name}: ${current.message}`);
+    current = current.cause;
+  }
+  return parts.join('\n');
+}
+
+function retryClass(error: unknown): 'occ' | 'service_unavailable' | null {
+  const message = errorChainText(error);
+  if (
+    /OptimisticConcurrencyControlFailure|write conflict|changed while this mutation was being run/i.test(
+      message,
+    )
+  ) {
+    return 'occ';
+  }
+  // Keep this narrow to Convex transport/outage/admission responses. A source
+  // commit is replay-safe, but an arbitrary application failure must stay loud.
+  if (
+    /TypeError:\s*fetch failed|ServiceUnavailable|Service temporarily unavailable|temporarily unavailable \(Code:\s*\d+\)|"code"\s*:\s*"(?:ExpiredInQueue|TooManyConcurrentRequests)"|"code"\s*:\s*"InternalServerError"[\s\S]*(?:Your request couldn't be completed\. Try again later\.|Your request timed out performing too many system operations\.)/i.test(
+      message,
+    )
+  ) {
+    return 'service_unavailable';
+  }
+  return null;
+}
+
+function retryDelayMs(attempt: number): number {
+  const ceiling = Math.min(RETRY_MAX_MS, RETRY_BASE_MS * 2 ** attempt);
+  return Math.floor(Math.random() * (ceiling + 1));
+}
+
+/** Replay the exact receipt mutation, not a broader provider or admission call. */
+export async function retryPlayWebhookReceiptSourceCommit<T>(
+  operation: () => Promise<T>,
+): Promise<T> {
+  const startedAt = Date.now();
+  let totalDelayMs = 0;
+  let failureClass: 'occ' | 'service_unavailable' | null = null;
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      const result = await operation();
+      if (attempt > 0) {
+        console.info('[play.webhook_delivery.source_commit_retry_outcome]', {
+          attemptsTotal: attempt + 1,
+          retriesTotal: attempt,
+          retryClass: failureClass,
+          recovered: true,
+          exhausted: false,
+          totalDelayMs,
+          totalElapsedMs: Date.now() - startedAt,
+        });
+      }
+      return result;
+    } catch (error) {
+      failureClass = retryClass(error);
+      if (failureClass === null || attempt >= MAX_RETRIES) {
+        if (failureClass !== null) {
+          console.warn('[play.webhook_delivery.source_commit_retry_outcome]', {
+            attemptsTotal: attempt + 1,
+            retriesTotal: attempt,
+            retryClass: failureClass,
+            recovered: false,
+            exhausted: attempt >= MAX_RETRIES,
+            totalDelayMs,
+            totalElapsedMs: Date.now() - startedAt,
+          });
+        }
+        throw error;
+      }
+      const delayMs = retryDelayMs(attempt);
+      totalDelayMs += delayMs;
+      await new Promise<void>((resolve) => setTimeout(resolve, delayMs));
+    }
+  }
+}

package/dist/bundling-sources/shared_libs/play-runtime/worker-api-types.ts

@@ -64,6 +64,11 @@ export const MODAL_SANDBOX_COMPUTE_PRICING_USD = {
   memoryGiBSecond: 0.00000667,
 } as const;
 
+// Modal bills one physical core as two vCPUs. This matches Deepline's standard
+// one-vCPU / one-GiB sandbox and stays beside the pure pricing contract so
+// Convex billing can use it without importing Modal's Node runtime config.
+export const MODAL_SANDBOX_CPU_CORES = 0.5;
+
 const NEON_COMPUTE_PRICING_USD = {
   cuHour: 0.106,
   defaultCu: 1,

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -1403,7 +1403,12 @@ export type PlayAuthoringFetchResponse = {
   /** Full response body as text, with any known secret values redacted. */
   bodyText: string;
   /**
-   * The parsed body, eagerly decoded at request time. Read it as a property — `const body = res.json`, never `await res.json()`. Null when the body is empty AND when it is not valid JSON: a malformed payload is reported as null rather than thrown, so check `res.ok` and fall back to `res.bodyText` before treating null as an empty result.
+   * The runtime parses the body at request time.
+   * Read the property with `const body = res.json`. Do not call `await res.json()`.
+   * The value is null when the body is empty or is not valid JSON.
+   * Malformed JSON produces null instead of an error.
+   *
+   * Check `res.ok`. Check `res.bodyText` before you interpret null as an empty response.
    */
   json: unknown | null;
 };

package/dist/bundling-sources/shared_libs/plays/tool-result-types.ts

@@ -94,6 +94,8 @@ export type ToolResultMetadata = {
   lists: Record<string, ToolResultListMetadata>;
   /** Original declarations preserve semantic accessor names across replay. */
   listExtractorPaths?: readonly string[];
+  /** Additional semantic names for another declared list; original names win. */
+  listExtractorAliases?: Readonly<Record<string, string>>;
   extractors?: Record<string, ToolResultExtractorDescriptor>;
 };
 
@@ -164,6 +166,8 @@ export type ToolResultMetadataInput = {
   extractors?: Record<string, ToolResultExtractorDescriptor>;
   targetGetters?: Record<string, readonly string[]>;
   listExtractorPaths?: readonly string[];
+  /** Additional semantic names for another declared list; original names win. */
+  listExtractorAliases?: Readonly<Record<string, string>>;
   listIdentityGetters?: Record<string, readonly string[]>;
 };
 
@@ -269,6 +273,8 @@ export type ToolExecuteResultBase<
     >;
     /** Original declarations preserve semantic accessor names across replay. */
     listExtractorPaths?: readonly string[];
+    /** Additional semantic names for another declared list; original names win. */
+    listExtractorAliases?: Readonly<Record<string, string>>;
   };
 };
 

package/dist/cli/auth-3GB2K636.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkBRJUESQVjs = require('./chunk-BRJUESQV.js');
+require('./chunk-Q3PUHXOY.js');
+require('./chunk-QUAQX3FQ.js');
+require('./chunk-Q2E4E4FJ.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-7P5AA3SN.js');
+require('./chunk-D6FFBSM5.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EXIT_WORKSPACE_MISMATCH = _chunkBRJUESQVjs.EXIT_WORKSPACE_MISMATCH; exports.authStatusLine = _chunkBRJUESQVjs.authStatusLine; exports.clearPendingClaim = _chunkBRJUESQVjs.clearPendingClaim; exports.clearSatisfiedPendingClaim = _chunkBRJUESQVjs.clearSatisfiedPendingClaim; exports.handleRegister = _chunkBRJUESQVjs.handleRegister; exports.handleStatus = _chunkBRJUESQVjs.handleStatus; exports.handleWait = _chunkBRJUESQVjs.handleWait; exports.httpJson = _chunkBRJUESQVjs.httpJson; exports.readPendingAuthClaim = _chunkBRJUESQVjs.readPendingAuthClaim; exports.readStatusBanner = _chunkBRJUESQVjs.readStatusBanner; exports.registerAuthCommands = _chunkBRJUESQVjs.registerAuthCommands; exports.reportSetupCompleted = _chunkBRJUESQVjs.reportSetupCompleted; exports.resolvePendingAuthClaimForResume = _chunkBRJUESQVjs.resolvePendingAuthClaimForResume; exports.statusBannerLine = _chunkBRJUESQVjs.statusBannerLine;

package/dist/cli/{auth-U7LIMXIS.mjs → auth-UVD3CUBB.mjs}

@@ -13,13 +13,13 @@ import {
   reportSetupCompleted,
   resolvePendingAuthClaimForResume,
   statusBannerLine
-} from "./chunk-2MLY2ZBT.mjs";
-import "./chunk-5IGBBYXH.mjs";
-import "./chunk-CGX4NSS3.mjs";
+} from "./chunk-IWBXJDZA.mjs";
+import "./chunk-4CFULMRB.mjs";
+import "./chunk-SD7MXAJA.mjs";
 import "./chunk-YHPYUZZX.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-NXGCO4JB.mjs";
-import "./chunk-42RUJLQI.mjs";
+import "./chunk-WTT6CLED.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {

package/dist/cli/{billing-KGGS3444.mjs → billing-BZVTXXLM.mjs}

@@ -2,7 +2,7 @@ import {
   DeeplineClient,
   iterateCursorPages,
   requireBillingIdempotencyKey
-} from "./chunk-7ZMVAV2B.mjs";
+} from "./chunk-LOYISF7S.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-JI2B4RZP.mjs";
 import "./chunk-EIMG75BT.mjs";
@@ -13,8 +13,8 @@ import {
   openInBrowser,
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-5IGBBYXH.mjs";
-import "./chunk-CGX4NSS3.mjs";
+} from "./chunk-4CFULMRB.mjs";
+import "./chunk-SD7MXAJA.mjs";
 import {
   AuthError,
   ConfigError
@@ -23,7 +23,7 @@ import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-42RUJLQI.mjs";
+import "./chunk-WTT6CLED.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -307,6 +307,22 @@ async function handleBalance(options) {
   const needsCredits = status === "no_billing" || status === "zero_balance" || status === "payment_method_only";
   const recovery = needsCredits ? balanceRecoveryForCredits() : null;
   const lines = [`Balance: ${payload.balance ?? "(unknown)"} credits`];
+  const spendable = payload.spendable_balance_credits;
+  if (payload.spendable_balance_status === "complete" && typeof spendable === "number") {
+    if (typeof payload.posted_balance_credits === "number") {
+      lines.push(`Posted wallet: ${payload.posted_balance_credits} credits.`);
+    }
+    lines.push(`Spendable: ${spendable} credits.`);
+    if (typeof payload.pending_spend_credits === "number") {
+      lines.push(
+        `Pending spending: ${payload.pending_spend_credits} credits \u2014 already committed, not yet debited.`
+      );
+    }
+  } else if (payload.spendable_balance_status !== void 0 || payload.exposure_status === "partial" || options.verbose) {
+    lines.push(
+      "Spendable balance is unavailable; the posted balance does not establish capacity for another call."
+    );
+  }
   const detail = [];
   const temporaryHolds = payload.temporary_hold_credits;
   if (typeof temporaryHolds === "number" && temporaryHolds > 0) {
@@ -1598,10 +1614,7 @@ Examples:
       ).option("--output <path>", "Write CSV to an explicit path").option("--run-id <run_id>", "Export ledger rows for one play run.").option("--operation <id>", "Export rows for one tool operation.").option(
         "--since <timestamp>",
         "Only export rows since ISO-8601 time or Unix milliseconds."
-      ).option(
-        "--json",
-        "Emit JSON output"
-      ).action(handleLedgerExportAll)
+      ).option("--json", "Emit JSON output").action(handleLedgerExportAll)
     )
   );
   billing.command("history").description("Export billing ledger history to CSV.").addHelpText(
@@ -1771,10 +1784,7 @@ Examples:
   deepline billing subscription status
   deepline billing subscription status
 `
-    ).option(
-      "--json",
-      "Emit JSON output"
-    ).action(handleSubscriptionStatus)
+    ).option("--json", "Emit JSON output").action(handleSubscriptionStatus)
   ).addCommand(
     new Command("cancel").description("Cancel the subscription at period end. Credits are kept.").addHelpText(
       "after",
@@ -1802,10 +1812,7 @@ Examples:
     ).option("--undo", "Reverse a pending cancellation before period end").option(
       "--dry-run",
       "Print the planned cancellation without calling the cancel endpoint"
-    ).option(
-      "--json",
-      "Emit JSON output"
-    ).action(handleSubscriptionCancel)
+    ).option("--json", "Emit JSON output").action(handleSubscriptionCancel)
   );
   billing.command("invoices").description("List subscription invoices and credit purchase receipts.").addHelpText(
     "after",