deepline 0.3.230 → 0.3.232

package/dist/cli/index.mjs

@@ -1951,7 +1951,7 @@ configureProxyFromEnv();
 
 // src/cli/index.ts
 import { mkdtemp as mkdtemp4, rm as rm4, writeFile as writeFile6 } from "fs/promises";
-import { join as join28 } from "path";
+import { join as join29 } from "path";
 import { tmpdir as tmpdir7 } from "os";
 import { Command as Command5 } from "commander";
 
@@ -2996,6 +2996,409 @@ function resolveCliCommandContext(inputConfig, requestedScope) {
   };
 }
 
+// ../integration-contracts/theirstack/execution-policy.ts
+var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
+var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
+var THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS = 21e4;
+var LONG_JOB_SEARCH_WINDOW_MS = 365 * 24 * 60 * 60 * 1e3;
+var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function parseDateOnly(value) {
+  if (typeof value !== "string" || !DATE_ONLY_PATTERN.test(value)) {
+    return null;
+  }
+  const timestamp = Date.parse(`${value}T00:00:00.000Z`);
+  if (!Number.isFinite(timestamp)) {
+    return null;
+  }
+  return new Date(timestamp).toISOString().slice(0, 10) === value ? timestamp : null;
+}
+function usesLongExplicitDateWindow(payload) {
+  const postedAtGte = parseDateOnly(payload.posted_at_gte);
+  const postedAtLte = parseDateOnly(payload.posted_at_lte);
+  if (postedAtGte !== null && postedAtLte !== null) {
+    return postedAtLte - postedAtGte >= LONG_JOB_SEARCH_WINDOW_MS;
+  }
+  if (postedAtGte !== null) {
+    return Date.now() - postedAtGte >= LONG_JOB_SEARCH_WINDOW_MS;
+  }
+  return postedAtLte !== null && payload.posted_at_gte == null;
+}
+function parseMaxAgeDays(value) {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : null;
+  }
+  if (typeof value !== "string" || !/^-?\d+$/.test(value.trim())) {
+    return null;
+  }
+  const parsed = Number(value.trim());
+  return Number.isSafeInteger(parsed) ? parsed : null;
+}
+function usesExtendedTheirstackJobSearchBudget(endpointId, payload) {
+  if (endpointId !== "theirstack_job_search") {
+    return false;
+  }
+  if (payload.include_total_results === true) {
+    return true;
+  }
+  const maxAgeDays = parseMaxAgeDays(payload.posted_at_max_age_days);
+  return maxAgeDays !== null && maxAgeDays >= 365 ? true : usesLongExplicitDateWindow(payload);
+}
+function resolveTheirstackClientTimeoutMs(endpointId, payload) {
+  if (endpointId === "theirstack_company_search") {
+    return THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS;
+  }
+  return usesExtendedTheirstackJobSearchBudget(endpointId, payload) ? THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS : null;
+}
+
+// ../integration-contracts/waterfall/execution-policy.ts
+var WATERFALL_PROSPECTOR_CLIENT_TIMEOUT_MS = 18e4;
+var WATERFALL_PROSPECTOR_LAUNCHER_TOOL_IDS = /* @__PURE__ */ new Set([
+  "prospector",
+  "deepline_native_prospector"
+]);
+function resolveWaterfallClientTimeoutMs(toolId) {
+  return WATERFALL_PROSPECTOR_LAUNCHER_TOOL_IDS.has(toolId.trim().toLowerCase()) ? WATERFALL_PROSPECTOR_CLIENT_TIMEOUT_MS : null;
+}
+
+// ../integration-contracts/bettercontact/execution-policy.ts
+var BETTERCONTACT_LAUNCHER_CLIENT_TIMEOUT_MS = 12e4;
+var BETTERCONTACT_LAUNCHER_TOOL_IDS = /* @__PURE__ */ new Set([
+  "bettercontact_enrich",
+  "bettercontact_bulk_enrich"
+]);
+function usesExtendedBetterContactLauncherBudget(toolId) {
+  return BETTERCONTACT_LAUNCHER_TOOL_IDS.has(toolId.trim().toLowerCase());
+}
+
+// ../plays/tool-response-contract.ts
+var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
+function legacyRawFromToolResponseRawV2(rawV2, view, responseMeta) {
+  const legacyRaw = view === "data" && rawV2 && typeof rawV2 === "object" && !Array.isArray(rawV2) ? rawV2.data : rawV2;
+  const deeplineBilling = responseMeta?.deepline_billing;
+  if (view === "rawV2" && deeplineBilling !== void 0 && legacyRaw && typeof legacyRaw === "object" && !Array.isArray(legacyRaw)) {
+    return {
+      ...legacyRaw,
+      deepline_billing: deeplineBilling
+    };
+  }
+  return legacyRaw;
+}
+function providerMetaFromToolResponseRawV2(rawV2, view) {
+  if (view !== "data" || !rawV2 || typeof rawV2 !== "object" || Array.isArray(rawV2)) {
+    return void 0;
+  }
+  const meta = rawV2.meta;
+  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : void 0;
+}
+
+// src/tool-calls.ts
+var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
+var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
+var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
+var RAW_V2_EXECUTE_RESPONSE_CONTRACT = RAW_V2_TOOL_RESPONSE_CONTRACT;
+var DEFAULT_EXECUTION_RECOVERY_TIMEOUT_MS = 15 * 60 * 1e3;
+function validateExecutionIdempotencyKey(key) {
+  if (typeof key !== "string" || key.length < 1 || key.length > 200 || !/^[A-Za-z0-9._:-]+$/.test(key)) {
+    throw new DeeplineError(
+      "Execution idempotency keys must be 1\u2013200 ASCII letters, digits, dots, underscores, colons, or hyphens.",
+      void 0,
+      "IDEMPOTENCY_KEY_INVALID"
+    );
+  }
+}
+function getExecutionRecoveryState(value) {
+  if (!isRecord2(value) || !isRecord2(value.executionRecovery)) return null;
+  const state = value.executionRecovery.state;
+  return state === "running" || state === "completed" || state === "outcome_unknown" ? state : null;
+}
+function isRecoverableExecutionAttemptError(error) {
+  if (error instanceof ToolExecutionError) {
+    return error.code === "EXECUTION_IN_PROGRESS" || error.origin === "deepline" && error.category === "network" && error.networkScope === "client_to_deepline";
+  }
+  return error instanceof DeeplineError && (error.code === "EXECUTION_IN_PROGRESS" || error.code?.startsWith("NETWORK_") === true && error.statusCode === void 0);
+}
+function isRecoverableExecutionLookupError(error) {
+  if (isRecoverableExecutionAttemptError(error)) return true;
+  return error instanceof DeeplineError && (error.statusCode === 429 || error.statusCode !== void 0 && error.statusCode >= 500);
+}
+function timeoutWithinRecoveryBudget(requestTimeoutMs, defaultRequestTimeoutMs, remainingMs) {
+  return Math.min(requestTimeoutMs ?? defaultRequestTimeoutMs, remainingMs);
+}
+function executionRecoveryError(input2) {
+  return new ToolExecutionError(input2.message, {
+    toolId: input2.toolId,
+    provider: null,
+    operation: input2.toolId,
+    code: input2.code,
+    origin: "deepline",
+    category: input2.code === "EXECUTION_OUTCOME_UNKNOWN" ? "unknown" : "conflict",
+    retryable: input2.code !== "EXECUTION_OUTCOME_UNKNOWN",
+    statusCode: null,
+    requestId: null,
+    retryAfterMs: null,
+    networkKind: null,
+    networkScope: null,
+    publicDetails: { idempotencyKey: input2.idempotencyKey }
+  });
+}
+var DEEPLINEAGENT_EXECUTE_TIMEOUT_MS = 15 * 60 * 1e3;
+var APIFY_SYNC_DEFAULT_TIMEOUT_MS = 3e5;
+var APIFY_SYNC_RESPONSE_GRACE_MS = 9e4;
+function resolveToolExecuteTimeoutMs(toolId, input2) {
+  const normalized = toolId.trim().toLowerCase();
+  if (normalized === "apify_run_actor_sync") {
+    const requestedTimeoutMs = input2.timeoutMs ?? APIFY_SYNC_DEFAULT_TIMEOUT_MS;
+    if (typeof requestedTimeoutMs === "number" && Number.isFinite(requestedTimeoutMs) && requestedTimeoutMs > 0) {
+      return Math.floor(requestedTimeoutMs) + APIFY_SYNC_RESPONSE_GRACE_MS;
+    }
+  }
+  const theirstackTimeoutMs = resolveTheirstackClientTimeoutMs(
+    normalized,
+    input2
+  );
+  if (theirstackTimeoutMs !== null) return theirstackTimeoutMs;
+  const waterfallTimeoutMs = resolveWaterfallClientTimeoutMs(normalized);
+  if (waterfallTimeoutMs !== null) return waterfallTimeoutMs;
+  if (usesExtendedBetterContactLauncherBudget(normalized)) {
+    return BETTERCONTACT_LAUNCHER_CLIENT_TIMEOUT_MS;
+  }
+  return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "ai_evaluate" || normalized === "deeplineagent_ai_evaluate" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
+}
+function isRecord2(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function materializeToolExecutionResponse(response) {
+  const toolResponse = response.toolResponse;
+  if (!toolResponse && isRecord2(response.result)) {
+    const legacyResult = response.result;
+    if (Object.prototype.hasOwnProperty.call(legacyResult, "data")) {
+      const legacyMeta = isRecord2(legacyResult.meta) ? legacyResult.meta : void 0;
+      return {
+        ...response,
+        toolResponse: {
+          raw: legacyResult.data,
+          ...legacyMeta ? { meta: legacyMeta } : {}
+        }
+      };
+    }
+  }
+  if (!toolResponse || Object.prototype.hasOwnProperty.call(toolResponse, "raw")) {
+    return response;
+  }
+  const rawV2 = toolResponse.rawV2;
+  const view = toolResponse.view;
+  const providerMeta = providerMetaFromToolResponseRawV2(
+    rawV2,
+    view ?? "rawV2"
+  );
+  const responseMeta = isRecord2(toolResponse.responseMeta) ? toolResponse.responseMeta : void 0;
+  return {
+    ...response,
+    toolResponse: {
+      ...toolResponse,
+      raw: legacyRawFromToolResponseRawV2(
+        rawV2,
+        view ?? "rawV2",
+        responseMeta
+      ),
+      ...toolResponse.meta || providerMeta || responseMeta ? {
+        meta: {
+          ...toolResponse.meta ?? {},
+          ...providerMeta ?? {},
+          ...responseMeta ?? {}
+        }
+      } : {}
+    }
+  };
+}
+var ToolCalls = class {
+  constructor(http, defaultRequestTimeoutMs) {
+    this.http = http;
+    this.defaultRequestTimeoutMs = defaultRequestTimeoutMs;
+  }
+  async call(toolId, input2, options) {
+    const inputSnapshot = JSON.parse(JSON.stringify(input2));
+    const metadataSnapshot = options?.metadata ? JSON.parse(JSON.stringify(options.metadata)) : void 0;
+    const idempotencyKey = options?.idempotencyKey ?? (options?.recover ? crypto.randomUUID() : void 0);
+    if (idempotencyKey !== void 0) {
+      validateExecutionIdempotencyKey(idempotencyKey);
+      if (options?.recoveryTimeoutMs !== void 0 && (!Number.isFinite(options.recoveryTimeoutMs) || options.recoveryTimeoutMs < 0)) {
+        throw new DeeplineError(
+          "recoveryTimeoutMs must be a finite, non-negative number.",
+          void 0,
+          "IDEMPOTENCY_KEY_INVALID"
+        );
+      }
+      await options?.onExecution?.({ idempotencyKey });
+    }
+    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, inputSnapshot);
+    if (idempotencyKey !== void 0) {
+      await this.lookupExecutionByKey(idempotencyKey, timeoutMs);
+    }
+    const isApifySync = toolId.trim().toLowerCase() === "apify_run_actor_sync";
+    const headers = {
+      [EXECUTE_RESPONSE_CONTRACT_HEADER]: RAW_V2_EXECUTE_RESPONSE_CONTRACT,
+      ...isApifySync ? { "X-Deepline-Apify-Sync-Response-Budget": "extended-v1" } : {},
+      [TOOL_EXECUTION_ERROR_SCHEMA_HEADER]: String(
+        TOOL_EXECUTION_ERROR_SCHEMA_VERSION
+      ),
+      ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
+      [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
+    };
+    const request = (requestTimeoutMs) => this.http.post(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
+      {
+        payload: inputSnapshot,
+        ...metadataSnapshot ? { metadata: metadataSnapshot } : {}
+      },
+      headers,
+      {
+        timeout: requestTimeoutMs,
+        maxRetries: idempotencyKey ? 0 : options?.maxRetries ?? 0,
+        retryApiErrors: options?.retryApiErrors === true,
+        exactUrlOnly: true,
+        toolId,
+        idempotencyKey
+      }
+    );
+    let response;
+    let recoveryDeadline = null;
+    const recoveryTimeoutMs = options?.recoveryTimeoutMs ?? DEFAULT_EXECUTION_RECOVERY_TIMEOUT_MS;
+    let retryDelayMs = 1e3;
+    const recoveryTimeoutError = () => executionRecoveryError({
+      toolId,
+      idempotencyKey,
+      code: "EXECUTION_RECOVERY_TIMEOUT",
+      message: `Execution recovery for ${idempotencyKey} did not finish before the recovery timeout. Inspect client.executions.getByKey() and resume with the same idempotency key.`
+    });
+    const waitForRecoveryRetry = async (deadline) => {
+      const remainingMs = deadline - Date.now();
+      if (remainingMs <= 0) throw recoveryTimeoutError();
+      await new Promise(
+        (resolve22) => setTimeout(resolve22, Math.min(retryDelayMs, remainingMs))
+      );
+      retryDelayMs = Math.min(retryDelayMs * 2, 5e3);
+    };
+    const lookupDuringRecovery = async () => {
+      while (true) {
+        const remainingMs = recoveryDeadline - Date.now();
+        if (remainingMs <= 0) throw recoveryTimeoutError();
+        try {
+          return await this.lookupExecutionByKey(
+            idempotencyKey,
+            timeoutWithinRecoveryBudget(
+              timeoutMs,
+              this.defaultRequestTimeoutMs,
+              remainingMs
+            )
+          );
+        } catch (error) {
+          if (!isRecoverableExecutionLookupError(error)) throw error;
+          await waitForRecoveryRetry(recoveryDeadline);
+        }
+      }
+    };
+    while (true) {
+      const remainingMs = recoveryDeadline === null ? null : recoveryDeadline - Date.now();
+      if (remainingMs !== null && remainingMs <= 0) {
+        throw recoveryTimeoutError();
+      }
+      try {
+        response = await request(
+          remainingMs === null ? timeoutMs : timeoutWithinRecoveryBudget(
+            timeoutMs,
+            this.defaultRequestTimeoutMs,
+            remainingMs
+          )
+        );
+        const recoveryState = getExecutionRecoveryState(response);
+        if (recoveryState === "outcome_unknown") {
+          if (!idempotencyKey) break;
+          throw executionRecoveryError({
+            toolId,
+            idempotencyKey,
+            code: "EXECUTION_OUTCOME_UNKNOWN",
+            message: `The outcome of execution ${idempotencyKey} is unknown. Do not retry with a new key; inspect client.executions.getByKey().`
+          });
+        }
+        if (!idempotencyKey || recoveryState !== "running") {
+          break;
+        }
+        if (recoveryDeadline === null) {
+          recoveryDeadline = Date.now() + recoveryTimeoutMs;
+        }
+      } catch (error) {
+        if (idempotencyKey && error instanceof DeeplineError && error.code === "EXECUTION_OUTCOME_UNKNOWN") {
+          throw executionRecoveryError({
+            toolId,
+            idempotencyKey,
+            code: "EXECUTION_OUTCOME_UNKNOWN",
+            message: error.message
+          });
+        }
+        if (!idempotencyKey || !isRecoverableExecutionAttemptError(error)) {
+          throw error;
+        }
+        if (recoveryDeadline === null) {
+          recoveryDeadline = Date.now() + recoveryTimeoutMs;
+        }
+      }
+      await waitForRecoveryRetry(recoveryDeadline);
+      const recovered = await lookupDuringRecovery();
+      if (getExecutionRecoveryState(recovered) === "outcome_unknown") {
+        throw executionRecoveryError({
+          toolId,
+          idempotencyKey,
+          code: "EXECUTION_OUTCOME_UNKNOWN",
+          message: `The outcome of execution ${idempotencyKey} is unknown. Do not retry with a new key; inspect client.executions.getByKey().`
+        });
+      }
+    }
+    const materialized = materializeToolExecutionResponse(response);
+    return idempotencyKey ? { ...materialized, idempotencyKey } : materialized;
+  }
+  /** Read the durable state of a keyed tool execution. */
+  async getByKey(idempotencyKey) {
+    validateExecutionIdempotencyKey(idempotencyKey);
+    const result = await this.lookupExecutionByKey(idempotencyKey);
+    if (!result) {
+      throw new DeeplineError(
+        `No execution exists for idempotency key ${idempotencyKey}.`,
+        404,
+        "EXECUTION_NOT_FOUND"
+      );
+    }
+    return result;
+  }
+  async lookupExecutionByKey(idempotencyKey, timeoutMs) {
+    validateExecutionIdempotencyKey(idempotencyKey);
+    let supported = false;
+    const result = await this.http.get(
+      `/api/v2/executions/by-key/${encodeURIComponent(idempotencyKey)}`,
+      {
+        exactUrlOnly: true,
+        maxRetries: 0,
+        timeout: timeoutMs,
+        idempotencyKey,
+        allowNotFound: true,
+        onResponse: (response) => {
+          supported = response.headers.get("X-Deepline-Idempotency-Supported") === "true";
+        }
+      }
+    );
+    if (!supported) {
+      throw new DeeplineError(
+        "This Deepline server does not support recoverable tool executions; no tool was dispatched.",
+        422,
+        "IDEMPOTENCY_NOT_SUPPORTED"
+      );
+    }
+    return result;
+  }
+};
+
 // ../plays/artifact-contract-version.ts
 var CURRENT_PLAY_ARTIFACT_CONTRACT_VERSION = 2;
 
@@ -3046,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.230",
+  version: "0.3.232",
   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
@@ -3730,7 +4133,7 @@ function providerLabelFromToolId(toolId) {
   const provider = normalized.split(/[_:./-]+/)[0];
   return provider || normalized || "provider";
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 var HttpClient = class {
@@ -3882,7 +4285,7 @@ var HttpClient = class {
           const parsed = parseResponseBody(body);
           const structuredToolError = options?.toolId && !response.ok ? deserializeToolExecutionFailure(
             apiErrorMessage(parsed, response.status),
-            isRecord2(parsed) ? parsed.tool_error : null,
+            isRecord3(parsed) ? parsed.tool_error : null,
             TOOL_EXECUTION_ERROR_SCHEMA_VERSION
           ) : null;
           if (structuredToolError) {
@@ -4953,11 +5356,11 @@ function buildPlayDocflowNodeErrorPreview(error, redactor = createSecretRedactio
     return "Non-Error value thrown (message unavailable)";
   }
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function normalizePreview(value, depth) {
-  if (!isRecord3(value) || typeof value.kind !== "string") return null;
+  if (!isRecord4(value) || typeof value.kind !== "string") return null;
   if (value.kind === "null") return { kind: "null" };
   if (value.kind === "scalar") {
     if (typeof value.value === "string" || typeof value.value === "boolean" || typeof value.value === "number" && Number.isFinite(value.value)) {
@@ -5022,7 +5425,7 @@ function normalizePreview(value, depth) {
       ...value.truncated === true || totalItems > items.length ? { truncated: true } : {}
     };
   }
-  if (value.kind === "object" && isRecord3(value.fields)) {
+  if (value.kind === "object" && isRecord4(value.fields)) {
     const fields2 = {};
     for (const [key, field] of Object.entries(value.fields).slice(
       0,
@@ -5042,10 +5445,10 @@ function normalizePreview(value, depth) {
   return null;
 }
 function normalizePlayDocflowNodeIoState(value) {
-  if (!isRecord3(value)) return void 0;
+  if (!isRecord4(value)) return void 0;
   const attempt = typeof value.attempt === "number" && Number.isFinite(value.attempt) ? Math.max(0, Math.floor(value.attempt)) : 0;
   const normalizeMap = (raw) => {
-    if (!isRecord3(raw)) return void 0;
+    if (!isRecord4(raw)) return void 0;
     const output2 = {};
     for (const [path, preview] of Object.entries(raw).slice(
       0,
@@ -5082,11 +5485,11 @@ function normalizePlayDocflowNodeIoState(value) {
 }
 
 // ../play-runtime/activity-observation.ts
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isPlayActivityObservation(value) {
-  if (!isRecord4(value) || value.schemaVersion !== void 0 && value.schemaVersion !== 1 || typeof value.activityId !== "string" || !value.activityId.trim() || typeof value.observedAt !== "number" || !Number.isFinite(value.observedAt) || !isRecord4(value.target) || !isRecord4(value.state)) {
+  if (!isRecord5(value) || value.schemaVersion !== void 0 && value.schemaVersion !== 1 || typeof value.activityId !== "string" || !value.activityId.trim() || typeof value.observedAt !== "number" || !Number.isFinite(value.observedAt) || !isRecord5(value.target) || !isRecord5(value.state)) {
     return false;
   }
   const targetKinds = /* @__PURE__ */ new Set([
@@ -5386,7 +5789,7 @@ var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
   "terminated",
   "timed_out"
 ]);
-function isRecord5(value) {
+function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
@@ -5401,7 +5804,7 @@ function isWorkCounterSegmentId(value) {
   );
 }
 function normalizePlayRunLedgerTerminalWorkCounterSegment(value) {
-  if (!isRecord5(value)) return void 0;
+  if (!isRecord6(value)) return void 0;
   if (!nonnegativeSafeInteger(value.attempt) || !nonnegativeSafeInteger(value.invocationSeq) || value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId)) {
     return void 0;
   }
@@ -5425,7 +5828,7 @@ function hasConfirmedPlayRunLedgerWorkCounters(snapshot) {
   );
 }
 function normalizeWorkCounters(value) {
-  if (!isRecord5(value)) return void 0;
+  if (!isRecord6(value)) return void 0;
   for (const field of [
     "attempt",
     "invocationSeq",
@@ -5515,8 +5918,8 @@ function summarizeRunRowOutcomes(snapshot) {
     const stepTotal = finiteNumber(progress.total);
     totalRows += stepTotal !== null && stepTotal >= 0 ? stepTotal : Math.max(0, finiteNumber(progress.completed) ?? 0) + Math.max(0, finiteNumber(progress.failed) ?? 0) + Math.max(0, finiteNumber(progress.supersededRows) ?? 0);
   }
-  const resultSummary = isRecord5(snapshot.resultSummary) ? snapshot.resultSummary : null;
-  const resultRowOutcomes = isRecord5(resultSummary?.rowOutcomes) ? resultSummary.rowOutcomes : null;
+  const resultSummary = isRecord6(snapshot.resultSummary) ? snapshot.resultSummary : null;
+  const resultRowOutcomes = isRecord6(resultSummary?.rowOutcomes) ? resultSummary.rowOutcomes : null;
   const terminalCompletedRows = finiteNumber(resultRowOutcomes?.completedRows);
   const terminalFailedRows = finiteNumber(resultRowOutcomes?.failedRows);
   const terminalTotalRows = finiteNumber(resultRowOutcomes?.totalRows);
@@ -5565,21 +5968,21 @@ function createEmptyPlayRunLedgerSnapshot(input2) {
   };
 }
 function normalizePlayRunLedgerSnapshot(value, fallback) {
-  if (!isRecord5(value)) {
+  if (!isRecord6(value)) {
     return createEmptyPlayRunLedgerSnapshot(fallback);
   }
   const orderedStepIds = Array.isArray(value.orderedStepIds) ? value.orderedStepIds.filter(
     (entry) => typeof entry === "string" && Boolean(entry.trim())
   ) : [];
-  const rawSteps = isRecord5(value.stepsById) ? value.stepsById : {};
+  const rawSteps = isRecord6(value.stepsById) ? value.stepsById : {};
   const stepsById = {};
   for (const [stepId, rawStep] of Object.entries(rawSteps)) {
-    if (!stepId.trim() || !isRecord5(rawStep)) continue;
+    if (!stepId.trim() || !isRecord6(rawStep)) continue;
     const rawStatus = normalizeStepStatus(rawStep.status);
     if (!rawStatus) continue;
     const completedAt = finiteNumber(rawStep.completedAt);
     const status = rawStatus === "running" && completedAt !== null ? "completed" : rawStatus;
-    const rawProgress = isRecord5(rawStep.progress) ? rawStep.progress : null;
+    const rawProgress = isRecord6(rawStep.progress) ? rawStep.progress : null;
     stepsById[stepId] = {
       stepId,
       label: optionalString(rawStep.label),
@@ -5595,10 +5998,10 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       progress: rawProgress ? normalizeStepProgress(rawProgress) : null
     };
   }
-  const rawDatasets = isRecord5(value.datasetsById) ? value.datasetsById : {};
+  const rawDatasets = isRecord6(value.datasetsById) ? value.datasetsById : {};
   const datasetsById = {};
   for (const [datasetId, rawDataset] of Object.entries(rawDatasets)) {
-    if (!datasetId.trim() || !isRecord5(rawDataset)) continue;
+    if (!datasetId.trim() || !isRecord6(rawDataset)) continue;
     const phase = rawDataset.phase === "available" || rawDataset.phase === "failed" ? rawDataset.phase : "registered";
     const datasetBornFrom = normalizeDatasetBornFrom(rawDataset.bornFrom);
     datasetsById[datasetId] = {
@@ -5621,7 +6024,7 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       updatedAt: finiteNumber(rawDataset.updatedAt) ?? 0
     };
   }
-  const rawActivities = isRecord5(value.activitiesById) ? value.activitiesById : {};
+  const rawActivities = isRecord6(value.activitiesById) ? value.activitiesById : {};
   const activitiesById = {};
   for (const [activityId, rawActivity] of Object.entries(rawActivities)) {
     if (activityId.trim() && isPlayActivityObservation(rawActivity) && rawActivity.activityId === activityId) {
@@ -5911,18 +6314,18 @@ function normalizePlayRunLiveStatus(value) {
 function isTerminalPlayRunLiveStatus(status) {
   return isTerminalPlayRunLifecycleStatus(status);
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 function extractTerminalRunLogTail(result) {
-  if (!isRecord6(result) || !isRecord6(result._metadata)) {
+  if (!isRecord7(result) || !isRecord7(result._metadata)) {
     return null;
   }
   const runLogTail = result._metadata.runLogTail;
-  if (!isRecord6(runLogTail) || !Array.isArray(runLogTail.tail)) {
+  if (!isRecord7(runLogTail) || !Array.isArray(runLogTail.tail)) {
     return null;
   }
   const logTail = runLogTail.tail.filter(
@@ -6582,80 +6985,6 @@ function isStopAllPlayRunsDryRunResult(result) {
   return "dryRun" in result && result.dryRun === true;
 }
 
-// ../integration-contracts/theirstack/execution-policy.ts
-var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
-var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
-var THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS = 21e4;
-var LONG_JOB_SEARCH_WINDOW_MS = 365 * 24 * 60 * 60 * 1e3;
-var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
-function parseDateOnly(value) {
-  if (typeof value !== "string" || !DATE_ONLY_PATTERN.test(value)) {
-    return null;
-  }
-  const timestamp = Date.parse(`${value}T00:00:00.000Z`);
-  if (!Number.isFinite(timestamp)) {
-    return null;
-  }
-  return new Date(timestamp).toISOString().slice(0, 10) === value ? timestamp : null;
-}
-function usesLongExplicitDateWindow(payload) {
-  const postedAtGte = parseDateOnly(payload.posted_at_gte);
-  const postedAtLte = parseDateOnly(payload.posted_at_lte);
-  if (postedAtGte !== null && postedAtLte !== null) {
-    return postedAtLte - postedAtGte >= LONG_JOB_SEARCH_WINDOW_MS;
-  }
-  if (postedAtGte !== null) {
-    return Date.now() - postedAtGte >= LONG_JOB_SEARCH_WINDOW_MS;
-  }
-  return postedAtLte !== null && payload.posted_at_gte == null;
-}
-function parseMaxAgeDays(value) {
-  if (typeof value === "number") {
-    return Number.isFinite(value) ? value : null;
-  }
-  if (typeof value !== "string" || !/^-?\d+$/.test(value.trim())) {
-    return null;
-  }
-  const parsed = Number(value.trim());
-  return Number.isSafeInteger(parsed) ? parsed : null;
-}
-function usesExtendedTheirstackJobSearchBudget(endpointId, payload) {
-  if (endpointId !== "theirstack_job_search") {
-    return false;
-  }
-  if (payload.include_total_results === true) {
-    return true;
-  }
-  const maxAgeDays = parseMaxAgeDays(payload.posted_at_max_age_days);
-  return maxAgeDays !== null && maxAgeDays >= 365 ? true : usesLongExplicitDateWindow(payload);
-}
-function resolveTheirstackClientTimeoutMs(endpointId, payload) {
-  if (endpointId === "theirstack_company_search") {
-    return THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS;
-  }
-  return usesExtendedTheirstackJobSearchBudget(endpointId, payload) ? THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS : null;
-}
-
-// ../integration-contracts/waterfall/execution-policy.ts
-var WATERFALL_PROSPECTOR_CLIENT_TIMEOUT_MS = 18e4;
-var WATERFALL_PROSPECTOR_LAUNCHER_TOOL_IDS = /* @__PURE__ */ new Set([
-  "prospector",
-  "deepline_native_prospector"
-]);
-function resolveWaterfallClientTimeoutMs(toolId) {
-  return WATERFALL_PROSPECTOR_LAUNCHER_TOOL_IDS.has(toolId.trim().toLowerCase()) ? WATERFALL_PROSPECTOR_CLIENT_TIMEOUT_MS : null;
-}
-
-// ../integration-contracts/bettercontact/execution-policy.ts
-var BETTERCONTACT_LAUNCHER_CLIENT_TIMEOUT_MS = 12e4;
-var BETTERCONTACT_LAUNCHER_TOOL_IDS = /* @__PURE__ */ new Set([
-  "bettercontact_enrich",
-  "bettercontact_bulk_enrich"
-]);
-function usesExtendedBetterContactLauncherBudget(toolId) {
-  return BETTERCONTACT_LAUNCHER_TOOL_IDS.has(toolId.trim().toLowerCase());
-}
-
 // ../plays/artifact-types.ts
 var PLAY_ARTIFACT_KINDS = {
   cjsNode20: "cjs_node20"
@@ -6729,27 +7058,6 @@ function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
 }
 
-// ../plays/tool-response-contract.ts
-var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
-function legacyRawFromToolResponseRawV2(rawV2, view, responseMeta) {
-  const legacyRaw = view === "data" && rawV2 && typeof rawV2 === "object" && !Array.isArray(rawV2) ? rawV2.data : rawV2;
-  const deeplineBilling = responseMeta?.deepline_billing;
-  if (view === "rawV2" && deeplineBilling !== void 0 && legacyRaw && typeof legacyRaw === "object" && !Array.isArray(legacyRaw)) {
-    return {
-      ...legacyRaw,
-      deepline_billing: deeplineBilling
-    };
-  }
-  return legacyRaw;
-}
-function providerMetaFromToolResponseRawV2(rawV2, view) {
-  if (view !== "data" || !rawV2 || typeof rawV2 !== "object" || Array.isArray(rawV2)) {
-    return void 0;
-  }
-  const meta = rawV2.meta;
-  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : void 0;
-}
-
 // src/client.ts
 var MAX_NOTIFICATION_GROUP_CREATE_TARGETS = 50;
 function parseNotificationGroupTarget(value) {
@@ -6788,69 +7096,14 @@ function notificationObjectKey(kind) {
   return `${kind}.${globalThis.crypto.randomUUID()}`;
 }
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
-var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
-var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
-var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
 var MONITOR_NON_RETRYABLE_MUTATION_OPTIONS = {
   maxRetries: 0,
   exactUrlOnly: true
 };
-var RAW_V2_EXECUTE_RESPONSE_CONTRACT = RAW_V2_TOOL_RESPONSE_CONTRACT;
-var DEFAULT_EXECUTION_RECOVERY_TIMEOUT_MS = 15 * 60 * 1e3;
-function validateExecutionIdempotencyKey(key) {
-  if (typeof key !== "string" || key.length < 1 || key.length > 200 || !/^[A-Za-z0-9._:-]+$/.test(key)) {
-    throw new DeeplineError(
-      "Execution idempotency keys must be 1\u2013200 ASCII letters, digits, dots, underscores, colons, or hyphens.",
-      void 0,
-      "IDEMPOTENCY_KEY_INVALID"
-    );
-  }
-}
-function isExecutionInProgressResponse(value) {
-  return typeof value === "object" && value !== null && typeof value.executionRecovery === "object" && value.executionRecovery.state === "running";
-}
-function getExecutionRecoveryState(value) {
-  if (typeof value !== "object" || value === null || typeof value.executionRecovery !== "object") {
-    return null;
-  }
-  const state = value.executionRecovery.state;
-  return state === "running" || state === "completed" || state === "outcome_unknown" ? state : null;
-}
-function isRecoverableExecutionAttemptError(error) {
-  if (error instanceof ToolExecutionError) {
-    return error.code === "EXECUTION_IN_PROGRESS" || error.origin === "deepline" && error.category === "network" && error.networkScope === "client_to_deepline";
-  }
-  return error instanceof DeeplineError && (error.code === "EXECUTION_IN_PROGRESS" || error.code?.startsWith("NETWORK_") === true && error.statusCode === void 0);
-}
-function isRecoverableExecutionLookupError(error) {
-  if (isRecoverableExecutionAttemptError(error)) return true;
-  return error instanceof DeeplineError && (error.statusCode === 429 || error.statusCode !== void 0 && error.statusCode >= 500);
-}
-function timeoutWithinRecoveryBudget(requestTimeoutMs, defaultRequestTimeoutMs, remainingMs) {
-  return Math.min(requestTimeoutMs ?? defaultRequestTimeoutMs, remainingMs);
-}
-function executionRecoveryError(input2) {
-  return new ToolExecutionError(input2.message, {
-    toolId: input2.toolId,
-    provider: null,
-    operation: input2.toolId,
-    code: input2.code,
-    origin: "deepline",
-    category: input2.code === "EXECUTION_OUTCOME_UNKNOWN" ? "unknown" : "conflict",
-    retryable: input2.code !== "EXECUTION_OUTCOME_UNKNOWN",
-    statusCode: null,
-    requestId: null,
-    retryAfterMs: null,
-    networkKind: null,
-    networkScope: null,
-    publicDetails: { idempotencyKey: input2.idempotencyKey }
-  });
-}
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
 var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
 var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT = 3;
 var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_BYTES = 25e5;
-var DEEPLINEAGENT_EXECUTE_TIMEOUT_MS = 15 * 60 * 1e3;
 function normalizePlayRunIntegrationMode(value) {
   if (value === "live" || value === "eval_stub" || value === "fixture") {
     return value;
@@ -7041,28 +7294,6 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-var APIFY_SYNC_DEFAULT_TIMEOUT_MS = 3e5;
-var APIFY_SYNC_RESPONSE_GRACE_MS = 9e4;
-function resolveToolExecuteTimeoutMs(toolId, input2) {
-  const normalized = toolId.trim().toLowerCase();
-  if (normalized === "apify_run_actor_sync") {
-    const requestedTimeoutMs = input2.timeoutMs ?? APIFY_SYNC_DEFAULT_TIMEOUT_MS;
-    if (typeof requestedTimeoutMs === "number" && Number.isFinite(requestedTimeoutMs) && requestedTimeoutMs > 0) {
-      return Math.floor(requestedTimeoutMs) + APIFY_SYNC_RESPONSE_GRACE_MS;
-    }
-  }
-  const theirstackTimeoutMs = resolveTheirstackClientTimeoutMs(
-    normalized,
-    input2
-  );
-  if (theirstackTimeoutMs !== null) return theirstackTimeoutMs;
-  const waterfallTimeoutMs = resolveWaterfallClientTimeoutMs(normalized);
-  if (waterfallTimeoutMs !== null) return waterfallTimeoutMs;
-  if (usesExtendedBetterContactLauncherBudget(normalized)) {
-    return BETTERCONTACT_LAUNCHER_CLIENT_TIMEOUT_MS;
-  }
-  return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "ai_evaluate" || normalized === "deeplineagent_ai_evaluate" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
-}
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
 function requireTargetBillingIdempotencyKey(value) {
@@ -7076,53 +7307,9 @@ function requireTargetBillingIdempotencyKey(value) {
   }
   return normalized;
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function materializeToolExecutionResponse(response) {
-  const toolResponse = response.toolResponse;
-  if (!toolResponse && isRecord7(response.result)) {
-    const legacyResult = response.result;
-    if (Object.prototype.hasOwnProperty.call(legacyResult, "data")) {
-      const legacyMeta = isRecord7(legacyResult.meta) ? legacyResult.meta : void 0;
-      return {
-        ...response,
-        toolResponse: {
-          raw: legacyResult.data,
-          ...legacyMeta ? { meta: legacyMeta } : {}
-        }
-      };
-    }
-  }
-  if (!toolResponse || Object.prototype.hasOwnProperty.call(toolResponse, "raw")) {
-    return response;
-  }
-  const rawV2 = toolResponse.rawV2;
-  const view = toolResponse.view;
-  const providerMeta = providerMetaFromToolResponseRawV2(
-    rawV2,
-    view ?? "rawV2"
-  );
-  const responseMeta = isRecord7(toolResponse.responseMeta) ? toolResponse.responseMeta : void 0;
-  return {
-    ...response,
-    toolResponse: {
-      ...toolResponse,
-      raw: legacyRawFromToolResponseRawV2(
-        rawV2,
-        view ?? "rawV2",
-        responseMeta
-      ),
-      ...toolResponse.meta || providerMeta || responseMeta ? {
-        meta: {
-          ...toolResponse.meta ?? {},
-          ...providerMeta ?? {},
-          ...responseMeta ?? {}
-        }
-      } : {}
-    }
-  };
-}
 function isPrebuiltPlayDescription(play) {
   return play.origin === "prebuilt" || play.ownerType === "deepline";
 }
@@ -7152,10 +7339,10 @@ function normalizePlayStatus(raw) {
   return {
     ...raw,
     runId,
-    ...isRecord7(legacyOverview) ? {
+    ...isRecord8(legacyOverview) ? {
       overview: legacyOverview
     } : {},
-    ...isRecord7(runStatus) ? { runStatus } : {},
+    ...isRecord8(runStatus) ? { runStatus } : {},
     ...runPackage ? {
       package: runPackage,
       outputs: runPackage.outputs
@@ -7294,7 +7481,7 @@ function updatePlayLiveStatusState(state, event) {
   }
   const runId = typeof payload.runId === "string" && payload.runId ? payload.runId : isPlayRunPackage(payload) ? payload.run.id : state.runId;
   const status = normalizeLiveStatus(payload.status) ?? (isPlayRunPackage(payload) ? normalizeLiveStatus(payload.run.status) : null) ?? state.status;
-  const progressPayload = isRecord7(payload.progress) ? payload.progress : {};
+  const progressPayload = isRecord8(payload.progress) ? payload.progress : {};
   if (event.type === "play.run.final_status" && state.logs.length === 0 && state.lastLogSeq === 0) {
     const payloadLogs = readStringArray(payload.logs);
     const progressLogs = readStringArray(progressPayload.logs);
@@ -7343,6 +7530,7 @@ function playRunResultFromStatus(status, startedAt, fallbackRunId) {
 }
 var DeeplineClient = class _DeeplineClient {
   http;
+  toolCalls;
   config;
   /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
   runs;
@@ -7366,6 +7554,7 @@ var DeeplineClient = class _DeeplineClient {
   constructor(options) {
     this.config = resolveConfig(options);
     this.http = new HttpClient(this.config);
+    this.toolCalls = new ToolCalls(this.http, this.config.timeout);
     this.runs = {
       get: (runId, options2) => this.getRunStatus(runId, options2),
       status: (runId) => this.getRunLifecycleStatus(runId),
@@ -7493,9 +7682,9 @@ var DeeplineClient = class _DeeplineClient {
     return fields2.length > 0 ? { fields: fields2 } : schema;
   }
   schemaMetadata(schema, key) {
-    if (!isRecord7(schema)) return null;
+    if (!isRecord8(schema)) return null;
     const value = schema[key];
-    return isRecord7(value) ? value : null;
+    return isRecord8(value) ? value : null;
   }
   playRunCommand(play, options) {
     const target = play.reference || play.name;
@@ -7550,7 +7739,7 @@ var DeeplineClient = class _DeeplineClient {
       aliases,
       inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
       outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
-      staticPipeline: isRecord7(play.staticPipeline) ? play.staticPipeline : isRecord7(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord7(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
+      staticPipeline: isRecord8(play.staticPipeline) ? play.staticPipeline : isRecord8(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord8(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
       ...csvInput ? { csvInput } : {},
       ...rowOutputSchema ? { rowOutputSchema } : {},
       runCommand: runCommand2,
@@ -7770,183 +7959,11 @@ var DeeplineClient = class _DeeplineClient {
    * Deepline execution envelope.
    */
   async executeTool(toolId, input2, options) {
-    const inputSnapshot = JSON.parse(JSON.stringify(input2));
-    const metadataSnapshot = options?.metadata ? JSON.parse(JSON.stringify(options.metadata)) : void 0;
-    const idempotencyKey = options?.idempotencyKey ?? (options?.recover ? crypto.randomUUID() : void 0);
-    if (idempotencyKey !== void 0) {
-      validateExecutionIdempotencyKey(idempotencyKey);
-      if (options?.recoveryTimeoutMs !== void 0 && (!Number.isFinite(options.recoveryTimeoutMs) || options.recoveryTimeoutMs < 0)) {
-        throw new DeeplineError(
-          "recoveryTimeoutMs must be a finite, non-negative number.",
-          void 0,
-          "IDEMPOTENCY_KEY_INVALID"
-        );
-      }
-      await options?.onExecution?.({ idempotencyKey });
-      const timeoutMs2 = options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, inputSnapshot);
-      await this.lookupExecutionByKey(idempotencyKey, timeoutMs2);
-    }
-    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, inputSnapshot);
-    const isApifySync = toolId.trim().toLowerCase() === "apify_run_actor_sync";
-    const headers = {
-      [EXECUTE_RESPONSE_CONTRACT_HEADER]: RAW_V2_EXECUTE_RESPONSE_CONTRACT,
-      ...isApifySync ? { "X-Deepline-Apify-Sync-Response-Budget": "extended-v1" } : {},
-      [TOOL_EXECUTION_ERROR_SCHEMA_HEADER]: String(
-        TOOL_EXECUTION_ERROR_SCHEMA_VERSION
-      ),
-      ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
-      [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw",
-      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
-      ...options?.searchRef ? { "x-deepline-search-ref": options.searchRef } : {}
-    };
-    const request = (requestTimeoutMs) => this.http.post(
-      `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
-      {
-        payload: inputSnapshot,
-        ...metadataSnapshot ? { metadata: metadataSnapshot } : {}
-      },
-      headers,
-      {
-        timeout: requestTimeoutMs,
-        maxRetries: idempotencyKey ? 0 : options?.maxRetries ?? 0,
-        retryApiErrors: options?.retryApiErrors === true,
-        exactUrlOnly: true,
-        toolId,
-        idempotencyKey
-      }
-    );
-    let response;
-    let recoveryDeadline = null;
-    const recoveryTimeoutMs = options?.recoveryTimeoutMs ?? DEFAULT_EXECUTION_RECOVERY_TIMEOUT_MS;
-    let retryDelayMs = 1e3;
-    const recoveryTimeoutError = () => executionRecoveryError({
-      toolId,
-      idempotencyKey,
-      code: "EXECUTION_RECOVERY_TIMEOUT",
-      message: `Execution recovery for ${idempotencyKey} did not finish before the recovery timeout. Inspect client.executions.getByKey() and resume with the same idempotency key.`
-    });
-    const waitForRecoveryRetry = async (deadline) => {
-      const remainingMs = deadline - Date.now();
-      if (remainingMs <= 0) throw recoveryTimeoutError();
-      await new Promise(
-        (resolve22) => setTimeout(resolve22, Math.min(retryDelayMs, remainingMs))
-      );
-      retryDelayMs = Math.min(retryDelayMs * 2, 5e3);
-    };
-    const lookupDuringRecovery = async () => {
-      while (true) {
-        const remainingMs = recoveryDeadline - Date.now();
-        if (remainingMs <= 0) throw recoveryTimeoutError();
-        try {
-          return await this.lookupExecutionByKey(
-            idempotencyKey,
-            timeoutWithinRecoveryBudget(
-              timeoutMs,
-              this.config.timeout,
-              remainingMs
-            )
-          );
-        } catch (error) {
-          if (!isRecoverableExecutionLookupError(error)) throw error;
-          await waitForRecoveryRetry(recoveryDeadline);
-        }
-      }
-    };
-    while (true) {
-      const remainingMs = recoveryDeadline === null ? null : recoveryDeadline - Date.now();
-      if (remainingMs !== null && remainingMs <= 0) {
-        throw recoveryTimeoutError();
-      }
-      try {
-        response = await request(
-          remainingMs === null ? timeoutMs : timeoutWithinRecoveryBudget(
-            timeoutMs,
-            this.config.timeout,
-            remainingMs
-          )
-        );
-        if (getExecutionRecoveryState(response) === "outcome_unknown") {
-          if (!idempotencyKey) break;
-          throw executionRecoveryError({
-            toolId,
-            idempotencyKey,
-            code: "EXECUTION_OUTCOME_UNKNOWN",
-            message: `The outcome of execution ${idempotencyKey} is unknown. Do not retry with a new key; inspect client.executions.getByKey().`
-          });
-        }
-        if (!idempotencyKey || !isExecutionInProgressResponse(response)) {
-          break;
-        }
-        if (recoveryDeadline === null) {
-          recoveryDeadline = Date.now() + recoveryTimeoutMs;
-        }
-      } catch (error) {
-        if (idempotencyKey && error instanceof DeeplineError && error.code === "EXECUTION_OUTCOME_UNKNOWN") {
-          throw executionRecoveryError({
-            toolId,
-            idempotencyKey,
-            code: "EXECUTION_OUTCOME_UNKNOWN",
-            message: error.message
-          });
-        }
-        if (!idempotencyKey || !isRecoverableExecutionAttemptError(error)) {
-          throw error;
-        }
-        if (recoveryDeadline === null) {
-          recoveryDeadline = Date.now() + recoveryTimeoutMs;
-        }
-      }
-      await waitForRecoveryRetry(recoveryDeadline);
-      const recovered = await lookupDuringRecovery();
-      if (getExecutionRecoveryState(recovered) === "outcome_unknown") {
-        throw executionRecoveryError({
-          toolId,
-          idempotencyKey,
-          code: "EXECUTION_OUTCOME_UNKNOWN",
-          message: `The outcome of execution ${idempotencyKey} is unknown. Do not retry with a new key; inspect client.executions.getByKey().`
-        });
-      }
-    }
-    const materialized = materializeToolExecutionResponse(response);
-    return idempotencyKey ? { ...materialized, idempotencyKey } : materialized;
+    return this.toolCalls.call(toolId, input2, options);
   }
   /** Read the durable state of a keyed tool execution. */
   async getExecutionByKey(idempotencyKey) {
-    validateExecutionIdempotencyKey(idempotencyKey);
-    const result = await this.lookupExecutionByKey(idempotencyKey);
-    if (!result) {
-      throw new DeeplineError(
-        `No execution exists for idempotency key ${idempotencyKey}.`,
-        404,
-        "EXECUTION_NOT_FOUND"
-      );
-    }
-    return result;
-  }
-  async lookupExecutionByKey(idempotencyKey, timeoutMs) {
-    validateExecutionIdempotencyKey(idempotencyKey);
-    let supported = false;
-    const result = await this.http.get(
-      `/api/v2/executions/by-key/${encodeURIComponent(idempotencyKey)}`,
-      {
-        exactUrlOnly: true,
-        maxRetries: 0,
-        timeout: timeoutMs,
-        idempotencyKey,
-        allowNotFound: true,
-        onResponse: (response) => {
-          supported = response.headers.get("X-Deepline-Idempotency-Supported") === "true";
-        }
-      }
-    );
-    if (!supported) {
-      throw new DeeplineError(
-        "This Deepline server does not support recoverable tool executions; no tool was dispatched.",
-        422,
-        "IDEMPOTENCY_NOT_SUPPORTED"
-      );
-    }
-    return result;
+    return this.toolCalls.getByKey(idempotencyKey);
   }
   /** Public recovery namespace. */
   get executions() {
@@ -8754,10 +8771,10 @@ var DeeplineClient = class _DeeplineClient {
     const responseRunStatus = isPlayRunPackage(response) ? response.runStatus : isPlayRunPackage(response.package) ? response.package.runStatus : response.runStatus;
     const responseOverview = isPlayRunPackage(response) ? response.overview : isPlayRunPackage(response.package) ? response.package.overview : response.overview;
     const status = normalizePlayStatus(response);
-    if (isRecord7(responseRunStatus)) {
+    if (isRecord8(responseRunStatus)) {
       status.runStatus = responseRunStatus;
     }
-    if (isRecord7(responseOverview)) {
+    if (isRecord8(responseOverview)) {
       status.overview = responseOverview;
     }
     if (options?.failedLogs !== true || status.status !== "failed") {
@@ -14582,24 +14599,24 @@ function sanitizeCsvProjectionInfo(input2) {
   const rows = input2.rows.map(stripCsvProjectionFields);
   return { rows, columns };
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isSerializedDataset(value) {
-  return isRecord8(value) && value.kind === "dataset" && typeof value.count === "number" && (Array.isArray(value.preview) || typeof value.tableNamespace === "string");
+  return isRecord9(value) && value.kind === "dataset" && typeof value.count === "number" && (Array.isArray(value.preview) || typeof value.tableNamespace === "string");
 }
 function isPackagedDatasetOutput(value) {
-  return isRecord8(value) && value.kind === "dataset" && isRecord8(value.preview) && Array.isArray(value.preview.rows);
+  return isRecord9(value) && value.kind === "dataset" && isRecord9(value.preview) && Array.isArray(value.preview.rows);
 }
 function hasCurrentTableExport(value) {
-  if (!isRecord8(value) || !isRecord8(value.actions)) return false;
+  if (!isRecord9(value) || !isRecord9(value.actions)) return false;
   const exportCsv = value.actions.exportCsv;
-  return isRecord8(exportCsv) && isRecord8(exportCsv.scope) && exportCsv.scope.kind === "database" && exportCsv.scope.mutability === "current";
+  return isRecord9(exportCsv) && isRecord9(exportCsv.scope) && exportCsv.scope.kind === "database" && exportCsv.scope.mutability === "current";
 }
 function currentTableQueryCommand(value) {
-  if (!isRecord8(value) || !isRecord8(value.actions)) return void 0;
+  if (!isRecord9(value) || !isRecord9(value.actions)) return void 0;
   const query = value.actions.queryCurrentTable;
-  const command = isRecord8(query) ? query.command : void 0;
+  const command = isRecord9(query) ? query.command : void 0;
   return typeof command === "string" && command.trim() ? command.trim() : void 0;
 }
 function recoveredReturnPaths(value) {
@@ -14618,7 +14635,7 @@ function pathParts(path) {
 function valueAtPath(root, path) {
   let cursor = root;
   for (const part of pathParts(path)) {
-    if (!isRecord8(cursor)) {
+    if (!isRecord9(cursor)) {
       return void 0;
     }
     cursor = cursor[part];
@@ -14626,17 +14643,17 @@ function valueAtPath(root, path) {
   return cursor;
 }
 function totalRowsForDataset(result, datasetPath) {
-  const metadata = isRecord8(result._metadata) ? result._metadata : null;
+  const metadata = isRecord9(result._metadata) ? result._metadata : null;
   const parentPath = datasetPath.split(".").slice(0, -1).join(".");
   const parent = parentPath ? valueAtPath({ result }, parentPath) : result;
-  return metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count ?? (isRecord8(parent) ? parent.totalRows ?? parent.rowCount ?? parent.count : void 0) ?? result.totalRows ?? result.rowCount ?? result.count;
+  return metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count ?? (isRecord9(parent) ? parent.totalRows ?? parent.rowCount ?? parent.count : void 0) ?? result.totalRows ?? result.rowCount ?? result.count;
 }
 function rowArray(value) {
   if (!Array.isArray(value)) {
     return null;
   }
   const rows = value.filter(
-    (row) => isRecord8(row)
+    (row) => isRecord9(row)
   );
   return rows.length === value.length ? rows : null;
 }
@@ -14660,7 +14677,7 @@ function inferColumns(rows) {
   return columns;
 }
 function columnsFromDatasetSummary(summary) {
-  if (!isRecord8(summary) || !isRecord8(summary.columnStats)) {
+  if (!isRecord9(summary) || !isRecord9(summary.columnStats)) {
     return [];
   }
   return Object.keys(summary.columnStats).filter((column) => column);
@@ -14717,7 +14734,7 @@ function canonicalRowsInfoFromCandidate(input2) {
           candidate.value.recoveredReturnPaths
         )
       } : {},
-      ...isRecord8(candidate.value.exportUnavailable) && (candidate.value.exportUnavailable.reason === "empty_dataset" || candidate.value.exportUnavailable.reason === "shared_table_namespace" || candidate.value.exportUnavailable.reason === "returned_dataset_not_persisted") ? {
+      ...isRecord9(candidate.value.exportUnavailable) && (candidate.value.exportUnavailable.reason === "empty_dataset" || candidate.value.exportUnavailable.reason === "shared_table_namespace" || candidate.value.exportUnavailable.reason === "returned_dataset_not_persisted") ? {
         exportUnavailableReason: candidate.value.exportUnavailable.reason,
         ...typeof candidate.value.exportUnavailable.message === "string" ? {
           exportUnavailableMessage: candidate.value.exportUnavailable.message
@@ -14765,7 +14782,7 @@ function collectDatasetCandidates(input2) {
     });
     return;
   }
-  if (!isRecord8(input2.value)) {
+  if (!isRecord9(input2.value)) {
     return;
   }
   for (const [key, child] of Object.entries(input2.value)) {
@@ -14782,12 +14799,12 @@ function collectDatasetCandidates(input2) {
   }
 }
 function collectCanonicalRowsInfos(statusOrResult) {
-  const root = isRecord8(statusOrResult) ? statusOrResult : null;
-  const result = isRecord8(root?.result) ? root.result : root;
+  const root = isRecord9(statusOrResult) ? statusOrResult : null;
+  const result = isRecord9(root?.result) ? root.result : root;
   if (!result) {
     return [];
   }
-  const metadata = isRecord8(result._metadata) ? result._metadata : null;
+  const metadata = isRecord9(result._metadata) ? result._metadata : null;
   const totalFromMetadata = metadata?.totalRows ?? metadata?.rowCount ?? metadata?.count;
   const candidates = [
     {
@@ -14811,8 +14828,8 @@ function collectCanonicalRowsInfos(statusOrResult) {
       total: totalFromMetadata ?? result.totalRows ?? result.rowCount ?? result.count
     }
   ];
-  if (isRecord8(result.output)) {
-    const outputMetadata = isRecord8(result.output._metadata) ? result.output._metadata : null;
+  if (isRecord9(result.output)) {
+    const outputMetadata = isRecord9(result.output._metadata) ? result.output._metadata : null;
     const outputTotalFromMetadata = outputMetadata?.totalRows ?? outputMetadata?.rowCount ?? outputMetadata?.count;
     candidates.push(
       {
@@ -14839,14 +14856,14 @@ function collectCanonicalRowsInfos(statusOrResult) {
   }
   if (Array.isArray(result.steps)) {
     result.steps.forEach((step, index) => {
-      if (!isRecord8(step) || !isRecord8(step.output)) {
+      if (!isRecord9(step) || !isRecord9(step.output)) {
         return;
       }
       const source = typeof step.output.path === "string" ? step.output.path : typeof step.id === "string" ? `steps.${step.id}.output` : `steps.${index}.output`;
       candidates.push({
         source,
         value: step.output,
-        total: step.output.rowCount ?? (isRecord8(step.output.preview) ? step.output.preview.totalRows : void 0) ?? (isRecord8(step.progress) ? step.progress.total : void 0)
+        total: step.output.rowCount ?? (isRecord9(step.output.preview) ? step.output.preview.totalRows : void 0) ?? (isRecord9(step.progress) ? step.progress.total : void 0)
       });
     });
   }
@@ -14874,15 +14891,15 @@ function collectCanonicalRowsInfos(statusOrResult) {
   return infos;
 }
 function collectPackagedDatasetCandidates(statusOrResult) {
-  const root = isRecord8(statusOrResult) ? statusOrResult : null;
+  const root = isRecord9(statusOrResult) ? statusOrResult : null;
   if (!root) {
     return [];
   }
-  const pkg = isRecord8(root.package) ? root.package : root;
+  const pkg = isRecord9(root.package) ? root.package : root;
   const datasets = Array.isArray(pkg.datasets) ? pkg.datasets : [];
   const candidates = [];
   for (const output2 of datasets) {
-    if (!isRecord8(output2) || !isPackagedDatasetOutput(output2)) {
+    if (!isRecord9(output2) || !isPackagedDatasetOutput(output2)) {
       continue;
     }
     const source = typeof output2.path === "string" && output2.path.trim() ? output2.path.trim() : null;
@@ -14892,18 +14909,18 @@ function collectPackagedDatasetCandidates(statusOrResult) {
     candidates.push({
       source,
       value: output2,
-      total: output2.rowCount ?? (isRecord8(output2.preview) ? output2.preview.totalRows : void 0)
+      total: output2.rowCount ?? (isRecord9(output2.preview) ? output2.preview.totalRows : void 0)
     });
   }
   return candidates;
 }
 function collectPackagedStepDatasetCandidates(statusOrResult) {
-  const root = isRecord8(statusOrResult) ? statusOrResult : null;
+  const root = isRecord9(statusOrResult) ? statusOrResult : null;
   if (!root) return [];
-  const pkg = isRecord8(root.package) ? root.package : root;
+  const pkg = isRecord9(root.package) ? root.package : root;
   const steps = Array.isArray(pkg.steps) ? pkg.steps : [];
   return steps.flatMap((step) => {
-    if (!isRecord8(step) || !isPackagedDatasetOutput(step.output)) return [];
+    if (!isRecord9(step) || !isPackagedDatasetOutput(step.output)) return [];
     const source = typeof step.output.path === "string" && step.output.path.trim() ? step.output.path.trim() : null;
     return source ? [
       {
@@ -14915,8 +14932,8 @@ function collectPackagedStepDatasetCandidates(statusOrResult) {
   });
 }
 function collectSerializedDatasetRowsInfos(statusOrResult) {
-  const root = isRecord8(statusOrResult) ? statusOrResult : null;
-  const result = isRecord8(root?.result) ? root.result : root;
+  const root = isRecord9(statusOrResult) ? statusOrResult : null;
+  const result = isRecord9(root?.result) ? root.result : root;
   const candidates = [];
   if (result) {
     collectDatasetCandidates({
@@ -14924,7 +14941,7 @@ function collectSerializedDatasetRowsInfos(statusOrResult) {
       path: "result",
       output: candidates
     });
-    if (isRecord8(result.output)) {
+    if (isRecord9(result.output)) {
       collectDatasetCandidates({
         value: result.output,
         path: "result",
@@ -15007,13 +15024,13 @@ function summarizeSampleValue(value, depth = 0) {
   if (typeof parsed === "number" || typeof parsed === "boolean") return parsed;
   if (depth >= 3) {
     if (Array.isArray(parsed)) return [];
-    if (isRecord8(parsed)) return {};
+    if (isRecord9(parsed)) return {};
     return compactScalar(parsed);
   }
   if (Array.isArray(parsed)) {
     return parsed.slice(0, 3).map((item) => summarizeSampleValue(item, depth + 1));
   }
-  if (isRecord8(parsed)) {
+  if (isRecord9(parsed)) {
     const out = {};
     for (const [key, nested] of Object.entries(parsed)) {
       if (["__dl", "meta", "metadata"].includes(key)) {
@@ -15044,7 +15061,7 @@ function compactCell(value) {
     }
     return `[${parsed.length} items]`;
   }
-  if (isRecord8(parsed)) {
+  if (isRecord9(parsed)) {
     for (const key of ["matched_result", "output"]) {
       if (parsed[key] !== null && parsed[key] !== void 0 && parsed[key] !== "") {
         return compactCell(parsed[key]);
@@ -16478,17 +16495,17 @@ function parsePositiveInteger2(value, flagName) {
   }
   return parsed;
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringValue(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function extractionEntries(value) {
-  if (Array.isArray(value)) return value.filter(isRecord9);
-  if (!isRecord9(value)) return [];
+  if (Array.isArray(value)) return value.filter(isRecord10);
+  if (!isRecord10(value)) return [];
   return Object.entries(value).map(
-    ([name, entry]) => isRecord9(entry) ? { name, ...entry } : { name }
+    ([name, entry]) => isRecord10(entry) ? { name, ...entry } : { name }
   );
 }
 var PlayBootstrapError = class extends Error {
@@ -17049,7 +17066,7 @@ function readCsvSampleRows(sample) {
     relax_column_count: true,
     trim: true
   });
-  return Array.isArray(parsedRows) ? parsedRows.filter(isRecord9) : [];
+  return Array.isArray(parsedRows) ? parsedRows.filter(isRecord10) : [];
 }
 function readSourceCsvColumnSpecs(csvPath) {
   const sample = readCsvSample(csvPath);
@@ -17082,16 +17099,16 @@ function packagedCsvPathForPlay(csvPath) {
   return portablePath.startsWith(".") ? portablePath : `./${portablePath}`;
 }
 function getterNamesFromTool(tool, kind) {
-  const usageGuidance = isRecord9(tool?.usageGuidance) ? tool.usageGuidance : {};
-  const resultGuidance = isRecord9(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord9(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
+  const usageGuidance = isRecord10(tool?.usageGuidance) ? tool.usageGuidance : {};
+  const resultGuidance = isRecord10(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord10(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
   const key = kind === "list" ? "extractedLists" : "extractedValues";
   const snakeKey = kind === "list" ? "extracted_lists" : "extracted_values";
   return extractionEntries(resultGuidance[key] ?? resultGuidance[snakeKey]).map((entry) => stringValue(entry.name)).filter(Boolean);
 }
 function targetGettersFromTool(tool) {
-  const record3 = isRecord9(tool) ? tool : {};
+  const record3 = isRecord10(tool) ? tool : {};
   const raw = record3.targetGetters ?? record3.target_getters;
-  if (!isRecord9(raw)) return {};
+  if (!isRecord10(raw)) return {};
   const entries = [];
   for (const [target, value] of Object.entries(raw)) {
     const paths = Array.isArray(value) ? value.map((path) => typeof path === "string" ? path.trim() : "").filter(Boolean) : [];
@@ -17112,10 +17129,10 @@ function listRowCandidateKeysFromTool(tool) {
   return [...keys].sort();
 }
 function inputPropertyNames(schema) {
-  if (!isRecord9(schema)) return [];
-  if (isRecord9(schema.properties)) return Object.keys(schema.properties);
+  if (!isRecord10(schema)) return [];
+  if (isRecord10(schema.properties)) return Object.keys(schema.properties);
   if (Array.isArray(schema.fields)) {
-    return schema.fields.filter(isRecord9).map((field) => stringValue(field.name)).filter(Boolean);
+    return schema.fields.filter(isRecord10).map((field) => stringValue(field.name)).filter(Boolean);
   }
   return [];
 }
@@ -17129,7 +17146,7 @@ function schemaFieldDetails(schema) {
   return { required, optional };
 }
 function jsonSchemaTypeExpression(schema) {
-  if (!isRecord9(schema)) return "unknown";
+  if (!isRecord10(schema)) return "unknown";
   const type = schema.type;
   if (Array.isArray(type)) {
     return type.map((entry) => jsonSchemaTypeExpression({ ...schema, type: entry })).join(" | ");
@@ -17159,7 +17176,7 @@ function jsonSchemaTypeExpression(schema) {
   }
 }
 function objectPropertySchema(schema, property) {
-  return isRecord9(schema) && isRecord9(schema.properties) ? schema.properties[property] : null;
+  return isRecord10(schema) && isRecord10(schema.properties) ? schema.properties[property] : null;
 }
 function playOutputHasField(schema, field) {
   return objectPropertySchema(schema, field) != null;
@@ -17335,14 +17352,14 @@ ${indent2.slice(2)}}`;
 }
 function requiredPlayInputFields(play) {
   const schema = play?.inputSchema;
-  if (!isRecord9(schema)) return [];
+  if (!isRecord10(schema)) return [];
   if (Array.isArray(schema.required)) {
     return schema.required.filter(
       (value) => typeof value === "string"
     );
   }
   if (Array.isArray(schema.fields)) {
-    return schema.fields.filter(isRecord9).filter(
+    return schema.fields.filter(isRecord10).filter(
       (field) => field.required === true && typeof field.name === "string"
     ).map((field) => String(field.name));
   }
@@ -17523,7 +17540,7 @@ function validateBootstrapRoutes(input2) {
   }
 }
 function staticPipelineSubsteps(pipeline) {
-  if (!isRecord9(pipeline)) return [];
+  if (!isRecord10(pipeline)) return [];
   return [
     ...extractionEntries(pipeline.stages),
     ...extractionEntries(pipeline.substeps)
@@ -17531,7 +17548,7 @@ function staticPipelineSubsteps(pipeline) {
 }
 function playUsesMapBackedRuntime(play) {
   const pipeline = play?.staticPipeline;
-  if (!isRecord9(pipeline)) return false;
+  if (!isRecord10(pipeline)) return false;
   if (stringValue(pipeline.tableNamespace)) return true;
   return staticPipelineSubsteps(pipeline).some((substep) => {
     if (stringValue(substep.type) === "map") return true;
@@ -17540,7 +17557,7 @@ function playUsesMapBackedRuntime(play) {
       aliases: [],
       runCommand: "",
       examples: [],
-      staticPipeline: isRecord9(substep.pipeline) ? substep.pipeline : null
+      staticPipeline: isRecord10(substep.pipeline) ? substep.pipeline : null
     });
   });
 }
@@ -28076,7 +28093,7 @@ function extractPlayValidationErrors(value) {
   if (value instanceof DeeplineError) {
     return extractPlayValidationErrors(value.details);
   }
-  if (!isRecord10(value)) {
+  if (!isRecord11(value)) {
     return [];
   }
   const directErrors = stringArrayField(value, "errors");
@@ -28740,7 +28757,7 @@ function formatPlayRuntimeLimit(runtimeLimit) {
   if (seconds % 60 === 0) return `${seconds / 60} min`;
   return `${seconds} sec`;
 }
-function isRecord10(value) {
+function isRecord11(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringValue3(value) {
@@ -28750,14 +28767,14 @@ function asArray(value) {
   return Array.isArray(value) ? value : [];
 }
 function extractionEntries2(value) {
-  if (Array.isArray(value)) return value.filter(isRecord10);
-  if (!isRecord10(value)) return [];
+  if (Array.isArray(value)) return value.filter(isRecord11);
+  if (!isRecord11(value)) return [];
   return Object.entries(value).map(
-    ([name, entry]) => isRecord10(entry) ? { name, ...entry } : { name }
+    ([name, entry]) => isRecord11(entry) ? { name, ...entry } : { name }
   );
 }
 function firstRawPath(entry) {
-  const details = isRecord10(entry.details) ? entry.details : {};
+  const details = isRecord11(entry.details) ? entry.details : {};
   const paths = [
     ...asArray(details.rawToolOutputPaths),
     ...asArray(details.raw_tool_output_paths),
@@ -28775,12 +28792,12 @@ function checkHintRawPath(value) {
 function collectStaticPipelineToolIds(staticPipeline) {
   const seen = /* @__PURE__ */ new Set();
   const visitPipeline = (pipeline) => {
-    if (!isRecord10(pipeline)) return;
+    if (!isRecord11(pipeline)) return;
     for (const step of [
       ...asArray(pipeline.stages),
       ...asArray(pipeline.substeps)
     ]) {
-      if (!isRecord10(step)) continue;
+      if (!isRecord11(step)) continue;
       if (step.type === "tool") {
         const toolId = stringValue3(step.toolId) || stringValue3(step.tool);
         if (toolId) seen.add(toolId);
@@ -28794,9 +28811,9 @@ function collectStaticPipelineToolIds(staticPipeline) {
   return [...seen].sort();
 }
 function toolGetterHintFromMetadata(toolId, tool) {
-  const usageGuidance = isRecord10(tool.usageGuidance) ? tool.usageGuidance : {};
-  const resultGuidance = isRecord10(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord10(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
-  const toolResponse = isRecord10(resultGuidance.toolResponse) ? resultGuidance.toolResponse : isRecord10(resultGuidance.tool_response) ? resultGuidance.tool_response : {};
+  const usageGuidance = isRecord11(tool.usageGuidance) ? tool.usageGuidance : {};
+  const resultGuidance = isRecord11(usageGuidance.toolExecutionResult) ? usageGuidance.toolExecutionResult : isRecord11(usageGuidance.tool_execution_result) ? usageGuidance.tool_execution_result : {};
+  const toolResponse = isRecord11(resultGuidance.toolResponse) ? resultGuidance.toolResponse : isRecord11(resultGuidance.tool_response) ? resultGuidance.tool_response : {};
   const lists = extractionEntries2(
     resultGuidance.extractedLists ?? resultGuidance.extracted_lists
   ).map((entry) => ({
@@ -29159,7 +29176,7 @@ function artifactForProductionCompatibilityCheck(artifact) {
       "DEEPLINE_PROD_CHECK_AUTHORING_CONTRACT_EDITION must be a positive integer."
     );
   }
-  const compatibility = isRecord10(artifact.compatibility) ? artifact.compatibility : {};
+  const compatibility = isRecord11(artifact.compatibility) ? artifact.compatibility : {};
   return {
     ...artifact,
     compatibility: {
@@ -34381,7 +34398,7 @@ function isMarkedTestAiInferenceCommand(command) {
   if (normalizeEnrichPlayRef(command.tool) !== "run_javascript") {
     return false;
   }
-  return isRecord11(command.payload) && command.payload[ENRICH_TEST_AI_INFERENCE_PAYLOAD_MARKER] === true;
+  return isRecord12(command.payload) && command.payload[ENRICH_TEST_AI_INFERENCE_PAYLOAD_MARKER] === true;
 }
 function enrichDebugEnabled(env = process.env) {
   const raw = String(env.DEEPLINE_DEBUG_ENRICH ?? "").trim().toLowerCase();
@@ -34645,7 +34662,7 @@ function rewriteGeneratedPlayRerunForEnrich(status, enrichCommand) {
     if (Array.isArray(value)) {
       return value.map(rewrite);
     }
-    if (!isRecord11(value)) {
+    if (!isRecord12(value)) {
       return value;
     }
     const next = Object.fromEntries(
@@ -34654,7 +34671,7 @@ function rewriteGeneratedPlayRerunForEnrich(status, enrichCommand) {
         key === "rerunCommand" && typeof entry === "string" ? enrichCommand : rewrite(entry)
       ])
     );
-    if (isRecord11(next.next) && typeof next.next.run === "string") {
+    if (isRecord12(next.next) && typeof next.next.run === "string") {
       next.next = { ...next.next, run: enrichCommand };
     }
     return next;
@@ -35136,7 +35153,7 @@ async function resolveWatchedGeneratedPlayStatus(input2) {
   }
   return input2.client.runs.get(runId, { full: true });
 }
-function isRecord11(value) {
+function isRecord12(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 async function captureStdout(run, options = {}) {
@@ -35388,15 +35405,15 @@ function readFirstEnrichDatasetActions(value) {
       return null;
     }
     const record3 = candidate;
-    const actions = isRecord11(record3.actions) ? record3.actions : null;
-    const currentQuery = isRecord11(actions?.queryCurrentTable) ? actions.queryCurrentTable : null;
-    const legacyQuery = isRecord11(actions?.query) ? actions.query : null;
+    const actions = isRecord12(record3.actions) ? record3.actions : null;
+    const currentQuery = isRecord12(actions?.queryCurrentTable) ? actions.queryCurrentTable : null;
+    const legacyQuery = isRecord12(actions?.query) ? actions.query : null;
     const query = currentQuery?.kind === "deepline_db_query" ? currentQuery : legacyQuery?.kind === "deepline_db_query" ? legacyQuery : null;
     if (query?.kind === "deepline_db_query") {
       return {
         dataset: record3,
         query,
-        ...isRecord11(actions?.exportCsv) ? { exportCsv: actions.exportCsv } : {}
+        ...isRecord12(actions?.exportCsv) ? { exportCsv: actions.exportCsv } : {}
       };
     }
     if (options.allowLegacy && record3.kind === "dataset" && typeof record3.queryDatasetCommand === "string" && record3.queryDatasetCommand.trim()) {
@@ -35449,7 +35466,7 @@ function enrichCustomerDbJson(input2) {
   const dataset = actions.dataset;
   const sql = actionStringField(query, "sql") ?? parseSqlFromDbQueryCommand(actions.queryDatasetCommand);
   const datasetPath = actionStringField(query, "datasetPath") ?? actionStringField(dataset, "path") ?? actionStringField(dataset, "tableNamespace");
-  const api = isRecord11(query.api) ? query.api : null;
+  const api = isRecord12(query.api) ? query.api : null;
   const apiPath = actionStringField(api ?? {}, "path") ?? "/api/v2/db/query";
   const apiMethod = actionStringField(api ?? {}, "method") ?? "POST";
   if (!datasetPath) {
@@ -35518,11 +35535,11 @@ function sqlStringLiteral(value) {
   return `'${value.replace(/'/g, "''")}'`;
 }
 function failureAliasFromCellMeta(cellMeta) {
-  if (!isRecord11(cellMeta)) {
+  if (!isRecord12(cellMeta)) {
     return null;
   }
   for (const [alias, meta] of Object.entries(cellMeta)) {
-    if (!isRecord11(meta)) {
+    if (!isRecord12(meta)) {
       continue;
     }
     const failure = failureCellFromMeta(meta, {});
@@ -36016,7 +36033,7 @@ function exportableSheetRow2(row, sourceRowStart = 0) {
   return fallback;
 }
 function failureCellFromMeta(meta, fallback) {
-  if (!isRecord11(meta)) {
+  if (!isRecord12(meta)) {
     return null;
   }
   const status = typeof meta.status === "string" ? meta.status.trim().toLowerCase() : "";
@@ -36036,7 +36053,7 @@ function failureCellFromMeta(meta, fallback) {
   };
 }
 function applyFailureCellMeta(row, cellMeta, fallback) {
-  if (!isRecord11(cellMeta)) {
+  if (!isRecord12(cellMeta)) {
     return;
   }
   for (const [field, meta] of Object.entries(cellMeta)) {
@@ -36264,7 +36281,7 @@ function stableRowSnapshot(value) {
 }
 function cellFailureError(value) {
   const parsed = parseMaybeJsonObject(value);
-  if (!isRecord11(parsed)) {
+  if (!isRecord12(parsed)) {
     const text = typeof parsed === "string" ? parsed.trim() : "";
     if (/^(?:[A-Za-z0-9_:-]+:\s*)?(?:Error|TypeError|ReferenceError|SyntaxError|RangeError):\s+/.test(
       text
@@ -36272,12 +36289,12 @@ function cellFailureError(value) {
       return { message: text };
     }
   }
-  if (!isRecord11(parsed)) {
+  if (!isRecord12(parsed)) {
     return null;
   }
   const status = typeof parsed.status === "string" ? parsed.status.trim().toLowerCase() : "";
   const directError = typeof parsed.error === "string" ? parsed.error.trim() : typeof parsed.last_error === "string" ? parsed.last_error.trim() : "";
-  const result = isRecord11(parsed.result) ? parsed.result : null;
+  const result = isRecord12(parsed.result) ? parsed.result : null;
   const resultError = typeof result?.error === "string" ? result.error.trim() : typeof result?.message === "string" ? result.message.trim() : "";
   if (!directError && !resultError && status !== "error" && status !== "failed") {
     return null;
@@ -36347,7 +36364,7 @@ function assignFlattenedFailurePath(target, field, value) {
   let cursor = target;
   for (const part of normalized.slice(0, -1)) {
     const existing = cursor[part];
-    if (!isRecord11(existing)) {
+    if (!isRecord12(existing)) {
       const next = {};
       cursor[part] = next;
       cursor = next;
@@ -36511,10 +36528,10 @@ function waterfallExecutionSignal(status, spec) {
   let everyChildStatOnlyConditionSkipped = true;
   const childAliasesWithStats = /* @__PURE__ */ new Set();
   for (const childAlias of childAliases) {
-    for (const stat5 of summaries.map((summary) => summary[childAlias]).filter(isRecord11)) {
+    for (const stat5 of summaries.map((summary) => summary[childAlias]).filter(isRecord12)) {
       sawChildStats = true;
       childAliasesWithStats.add(childAlias);
-      const execution = isRecord11(stat5.execution) ? stat5.execution : null;
+      const execution = isRecord12(stat5.execution) ? stat5.execution : null;
       const executedSummary = parseExecutionSummary(
         execution?.["completed:executed"]
       );
@@ -36544,7 +36561,7 @@ function waterfallExecutionSignal(status, spec) {
 }
 function emptyWaterfallStatsEvidence(status, spec) {
   const summaries = collectColumnStats(status);
-  const parentStats = summaries.map((summary) => summary[spec.alias]).filter(isRecord11);
+  const parentStats = summaries.map((summary) => summary[spec.alias]).filter(isRecord12);
   for (const stat5 of parentStats) {
     const nonEmpty = parseExecutionSummary(stat5.non_empty);
     if (nonEmpty?.total && nonEmpty.count === 0) {
@@ -36558,7 +36575,7 @@ function emptyWaterfallStatsEvidence(status, spec) {
   let selectedRows = 0;
   let sawStatsForEveryChild = true;
   for (const childAlias of childAliases) {
-    const stat5 = summaries.map((summary) => summary[childAlias]).find(isRecord11);
+    const stat5 = summaries.map((summary) => summary[childAlias]).find(isRecord12);
     if (!stat5) {
       sawStatsForEveryChild = false;
       break;
@@ -36567,7 +36584,7 @@ function emptyWaterfallStatsEvidence(status, spec) {
     if ((nonEmpty?.count ?? 0) > 0) {
       return null;
     }
-    const execution = isRecord11(stat5.execution) ? stat5.execution : null;
+    const execution = isRecord12(stat5.execution) ? stat5.execution : null;
     const executed = parseExecutionSummary(execution?.["completed:executed"]);
     const reused = parseExecutionSummary(execution?.["completed:reused"]);
     const skipped = parseExecutionSummary(execution?.["skipped:condition"]);
@@ -36609,11 +36626,11 @@ function collectStatusFailureJobs(input2) {
   const jobs = [];
   aliases.forEach((spec, aliasIndex) => {
     const { alias } = spec;
-    const stat5 = summaries.map((summary) => summary[alias]).find(isRecord11);
+    const stat5 = summaries.map((summary) => summary[alias]).find(isRecord12);
     if (!stat5) {
       return;
     }
-    const execution = isRecord11(stat5.execution) ? stat5.execution : null;
+    const execution = isRecord12(stat5.execution) ? stat5.execution : null;
     const failedCount = Math.min(
       selectedRows,
       Math.max(
@@ -36720,10 +36737,10 @@ function collectColumnStats(status) {
       value.forEach(visit);
       return;
     }
-    if (!isRecord11(value)) {
+    if (!isRecord12(value)) {
       return;
     }
-    if (isRecord11(value.columnStats)) {
+    if (isRecord12(value.columnStats)) {
       summaries.push(value.columnStats);
     }
     Object.values(value).forEach(visit);
@@ -36735,12 +36752,12 @@ function firstAliasExecutionCounts(input2) {
   const aliases = collectConfigScalarAliasOrder(input2.config);
   const summaries = collectColumnStats(input2.status);
   for (const alias of aliases) {
-    const stat5 = summaries.map((summary) => summary[alias]).find(isRecord11);
+    const stat5 = summaries.map((summary) => summary[alias]).find(isRecord12);
     if (!stat5) continue;
     if (input2.forceAliases.has(normalizeAlias2(alias))) {
       return { executed: input2.selectedRows, reused: 0 };
     }
-    const execution = isRecord11(stat5.execution) ? stat5.execution : null;
+    const execution = isRecord12(stat5.execution) ? stat5.execution : null;
     if (!execution) continue;
     return {
       executed: parseExecutionCount(execution["completed:executed"]),
@@ -36767,14 +36784,14 @@ function rewriteEnrichJsonStatus(input2) {
     if (Array.isArray(value)) {
       return value.map(rewrite);
     }
-    if (!isRecord11(value)) {
+    if (!isRecord12(value)) {
       return value;
     }
     const next = {};
     for (const [key, entry] of Object.entries(value)) {
       next[key] = rewrite(entry);
     }
-    if (isRecord11(next.progress)) {
+    if (isRecord12(next.progress)) {
       next.progress = {
         ...next.progress,
         ...selectedRows > 0 ? { total: selectedRows } : {},
@@ -36783,8 +36800,8 @@ function rewriteEnrichJsonStatus(input2) {
         ...failedRows > 0 ? { failed: failedRows, pending: 0 } : {}
       };
     }
-    if (isRecord11(next.summary)) {
-      const rowCounts = isRecord11(next.summary.rowCounts) ? next.summary.rowCounts : null;
+    if (isRecord12(next.summary)) {
+      const rowCounts = isRecord12(next.summary.rowCounts) ? next.summary.rowCounts : null;
       if (failedRows > 0) {
         next.summary = {
           ...next.summary,
@@ -36797,11 +36814,11 @@ function rewriteEnrichJsonStatus(input2) {
         };
       }
     }
-    if (isRecord11(next.columnStats) && selectedRows > 0) {
+    if (isRecord12(next.columnStats) && selectedRows > 0) {
       const columnStats = { ...next.columnStats };
       for (const alias of forcedAliases) {
-        const stat5 = isRecord11(columnStats[alias]) ? columnStats[alias] : null;
-        const execution = isRecord11(stat5?.execution) ? stat5.execution : null;
+        const stat5 = isRecord12(columnStats[alias]) ? columnStats[alias] : null;
+        const execution = isRecord12(stat5?.execution) ? stat5.execution : null;
         if (!stat5 || !execution) continue;
         columnStats[alias] = {
           ...stat5,
@@ -36820,14 +36837,14 @@ function rewriteEnrichJsonStatus(input2) {
     return next;
   };
   const rewritten = rewrite(input2.status);
-  if (failedRows === 0 || !isRecord11(rewritten)) {
+  if (failedRows === 0 || !isRecord12(rewritten)) {
     return rewritten;
   }
   const partialStatus = selectedRows > 0 && failedRows < selectedRows ? "partial_success" : "failed";
   return {
     ...rewritten,
     ...rewritten.status === "completed" || rewritten.status === "failed" ? { status: partialStatus } : {},
-    ...isRecord11(rewritten.run) && (rewritten.run.status === "completed" || rewritten.run.status === "failed") ? { run: { ...rewritten.run, status: partialStatus } } : {}
+    ...isRecord12(rewritten.run) && (rewritten.run.status === "completed" || rewritten.run.status === "failed") ? { run: { ...rewritten.run, status: partialStatus } } : {}
   };
 }
 function summarizeFailedJobError(value) {
@@ -37451,7 +37468,7 @@ function materializeCsvCellValue(value) {
   return value;
 }
 function compactArrayEnvelopeCompleteValue(value) {
-  if (!isRecord11(value) || value.kind !== "array") {
+  if (!isRecord12(value) || value.kind !== "array") {
     return null;
   }
   if (!Array.isArray(value.preview)) {
@@ -37465,7 +37482,7 @@ function compactArrayEnvelopeCompleteValue(value) {
 }
 function disambiguateCompactAiInferencePayload(value) {
   const parsed = parseMaybeJsonObject(value);
-  if (!isRecord11(parsed) || !cellFailureError(parsed)) {
+  if (!isRecord12(parsed) || !cellFailureError(parsed)) {
     return value;
   }
   return {
@@ -37474,14 +37491,14 @@ function disambiguateCompactAiInferencePayload(value) {
   };
 }
 function compactAiInferenceCellForCsv(value) {
-  if (!isRecord11(value)) {
+  if (!isRecord12(value)) {
     return value;
   }
   const extractedJson = value.extracted_json;
   if (extractedJson !== null && extractedJson !== void 0) {
     return disambiguateCompactAiInferencePayload(extractedJson);
   }
-  const result = isRecord11(value.result) ? value.result : null;
+  const result = isRecord12(value.result) ? value.result : null;
   const object = result?.object;
   if (object !== null && object !== void 0) {
     return disambiguateCompactAiInferencePayload(object);
@@ -37498,12 +37515,12 @@ function compactAiInferenceCellForCsv(value) {
 }
 function materializeEnrichAliasCellForCsv(row, alias, options) {
   const direct = row[alias];
-  if (isRecord11(direct)) {
+  if (isRecord12(direct)) {
     const completeArray = compactArrayEnvelopeCompleteValue(direct);
     if (completeArray) {
       return materializeCsvCellValue(completeArray);
     }
-    if (options?.compactAiCell && direct.status === "completed" && (isRecord11(direct.result) || Object.prototype.hasOwnProperty.call(direct, "extracted_json") || typeof direct.output === "string")) {
+    if (options?.compactAiCell && direct.status === "completed" && (isRecord12(direct.result) || Object.prototype.hasOwnProperty.call(direct, "extracted_json") || typeof direct.output === "string")) {
       return materializeCsvCellValue(compactAiInferenceCellForCsv(direct));
     }
     if (Object.prototype.hasOwnProperty.call(direct, "matched_result") || Object.prototype.hasOwnProperty.call(direct, "matchedResult") || Object.prototype.hasOwnProperty.call(direct, "result")) {
@@ -37644,11 +37661,11 @@ function normalizeEnrichRowsForCsvExport(rows, config, options) {
 }
 function legacyMetadataFromRow(row) {
   const direct = parseLegacyMetadataCell(row._metadata);
-  if (direct && isRecord11(direct.columns)) {
+  if (direct && isRecord12(direct.columns)) {
     return direct;
   }
   const relocated = parseLegacyMetadataCell(row.metadata);
-  if (relocated && isRecord11(relocated.columns)) {
+  if (relocated && isRecord12(relocated.columns)) {
     return relocated;
   }
   const flattenedColumns = parseLegacyMetadataCell(row["metadata.columns"]);
@@ -37665,7 +37682,7 @@ function legacyMetadataFromRow(row) {
 }
 function parseLegacyMetadataCell(value) {
   const parsed = parseMaybeJsonObject(value);
-  if (isRecord11(parsed)) {
+  if (isRecord12(parsed)) {
     return parsed;
   }
   if (typeof value !== "string") {
@@ -37682,12 +37699,12 @@ function parseLegacyMetadataCell(value) {
   for (const candidate of candidates) {
     try {
       const decoded = JSON.parse(candidate);
-      if (isRecord11(decoded)) {
+      if (isRecord12(decoded)) {
         return decoded;
       }
       if (typeof decoded === "string") {
         const nested = JSON.parse(decoded);
-        if (isRecord11(nested)) {
+        if (isRecord12(nested)) {
           return nested;
         }
       }
@@ -37697,8 +37714,8 @@ function parseLegacyMetadataCell(value) {
   return null;
 }
 function mergeLegacyMetadataRecords(base, enriched) {
-  const baseColumns = isRecord11(base.columns) ? base.columns : null;
-  const enrichedColumns = isRecord11(enriched.columns) ? enriched.columns : null;
+  const baseColumns = isRecord12(base.columns) ? base.columns : null;
+  const enrichedColumns = isRecord12(enriched.columns) ? enriched.columns : null;
   const merged = {
     ...base,
     ...enriched
@@ -49514,6 +49531,18 @@ Examples:
 
 // src/cli/commands/tools.ts
 import { Option as Option4 } from "commander";
+import {
+  chmodSync,
+  existsSync as existsSync20,
+  mkdirSync as mkdirSync17,
+  mkdtempSync,
+  readFileSync as readFileSync23,
+  writeFileSync as writeFileSync21
+} from "fs";
+import { tmpdir as tmpdir6 } from "os";
+import { dirname as dirname21, join as join27, resolve as resolve20 } from "path";
+
+// src/cli/tool-call-recovery.ts
 import { createHash as createHash7, randomUUID as randomUUID9 } from "crypto";
 
 // ../plays/row-identity.ts
@@ -49532,30 +49561,107 @@ function stableStringify(value) {
   return JSON.stringify(stableValue(value));
 }
 
-// src/cli/commands/tools.ts
+// src/cli/tool-call-recovery.ts
 import {
-  chmodSync,
   existsSync as existsSync19,
   linkSync,
-  mkdirSync as mkdirSync16,
-  mkdtempSync,
+  mkdirSync as mkdirSync15,
   readFileSync as readFileSync22,
   unlinkSync as unlinkSync4,
-  writeFileSync as writeFileSync20
+  writeFileSync as writeFileSync19
 } from "fs";
-import { tmpdir as tmpdir6 } from "os";
-import { dirname as dirname20, join as join26, resolve as resolve20 } from "path";
+import { dirname as dirname19, join as join25 } from "path";
+var ToolCallRecovery = class _ToolCallRecovery {
+  constructor(idempotencyKey, path) {
+    this.idempotencyKey = idempotencyKey;
+    this.path = path;
+  }
+  static open(input2) {
+    if (!input2.recover || input2.idempotencyKey) {
+      return new _ToolCallRecovery(input2.idempotencyKey, null);
+    }
+    const path = pendingToolExecutionPath(input2);
+    return new _ToolCallRecovery(loadOrCreatePendingToolExecution(path), path);
+  }
+  async acknowledgeDelivery() {
+    await completePendingToolExecution(this.path, this.idempotencyKey);
+  }
+};
+function pendingToolExecutionPath(input2) {
+  const config = resolveConfig();
+  const fingerprint = createHash7("sha256").update(config.baseUrl).update("\0").update(createHash7("sha256").update(config.apiKey).digest("hex")).update("\0").update(input2.toolId).update("\0").update(stableStringify(input2.params)).update("\0").update(input2.responseIntent).digest("hex");
+  return join25(
+    sdkCliStateDirPath(config.baseUrl),
+    `pending-tool-execution-${fingerprint}.json`
+  );
+}
+function loadOrCreatePendingToolExecution(path) {
+  mkdirSync15(dirname19(path), { recursive: true });
+  if (existsSync19(path)) {
+    return readPendingToolExecution(path);
+  }
+  const idempotencyKey = randomUUID9();
+  const temporaryPath = `${path}.${process.pid}.${randomUUID9()}.tmp`;
+  try {
+    writeFileSync19(temporaryPath, `${JSON.stringify({ idempotencyKey })}
+`, {
+      encoding: "utf8",
+      flag: "wx",
+      mode: 384
+    });
+    linkSync(temporaryPath, path);
+    return idempotencyKey;
+  } catch (error) {
+    if (error.code !== "EEXIST") throw error;
+    return readPendingToolExecution(path);
+  } finally {
+    if (existsSync19(temporaryPath)) unlinkSync4(temporaryPath);
+  }
+}
+function readPendingToolExecution(path) {
+  const saved = JSON.parse(readFileSync22(path, "utf8"));
+  if (typeof saved.idempotencyKey !== "string") {
+    throw new Error(
+      `Cannot resume the saved tool execution at ${path}: invalid recovery key.`
+    );
+  }
+  return saved.idempotencyKey;
+}
+async function completePendingToolExecution(path, idempotencyKey) {
+  if (!path || !idempotencyKey || !existsSync19(path)) return;
+  await new Promise((resolve22, reject) => {
+    const onError = (error) => {
+      process.stdout.off("error", onError);
+      reject(error);
+    };
+    process.stdout.once("error", onError);
+    process.stdout.write("", (error) => {
+      process.stdout.off("error", onError);
+      if (error) {
+        reject(error);
+      } else {
+        resolve22();
+      }
+    });
+  });
+  try {
+    if (readPendingToolExecution(path) !== idempotencyKey) return;
+    unlinkSync4(path);
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+}
 
 // src/tool-output.ts
 import {
   closeSync as closeSync3,
-  mkdirSync as mkdirSync15,
+  mkdirSync as mkdirSync16,
   openSync as openSync3,
-  writeFileSync as writeFileSync19,
+  writeFileSync as writeFileSync20,
   writeSync
 } from "fs";
 import { homedir as homedir13 } from "os";
-import { dirname as dirname19, join as join25 } from "path";
+import { dirname as dirname20, join as join26 } from "path";
 function isPlainObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -49682,19 +49788,19 @@ function projectRowOutput(conversion) {
   };
 }
 function ensureOutputDir() {
-  const outputDir = join25(homedir13(), ".local", "share", "deepline", "data");
-  mkdirSync15(outputDir, { recursive: true });
+  const outputDir = join26(homedir13(), ".local", "share", "deepline", "data");
+  mkdirSync16(outputDir, { recursive: true });
   return outputDir;
 }
 function writeJsonOutputFile(payload, stem) {
   const outputDir = ensureOutputDir();
-  const outputPath = join25(outputDir, `${stem}_${Date.now()}.json`);
-  writeFileSync19(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  const outputPath = join26(outputDir, `${stem}_${Date.now()}.json`);
+  writeFileSync20(outputPath, JSON.stringify(payload, null, 2), "utf-8");
   return outputPath;
 }
 function writeCsvOutputFile(rows, stem, options) {
-  const outputPath = options?.outPath ? options.outPath : join25(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
-  mkdirSync15(dirname19(outputPath), { recursive: true });
+  const outputPath = options?.outPath ? options.outPath : join26(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
+  mkdirSync16(dirname20(outputPath), { recursive: true });
   const columns = columnsForRows(rows);
   const escapeCell = (value) => {
     const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
@@ -50282,12 +50388,12 @@ async function listTools(category, options = {}) {
 }
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return join26(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
+  return join27(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
-    mkdirSync16(dirname20(lastSearchPath()), { recursive: true });
-    writeFileSync20(
+    mkdirSync17(dirname21(lastSearchPath()), { recursive: true });
+    writeFileSync21(
       lastSearchPath(),
       JSON.stringify({ searchRef, at: Date.now() }),
       { mode: 384 }
@@ -50297,7 +50403,7 @@ function rememberSearchRef(searchRef) {
 }
 function recentSearchRef() {
   try {
-    const saved = JSON.parse(readFileSync22(lastSearchPath(), "utf8"));
+    const saved = JSON.parse(readFileSync23(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;
@@ -50332,7 +50438,7 @@ async function searchTools(queryInput, options = {}) {
     tools: result.tools.slice(0, 8).map(compactTool)
   } : result;
   printCommandEnvelope(payload, {
-    json: options.json || shouldEmitJson()
+    json: options.json === true
   });
   return 0;
 }
@@ -50561,11 +50667,13 @@ Notes:
   Use a provider name in the query; --prefix is not a supported option.
   The grep alias is the same ranked retrieval surface with a more literal name
   for agents that are filtering a registry rather than choosing a workflow.
+  Search prints a readable result list by default, piped or not, and that is
+  the recommended form. Pass --json only when a program parses the result.
 
 Examples:
-  deepline tools search email --limit 10 --json
-  deepline tools search email --limit 10 --offset 10 --json
-  deepline tools search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company" --json
+  deepline tools search email --limit 10
+  deepline tools search email --limit 10 --offset 10
+  deepline tools search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company"
   deepline tools search --categories company_search --search_terms "investors,funding"
   deepline tools grep "company enrichment" --categories enrichment --json
   deepline tools search verifier --search-mode v2 --json
@@ -50579,7 +50687,7 @@ Examples:
   ).option("--search-terms <terms>", "Alias for --search_terms").option(
     "--task <sentence>",
     "What you are trying to accomplish: input you have -> result you need"
-  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
+  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output instead of the readable default").action(async (query, options) => {
     process.exitCode = await searchTools(query, {
       json: options.json,
       compact: options.compact,
@@ -50955,7 +51063,7 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
 }
 function extractionContractEntries(entries) {
   return entries.flatMap((entry) => {
-    if (!isRecord12(entry)) return [];
+    if (!isRecord13(entry)) return [];
     const name = stringField2(entry, "name");
     const expression = stringField2(entry, "expression");
     return name && expression ? [{ name, expression }] : [];
@@ -50976,7 +51084,7 @@ function printMonitorTypeFilters(tool) {
   }
   console.log("Deploy filters (set in the monitor payload):");
   for (const name of names) {
-    const field = isRecord12(properties[name]) ? properties[name] : {};
+    const field = isRecord13(properties[name]) ? properties[name] : {};
     const star = required.has(name) ? "*" : "";
     const enumVals = arrayField2(field, "enum").filter(
       (v) => typeof v === "string"
@@ -50990,7 +51098,7 @@ function printMonitorTypeFilterExamples(tool) {
   const documentation = recordField2(tool, "documentation");
   const fields2 = recordField2(documentation, "fields");
   const examples = Object.entries(fields2).flatMap(([name, rawField]) => {
-    const grammar = recordField2(isRecord12(rawField) ? rawField : {}, "grammar");
+    const grammar = recordField2(isRecord13(rawField) ? rawField : {}, "grammar");
     const example = stringField2(grammar, "example");
     const values = [
       ...arrayField2(grammar, "examples").filter(
@@ -51009,14 +51117,14 @@ function printMonitorTypeFilterExamples(tool) {
 }
 function printMonitorTypeStreams(tool) {
   const streams = arrayField2(tool, "streams", "output_streams").filter(
-    isRecord12
+    isRecord13
   );
   if (!streams.length) return;
   console.log("");
   console.log("Filter columns (a play's sqlListeners.where, per stream):");
   for (const stream of streams) {
     const name = stringField2(stream, "stream");
-    const cols = arrayField2(stream, "columns").filter(isRecord12).map((col) => stringField2(col, "name")).filter(Boolean);
+    const cols = arrayField2(stream, "columns").filter(isRecord13).map((col) => stringField2(col, "name")).filter(Boolean);
     console.log(`- ${name}: ${cols.join(", ")}`);
   }
 }
@@ -51034,7 +51142,7 @@ function printMonitorTypePricing(tool) {
   }
   console.log("Pricing (Deepline credits per accepted event):");
   for (const key of keys) {
-    const entry = isRecord12(byType[key]) ? byType[key] : {};
+    const entry = isRecord13(byType[key]) ? byType[key] : {};
     const credits = numberField2(entry, "deepline_credits", "deeplineCredits");
     const display = stringField2(entry, "display");
     const shown = display || (credits !== null ? `${formatDecimal(credits)} credits/event` : "see --json");
@@ -51080,8 +51188,8 @@ function printCompactToolContract(tool, requestedToolId) {
     return;
   }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const cost = isRecord12(contract.cost) ? contract.cost : {};
-  const getters = isRecord12(contract.getters) ? contract.getters : {};
+  const cost = isRecord13(contract.cost) ? contract.cost : {};
+  const getters = isRecord13(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   const inputFields = recursiveToolInputFieldsForDisplay(
@@ -51098,7 +51206,7 @@ function printCompactToolContract(tool, requestedToolId) {
   printToolOutputArrayShape(contract);
   printToolExecutionHints(contract);
   if (contract.deprecated === true) {
-    const deprecation = isRecord12(contract.deprecation) ? contract.deprecation : {};
+    const deprecation = isRecord13(contract.deprecation) ? contract.deprecation : {};
     const message = stringField2(deprecation, "message");
     const replacementToolId = stringField2(
       deprecation,
@@ -51125,7 +51233,7 @@ function printCompactToolContract(tool, requestedToolId) {
     console.log("");
     console.log("Inputs:");
     for (const field of inputFields) {
-      if (!isRecord12(field)) continue;
+      if (!isRecord13(field)) continue;
       const name = stringField2(field, "name");
       if (!name) continue;
       const required = field.required ? "*" : "";
@@ -51145,7 +51253,7 @@ function printCompactToolContract(tool, requestedToolId) {
   }
   console.log("");
   printToolExamplesOnly(tool, requestedToolId, { includeSamples: false });
-  const starterScript = isRecord12(contract.starterScript) ? contract.starterScript : {};
+  const starterScript = isRecord13(contract.starterScript) ? contract.starterScript : {};
   const starterPath = stringField2(starterScript, "path");
   if (starterPath) {
     console.log("");
@@ -51159,14 +51267,14 @@ function printCompactToolContract(tool, requestedToolId) {
     console.log("Getters:");
     if (listGetters.length) console.log("Lists:");
     for (const entry of listGetters) {
-      if (isRecord12(entry))
+      if (isRecord13(entry))
         console.log(
           `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
         );
     }
     if (valueGetters.length) console.log("Values:");
     for (const entry of valueGetters) {
-      if (isRecord12(entry))
+      if (isRecord13(entry))
         console.log(
           `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -51183,7 +51291,7 @@ function printToolPricingOnly(tool, requestedToolId, options = {}) {
     return;
   }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const cost = isRecord12(contract.cost) ? contract.cost : {};
+  const cost = isRecord13(contract.cost) ? contract.cost : {};
   const pricingModel = stringField2(cost, "pricingModel") || "unknown";
   const billing = stringField2(cost, "billingSourceLabel") || stringField2(cost, "billingSource") || stringField2(cost, "billingMode") || "unknown";
   const explicitUnit = stringField2(cost, "unit");
@@ -51260,10 +51368,10 @@ function printToolExamplesOnly(tool, requestedToolId, options = {}) {
     `  input: ${JSON.stringify(sampleInput || {}, null, 2).replace(/\n/g, "\n  ")},`
   );
   console.log("});");
-  const getters = isRecord12(contract.getters) ? contract.getters : {};
+  const getters = isRecord13(contract.getters) ? contract.getters : {};
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
-  const firstGetter = [...valueGetters, ...listGetters].find(isRecord12);
+  const firstGetter = [...valueGetters, ...listGetters].find(isRecord13);
   if (firstGetter) {
     const name = stringField2(firstGetter, "name") || "value";
     const expression = stringField2(firstGetter, "expression");
@@ -51299,7 +51407,7 @@ function printPlayLikeToolUsage(tool, requestedToolId) {
 }
 function printToolGettersOnly(tool, requestedToolId) {
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const getters = isRecord12(contract.getters) ? contract.getters : {};
+  const getters = isRecord13(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   console.log(`Getters: ${contract.toolId}`);
@@ -51312,7 +51420,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   if (listGetters.length) {
     console.log("Lists:");
     for (const entry of listGetters) {
-      if (isRecord12(entry))
+      if (isRecord13(entry))
         console.log(
           `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -51321,7 +51429,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   if (valueGetters.length) {
     console.log("Values:");
     for (const entry of valueGetters) {
-      if (isRecord12(entry))
+      if (isRecord13(entry))
         console.log(
           `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
         );
@@ -51347,7 +51455,7 @@ function sampleValueForField(field) {
 function samplePayloadForInputFields(fields2) {
   return Object.fromEntries(
     fields2.slice(0, 4).flatMap((field) => {
-      if (!isRecord12(field)) return [];
+      if (!isRecord13(field)) return [];
       const name = stringField2(field, "name");
       if (!name) return [];
       return [[name, sampleValueForField(field)]];
@@ -51477,8 +51585,8 @@ function formatListedToolCost(tool) {
 }
 function toolInputFieldsForDisplay(inputSchema) {
   if (Array.isArray(inputSchema.fields)) {
-    const fields2 = inputSchema.fields.filter(isRecord12);
-    if (!isRecord12(inputSchema.jsonSchema)) return fields2;
+    const fields2 = inputSchema.fields.filter(isRecord13);
+    if (!isRecord13(inputSchema.jsonSchema)) return fields2;
     const jsonSchemaFields = new Map(
       recursiveToolInputFieldsForDisplay({
         jsonSchema: inputSchema.jsonSchema
@@ -51490,26 +51598,26 @@ function toolInputFieldsForDisplay(inputSchema) {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
       const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
       const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
-      const items = isRecord12(field.items) ? field.items : jsonSchemaField?.items;
+      const items = isRecord13(field.items) ? field.items : jsonSchemaField?.items;
       return {
         ...field,
-        ...isRecord12(items) ? { items } : {},
+        ...isRecord13(items) ? { items } : {},
         ...typeof minItems === "number" ? { minItems } : {},
         ...typeof maxItems === "number" ? { maxItems } : {}
       };
     });
   }
-  const jsonSchema = isRecord12(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
-  const properties = isRecord12(jsonSchema.properties) ? jsonSchema.properties : {};
+  const jsonSchema = isRecord13(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+  const properties = isRecord13(jsonSchema.properties) ? jsonSchema.properties : {};
   const required = Array.isArray(jsonSchema.required) ? new Set(jsonSchema.required.map(String)) : /* @__PURE__ */ new Set();
   return Object.entries(properties).map(([name, value]) => {
-    const property = isRecord12(value) ? value : {};
+    const property = isRecord13(value) ? value : {};
     return {
       name,
       type: typeof property.type === "string" ? property.type : "unknown",
       required: required.has(name),
       description: property.description,
-      ...isRecord12(property.items) ? { items: property.items } : {},
+      ...isRecord13(property.items) ? { items: property.items } : {},
       ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
       ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
       ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
@@ -51526,7 +51634,7 @@ function toolOutputFieldsForDisplay(outputSchema) {
 }
 function printToolOutputArrayShape(tool) {
   const outputFields = toolOutputFieldsForDisplay(
-    recordField2(isRecord12(tool) ? tool : {}, "outputSchema", "output_schema")
+    recordField2(isRecord13(tool) ? tool : {}, "outputSchema", "output_schema")
   );
   if (outputFields.length === 0) return;
   console.log("  Output array shape (declared schema):");
@@ -51541,10 +51649,10 @@ function printToolOutputArrayShape(tool) {
   }
 }
 function canonicalToolJsonSchema(inputSchema) {
-  return isRecord12(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+  return isRecord13(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
 }
 function declaredToolJsonSchema(inputSchema) {
-  if (isRecord12(inputSchema.jsonSchema)) {
+  if (isRecord13(inputSchema.jsonSchema)) {
     return inputSchema.jsonSchema;
   }
   return Array.isArray(inputSchema.fields) ? null : inputSchema;
@@ -51569,7 +51677,7 @@ function publicToolInputSchemaForDescribe(inputSchema) {
   };
   const stripDescriptions = (value) => {
     if (Array.isArray(value)) return value.map(stripDescriptions);
-    if (!isRecord12(value)) return value;
+    if (!isRecord13(value)) return value;
     return Object.fromEntries(
       Object.entries(value).flatMap(([key, nested]) => {
         if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
@@ -51590,7 +51698,7 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
       for (const item of value) collectSchemaIds(item);
       return;
     }
-    if (!isRecord12(value)) return;
+    if (!isRecord13(value)) return;
     if (typeof value.$id === "string" && value.$id.trim()) {
       schemasById.set(value.$id.trim(), value);
     }
@@ -51603,10 +51711,10 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
     let current = root;
     for (const rawSegment of ref.slice(2).split("/")) {
       const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
-      if (!isRecord12(current)) return schema;
+      if (!isRecord13(current)) return schema;
       current = current[segment];
     }
-    return isRecord12(current) ? current : schema;
+    return isRecord13(current) ? current : schema;
   };
   const addField = (field) => {
     const name = typeof field.name === "string" ? field.name : "";
@@ -51621,7 +51729,7 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
     if (ref && activeRefs.has(ref)) return;
     const schema = resolveRef(unresolvedSchema);
     const nextActiveRefs = ref ? /* @__PURE__ */ new Set([...activeRefs, ref]) : activeRefs;
-    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord12(schema.properties) ? "object" : schema.items ? "array" : "unknown";
+    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord13(schema.properties) ? "object" : schema.items ? "array" : "unknown";
     if (path) {
       addField({
         name: path,
@@ -51629,18 +51737,18 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
         required,
         description: schema.description,
         ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
-        ...isRecord12(schema.items) ? { items: schema.items } : {},
+        ...isRecord13(schema.items) ? { items: schema.items } : {},
         ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
         ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
         ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
       });
     }
-    const properties = isRecord12(schema.properties) ? schema.properties : {};
+    const properties = isRecord13(schema.properties) ? schema.properties : {};
     const requiredNames = new Set(
       Array.isArray(schema.required) ? schema.required.map(String) : []
     );
     for (const [name, value] of Object.entries(properties)) {
-      if (!isRecord12(value)) continue;
+      if (!isRecord13(value)) continue;
       visit(
         value,
         path ? `${path}.${name}` : name,
@@ -51648,13 +51756,13 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
         nextActiveRefs
       );
     }
-    if (isRecord12(schema.items)) {
+    if (isRecord13(schema.items)) {
       visit(schema.items, `${path}[]`, false, nextActiveRefs);
     }
     for (const keyword of ["anyOf", "oneOf", "allOf"]) {
       const branches = Array.isArray(schema[keyword]) ? schema[keyword] : [];
       for (const branch of branches) {
-        if (isRecord12(branch)) {
+        if (isRecord13(branch)) {
           visit(branch, path, required, nextActiveRefs);
         }
       }
@@ -51664,21 +51772,21 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   return fields2.size ? [...fields2.values()] : toolInputFieldsForDisplay(inputSchema);
 }
 function inputFieldJsonForDescribe(field) {
-  const publicItems = isRecord12(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
+  const publicItems = isRecord13(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
   return {
     name: field.name,
     type: field.type ?? "unknown",
     required: Boolean(field.required),
     ...field.description ? { description: field.description } : {},
-    ...isRecord12(publicItems) ? { items: publicItems } : {},
+    ...isRecord13(publicItems) ? { items: publicItems } : {},
     ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
     ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
     ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
   };
 }
 function arrayItemBoundsSuffix(field) {
-  const itemSchema = isRecord12(field.items) ? field.items : null;
-  const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord12(itemSchema.properties) ? "object" : "unknown" : null;
+  const itemSchema = isRecord13(field.items) ? field.items : null;
+  const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord13(itemSchema.properties) ? "object" : "unknown" : null;
   const itemEnum = Array.isArray(itemSchema?.enum) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
   const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
@@ -51692,13 +51800,13 @@ function arrayItemBoundsSuffix(field) {
 }
 function printToolExecutionHints(value) {
   const batchCapabilityRecord = recordField2(
-    isRecord12(value) ? value : {},
+    isRecord13(value) ? value : {},
     "batchCapability",
     "batch_capability"
   );
   const batchCapability = Object.keys(batchCapabilityRecord).length > 0 ? batchCapabilityRecord : null;
   const executionMetadata = recordField2(
-    isRecord12(value) ? value : {},
+    isRecord13(value) ? value : {},
     "executionMetadata",
     "execution_metadata"
   );
@@ -51738,7 +51846,7 @@ function printToolExecutionHints(value) {
     executionMetadata,
     "configuredRateLimits",
     "configured_rate_limits"
-  ).filter(isRecord12);
+  ).filter(isRecord13);
   if (configuredRateLimits.length > 0) {
     console.log("");
     console.log(
@@ -51803,17 +51911,17 @@ function printJsonPreview(label, payload) {
 }
 function samplePayload(samples, key) {
   const entry = samples[key];
-  if (!isRecord12(entry)) return void 0;
+  if (!isRecord13(entry)) return void 0;
   return Object.prototype.hasOwnProperty.call(entry, "payload") ? entry.payload : entry;
 }
 function commandEnvelopeFromRawResponse(rawResponse) {
-  return isRecord12(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
+  return isRecord13(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
 }
 function toolExecuteExitCode(envelope) {
   return envelope.status === "failed" || envelope.ok === false ? 1 : 0;
 }
 function extractToolExecutionWarningMessages(rawResponse) {
-  if (!isRecord12(rawResponse)) return [];
+  if (!isRecord13(rawResponse)) return [];
   const candidates = [
     recordField2(recordField2(rawResponse, "toolResponse"), "meta"),
     recordField2(
@@ -51830,7 +51938,7 @@ function extractToolExecutionWarningMessages(rawResponse) {
     for (const warning of warnings) {
       if (typeof warning === "string" && warning.trim()) {
         messages.push(warning.trim());
-      } else if (isRecord12(warning)) {
+      } else if (isRecord13(warning)) {
         const message = stringField2(warning, "message");
         if (message) messages.push(message);
       }
@@ -51839,7 +51947,7 @@ function extractToolExecutionWarningMessages(rawResponse) {
   return [...new Set(messages)];
 }
 function apifySyncRecoveryNext(rawResponse) {
-  if (!isRecord12(rawResponse) || rawResponse.status !== "running") return null;
+  if (!isRecord13(rawResponse) || rawResponse.status !== "running") return null;
   const toolResponse = recordField2(rawResponse, "toolResponse");
   const raw = recordField2(toolResponse, "raw");
   if (raw.state !== "awaiting_apify") return null;
@@ -51862,7 +51970,7 @@ function apifySyncRecoveryNext(rawResponse) {
 }
 function listExtractorPathsFromUsageGuidance(tool) {
   const toolExecutionResult = tool.usageGuidance?.toolExecutionResult;
-  const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord12(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
+  const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord13(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
   return extractedLists.flatMap((entry) => {
     const paths = entry.details?.candidatePaths ?? entry.details?.rawToolOutputPaths;
     if (!Array.isArray(paths)) return [];
@@ -51878,7 +51986,7 @@ function formatDecimal(value) {
 function formatUsd(value) {
   return `$${formatDecimal(value)}`;
 }
-function isRecord12(value) {
+function isRecord13(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringField2(source, ...keys) {
@@ -51905,7 +52013,7 @@ function arrayField2(source, ...keys) {
 function recordField2(source, ...keys) {
   for (const key of keys) {
     const value = source[key];
-    if (isRecord12(value)) return value;
+    if (isRecord13(value)) return value;
   }
   return {};
 }
@@ -51928,10 +52036,10 @@ function normalizeOutputFormat(raw) {
 function resolveAtFilePath(rawPath) {
   const trimmed = rawPath.trim();
   const resolved = resolve20(trimmed);
-  if (existsSync19(resolved)) return resolved;
+  if (existsSync20(resolved)) return resolved;
   if (process.platform !== "win32" && trimmed.includes("\\")) {
     const normalized = resolve20(trimmed.replace(/\\/g, "/"));
-    if (existsSync19(normalized)) return normalized;
+    if (existsSync20(normalized)) return normalized;
   }
   return resolved;
 }
@@ -51942,7 +52050,7 @@ function readJsonArgument(raw, flagName) {
     throw new Error(`Invalid ${flagName} value: empty @file path.`);
   }
   try {
-    return readFileSync22(resolveAtFilePath(filePath), "utf8").replace(
+    return readFileSync23(resolveAtFilePath(filePath), "utf8").replace(
       /^\uFEFF/,
       ""
     );
@@ -51971,7 +52079,7 @@ function parseJsonObjectArgument(raw, flagName) {
     }
     throw invalidJsonError(flagName, message);
   }
-  if (!isRecord12(parsed)) {
+  if (!isRecord13(parsed)) {
     throw invalidJsonError(flagName, "expected an object.");
   }
   return parsed;
@@ -52078,70 +52186,6 @@ function parseToolExecuteTimeout(raw) {
   }
   return timeoutMs;
 }
-function pendingToolExecutionPath(input2) {
-  const config = resolveConfig();
-  const fingerprint = createHash7("sha256").update(config.baseUrl).update("\0").update(createHash7("sha256").update(config.apiKey).digest("hex")).update("\0").update(input2.toolId).update("\0").update(stableStringify(input2.params)).update("\0").update(input2.responseIntent).digest("hex");
-  return join26(
-    sdkCliStateDirPath(resolveConfig().baseUrl),
-    `pending-tool-execution-${fingerprint}.json`
-  );
-}
-function loadOrCreatePendingToolExecution(path) {
-  mkdirSync16(dirname20(path), { recursive: true });
-  if (existsSync19(path)) {
-    return readPendingToolExecution(path);
-  }
-  const idempotencyKey = randomUUID9();
-  const temporaryPath = `${path}.${process.pid}.${randomUUID9()}.tmp`;
-  try {
-    writeFileSync20(temporaryPath, `${JSON.stringify({ idempotencyKey })}
-`, {
-      encoding: "utf8",
-      flag: "wx",
-      mode: 384
-    });
-    linkSync(temporaryPath, path);
-    return idempotencyKey;
-  } catch (error) {
-    if (error.code !== "EEXIST") throw error;
-    return readPendingToolExecution(path);
-  } finally {
-    if (existsSync19(temporaryPath)) unlinkSync4(temporaryPath);
-  }
-}
-function readPendingToolExecution(path) {
-  const saved = JSON.parse(readFileSync22(path, "utf8"));
-  if (typeof saved.idempotencyKey !== "string") {
-    throw new Error(
-      `Cannot resume the saved tool execution at ${path}: invalid recovery key.`
-    );
-  }
-  return saved.idempotencyKey;
-}
-async function completePendingToolExecution(path, idempotencyKey) {
-  if (!path || !idempotencyKey || !existsSync19(path)) return;
-  await new Promise((resolve22, reject) => {
-    const onError = (error) => {
-      process.stdout.off("error", onError);
-      reject(error);
-    };
-    process.stdout.once("error", onError);
-    process.stdout.write("", (error) => {
-      process.stdout.off("error", onError);
-      if (error) {
-        reject(error);
-      } else {
-        resolve22();
-      }
-    });
-  });
-  try {
-    if (readPendingToolExecution(path) !== idempotencyKey) return;
-    unlinkSync4(path);
-  } catch (error) {
-    if (error.code !== "ENOENT") throw error;
-  }
-}
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
@@ -52165,9 +52209,9 @@ function starterScriptJson(script) {
 function seedToolListScript(input2) {
   const stem = safeFileStem(input2.toolId);
   const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
-  const scriptDir = mkdtempSync(join26(tmpdir6(), "deepline-workflow-seed-"));
+  const scriptDir = mkdtempSync(join27(tmpdir6(), "deepline-workflow-seed-"));
   chmodSync(scriptDir, 448);
-  const scriptPath = join26(scriptDir, fileName);
+  const scriptPath = join27(scriptDir, fileName);
   const projectDir = `deepline/projects/${stem}-workflow`;
   const playName = `${stem}-workflow`;
   const sampleRows = input2.rows.length > 0 ? `${JSON.stringify(input2.rows.slice(0, 2)).replace(/\]$/, "")}, ...]` : "[]";
@@ -52210,7 +52254,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   description: ${JSON.stringify(`Seed ${input2.toolId} rows into a Deepline workflow-ready dataset.`)},
 });
 `;
-  writeFileSync20(scriptPath, script, { encoding: "utf-8", mode: 384 });
+  writeFileSync21(scriptPath, script, { encoding: "utf-8", mode: 384 });
   return {
     path: scriptPath,
     sourceCode: script,
@@ -52237,7 +52281,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     kind: summaryEntries.length > 0 ? "object" : "raw",
     summary: input2.summary
   };
-  const envelopeHasCanonicalOutput = isRecord12(envelope.toolResponse) && Object.prototype.hasOwnProperty.call(envelope.toolResponse, "raw");
+  const envelopeHasCanonicalOutput = isRecord13(envelope.toolResponse) && Object.prototype.hasOwnProperty.call(envelope.toolResponse, "raw");
   const envelopeHasDeclaredOutput = Object.prototype.hasOwnProperty.call(
     envelope,
     "output"
@@ -52264,7 +52308,7 @@ function buildToolExecuteBaseEnvelope(input2) {
   return {
     ...envelope,
     ...input2.idempotencyKey ? { idempotency_key: input2.idempotencyKey } : {},
-    ...isRecord12(input2.rawResponse) && isRecord12(input2.rawResponse.executionRecovery) ? { execution_recovery: input2.rawResponse.executionRecovery } : {},
+    ...isRecord13(input2.rawResponse) && isRecord13(input2.rawResponse.executionRecovery) ? { execution_recovery: input2.rawResponse.executionRecovery } : {},
     ...envelopeHasCanonicalOutput || envelopeHasDeclaredOutput ? { output_preview: outputPreview } : { output: outputPreview },
     ...summaryEntries.length > 0 ? { summary: input2.summary } : {},
     ...warningMessages.length > 0 ? { warnings: warningMessages } : {},
@@ -52323,7 +52367,7 @@ function buildToolExecuteRowArtifactEnvelope(input2) {
   void _render;
   void _next;
   void _local;
-  const billingLookup = isRecord12(input2.baseEnvelope.next) && typeof input2.baseEnvelope.next.billing === "string" ? input2.baseEnvelope.next.billing : null;
+  const billingLookup = isRecord13(input2.baseEnvelope.next) && typeof input2.baseEnvelope.next.billing === "string" ? input2.baseEnvelope.next.billing : null;
   return {
     ...base,
     status: typeof base.status === "string" ? base.status : "completed",
@@ -52452,17 +52496,15 @@ async function executeTool(args) {
     }
     return 2;
   }
-  let idempotencyKey = parsed.idempotencyKey;
-  let pendingRecoveryPath = null;
   const responseIntent = parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw";
-  if (parsed.recover && !idempotencyKey) {
-    pendingRecoveryPath = pendingToolExecutionPath({
-      toolId: parsed.toolId,
-      params: parsed.params,
-      responseIntent
-    });
-    idempotencyKey = loadOrCreatePendingToolExecution(pendingRecoveryPath);
-  }
+  const recovery = ToolCallRecovery.open({
+    toolId: parsed.toolId,
+    params: parsed.params,
+    responseIntent,
+    recover: parsed.recover,
+    idempotencyKey: parsed.idempotencyKey
+  });
+  const { idempotencyKey } = recovery;
   if (idempotencyKey) {
     console.error(`Tool execution recovery key: ${idempotencyKey}`);
   }
@@ -52487,42 +52529,12 @@ async function executeTool(args) {
     summary
   });
   const executeExitCode = toolExecuteExitCode(baseEnvelope);
-  if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && shouldEmitJson())) {
-    printCommandEnvelope(baseEnvelope, { json: true });
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  if (parsed.outputFormat === "json_file") {
-    const jsonPath = writeJsonOutputFile(
-      rawResponse,
-      `payload_${parsed.toolId}`
-    );
-    printCommandEnvelope(
-      {
-        ...baseEnvelope,
-        local: {
-          ...isRecord12(baseEnvelope.local) ? baseEnvelope.local : {},
-          payload_file: jsonPath
-        }
-      },
-      { json: true }
-    );
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  if (!listConversion) {
-    if (parsed.outPath) {
-      const error = new Error(
-        `${parsed.toolId} did not expose row-shaped output to write as CSV. Re-run with --json to inspect the raw tool response.`
-      );
-      if (argsWantJson(args)) {
-        printJsonError(error);
-      } else {
-        console.error(error.message);
-      }
-      return 1;
+  const delivered = (() => {
+    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && shouldEmitJson())) {
+      printCommandEnvelope(baseEnvelope, { json: true });
+      return true;
     }
-    if (parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file") {
+    if (parsed.outputFormat === "json_file") {
       const jsonPath = writeJsonOutputFile(
         rawResponse,
         `payload_${parsed.toolId}`
@@ -52531,68 +52543,94 @@ async function executeTool(args) {
         {
           ...baseEnvelope,
           local: {
+            ...isRecord13(baseEnvelope.local) ? baseEnvelope.local : {},
             payload_file: jsonPath
           }
         },
-        { json: parsed.outputFormat === "csv_file" || shouldEmitJson() }
+        { json: true }
       );
-      await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-      return executeExitCode;
+      return true;
     }
-    printCommandEnvelope(baseEnvelope, { json: false });
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  const rowOutput = projectRowOutput(listConversion);
-  const csv = writeCsvOutputFile(
-    listConversion.rows,
-    `${parsed.toolId}_output`,
-    parsed.outPath ? { outPath: parsed.outPath } : void 0
-  );
-  const seededScript = seedToolListScript({
-    toolId: parsed.toolId,
-    payload: parsed.params,
-    rows: listConversion.rows
-  });
-  const materializedEnvelope = buildToolExecuteRowArtifactEnvelope({
-    baseEnvelope,
-    csv,
-    rowOutput,
-    summary,
-    seededScript
-  });
-  if (parsed.outputFormat === "csv_file") {
-    printCommandEnvelope(materializedEnvelope, { json: true });
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  if (parsed.outPath) {
-    printCommandEnvelope(materializedEnvelope, {
-      json: argsWantJson(args) || shouldEmitJson(),
-      text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
-`
-    });
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  if (parsed.noPreview) {
-    printCommandEnvelope(
-      {
-        ...materializedEnvelope,
-        local: {
-          ...materializedEnvelope.local ?? {},
-          output_path: csv.path
+    if (!listConversion) {
+      if (parsed.outPath) {
+        const error = new Error(
+          `${parsed.toolId} did not expose row-shaped output to write as CSV. Re-run with --json to inspect the raw tool response.`
+        );
+        if (argsWantJson(args)) {
+          printJsonError(error);
+        } else {
+          console.error(error.message);
         }
-      },
-      { json: shouldEmitJson(), text: `${csv.path}
-` }
+        return false;
+      }
+      if (parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file") {
+        const jsonPath = writeJsonOutputFile(
+          rawResponse,
+          `payload_${parsed.toolId}`
+        );
+        printCommandEnvelope(
+          {
+            ...baseEnvelope,
+            local: {
+              payload_file: jsonPath
+            }
+          },
+          { json: parsed.outputFormat === "csv_file" || shouldEmitJson() }
+        );
+        return true;
+      }
+      printCommandEnvelope(baseEnvelope, { json: false });
+      return true;
+    }
+    const rowOutput = projectRowOutput(listConversion);
+    const csv = writeCsvOutputFile(
+      listConversion.rows,
+      `${parsed.toolId}_output`,
+      parsed.outPath ? { outPath: parsed.outPath } : void 0
     );
-    await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-    return executeExitCode;
-  }
-  printCommandEnvelope(materializedEnvelope, { json: false });
-  await completePendingToolExecution(pendingRecoveryPath, idempotencyKey);
-  return executeExitCode;
+    const seededScript = seedToolListScript({
+      toolId: parsed.toolId,
+      payload: parsed.params,
+      rows: listConversion.rows
+    });
+    const materializedEnvelope = buildToolExecuteRowArtifactEnvelope({
+      baseEnvelope,
+      csv,
+      rowOutput,
+      summary,
+      seededScript
+    });
+    if (parsed.outputFormat === "csv_file") {
+      printCommandEnvelope(materializedEnvelope, { json: true });
+      return true;
+    }
+    if (parsed.outPath) {
+      printCommandEnvelope(materializedEnvelope, {
+        json: argsWantJson(args) || shouldEmitJson(),
+        text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
+`
+      });
+      return true;
+    }
+    if (parsed.noPreview) {
+      printCommandEnvelope(
+        {
+          ...materializedEnvelope,
+          local: {
+            ...materializedEnvelope.local ?? {},
+            output_path: csv.path
+          }
+        },
+        { json: shouldEmitJson(), text: `${csv.path}
+` }
+      );
+      return true;
+    }
+    printCommandEnvelope(materializedEnvelope, { json: false });
+    return true;
+  })();
+  if (delivered) await recovery.acknowledgeDelivery();
+  return delivered ? executeExitCode : 1;
 }
 
 // src/cli/commands/providers.ts
@@ -52674,7 +52712,7 @@ Examples:
 
 // src/cli/commands/workflow.ts
 import { mkdir as mkdir6, readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
-import { dirname as dirname21, join as join27, resolve as resolve21 } from "path";
+import { dirname as dirname22, join as join28, resolve as resolve21 } from "path";
 
 // src/cli/workflow-to-play.ts
 import { createHash as createHash8 } from "crypto";
@@ -52925,8 +52963,8 @@ async function transformOne(api, workflowId, outDir, publish) {
       revision.config,
       { workflowName: workflow.name, version: revision.version }
     );
-    const file = join27(resolve21(outDir), `${compiled.playName}.play.ts`);
-    await mkdir6(dirname21(file), { recursive: true });
+    const file = join28(resolve21(outDir), `${compiled.playName}.play.ts`);
+    await mkdir6(dirname22(file), { recursive: true });
     await writeFile5(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
@@ -53472,8 +53510,8 @@ function topLevelCommandKnown(program, commandName) {
   );
 }
 async function runPlayRunnerHealthCheck() {
-  const dir = await mkdtemp4(join28(tmpdir7(), "deepline-health-play-"));
-  const file = join28(dir, "health-check.play.ts");
+  const dir = await mkdtemp4(join29(tmpdir7(), "deepline-health-play-"));
+  const file = join29(dir, "health-check.play.ts");
   try {
     await writeFile6(
       file,