deepline 0.3.235 → 0.3.237

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

@@ -2047,6 +2047,8 @@ export type BillingRecentUsageEntry = {
     | 'pending'
     | 'free'
     | 'failed';
+  /** Final billing truth may be unknown even after execution completes. */
+  charge_finality?: 'final' | 'pending' | 'unknown';
   rough_usd_cost: number | null;
   created_at: string;
 };
@@ -2076,6 +2078,10 @@ export type BillingUsageResult = {
     run_id: string | null;
     request_id?: string;
     total: number;
+    /** Only true when total covers the complete matching history. */
+    total_is_exact?: boolean;
+    /** Proven matching entries, without assuming unscanned rows match. */
+    total_lower_bound?: number;
     offset: number;
     limit: number;
     next_offset: number;

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

@@ -204,6 +204,18 @@ function describeRequestTarget(path: string): string {
   return 'Deepline';
 }
 
+function networkDiagnosticUrl(value: string): string | undefined {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== 'https:' && url.protocol !== 'http:') return undefined;
+    // Diagnostics never retain URL credentials, query values, or fragments.
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    // Preserve the original transport failure for malformed request URLs.
+    return undefined;
+  }
+}
+
 function providerLabelFromToolId(toolId: string): string {
   const normalized = toolId.trim().toLowerCase();
   const provider = normalized.split(/[_:./-]+/)[0];
@@ -379,6 +391,10 @@ export class HttpClient {
     const baseUrl = this.config.baseUrl;
     const url = `${baseUrl}${path}`;
     const method = options?.method ?? 'GET';
+    const requestStartedAt = Date.now();
+    let fetchAttempts = 0;
+    let lastRequestUrl = url;
+    let networkFailedAt: number | undefined;
 
     const headers = this.authHeaders(options?.headers);
 
@@ -397,6 +413,7 @@ export class HttpClient {
     requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
       if (options?.signal?.aborted) {
         lastError = requestCancelledError(options.signal);
+        networkFailedAt = Date.now();
         break;
       }
       if (attempt > 0) {
@@ -410,6 +427,7 @@ export class HttpClient {
           await sleep(delayMs, options?.signal);
         } catch (error) {
           lastError = error instanceof Error ? error : new Error(String(error));
+          networkFailedAt = Date.now();
           break;
         }
       }
@@ -417,6 +435,7 @@ export class HttpClient {
       for (const candidateUrl of candidateUrls) {
         if (options?.signal?.aborted) {
           lastError = requestCancelledError(options.signal);
+          networkFailedAt = Date.now();
           break requestAttempts;
         }
         const controller = new AbortController();
@@ -432,17 +451,20 @@ export class HttpClient {
         });
 
         try {
+          const requestBody =
+            options?.formData !== undefined
+              ? typeof options.formData === 'function'
+                ? options.formData()
+                : options.formData
+              : options?.body !== undefined
+                ? JSON.stringify(options.body)
+                : undefined;
+          fetchAttempts += 1;
+          lastRequestUrl = candidateUrl;
           const response = await fetch(candidateUrl, {
             method,
             headers,
-            body:
-              options?.formData !== undefined
-                ? typeof options.formData === 'function'
-                  ? options.formData()
-                  : options.formData
-                : options?.body !== undefined
-                  ? JSON.stringify(options.body)
-                  : undefined,
+            body: requestBody,
             signal: controller.signal,
           });
 
@@ -605,6 +627,7 @@ export class HttpClient {
           return parsed as T;
         } catch (error) {
           clearTimeout(timeoutId);
+          networkFailedAt = Date.now();
           if (options?.signal?.aborted) {
             lastError = requestCancelledError(options.signal);
             break requestAttempts;
@@ -637,6 +660,19 @@ export class HttpClient {
       lastError,
       describeRequestTarget(path),
     );
+    const failedAt = networkFailedAt ?? Date.now();
+    const diagnosticUrl = networkDiagnosticUrl(lastRequestUrl);
+    const networkDetails = {
+      ...mappedNetworkError.details,
+      request: {
+        method,
+        ...(diagnosticUrl === undefined ? {} : { url: diagnosticUrl }),
+        failedAtUtc: new Date(failedAt).toISOString(),
+        // Elapsed time covers the entire logical request, including retries.
+        elapsedMs: Math.max(0, failedAt - requestStartedAt),
+        attempts: fetchAttempts,
+      },
+    };
     if (options?.toolId) {
       const code = mappedNetworkError.code;
       throw withErrorCause(
@@ -662,7 +698,7 @@ export class HttpClient {
                   ? 'unknown'
                   : 'unavailable',
             networkScope: 'client_to_deepline',
-            details: mappedNetworkError.details,
+            details: networkDetails,
             publicDetails: options.idempotencyKey
               ? { idempotencyKey: options.idempotencyKey }
               : null,
@@ -676,7 +712,7 @@ export class HttpClient {
         withCoworkNetworkHint(mappedNetworkError.message),
         undefined,
         mappedNetworkError.code,
-        mappedNetworkError.details,
+        networkDetails,
       ),
       lastError,
     );

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.235',
+  version: '0.3.237',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-pool.ts

@@ -11,6 +11,7 @@
  * cross-call session state.
  */
 import { createRequire } from 'node:module';
+import { AsyncLocalStorage } from 'node:async_hooks';
 import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import {
@@ -30,6 +31,18 @@ import {
 
 export { ABSURD_SCHEMA_VERSION };
 
+const absurdSchedulerQuerySignal = new AsyncLocalStorage<AbortSignal>();
+
+/** Applies cancellation to this async operation's Absurd SQL calls only.
+ * The SDK has no signal argument; keep cancellation in its Deepline adapter,
+ * without affecting other tasks sharing the same queryable or pool. */
+export function runWithAbsurdSchedulerQuerySignal<T>(
+  signal: AbortSignal,
+  operation: () => Promise<T>,
+): Promise<T> {
+  return absurdSchedulerQuerySignal.run(signal, operation);
+}
+
 /**
  * Builds an SDK `Queryable` backed by the hardened runtime scheduler pool.
  * Every query runs on a freshly checked-out pooled client and releases it,
@@ -43,13 +56,19 @@ export function absurdQueryableForRuntimeScheduler(
       sql: string,
       params?: unknown[],
     ): Promise<QueryResult<Row>> => {
-      return withRuntimeSchedulerClient(poolOptions, async (client) => {
-        const result = await client.query<Row & Record<string, unknown>>(
-          sql,
-          params,
-        );
-        return { rows: result.rows as Row[] };
-      });
+      const signal = absurdSchedulerQuerySignal.getStore();
+      return withRuntimeSchedulerClient(
+        poolOptions,
+        async (client) => {
+          const result = await client.query<Row & Record<string, unknown>>(
+            sql,
+            params,
+          );
+          return { rows: result.rows as Row[] };
+        },
+        undefined,
+        { signal },
+      );
     },
   };
 }