deepline 0.3.235 → 0.3.236

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.236',
   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 },
+      );
     },
   };
 }

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

@@ -221,6 +221,7 @@ import {
   type RuntimeSchedulerPoolOptions,
   withRuntimeSchedulerClient,
 } from './postgres-pool';
+import { runWithAbsurdSchedulerQuerySignal } from './absurd-pool';
 import {
   createPostgresSchedulerProgressReporter,
   type PostgresSchedulerProgressReporter,
@@ -550,7 +551,10 @@ export async function runWithAbsurdExecutionLeaseHeartbeat<T>(input: {
     lastHeartbeatAt = now;
     heartbeatState.inFlight = (async () => {
       try {
-        await input.ctx.heartbeat();
+        await runWithAbsurdSchedulerQuerySignal(
+          cancellationController.signal,
+          () => input.ctx.heartbeat(),
+        );
       } catch (error) {
         if (!isTransientHeartbeatTimeout(error) || stopped) throw error;
         console.warn('[absurd-runtime.worker] lease_heartbeat_timeout_retry', {
@@ -559,10 +563,22 @@ export async function runWithAbsurdExecutionLeaseHeartbeat<T>(input: {
         });
         await sleep(heartbeatTimeoutRetryDelayMs);
         if (stopped) return;
-        await input.ctx.heartbeat();
+        await runWithAbsurdSchedulerQuerySignal(
+          cancellationController.signal,
+          () => input.ctx.heartbeat(),
+        );
       }
     })()
       .catch((error) => {
+        // The handoff deadline owns this cancellation. A cancelled local SQL
+        // call does not prove that the engine cancelled the durable task.
+        if (
+          cancellationController.signal.aborted &&
+          error === cancellationController.signal.reason &&
+          error instanceof AbsurdExecutionOperationTimeoutError
+        ) {
+          return;
+        }
         const engineTerminal =
           error instanceof CancelledTask || error instanceof FailedTask;
         if (engineTerminal) {
@@ -595,9 +611,22 @@ export async function runWithAbsurdExecutionLeaseHeartbeat<T>(input: {
   timer.unref?.();
   let operationTimeout: ReturnType<typeof setTimeout> | null = null;
   try {
-    const operation = Promise.resolve().then(() =>
-      input.operation(cancellationController.signal),
-    );
+    // A completed backend still cannot park until its in-flight lease update
+    // settles. Keep that drain inside the same supervised handoff deadline.
+    const operation = (async () => {
+      try {
+        operationResult = await Promise.resolve().then(() =>
+          input.operation(cancellationController.signal),
+        );
+      } catch (error) {
+        operationError = error;
+      } finally {
+        stopped = true;
+        stopHeartbeatTimer();
+        await heartbeatState.inFlight;
+      }
+      return operationResult;
+    })();
     if (operationTimeoutMs !== null) {
       operationResult = await Promise.race([
         operation,
@@ -619,15 +648,11 @@ export async function runWithAbsurdExecutionLeaseHeartbeat<T>(input: {
       operationResult = await operation;
     }
   } catch (error) {
-    operationError = error;
+    operationError ??= error;
   } finally {
     if (operationTimeout) clearTimeout(operationTimeout);
     stopped = true;
     stopHeartbeatTimer();
-    const pendingHeartbeat = heartbeatState.inFlight;
-    if (pendingHeartbeat) {
-      await pendingHeartbeat.catch(() => undefined);
-    }
   }
   if (heartbeatFailure) {
     if (

package/dist/cli/index.js

@@ -3454,7 +3454,7 @@ var 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.236",
   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: {
     updatePreferences: 1
@@ -4133,6 +4133,15 @@ function describeRequestTarget(path) {
   }
   return "Deepline";
 }
+function networkDiagnosticUrl(value) {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    return void 0;
+  }
+}
 function providerLabelFromToolId(toolId) {
   const normalized = toolId.trim().toLowerCase();
   const provider = normalized.split(/[_:./-]+/)[0];
@@ -4233,6 +4242,10 @@ var HttpClient = class {
     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;
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -4244,6 +4257,7 @@ var HttpClient = class {
     requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
       if (options?.signal?.aborted) {
         lastError = requestCancelledError(options.signal);
+        networkFailedAt = Date.now();
         break;
       }
       if (attempt > 0) {
@@ -4254,12 +4268,14 @@ var HttpClient = class {
           await sleep(delayMs, options?.signal);
         } catch (error) {
           lastError = error instanceof Error ? error : new Error(String(error));
+          networkFailedAt = Date.now();
           break;
         }
       }
       for (const candidateUrl of candidateUrls) {
         if (options?.signal?.aborted) {
           lastError = requestCancelledError(options.signal);
+          networkFailedAt = Date.now();
           break requestAttempts;
         }
         const controller = new AbortController();
@@ -4274,10 +4290,13 @@ var HttpClient = class {
           once: true
         });
         try {
+          const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
+          fetchAttempts += 1;
+          lastRequestUrl = candidateUrl;
           const response = await fetch(candidateUrl, {
             method,
             headers,
-            body: options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
+            body: requestBody,
             signal: controller.signal
           });
           options?.onResponse?.(response);
@@ -4381,6 +4400,7 @@ var HttpClient = class {
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
+          networkFailedAt = Date.now();
           if (options?.signal?.aborted) {
             lastError = requestCancelledError(options.signal);
             break requestAttempts;
@@ -4411,6 +4431,19 @@ var HttpClient = class {
       lastError,
       describeRequestTarget(path)
     );
+    const failedAt = networkFailedAt ?? Date.now();
+    const diagnosticUrl = networkDiagnosticUrl(lastRequestUrl);
+    const networkDetails = {
+      ...mappedNetworkError.details,
+      request: {
+        method,
+        ...diagnosticUrl === void 0 ? {} : { 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(
@@ -4431,7 +4464,7 @@ var HttpClient = class {
             retryAfterMs: null,
             networkKind: code === "NETWORK_TIMEOUT" ? "timeout" : code === "NETWORK_ABORTED" ? "unknown" : "unavailable",
             networkScope: "client_to_deepline",
-            details: mappedNetworkError.details,
+            details: networkDetails,
             publicDetails: options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : null
           }
         ),
@@ -4443,7 +4476,7 @@ var HttpClient = class {
         withCoworkNetworkHint(mappedNetworkError.message),
         void 0,
         mappedNetworkError.code,
-        mappedNetworkError.details
+        networkDetails
       ),
       lastError
     );

package/dist/cli/index.mjs

@@ -3449,7 +3449,7 @@ var 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.236",
   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: {
     updatePreferences: 1
@@ -4128,6 +4128,15 @@ function describeRequestTarget(path) {
   }
   return "Deepline";
 }
+function networkDiagnosticUrl(value) {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    return void 0;
+  }
+}
 function providerLabelFromToolId(toolId) {
   const normalized = toolId.trim().toLowerCase();
   const provider = normalized.split(/[_:./-]+/)[0];
@@ -4228,6 +4237,10 @@ var HttpClient = class {
     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;
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -4239,6 +4252,7 @@ var HttpClient = class {
     requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
       if (options?.signal?.aborted) {
         lastError = requestCancelledError(options.signal);
+        networkFailedAt = Date.now();
         break;
       }
       if (attempt > 0) {
@@ -4249,12 +4263,14 @@ var HttpClient = class {
           await sleep(delayMs, options?.signal);
         } catch (error) {
           lastError = error instanceof Error ? error : new Error(String(error));
+          networkFailedAt = Date.now();
           break;
         }
       }
       for (const candidateUrl of candidateUrls) {
         if (options?.signal?.aborted) {
           lastError = requestCancelledError(options.signal);
+          networkFailedAt = Date.now();
           break requestAttempts;
         }
         const controller = new AbortController();
@@ -4269,10 +4285,13 @@ var HttpClient = class {
           once: true
         });
         try {
+          const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
+          fetchAttempts += 1;
+          lastRequestUrl = candidateUrl;
           const response = await fetch(candidateUrl, {
             method,
             headers,
-            body: options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
+            body: requestBody,
             signal: controller.signal
           });
           options?.onResponse?.(response);
@@ -4376,6 +4395,7 @@ var HttpClient = class {
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
+          networkFailedAt = Date.now();
           if (options?.signal?.aborted) {
             lastError = requestCancelledError(options.signal);
             break requestAttempts;
@@ -4406,6 +4426,19 @@ var HttpClient = class {
       lastError,
       describeRequestTarget(path)
     );
+    const failedAt = networkFailedAt ?? Date.now();
+    const diagnosticUrl = networkDiagnosticUrl(lastRequestUrl);
+    const networkDetails = {
+      ...mappedNetworkError.details,
+      request: {
+        method,
+        ...diagnosticUrl === void 0 ? {} : { 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(
@@ -4426,7 +4459,7 @@ var HttpClient = class {
             retryAfterMs: null,
             networkKind: code === "NETWORK_TIMEOUT" ? "timeout" : code === "NETWORK_ABORTED" ? "unknown" : "unavailable",
             networkScope: "client_to_deepline",
-            details: mappedNetworkError.details,
+            details: networkDetails,
             publicDetails: options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : null
           }
         ),
@@ -4438,7 +4471,7 @@ var HttpClient = class {
         withCoworkNetworkHint(mappedNetworkError.message),
         void 0,
         mappedNetworkError.code,
-        mappedNetworkError.details
+        networkDetails
       ),
       lastError
     );

package/dist/index.js

@@ -1267,7 +1267,7 @@ var 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.236",
   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: {
     updatePreferences: 1
@@ -1909,6 +1909,15 @@ function describeRequestTarget(path) {
   }
   return "Deepline";
 }
+function networkDiagnosticUrl(value) {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    return void 0;
+  }
+}
 function providerLabelFromToolId(toolId) {
   const normalized = toolId.trim().toLowerCase();
   const provider = normalized.split(/[_:./-]+/)[0];
@@ -2009,6 +2018,10 @@ var HttpClient = class {
     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;
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -2020,6 +2033,7 @@ var HttpClient = class {
     requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
       if (options?.signal?.aborted) {
         lastError = requestCancelledError(options.signal);
+        networkFailedAt = Date.now();
         break;
       }
       if (attempt > 0) {
@@ -2030,12 +2044,14 @@ var HttpClient = class {
           await sleep(delayMs, options?.signal);
         } catch (error) {
           lastError = error instanceof Error ? error : new Error(String(error));
+          networkFailedAt = Date.now();
           break;
         }
       }
       for (const candidateUrl of candidateUrls) {
         if (options?.signal?.aborted) {
           lastError = requestCancelledError(options.signal);
+          networkFailedAt = Date.now();
           break requestAttempts;
         }
         const controller = new AbortController();
@@ -2050,10 +2066,13 @@ var HttpClient = class {
           once: true
         });
         try {
+          const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
+          fetchAttempts += 1;
+          lastRequestUrl = candidateUrl;
           const response = await fetch(candidateUrl, {
             method,
             headers,
-            body: options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
+            body: requestBody,
             signal: controller.signal
           });
           options?.onResponse?.(response);
@@ -2157,6 +2176,7 @@ var HttpClient = class {
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
+          networkFailedAt = Date.now();
           if (options?.signal?.aborted) {
             lastError = requestCancelledError(options.signal);
             break requestAttempts;
@@ -2187,6 +2207,19 @@ var HttpClient = class {
       lastError,
       describeRequestTarget(path)
     );
+    const failedAt = networkFailedAt ?? Date.now();
+    const diagnosticUrl = networkDiagnosticUrl(lastRequestUrl);
+    const networkDetails = {
+      ...mappedNetworkError.details,
+      request: {
+        method,
+        ...diagnosticUrl === void 0 ? {} : { 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(
@@ -2207,7 +2240,7 @@ var HttpClient = class {
             retryAfterMs: null,
             networkKind: code === "NETWORK_TIMEOUT" ? "timeout" : code === "NETWORK_ABORTED" ? "unknown" : "unavailable",
             networkScope: "client_to_deepline",
-            details: mappedNetworkError.details,
+            details: networkDetails,
             publicDetails: options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : null
           }
         ),
@@ -2219,7 +2252,7 @@ var HttpClient = class {
         withCoworkNetworkHint(mappedNetworkError.message),
         void 0,
         mappedNetworkError.code,
-        mappedNetworkError.details
+        networkDetails
       ),
       lastError
     );

package/dist/index.mjs

@@ -1171,7 +1171,7 @@ var 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.236",
   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: {
     updatePreferences: 1
@@ -1813,6 +1813,15 @@ function describeRequestTarget(path) {
   }
   return "Deepline";
 }
+function networkDiagnosticUrl(value) {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    return void 0;
+  }
+}
 function providerLabelFromToolId(toolId) {
   const normalized = toolId.trim().toLowerCase();
   const provider = normalized.split(/[_:./-]+/)[0];
@@ -1913,6 +1922,10 @@ var HttpClient = class {
     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;
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -1924,6 +1937,7 @@ var HttpClient = class {
     requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
       if (options?.signal?.aborted) {
         lastError = requestCancelledError(options.signal);
+        networkFailedAt = Date.now();
         break;
       }
       if (attempt > 0) {
@@ -1934,12 +1948,14 @@ var HttpClient = class {
           await sleep(delayMs, options?.signal);
         } catch (error) {
           lastError = error instanceof Error ? error : new Error(String(error));
+          networkFailedAt = Date.now();
           break;
         }
       }
       for (const candidateUrl of candidateUrls) {
         if (options?.signal?.aborted) {
           lastError = requestCancelledError(options.signal);
+          networkFailedAt = Date.now();
           break requestAttempts;
         }
         const controller = new AbortController();
@@ -1954,10 +1970,13 @@ var HttpClient = class {
           once: true
         });
         try {
+          const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
+          fetchAttempts += 1;
+          lastRequestUrl = candidateUrl;
           const response = await fetch(candidateUrl, {
             method,
             headers,
-            body: options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
+            body: requestBody,
             signal: controller.signal
           });
           options?.onResponse?.(response);
@@ -2061,6 +2080,7 @@ var HttpClient = class {
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
+          networkFailedAt = Date.now();
           if (options?.signal?.aborted) {
             lastError = requestCancelledError(options.signal);
             break requestAttempts;
@@ -2091,6 +2111,19 @@ var HttpClient = class {
       lastError,
       describeRequestTarget(path)
     );
+    const failedAt = networkFailedAt ?? Date.now();
+    const diagnosticUrl = networkDiagnosticUrl(lastRequestUrl);
+    const networkDetails = {
+      ...mappedNetworkError.details,
+      request: {
+        method,
+        ...diagnosticUrl === void 0 ? {} : { 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(
@@ -2111,7 +2144,7 @@ var HttpClient = class {
             retryAfterMs: null,
             networkKind: code === "NETWORK_TIMEOUT" ? "timeout" : code === "NETWORK_ABORTED" ? "unknown" : "unavailable",
             networkScope: "client_to_deepline",
-            details: mappedNetworkError.details,
+            details: networkDetails,
             publicDetails: options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : null
           }
         ),
@@ -2123,7 +2156,7 @@ var HttpClient = class {
         withCoworkNetworkHint(mappedNetworkError.message),
         void 0,
         mappedNetworkError.code,
-        mappedNetworkError.details
+        networkDetails
       ),
       lastError
     );

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.235";
+    readonly version: "0.3.236";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.235";
+    readonly version: "0.3.236";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var 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.236",
   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: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var 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.236",
   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: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.235",
+  "version": "0.3.236",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",