deepline 0.1.101 → 0.1.103

package/dist/index.d.mts

@@ -978,7 +978,7 @@ interface ClearPlayHistoryResult {
  * Response from starting a play run.
  *
  * Internal/advanced payload returned by low-level play submission primitives.
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
  * or {@link PlayJob.get}.
  *
  * @example
@@ -1042,7 +1042,7 @@ interface PlayCheckToolGetterHint {
  * Request body for starting a play run via {@link DeeplineClient.startPlayRun}.
  *
  * Internal/advanced request shape for low-level submission primitives.
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
  * or {@link Deepline.connect}.
  *
  * Either `name` (for live plays) or `artifactStorageKey` (for packaged ad hoc runs) is required.
@@ -1505,7 +1505,7 @@ declare class DeeplineClient {
      * or {@link runPlay}.
      *
      * Supported invocation surfaces intentionally share this same run contract:
-     * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
+     * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
      * SDK context calls like `Deepline.connect().play(name).run()`, and direct
      * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
      * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1625,7 +1625,7 @@ declare class DeeplineClient {
      *
      * Unlike {@link registerPlayArtifact}, this does not store the artifact,
      * publish a revision, or start a run. It is the authoritative cloud validation
-     * path used by `deepline play check`.
+     * path used by `deepline plays check`.
      */
     checkPlayArtifact(input: {
         name?: string;
@@ -1750,7 +1750,7 @@ declare class DeeplineClient {
      * Get the current status of a play execution.
      *
      * Internal/advanced primitive. Public callers should usually prefer
-     * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
+     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
      *
      * @param workflowId - Play-run id from {@link startPlayRun}
      * @returns Current status with progress logs and partial results
@@ -3261,7 +3261,7 @@ interface DeeplinePlayRuntimeContext {
  * Provides methods to check status, stream logs, wait for completion,
  * or cancel the execution.
  *
- * This handle is the SDK-context equivalent of `deepline play run --watch` and
+ * This handle is the SDK-context equivalent of `deepline plays run --watch` and
  * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
  * the completed user output through `PlayJob.get()` or the status endpoint's
  * `result` field. Runtime logs are available from `status().progress.logs` and

package/dist/index.d.ts

@@ -978,7 +978,7 @@ interface ClearPlayHistoryResult {
  * Response from starting a play run.
  *
  * Internal/advanced payload returned by low-level play submission primitives.
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
  * or {@link PlayJob.get}.
  *
  * @example
@@ -1042,7 +1042,7 @@ interface PlayCheckToolGetterHint {
  * Request body for starting a play run via {@link DeeplineClient.startPlayRun}.
  *
  * Internal/advanced request shape for low-level submission primitives.
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
  * or {@link Deepline.connect}.
  *
  * Either `name` (for live plays) or `artifactStorageKey` (for packaged ad hoc runs) is required.
@@ -1505,7 +1505,7 @@ declare class DeeplineClient {
      * or {@link runPlay}.
      *
      * Supported invocation surfaces intentionally share this same run contract:
-     * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
+     * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
      * SDK context calls like `Deepline.connect().play(name).run()`, and direct
      * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
      * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1625,7 +1625,7 @@ declare class DeeplineClient {
      *
      * Unlike {@link registerPlayArtifact}, this does not store the artifact,
      * publish a revision, or start a run. It is the authoritative cloud validation
-     * path used by `deepline play check`.
+     * path used by `deepline plays check`.
      */
     checkPlayArtifact(input: {
         name?: string;
@@ -1750,7 +1750,7 @@ declare class DeeplineClient {
      * Get the current status of a play execution.
      *
      * Internal/advanced primitive. Public callers should usually prefer
-     * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
+     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
      *
      * @param workflowId - Play-run id from {@link startPlayRun}
      * @returns Current status with progress logs and partial results
@@ -3261,7 +3261,7 @@ interface DeeplinePlayRuntimeContext {
  * Provides methods to check status, stream logs, wait for completion,
  * or cancel the execution.
  *
- * This handle is the SDK-context equivalent of `deepline play run --watch` and
+ * This handle is the SDK-context equivalent of `deepline plays run --watch` and
  * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
  * the completed user output through `PlayJob.get()` or the status endpoint's
  * `result` field. Runtime logs are available from `status().progress.logs` and

package/dist/index.js

@@ -261,10 +261,15 @@ var SDK_RELEASE = {
   // 0.1.98 ships the duplicate-browser-tab fix (default-browser detection).
   // 0.1.99 ships prebuilt job-change source-column preservation and validation fixes.
   // 0.1.101 ships retryable play artifact publish failures and CI retry hardening.
-  version: "0.1.101",
+  // 0.1.102 ships the job-change ledger fixes: recovered-dataset export on
+  // failed runs, persisted/succeeded/failed row counts, strict local CSV
+  // preflight (existence, data rows, quotes, duplicate headers), HTML error
+  // scrubbing, and word-boundary watch truncation.
+  // 0.1.103 ships the refined SDK CLI command surface.
+  version: "0.1.103",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.101",
+    latest: "0.1.103",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -415,6 +420,22 @@ var HttpClient = class {
             parsed = body;
           }
           if (!response.ok) {
+            const htmlError = detectHtmlErrorBody(
+              body,
+              response.headers.get("content-type")
+            );
+            if (htmlError) {
+              throw new DeeplineError(
+                htmlError.message(response.status),
+                response.status,
+                "API_ERROR",
+                {
+                  htmlErrorPage: true,
+                  ...htmlError.title ? { title: htmlError.title } : {},
+                  ...htmlError.workerThrewException ? { workerThrewException: true } : {}
+                }
+              );
+            }
             const errorValue = typeof parsed === "object" && parsed && "error" in parsed ? parsed.error : void 0;
             const msg = typeof errorValue === "string" ? errorValue : errorValue && typeof errorValue === "object" && "message" in errorValue && typeof errorValue.message === "string" ? errorValue.message : typeof parsed === "object" && parsed && "message" in parsed && typeof parsed.message === "string" ? parsed.message : `HTTP ${response.status}`;
             throw new DeeplineError(msg, response.status, "API_ERROR", {
@@ -475,6 +496,22 @@ var HttpClient = class {
         }
         if (!response.ok) {
           const body = await response.text();
+          const htmlError = detectHtmlErrorBody(
+            body,
+            response.headers.get("content-type")
+          );
+          if (htmlError) {
+            throw new DeeplineError(
+              htmlError.message(response.status),
+              response.status,
+              "API_ERROR",
+              {
+                htmlErrorPage: true,
+                ...htmlError.title ? { title: htmlError.title } : {},
+                ...htmlError.workerThrewException ? { workerThrewException: true } : {}
+              }
+            );
+          }
           const parsed = parseResponseBody(body);
           throw new DeeplineError(
             apiErrorMessage(parsed, response.status),
@@ -540,6 +577,31 @@ function parseResponseBody(body) {
     return body;
   }
 }
+function detectHtmlErrorBody(body, contentType) {
+  const trimmed = body.trim();
+  const lower = trimmed.toLowerCase();
+  const isHtml = (contentType ?? "").toLowerCase().includes("text/html") || lower.startsWith("<!doctype") || lower.startsWith("<html");
+  if (!isHtml) {
+    return null;
+  }
+  const titleMatch = trimmed.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+  const title = titleMatch?.[1]?.replace(/\s+/g, " ").trim() || void 0;
+  const workerThrewException = /worker threw exception/i.test(trimmed);
+  return {
+    title,
+    workerThrewException,
+    message: (status) => {
+      const segments = [`HTTP ${status}`];
+      if (workerThrewException) {
+        segments.push("Worker threw exception");
+      }
+      if (title) {
+        segments.push(title);
+      }
+      return `${segments.join(": ")} (Cloudflare HTML error page suppressed)`;
+    }
+  };
+}
 function apiErrorMessage(parsed, status) {
   const errorValue = typeof parsed === "object" && parsed && "error" in parsed ? parsed.error : void 0;
   if (typeof errorValue === "string") {
@@ -635,7 +697,7 @@ function isTransientPlayStreamError(error) {
     return error.statusCode >= 500 && error.statusCode < 600;
   }
   const text = error instanceof Error ? error.message : String(error);
-  return /auth validation backend timed out|fetch failed|eaddrnotavail|econnreset|etimedout|eai_again|socket hang up/i.test(
+  return /auth validation backend timed out|coordinator \/submit(?:\?[^ ]*)? 5\d\d|Worker threw exception|Internal Server Error|Service Unavailable|fetch failed|eaddrnotavail|econnreset|etimedout|eai_again|socket hang up/i.test(
     text
   );
 }
@@ -867,6 +929,10 @@ function buildSnapshotFromLedger(snapshot) {
   return {
     runId: snapshot.runId,
     status: normalizePlayRunLiveStatus(snapshot.status),
+    createdAt: snapshot.createdAt ?? null,
+    startedAt: snapshot.startedAt ?? null,
+    finishedAt: snapshot.finishedAt ?? null,
+    durationMs: snapshot.durationMs ?? null,
     updatedAt: snapshot.updatedAt ?? snapshot.finishedAt ?? snapshot.startedAt ?? null,
     logs: snapshot.logTail,
     totalLogCount: snapshot.totalLogCount,
@@ -1869,7 +1935,7 @@ var DeeplineClient = class {
    * or {@link runPlay}.
    *
    * Supported invocation surfaces intentionally share this same run contract:
-   * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
+   * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
    * SDK context calls like `Deepline.connect().play(name).run()`, and direct
    * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
    * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -2038,7 +2104,7 @@ var DeeplineClient = class {
    *
    * Unlike {@link registerPlayArtifact}, this does not store the artifact,
    * publish a revision, or start a run. It is the authoritative cloud validation
-   * path used by `deepline play check`.
+   * path used by `deepline plays check`.
    */
   async checkPlayArtifact(input) {
     return this.http.post("/api/v2/plays/check", input);
@@ -2231,7 +2297,7 @@ var DeeplineClient = class {
    * Get the current status of a play execution.
    *
    * Internal/advanced primitive. Public callers should usually prefer
-   * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
+   * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
    *
    * @param workflowId - Play-run id from {@link startPlayRun}
    * @returns Current status with progress logs and partial results

package/dist/index.mjs

@@ -183,10 +183,15 @@ var SDK_RELEASE = {
   // 0.1.98 ships the duplicate-browser-tab fix (default-browser detection).
   // 0.1.99 ships prebuilt job-change source-column preservation and validation fixes.
   // 0.1.101 ships retryable play artifact publish failures and CI retry hardening.
-  version: "0.1.101",
+  // 0.1.102 ships the job-change ledger fixes: recovered-dataset export on
+  // failed runs, persisted/succeeded/failed row counts, strict local CSV
+  // preflight (existence, data rows, quotes, duplicate headers), HTML error
+  // scrubbing, and word-boundary watch truncation.
+  // 0.1.103 ships the refined SDK CLI command surface.
+  version: "0.1.103",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.101",
+    latest: "0.1.103",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -337,6 +342,22 @@ var HttpClient = class {
             parsed = body;
           }
           if (!response.ok) {
+            const htmlError = detectHtmlErrorBody(
+              body,
+              response.headers.get("content-type")
+            );
+            if (htmlError) {
+              throw new DeeplineError(
+                htmlError.message(response.status),
+                response.status,
+                "API_ERROR",
+                {
+                  htmlErrorPage: true,
+                  ...htmlError.title ? { title: htmlError.title } : {},
+                  ...htmlError.workerThrewException ? { workerThrewException: true } : {}
+                }
+              );
+            }
             const errorValue = typeof parsed === "object" && parsed && "error" in parsed ? parsed.error : void 0;
             const msg = typeof errorValue === "string" ? errorValue : errorValue && typeof errorValue === "object" && "message" in errorValue && typeof errorValue.message === "string" ? errorValue.message : typeof parsed === "object" && parsed && "message" in parsed && typeof parsed.message === "string" ? parsed.message : `HTTP ${response.status}`;
             throw new DeeplineError(msg, response.status, "API_ERROR", {
@@ -397,6 +418,22 @@ var HttpClient = class {
         }
         if (!response.ok) {
           const body = await response.text();
+          const htmlError = detectHtmlErrorBody(
+            body,
+            response.headers.get("content-type")
+          );
+          if (htmlError) {
+            throw new DeeplineError(
+              htmlError.message(response.status),
+              response.status,
+              "API_ERROR",
+              {
+                htmlErrorPage: true,
+                ...htmlError.title ? { title: htmlError.title } : {},
+                ...htmlError.workerThrewException ? { workerThrewException: true } : {}
+              }
+            );
+          }
           const parsed = parseResponseBody(body);
           throw new DeeplineError(
             apiErrorMessage(parsed, response.status),
@@ -462,6 +499,31 @@ function parseResponseBody(body) {
     return body;
   }
 }
+function detectHtmlErrorBody(body, contentType) {
+  const trimmed = body.trim();
+  const lower = trimmed.toLowerCase();
+  const isHtml = (contentType ?? "").toLowerCase().includes("text/html") || lower.startsWith("<!doctype") || lower.startsWith("<html");
+  if (!isHtml) {
+    return null;
+  }
+  const titleMatch = trimmed.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+  const title = titleMatch?.[1]?.replace(/\s+/g, " ").trim() || void 0;
+  const workerThrewException = /worker threw exception/i.test(trimmed);
+  return {
+    title,
+    workerThrewException,
+    message: (status) => {
+      const segments = [`HTTP ${status}`];
+      if (workerThrewException) {
+        segments.push("Worker threw exception");
+      }
+      if (title) {
+        segments.push(title);
+      }
+      return `${segments.join(": ")} (Cloudflare HTML error page suppressed)`;
+    }
+  };
+}
 function apiErrorMessage(parsed, status) {
   const errorValue = typeof parsed === "object" && parsed && "error" in parsed ? parsed.error : void 0;
   if (typeof errorValue === "string") {
@@ -557,7 +619,7 @@ function isTransientPlayStreamError(error) {
     return error.statusCode >= 500 && error.statusCode < 600;
   }
   const text = error instanceof Error ? error.message : String(error);
-  return /auth validation backend timed out|fetch failed|eaddrnotavail|econnreset|etimedout|eai_again|socket hang up/i.test(
+  return /auth validation backend timed out|coordinator \/submit(?:\?[^ ]*)? 5\d\d|Worker threw exception|Internal Server Error|Service Unavailable|fetch failed|eaddrnotavail|econnreset|etimedout|eai_again|socket hang up/i.test(
     text
   );
 }
@@ -789,6 +851,10 @@ function buildSnapshotFromLedger(snapshot) {
   return {
     runId: snapshot.runId,
     status: normalizePlayRunLiveStatus(snapshot.status),
+    createdAt: snapshot.createdAt ?? null,
+    startedAt: snapshot.startedAt ?? null,
+    finishedAt: snapshot.finishedAt ?? null,
+    durationMs: snapshot.durationMs ?? null,
     updatedAt: snapshot.updatedAt ?? snapshot.finishedAt ?? snapshot.startedAt ?? null,
     logs: snapshot.logTail,
     totalLogCount: snapshot.totalLogCount,
@@ -1791,7 +1857,7 @@ var DeeplineClient = class {
    * or {@link runPlay}.
    *
    * Supported invocation surfaces intentionally share this same run contract:
-   * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
+   * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
    * SDK context calls like `Deepline.connect().play(name).run()`, and direct
    * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
    * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1960,7 +2026,7 @@ var DeeplineClient = class {
    *
    * Unlike {@link registerPlayArtifact}, this does not store the artifact,
    * publish a revision, or start a run. It is the authoritative cloud validation
-   * path used by `deepline play check`.
+   * path used by `deepline plays check`.
    */
   async checkPlayArtifact(input) {
     return this.http.post("/api/v2/plays/check", input);
@@ -2153,7 +2219,7 @@ var DeeplineClient = class {
    * Get the current status of a play execution.
    *
    * Internal/advanced primitive. Public callers should usually prefer
-   * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
+   * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
    *
    * @param workflowId - Play-run id from {@link startPlayRun}
    * @returns Current status with progress logs and partial results