deepline 0.3.46 → 0.3.48

package/dist/index.js

@@ -175,6 +175,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.
    *
@@ -199,6 +201,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);
@@ -324,6 +327,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;
@@ -337,6 +367,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,
@@ -351,7 +382,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) {
@@ -369,7 +401,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) {
@@ -427,6 +460,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);
@@ -442,6 +477,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)) {
@@ -779,7 +815,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
@@ -1659,7 +1695,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)) {
@@ -5363,12 +5399,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;
       }
     }
   }
@@ -6397,7 +6447,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);

package/dist/index.mjs

@@ -98,6 +98,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.
    *
@@ -122,6 +124,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);
@@ -247,6 +250,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;
@@ -260,6 +290,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,
@@ -274,7 +305,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) {
@@ -292,7 +324,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) {
@@ -350,6 +383,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);
@@ -365,6 +400,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)) {
@@ -702,7 +738,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
@@ -1582,7 +1618,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)) {
@@ -5286,12 +5322,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;
       }
     }
   }
@@ -6320,7 +6370,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);

package/dist/install-integrity.json

@@ -257,8 +257,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-BuoqasqI.d.mts",
-    "dist/compiler-manifest-BuoqasqI.d.ts",
+    "dist/compiler-manifest-CbzdZrJj.d.mts",
+    "dist/compiler-manifest-CbzdZrJj.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-BuoqasqI.mjs';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BuoqasqI.mjs';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CbzdZrJj.mjs';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-CbzdZrJj.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-BuoqasqI.js';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BuoqasqI.js';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CbzdZrJj.js';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-CbzdZrJj.js';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.46",
+  "version": "0.3.48",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",