deepline 0.3.213 → 0.3.214

package/dist/index.js

@@ -864,7 +864,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.213",
+  version: "0.3.214",
   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
@@ -1158,6 +1158,12 @@ function readSdkSkillsLocalVersion(baseUrl) {
   }
 }
 
+// src/deployment-protection.ts
+function deploymentProtectionHeaders() {
+  const token = typeof process !== "undefined" ? process.env?.VERCEL_PROTECTION_BYPASS_TOKEN : void 0;
+  return token ? { "x-vercel-protection-bypass": token } : {};
+}
+
 // ../play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
 var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
@@ -1540,16 +1546,13 @@ var HttpClient = class {
       "X-Deepline-SDK-Version": SDK_VERSION,
       "X-Deepline-API-Contract": SDK_API_CONTRACT,
       "X-Deepline-Run-Result-Shape": "canonical",
-      ...extra
+      ...extra,
+      ...deploymentProtectionHeaders()
     };
     const skillsVersion = this.readSkillsVersionHeader();
     if (skillsVersion) {
       headers["X-Deepline-Skills-Version"] = skillsVersion;
     }
-    const bypassToken = typeof process !== "undefined" ? process.env?.VERCEL_PROTECTION_BYPASS_TOKEN : void 0;
-    if (bypassToken) {
-      headers["x-vercel-protection-bypass"] = bypassToken;
-    }
     const playArtifactR2Prefix = typeof process !== "undefined" ? process.env?.DEEPLINE_PLAY_ARTIFACT_R2_PREFIX : void 0;
     if (playArtifactR2Prefix) {
       headers["x-deepline-play-artifact-r2-prefix"] = playArtifactR2Prefix;
@@ -4722,10 +4725,19 @@ function normalizePlayStatus(raw) {
     );
   }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
+  const legacyOverview = runPackage?.overview ?? raw.overview;
+  const runStatus = runPackage?.runStatus ?? raw.runStatus;
   return {
     ...raw,
     runId,
-    ...runPackage ? { package: runPackage, outputs: runPackage.outputs } : {},
+    ...isRecord7(legacyOverview) ? {
+      overview: legacyOverview
+    } : {},
+    ...isRecord7(runStatus) ? { runStatus } : {},
+    ...runPackage ? {
+      package: runPackage,
+      outputs: runPackage.outputs
+    } : {},
     status
   };
 }
@@ -4907,18 +4919,6 @@ function playRunResultFromStatus(status, startedAt, fallbackRunId) {
     error: status.progress?.error ?? (status.status !== "completed" ? status.status : void 0)
   };
 }
