deepline 0.3.46 → 0.3.48

package/dist/cli/index.js

@@ -282,6 +282,8 @@ var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
   networkKind;
   /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
+  publicDetails;
   /**
    * Construct a structured tool error.
    *
@@ -306,6 +308,7 @@ var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
     this.retryAfterMs = options.retryAfterMs;
     this.networkKind = options.networkKind;
     this.networkScope = options.networkScope;
+    this.publicDetails = options.publicDetails ?? null;
     applyBrand(this, TOOL_EXECUTION_ERROR_BRAND);
     if (isProviderTransientFailure(options)) {
       applyBrand(this, PROVIDER_TRANSIENT_ERROR_BRAND);
@@ -417,6 +420,33 @@ function normalizeNetworkScope(value) {
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+var MAX_PUBLIC_DETAIL_ENTRIES = 20;
+var MAX_PUBLIC_DETAIL_KEY_LENGTH = 80;
+var MAX_PUBLIC_DETAIL_STRING_LENGTH = 512;
+function normalizeToolExecutionPublicDetails(value) {
+  if (!isRecord(value)) return null;
+  const details = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (Object.keys(details).length >= MAX_PUBLIC_DETAIL_ENTRIES) break;
+    if (key.length === 0 || key.length > MAX_PUBLIC_DETAIL_KEY_LENGTH || !/^[a-z][a-zA-Z0-9_]*$/.test(key)) {
+      continue;
+    }
+    if (typeof entry === "string") {
+      if (entry.length <= MAX_PUBLIC_DETAIL_STRING_LENGTH) details[key] = entry;
+      continue;
+    }
+    if (typeof entry === "number") {
+      if (Number.isFinite(entry)) details[key] = entry;
+      continue;
+    }
+    if (typeof entry === "boolean") {
+      details[key] = entry;
+      continue;
+    }
+    if (entry === null) details[key] = null;
+  }
+  return Object.keys(details).length > 0 ? details : null;
+}
 function normalizeToolExecutionFailure(value) {
   if (!isRecord(value) || value.schemaVersion !== TOOL_EXECUTION_ERROR_SCHEMA_VERSION) {
     return null;
@@ -430,6 +460,7 @@ function normalizeToolExecutionFailure(value) {
     operation
   });
   const category = normalizeToolExecutionCategory(value.category);
+  const publicDetails = normalizeToolExecutionPublicDetails(value.publicDetails);
   const trustworthy = origin !== "unknown" && category !== "unknown" && typeof value.retryable === "boolean";
   return {
     schemaVersion: TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
@@ -444,7 +475,8 @@ function normalizeToolExecutionFailure(value) {
     requestId: boundedString(value.requestId),
     retryAfterMs: finiteNonNegativeInteger(value.retryAfterMs),
     networkKind: normalizeNetworkKind(value.networkKind),
-    networkScope: normalizeNetworkScope(value.networkScope)
+    networkScope: normalizeNetworkScope(value.networkScope),
+    ...publicDetails ? { publicDetails } : {}
   };
 }
 function serializeToolExecutionFailure(error) {
@@ -462,7 +494,8 @@ function serializeToolExecutionFailure(error) {
     requestId: error.requestId,
     retryAfterMs: error.retryAfterMs,
     networkKind: error.networkKind,
-    networkScope: error.networkScope
+    networkScope: error.networkScope,
+    publicDetails: error.publicDetails
   });
 }
 function deserializeToolExecutionFailure(message, value, acceptedSchemaVersion) {
@@ -520,6 +553,8 @@ var ToolRateLimitError = class extends RateLimitError {
   networkKind;
   /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Explicitly allowlisted diagnostics safe for SDK callers. */
