deepline 0.1.227 → 0.1.228

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

@@ -522,6 +522,14 @@ function resolveRuntimeApiHeaders(
     'content-type': 'application/json',
     authorization: `Bearer ${token}`,
     [PLAY_RUNTIME_CONTRACT_HEADER]: String(PLAY_RUNTIME_CONTRACT),
+    // A run has many callback HTTP attempts. Preserve the logical run
+    // correlation in headers while Vercel keeps its own per-attempt request id.
+    ...(context.runId?.trim()
+      ? {
+          'x-deepline-run-id': context.runId.trim(),
+          'x-deepline-correlation-id': `run:${context.runId.trim()}`,
+        }
+      : {}),
     ...vercelHeaders,
     ...(context.runtimeTestFaultHeader?.trim()
       ? {
@@ -677,7 +685,7 @@ function runtimeApiMaxAttempts(
 }
 
 export function isTransientRuntimeApiErrorMessage(message: string): boolean {
-  return /timeout exceeded when trying to connect|timed out|fetch failed|ECONNRESET|ECONNREFUSED|UND_ERR_CONNECT_TIMEOUT|requested endpoint could not be found, or you don't have access|RUNTIME_SCHEDULER_SATURATED|Runtime scheduler DB pool is saturated|Runtime scheduler DB circuit breaker is open/i.test(
+  return /timeout exceeded when trying to connect|timed out|fetch failed|ECONNRESET|ECONNREFUSED|UND_ERR_CONNECT_TIMEOUT|requested endpoint could not be found, or you don't have access|RUNTIME_SCHEDULER_(?:SATURATED|UNAVAILABLE)|Runtime scheduler DB pool is saturated|Runtime scheduler DB circuit breaker is open/i.test(
     message,
   );
 }
@@ -1779,11 +1787,22 @@ function isMissingRelationError(error: unknown): boolean {
 }
 
 function isPostgresPermissionDeniedError(error: unknown): boolean {
-  return (
-    error !== null &&
-    typeof error === 'object' &&
-    'code' in error &&
-    String(error.code) === '42501'
+  if (error === null || typeof error !== 'object') {
+    return false;
+  }
+  if ('code' in error && String(error.code) === '42501') {
+    return true;
+  }
+  const message =
+    'message' in error && typeof error.message === 'string'
+      ? error.message
+      : '';
+  // Postgres errors raised by a direct session retain SQLSTATE 42501. The
+  // same failure crossing the runtime API boundary is intentionally rendered
+  // as a safe Error message, so preserve the exact permission-denied shape as
+  // the repair signal without treating arbitrary 500s as storage drift.
+  return /permission denied for (?:database|schema|relation|table|sequence)/i.test(
+    message,
   );
 }
 
@@ -2951,12 +2970,28 @@ export async function ensureRuntimeSheet(
     sheetContract: PlaySheetContract;
   },
 ): Promise<void> {
-  await postRuntimeApi<{ ok: true }>(context, {
-    action: 'ensure_sheet',
+  const request = {
+    action: 'ensure_sheet' as const,
     ...input,
     runId: context.runId ?? null,
     userEmail: normalizeRuntimeUserEmail(context.userEmail),
-  });
+  };
+  try {
+    await postRuntimeApi<{ ok: true }>(context, request);
+  } catch (error) {
+    if (!isPostgresPermissionDeniedError(error)) {
+      throw error;
+    }
+    // Fresh tenant databases can become visible through the pooled endpoint
+    // before their runtime-role grants are usable. Non-preloaded file runs hit
+    // ensure_sheet before any direct Postgres operation, so the existing
+    // operation-level self-heal cannot observe this boundary. Repair the
+    // canonical storage contract once, then retry the exact ensure request.
+    await repairRuntimeStorageGrants(context, {
+      playName: input.playName,
+    });
+    await postRuntimeApi<{ ok: true }>(context, request);
+  }
 }
 
 async function prepareRuntimeSheetDatasetRows(

package/dist/bundling-sources/shared_libs/play-runtime/transport-error-diagnostics.ts

@@ -0,0 +1,63 @@
+import { redactLedgerString } from './ledger-safe-payload';
+
+type ErrorLike = Record<string, unknown>;
+
+export type TransportErrorDiagnostic = {
+  name: string | null;
+  message: string | null;
+  code: string | null;
+  errno: string | null;
+  syscall: string | null;
+  cause: TransportErrorDiagnostic | null;
+};
+
+function asErrorLike(value: unknown): ErrorLike | null {
+  return value !== null && typeof value === 'object'
+    ? (value as ErrorLike)
+    : null;
+}
+
+function safeString(value: unknown): string | null {
+  if (typeof value !== 'string' && typeof value !== 'number') return null;
+  return redactLedgerString(String(value))?.slice(0, 500) ?? null;
+}
+
+export function transportGatewayOriginForDiagnostic(url: string): string {
+  try {
+    return new URL(url).origin;
+  } catch {
+    return '<invalid-gateway-origin>';
+  }
+}
+
+/**
+ * Make a small, secret-redacted transport diagnostic that can safely cross the
+ * runner -> gateway -> durable run-log boundary. Keep stacks in process logs:
+ * serializing them into run state leaks implementation details and is rarely
+ * useful without the original error's code/errno/cause chain.
+ */
+export function describeTransportError(
+  error: unknown,
+  depth = 0,
+): TransportErrorDiagnostic {
+  const value = asErrorLike(error);
+  const errorValue = error instanceof Error ? error : null;
+  const name =
+    safeString(errorValue?.name ?? value?.name) ?? (value ? 'Error' : null);
+  const message = safeString(errorValue?.message ?? value?.message ?? error);
+  const cause = value?.cause;
+
+  return {
+    name,
+    message,
+    code: safeString(value?.code),
+    errno: safeString(value?.errno),
+    syscall: safeString(value?.syscall),
+    // A short cause chain is enough for fetch/undici errors and prevents a
+    // pathological custom error graph from making durable traces unbounded.
+    cause:
+      cause !== undefined && depth < 2
+        ? describeTransportError(cause, depth + 1)
+        : null,
+  };
+}

package/dist/cli/index.js

@@ -625,10 +625,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.227",
+  version: "0.1.228",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.227",
+    latest: "0.1.228",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -1691,8 +1691,9 @@ function normalizePlayRunLifecycleStatus(value) {
       return "running";
     case "running":
     case "started":
-    case "waiting":
       return "running";
+    case "waiting":
+      return "waiting";
     case "completed":
     case "complete":
     case "succeeded":
@@ -2466,8 +2467,16 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-function resolveToolExecuteTimeoutMs(toolId) {
+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;
+    }
+  }
   return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
@@ -2967,7 +2976,7 @@ var DeeplineClient = class {
       headers,
       {
         forbiddenAsApiError: true,
-        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId),
+        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, input2),
         maxRetries: options?.maxRetries ?? 0,
         exactUrlOnly: true
       }
@@ -10436,7 +10445,7 @@ Examples:
   deepline plays bootstrap company-list --from provider:crustdata_companydb_search --limit 5 --out companies.play.ts
 
   deepline plays bootstrap monitor-triggered --out on-new-row.play.ts
-  deepline plays bootstrap monitor-triggered --tool tamradar.company_radar --stream company_job_openings --out on-new-job.play.ts
+  deepline plays bootstrap monitor-triggered --tool deepline_native.company_radar --stream company_job_openings --out on-new-job.play.ts
 `
   ).option("--name <name>", "Generated play name").option(
     "--from <ref>",
@@ -12055,6 +12064,15 @@ function getStatusFromLiveEvent(event) {
   const payload = getEventPayload(event);
   return playStatusValue(payload.status) ?? playStatusValue(getRunRecordFromPackage(payload)?.status);
 }
+function writePlayWaitingHint(input2) {
+  if (getStatusFromLiveEvent(input2.event) !== "waiting") return;
+  const runId = getRunIdFromLiveEvent(input2.event);
+  if (!runId || input2.state.waitingRunId === runId) return;
+  input2.state.waitingRunId = runId;
+  input2.progress.writeLine(
+    `[play waiting] ${runId} is waiting for an external approval or event. The command will continue watching; inspect it with 'deepline runs get ${runId} --full --json'.`
+  );
+}
 function getFinalStatusFromLiveEvent(event) {
   if (event.type !== "play.run.snapshot" && event.type !== "play.run.status" && event.type !== "play.run.final_status") {
     return null;
@@ -12403,6 +12421,11 @@ async function waitForPlayCompletionByStream(input2) {
       lastPhase = phase;
       input2.progress.phase(phase);
     }
+    writePlayWaitingHint({
+      event,
+      state: input2.state,
+      progress: input2.progress
+    });
     emitLiveDebugTableHints({
       event,
       playName: input2.playName,
@@ -12735,6 +12758,11 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
         lastPhase = phase;
         input2.progress.phase(phase);
       }
+      writePlayWaitingHint({
+        event,
+        state,
+        progress: input2.progress
+      });
       printPlayLogLines({
         lines: getLogLinesFromLiveEvent(event),
         status: null,
@@ -26128,9 +26156,14 @@ async function listTools(args) {
   return 0;
 }
 async function searchTools(queryInput, options = {}) {
-  const query = queryInput.trim();
-  if (!query) {
-    console.error("Usage: deepline tools search <query> [--json]");
+  const query = queryInput?.trim() ?? "";
+  const hasStructuredSearch = Boolean(
+    options.categories?.trim() || options.searchTerms?.trim()
+  );
+  if (!query && !hasStructuredSearch) {
+    console.error(
+      "Usage: deepline tools search [query] --categories <categories> [--search_terms <terms>] [--json]"
+    );
     return 1;
   }
   const client2 = new DeeplineClient();
@@ -26366,7 +26399,7 @@ Examples:
       includeSearchDebug: Boolean(options.includeSearchDebug)
     });
   });
-  addToolSearchCommand(tools.command("search <query>"));
+  addToolSearchCommand(tools.command("search [query]"));
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -27026,6 +27059,28 @@ function samplePayload(samples, key) {
 function commandEnvelopeFromRawResponse(rawResponse) {
   return isRecord8(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
 }
+function apifySyncRecoveryNext(rawResponse) {
+  if (!isRecord8(rawResponse) || rawResponse.status !== "running") return null;
+  const toolResponse = recordField2(rawResponse, "toolResponse");
+  const raw = recordField2(toolResponse, "raw");
+  if (raw.state !== "awaiting_apify") return null;
+  const next = recordField2(raw, "next");
+  const getActorRun = recordField2(next, "getActorRun");
+  const getActorRunTool = stringField2(getActorRun, "tool");
+  const getActorRunPayload = recordField2(getActorRun, "payload");
+  if (!getActorRunTool || Object.keys(getActorRunPayload).length === 0) {
+    return null;
+  }
+  const getDatasetItems = recordField2(next, "getDatasetItems");
+  const getDatasetItemsTool = stringField2(getDatasetItems, "tool");
+  const getDatasetItemsPayload = recordField2(getDatasetItems, "payload");
+  return {
+    getActorRun: `deepline tools execute ${getActorRunTool} --input ${shellQuote4(JSON.stringify(getActorRunPayload))} --json`,
+    ...getDatasetItemsTool && Object.keys(getDatasetItemsPayload).length > 0 ? {
+      getDatasetItems: `deepline tools execute ${getDatasetItemsTool} --input ${shellQuote4(JSON.stringify(getDatasetItemsPayload))} --json`
+    } : {}
+  };
+}
 function listExtractorPathsFromUsageGuidance(tool) {
   const toolExecutionResult = tool.usageGuidance?.toolExecutionResult;
   const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord8(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
@@ -27271,6 +27326,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
 }
 function buildToolExecuteBaseEnvelope(input2) {
   const envelope = commandEnvelopeFromRawResponse(input2.rawResponse);
+  const apifyRecovery = apifySyncRecoveryNext(input2.rawResponse);
   const summaryEntries = Object.entries(input2.summary);
   const outputPreview = input2.listConversion ? {
     kind: "list",
@@ -27294,6 +27350,14 @@ function buildToolExecuteBaseEnvelope(input2) {
       label: "next",
       command: "move starter script into a project folder and expand it into a Deepline play"
     }
+  ] : apifyRecovery ? [
+    { label: "check Apify run", command: apifyRecovery.getActorRun },
+    ...apifyRecovery.getDatasetItems ? [
+      {
+        label: "get Apify dataset items",
+        command: apifyRecovery.getDatasetItems
+      }
+    ] : []
   ] : [];
   return {
     ...envelope,
@@ -27301,6 +27365,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     ...summaryEntries.length > 0 ? { summary: input2.summary } : {},
     next: {
       inspect: inspectCommand,
+      ...apifyRecovery ?? {},
       playDebugging: "When fixing a play getter, inspect returned dataset handles with runs get and export rows with runs export; do not copy CLI preview paths blindly.",
       ...input2.listConversion ? {
         expandToPlay: "Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again.",
@@ -27321,7 +27386,9 @@ function buildToolExecuteBaseEnvelope(input2) {
       ] : [
         {
           title: "result",
-          lines: summaryEntries.length > 0 ? summaryEntries.map(
+          lines: apifyRecovery ? [
+            "Apify is still running. Run the follow-up command(s) below."
+          ] : summaryEntries.length > 0 ? summaryEntries.map(
             ([key, value]) => `${key}=${String(value)}`
           ) : [JSON.stringify(input2.rawResponse, null, 2)]
         }

package/dist/cli/index.mjs

@@ -610,10 +610,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.227",
+  version: "0.1.228",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.227",
+    latest: "0.1.228",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -1676,8 +1676,9 @@ function normalizePlayRunLifecycleStatus(value) {
       return "running";
     case "running":
     case "started":
-    case "waiting":
       return "running";
+    case "waiting":
+      return "waiting";
     case "completed":
     case "complete":
     case "succeeded":
@@ -2451,8 +2452,16 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-function resolveToolExecuteTimeoutMs(toolId) {
+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;
+    }
+  }
   return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
@@ -2952,7 +2961,7 @@ var DeeplineClient = class {
       headers,
       {
         forbiddenAsApiError: true,
-        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId),
+        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, input2),
         maxRetries: options?.maxRetries ?? 0,
         exactUrlOnly: true
       }
@@ -10465,7 +10474,7 @@ Examples:
   deepline plays bootstrap company-list --from provider:crustdata_companydb_search --limit 5 --out companies.play.ts
 
   deepline plays bootstrap monitor-triggered --out on-new-row.play.ts
-  deepline plays bootstrap monitor-triggered --tool tamradar.company_radar --stream company_job_openings --out on-new-job.play.ts
+  deepline plays bootstrap monitor-triggered --tool deepline_native.company_radar --stream company_job_openings --out on-new-job.play.ts
 `
   ).option("--name <name>", "Generated play name").option(
     "--from <ref>",
@@ -12084,6 +12093,15 @@ function getStatusFromLiveEvent(event) {
   const payload = getEventPayload(event);
   return playStatusValue(payload.status) ?? playStatusValue(getRunRecordFromPackage(payload)?.status);
 }
+function writePlayWaitingHint(input2) {
+  if (getStatusFromLiveEvent(input2.event) !== "waiting") return;
+  const runId = getRunIdFromLiveEvent(input2.event);
+  if (!runId || input2.state.waitingRunId === runId) return;
+  input2.state.waitingRunId = runId;
+  input2.progress.writeLine(
+    `[play waiting] ${runId} is waiting for an external approval or event. The command will continue watching; inspect it with 'deepline runs get ${runId} --full --json'.`
+  );
+}
 function getFinalStatusFromLiveEvent(event) {
   if (event.type !== "play.run.snapshot" && event.type !== "play.run.status" && event.type !== "play.run.final_status") {
     return null;
@@ -12432,6 +12450,11 @@ async function waitForPlayCompletionByStream(input2) {
       lastPhase = phase;
       input2.progress.phase(phase);
     }
+    writePlayWaitingHint({
+      event,
+      state: input2.state,
+      progress: input2.progress
+    });
     emitLiveDebugTableHints({
       event,
       playName: input2.playName,
@@ -12764,6 +12787,11 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
         lastPhase = phase;
         input2.progress.phase(phase);
       }
+      writePlayWaitingHint({
+        event,
+        state,
+        progress: input2.progress
+      });
       printPlayLogLines({
         lines: getLogLinesFromLiveEvent(event),
         status: null,
@@ -26176,9 +26204,14 @@ async function listTools(args) {
   return 0;
 }
 async function searchTools(queryInput, options = {}) {
-  const query = queryInput.trim();
-  if (!query) {
-    console.error("Usage: deepline tools search <query> [--json]");
+  const query = queryInput?.trim() ?? "";
+  const hasStructuredSearch = Boolean(
+    options.categories?.trim() || options.searchTerms?.trim()
+  );
+  if (!query && !hasStructuredSearch) {
+    console.error(
+      "Usage: deepline tools search [query] --categories <categories> [--search_terms <terms>] [--json]"
+    );
     return 1;
   }
   const client2 = new DeeplineClient();
@@ -26414,7 +26447,7 @@ Examples:
       includeSearchDebug: Boolean(options.includeSearchDebug)
     });
   });
-  addToolSearchCommand(tools.command("search <query>"));
+  addToolSearchCommand(tools.command("search [query]"));
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -27074,6 +27107,28 @@ function samplePayload(samples, key) {
 function commandEnvelopeFromRawResponse(rawResponse) {
   return isRecord8(rawResponse) ? { ...rawResponse } : { status: "completed", result: rawResponse };
 }
+function apifySyncRecoveryNext(rawResponse) {
+  if (!isRecord8(rawResponse) || rawResponse.status !== "running") return null;
+  const toolResponse = recordField2(rawResponse, "toolResponse");
+  const raw = recordField2(toolResponse, "raw");
+  if (raw.state !== "awaiting_apify") return null;
+  const next = recordField2(raw, "next");
+  const getActorRun = recordField2(next, "getActorRun");
+  const getActorRunTool = stringField2(getActorRun, "tool");
+  const getActorRunPayload = recordField2(getActorRun, "payload");
+  if (!getActorRunTool || Object.keys(getActorRunPayload).length === 0) {
+    return null;
+  }
+  const getDatasetItems = recordField2(next, "getDatasetItems");
+  const getDatasetItemsTool = stringField2(getDatasetItems, "tool");
+  const getDatasetItemsPayload = recordField2(getDatasetItems, "payload");
+  return {
+    getActorRun: `deepline tools execute ${getActorRunTool} --input ${shellQuote4(JSON.stringify(getActorRunPayload))} --json`,
+    ...getDatasetItemsTool && Object.keys(getDatasetItemsPayload).length > 0 ? {
+      getDatasetItems: `deepline tools execute ${getDatasetItemsTool} --input ${shellQuote4(JSON.stringify(getDatasetItemsPayload))} --json`
+    } : {}
+  };
+}
 function listExtractorPathsFromUsageGuidance(tool) {
   const toolExecutionResult = tool.usageGuidance?.toolExecutionResult;
   const extractedLists = Array.isArray(toolExecutionResult?.extractedLists) ? toolExecutionResult.extractedLists : isRecord8(toolExecutionResult?.extractedLists) ? Object.values(toolExecutionResult.extractedLists) : [];
@@ -27319,6 +27374,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
 }
 function buildToolExecuteBaseEnvelope(input2) {
   const envelope = commandEnvelopeFromRawResponse(input2.rawResponse);
+  const apifyRecovery = apifySyncRecoveryNext(input2.rawResponse);
   const summaryEntries = Object.entries(input2.summary);
   const outputPreview = input2.listConversion ? {
     kind: "list",
@@ -27342,6 +27398,14 @@ function buildToolExecuteBaseEnvelope(input2) {
       label: "next",
       command: "move starter script into a project folder and expand it into a Deepline play"
     }
+  ] : apifyRecovery ? [
+    { label: "check Apify run", command: apifyRecovery.getActorRun },
+    ...apifyRecovery.getDatasetItems ? [
+      {
+        label: "get Apify dataset items",
+        command: apifyRecovery.getDatasetItems
+      }
+    ] : []
   ] : [];
   return {
     ...envelope,
@@ -27349,6 +27413,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     ...summaryEntries.length > 0 ? { summary: input2.summary } : {},
     next: {
       inspect: inspectCommand,
+      ...apifyRecovery ?? {},
       playDebugging: "When fixing a play getter, inspect returned dataset handles with runs get and export rows with runs export; do not copy CLI preview paths blindly.",
       ...input2.listConversion ? {
         expandToPlay: "Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again.",
@@ -27369,7 +27434,9 @@ function buildToolExecuteBaseEnvelope(input2) {
       ] : [
         {
           title: "result",
-          lines: summaryEntries.length > 0 ? summaryEntries.map(
+          lines: apifyRecovery ? [
+            "Apify is still running. Run the follow-up command(s) below."
+          ] : summaryEntries.length > 0 ? summaryEntries.map(
             ([key, value]) => `${key}=${String(value)}`
           ) : [JSON.stringify(input2.rawResponse, null, 2)]
         }

package/dist/index.d.mts

@@ -3128,7 +3128,7 @@ interface PlayCallOptions {
  *   sqlListeners: [
  *     {
  *       id: 'jobs',
- *       tool: 'tamradar.company_radar',
+ *       tool: 'deepline_native.company_radar',
  *       stream: 'company_job_openings',
  *       operations: ['INSERT'],
  *     },
@@ -3202,7 +3202,7 @@ type SqlListenerWhere = {
 type SqlListenerDeclaration = {
     /** Short id unique inside this play. Deepline stores it as playName.id. */
     id: string;
-    /** Modeled monitor tool id, for example "tamradar.company_radar". */
+    /** Modeled monitor tool id, for example "deepline_native.company_radar". */
     tool: string;
     /** Stream key exposed by the modeled monitor tool, for example "company_job_openings". */
     stream: string;

package/dist/index.d.ts

@@ -3128,7 +3128,7 @@ interface PlayCallOptions {
  *   sqlListeners: [
  *     {
  *       id: 'jobs',
- *       tool: 'tamradar.company_radar',
+ *       tool: 'deepline_native.company_radar',
  *       stream: 'company_job_openings',
  *       operations: ['INSERT'],
  *     },
@@ -3202,7 +3202,7 @@ type SqlListenerWhere = {
 type SqlListenerDeclaration = {
     /** Short id unique inside this play. Deepline stores it as playName.id. */
     id: string;
-    /** Modeled monitor tool id, for example "tamradar.company_radar". */
+    /** Modeled monitor tool id, for example "deepline_native.company_radar". */
     tool: string;
     /** Stream key exposed by the modeled monitor tool, for example "company_job_openings". */
     stream: string;

package/dist/index.js

@@ -424,10 +424,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.227",
+  version: "0.1.228",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.227",
+    latest: "0.1.228",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -1490,8 +1490,9 @@ function normalizePlayRunLifecycleStatus(value) {
       return "running";
     case "running":
     case "started":
-    case "waiting":
       return "running";
+    case "waiting":
+      return "waiting";
     case "completed":
     case "complete":
     case "succeeded":
@@ -2265,8 +2266,16 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-function resolveToolExecuteTimeoutMs(toolId) {
+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;
+    }
+  }
   return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
@@ -2766,7 +2775,7 @@ var DeeplineClient = class {
       headers,
       {
         forbiddenAsApiError: true,
-        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId),
+        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, input),
         maxRetries: options?.maxRetries ?? 0,
         exactUrlOnly: true
       }

package/dist/index.mjs

@@ -354,10 +354,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.227",
+  version: "0.1.228",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.227",
+    latest: "0.1.228",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -1420,8 +1420,9 @@ function normalizePlayRunLifecycleStatus(value) {
       return "running";
     case "running":
     case "started":
-    case "waiting":
       return "running";
+    case "waiting":
+      return "waiting";
     case "completed":
     case "complete":
     case "succeeded":
@@ -2195,8 +2196,16 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
-function resolveToolExecuteTimeoutMs(toolId) {
+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;
+    }
+  }
   return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
@@ -2696,7 +2705,7 @@ var DeeplineClient = class {
       headers,
       {
         forbiddenAsApiError: true,
-        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId),
+        timeout: options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, input),
         maxRetries: options?.maxRetries ?? 0,
         exactUrlOnly: true
       }