deepline 0.3.305 → 0.3.306

package/dist/bundling-sources/sdk/src/cli-invocation-id.ts

@@ -0,0 +1,14 @@
+import { DeeplineError } from './errors.js';
+
+const CLI_INVOCATION_ID_PATTERN =
+  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+export function validateCliInvocationId(value: string): void {
+  if (!CLI_INVOCATION_ID_PATTERN.test(value)) {
+    throw new DeeplineError(
+      'CLI invocation IDs must be UUID v4 values.',
+      undefined,
+      'CLI_INVOCATION_ID_INVALID',
+    );
+  }
+}

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

@@ -57,6 +57,7 @@ import {
   type ExecutionByKeyResult,
   type ToolExecution,
 } from './tool-calls.js';
+import { validateCliInvocationId } from './cli-invocation-id.js';
 export type {
   ExecutionRecovery,
   ExecutionByKeyResult,
@@ -3263,7 +3264,13 @@ export class DeeplineClient {
    * console.log(`Input schema:`, meta.inputSchema);
    * ```
    */
-  async getTool(toolId: string): Promise<ToolMetadata> {
+  async getTool(
+    toolId: string,
+    options?: { cliInvocationId?: string },
+  ): Promise<ToolMetadata> {
+    if (options?.cliInvocationId !== undefined) {
+      validateCliInvocationId(options.cliInvocationId);
+    }
     return this.http.request<ToolMetadata>(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/get`,
       {
@@ -3274,6 +3281,9 @@ export class DeeplineClient {
         retryApiErrors: true,
         headers: {
           'x-deepline-tool-meta-only': '1',
+          ...(options?.cliInvocationId !== undefined
+            ? { 'x-deepline-cli-invocation-id': options.cliInvocationId }
+            : {}),
         },
       },
     );
@@ -5427,7 +5437,11 @@ export class DeeplineClient {
     query: string;
     compact?: boolean;
     scope?: 'prebuilt' | 'owned' | 'all';
+    cliInvocationId?: string;
   }): Promise<PlayDescription[]> {
+    if (options.cliInvocationId !== undefined) {
+      validateCliInvocationId(options.cliInvocationId);
+    }
     const params = new URLSearchParams();
     params.set('search', options.query.trim());
     const scope = options.scope ?? 'prebuilt';
@@ -5436,6 +5450,15 @@ export class DeeplineClient {
     }
     const response = await this.http.get<{ plays: PlayListItem[] }>(
       `/api/v2/plays?${params.toString()}`,
+      {
+        ...(options.cliInvocationId !== undefined
+          ? {
+              headers: {
+                'x-deepline-cli-invocation-id': options.cliInvocationId,
+              },
+            }
+          : {}),
+      },
     );
     const plays = (response.plays ?? []).map((play) =>
       this.summarizePlayListItem(play, options),

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

@@ -8,6 +8,8 @@
  *
  * - **Max attempts**: `1 + maxRetries` (default: 4 total attempts)
  * - **Backoff**: exponential — 1s, 2s, 4s, 8s, ... capped at 30s
+ * - **Total automatic retry wait**: 30s per request; a longer upstream
+ *   `Retry-After` is returned to the caller instead of blocking the request
  * - **Retryable**: network errors, timeouts, HTTP 429 (rate limit)
  * - **Not retryable**: HTTP 401 (auth error), HTTP 403 and other 4xx API errors
  *
@@ -54,6 +56,7 @@ const COWORK_NETWORK_HINT =
   'Claude Cowork appears to be running Deepline in a network-restricted sandbox. In Claude Desktop, open Settings > Capabilities, turn on Allow network egress, and set Domain allowlist to All domains for the Cowork session.';
 const REQUEST_TIMEOUT_MARKER = Symbol('deeplineRequestTimeout');
 const REQUEST_ABORT_MARKER = Symbol('deeplineRequestAbort');
+const MAX_AUTOMATIC_RETRY_WAIT_MS = 30_000;
 
 interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -431,6 +434,7 @@ export class HttpClient {
       ? [url]
       : buildCandidateUrls(url);
     let retryAfterDelayMs: number | null = null;
+    let totalRetryWaitMs = 0;
 
     const maxRetries = options?.maxRetries ?? this.config.maxRetries;
 
@@ -447,6 +451,13 @@ export class HttpClient {
             ? backoffMs
             : Math.max(backoffMs, retryAfterDelayMs);
         retryAfterDelayMs = null;
+        if (totalRetryWaitMs + delayMs > MAX_AUTOMATIC_RETRY_WAIT_MS) {
+          // Honor the upstream delay by returning its original error. Never
+          // retry sooner than requested, and never let automatic retries hold
+          // the caller for an unbounded series of Retry-After sleeps.
+          break requestAttempts;
+        }
+        totalRetryWaitMs += delayMs;
         networkPhase = 'retry_wait';
         try {
           await sleep(delayMs, options?.signal);

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.305',
+  version: '0.3.306',
   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/sdk/src/tool-calls.ts

@@ -18,6 +18,7 @@ import {
 
 import { DeeplineError, ToolExecutionError } from './errors.js';
 import type { HttpClient } from './http.js';
+import { validateCliInvocationId } from './cli-invocation-id.js';
 
 const INCLUDE_TOOL_METADATA_HEADER = 'x-deepline-include-tool-metadata';
 const EXECUTE_RESPONSE_CONTRACT_HEADER = 'x-deepline-execute-response-contract';
@@ -132,6 +133,8 @@ export type ExecuteToolRawOptions = {
   recoveryTimeoutMs?: number;
   /** The `search_ref` of the tools search that found this tool. */
   searchRef?: string;
+  /** Correlates one CLI command with its execute request and server telemetry. */
+  cliInvocationId?: string;
 };
 
 /** Durable state returned for a keyed tool execution. */
@@ -327,6 +330,9 @@ export class ToolCalls {
     input: Record<string, unknown>,
     options?: ExecuteToolRawOptions,
   ): Promise<ToolExecution<TData, TMeta>> {
+    if (options?.cliInvocationId !== undefined) {
+      validateCliInvocationId(options.cliInvocationId);
+    }
     // Snapshot JSON input before the caller's awaited onExecution callback and
     // before any retry, so every POST is byte-equivalent in meaning.
     const inputSnapshot = JSON.parse(JSON.stringify(input)) as Record<
@@ -365,7 +371,11 @@ export class ToolCalls {
         this.configuredRequestTimeoutMs,
       );
     if (idempotencyKey !== undefined) {
-      await this.lookupExecutionByKey(idempotencyKey, timeoutMs);
+      await this.lookupExecutionByKey(
+        idempotencyKey,
+        timeoutMs,
+        options?.cliInvocationId,
+      );
     }
     const isApifySync = toolId.trim().toLowerCase() === 'apify_run_actor_sync';
     const headers = {
@@ -384,6 +394,9 @@ export class ToolCalls {
       ...(options?.searchRef
         ? { 'x-deepline-search-ref': options.searchRef }
         : {}),
+      ...(options?.cliInvocationId !== undefined
+        ? { 'x-deepline-cli-invocation-id': options.cliInvocationId }
+        : {}),
     };
     const request = (requestTimeoutMs: number | undefined) =>
       this.http.post<ToolExecution<TData, TMeta>>(
@@ -434,6 +447,7 @@ export class ToolCalls {
               this.defaultRequestTimeoutMs,
               remainingMs,
             ),
+            options?.cliInvocationId,
           );
         } catch (error) {
           if (!isRecoverableExecutionLookupError(error)) throw error;
@@ -525,6 +539,7 @@ export class ToolCalls {
   private async lookupExecutionByKey(
     idempotencyKey: string,
     timeoutMs?: number,
+    cliInvocationId?: string,
   ): Promise<ExecutionByKeyResult | null> {
     validateExecutionIdempotencyKey(idempotencyKey);
     let supported = false;
@@ -536,6 +551,9 @@ export class ToolCalls {
         timeout: timeoutMs,
         idempotencyKey,
         allowNotFound: true,
+        ...(cliInvocationId !== undefined
+          ? { headers: { 'x-deepline-cli-invocation-id': cliInvocationId } }
+          : {}),
         onResponse: (response) => {
           supported =
             response.headers.get('X-Deepline-Idempotency-Supported') === 'true';

package/dist/cli/{auth-XMYFUM5L.mjs → auth-WTC7LCQ6.mjs}

@@ -9,11 +9,11 @@ import {
   registerAuthCommands,
   reportSetupCompleted,
   resolvePendingAuthClaimForResume
-} from "./chunk-SCX2AZFY.mjs";
-import "./chunk-QFSISXKO.mjs";
-import "./chunk-6C4SD4U3.mjs";
+} from "./chunk-7XORS6WQ.mjs";
+import "./chunk-5V56XCQN.mjs";
+import "./chunk-4PSSDZQB.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-KNK42P4M.mjs";
+import "./chunk-WWPI4GJI.mjs";
 import "./chunk-NXGCO4JB.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";

package/dist/cli/auth-ZT3UF33R.js

@@ -0,0 +1,31 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+var _chunkU37SW6IKjs = require('./chunk-U37SW6IK.js');
+require('./chunk-MMNZ6GBT.js');
+require('./chunk-M6HCRRV2.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-OZIFVQRY.js');
+require('./chunk-7P5AA3SN.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+
+
+
+
+exports.EXIT_WORKSPACE_MISMATCH = _chunkU37SW6IKjs.EXIT_WORKSPACE_MISMATCH; exports.clearPendingClaim = _chunkU37SW6IKjs.clearPendingClaim; exports.clearSatisfiedPendingClaim = _chunkU37SW6IKjs.clearSatisfiedPendingClaim; exports.handleRegister = _chunkU37SW6IKjs.handleRegister; exports.handleStatus = _chunkU37SW6IKjs.handleStatus; exports.handleWait = _chunkU37SW6IKjs.handleWait; exports.readPendingAuthClaim = _chunkU37SW6IKjs.readPendingAuthClaim; exports.registerAuthCommands = _chunkU37SW6IKjs.registerAuthCommands; exports.reportSetupCompleted = _chunkU37SW6IKjs.reportSetupCompleted; exports.resolvePendingAuthClaimForResume = _chunkU37SW6IKjs.resolvePendingAuthClaimForResume;