deepline 0.2.69 → 0.2.71

package/dist/bundling-sources/sdk/src/client.ts

@@ -69,6 +69,7 @@ import type {
   PublishPlayVersionResult,
   StartPlayRunRequest,
   DeletePlayResult,
+  RestorePlayResult,
   SharePageStatus,
   PublishSharePageRequest,
   UpdateSharePageRequest,
@@ -1155,16 +1156,16 @@ function isPrebuiltPlayDescription(
 function preferPrebuiltPlayDescriptions<T extends PlayDescription>(
   plays: T[],
 ): T[] {
-  const prebuilt: T[] = [];
-  const owned: T[] = [];
-  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: unknown): value is PlayRunPackage {
@@ -1774,6 +1775,8 @@ export class DeeplineClient {
       ...(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,
@@ -3777,9 +3780,24 @@ export class DeeplineClient {
     origin?: 'prebuilt' | 'owned';
     grep?: string;
     grepMode?: 'all' | 'any' | 'phrase';
+    categories?: string | string[];
+    includeToolCategories?: boolean;
+    includeArchived?: boolean;
   }): Promise<PlayListItem[]> {
     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');
@@ -3792,6 +3810,16 @@ export class DeeplineClient {
     return response.plays ?? [];
   }
 
+  /** Set whether an org-owned Play sorts before unpinned Plays. */
+  async setPlayPinned(
+    playName: string,
+    pinned: boolean,
+  ): Promise<{ name: string; pinned: boolean }> {
+    return this.http.post(`/api/v2/plays/${encodeURIComponent(playName)}/pin`, {
+      pinned,
+    });
+  }
+
   /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
   async getNotificationSettings(): Promise<ProductNotificationSettings> {
     return this.http.get('/api/v2/settings/notifications');
@@ -4066,14 +4094,24 @@ export class DeeplineClient {
   }
 
   /**
-   * 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: string): Promise<DeletePlayResult> {
     const encodedName = encodeURIComponent(name);
     return this.http.delete<DeletePlayResult>(`/api/v2/plays/${encodedName}`);
   }
 
+  /** Restore an org-owned play that was previously moved to Trash. */
+  async restorePlay(name: string): Promise<RestorePlayResult> {
+    const encodedName = encodeURIComponent(name);
+    return this.http.post<RestorePlayResult>(
+      `/api/v2/plays/${encodedName}/restore`,
+      {},
+    );
+  }
+
   // ——————————————————————————————————————————————————————————
   // Plays — public share pages
   // ——————————————————————————————————————————————————————————

package/dist/bundling-sources/sdk/src/release.ts

@@ -183,7 +183,7 @@ export const 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',

package/dist/bundling-sources/sdk/src/types.ts

@@ -1010,6 +1010,10 @@ export interface PlayDefinitionDetail {
   name: string;
   /** Human-friendly display name for UI surfaces. */
   displayName?: string;
+  /** Whether this Play sorts before unpinned Plays. */
+  pinned?: boolean;
+  /** Canonical categories declared by tools used in this Play. */
+  toolCategories?: string[];
   /** Whether this entry comes from the Deepline prebuilt registry or the org-owned catalog. */
   origin?: 'prebuilt' | 'owned';
   /** Ownership class used for permissions and badges. */
@@ -1064,6 +1068,8 @@ export interface PlayListItem {
   name: string;
   displayName?: string;
   description?: string | null;
+  pinned?: boolean;
+  toolCategories?: string[];
   origin?: 'prebuilt' | 'owned';
   ownerType?: 'deepline' | 'org';
   ownerSlug?: string;
@@ -1135,6 +1141,8 @@ export interface PlayDescription {
   reference?: string;
   displayName?: string;
   description?: string | null;
+  pinned?: boolean;
+  toolCategories?: string[];
   origin?: 'prebuilt' | 'owned';
   ownerType?: 'deepline' | 'org';
   canEdit?: boolean;
@@ -1547,14 +1555,24 @@ export interface PublishPlayVersionResult {
 }
 
 /**
- * Result returned after deleting an org-owned play.
+ * Result returned after moving an org-owned play to Trash.
+ *
+ * `deletePlay` is retained as the SDK method name for compatibility, but play
+ * deletion is soft: revisions and run history remain available if the play is
+ * restored.
  */
 export interface DeletePlayResult {
-  deleted: boolean;
+  archived: boolean;
+  alreadyArchived: boolean;
+  name: string;
+  archivedBindingCount: number;
+}
+
+/** Result returned after restoring an org-owned play from Trash. */
+export interface RestorePlayResult {
+  restored: boolean;
+  alreadyActive?: boolean;
   name: string;
-  deletedRevisionCount: number;
-  deletedBindingCount: number;
-  deletedRunCount: number;
 }
 
 // ——————————————————————————————————————————————————————————

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -38,7 +38,7 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
     changed:
       'Materializes the declared input schema in the admitted snapshot so launch never reparses current source.',
     compatibilityOwner: 'Plays Runtime',
-    newWritesEnd: null,
+    newWritesEnd: '2026-08-19',
     readerRemoval: null,
   },
 ] as const;

package/dist/bundling-sources/shared_libs/plays/enrich-play-compiler.ts

@@ -691,10 +691,20 @@ export function compileEnrichConfigToPlaySource(
   const runOptionsSource = options.failFast
     ? `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart), onRowError: 'fail' as const }`
     : `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart) }`;
+  const describedColumns = config.commands
+    .filter((command) => isWaterfall(command) || !command.disabled)
+    .map((command) =>
+      (isWaterfall(command) ? command.with_waterfall : command.alias)
+        .replace(/[_-]+/g, ' ')
+        .trim(),
+    )
+    .filter(Boolean)
+    .slice(0, 3);
+  const generatedDescription = describedColumns.length
+    ? `Enrich CSV rows with ${describedColumns.join(', ')}.`
+    : 'Prepare CSV rows for enrichment.';
   const playOptionsSource = [
-    `description: ${stringLiteral(
-      'Read a CSV file, run the configured Deepline enrich commands, and return enriched rows.',
-    )}`,
+    `description: ${stringLiteral(generatedDescription)}`,
     ...(options.maxCreditsPerRun === undefined
       ? []
       : [`billing: { maxCreditsPerRun: ${String(options.maxCreditsPerRun)} }`]),

package/dist/bundling-sources/shared_libs/plays/tool-category-descriptions.ts

@@ -49,3 +49,15 @@ export const TOOL_CATEGORY_DESCRIPTIONS: Readonly<Record<string, string>> = {
 export function describeToolCategory(category: string): string | null {
   return TOOL_CATEGORY_DESCRIPTIONS[category] ?? null;
 }
+
+/** Human-readable label for a canonical tool-category slug. */
+export function formatToolCategoryLabel(category: string): string {
+  const normalized = category
+    .trim()
+    .replace(/[_-]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .toLowerCase();
+  return normalized
+    ? `${normalized[0]?.toUpperCase() ?? ''}${normalized.slice(1)}`
+    : '';
+}