deepline 0.2.68 → 0.2.70

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

@@ -69,6 +69,7 @@ import type {
   PublishPlayVersionResult,
   StartPlayRunRequest,
   DeletePlayResult,
+  RestorePlayResult,
   SharePageStatus,
   PublishSharePageRequest,
   UpdateSharePageRequest,
@@ -4066,14 +4067,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.68',
+  version: '0.2.70',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -1547,14 +1547,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/cli/index.js

@@ -1044,7 +1044,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.68",
+  version: "0.2.70",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -6050,13 +6050,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
   // ——————————————————————————————————————————————————————————
@@ -7533,6 +7542,23 @@ async function httpJson(method, url, apiKey, body) {
   }
   return { status: response.status, data };
 }
+async function reportSetupCompleted(input2) {
+  const apiKey = input2.authScope === "folder" ? resolveProjectApiKeyForBaseUrl(input2.baseUrl) : resolveGlobalApiKeyForBaseUrl(input2.baseUrl);
+  if (!apiKey) return;
+  try {
+    await httpJson(
+      "POST",
+      `${input2.baseUrl}/api/v2/telemetry/setup-completed`,
+      apiKey,
+      {
+        scope: input2.scope,
+        resumed: input2.resumed,
+        installed_agent_count: input2.installedAgentCount
+      }
+    );
+  } catch {
+  }
+}
 function buildCandidateUrls2(url) {
   try {
     const parsed = new URL(url);
@@ -24656,15 +24682,32 @@ async function handlePlayPublish(args) {
 async function handlePlayDelete(args) {
   const playName = args[0];
   if (!playName) {
-    console.error("Usage: deepline plays delete <play-name> --yes [--json]");
-    return 1;
+    console.error(
+      "Usage: deepline plays delete <play-name> --yes [--dry-run] [--json]"
+    );
+    return 2;
+  }
+  if (looksLikeRunId(playName)) {
+    console.error(
+      formatPlayCommandReceivedRunIdError({
+        command: "delete",
+        runId: playName
+      })
+    );
+    return 2;
   }
-  const confirmed = args.includes("--yes") || args.includes("-y") || args.includes("--force");
+  if (isFileTarget(playName) || looksLikeFilePath(playName)) {
+    console.error(
+      "Refusing to delete a local file. This command only moves a saved org-owned play to Trash."
+    );
+    return 2;
+  }
+  const confirmed = args.includes("--yes") || args.includes("-y");
   if (!confirmed) {
     console.error(
-      "Refusing to delete without --yes. This deletes the org-owned play, its revisions, trigger bindings, and local run records."
+      "Refusing to move the play to Trash without --yes. This stops active triggers; the play can be restored later."
     );
-    return 1;
+    return 2;
   }
   const client2 = new DeeplineClient();
   let detail;
@@ -24672,27 +24715,103 @@ async function handlePlayDelete(args) {
     detail = await client2.getPlay(parseReferencedPlayTarget2(playName).playName);
   } catch (error) {
     console.error(error instanceof Error ? error.message : String(error));
-    return 1;
+    return 5;
   }
   if (detail.play.ownerType === "deepline" || detail.play.origin === "prebuilt") {
     console.error(
-      `Cannot delete prebuilt play: ${formatPlayReference(detail.play)}`
+      `Cannot move prebuilt play to Trash: ${formatPlayReference(detail.play)}`
     );
-    return 1;
+    return 2;
   }
-  const result = await client2.deletePlay(
-    parseReferencedPlayTarget2(formatPlayReference(detail.play)).playName
-  );
+  const resolvedName = parseReferencedPlayTarget2(
+    formatPlayReference(detail.play)
+  ).playName;
+  if (args.includes("--dry-run")) {
+    const result2 = {
+      ok: true,
+      dryRun: true,
+      name: resolvedName,
+      plannedMutation: "move saved org-owned play to Trash and stop triggers"
+    };
+    if (argsWantJson(args)) {
+      process.stdout.write(`${JSON.stringify(result2)}
+`);
+    } else {
+      process.stdout.write(
+        `Dry run: would move ${result2.name} to Trash and stop its active triggers.
+`
+      );
+    }
+    return 0;
+  }
+  const result = await client2.deletePlay(resolvedName);
   if (argsWantJson(args)) {
     process.stdout.write(`${JSON.stringify(result)}
 `);
-    return result.deleted ? 0 : 1;
+    return result.archived || result.alreadyArchived ? 0 : 4;
+  }
+  if (result.alreadyArchived) {
+    process.stdout.write(`Play ${result.name} is already in Trash.
+`);
+    return 0;
+  }
+  if (!result.archived) {
+    console.error(`Play not found: ${result.name}`);
+    return 4;
   }
   process.stdout.write(
-    `Deleted ${result.name}: revisions=${result.deletedRevisionCount}, bindings=${result.deletedBindingCount}, runs=${result.deletedRunCount}
+    `Moved ${result.name} to Trash: stopped bindings=${result.archivedBindingCount}
 `
   );
-  return result.deleted ? 0 : 1;
+  return 0;
+}
+async function handlePlayRestore(args) {
+  const playName = args[0];
+  if (!playName) {
+    console.error("Usage: deepline plays restore <play-name> [--json]");
+    return 2;
+  }
+  if (looksLikeRunId(playName)) {
+    console.error(
+      formatPlayCommandReceivedRunIdError({
+        command: "restore",
+        runId: playName
+      })
+    );
+    return 2;
+  }
+  if (isFileTarget(playName) || looksLikeFilePath(playName)) {
+    console.error(
+      "Refusing to restore a local file. This command only restores a saved org-owned play from Trash."
+    );
+    return 2;
+  }
+  const client2 = new DeeplineClient();
+  try {
+    const result = await client2.restorePlay(
+      parseReferencedPlayTarget2(playName).playName
+    );
+    if (argsWantJson(args)) {
+      process.stdout.write(`${JSON.stringify(result)}
+`);
+      return result.restored || result.alreadyActive ? 0 : 4;
+    }
+    if (result.alreadyActive) {
+      process.stdout.write(`Play ${result.name} is already active.
+`);
+      return 0;
+    }
+    if (!result.restored) {
+      console.error(`Play not found: ${result.name}`);
+      return 4;
+    }
+    process.stdout.write(`Restored ${result.name} from Trash.
+`);
+    return 0;
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 5;
+  }
 }
 function registerPlayCommands(program) {
   const play = program.command("plays").description("Search, validate, run, and manage cloud plays.").addHelpText(
@@ -25077,21 +25196,40 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
-  play.command("delete <target>").description("Delete an org-owned play and its saved revisions/runs.").addHelpText(
+  play.command("delete <target>").description("Move an org-owned play to Trash and stop its triggers.").addHelpText(
     "after",
     `
 Notes:
-  Destructive mutation. Deletes an org-owned play plus saved revisions and run
-  records. Prebuilt/read-only plays are refused. Use --yes for noninteractive runs.
+  Soft delete. Moves an org-owned play to Trash and stops active triggers while
+  retaining revisions and run history. Prebuilt/read-only plays are refused.
+  Use --yes for noninteractive runs. Restore later with \`plays restore\`.
 
 Examples:
-  deepline plays delete my-play
+  deepline plays delete my-play --yes
   deepline plays delete my-play --yes --json
+  deepline plays delete my-play --yes --dry-run --json
 `
-  ).option("-y, --yes", "Confirm deletion").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
+  ).option("-y, --yes", "Confirm deletion").option("--dry-run", "Show the planned archive without mutating the play").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayDelete([
       target,
       ...options.yes ? ["--yes"] : [],
+      ...options.dryRun ? ["--dry-run"] : [],
+      ...options.json ? ["--json"] : []
+    ]);
+  });
+  play.command("restore <target>").description("Restore an org-owned play from Trash.").addHelpText(
+    "after",
+    `
+Notes:
+  Restoring re-enables the saved play and recreates its trigger bindings.
+
+Examples:
+  deepline plays restore my-play
+  deepline plays restore my-play --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
+    process.exitCode = await handlePlayRestore([
+      target,
       ...options.json ? ["--json"] : []
     ]);
   });
@@ -35195,6 +35333,16 @@ async function runSetupCommand(options) {
     status: "complete",
     phases
   });
+  const installedAgents = Array.isArray(skillsPayload?.agents) ? skillsPayload.agents.filter(
+    (agent) => typeof agent === "string"
+  ) : [];
+  await reportSetupCompleted({
+    baseUrl,
+    authScope,
+    scope,
+    resumed,
+    installedAgentCount: installedAgents.length
+  });
   const doctorChecks = asRecord3(doctorPayload?.checks);
   const apiCheck = asRecord3(doctorChecks?.api);
   printCommandEnvelope(
@@ -35204,7 +35352,7 @@ async function runSetupCommand(options) {
       complete: true,
       scope,
       cliVersion: SDK_VERSION,
-      agents: skillsPayload?.agents ?? [],
+      agents: installedAgents,
       workspace: apiCheck?.workspace ?? null,
       rollbackCommand: rollbackCommand(scope, root),
       statePath,

package/dist/cli/index.mjs

@@ -1030,7 +1030,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.68",
+  version: "0.2.70",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -6036,13 +6036,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
   // ——————————————————————————————————————————————————————————
@@ -7531,6 +7540,23 @@ async function httpJson(method, url, apiKey, body) {
   }
   return { status: response.status, data };
 }
+async function reportSetupCompleted(input2) {
+  const apiKey = input2.authScope === "folder" ? resolveProjectApiKeyForBaseUrl(input2.baseUrl) : resolveGlobalApiKeyForBaseUrl(input2.baseUrl);
+  if (!apiKey) return;
+  try {
+    await httpJson(
+      "POST",
+      `${input2.baseUrl}/api/v2/telemetry/setup-completed`,
+      apiKey,
+      {
+        scope: input2.scope,
+        resumed: input2.resumed,
+        installed_agent_count: input2.installedAgentCount
+      }
+    );
+  } catch {
+  }
+}
 function buildCandidateUrls2(url) {
   try {
     const parsed = new URL(url);
@@ -24708,15 +24734,32 @@ async function handlePlayPublish(args) {
 async function handlePlayDelete(args) {
   const playName = args[0];
   if (!playName) {
-    console.error("Usage: deepline plays delete <play-name> --yes [--json]");
-    return 1;
+    console.error(
+      "Usage: deepline plays delete <play-name> --yes [--dry-run] [--json]"
+    );
+    return 2;
+  }
+  if (looksLikeRunId(playName)) {
+    console.error(
+      formatPlayCommandReceivedRunIdError({
+        command: "delete",
+        runId: playName
+      })
+    );
+    return 2;
   }
-  const confirmed = args.includes("--yes") || args.includes("-y") || args.includes("--force");
+  if (isFileTarget(playName) || looksLikeFilePath(playName)) {
+    console.error(
+      "Refusing to delete a local file. This command only moves a saved org-owned play to Trash."
+    );
+    return 2;
+  }
+  const confirmed = args.includes("--yes") || args.includes("-y");
   if (!confirmed) {
     console.error(
-      "Refusing to delete without --yes. This deletes the org-owned play, its revisions, trigger bindings, and local run records."
+      "Refusing to move the play to Trash without --yes. This stops active triggers; the play can be restored later."
     );
-    return 1;
+    return 2;
   }
   const client2 = new DeeplineClient();
   let detail;
@@ -24724,27 +24767,103 @@ async function handlePlayDelete(args) {
     detail = await client2.getPlay(parseReferencedPlayTarget2(playName).playName);
   } catch (error) {
     console.error(error instanceof Error ? error.message : String(error));
-    return 1;
+    return 5;
   }
   if (detail.play.ownerType === "deepline" || detail.play.origin === "prebuilt") {
     console.error(
-      `Cannot delete prebuilt play: ${formatPlayReference(detail.play)}`
+      `Cannot move prebuilt play to Trash: ${formatPlayReference(detail.play)}`
     );
-    return 1;
+    return 2;
   }
-  const result = await client2.deletePlay(
-    parseReferencedPlayTarget2(formatPlayReference(detail.play)).playName
-  );
+  const resolvedName = parseReferencedPlayTarget2(
+    formatPlayReference(detail.play)
+  ).playName;
+  if (args.includes("--dry-run")) {
+    const result2 = {
+      ok: true,
+      dryRun: true,
+      name: resolvedName,
+      plannedMutation: "move saved org-owned play to Trash and stop triggers"
+    };
+    if (argsWantJson(args)) {
+      process.stdout.write(`${JSON.stringify(result2)}
+`);
+    } else {
+      process.stdout.write(
+        `Dry run: would move ${result2.name} to Trash and stop its active triggers.
+`
+      );
+    }
+    return 0;
+  }
+  const result = await client2.deletePlay(resolvedName);
   if (argsWantJson(args)) {
     process.stdout.write(`${JSON.stringify(result)}
 `);
-    return result.deleted ? 0 : 1;
+    return result.archived || result.alreadyArchived ? 0 : 4;
+  }
+  if (result.alreadyArchived) {
+    process.stdout.write(`Play ${result.name} is already in Trash.
+`);
+    return 0;
+  }
+  if (!result.archived) {
+    console.error(`Play not found: ${result.name}`);
+    return 4;
   }
   process.stdout.write(
-    `Deleted ${result.name}: revisions=${result.deletedRevisionCount}, bindings=${result.deletedBindingCount}, runs=${result.deletedRunCount}
+    `Moved ${result.name} to Trash: stopped bindings=${result.archivedBindingCount}
 `
   );
-  return result.deleted ? 0 : 1;
+  return 0;
+}
+async function handlePlayRestore(args) {
+  const playName = args[0];
+  if (!playName) {
+    console.error("Usage: deepline plays restore <play-name> [--json]");
+    return 2;
+  }
+  if (looksLikeRunId(playName)) {
+    console.error(
+      formatPlayCommandReceivedRunIdError({
+        command: "restore",
+        runId: playName
+      })
+    );
+    return 2;
+  }
+  if (isFileTarget(playName) || looksLikeFilePath(playName)) {
+    console.error(
+      "Refusing to restore a local file. This command only restores a saved org-owned play from Trash."
+    );
+    return 2;
+  }
+  const client2 = new DeeplineClient();
+  try {
+    const result = await client2.restorePlay(
+      parseReferencedPlayTarget2(playName).playName
+    );
+    if (argsWantJson(args)) {
+      process.stdout.write(`${JSON.stringify(result)}
+`);
+      return result.restored || result.alreadyActive ? 0 : 4;
+    }
+    if (result.alreadyActive) {
+      process.stdout.write(`Play ${result.name} is already active.
+`);
+      return 0;
+    }
+    if (!result.restored) {
+      console.error(`Play not found: ${result.name}`);
+      return 4;
+    }
+    process.stdout.write(`Restored ${result.name} from Trash.
+`);
+    return 0;
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 5;
+  }
 }
 function registerPlayCommands(program) {
   const play = program.command("plays").description("Search, validate, run, and manage cloud plays.").addHelpText(
@@ -25129,21 +25248,40 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
-  play.command("delete <target>").description("Delete an org-owned play and its saved revisions/runs.").addHelpText(
+  play.command("delete <target>").description("Move an org-owned play to Trash and stop its triggers.").addHelpText(
     "after",
     `
 Notes:
-  Destructive mutation. Deletes an org-owned play plus saved revisions and run
-  records. Prebuilt/read-only plays are refused. Use --yes for noninteractive runs.
+  Soft delete. Moves an org-owned play to Trash and stops active triggers while
+  retaining revisions and run history. Prebuilt/read-only plays are refused.
+  Use --yes for noninteractive runs. Restore later with \`plays restore\`.
 
 Examples:
-  deepline plays delete my-play
+  deepline plays delete my-play --yes
   deepline plays delete my-play --yes --json
+  deepline plays delete my-play --yes --dry-run --json
 `
-  ).option("-y, --yes", "Confirm deletion").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
+  ).option("-y, --yes", "Confirm deletion").option("--dry-run", "Show the planned archive without mutating the play").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayDelete([
       target,
       ...options.yes ? ["--yes"] : [],
+      ...options.dryRun ? ["--dry-run"] : [],
+      ...options.json ? ["--json"] : []
+    ]);
+  });
+  play.command("restore <target>").description("Restore an org-owned play from Trash.").addHelpText(
+    "after",
+    `
+Notes:
+  Restoring re-enables the saved play and recreates its trigger bindings.
+
+Examples:
+  deepline plays restore my-play
+  deepline plays restore my-play --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
+    process.exitCode = await handlePlayRestore([
+      target,
       ...options.json ? ["--json"] : []
     ]);
   });
@@ -35262,6 +35400,16 @@ async function runSetupCommand(options) {
     status: "complete",
     phases
   });
+  const installedAgents = Array.isArray(skillsPayload?.agents) ? skillsPayload.agents.filter(
+    (agent) => typeof agent === "string"
+  ) : [];
+  await reportSetupCompleted({
+    baseUrl,
+    authScope,
+    scope,
+    resumed,
+    installedAgentCount: installedAgents.length
+  });
   const doctorChecks = asRecord3(doctorPayload?.checks);
   const apiCheck = asRecord3(doctorChecks?.api);
   printCommandEnvelope(
@@ -35271,7 +35419,7 @@ async function runSetupCommand(options) {
       complete: true,
       scope,
       cliVersion: SDK_VERSION,
-      agents: skillsPayload?.agents ?? [],
+      agents: installedAgents,
       workspace: apiCheck?.workspace ?? null,
       rollbackCommand: rollbackCommand(scope, root),
       statePath,

package/dist/index.d.mts

@@ -1634,14 +1634,23 @@ interface PublishPlayVersionResult {
     triggerBindings?: unknown;
 }
 /**
- * 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.
  */
 interface DeletePlayResult {
-    deleted: boolean;
+    archived: boolean;
+    alreadyArchived: boolean;
+    name: string;
+    archivedBindingCount: number;
+}
+/** Result returned after restoring an org-owned play from Trash. */
+interface RestorePlayResult {
+    restored: boolean;
+    alreadyActive?: boolean;
     name: string;
-    deletedRevisionCount: number;
-    deletedBindingCount: number;
-    deletedRunCount: number;
 }
 /** Owner-facing view of a play's public share page. */
 interface SharePageOwnerView {
@@ -3428,10 +3437,13 @@ declare class DeeplineClient {
      */
     publishPlayVersion(name: string, request?: PublishPlayVersionRequest): Promise<PublishPlayVersionResult>;
     /**
-     * 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.
      */
     deletePlay(name: string): Promise<DeletePlayResult>;
+    /** Restore an org-owned play that was previously moved to Trash. */
+    restorePlay(name: string): Promise<RestorePlayResult>;
     /**
      * Current share status for a play: the public page (if any), the published
      * copy, and the revision picker. Read-only.

package/dist/index.d.ts

@@ -1634,14 +1634,23 @@ interface PublishPlayVersionResult {
     triggerBindings?: unknown;
 }
 /**
- * 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.
  */
 interface DeletePlayResult {
-    deleted: boolean;
+    archived: boolean;
+    alreadyArchived: boolean;
+    name: string;
+    archivedBindingCount: number;
+}
+/** Result returned after restoring an org-owned play from Trash. */
+interface RestorePlayResult {
+    restored: boolean;
+    alreadyActive?: boolean;
     name: string;
-    deletedRevisionCount: number;
-    deletedBindingCount: number;
-    deletedRunCount: number;
 }
 /** Owner-facing view of a play's public share page. */
 interface SharePageOwnerView {
@@ -3428,10 +3437,13 @@ declare class DeeplineClient {
      */
     publishPlayVersion(name: string, request?: PublishPlayVersionRequest): Promise<PublishPlayVersionResult>;
     /**
-     * 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.
      */
     deletePlay(name: string): Promise<DeletePlayResult>;
+    /** Restore an org-owned play that was previously moved to Trash. */
+    restorePlay(name: string): Promise<RestorePlayResult>;
     /**
      * Current share status for a play: the public page (if any), the published
      * copy, and the revision picker. Read-only.

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.68",
+  version: "0.2.70",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5786,13 +5786,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.68",
+  version: "0.2.70",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5709,13 +5709,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.68",
+  "version": "0.2.70",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",