deepline 0.3.247 → 0.3.249

package/dist/index.js

@@ -122,6 +122,31 @@ async function* iterateCursorPages(fetchPage) {
   }
 }
 
+// src/plays/input-example.ts
+function playInputExampleArgs(schema) {
+  if (!schema) return " --input '@<input.json>'";
+  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
+  const csv = schema.csvInput;
+  const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
+  const required = Array.isArray(schema.required) ? schema.required : [];
+  const csvOnlyRequired = required.every((key) => key === csvField);
+  const alternatives = schema.oneOf ?? schema.anyOf;
+  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
+    if (!branch || typeof branch !== "object") return false;
+    const keys = branch.required;
+    return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
+  });
+  if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
+    if (csvField === "csv") return " --csv '<contacts.csv>'";
+    const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
+    return ` --input '${value.replace(/'/g, "'\\''")}'`;
+  }
+  if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
+    return "";
+  }
+  return " --input '@<input.json>'";
+}
+
 // src/config.ts
 var import_node_fs = require("fs");
 var import_node_os = require("os");
@@ -979,8 +1004,12 @@ function executionRecoveryError(input) {
 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) {
+var JSEARCH_SEARCH_CLIENT_TIMEOUT_MS = 2 * 12e4 + 250 + 15e3;
+function resolveToolExecuteTimeoutMs(toolId, input, configuredRequestTimeoutMs) {
   const normalized = toolId.trim().toLowerCase();
+  if (normalized === "openwebninja_jsearch_search") {
+    return configuredRequestTimeoutMs ?? JSEARCH_SEARCH_CLIENT_TIMEOUT_MS;
+  }
   const lookupTimeoutMs = resolveLookupClientTimeoutMs(normalized);
   if (lookupTimeoutMs !== void 0) return lookupTimeoutMs;
   if (normalized === "apify_run_actor_sync") {
@@ -1049,9 +1078,10 @@ function materializeToolExecutionResponse(response) {
   };
 }
 var ToolCalls = class {
-  constructor(http, defaultRequestTimeoutMs) {
+  constructor(http, defaultRequestTimeoutMs, configuredRequestTimeoutMs) {
     this.http = http;
     this.defaultRequestTimeoutMs = defaultRequestTimeoutMs;
+    this.configuredRequestTimeoutMs = configuredRequestTimeoutMs;
   }
   async call(toolId, input, options) {
     const inputSnapshot = JSON.parse(JSON.stringify(input));
@@ -1068,7 +1098,11 @@ var ToolCalls = class {
       }
       await options?.onExecution?.({ idempotencyKey });
     }
-    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, inputSnapshot);
+    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(
+      toolId,
+      inputSnapshot,
+      this.configuredRequestTimeoutMs
+    );
     if (idempotencyKey !== void 0) {
       await this.lookupExecutionByKey(idempotencyKey, timeoutMs);
     }
@@ -1286,7 +1320,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.247",
+  version: "0.3.249",
   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
@@ -2675,8 +2709,12 @@ function resolveTimingWindow(input) {
 // ../play-runtime/run-failure.ts
 var PUBLIC_FAILURE_TEXT_BYTE_LIMIT = 64 * 1024;
 
+// ../play-runtime/log-context.ts
+var utf8 = new TextEncoder();
+
 // ../play-runtime/run-log-buffer.ts
 var RUNNER_LOG_MAX_BYTES = 5 * 1024 * 1024;
+var RUNNER_LOG_CONTEXT_MAX_BYTES = 128 * 1024;
 var TERMINAL_RESERVE_BYTES = 64 * 1024;
 var encoder = new TextEncoder();
 
@@ -3606,6 +3644,21 @@ function runtimeSelectionHeaders(runtime) {
     ...receivers ? { [RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
   };
 }
+function isolatedCiRuntimeEventReadHeaders() {
+  const schema = process.env.DEEPLINE_RUNTIME_SCHEDULER_SCHEMA?.trim();
+  if (process.env.DEEPLINE_SYNTHETIC_RUN?.trim() !== "1" || !schema || !/^fly_absurd_pr_\d+_\d+(?:_\d+)?$/.test(schema)) {
+    return void 0;
+  }
+  const token = process.env.DEEPLINE_INTERNAL_TOKEN?.trim();
+  if (!token) {
+    throw new DeeplineError(
+      "DEEPLINE_INTERNAL_TOKEN is required for isolated CI runtime event reads.",
+      void 0,
+      "RUNTIME_EVENT_INTERNAL_TOKEN_REQUIRED"
+    );
+  }
+  return { [COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
+}
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -3978,8 +4031,13 @@ 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.toolCalls = new ToolCalls(
+      this.http,
+      this.config.timeout,
+      options?.timeout
+    );
     this.runs = {
+      getReceipts: (runId, options2) => this.getRunReceipts(runId, options2),
       get: (runId, options2) => this.getRunStatus(runId, options2),
       status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options2) => this.listRuns(options2),
@@ -3987,6 +4045,7 @@ var DeeplineClient = class _DeeplineClient {
       watch: (runId, options2) => this.watchRunToTerminal(runId, options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
+      searchEvents: (options2) => this.searchRunEvents(options2),
       input: (runId) => this.getRunInput(runId),
       rerun: (runId, options2) => this.rerun(runId, options2),
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
@@ -4111,13 +4170,9 @@ var DeeplineClient = class _DeeplineClient {
     const value = schema[key];
     return isRecord4(value) ? value : null;
   }
-  playRunCommand(play, options) {
+  playRunCommand(play) {
     const target = play.reference || play.name;
-    if (options?.csvInput) {
-      const inputField = typeof options.csvInput.inputField === "string" && options.csvInput.inputField.trim() ? options.csvInput.inputField.trim() : "csv";
-      return `deepline plays run ${target} --input '${JSON.stringify({ [inputField]: "leads.csv" })}' --watch`;
-    }
-    return `deepline plays run ${target} --input '{...}' --watch`;
+    return `deepline plays run ${target}${playInputExampleArgs(play.inputSchema)} --watch`;
   }
   starterPlayPath(play) {
     const target = play.reference || play.name;
@@ -4144,7 +4199,7 @@ var DeeplineClient = class _DeeplineClient {
       "rowOutputSchema"
     );
     const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
-    const runCommand = this.playRunCommand(play, { csvInput });
+    const runCommand = this.playRunCommand(play);
     const cloneEditStarter = this.playCloneEditStarter(play);
     return {
       name: play.name,
@@ -5357,6 +5412,33 @@ var DeeplineClient = class _DeeplineClient {
     );
     return { ...response, runs: response.runs ?? [] };
   }
+  /** Read batches rather than silently truncating a long key list. */
+  async getRunReceipts(runId, options) {
+    if (!options.keys.length || options.keys.some(
+      (key) => typeof key !== "string" || !key.trim() || key.length > 2048 || /[\r\n\0]/.test(key)
+    )) {
+      throw Object.assign(
+        new Error(
+          "Supply nonempty receipt keys, at most 2048 characters each."
+        ),
+        { exitCode: 2 }
+      );
+    }
+    const receipts = [];
+    for (let offset = 0; offset < options.keys.length; offset += 100) {
+      const keys = options.keys.slice(offset, offset + 100);
+      const result = await this.http.post(`/api/v2/runs/${encodeURIComponent(runId)}/receipts/results`, { keys });
+      if (result.runId !== runId || result.receipts.length !== keys.length || result.receipts.some(
+        (receipt, index) => receipt.receiptKey !== keys[index]
+      )) {
+        throw new Error(
+          "Receipt response does not match the requested run and keys."
+        );
+      }
+      receipts.push(...result.receipts);
+    }
+    return { runId, receipts };
+  }
   /** Get the exact original input retained for a run. This is intentionally separate from status. */
   async getRunInput(runId) {
     return this.http.get(`/api/v2/runs/${encodeURIComponent(runId)}/input`);
@@ -5406,7 +5488,8 @@ var DeeplineClient = class _DeeplineClient {
       const requestedLimit = typeof options.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : RUNS_FAILED_LOG_LIMIT;
       const failedLimit = Math.min(RUNS_FAILED_LOG_LIMIT, requestedLimit);
       const page = await this.http.get(
-        `/api/v2/runs/${encodeURIComponent(runId)}/logs?view=failed&limit=${failedLimit}`
+        `/api/v2/runs/${encodeURIComponent(runId)}/logs?view=failed&limit=${failedLimit}`,
+        { retryApiErrors: true }
       );
       return {
         runId: page.runId,
@@ -5428,7 +5511,8 @@ var DeeplineClient = class _DeeplineClient {
     }
     const limit = options?.all ? Number.MAX_SAFE_INTEGER : typeof options?.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : 200;
     const fetchPage = (afterSeq2, pageLimit) => this.http.get(
-      `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`
+      `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`,
+      { retryApiErrors: true }
     );
     const probe = await fetchPage(0, 1);
     const lastStoredSeq = probe.lastStoredSeq;
@@ -5463,6 +5547,42 @@ var DeeplineClient = class _DeeplineClient {
       ...probe.logsTruncated ? { logsTruncated: true } : {}
     };
   }
+  /** Search bounded, structured runtime history without requiring a run id. */
+  async searchRunEvents(options = {}) {
+    const now = Date.now();
+    const params = new URLSearchParams({
+      since: options.since ?? new Date(now - 60 * 60 * 1e3).toISOString(),
+      until: options.until ?? new Date(now).toISOString()
+    });
+    if (options.runId) params.set("runId", options.runId);
+    if (options.playName) params.set("playName", options.playName);
+    if (options.kind) params.set("kind", options.kind);
+    if (options.jsonpath) params.set("jsonpath", options.jsonpath);
+    if (options.includePayloads) params.set("payloads", "true");
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    if (options.cursor) params.set("cursor", options.cursor);
+    let headers;
+    if (options.runtime !== void 0) {
+      const runtime = normalizePlayRuntimeSelection(options.runtime);
+      if (!runtime) {
+        throw new DeeplineError(
+          "runs.searchEvents runtime must be a valid Preview selection.",
+          void 0,
+          "INVALID_RUNTIME_SELECTION"
+        );
+      }
+      params.set("runtime", "preview");
+      params.set("namespace", runtime.namespace);
+      if (runtime.backend) params.set("backend", runtime.backend);
+      headers = runtimeSelectionHeaders(runtime);
+    } else {
+      headers = isolatedCiRuntimeEventReadHeaders();
+    }
+    return this.http.get(
+      `/api/v2/runs/events?${params.toString()}`,
+      { headers, retryApiErrors: true }
+    );
+  }
   /**
    * Export persisted runtime-sheet rows for a play dataset/table namespace.
    *
@@ -10242,7 +10362,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   `  runPlay<TOutput = unknown>(key: string, playRef: ${cloudReferenceType("ctx.runPlay.playRef")}, input: ${cloudReferenceType("ctx.runPlay.input")}, options: PlayCallOptions): Promise<TOutput>;`,
   "  runPlayAsync<TInput extends Record<string, unknown>>(key: string, playRef: PlayReferenceLike<TInput>, input: NoInfer<TInput>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
   "  runPlayAsync(key: string, playRef: string, input: Record<string, unknown>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
-  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error' }): void;",
+  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error'; context?: Readonly<Record<string, string | number | boolean>> }): void;",
   `  sleep(ms: ${cloudReferenceType("ctx.sleep.ms")}): Promise<void>;`,
   "}",
   "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",

package/dist/index.mjs

@@ -18,6 +18,31 @@ async function* iterateCursorPages(fetchPage) {
   }
 }
 
+// src/plays/input-example.ts
+function playInputExampleArgs(schema) {
+  if (!schema) return " --input '@<input.json>'";
+  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
+  const csv = schema.csvInput;
+  const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
+  const required = Array.isArray(schema.required) ? schema.required : [];
+  const csvOnlyRequired = required.every((key) => key === csvField);
+  const alternatives = schema.oneOf ?? schema.anyOf;
+  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
+    if (!branch || typeof branch !== "object") return false;
+    const keys = branch.required;
+    return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
+  });
+  if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
+    if (csvField === "csv") return " --csv '<contacts.csv>'";
+    const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
+    return ` --input '${value.replace(/'/g, "'\\''")}'`;
+  }
+  if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
+    return "";
+  }
+  return " --input '@<input.json>'";
+}
+
 // src/config.ts
 import {
   existsSync,
@@ -883,8 +908,12 @@ function executionRecoveryError(input) {
 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) {
+var JSEARCH_SEARCH_CLIENT_TIMEOUT_MS = 2 * 12e4 + 250 + 15e3;
+function resolveToolExecuteTimeoutMs(toolId, input, configuredRequestTimeoutMs) {
   const normalized = toolId.trim().toLowerCase();
+  if (normalized === "openwebninja_jsearch_search") {
+    return configuredRequestTimeoutMs ?? JSEARCH_SEARCH_CLIENT_TIMEOUT_MS;
+  }
   const lookupTimeoutMs = resolveLookupClientTimeoutMs(normalized);
   if (lookupTimeoutMs !== void 0) return lookupTimeoutMs;
   if (normalized === "apify_run_actor_sync") {
@@ -953,9 +982,10 @@ function materializeToolExecutionResponse(response) {
   };
 }
 var ToolCalls = class {
-  constructor(http, defaultRequestTimeoutMs) {
+  constructor(http, defaultRequestTimeoutMs, configuredRequestTimeoutMs) {
     this.http = http;
     this.defaultRequestTimeoutMs = defaultRequestTimeoutMs;
+    this.configuredRequestTimeoutMs = configuredRequestTimeoutMs;
   }
   async call(toolId, input, options) {
     const inputSnapshot = JSON.parse(JSON.stringify(input));
@@ -972,7 +1002,11 @@ var ToolCalls = class {
       }
       await options?.onExecution?.({ idempotencyKey });
     }
-    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(toolId, inputSnapshot);
+    const timeoutMs = options?.timeout ?? resolveToolExecuteTimeoutMs(
+      toolId,
+      inputSnapshot,
+      this.configuredRequestTimeoutMs
+    );
     if (idempotencyKey !== void 0) {
       await this.lookupExecutionByKey(idempotencyKey, timeoutMs);
     }
@@ -1190,7 +1224,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.247",
+  version: "0.3.249",
   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
@@ -2579,8 +2613,12 @@ function resolveTimingWindow(input) {
 // ../play-runtime/run-failure.ts
 var PUBLIC_FAILURE_TEXT_BYTE_LIMIT = 64 * 1024;
 
+// ../play-runtime/log-context.ts
+var utf8 = new TextEncoder();
+
 // ../play-runtime/run-log-buffer.ts
 var RUNNER_LOG_MAX_BYTES = 5 * 1024 * 1024;
+var RUNNER_LOG_CONTEXT_MAX_BYTES = 128 * 1024;
 var TERMINAL_RESERVE_BYTES = 64 * 1024;
 var encoder = new TextEncoder();
 
@@ -3510,6 +3548,21 @@ function runtimeSelectionHeaders(runtime) {
     ...receivers ? { [RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
   };
 }
+function isolatedCiRuntimeEventReadHeaders() {
+  const schema = process.env.DEEPLINE_RUNTIME_SCHEDULER_SCHEMA?.trim();
+  if (process.env.DEEPLINE_SYNTHETIC_RUN?.trim() !== "1" || !schema || !/^fly_absurd_pr_\d+_\d+(?:_\d+)?$/.test(schema)) {
+    return void 0;
+  }
+  const token = process.env.DEEPLINE_INTERNAL_TOKEN?.trim();
+  if (!token) {
+    throw new DeeplineError(
+      "DEEPLINE_INTERNAL_TOKEN is required for isolated CI runtime event reads.",
+      void 0,
+      "RUNTIME_EVENT_INTERNAL_TOKEN_REQUIRED"
+    );
+  }
+  return { [COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
+}
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -3882,8 +3935,13 @@ 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.toolCalls = new ToolCalls(
+      this.http,
+      this.config.timeout,
+      options?.timeout
+    );
     this.runs = {
+      getReceipts: (runId, options2) => this.getRunReceipts(runId, options2),
       get: (runId, options2) => this.getRunStatus(runId, options2),
       status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options2) => this.listRuns(options2),
@@ -3891,6 +3949,7 @@ var DeeplineClient = class _DeeplineClient {
       watch: (runId, options2) => this.watchRunToTerminal(runId, options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
+      searchEvents: (options2) => this.searchRunEvents(options2),
       input: (runId) => this.getRunInput(runId),
       rerun: (runId, options2) => this.rerun(runId, options2),
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
@@ -4015,13 +4074,9 @@ var DeeplineClient = class _DeeplineClient {
     const value = schema[key];
     return isRecord4(value) ? value : null;
   }
-  playRunCommand(play, options) {
+  playRunCommand(play) {
     const target = play.reference || play.name;
-    if (options?.csvInput) {
-      const inputField = typeof options.csvInput.inputField === "string" && options.csvInput.inputField.trim() ? options.csvInput.inputField.trim() : "csv";
-      return `deepline plays run ${target} --input '${JSON.stringify({ [inputField]: "leads.csv" })}' --watch`;
-    }
-    return `deepline plays run ${target} --input '{...}' --watch`;
+    return `deepline plays run ${target}${playInputExampleArgs(play.inputSchema)} --watch`;
   }
   starterPlayPath(play) {
     const target = play.reference || play.name;
@@ -4048,7 +4103,7 @@ var DeeplineClient = class _DeeplineClient {
       "rowOutputSchema"
     );
     const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
-    const runCommand = this.playRunCommand(play, { csvInput });
+    const runCommand = this.playRunCommand(play);
     const cloneEditStarter = this.playCloneEditStarter(play);
     return {
       name: play.name,
@@ -5261,6 +5316,33 @@ var DeeplineClient = class _DeeplineClient {
     );
     return { ...response, runs: response.runs ?? [] };
   }
+  /** Read batches rather than silently truncating a long key list. */
+  async getRunReceipts(runId, options) {
+    if (!options.keys.length || options.keys.some(
+      (key) => typeof key !== "string" || !key.trim() || key.length > 2048 || /[\r\n\0]/.test(key)
+    )) {
+      throw Object.assign(
+        new Error(
+          "Supply nonempty receipt keys, at most 2048 characters each."
+        ),
+        { exitCode: 2 }
+      );
+    }
+    const receipts = [];
+    for (let offset = 0; offset < options.keys.length; offset += 100) {
+      const keys = options.keys.slice(offset, offset + 100);
+      const result = await this.http.post(`/api/v2/runs/${encodeURIComponent(runId)}/receipts/results`, { keys });
+      if (result.runId !== runId || result.receipts.length !== keys.length || result.receipts.some(
+        (receipt, index) => receipt.receiptKey !== keys[index]
+      )) {
+        throw new Error(
+          "Receipt response does not match the requested run and keys."
+        );
+      }
+      receipts.push(...result.receipts);
+    }
+    return { runId, receipts };
+  }
   /** Get the exact original input retained for a run. This is intentionally separate from status. */
   async getRunInput(runId) {
     return this.http.get(`/api/v2/runs/${encodeURIComponent(runId)}/input`);
@@ -5310,7 +5392,8 @@ var DeeplineClient = class _DeeplineClient {
       const requestedLimit = typeof options.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : RUNS_FAILED_LOG_LIMIT;
       const failedLimit = Math.min(RUNS_FAILED_LOG_LIMIT, requestedLimit);
       const page = await this.http.get(
-        `/api/v2/runs/${encodeURIComponent(runId)}/logs?view=failed&limit=${failedLimit}`
+        `/api/v2/runs/${encodeURIComponent(runId)}/logs?view=failed&limit=${failedLimit}`,
+        { retryApiErrors: true }
       );
       return {
         runId: page.runId,
@@ -5332,7 +5415,8 @@ var DeeplineClient = class _DeeplineClient {
     }
     const limit = options?.all ? Number.MAX_SAFE_INTEGER : typeof options?.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : 200;
     const fetchPage = (afterSeq2, pageLimit) => this.http.get(
-      `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`
+      `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`,
+      { retryApiErrors: true }
     );
     const probe = await fetchPage(0, 1);
     const lastStoredSeq = probe.lastStoredSeq;
@@ -5367,6 +5451,42 @@ var DeeplineClient = class _DeeplineClient {
       ...probe.logsTruncated ? { logsTruncated: true } : {}
     };
   }
+  /** Search bounded, structured runtime history without requiring a run id. */
+  async searchRunEvents(options = {}) {
+    const now = Date.now();
+    const params = new URLSearchParams({
+      since: options.since ?? new Date(now - 60 * 60 * 1e3).toISOString(),
+      until: options.until ?? new Date(now).toISOString()
+    });
+    if (options.runId) params.set("runId", options.runId);
+    if (options.playName) params.set("playName", options.playName);
+    if (options.kind) params.set("kind", options.kind);
+    if (options.jsonpath) params.set("jsonpath", options.jsonpath);
+    if (options.includePayloads) params.set("payloads", "true");
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    if (options.cursor) params.set("cursor", options.cursor);
+    let headers;
+    if (options.runtime !== void 0) {
+      const runtime = normalizePlayRuntimeSelection(options.runtime);
+      if (!runtime) {
+        throw new DeeplineError(
+          "runs.searchEvents runtime must be a valid Preview selection.",
+          void 0,
+          "INVALID_RUNTIME_SELECTION"
+        );
+      }
+      params.set("runtime", "preview");
+      params.set("namespace", runtime.namespace);
+      if (runtime.backend) params.set("backend", runtime.backend);
+      headers = runtimeSelectionHeaders(runtime);
+    } else {
+      headers = isolatedCiRuntimeEventReadHeaders();
+    }
+    return this.http.get(
+      `/api/v2/runs/events?${params.toString()}`,
+      { headers, retryApiErrors: true }
+    );
+  }
   /**
    * Export persisted runtime-sheet rows for a play dataset/table namespace.
    *
@@ -10146,7 +10266,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   `  runPlay<TOutput = unknown>(key: string, playRef: ${cloudReferenceType("ctx.runPlay.playRef")}, input: ${cloudReferenceType("ctx.runPlay.input")}, options: PlayCallOptions): Promise<TOutput>;`,
   "  runPlayAsync<TInput extends Record<string, unknown>>(key: string, playRef: PlayReferenceLike<TInput>, input: NoInfer<TInput>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
   "  runPlayAsync(key: string, playRef: string, input: Record<string, unknown>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
-  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error' }): void;",
+  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error'; context?: Readonly<Record<string, string | number | boolean>> }): void;",
   `  sleep(ms: ${cloudReferenceType("ctx.sleep.ms")}): Promise<void>;`,
   "}",
   "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",

package/dist/install-integrity.json

@@ -18,10 +18,13 @@
     "dist/bundling-sources/sdk/src/pagination.ts",
     "dist/bundling-sources/sdk/src/play.ts",
     "dist/bundling-sources/sdk/src/plays/bundle-play-file.ts",
+    "dist/bundling-sources/sdk/src/plays/input-example.ts",
     "dist/bundling-sources/sdk/src/plays/local-file-discovery.ts",
     "dist/bundling-sources/sdk/src/release.ts",
     "dist/bundling-sources/sdk/src/runs/observe-transport.ts",
+    "dist/bundling-sources/sdk/src/runs/overview.ts",
     "dist/bundling-sources/sdk/src/runs/read-errors.ts",
+    "dist/bundling-sources/sdk/src/runs/receipts.ts",
     "dist/bundling-sources/sdk/src/runs/watch-polling.ts",
     "dist/bundling-sources/sdk/src/skills-version.ts",
     "dist/bundling-sources/sdk/src/tool-calls.ts",
@@ -221,6 +224,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/ledger-safe-payload.ts",
     "dist/bundling-sources/shared_libs/play-runtime/live-events.ts",
     "dist/bundling-sources/shared_libs/play-runtime/live-state-contract.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/log-context.ts",
     "dist/bundling-sources/shared_libs/play-runtime/log-provenance.ts",
     "dist/bundling-sources/shared_libs/play-runtime/map-chunk-limits.ts",
     "dist/bundling-sources/shared_libs/play-runtime/map-execution-frame.ts",
@@ -317,7 +321,9 @@
     "dist/bundling-sources/shared_libs/play-runtime/runner-app/runtime-progress-push.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-app/runtime-sheet-persistence-retry.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-app/runtime-terminal-push.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-control-transport.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-labels.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-launch-transport.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-lifecycle.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-modal-fallback.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-payload-transport.ts",
@@ -409,6 +415,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-terminal-transition.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runner-push.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-api-origin.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-event-search.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-queue-health.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-receipt-gateway-health.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-receipt-value-storage.ts",
@@ -575,8 +582,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-n8ZtPv2h.d.mts",
-    "dist/compiler-manifest-n8ZtPv2h.d.ts",
+    "dist/compiler-manifest-DavmLa8y.d.mts",
+    "dist/compiler-manifest-DavmLa8y.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-n8ZtPv2h.mjs';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-n8ZtPv2h.mjs';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DavmLa8y.mjs';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-DavmLa8y.mjs';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-n8ZtPv2h.js';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-n8ZtPv2h.js';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DavmLa8y.js';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-DavmLa8y.js';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.mjs

@@ -1609,7 +1609,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   `  runPlay<TOutput = unknown>(key: string, playRef: ${cloudReferenceType("ctx.runPlay.playRef")}, input: ${cloudReferenceType("ctx.runPlay.input")}, options: PlayCallOptions): Promise<TOutput>;`,
   "  runPlayAsync<TInput extends Record<string, unknown>>(key: string, playRef: PlayReferenceLike<TInput>, input: NoInfer<TInput>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
   "  runPlayAsync(key: string, playRef: string, input: Record<string, unknown>, options: PlayAsyncCallOptions): Promise<AsyncPlayRunRef>;",
-  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error' }): void;",
+  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error'; context?: Readonly<Record<string, string | number | boolean>> }): void;",
   `  sleep(ms: ${cloudReferenceType("ctx.sleep.ms")}): Promise<void>;`,
   "}",
   "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.247";
+    readonly version: "0.3.249";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.247";
+    readonly version: "0.3.249";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.247",
+  version: "0.3.249",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.247",
+  version: "0.3.249",
   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