deepline 0.3.231 → 0.3.233

package/dist/index.js

@@ -814,6 +814,409 @@ function resolveConfig(options) {
   };
 }
 
+// ../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(input) {
+  return new ToolExecutionError(input.message, {
+    toolId: input.toolId,
+    provider: null,
+    operation: input.toolId,
+    code: input.code,
+    origin: "deepline",
+    category: input.code === "EXECUTION_OUTCOME_UNKNOWN" ? "unknown" : "conflict",
+    retryable: input.code !== "EXECUTION_OUTCOME_UNKNOWN",
+    statusCode: null,
+    requestId: null,
+    retryAfterMs: null,
+    networkKind: null,
+    networkScope: null,
+    publicDetails: { idempotencyKey: input.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, input) {
+  const normalized = toolId.trim().toLowerCase();
+  if (normalized === "apify_run_actor_sync") {
+    const requestedTimeoutMs = input.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,
+    input
+  );
+  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, input, options) {
+    const inputSnapshot = JSON.parse(JSON.stringify(input));
+    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(
+        (resolve2) => setTimeout(resolve2, 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;
 
@@ -864,7 +1267,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.231",
+  version: "0.3.233",
   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
@@ -1511,7 +1914,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 {
@@ -1663,7 +2066,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) {
@@ -2709,11 +3112,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)) {
@@ -2778,7 +3181,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 fields = {};
     for (const [key, field] of Object.entries(value.fields).slice(
       0,
@@ -2798,10 +3201,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 output = {};
     for (const [path, preview] of Object.entries(raw).slice(
       0,
@@ -2838,11 +3241,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([
@@ -3142,7 +3545,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) {
@@ -3157,7 +3560,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;
   }
@@ -3181,7 +3584,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",
@@ -3271,8 +3674,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);
@@ -3321,21 +3724,21 @@ function createEmptyPlayRunLedgerSnapshot(input) {
   };
 }
 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),
@@ -3351,10 +3754,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] = {
@@ -3377,7 +3780,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) {
@@ -3567,18 +3970,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(
@@ -4238,80 +4641,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"
@@ -4385,27 +4714,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) {
@@ -4428,85 +4736,30 @@ function parseNotificationGroupTarget(value) {
   }
   const member = /^member:([UW][A-Z0-9]{8,})$/i.exec(slack);
   if (member?.[1]) {
-    return { kind: "slack", memberId: member[1].toUpperCase() };
-  }
-  if (slack.toLowerCase().startsWith("member:")) {
-    throw new Error(
-      "Slack member IDs must look like slack:member:U0123456789."
-    );
-  }
-  if (!slack.replace(/^#/, "").trim()) {
-    throw new Error("Use --to slack:#channel.");
-  }
-  return { kind: "slack", channel: slack };
-}
-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(input) {
-  return new ToolExecutionError(input.message, {
-    toolId: input.toolId,
-    provider: null,
-    operation: input.toolId,
-    code: input.code,
-    origin: "deepline",
-    category: input.code === "EXECUTION_OUTCOME_UNKNOWN" ? "unknown" : "conflict",
-    retryable: input.code !== "EXECUTION_OUTCOME_UNKNOWN",
-    statusCode: null,
-    requestId: null,
-    retryAfterMs: null,
-    networkKind: null,
-    networkScope: null,
-    publicDetails: { idempotencyKey: input.idempotencyKey }
-  });
+    return { kind: "slack", memberId: member[1].toUpperCase() };
+  }
+  if (slack.toLowerCase().startsWith("member:")) {
+    throw new Error(
+      "Slack member IDs must look like slack:member:U0123456789."
+    );
+  }
+  if (!slack.replace(/^#/, "").trim()) {
+    throw new Error("Use --to slack:#channel.");
+  }
+  return { kind: "slack", channel: slack };
+}
+function notificationObjectKey(kind) {
+  return `${kind}.${globalThis.crypto.randomUUID()}`;
 }
+var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+var MONITOR_NON_RETRYABLE_MUTATION_OPTIONS = {
+  maxRetries: 0,
+  exactUrlOnly: true
+};
 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;
@@ -4697,28 +4950,6 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-var APIFY_SYNC_DEFAULT_TIMEOUT_MS = 3e5;
-var APIFY_SYNC_RESPONSE_GRACE_MS = 9e4;
-function resolveToolExecuteTimeoutMs(toolId, input) {
-  const normalized = toolId.trim().toLowerCase();
-  if (normalized === "apify_run_actor_sync") {
-    const requestedTimeoutMs = input.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,
-    input
-  );
-  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;
 var MONITOR_JOB_STATES = [
@@ -4753,53 +4984,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";
 }
@@ -4829,10 +5016,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
@@ -4971,7 +5158,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);
@@ -5020,6 +5207,7 @@ function playRunResultFromStatus(status, startedAt, fallbackRunId) {
 }
 var DeeplineClient = class _DeeplineClient {
   http;
+  toolCalls;
   config;
   /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
   runs;
@@ -5043,6 +5231,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),
@@ -5170,9 +5359,9 @@ var DeeplineClient = class _DeeplineClient {
     return fields.length > 0 ? { fields } : 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;
@@ -5227,7 +5416,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,
@@ -5447,183 +5636,11 @@ var DeeplineClient = class _DeeplineClient {
    * Deepline execution envelope.
    */
   async executeTool(toolId, input, options) {
-    const inputSnapshot = JSON.parse(JSON.stringify(input));
-    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(
-        (resolve2) => setTimeout(resolve2, 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, input, 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() {
@@ -6431,10 +6448,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") {
@@ -9273,7 +9290,7 @@ var TARGET_FALLBACK_KEYS = {
   status: { match: [/^email_status$/i, /^status$/i] },
   email_status: { match: [/^email_status$/i, /^status$/i] }
 };
-function isRecord8(value) {
+function isRecord9(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function toV2RawToolOutputPath(path) {
@@ -9333,7 +9350,7 @@ function valuesAtSegments(current, segments, path = []) {
     if (!Array.isArray(current)) return [];
     return valuesAtSegments(current[segment], rest, [...path, segment]);
   }
-  if (!isRecord8(current)) return [];
+  if (!isRecord9(current)) return [];
   const directMatches = valuesAtSegments(current[segment], rest, [
     ...path,
     segment
@@ -9363,7 +9380,7 @@ function getValuesAtPath(root, path) {
   return valuesAtSegments(root, parsePath(path)).map((entry) => entry.value);
 }
 function toResultEnvelope(value) {
-  if (isRecord8(value) && "data" in value) {
+  if (isRecord9(value) && "data" in value) {
     const envelope = { data: value.data };
     if ("meta" in value) envelope.meta = value.meta;
     return envelope;
@@ -9416,7 +9433,7 @@ function getAtPath(root, path) {
       current = current[segment];
       continue;
     }
-    if (!isRecord8(current)) return void 0;
+    if (!isRecord9(current)) return void 0;
     current = current[segment];
   }
   return current;
@@ -9433,7 +9450,7 @@ function normalizeString(value) {
 }
 function normalizeRows(value) {
   if (!Array.isArray(value)) return null;
-  return value.map((entry) => isRecord8(entry) ? entry : { value: entry });
+  return value.map((entry) => isRecord9(entry) ? entry : { value: entry });
 }
 function findFirstTargetByPath(result, paths) {
   for (const path of paths ?? []) {
@@ -9503,7 +9520,7 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
     }
     return null;
   }
-  if (!isRecord8(result)) return null;
+  if (!isRecord9(result)) return null;
   const rule = TARGET_FALLBACK_KEYS[target] ?? {
     match: [new RegExp(`^${target}$`, "i")]
   };
@@ -9564,7 +9581,7 @@ function normalizeJobChangeStatus(value) {
 function firstExperienceDate(value) {
   if (!Array.isArray(value)) return null;
   for (const entry of value) {
-    if (!isRecord8(entry)) continue;
+    if (!isRecord9(entry)) continue;
     const date = normalizeString(
       entry.start_date ?? entry.started_at ?? entry.startDate
     );
@@ -9573,10 +9590,10 @@ function firstExperienceDate(value) {
   return null;
 }
 function normalizeJobChange(value) {
-  const record3 = isRecord8(value) ? value : {};
-  const nested = isRecord8(record3.job_change) ? record3.job_change : record3;
-  const output = isRecord8(nested.output) ? nested.output : nested;
-  const person = isRecord8(output.person) ? output.person : {};
+  const record3 = isRecord9(value) ? value : {};
+  const nested = isRecord9(record3.job_change) ? record3.job_change : record3;
+  const output = isRecord9(nested.output) ? nested.output : nested;
+  const person = isRecord9(output.person) ? output.person : {};
   const status = normalizeJobChangeStatus(
     output.status ?? output.job_change_status ?? output.job_changed ?? output.changed
   );
@@ -9987,7 +10004,7 @@ function attachToolResultListDataset(result, input) {
     root = replaceAtPath(root, candidate, serialized.preview);
     break;
   }
-  if (isRecord8(root) && isRecord8(root.toolResponse) && Object.prototype.hasOwnProperty.call(root.toolResponse, "raw")) {
+  if (isRecord9(root) && isRecord9(root.toolResponse) && Object.prototype.hasOwnProperty.call(root.toolResponse, "raw")) {
     result.toolResponse.raw = root.toolResponse.raw;
     result.toolOutput.raw = root.toolResponse.raw;
   }
@@ -10005,7 +10022,7 @@ function replaceAtPath(root, path, replacement) {
       copy[segment] = replace(copy[segment], index + 1);
       return copy;
     }
-    if (!isRecord8(current)) return current;
+    if (!isRecord9(current)) return current;
     return {
       ...current,
       [segment]: replace(current[segment], index + 1)
@@ -11975,11 +11992,11 @@ var Deepline = class {
     return new DeeplineContext(options);
   }
 };
-function isRecord9(value) {
+function isRecord10(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function stringArrayRecord(value) {
-  if (!isRecord9(value)) return {};
+  if (!isRecord10(value)) return {};
   return Object.fromEntries(
     Object.entries(value).map(([key, paths]) => [
       key,
@@ -11991,7 +12008,7 @@ function stringArray(value) {
   return Array.isArray(value) ? value.map(String) : [];
 }
 function emailStatusExtractorConfig(value) {
-  if (!isRecord9(value)) return void 0;
+  if (!isRecord10(value)) return void 0;
   const readPaths = (key) => {
     const paths = stringArray(value[key]).map((path) => path.trim()).filter(Boolean);
     return paths.length > 0 ? paths : void 0;
@@ -12018,7 +12035,7 @@ function emailStatusExtractorConfig(value) {
     const paths = readPaths(key);
     if (paths) config[key] = paths;
   }
-  if (isRecord9(value.statusMap)) {
+  if (isRecord10(value.statusMap)) {
     config.statusMap = value.statusMap;
   }
   if (Array.isArray(value.rules)) {
@@ -12027,10 +12044,10 @@ function emailStatusExtractorConfig(value) {
   return config;
 }
 function extractorDescriptorRecord(value) {
-  if (!isRecord9(value)) return {};
+  if (!isRecord10(value)) return {};
   return Object.fromEntries(
     Object.entries(value).flatMap(([key, descriptor]) => {
-      if (!isRecord9(descriptor)) return [];
+      if (!isRecord10(descriptor)) return [];
       const paths = stringArray(descriptor.paths).map((path) => path.trim()).filter(Boolean);
       if (paths.length === 0) return [];
       const transforms = stringArray(descriptor.transforms).map((transform) => transform.trim()).filter(Boolean);
@@ -12052,7 +12069,7 @@ function extractorDescriptorRecord(value) {
 }
 function rowsFromUnknown(value) {
   if (!Array.isArray(value)) return [];
-  return value.map((row) => isRecord9(row) ? row : { value: row });
+  return value.map((row) => isRecord10(row) ? row : { value: row });
 }
 function finiteNonNegativeInteger3(value) {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
@@ -12074,8 +12091,8 @@ function stableHash(value) {
 }
 function attachSdkQueryResultDatasetResult(toolId, result, options) {
   if (!options || !isQueryResultDatasetTool(toolId)) return result;
-  const raw = isRecord9(result.toolResponse.raw) ? result.toolResponse.raw : null;
-  const dataset = isRecord9(raw?.dataset) ? raw.dataset : null;
+  const raw = isRecord10(result.toolResponse.raw) ? result.toolResponse.raw : null;
+  const dataset = isRecord10(raw?.dataset) ? raw.dataset : null;
   const totalRows = finiteNonNegativeInteger3(dataset?.total_rows);
   const sql = typeof options.input.sql === "string" ? options.input.sql : typeof options.input.query === "string" ? options.input.query : typeof raw?.sql === "string" ? raw.sql : null;
   if (!dataset || totalRows === null || !sql) {
@@ -12107,7 +12124,7 @@ function attachSdkQueryResultDatasetResult(toolId, result, options) {
         } : {}
       }
     });
-    const pageRaw = isRecord9(response.toolResponse?.raw) ? response.toolResponse.raw : null;
+    const pageRaw = isRecord10(response.toolResponse?.raw) ? response.toolResponse.raw : null;
     return rowsFromUnknown(pageRaw?.rows);
   };
   const collectRows = async (limit) => {
@@ -12164,8 +12181,8 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   const rawV2 = response.toolResponse?.rawV2;
   const view = response.toolResponse?.view;
   const meta = response.toolResponse?.meta;
-  const metadata = isRecord9(response._metadata) ? response._metadata.tool : null;
-  const toolMetadata = isRecord9(metadata) ? metadata : {};
+  const metadata = isRecord10(response._metadata) ? response._metadata.tool : null;
+  const toolMetadata = isRecord10(metadata) ? metadata : {};
   const result = attachSdkQueryResultDatasetResult(
     fallbackToolId,
     createToolExecuteResult({
@@ -12173,12 +12190,12 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
       jobId: typeof response.job_id === "string" ? response.job_id : void 0,
       result: {
         data: raw,
-        ...isRecord9(meta) ? { meta } : {}
+        ...isRecord10(meta) ? { meta } : {}
       },
       response: {
         ...rawV2 !== void 0 ? { rawV2 } : {},
         ...view === "data" || view === "rawV2" ? { view } : {},
-        ...isRecord9(meta) ? { meta } : {}
+        ...isRecord10(meta) ? { meta } : {}
       },
       metadata: {
         toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
@@ -12194,12 +12211,12 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
         cached: false,
         source: "live"
       },
-      meta: isRecord9(response.meta) ? response.meta : void 0,
+      meta: isRecord10(response.meta) ? response.meta : void 0,
       billing: response.billing
     }),
     options
   );
-  const executionRecovery = isRecord9(response.executionRecovery) ? response.executionRecovery : void 0;
+  const executionRecovery = isRecord10(response.executionRecovery) ? response.executionRecovery : void 0;
   if (typeof response.idempotencyKey === "string") {
     result.idempotencyKey = response.idempotencyKey;
   }