@asgard-js/core 0.3.94 → 0.3.95

package/dist/index.mjs

@@ -1669,14 +1669,34 @@ class Yn {
    * about a minute), on purpose: the next turn must not race a dying pod.
    */
   async deleteChannel(t) {
-    const e = this.deriveChannelEndpoint();
-    if (!e)
+    await this.releaseChannel("DELETE", "", t);
+  }
+  /**
+   * Reset the conversation but keep the channel's files (F-039): `POST {base}/channel/clear?custom_channel_id=…`.
+   * The backend stops the run and clears the transcript, agent session, title and pending tool consent,
+   * but keeps the Channel Home (`/work`) files, uploaded blobs, the tool-call allow-list and the channel
+   * itself; the Sandbox restarts onto the same files. It answers only once the clear is done.
+   *
+   * Same success rule as {@link deleteChannel}: **any 2xx**, body never read — the edge answers `204`, a
+   * BFF relay may answer `200` with a body. There is no `404` special case either: an absent channel
+   * answers 2xx, so a `404` means the relay route does not exist, and reading it as "cleared" would hide
+   * a clear that never happened. Everything else throws {@link HttpError}.
+   *
+   * **No timeout is imposed** — a live Sandbox can hold the answer for up to about 45 seconds.
+   */
+  async clearChannel(t) {
+    await this.releaseChannel("POST", "/clear", t);
+  }
+  /** The shared request behind {@link deleteChannel} and {@link clearChannel}: any 2xx resolves, else throws. */
+  async releaseChannel(t, e, s) {
+    const r = this.deriveChannelEndpoint();
+    if (!r)
       throw new Error("Unable to derive channel endpoint. Please provide botProviderEndpoint in config.");
-    const s = new URL(e);
-    s.searchParams.set("custom_channel_id", t);
-    const r = await fetch(s.toString(), { method: "DELETE", headers: this.apiHeaders() });
-    if (!r.ok)
-      throw new k(r.status, r.statusText, await r.text().catch(() => {
+    const i = new URL(`${r}${e}`);
+    i.searchParams.set("custom_channel_id", s);
+    const o = await fetch(i.toString(), { method: t, headers: this.apiHeaders() });
+    if (!o.ok)
+      throw new k(o.status, o.statusText, await o.text().catch(() => {
       }));
   }
   deriveFeedbackEndpoint() {
@@ -3043,8 +3063,11 @@ class q {
    * Clear an **existing** conversation and start over on the same id (F-032) — what the header's reset
    * button does. Two steps, in this order and never bundled:
    *
-   * 1. `client.deleteChannel()` — the backend releases the run, transcript, blobs, consent allow-list,
-   *    Sandbox and Channel Home, and answers only once that teardown is done.
+   * 1. Release the old conversation, per `mode` (F-039, default `'delete'`):
+   *    - `'delete'` — `client.deleteChannel()`: the backend releases the run, transcript, blobs, consent
+   *      allow-list, Sandbox and Channel Home, and answers only once that teardown is done.
+   *    - `'clear'` — `client.clearChannel()`: the conversation is cleared but the Channel Home files,
+   *      blobs and allow-list are kept; the Sandbox restarts onto the same files.
    * 2. {@link Channel.open} — a plain `action=NONE` opening turn on the now-empty id.
    *
    * This replaces the single `RESET_CHANNEL` turn, which bundled both into one request and therefore
@@ -3052,17 +3075,27 @@ class q {
    * the delete stripped them and the `blobIds` resolved to nothing without an error. A host that needs
    * "clear, then send with attachments" sequences it itself: `deleteChannel` → upload → `sendMessage`.
    *
-   * **Nothing local changes until the delete succeeds** — no channel is constructed, so no state
-   * observer fires. A failed delete therefore leaves the caller's current channel and conversation
+   * **Nothing local changes until step 1 succeeds** — no channel is constructed, so no state
+   * observer fires. A failed delete or clear therefore leaves the caller's current channel and conversation
    * exactly as they were, which is the point: the screen must never be cleared while the server still
    * holds the old conversation.
    */
-  static async reset(t, e, s, r) {
-    if (!t.client.deleteChannel)
-      throw new Error(
-        "This client cannot reset a channel: IAsgardServiceClient.deleteChannel is not implemented. Implement it (DELETE {base}/channel?custom_channel_id=…) or use AsgardServiceClient."
-      );
-    return await t.client.deleteChannel(t.customChannelId), q.open(t, e, s, r);
+  static async reset(t, e, s, r, i = "delete") {
+    const { client: o, customChannelId: a } = t;
+    if (i === "clear") {
+      if (!o.clearChannel)
+        throw new Error(
+          "This client cannot clear a channel: IAsgardServiceClient.clearChannel is not implemented. Implement it (POST {base}/channel/clear?custom_channel_id=…) or use AsgardServiceClient."
+        );
+      await o.clearChannel(a);
+    } else {
+      if (!o.deleteChannel)
+        throw new Error(
+          "This client cannot reset a channel: IAsgardServiceClient.deleteChannel is not implemented. Implement it (DELETE {base}/channel?custom_channel_id=…) or use AsgardServiceClient."
+        );
+      await o.deleteChannel(a);
+    }
+    return q.open(t, e, s, r);
   }
   /**
    * Join an **existing** channel without resetting it (F-015). Seeds the title from `config.channelTitle`