deepline 0.2.69 → 0.2.71

package/dist/index.js

@@ -780,7 +780,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.69",
+  version: "0.2.71",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3719,16 +3719,9 @@ function isPrebuiltPlayDescription(play) {
   return play.origin === "prebuilt" || play.ownerType === "deepline";
 }
 function preferPrebuiltPlayDescriptions(plays) {
-  const prebuilt = [];
-  const owned = [];
-  for (const play of plays) {
-    if (isPrebuiltPlayDescription(play)) {
-      prebuilt.push(play);
-    } else {
-      owned.push(play);
-    }
-  }
-  return [...prebuilt, ...owned];
+  return plays.map((play, index) => ({ play, index })).sort(
+    (left, right) => Number(right.play.pinned) - Number(left.play.pinned) || Number(isPrebuiltPlayDescription(right.play)) - Number(isPrebuiltPlayDescription(left.play)) || left.index - right.index
+  ).map(({ play }) => play);
 }
 function isPlayRunPackage(value) {
   return Boolean(
@@ -4075,6 +4068,8 @@ var DeeplineClient = class {
       ...play.reference ? { reference: play.reference } : {},
       ...play.displayName ? { displayName: play.displayName } : {},
       ...description ? { description } : {},
+      pinned: Boolean(play.pinned),
+      toolCategories: play.toolCategories ?? [],
       origin: play.origin,
       ownerType: play.ownerType,
       canEdit: play.canEdit,
@@ -5573,6 +5568,16 @@ var DeeplineClient = class {
   async listPlays(options) {
     const params = new URLSearchParams();
     if (options?.origin) params.set("origin", options.origin);
+    if (options?.categories) {
+      params.set(
+        "categories",
+        Array.isArray(options.categories) ? options.categories.join(",") : options.categories
+      );
+    }
+    if (options?.categories || options?.includeToolCategories) {
+      params.set("include_tool_categories", "1");
+    }
+    if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.grep?.trim()) {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
@@ -5584,6 +5589,12 @@ var DeeplineClient = class {
     );
     return response.plays ?? [];
   }
+  /** Set whether an org-owned Play sorts before unpinned Plays. */
+  async setPlayPinned(playName, pinned) {
+    return this.http.post(`/api/v2/plays/${encodeURIComponent(playName)}/pin`, {
+      pinned
+    });
+  }
   /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
   async getNotificationSettings() {
     return this.http.get("/api/v2/settings/notifications");
@@ -5786,13 +5797,22 @@ var DeeplineClient = class {
     );
   }
   /**
-   * Delete an org-owned play definition, including its revisions, trigger
-   * bindings, and local run records. Deepline prebuilt plays are read-only.
+   * Move an org-owned play to Trash. This disables its active triggers while
+   * retaining its revisions and run history so it can be restored. Deepline
+   * prebuilt plays are read-only.
    */
   async deletePlay(name) {
     const encodedName = encodeURIComponent(name);
     return this.http.delete(`/api/v2/plays/${encodedName}`);
   }
+  /** Restore an org-owned play that was previously moved to Trash. */
+  async restorePlay(name) {
+    const encodedName = encodeURIComponent(name);
+    return this.http.post(
+      `/api/v2/plays/${encodedName}/restore`,
+      {}
+    );
+  }
   // ——————————————————————————————————————————————————————————
   // Plays — public share pages
   // ——————————————————————————————————————————————————————————

package/dist/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.69",
+  version: "0.2.71",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3642,16 +3642,9 @@ function isPrebuiltPlayDescription(play) {
   return play.origin === "prebuilt" || play.ownerType === "deepline";
 }
 function preferPrebuiltPlayDescriptions(plays) {
-  const prebuilt = [];
-  const owned = [];
-  for (const play of plays) {
-    if (isPrebuiltPlayDescription(play)) {
-      prebuilt.push(play);
-    } else {
-      owned.push(play);
-    }
-  }
-  return [...prebuilt, ...owned];
+  return plays.map((play, index) => ({ play, index })).sort(
+    (left, right) => Number(right.play.pinned) - Number(left.play.pinned) || Number(isPrebuiltPlayDescription(right.play)) - Number(isPrebuiltPlayDescription(left.play)) || left.index - right.index
+  ).map(({ play }) => play);
 }
 function isPlayRunPackage(value) {
   return Boolean(
@@ -3998,6 +3991,8 @@ var DeeplineClient = class {
       ...play.reference ? { reference: play.reference } : {},
       ...play.displayName ? { displayName: play.displayName } : {},
       ...description ? { description } : {},
+      pinned: Boolean(play.pinned),
+      toolCategories: play.toolCategories ?? [],
       origin: play.origin,
       ownerType: play.ownerType,
       canEdit: play.canEdit,
@@ -5496,6 +5491,16 @@ var DeeplineClient = class {
   async listPlays(options) {
     const params = new URLSearchParams();
     if (options?.origin) params.set("origin", options.origin);
+    if (options?.categories) {
+      params.set(
+        "categories",
+        Array.isArray(options.categories) ? options.categories.join(",") : options.categories
+      );
+    }
+    if (options?.categories || options?.includeToolCategories) {
+      params.set("include_tool_categories", "1");
+    }
+    if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.grep?.trim()) {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
@@ -5507,6 +5512,12 @@ var DeeplineClient = class {
     );
     return response.plays ?? [];
   }
+  /** Set whether an org-owned Play sorts before unpinned Plays. */
+  async setPlayPinned(playName, pinned) {
+    return this.http.post(`/api/v2/plays/${encodeURIComponent(playName)}/pin`, {
+      pinned
+    });
+  }
   /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
   async getNotificationSettings() {
     return this.http.get("/api/v2/settings/notifications");
@@ -5709,13 +5720,22 @@ var DeeplineClient = class {
     );
   }
   /**
-   * Delete an org-owned play definition, including its revisions, trigger
-   * bindings, and local run records. Deepline prebuilt plays are read-only.
+   * Move an org-owned play to Trash. This disables its active triggers while
+   * retaining its revisions and run history so it can be restored. Deepline
+   * prebuilt plays are read-only.
    */
   async deletePlay(name) {
     const encodedName = encodeURIComponent(name);
     return this.http.delete(`/api/v2/plays/${encodedName}`);
   }
+  /** Restore an org-owned play that was previously moved to Trash. */
+  async restorePlay(name) {
+    const encodedName = encodeURIComponent(name);
+    return this.http.post(
+      `/api/v2/plays/${encodedName}/restore`,
+      {}
+    );
+  }
   // ——————————————————————————————————————————————————————————
   // Plays — public share pages
   // ——————————————————————————————————————————————————————————

package/package.json

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