deepline 0.3.216 → 0.3.218

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

@@ -675,6 +675,8 @@ type ExecuteToolRawOptions = {
   onExecution?: (execution: { idempotencyKey: string }) => void | Promise<void>;
   /** Maximum time to reconnect to an in-progress keyed execution. Defaults to 15 minutes. */
   recoveryTimeoutMs?: number;
+  /** The `search_ref` of the tools search that found this tool. */
+  searchRef?: string;
 };
 
 /** Durable state returned for a keyed tool execution. */
@@ -3537,6 +3539,9 @@ export class DeeplineClient {
         : {}),
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? 'raw',
       ...(idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : {}),
+      ...(options?.searchRef
+        ? { 'x-deepline-search-ref': options.searchRef }
+        : {}),
     };
     const request = (requestTimeoutMs: number | undefined) =>
       this.http.post<ToolExecution<TData, TMeta>>(

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.216',
+  version: '0.3.218',
   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/types.ts

@@ -490,6 +490,8 @@ export interface ToolSearchOptions {
 export interface ToolSearchResult {
   /** Ranked matching tools. */
   tools: ToolDefinition[];
+  /** Identifies this search; pass it as `searchRef` when executing a tool it found. */
+  search_ref?: string;
   /** Count included in this response when available. */
   count?: number;
   /** Matching count within the selected retrieval set. Check total_is_exact. */

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

@@ -49,7 +49,11 @@ import {
   LEGACY_RUNTIME_RECEIPT_WIRE_HEADER,
 } from './/runtime-contract';
 import { PLAY_RUNTIME_API_COMPAT_PATH } from './/runtime-api-paths';
-import { buildRunLedgerEventsIdempotencyKey } from './run-ledger-projection-contract';
+import {
+  buildRunLedgerEventsIdempotencyKey,
+  isRunLedgerProjectionLeaseLostReason,
+  type RunLedgerProjectionLeaseLostReason,
+} from './run-ledger-projection-contract';
 import {
   RUNTIME_API_ACCEPTS_HEADER,
   gzipRuntimeApiRequestBody,
@@ -928,6 +932,21 @@ function appRuntimeErrorCode(response: Response, body: string): string | null {
   }
 }
 
+function appRuntimeFailureReason(
+  responseCode: string | null,
+  body: string,
+): RunLedgerProjectionLeaseLostReason | null {
+  if (responseCode !== 'RUN_LEDGER_DELIVERY_LEASE_LOST') return null;
+  try {
+    const parsed = JSON.parse(body) as { failureReason?: unknown };
+    return isRunLedgerProjectionLeaseLostReason(parsed.failureReason)
+      ? parsed.failureReason
+      : null;
+  } catch {
+    return null;
+  }
+}
+
 export function isTransientAppRuntimeFailureBody(body: string): boolean {
   return /WorkerOverloaded|"\s*code\s*"\s*:\s*"\s*InternalServerError\s*"|Your request couldn't be completed\. Try again later\.|timeout exceeded when trying to connect|timed out|fetch failed|ECONNRESET|ECONNREFUSED|UND_ERR_CONNECT_TIMEOUT|tuple concurrently updated|RUNTIME_SCHEDULER_(?:SATURATED|UNAVAILABLE|SCHEMA_NOT_READY)|Runtime scheduler DB pool is saturated|Runtime scheduler DB circuit breaker is open|Runtime scheduler schema .* is not ready|OptimisticConcurrencyControlFailure|changed while this mutation was being run|Documents read from or written to the .* table changed while this mutation/i.test(
     body,
@@ -1340,6 +1359,7 @@ export class AppRuntimeApiResponseError extends Error {
   readonly action: RuntimeApiRequest['action'];
   readonly status: number;
   readonly code: string | null;
+  readonly failureReason: RunLedgerProjectionLeaseLostReason | null;
   readonly requestId: string | null;
   readonly retryable: boolean;
   /** Server-requested delay, retained for durable callers after local retries end. */
@@ -1350,6 +1370,7 @@ export class AppRuntimeApiResponseError extends Error {
     action: RuntimeApiRequest['action'];
     status: number;
     code?: string | null;
+    failureReason?: RunLedgerProjectionLeaseLostReason | null;
     requestId?: string | null;
     retryable: boolean;
     retryAfterMs?: number | null;
@@ -1366,6 +1387,7 @@ export class AppRuntimeApiResponseError extends Error {
     this.action = input.action;
     this.status = input.status;
     this.code = input.code?.trim() || null;
+    this.failureReason = input.failureReason ?? null;
     this.requestId = input.requestId?.trim() || null;
     this.retryable = input.retryable;
     this.retryAfterMs =
@@ -1830,6 +1852,7 @@ async function postAppRuntimeApi<TResponse>(
       action: body.action,
       status: response.status,
       code,
+      failureReason: appRuntimeFailureReason(code, responseText),
       requestId,
       // The structured response is authoritative even for a 5xx. Retrying an
       // explicitly deterministic database failure here turns one rejected SQL

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger-projection-contract.ts

@@ -10,10 +10,41 @@ const UUID_PATTERN =
   /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/i;
 
+export const RUN_LEDGER_PROJECTION_LEASE_LOST_REASONS = [
+  'delivery_lease_not_current',
+  'head_lease_missing',
+  'head_lease_owner_mismatch',
+  'prefix_lease_owner_mismatch',
+  'lease_expired',
+  'predecessor_not_due',
+  'predecessor_failed',
+  'delivery_key_mismatch',
+  'projected_events_mismatch',
+] as const;
+
+export type RunLedgerProjectionLeaseLostReason =
+  (typeof RUN_LEDGER_PROJECTION_LEASE_LOST_REASONS)[number];
+
+export function isRunLedgerProjectionLeaseLostReason(
+  value: unknown,
+): value is RunLedgerProjectionLeaseLostReason {
+  return (
+    typeof value === 'string' &&
+    RUN_LEDGER_PROJECTION_LEASE_LOST_REASONS.includes(
+      value as RunLedgerProjectionLeaseLostReason,
+    )
+  );
+}
+
 export class RunLedgerProjectionLeaseLostError extends Error {
-  constructor() {
+  readonly reason: RunLedgerProjectionLeaseLostReason;
+
+  constructor(
+    reason: RunLedgerProjectionLeaseLostReason = 'delivery_lease_not_current',
+  ) {
     super('Run Ledger projection requires the current outbox delivery lease.');
     this.name = 'RunLedgerProjectionLeaseLostError';
+    this.reason = reason;
   }
 }
 

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

@@ -95,6 +95,7 @@ import {
 import {
   buildRunLedgerEventsIdempotencyKey,
   RunLedgerProjectionLeaseLostError,
+  type RunLedgerProjectionLeaseLostReason,
   buildRunLedgerStartIdempotencyKey,
   buildRunLedgerTerminalIdempotencyKey,
 } from '../run-ledger-projection-contract';
@@ -16013,7 +16014,7 @@ export async function renewPostgresRunLedgerDelivery(
     ],
   );
   if (result.rows.length !== input.eventIds.length)
-    throw new RunLedgerProjectionLeaseLostError();
+    throw new RunLedgerProjectionLeaseLostError('delivery_lease_not_current');
 }
 
 /** Only the currently claimed causal prefix may use the projection write path. */
@@ -16060,21 +16061,33 @@ export async function assertPostgresRunLedgerDelivery(
   );
   const rows = result.rows;
   const leaseOwner = input.leaseOwner?.trim() || rows[0]?.lease_owner;
-  if (!leaseOwner || rows[0]?.lease_owner !== leaseOwner) {
-    throw new RunLedgerProjectionLeaseLostError();
+  if (!leaseOwner) {
+    throw new RunLedgerProjectionLeaseLostError('head_lease_missing');
+  }
+  if (rows[0]?.lease_owner !== leaseOwner) {
+    throw new RunLedgerProjectionLeaseLostError('head_lease_owner_mismatch');
   }
 
   // Cancellation may own several pending facts at once. Validate the exact
   // contiguous, due prefix named by the receipt instead of all rows sharing
   // that cancellation lease.
   const prefix: typeof rows = [];
+  let prefixStopReason: RunLedgerProjectionLeaseLostReason | null = null;
   for (const row of rows) {
-    if (
-      row.lease_owner !== leaseOwner ||
-      row.lease_live !== true ||
-      row.due !== true ||
-      row.blocked === true
-    ) {
+    if (row.lease_owner !== leaseOwner) {
+      prefixStopReason = 'prefix_lease_owner_mismatch';
+      break;
+    }
+    if (row.lease_live !== true) {
+      prefixStopReason = 'lease_expired';
+      break;
+    }
+    if (row.due !== true) {
+      prefixStopReason = 'predecessor_not_due';
+      break;
+    }
+    if (row.blocked === true) {
+      prefixStopReason = 'predecessor_failed';
       break;
     }
     if (prefix.length > 0 && row.event_type === 'run.events') break;
@@ -16160,7 +16173,7 @@ export async function assertPostgresRunLedgerDelivery(
       ) {
         return;
       }
-      throw new RunLedgerProjectionLeaseLostError();
+      throw new RunLedgerProjectionLeaseLostError('projected_events_mismatch');
     }
 
     if (
@@ -16173,7 +16186,9 @@ export async function assertPostgresRunLedgerDelivery(
       break;
     }
   }
-  throw new RunLedgerProjectionLeaseLostError();
+  throw new RunLedgerProjectionLeaseLostError(
+    prefixStopReason ?? 'delivery_key_mismatch',
+  );
 }
 
 /** Snapshot-creating facts precede progress, even when their intake was late. */
@@ -16693,6 +16708,7 @@ function runLedgerDeliveryFailure(input: { error: unknown }): {
   code: string | null;
   status: number | null;
   retryable: boolean;
+  failureReason: RunLedgerProjectionLeaseLostReason | null;
   retryAfterMs: number | null;
 } {
   if (input.error instanceof AppRuntimeApiResponseError) {
@@ -16712,6 +16728,7 @@ function runLedgerDeliveryFailure(input: { error: unknown }): {
       code: input.error.code,
       status: input.error.status,
       retryable,
+      failureReason: input.error.failureReason,
       retryAfterMs:
         input.error.retryAfterMs === null
           ? null
@@ -16727,6 +16744,7 @@ function runLedgerDeliveryFailure(input: { error: unknown }): {
       code: 'app_runtime_transport_error',
       status: null,
       retryable: true,
+      failureReason: null,
       retryAfterMs: null,
     };
   }
@@ -16737,6 +16755,7 @@ function runLedgerDeliveryFailure(input: { error: unknown }): {
     code: null,
     status: null,
     retryable: true,
+    failureReason: null,
     retryAfterMs: null,
   };
 }
@@ -16833,6 +16852,9 @@ export async function settlePostgresSchedulerOutboxFailure(
         code: failure.code,
         status: failure.status,
         retryable: failure.retryable,
+        ...(failure.failureReason
+          ? { failureReason: failure.failureReason }
+          : {}),
         retryAfterMs: failure.retryAfterMs,
         recordedAt: new Date().toISOString(),
       }),

package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts

@@ -103,7 +103,11 @@ function dedupeStaticFieldNames(
 
 export function inputFieldFromStaticCsvArg(csvArg: unknown): string | null {
   if (typeof csvArg !== 'string') return null;
-  const match = /^input\.([A-Za-z_$][\w$]*)$/.exec(csvArg.trim());
+  // Static analysis retains the authored expression, including its fallback.
+  const match =
+    /^\(?\s*input\.([A-Za-z_$][\w$]*)\s*\)?(?:\s*\?\?[\s\S]+)?$/.exec(
+      csvArg.trim(),
+    );
   return match?.[1] ?? null;
 }
 

package/dist/cli/index.js

@@ -3051,7 +3051,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.216",
+  version: "0.3.218",
   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
@@ -7699,7 +7699,8 @@ var DeeplineClient = class _DeeplineClient {
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
-      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
     };
     const request = (requestTimeoutMs) => this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
@@ -49828,6 +49829,29 @@ async function listTools(category, options = {}) {
   }
   return listToolCategories(emitJson, compact);
 }
+var SEARCH_REF_TTL_MS = 15 * 6e4;
+function lastSearchPath() {
+  return (0, import_node_path31.join)(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
+}
+function rememberSearchRef(searchRef) {
+  try {
+    (0, import_node_fs26.mkdirSync)((0, import_node_path31.dirname)(lastSearchPath()), { recursive: true });
+    (0, import_node_fs26.writeFileSync)(
+      lastSearchPath(),
+      JSON.stringify({ searchRef, at: Date.now() }),
+      { mode: 384 }
+    );
+  } catch {
+  }
+}
+function recentSearchRef() {
+  try {
+    const saved = JSON.parse((0, import_node_fs26.readFileSync)(lastSearchPath(), "utf8"));
+    return typeof saved.searchRef === "string" && typeof saved.at === "number" && Date.now() - saved.at < SEARCH_REF_TTL_MS ? saved.searchRef : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function searchTools(queryInput, options = {}) {
   const query = queryInput?.trim() ?? "";
   const hasStructuredSearch = Boolean(
@@ -49840,7 +49864,7 @@ async function searchTools(queryInput, options = {}) {
     return 1;
   }
   const client2 = new DeeplineClient();
-  const result = await client2.searchTools({
+  const { search_ref: searchRef, ...result } = await client2.searchTools({
     query,
     categories: options.categories,
     searchTerms: options.searchTerms,
@@ -49849,6 +49873,7 @@ async function searchTools(queryInput, options = {}) {
     searchMode: options.searchMode,
     includeSearchDebug: options.includeSearchDebug
   });
+  if (searchRef) rememberSearchRef(searchRef);
   const shouldCompact = options.compact || !options.json;
   const payload = shouldCompact && Array.isArray(result.tools) ? {
     ...result,
@@ -51986,7 +52011,8 @@ async function executeTool(args) {
     ...metadata.executionMetadata?.retrySafeTransientHttp === true ? { maxRetries: 2, retryApiErrors: true } : {},
     responseIntent,
     ...idempotencyKey ? { idempotencyKey } : {},
-    ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {}
+    ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
+    searchRef: recentSearchRef()
   });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)

package/dist/cli/index.mjs

@@ -3046,7 +3046,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.216",
+  version: "0.3.218",
   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
@@ -7694,7 +7694,8 @@ var DeeplineClient = class _DeeplineClient {
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
-      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
     };
     const request = (requestTimeoutMs) => this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
@@ -49976,6 +49977,29 @@ async function listTools(category, options = {}) {
   }
   return listToolCategories(emitJson, compact);
 }
+var SEARCH_REF_TTL_MS = 15 * 6e4;
+function lastSearchPath() {
+  return join26(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
+}
+function rememberSearchRef(searchRef) {
+  try {
+    mkdirSync16(dirname20(lastSearchPath()), { recursive: true });
+    writeFileSync20(
+      lastSearchPath(),
+      JSON.stringify({ searchRef, at: Date.now() }),
+      { mode: 384 }
+    );
+  } catch {
+  }
+}
+function recentSearchRef() {
+  try {
+    const saved = JSON.parse(readFileSync22(lastSearchPath(), "utf8"));
+    return typeof saved.searchRef === "string" && typeof saved.at === "number" && Date.now() - saved.at < SEARCH_REF_TTL_MS ? saved.searchRef : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function searchTools(queryInput, options = {}) {
   const query = queryInput?.trim() ?? "";
   const hasStructuredSearch = Boolean(
@@ -49988,7 +50012,7 @@ async function searchTools(queryInput, options = {}) {
     return 1;
   }
   const client2 = new DeeplineClient();
-  const result = await client2.searchTools({
+  const { search_ref: searchRef, ...result } = await client2.searchTools({
     query,
     categories: options.categories,
     searchTerms: options.searchTerms,
@@ -49997,6 +50021,7 @@ async function searchTools(queryInput, options = {}) {
     searchMode: options.searchMode,
     includeSearchDebug: options.includeSearchDebug
   });
+  if (searchRef) rememberSearchRef(searchRef);
   const shouldCompact = options.compact || !options.json;
   const payload = shouldCompact && Array.isArray(result.tools) ? {
     ...result,
@@ -52134,7 +52159,8 @@ async function executeTool(args) {
     ...metadata.executionMetadata?.retrySafeTransientHttp === true ? { maxRetries: 2, retryApiErrors: true } : {},
     responseIntent,
     ...idempotencyKey ? { idempotencyKey } : {},
-    ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {}
+    ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
+    searchRef: recentSearchRef()
   });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)

package/dist/index.d.mts

@@ -1505,6 +1505,8 @@ interface ToolSearchOptions {
 interface ToolSearchResult {
     /** Ranked matching tools. */
     tools: ToolDefinition[];
+    /** Identifies this search; pass it as `searchRef` when executing a tool it found. */
+    search_ref?: string;
     /** Count included in this response when available. */
     count?: number;
     /** Matching count within the selected retrieval set. Check total_is_exact. */
@@ -3312,6 +3314,8 @@ type ExecuteToolRawOptions = {
     }) => void | Promise<void>;
     /** Maximum time to reconnect to an in-progress keyed execution. Defaults to 15 minutes. */
     recoveryTimeoutMs?: number;
+    /** The `search_ref` of the tools search that found this tool. */
+    searchRef?: string;
 };
 /** Durable state returned for a keyed tool execution. */
 type ExecutionRecovery = {

package/dist/index.d.ts

@@ -1505,6 +1505,8 @@ interface ToolSearchOptions {
 interface ToolSearchResult {
     /** Ranked matching tools. */
     tools: ToolDefinition[];
+    /** Identifies this search; pass it as `searchRef` when executing a tool it found. */
+    search_ref?: string;
     /** Count included in this response when available. */
     count?: number;
     /** Matching count within the selected retrieval set. Check total_is_exact. */
@@ -3312,6 +3314,8 @@ type ExecuteToolRawOptions = {
     }) => void | Promise<void>;
     /** Maximum time to reconnect to an in-progress keyed execution. Defaults to 15 minutes. */
     recoveryTimeoutMs?: number;
+    /** The `search_ref` of the tools search that found this tool. */
+    searchRef?: string;
 };
 /** Durable state returned for a keyed tool execution. */
 type ExecutionRecovery = {

package/dist/index.js

@@ -864,7 +864,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.216",
+  version: "0.3.218",
   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
@@ -5371,7 +5371,8 @@ var DeeplineClient = class _DeeplineClient {
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
-      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
     };
     const request = (requestTimeoutMs) => this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,

package/dist/index.mjs

@@ -768,7 +768,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.216",
+  version: "0.3.218",
   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
@@ -5275,7 +5275,8 @@ var DeeplineClient = class _DeeplineClient {
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
-      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
     };
     const request = (requestTimeoutMs) => this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.216";
+    readonly version: "0.3.218";
     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.216";
+    readonly version: "0.3.218";
     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.216",
+  version: "0.3.218",
   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.216",
+  version: "0.3.218",
   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.216",
+  "version": "0.3.218",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",