-function playRunStatusFromState(state) {
-  return {
-    runId: state.runId,
-    status: state.status,
-    progress: {
-      status: state.status,
-      logs: state.logs,
-      ...state.error ? { error: state.error } : {}
-    },
-    ..."result" in state ? { result: state.result } : {}
-  };
-}
 var DeeplineClient = class _DeeplineClient {
   http;
   config;
@@ -5255,6 +5255,12 @@ var DeeplineClient = class _DeeplineClient {
       options.includeSearchDebug ? "true" : "false"
     );
     params.set("search_mode", options.searchMode ?? "v2");
+    if (options.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    if (options.offset !== void 0) {
+      params.set("offset", String(options.offset));
+    }
     if (options.categories?.trim()) {
       params.set("categories", options.categories.trim());
     }
@@ -6316,9 +6322,18 @@ var DeeplineClient = class _DeeplineClient {
     }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      `/api/v2/runs/${encodeURIComponent(runId)}${query}`
+      `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
+      { headers: { "x-deepline-run-status": "1" } }
     );
+    const responseRunStatus = isPlayRunPackage(response) ? response.runStatus : isPlayRunPackage(response.package) ? response.package.runStatus : response.runStatus;
+    const responseOverview = isPlayRunPackage(response) ? response.overview : isPlayRunPackage(response.package) ? response.package.overview : response.overview;
     const status = normalizePlayStatus(response);
+    if (isRecord7(responseRunStatus)) {
+      status.runStatus = responseRunStatus;
+    }
+    if (isRecord7(responseOverview)) {
+      status.overview = responseOverview;
+    }
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
     }
@@ -6359,7 +6374,10 @@ var DeeplineClient = class _DeeplineClient {
       }
     };
   }
-  /** Read only the bounded scalar projection; does not hydrate the run package. */
+  /** Fetch only the legacy scalar lifecycle status for a run.
+   *
+   * @deprecated Use `client.runs.get(runId)` for the canonical run read.
+   */
   async getRunLifecycleStatus(runId) {
     const response = await this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}/status`
@@ -6535,9 +6553,7 @@ var DeeplineClient = class _DeeplineClient {
       if (!status || !TERMINAL_PLAY_STATUSES.has(status.status)) {
         continue;
       }
-      return await this.getRunStatus(status.runId || runId).catch(
-        () => state.latest ?? playRunStatusFromState(state)
-      );
+      return await this.getRunStatus(status.runId || runId);
     }
     if (options?.signal?.aborted) {
       throw new DeeplineError("Run observation aborted.", void 0, "ABORTED");
@@ -6588,6 +6604,7 @@ var DeeplineClient = class _DeeplineClient {
     for (; ; ) {
       const connectedAt = Date.now();
       let sawEvent = false;
+      let terminalRunId = null;
       let endedReason = "stream window ended before a terminal event";
       try {
         for await (const event of this.streamPlayRunEvents(runId, {
@@ -6600,9 +6617,8 @@ var DeeplineClient = class _DeeplineClient {
           if (!status || !TERMINAL_PLAY_STATUSES.has(status.status)) {
             continue;
           }
-          return await this.getRunStatus(status.runId || runId).catch(
-            () => state.latest ?? playRunStatusFromState(state)
-          );
+          terminalRunId = status.runId || runId;
+          break;
         }
       } catch (error) {
         if (options?.signal?.aborted || !isTransientPlayStreamError(error)) {
@@ -6610,15 +6626,11 @@ var DeeplineClient = class _DeeplineClient {
         }
         endedReason = error instanceof Error ? error.message : String(error);
       }
-      let refreshed = null;
-      try {
-        refreshed = await this.getRunStatus(runId);
-      } catch (error) {
-        if (!isTransientPlayStreamError(error)) {
-          throw error;
-        }
+      if (terminalRunId) {
+        return await this.getRunStatus(terminalRunId);
       }
-      if (refreshed && TERMINAL_PLAY_STATUSES.has(refreshed.status)) {
+      const refreshed = await this.getRunStatus(runId);
+      if (TERMINAL_PLAY_STATUSES.has(refreshed.status)) {
         return refreshed;
       }
       if (sawEvent || Date.now() - connectedAt >= STREAM_HEALTHY_CONNECTION_MS) {
@@ -6907,6 +6919,26 @@ var DeeplineClient = class _DeeplineClient {
       hasMore: Boolean(response.pagination?.hasMore ?? response.hasMore)
     };
   }
+  /** Read definition-level settings, independently of code revisions. */
+  async getPlaySettings(playName) {
+    return this.http.get(
+      `/api/v2/plays/${encodeURIComponent(playName)}/settings`
+    );
+  }
+  /** Retry-safe field patch; omitted fields retain their current value. */
+  async updatePlaySettings(playName, patch) {
+    return this.http.patch(
+      `/api/v2/plays/${encodeURIComponent(playName)}/settings`,
+      patch
+    );
+  }
+  /** List one bounded page of existing Play locations; continue with cursor. */
+  async listPlaySettingsPaths(options = {}) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(options))
+      if (value !== void 0) query.set(key, String(value));
+    return this.http.get(`/api/v2/plays/settings/paths?${query}`);
+  }
   /** Set whether an org-owned Play sorts before unpinned Plays. */
   async setPlayPinned(playName, pinned) {
     return this.http.post(`/api/v2/plays/${encodeURIComponent(playName)}/pin`, {

package/dist/index.mjs

@@ -768,7 +768,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.213",
+  version: "0.3.214",
   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
@@ -1062,6 +1062,12 @@ function readSdkSkillsLocalVersion(baseUrl) {
   }
 }
 
+// src/deployment-protection.ts
+function deploymentProtectionHeaders() {
+  const token = typeof process !== "undefined" ? process.env?.VERCEL_PROTECTION_BYPASS_TOKEN : void 0;
+  return token ? { "x-vercel-protection-bypass": token } : {};
+}
+
 // ../play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
 var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
@@ -1444,16 +1450,13 @@ var HttpClient = class {
       "X-Deepline-SDK-Version": SDK_VERSION,
       "X-Deepline-API-Contract": SDK_API_CONTRACT,
       "X-Deepline-Run-Result-Shape": "canonical",
-      ...extra
+      ...extra,
+      ...deploymentProtectionHeaders()
     };
     const skillsVersion = this.readSkillsVersionHeader();
     if (skillsVersion) {
       headers["X-Deepline-Skills-Version"] = skillsVersion;
     }
-    const bypassToken = typeof process !== "undefined" ? process.env?.VERCEL_PROTECTION_BYPASS_TOKEN : void 0;
-    if (bypassToken) {
-      headers["x-vercel-protection-bypass"] = bypassToken;
-    }
     const playArtifactR2Prefix = typeof process !== "undefined" ? process.env?.DEEPLINE_PLAY_ARTIFACT_R2_PREFIX : void 0;
     if (playArtifactR2Prefix) {
       headers["x-deepline-play-artifact-r2-prefix"] = playArtifactR2Prefix;
@@ -4626,10 +4629,19 @@ function normalizePlayStatus(raw) {
     );
   }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
+  const legacyOverview = runPackage?.overview ?? raw.overview;
+  const runStatus = runPackage?.runStatus ?? raw.runStatus;
   return {
     ...raw,
     runId,
-    ...runPackage ? { package: runPackage, outputs: runPackage.outputs } : {},
+    ...isRecord7(legacyOverview) ? {
+      overview: legacyOverview
+    } : {},
+    ...isRecord7(runStatus) ? { runStatus } : {},
+    ...runPackage ? {
+      package: runPackage,
+      outputs: runPackage.outputs
+    } : {},
     status
   };
 }
@@ -4811,18 +4823,6 @@ function playRunResultFromStatus(status, startedAt, fallbackRunId) {
     error: status.progress?.error ?? (status.status !== "completed" ? status.status : void 0)
   };
 }
-function playRunStatusFromState(state) {
-  return {
-    runId: state.runId,
-    status: state.status,
-    progress: {
-      status: state.status,
-      logs: state.logs,
-      ...state.error ? { error: state.error } : {}
-    },
-    ..."result" in state ? { result: state.result } : {}
-  };
-}
 var DeeplineClient = class _DeeplineClient {
   http;
   config;
@@ -5159,6 +5159,12 @@ var DeeplineClient = class _DeeplineClient {
       options.includeSearchDebug ? "true" : "false"
     );
     params.set("search_mode", options.searchMode ?? "v2");
+    if (options.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    if (options.offset !== void 0) {
+      params.set("offset", String(options.offset));
+    }
     if (options.categories?.trim()) {
       params.set("categories", options.categories.trim());
     }
@@ -6220,9 +6226,18 @@ var DeeplineClient = class _DeeplineClient {
     }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      `/api/v2/runs/${encodeURIComponent(runId)}${query}`
+      `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
+      { headers: { "x-deepline-run-status": "1" } }
     );
+    const responseRunStatus = isPlayRunPackage(response) ? response.runStatus : isPlayRunPackage(response.package) ? response.package.runStatus : response.runStatus;
+    const responseOverview = isPlayRunPackage(response) ? response.overview : isPlayRunPackage(response.package) ? response.package.overview : response.overview;
     const status = normalizePlayStatus(response);
+    if (isRecord7(responseRunStatus)) {
+      status.runStatus = responseRunStatus;
+    }
+    if (isRecord7(responseOverview)) {
+      status.overview = responseOverview;
+    }
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
     }
@@ -6263,7 +6278,10 @@ var DeeplineClient = class _DeeplineClient {
       }
     };
   }
-  /** Read only the bounded scalar projection; does not hydrate the run package. */
+  /** Fetch only the legacy scalar lifecycle status for a run.
+   *
+   * @deprecated Use `client.runs.get(runId)` for the canonical run read.
+   */
   async getRunLifecycleStatus(runId) {
     const response = await this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}/status`
@@ -6439,9 +6457,7 @@ var DeeplineClient = class _DeeplineClient {
       if (!status || !TERMINAL_PLAY_STATUSES.has(status.status)) {
         continue;
       }
-      return await this.getRunStatus(status.runId || runId).catch(
-        () => state.latest ?? playRunStatusFromState(state)
-      );
+      return await this.getRunStatus(status.runId || runId);
     }
     if (options?.signal?.aborted) {
       throw new DeeplineError("Run observation aborted.", void 0, "ABORTED");
@@ -6492,6 +6508,7 @@ var DeeplineClient = class _DeeplineClient {
     for (; ; ) {
       const connectedAt = Date.now();
       let sawEvent = false;
+      let terminalRunId = null;
       let endedReason = "stream window ended before a terminal event";
       try {
         for await (const event of this.streamPlayRunEvents(runId, {
@@ -6504,9 +6521,8 @@ var DeeplineClient = class _DeeplineClient {
           if (!status || !TERMINAL_PLAY_STATUSES.has(status.status)) {
             continue;
           }
-          return await this.getRunStatus(status.runId || runId).catch(
-            () => state.latest ?? playRunStatusFromState(state)
-          );
+          terminalRunId = status.runId || runId;
+          break;
         }
       } catch (error) {
         if (options?.signal?.aborted || !isTransientPlayStreamError(error)) {
@@ -6514,15 +6530,11 @@ var DeeplineClient = class _DeeplineClient {
         }
         endedReason = error instanceof Error ? error.message : String(error);
       }
-      let refreshed = null;
-      try {
-        refreshed = await this.getRunStatus(runId);
-      } catch (error) {
-        if (!isTransientPlayStreamError(error)) {
-          throw error;
-        }
+      if (terminalRunId) {
+        return await this.getRunStatus(terminalRunId);
       }
-      if (refreshed && TERMINAL_PLAY_STATUSES.has(refreshed.status)) {
+      const refreshed = await this.getRunStatus(runId);
+      if (TERMINAL_PLAY_STATUSES.has(refreshed.status)) {
         return refreshed;
       }
       if (sawEvent || Date.now() - connectedAt >= STREAM_HEALTHY_CONNECTION_MS) {
@@ -6811,6 +6823,26 @@ var DeeplineClient = class _DeeplineClient {
       hasMore: Boolean(response.pagination?.hasMore ?? response.hasMore)
     };
   }
+  /** Read definition-level settings, independently of code revisions. */
+  async getPlaySettings(playName) {
+    return this.http.get(
+      `/api/v2/plays/${encodeURIComponent(playName)}/settings`
+    );
+  }
+  /** Retry-safe field patch; omitted fields retain their current value. */
+  async updatePlaySettings(playName, patch) {
+    return this.http.patch(
+      `/api/v2/plays/${encodeURIComponent(playName)}/settings`,
+      patch
+    );
+  }
+  /** List one bounded page of existing Play locations; continue with cursor. */
+  async listPlaySettingsPaths(options = {}) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(options))
+      if (value !== void 0) query.set(key, String(value));
+    return this.http.get(`/api/v2/plays/settings/paths?${query}`);
+  }
   /** Set whether an org-owned Play sorts before unpinned Plays. */
   async setPlayPinned(playName, pinned) {
     return this.http.post(`/api/v2/plays/${encodeURIComponent(playName)}/pin`, {

package/dist/install-integrity.json

@@ -5,6 +5,7 @@
     "dist/bundling-sources/sdk/src/client.ts",
     "dist/bundling-sources/sdk/src/compat.ts",
     "dist/bundling-sources/sdk/src/config.ts",
+    "dist/bundling-sources/sdk/src/deployment-protection.ts",
     "dist/bundling-sources/sdk/src/errors.ts",
     "dist/bundling-sources/sdk/src/gtm.ts",
     "dist/bundling-sources/sdk/src/helpers.ts",
@@ -503,6 +504,7 @@
     "dist/bundling-sources/shared_libs/plays/sandbox-runtime-limits.ts",
     "dist/bundling-sources/shared_libs/plays/secret-guardrails.ts",
     "dist/bundling-sources/shared_libs/plays/secrets/errors.ts",
+    "dist/bundling-sources/shared_libs/plays/settings-contract.ts",
     "dist/bundling-sources/shared_libs/plays/share/copy.ts",
     "dist/bundling-sources/shared_libs/plays/share/metrics.ts",
     "dist/bundling-sources/shared_libs/plays/share/public-read-model.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.213";
+    readonly version: "0.3.214";
     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.213";
+    readonly version: "0.3.214";
     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.213",
+  version: "0.3.214",
   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.213",
+  version: "0.3.214",
   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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.213",
+  "version": "0.3.214",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",
@@ -71,7 +71,8 @@
     "csv-parse": "^5.6.0",
     "csv-stringify": "^6.5.0",
     "handlebars": "4.7.8",
-    "undici": "^6.22.0"
+    "undici": "^6.22.0",
+    "zod": "^4.0.0"
   },
   "optionalDependencies": {
     "esbuild": "^0.27.0"