+  publicDetails;
   /** Constructed by the SDK after a structured tool HTTP 429. */
   constructor(message, options) {
     super(options.retryAfterMs ?? 5e3, message);
@@ -535,6 +570,7 @@ var ToolRateLimitError = class extends RateLimitError {
     this.requestId = options.requestId;
     this.networkKind = options.networkKind;
     this.networkScope = options.networkScope;
+    this.publicDetails = options.publicDetails ?? null;
     this.details = options.details;
     brandAsToolExecutionError(this);
     if (isProviderTransientFailure(this)) {
@@ -1043,7 +1079,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.46",
+  version: "0.3.48",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1932,7 +1968,7 @@ var HttpClient = class {
           body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
           signal: options?.signal
         });
-        if (!response.ok) {
+        if (!response.ok || response.status === 202) {
           const body = await response.text();
           const parsed = parseResponseBody(body);
           if (response.status === 401 && !isProviderOriginatedHttpError(parsed)) {
@@ -5661,12 +5697,26 @@ var DeeplineClient = class {
     const headers = options?.lastEventId && options.lastEventId.trim() ? { "Last-Event-ID": options.lastEventId.trim() } : void 0;
     const params = new URLSearchParams();
     params.set("mode", options?.mode ?? "cli");
-    for await (const event of this.http.streamSse(
-      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
-      { signal: options?.signal, headers }
-    )) {
-      if (event.scope === "play") {
-        yield event;
+    const projectionDeadline = Date.now() + 3e4;
+    let projectionAttempt = 0;
+    for (; ; ) {
+      let sawEvent = false;
+      try {
+        for await (const event of this.http.streamSse(
+          `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
+          { signal: options?.signal, headers }
+        )) {
+          sawEvent = true;
+          if (event.scope === "play") {
+            yield event;
+          }
+        }
+        return;
+      } catch (error) {
+        const projectionPending = options?.waitForProjection === true && !sawEvent && error instanceof DeeplineError && (error.statusCode === 404 || error.statusCode === 202 && error.code === "RUN_PROJECTION_PENDING") && Date.now() < projectionDeadline;
+        if (!projectionPending) throw error;
+        await sleep2(streamReconnectDelayMs(projectionAttempt));
+        projectionAttempt += 1;
       }
     }
   }
@@ -6695,7 +6745,8 @@ var DeeplineClient = class {
     }
     for await (const event of this.streamPlayRunEvents(workflowId, {
       mode: "cli",
-      signal: options?.signal
+      signal: options?.signal,
+      waitForProjection: true
     })) {
       if (options?.signal?.aborted) {
         await this.cancelPlay(workflowId);
@@ -20728,7 +20779,7 @@ async function waitForPlayCompletionByStream(input2) {
     try {
       for await (const event of input2.client.streamPlayRunEvents(
         input2.workflowId,
-        { signal: controller.signal }
+        { signal: controller.signal, waitForProjection: true }
       )) {
         sawEvent = true;
         const terminal = await handleLiveEvent(event);
@@ -32311,6 +32362,7 @@ async function handleFeedback(text, options) {
   const { http } = getAuthedHttpClient();
   const response = await http.post("/api/v2/cli/feedback", {
     text,
+    requested: options.requested === true,
     environment: collectLocalEnvInfo(),
     ...options.command ? { command: options.command } : {},
     ...options.payload ? { payload: options.payload } : {}
@@ -32334,6 +32386,7 @@ function registerFeedbackCommands(program) {
 Notes:
   Sends the feedback text plus local CLI environment info to Deepline support.
   Use --command and --payload to attach a reproducible command shape.
+  Agents should pass --requested when the user asked them to submit the report.
 
 Examples:
   deepline feedback send "plays run failed after upload" --command "deepline plays run my.play.ts --watch"
@@ -32345,9 +32398,13 @@ Examples:
     `
 Examples:
   deepline feedback send "tools search returned stale results" --json
+  deepline feedback send "tools search returned stale results" --requested --json
   deepline feedback send "plays run failed after upload" --command "deepline plays run my.play.ts --watch"
 `
-  ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option("--json", "Emit JSON output").action(handleFeedback);
+  ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option(
+    "--requested",
+    "Mark the report as explicitly requested by the user"
+  ).option("--json", "Emit JSON output").action(handleFeedback);
 }
 
 // src/cli/commands/sessions.ts

package/dist/cli/index.mjs

@@ -268,6 +268,8 @@ var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
   networkKind;
   /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
+  publicDetails;
   /**
    * Construct a structured tool error.
    *
@@ -292,6 +294,7 @@ var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
     this.retryAfterMs = options.retryAfterMs;
     this.networkKind = options.networkKind;
     this.networkScope = options.networkScope;
+    this.publicDetails = options.publicDetails ?? null;
     applyBrand(this, TOOL_EXECUTION_ERROR_BRAND);
     if (isProviderTransientFailure(options)) {
       applyBrand(this, PROVIDER_TRANSIENT_ERROR_BRAND);
@@ -403,6 +406,33 @@ function normalizeNetworkScope(value) {
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+var MAX_PUBLIC_DETAIL_ENTRIES = 20;
+var MAX_PUBLIC_DETAIL_KEY_LENGTH = 80;
+var MAX_PUBLIC_DETAIL_STRING_LENGTH = 512;
+function normalizeToolExecutionPublicDetails(value) {
+  if (!isRecord(value)) return null;
+  const details = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (Object.keys(details).length >= MAX_PUBLIC_DETAIL_ENTRIES) break;
+    if (key.length === 0 || key.length > MAX_PUBLIC_DETAIL_KEY_LENGTH || !/^[a-z][a-zA-Z0-9_]*$/.test(key)) {
+      continue;
+    }
+    if (typeof entry === "string") {
+      if (entry.length <= MAX_PUBLIC_DETAIL_STRING_LENGTH) details[key] = entry;
+      continue;
+    }
+    if (typeof entry === "number") {
+      if (Number.isFinite(entry)) details[key] = entry;
+      continue;
+    }
+    if (typeof entry === "boolean") {
+      details[key] = entry;
+      continue;
+    }
+    if (entry === null) details[key] = null;
+  }
+  return Object.keys(details).length > 0 ? details : null;
+}
 function normalizeToolExecutionFailure(value) {
   if (!isRecord(value) || value.schemaVersion !== TOOL_EXECUTION_ERROR_SCHEMA_VERSION) {
     return null;
@@ -416,6 +446,7 @@ function normalizeToolExecutionFailure(value) {
     operation
   });
   const category = normalizeToolExecutionCategory(value.category);
+  const publicDetails = normalizeToolExecutionPublicDetails(value.publicDetails);
   const trustworthy = origin !== "unknown" && category !== "unknown" && typeof value.retryable === "boolean";
   return {
     schemaVersion: TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
@@ -430,7 +461,8 @@ function normalizeToolExecutionFailure(value) {
     requestId: boundedString(value.requestId),
     retryAfterMs: finiteNonNegativeInteger(value.retryAfterMs),
     networkKind: normalizeNetworkKind(value.networkKind),
-    networkScope: normalizeNetworkScope(value.networkScope)
+    networkScope: normalizeNetworkScope(value.networkScope),
+    ...publicDetails ? { publicDetails } : {}
   };
 }
 function serializeToolExecutionFailure(error) {
@@ -448,7 +480,8 @@ function serializeToolExecutionFailure(error) {
     requestId: error.requestId,
     retryAfterMs: error.retryAfterMs,
     networkKind: error.networkKind,
-    networkScope: error.networkScope
+    networkScope: error.networkScope,
+    publicDetails: error.publicDetails
   });
 }
 function deserializeToolExecutionFailure(message, value, acceptedSchemaVersion) {
@@ -506,6 +539,8 @@ var ToolRateLimitError = class extends RateLimitError {
   networkKind;
   /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Explicitly allowlisted diagnostics safe for SDK callers. */
+  publicDetails;
   /** Constructed by the SDK after a structured tool HTTP 429. */
   constructor(message, options) {
     super(options.retryAfterMs ?? 5e3, message);
@@ -521,6 +556,7 @@ var ToolRateLimitError = class extends RateLimitError {
     this.requestId = options.requestId;
     this.networkKind = options.networkKind;
     this.networkScope = options.networkScope;
+    this.publicDetails = options.publicDetails ?? null;
     this.details = options.details;
     brandAsToolExecutionError(this);
     if (isProviderTransientFailure(this)) {
@@ -1029,7 +1065,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.46",
+  version: "0.3.48",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1918,7 +1954,7 @@ var HttpClient = class {
           body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
           signal: options?.signal
         });
-        if (!response.ok) {
+        if (!response.ok || response.status === 202) {
           const body = await response.text();
           const parsed = parseResponseBody(body);
           if (response.status === 401 && !isProviderOriginatedHttpError(parsed)) {
@@ -5647,12 +5683,26 @@ var DeeplineClient = class {
     const headers = options?.lastEventId && options.lastEventId.trim() ? { "Last-Event-ID": options.lastEventId.trim() } : void 0;
     const params = new URLSearchParams();
     params.set("mode", options?.mode ?? "cli");
-    for await (const event of this.http.streamSse(
-      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
-      { signal: options?.signal, headers }
-    )) {
-      if (event.scope === "play") {
-        yield event;
+    const projectionDeadline = Date.now() + 3e4;
+    let projectionAttempt = 0;
+    for (; ; ) {
+      let sawEvent = false;
+      try {
+        for await (const event of this.http.streamSse(
+          `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
+          { signal: options?.signal, headers }
+        )) {
+          sawEvent = true;
+          if (event.scope === "play") {
+            yield event;
+          }
+        }
+        return;
+      } catch (error) {
+        const projectionPending = options?.waitForProjection === true && !sawEvent && error instanceof DeeplineError && (error.statusCode === 404 || error.statusCode === 202 && error.code === "RUN_PROJECTION_PENDING") && Date.now() < projectionDeadline;
+        if (!projectionPending) throw error;
+        await sleep2(streamReconnectDelayMs(projectionAttempt));
+        projectionAttempt += 1;
       }
     }
   }
@@ -6681,7 +6731,8 @@ var DeeplineClient = class {
     }
     for await (const event of this.streamPlayRunEvents(workflowId, {
       mode: "cli",
-      signal: options?.signal
+      signal: options?.signal,
+      waitForProjection: true
     })) {
       if (options?.signal?.aborted) {
         await this.cancelPlay(workflowId);
@@ -20791,7 +20842,7 @@ async function waitForPlayCompletionByStream(input2) {
     try {
       for await (const event of input2.client.streamPlayRunEvents(
         input2.workflowId,
-        { signal: controller.signal }
+        { signal: controller.signal, waitForProjection: true }
       )) {
         sawEvent = true;
         const terminal = await handleLiveEvent(event);
@@ -32374,6 +32425,7 @@ async function handleFeedback(text, options) {
   const { http } = getAuthedHttpClient();
   const response = await http.post("/api/v2/cli/feedback", {
     text,
+    requested: options.requested === true,
     environment: collectLocalEnvInfo(),
     ...options.command ? { command: options.command } : {},
     ...options.payload ? { payload: options.payload } : {}
@@ -32397,6 +32449,7 @@ function registerFeedbackCommands(program) {
 Notes:
   Sends the feedback text plus local CLI environment info to Deepline support.
   Use --command and --payload to attach a reproducible command shape.
+  Agents should pass --requested when the user asked them to submit the report.
 
 Examples:
   deepline feedback send "plays run failed after upload" --command "deepline plays run my.play.ts --watch"
@@ -32408,9 +32461,13 @@ Examples:
     `
 Examples:
   deepline feedback send "tools search returned stale results" --json
+  deepline feedback send "tools search returned stale results" --requested --json
   deepline feedback send "plays run failed after upload" --command "deepline plays run my.play.ts --watch"
 `
-  ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option("--json", "Emit JSON output").action(handleFeedback);
+  ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option(
+    "--requested",
+    "Mark the report as explicitly requested by the user"
+  ).option("--json", "Emit JSON output").action(handleFeedback);
 }
 
 // src/cli/commands/sessions.ts

package/dist/{compiler-manifest-BuoqasqI.d.mts → compiler-manifest-CbzdZrJj.d.mts}

@@ -42,6 +42,14 @@ type ToolExecutionNetworkKind = 'timeout' | 'dns' | 'connect' | 'reset' | 'unava
  * @sdkReference errors 050
  */
 type ToolExecutionNetworkScope = 'client_to_deepline' | 'runtime_to_deepline' | 'deepline_to_provider';
+/**
+ * Bounded, primitive-only diagnostics explicitly approved for customers.
+ * Raw provider bodies, credentials, prompts, stacks, and causes never belong
+ * in this shared API/SDK/Play contract.
+ *
+ * @sdkReference errors 063
+ */
+type ToolExecutionPublicDetails = Readonly<Record<string, string | number | boolean | null>>;
 /**
  * Portable version-1 `tool_error` payload.
  *
@@ -78,6 +86,8 @@ type ToolExecutionFailureV1 = {
     networkKind: ToolExecutionNetworkKind | null;
     /** Network boundary that failed, or `null`. */
     networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted customer diagnostics, when present. */
+    publicDetails?: ToolExecutionPublicDetails | null;
 };
 /**
  * Constructor input for a structured tool failure.
@@ -170,6 +180,8 @@ declare class ToolExecutionError extends DeeplineError {
     readonly networkKind: ToolExecutionNetworkKind | null;
     /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
+    readonly publicDetails: ToolExecutionPublicDetails | null;
     /**
      * Construct a structured tool error.
      *
@@ -2941,4 +2953,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { PHONE_STATUS_VALUES as $, type PlayAuthoringCallExecution as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, DeeplineError as D, type PlayAuthoringInputContract as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, type PlayArtifactKind as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DEEPLINE_EXTRACTOR_TARGETS as S, ToolExecutionError as T, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as U, type DeeplineEmailStatusGetterValue as V, type DeeplineExtractorTarget as W, type DeeplineGetterValue as X, type DeeplineGetterValueMap as Y, JOB_CHANGE_STATUS_VALUES as Z, type JobChangeStatus as _, type PlayBundleArtifact as a, type PhoneStatus as a0, type PlayDataset as a1, type PlayDatasetInput as a2, type PreviousCell as a3, ProviderTransientError as a4, type ProviderTransientErrorCategory as a5, type ProviderUnavailableError as a6, type ProviderUnavailableReason as a7, type ToolExecutionErrorCategory as a8, type ToolExecutionErrorOrigin as a9, type ToolExecutionFailureV1 as aa, type ToolExecutionNetworkKind as ab, type ToolExecutionNetworkScope as ac, getProviderUnavailableReason as ad, isDeeplineExtractorTarget as ae, isProviderUnavailable as af, isProviderWaterfallUnavailableError as ag, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature as h, type ToolExecutionErrorOptions as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type ToolExecuteResult as s, type PlayAuthoringReferenceLike as t, type PlayReturnObject as u, type PlayAuthoringDefineConfig as v, type PlayAuthoringDefinedPlay as w, type PlayAuthoringFetchOptions as x, type PlayAuthoringFileInput as y, type PlayAuthoringBindings as z };
+export { PHONE_STATUS_VALUES as $, type PlayAuthoringCallExecution as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, DeeplineError as D, type PlayAuthoringInputContract as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, type PlayArtifactKind as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DEEPLINE_EXTRACTOR_TARGETS as S, ToolExecutionError as T, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as U, type DeeplineEmailStatusGetterValue as V, type DeeplineExtractorTarget as W, type DeeplineGetterValue as X, type DeeplineGetterValueMap as Y, JOB_CHANGE_STATUS_VALUES as Z, type JobChangeStatus as _, type PlayBundleArtifact as a, type PhoneStatus as a0, type PlayDataset as a1, type PlayDatasetInput as a2, type PreviousCell as a3, ProviderTransientError as a4, type ProviderTransientErrorCategory as a5, type ProviderUnavailableError as a6, type ProviderUnavailableReason as a7, type ToolExecutionErrorCategory as a8, type ToolExecutionErrorOrigin as a9, type ToolExecutionFailureV1 as aa, type ToolExecutionNetworkKind as ab, type ToolExecutionNetworkScope as ac, type ToolExecutionPublicDetails as ad, getProviderUnavailableReason as ae, isDeeplineExtractorTarget as af, isProviderUnavailable as ag, isProviderWaterfallUnavailableError as ah, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature as h, type ToolExecutionErrorOptions as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type ToolExecuteResult as s, type PlayAuthoringReferenceLike as t, type PlayReturnObject as u, type PlayAuthoringDefineConfig as v, type PlayAuthoringDefinedPlay as w, type PlayAuthoringFetchOptions as x, type PlayAuthoringFileInput as y, type PlayAuthoringBindings as z };

package/dist/{compiler-manifest-BuoqasqI.d.ts → compiler-manifest-CbzdZrJj.d.ts}

@@ -42,6 +42,14 @@ type ToolExecutionNetworkKind = 'timeout' | 'dns' | 'connect' | 'reset' | 'unava
  * @sdkReference errors 050
  */
 type ToolExecutionNetworkScope = 'client_to_deepline' | 'runtime_to_deepline' | 'deepline_to_provider';
+/**
+ * Bounded, primitive-only diagnostics explicitly approved for customers.
+ * Raw provider bodies, credentials, prompts, stacks, and causes never belong
+ * in this shared API/SDK/Play contract.
+ *
+ * @sdkReference errors 063
+ */
+type ToolExecutionPublicDetails = Readonly<Record<string, string | number | boolean | null>>;
 /**
  * Portable version-1 `tool_error` payload.
  *
@@ -78,6 +86,8 @@ type ToolExecutionFailureV1 = {
     networkKind: ToolExecutionNetworkKind | null;
     /** Network boundary that failed, or `null`. */
     networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted customer diagnostics, when present. */
+    publicDetails?: ToolExecutionPublicDetails | null;
 };
 /**
  * Constructor input for a structured tool failure.
@@ -170,6 +180,8 @@ declare class ToolExecutionError extends DeeplineError {
     readonly networkKind: ToolExecutionNetworkKind | null;
     /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionNetworkScope | null;
+    /** Explicitly allowlisted diagnostics safe for SDK and Play callers. */
+    readonly publicDetails: ToolExecutionPublicDetails | null;
     /**
      * Construct a structured tool error.
      *
@@ -2941,4 +2953,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { PHONE_STATUS_VALUES as $, type PlayAuthoringCallExecution as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, DeeplineError as D, type PlayAuthoringInputContract as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, type PlayArtifactKind as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DEEPLINE_EXTRACTOR_TARGETS as S, ToolExecutionError as T, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as U, type DeeplineEmailStatusGetterValue as V, type DeeplineExtractorTarget as W, type DeeplineGetterValue as X, type DeeplineGetterValueMap as Y, JOB_CHANGE_STATUS_VALUES as Z, type JobChangeStatus as _, type PlayBundleArtifact as a, type PhoneStatus as a0, type PlayDataset as a1, type PlayDatasetInput as a2, type PreviousCell as a3, ProviderTransientError as a4, type ProviderTransientErrorCategory as a5, type ProviderUnavailableError as a6, type ProviderUnavailableReason as a7, type ToolExecutionErrorCategory as a8, type ToolExecutionErrorOrigin as a9, type ToolExecutionFailureV1 as aa, type ToolExecutionNetworkKind as ab, type ToolExecutionNetworkScope as ac, getProviderUnavailableReason as ad, isDeeplineExtractorTarget as ae, isProviderUnavailable as af, isProviderWaterfallUnavailableError as ag, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature as h, type ToolExecutionErrorOptions as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type ToolExecuteResult as s, type PlayAuthoringReferenceLike as t, type PlayReturnObject as u, type PlayAuthoringDefineConfig as v, type PlayAuthoringDefinedPlay as w, type PlayAuthoringFetchOptions as x, type PlayAuthoringFileInput as y, type PlayAuthoringBindings as z };
+export { PHONE_STATUS_VALUES as $, type PlayAuthoringCallExecution as A, type PlayAuthoringCallOptions as B, type PlayAuthoringFetchResponse as C, DeeplineError as D, type PlayAuthoringInputContract as E, type PlayAuthoringStepProgramStep as F, type PlayAuthoringRuntimeStepOptions as G, type PlaySqlListenerDeclaration as H, type PlaySqlListenerEvent as I, type PlaySqlListenerOperation as J, type PlaySqlQuery as K, type PlayAuthoringStepOptions as L, type PlayAuthoringStepProgram as M, type PlayAuthoringStepProgramResolver as N, type PlayAuthoringStepResolver as O, type PlayArtifactKind as P, type PlayToolExecutionRequest as Q, type PlayAuthoringStepProgramOptions as R, DEEPLINE_EXTRACTOR_TARGETS as S, ToolExecutionError as T, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as U, type DeeplineEmailStatusGetterValue as V, type DeeplineExtractorTarget as W, type DeeplineGetterValue as X, type DeeplineGetterValueMap as Y, JOB_CHANGE_STATUS_VALUES as Z, type JobChangeStatus as _, type PlayBundleArtifact as a, type PhoneStatus as a0, type PlayDataset as a1, type PlayDatasetInput as a2, type PreviousCell as a3, ProviderTransientError as a4, type ProviderTransientErrorCategory as a5, type ProviderUnavailableError as a6, type ProviderUnavailableReason as a7, type ToolExecutionErrorCategory as a8, type ToolExecutionErrorOrigin as a9, type ToolExecutionFailureV1 as aa, type ToolExecutionNetworkKind as ab, type ToolExecutionNetworkScope as ac, type ToolExecutionPublicDetails as ad, getProviderUnavailableReason as ae, isDeeplineExtractorTarget as af, isProviderUnavailable as ag, isProviderWaterfallUnavailableError as ah, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayArtifactCompatibility as e, type PlayImportPolicy as f, type PlayPackageImport as g, type PlayRuntimeFeature as h, type ToolExecutionErrorOptions as i, type PlayAuthoringColumnMap as j, type PlayAuthoringColumnResolver as k, type PlayAuthoringRuntimeContext as l, type PlayAuthoringConditionalStepResolver as m, type PlayAuthoringCsvInput as n, type PlayAuthoringCsvOptions as o, type PlayAuthoringDatasetBuilder as p, type PlayAuthoringDatasetColumnDefinition as q, type PlayAuthoringDatasetColumnRunInput as r, type ToolExecuteResult as s, type PlayAuthoringReferenceLike as t, type PlayReturnObject as u, type PlayAuthoringDefineConfig as v, type PlayAuthoringDefinedPlay as w, type PlayAuthoringFetchOptions as x, type PlayAuthoringFileInput as y, type PlayAuthoringBindings as z };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, D as DeeplineError, T as ToolExecutionError, i as ToolExecutionErrorOptions, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as ToolExecuteResult, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringBindings, A as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions } from './compiler-manifest-BuoqasqI.mjs';
-export { S as DEEPLINE_EXTRACTOR_TARGETS, U as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, V as DeeplineEmailStatusGetterValue, W as DeeplineExtractorTarget, X as DeeplineGetterValue, Y as DeeplineGetterValueMap, Z as JOB_CHANGE_STATUS_VALUES, _ as JobChangeStatus, $ as PHONE_STATUS_VALUES, a0 as PhoneStatus, a1 as PlayDataset, a2 as PlayDatasetInput, a3 as PreviousCell, a4 as ProviderTransientError, a5 as ProviderTransientErrorCategory, a6 as ProviderUnavailableError, a7 as ProviderUnavailableReason, a8 as ToolExecutionErrorCategory, a9 as ToolExecutionErrorOrigin, aa as ToolExecutionFailureV1, ab as ToolExecutionNetworkKind, ac as ToolExecutionNetworkScope, ad as getProviderUnavailableReason, ae as isDeeplineExtractorTarget, af as isProviderUnavailable, ag as isProviderWaterfallUnavailableError } from './compiler-manifest-BuoqasqI.mjs';
+import { c as PlayCompilerManifest, D as DeeplineError, T as ToolExecutionError, i as ToolExecutionErrorOptions, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as ToolExecuteResult, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringBindings, A as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions } from './compiler-manifest-CbzdZrJj.mjs';
+export { S as DEEPLINE_EXTRACTOR_TARGETS, U as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, V as DeeplineEmailStatusGetterValue, W as DeeplineExtractorTarget, X as DeeplineGetterValue, Y as DeeplineGetterValueMap, Z as JOB_CHANGE_STATUS_VALUES, _ as JobChangeStatus, $ as PHONE_STATUS_VALUES, a0 as PhoneStatus, a1 as PlayDataset, a2 as PlayDatasetInput, a3 as PreviousCell, a4 as ProviderTransientError, a5 as ProviderTransientErrorCategory, a6 as ProviderUnavailableError, a7 as ProviderUnavailableReason, a8 as ToolExecutionErrorCategory, a9 as ToolExecutionErrorOrigin, aa as ToolExecutionFailureV1, ab as ToolExecutionNetworkKind, ac as ToolExecutionNetworkScope, ad as ToolExecutionPublicDetails, ae as getProviderUnavailableReason, af as isDeeplineExtractorTarget, ag as isProviderUnavailable, ah as isProviderWaterfallUnavailableError } from './compiler-manifest-CbzdZrJj.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -3213,6 +3213,14 @@ declare class DeeplineClient {
         signal?: AbortSignal;
         lastEventId?: string;
         mode?: 'cli' | 'ui';
+        /**
+         * A run just accepted by durable scheduler admission can take a short
+         * time to appear in the asynchronous Convex read model. Callers that
+         * received that admission may opt into a bounded retry of the initial
+         * pending response; a normal arbitrary run id still fails loudly by
+         * default.
+         */
+        waitForProjection?: boolean;
     }): AsyncGenerator<PlayLiveEvent>;
     /**
      * Cancel a running play execution.
@@ -3949,6 +3957,8 @@ declare class ToolRateLimitError extends RateLimitError {
     readonly networkKind: ToolExecutionError['networkKind'];
     /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionError['networkScope'];
+    /** Explicitly allowlisted diagnostics safe for SDK callers. */
+    readonly publicDetails: ToolExecutionError['publicDetails'];
     /** Constructed by the SDK after a structured tool HTTP 429. */
     constructor(message: string, options: ToolExecutionErrorOptions);
 }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, D as DeeplineError, T as ToolExecutionError, i as ToolExecutionErrorOptions, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as ToolExecuteResult, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringBindings, A as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions } from './compiler-manifest-BuoqasqI.js';
-export { S as DEEPLINE_EXTRACTOR_TARGETS, U as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, V as DeeplineEmailStatusGetterValue, W as DeeplineExtractorTarget, X as DeeplineGetterValue, Y as DeeplineGetterValueMap, Z as JOB_CHANGE_STATUS_VALUES, _ as JobChangeStatus, $ as PHONE_STATUS_VALUES, a0 as PhoneStatus, a1 as PlayDataset, a2 as PlayDatasetInput, a3 as PreviousCell, a4 as ProviderTransientError, a5 as ProviderTransientErrorCategory, a6 as ProviderUnavailableError, a7 as ProviderUnavailableReason, a8 as ToolExecutionErrorCategory, a9 as ToolExecutionErrorOrigin, aa as ToolExecutionFailureV1, ab as ToolExecutionNetworkKind, ac as ToolExecutionNetworkScope, ad as getProviderUnavailableReason, ae as isDeeplineExtractorTarget, af as isProviderUnavailable, ag as isProviderWaterfallUnavailableError } from './compiler-manifest-BuoqasqI.js';
+import { c as PlayCompilerManifest, D as DeeplineError, T as ToolExecutionError, i as ToolExecutionErrorOptions, j as PlayAuthoringColumnMap, k as PlayAuthoringColumnResolver, l as PlayAuthoringRuntimeContext, m as PlayAuthoringConditionalStepResolver, n as PlayAuthoringCsvInput, o as PlayAuthoringCsvOptions, p as PlayAuthoringDatasetBuilder, q as PlayAuthoringDatasetColumnDefinition, r as PlayAuthoringDatasetColumnRunInput, s as ToolExecuteResult, t as PlayAuthoringReferenceLike, u as PlayReturnObject$1, v as PlayAuthoringDefineConfig, w as PlayAuthoringDefinedPlay, x as PlayAuthoringFetchOptions, y as PlayAuthoringFileInput, z as PlayAuthoringBindings, A as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions } from './compiler-manifest-CbzdZrJj.js';
+export { S as DEEPLINE_EXTRACTOR_TARGETS, U as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, V as DeeplineEmailStatusGetterValue, W as DeeplineExtractorTarget, X as DeeplineGetterValue, Y as DeeplineGetterValueMap, Z as JOB_CHANGE_STATUS_VALUES, _ as JobChangeStatus, $ as PHONE_STATUS_VALUES, a0 as PhoneStatus, a1 as PlayDataset, a2 as PlayDatasetInput, a3 as PreviousCell, a4 as ProviderTransientError, a5 as ProviderTransientErrorCategory, a6 as ProviderUnavailableError, a7 as ProviderUnavailableReason, a8 as ToolExecutionErrorCategory, a9 as ToolExecutionErrorOrigin, aa as ToolExecutionFailureV1, ab as ToolExecutionNetworkKind, ac as ToolExecutionNetworkScope, ad as ToolExecutionPublicDetails, ae as getProviderUnavailableReason, af as isDeeplineExtractorTarget, ag as isProviderUnavailable, ah as isProviderWaterfallUnavailableError } from './compiler-manifest-CbzdZrJj.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -3213,6 +3213,14 @@ declare class DeeplineClient {
         signal?: AbortSignal;
         lastEventId?: string;
         mode?: 'cli' | 'ui';
+        /**
+         * A run just accepted by durable scheduler admission can take a short
+         * time to appear in the asynchronous Convex read model. Callers that
+         * received that admission may opt into a bounded retry of the initial
+         * pending response; a normal arbitrary run id still fails loudly by
+         * default.
+         */
+        waitForProjection?: boolean;
     }): AsyncGenerator<PlayLiveEvent>;
     /**
      * Cancel a running play execution.
@@ -3949,6 +3957,8 @@ declare class ToolRateLimitError extends RateLimitError {
     readonly networkKind: ToolExecutionError['networkKind'];
     /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionError['networkScope'];
+    /** Explicitly allowlisted diagnostics safe for SDK callers. */
+    readonly publicDetails: ToolExecutionError['publicDetails'];
     /** Constructed by the SDK after a structured tool HTTP 429. */
     constructor(message: string, options: ToolExecutionErrorOptions);
 }