@liveblocks/core 3.2.1 → 3.3.0

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.2.1";
+var PKG_VERSION = "3.3.0";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -52,151 +52,101 @@ function detectDupes(pkgName, pkgVersion, pkgFormat) {
   }
 }
 
-// src/convert-plain-data.ts
-function convertToCommentData(data) {
-  const editedAt = data.editedAt ? new Date(data.editedAt) : void 0;
-  const createdAt = new Date(data.createdAt);
-  const reactions = data.reactions.map((reaction) => ({
-    ...reaction,
-    createdAt: new Date(reaction.createdAt)
-  }));
-  if (data.body) {
-    return {
-      ...data,
-      reactions,
-      createdAt,
-      editedAt
-    };
-  } else {
-    const deletedAt = new Date(data.deletedAt);
-    return {
-      ...data,
-      reactions,
-      createdAt,
-      editedAt,
-      deletedAt
-    };
+// src/lib/EventSource.ts
+function makeEventSource() {
+  const _observers = /* @__PURE__ */ new Set();
+  function subscribe(callback) {
+    _observers.add(callback);
+    return () => _observers.delete(callback);
   }
-}
-function convertToThreadData(data) {
-  const createdAt = new Date(data.createdAt);
-  const updatedAt = new Date(data.updatedAt);
-  const comments = data.comments.map(
-    (comment) => convertToCommentData(comment)
-  );
-  return {
-    ...data,
-    createdAt,
-    updatedAt,
-    comments
-  };
-}
-function convertToCommentUserReaction(data) {
-  return {
-    ...data,
-    createdAt: new Date(data.createdAt)
-  };
-}
-function convertToInboxNotificationData(data) {
-  const notifiedAt = new Date(data.notifiedAt);
-  const readAt = data.readAt ? new Date(data.readAt) : null;
-  if ("activities" in data) {
-    const activities = data.activities.map((activity) => ({
-      ...activity,
-      createdAt: new Date(activity.createdAt)
-    }));
-    return {
-      ...data,
-      notifiedAt,
-      readAt,
-      activities
-    };
+  function subscribeOnce(callback) {
+    const unsub = subscribe((event) => {
+      unsub();
+      return callback(event);
+    });
+    return unsub;
+  }
+  async function waitUntil(predicate) {
+    let unsub;
+    return new Promise((res) => {
+      unsub = subscribe((event) => {
+        if (predicate === void 0 || predicate(event)) {
+          res(event);
+        }
+      });
+    }).finally(() => unsub?.());
+  }
+  function notify(event) {
+    let called = false;
+    for (const callback of _observers) {
+      callback(event);
+      called = true;
+    }
+    return called;
+  }
+  function count() {
+    return _observers.size;
   }
   return {
-    ...data,
-    notifiedAt,
-    readAt
-  };
-}
-function convertToSubscriptionData(data) {
-  const createdAt = new Date(data.createdAt);
-  return {
-    ...data,
-    createdAt
-  };
-}
-function convertToUserSubscriptionData(data) {
-  const createdAt = new Date(data.createdAt);
-  return {
-    ...data,
-    createdAt
-  };
-}
-function convertToThreadDeleteInfo(data) {
-  const deletedAt = new Date(data.deletedAt);
-  return {
-    ...data,
-    deletedAt
-  };
-}
-function convertToInboxNotificationDeleteInfo(data) {
-  const deletedAt = new Date(data.deletedAt);
-  return {
-    ...data,
-    deletedAt
+    // Private/internal control over event emission
+    notify,
+    subscribe,
+    subscribeOnce,
+    count,
+    waitUntil,
+    dispose() {
+      _observers.clear();
+    },
+    // Publicly exposable subscription API
+    observable: {
+      subscribe,
+      subscribeOnce,
+      waitUntil
+    }
   };
 }
-function convertToSubscriptionDeleteInfo(data) {
-  const deletedAt = new Date(data.deletedAt);
+function makeBufferableEventSource() {
+  const eventSource2 = makeEventSource();
+  let _buffer = null;
+  function pause() {
+    _buffer = [];
+  }
+  function unpause() {
+    if (_buffer === null) {
+      return;
+    }
+    for (const event of _buffer) {
+      eventSource2.notify(event);
+    }
+    _buffer = null;
+  }
+  function notifyOrBuffer(event) {
+    if (_buffer !== null) {
+      _buffer.push(event);
+      return false;
+    } else {
+      return eventSource2.notify(event);
+    }
+  }
   return {
-    ...data,
-    deletedAt
+    ...eventSource2,
+    notify: notifyOrBuffer,
+    pause,
+    unpause,
+    dispose() {
+      eventSource2.dispose();
+      if (_buffer !== null) {
+        _buffer.length = 0;
+      }
+    }
   };
 }
 
-// src/lib/fancy-console.ts
-var fancy_console_exports = {};
-__export(fancy_console_exports, {
-  error: () => error2,
-  errorWithTitle: () => errorWithTitle,
-  warn: () => warn,
-  warnWithTitle: () => warnWithTitle
-});
-var badge = "background:#0e0d12;border-radius:9999px;color:#fff;padding:3px 7px;font-family:sans-serif;font-weight:600;";
-var bold = "font-weight:600";
-function wrap(method) {
-  return typeof window === "undefined" || process.env.NODE_ENV === "test" ? console[method] : (
-    /* istanbul ignore next */
-    (message, ...args) => console[method]("%cLiveblocks", badge, message, ...args)
-  );
-}
-var warn = wrap("warn");
-var error2 = wrap("error");
-function wrapWithTitle(method) {
-  return typeof window === "undefined" || process.env.NODE_ENV === "test" ? console[method] : (
-    /* istanbul ignore next */
-    (title, message, ...args) => console[method](
-      `%cLiveblocks%c ${title}`,
-      badge,
-      bold,
-      message,
-      ...args
-    )
-  );
-}
-var warnWithTitle = wrapWithTitle("warn");
-var errorWithTitle = wrapWithTitle("error");
-
-// src/lib/guards.ts
-function isDefined(value) {
-  return value !== null && value !== void 0;
-}
-function isPlainObject(blob) {
-  return blob !== null && typeof blob === "object" && Object.prototype.toString.call(blob) === "[object Object]";
-}
-function isStartsWithOperator(blob) {
-  return isPlainObject(blob) && typeof blob.startsWith === "string";
-}
+// src/lib/freeze.ts
+var freeze = process.env.NODE_ENV === "production" ? (
+  /* istanbul ignore next */
+  (x) => x
+) : Object.freeze;
 
 // src/lib/utils.ts
 function raise(msg) {
@@ -294,201 +244,22 @@ function memoizeOnSuccess(factoryFn) {
   };
 }
 
-// src/lib/autoRetry.ts
-var HttpError = class _HttpError extends Error {
-  response;
-  details;
-  constructor(message, response, details) {
-    super(message);
-    this.name = "HttpError";
-    this.response = response;
-    this.details = details;
+// src/lib/signals.ts
+var kSinks = Symbol("kSinks");
+var kTrigger = Symbol("kTrigger");
+var signalsToTrigger = null;
+var trackedReads = null;
+function batch(callback) {
+  if (signalsToTrigger !== null) {
+    callback();
+    return;
   }
-  static async fromResponse(response) {
-    let bodyAsText;
-    try {
-      bodyAsText = await response.text();
-    } catch {
-    }
-    const bodyAsJson = bodyAsText ? tryParseJson(bodyAsText) : void 0;
-    let bodyAsJsonObject;
-    if (isPlainObject(bodyAsJson)) {
-      bodyAsJsonObject = bodyAsJson;
-    }
-    let message = "";
-    message ||= typeof bodyAsJsonObject?.message === "string" ? bodyAsJsonObject.message : "";
-    message ||= typeof bodyAsJsonObject?.error === "string" ? bodyAsJsonObject.error : "";
-    if (bodyAsJson === void 0) {
-      message ||= bodyAsText || "";
-    }
-    message ||= response.statusText;
-    let path;
-    try {
-      path = new URL(response.url).pathname;
-    } catch {
-    }
-    message += path !== void 0 ? ` (got status ${response.status} from ${path})` : ` (got status ${response.status})`;
-    const details = bodyAsJsonObject;
-    return new _HttpError(message, response, details);
-  }
-  /**
-   * Convenience accessor for response.status.
-   */
-  get status() {
-    return this.response.status;
-  }
-};
-var DONT_RETRY_4XX = (x) => x instanceof HttpError && x.status >= 400 && x.status < 500;
-async function autoRetry(promiseFn, maxTries, backoff, shouldStopRetrying = DONT_RETRY_4XX) {
-  const fallbackBackoff = backoff.length > 0 ? backoff[backoff.length - 1] : 0;
-  let attempt = 0;
-  while (true) {
-    attempt++;
-    try {
-      return await promiseFn();
-    } catch (err) {
-      if (shouldStopRetrying(err)) {
-        throw err;
-      }
-      if (attempt >= maxTries) {
-        throw new Error(`Failed after ${maxTries} attempts: ${String(err)}`);
-      }
-    }
-    const delay = backoff[attempt - 1] ?? fallbackBackoff;
-    warn(
-      `Attempt ${attempt} was unsuccessful. Retrying in ${delay} milliseconds.`
-    );
-    await wait(delay);
-  }
-}
-
-// src/lib/controlledPromise.ts
-function controlledPromise() {
-  let resolve;
-  let reject;
-  const promise = new Promise((res, rej) => {
-    resolve = res;
-    reject = rej;
-  });
-  return [promise, resolve, reject];
-}
-function Promise_withResolvers() {
-  const [promise, resolve, reject] = controlledPromise();
-  return { promise, resolve, reject };
-}
-
-// src/lib/EventSource.ts
-function makeEventSource() {
-  const _observers = /* @__PURE__ */ new Set();
-  function subscribe(callback) {
-    _observers.add(callback);
-    return () => _observers.delete(callback);
-  }
-  function subscribeOnce(callback) {
-    const unsub = subscribe((event) => {
-      unsub();
-      return callback(event);
-    });
-    return unsub;
-  }
-  async function waitUntil(predicate) {
-    let unsub;
-    return new Promise((res) => {
-      unsub = subscribe((event) => {
-        if (predicate === void 0 || predicate(event)) {
-          res(event);
-        }
-      });
-    }).finally(() => unsub?.());
-  }
-  function notify(event) {
-    let called = false;
-    for (const callback of _observers) {
-      callback(event);
-      called = true;
-    }
-    return called;
-  }
-  function count() {
-    return _observers.size;
-  }
-  return {
-    // Private/internal control over event emission
-    notify,
-    subscribe,
-    subscribeOnce,
-    count,
-    waitUntil,
-    dispose() {
-      _observers.clear();
-    },
-    // Publicly exposable subscription API
-    observable: {
-      subscribe,
-      subscribeOnce,
-      waitUntil
-    }
-  };
-}
-function makeBufferableEventSource() {
-  const eventSource2 = makeEventSource();
-  let _buffer = null;
-  function pause() {
-    _buffer = [];
-  }
-  function unpause() {
-    if (_buffer === null) {
-      return;
-    }
-    for (const event of _buffer) {
-      eventSource2.notify(event);
-    }
-    _buffer = null;
-  }
-  function notifyOrBuffer(event) {
-    if (_buffer !== null) {
-      _buffer.push(event);
-      return false;
-    } else {
-      return eventSource2.notify(event);
-    }
-  }
-  return {
-    ...eventSource2,
-    notify: notifyOrBuffer,
-    pause,
-    unpause,
-    dispose() {
-      eventSource2.dispose();
-      if (_buffer !== null) {
-        _buffer.length = 0;
-      }
-    }
-  };
-}
-
-// src/lib/freeze.ts
-var freeze = process.env.NODE_ENV === "production" ? (
-  /* istanbul ignore next */
-  (x) => x
-) : Object.freeze;
-
-// src/lib/signals.ts
-var kSinks = Symbol("kSinks");
-var kTrigger = Symbol("kTrigger");
-var signalsToTrigger = null;
-var trackedReads = null;
-function batch(callback) {
-  if (signalsToTrigger !== null) {
-    callback();
-    return;
-  }
-  signalsToTrigger = /* @__PURE__ */ new Set();
-  try {
-    callback();
-  } finally {
-    for (const signal of signalsToTrigger) {
-      signal[kTrigger]();
+  signalsToTrigger = /* @__PURE__ */ new Set();
+  try {
+    callback();
+  } finally {
+    for (const signal of signalsToTrigger) {
+      signal[kTrigger]();
     }
     signalsToTrigger = null;
   }
@@ -695,64 +466,510 @@ var DerivedSignal = class _DerivedSignal extends AbstractSignal {
       this.#dirty = true;
       this.markSinksDirty();
     }
-  }
-  get() {
-    if (this.#dirty) {
-      this.#recompute();
+  }
+  get() {
+    if (this.#dirty) {
+      this.#recompute();
+    }
+    trackedReads?.add(this);
+    return this.#prevValue;
+  }
+  /**
+   * Called by the Signal system if one or more of the dependent signals have
+   * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
+   * the actual value if it's being watched, or any of their sinks are being
+   * watched actively.
+   */
+  [kTrigger]() {
+    if (!this.hasWatchers) {
+      return;
+    }
+    const updated = this.#recompute();
+    if (updated) {
+      super[kTrigger]();
+    }
+  }
+};
+var MutableSignal = class extends AbstractSignal {
+  #state;
+  constructor(initialState) {
+    super();
+    this.#state = initialState;
+  }
+  dispose() {
+    super.dispose();
+    this.#state = "(disposed)";
+  }
+  get() {
+    trackedReads?.add(this);
+    return this.#state;
+  }
+  /**
+   * Invokes a callback function that is allowed to mutate the given state
+   * value. Do not change the value outside of the callback.
+   *
+   * If the callback explicitly returns `false`, it's assumed that the state
+   * was not changed.
+   */
+  mutate(callback) {
+    batch(() => {
+      const result = callback ? callback(this.#state) : true;
+      if (result !== null && typeof result === "object" && "then" in result) {
+        raise("MutableSignal.mutate() does not support async callbacks");
+      }
+      if (result !== false) {
+        this.markSinksDirty();
+        enqueueTrigger(this);
+      }
+    });
+  }
+};
+
+// src/lib/SortedList.ts
+function bisectRight(arr, x, lt) {
+  let lo = 0;
+  let hi = arr.length;
+  while (lo < hi) {
+    const mid = lo + (hi - lo >> 1);
+    if (lt(x, arr[mid])) {
+      hi = mid;
+    } else {
+      lo = mid + 1;
+    }
+  }
+  return lo;
+}
+var SortedList = class _SortedList {
+  #data;
+  #lt;
+  constructor(alreadySortedList, lt) {
+    this.#lt = lt;
+    this.#data = alreadySortedList;
+  }
+  static with(lt) {
+    return _SortedList.fromAlreadySorted([], lt);
+  }
+  static from(arr, lt) {
+    const sorted = new _SortedList([], lt);
+    for (const item of arr) {
+      sorted.add(item);
+    }
+    return sorted;
+  }
+  static fromAlreadySorted(alreadySorted, lt) {
+    return new _SortedList(alreadySorted, lt);
+  }
+  /**
+   * Clones the sorted list to a new instance.
+   */
+  clone() {
+    return new _SortedList(this.#data.slice(), this.#lt);
+  }
+  /**
+   * Adds a new item to the sorted list, such that it remains sorted.
+   */
+  add(value) {
+    const idx = bisectRight(this.#data, value, this.#lt);
+    this.#data.splice(idx, 0, value);
+  }
+  /**
+   * Removes all values from the sorted list, making it empty again.
+   * Returns whether the list was mutated or not.
+   */
+  clear() {
+    const hadData = this.#data.length > 0;
+    this.#data.length = 0;
+    return hadData;
+  }
+  /**
+   * Removes the first value matching the predicate.
+   * Returns whether the list was mutated or not.
+   */
+  removeBy(predicate, limit = Number.POSITIVE_INFINITY) {
+    let deleted = 0;
+    for (let i = 0; i < this.#data.length; i++) {
+      if (predicate(this.#data[i])) {
+        this.#data.splice(i, 1);
+        deleted++;
+        if (deleted >= limit) {
+          break;
+        } else {
+          i--;
+        }
+      }
+    }
+    return deleted > 0;
+  }
+  /**
+   * Removes the given value from the sorted list, if it exists. The given
+   * value must be `===` to one of the list items. Only the first entry will be
+   * removed if the element exists in the sorted list multiple times.
+   *
+   * Returns whether the list was mutated or not.
+   */
+  remove(value) {
+    const idx = this.#data.indexOf(value);
+    if (idx >= 0) {
+      this.#data.splice(idx, 1);
+      return true;
+    }
+    return false;
+  }
+  at(index) {
+    return this.#data[index];
+  }
+  get length() {
+    return this.#data.length;
+  }
+  *filter(predicate) {
+    for (const item of this.#data) {
+      if (predicate(item)) {
+        yield item;
+      }
+    }
+  }
+  // XXXX If we keep this, add unit tests. Or remove it.
+  *findAllRight(predicate) {
+    for (let i = this.#data.length - 1; i >= 0; i--) {
+      const item = this.#data[i];
+      if (predicate(item, i)) {
+        yield item;
+      }
+    }
+  }
+  [Symbol.iterator]() {
+    return this.#data[Symbol.iterator]();
+  }
+  *iterReversed() {
+    for (let i = this.#data.length - 1; i >= 0; i--) {
+      yield this.#data[i];
+    }
+  }
+  /** Finds the leftmost item that matches the predicate. */
+  find(predicate, start) {
+    const idx = this.findIndex(predicate, start);
+    return idx > -1 ? this.#data.at(idx) : void 0;
+  }
+  /** Finds the leftmost index that matches the predicate. */
+  findIndex(predicate, start = 0) {
+    for (let i = Math.max(0, start); i < this.#data.length; i++) {
+      if (predicate(this.#data[i], i)) {
+        return i;
+      }
+    }
+    return -1;
+  }
+  /** Finds the rightmost item that matches the predicate. */
+  findRight(predicate, start) {
+    const idx = this.findIndexRight(predicate, start);
+    return idx > -1 ? this.#data.at(idx) : void 0;
+  }
+  /** Finds the rightmost index that matches the predicate. */
+  findIndexRight(predicate, start = this.#data.length - 1) {
+    for (let i = Math.min(start, this.#data.length - 1); i >= 0; i--) {
+      if (predicate(this.#data[i], i)) {
+        return i;
+      }
+    }
+    return -1;
+  }
+  get rawArray() {
+    return this.#data;
+  }
+};
+
+// src/AiChatDB.ts
+var AiChatDB = class {
+  #byId;
+  // A map of chat id to chat details
+  #chats;
+  // Sorted list of non-deleted chats, most recent first
+  signal;
+  constructor() {
+    this.#byId = /* @__PURE__ */ new Map();
+    this.#chats = SortedList.from([], (c1, c2) => {
+      const d2 = c2.lastMessageAt ?? c2.createdAt;
+      const d1 = c1.lastMessageAt ?? c1.createdAt;
+      return d2 < d1 ? true : d2 === d1 ? c2.id < c1.id : false;
+    });
+    this.signal = new MutableSignal(this);
+  }
+  getEvenIfDeleted(chatId) {
+    return this.#byId.get(chatId);
+  }
+  markDeleted(chatId) {
+    const chat = this.#byId.get(chatId);
+    if (chat === void 0 || chat.deletedAt !== void 0) return;
+    this.upsert({
+      ...chat,
+      deletedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  upsert(chat) {
+    this.signal.mutate(() => {
+      const existingThread = this.#byId.get(chat.id);
+      if (existingThread !== void 0) {
+        if (existingThread.deletedAt !== void 0) return false;
+        this.#chats.remove(existingThread);
+        this.#byId.delete(existingThread.id);
+      }
+      if (chat.deletedAt === void 0) {
+        this.#chats.add(chat);
+      }
+      this.#byId.set(chat.id, chat);
+      return true;
+    });
+  }
+  findMany(query) {
+    return Array.from(
+      this.#chats.filter((chat) => {
+        if (query.metadata === void 0) return true;
+        for (const [key, value] of Object.entries(query.metadata)) {
+          if (value === null) {
+            if (key in chat.metadata) return false;
+          } else if (typeof value === "string") {
+            if (chat.metadata[key] !== value) return false;
+          } else {
+            const chatValue = chat.metadata[key];
+            if (!Array.isArray(chatValue) || !value.every((v) => chatValue.includes(v))) {
+              return false;
+            }
+          }
+        }
+        return true;
+      })
+    );
+  }
+};
+
+// src/convert-plain-data.ts
+function convertToCommentData(data) {
+  const editedAt = data.editedAt ? new Date(data.editedAt) : void 0;
+  const createdAt = new Date(data.createdAt);
+  const reactions = data.reactions.map((reaction) => ({
+    ...reaction,
+    createdAt: new Date(reaction.createdAt)
+  }));
+  if (data.body) {
+    return {
+      ...data,
+      reactions,
+      createdAt,
+      editedAt
+    };
+  } else {
+    const deletedAt = new Date(data.deletedAt);
+    return {
+      ...data,
+      reactions,
+      createdAt,
+      editedAt,
+      deletedAt
+    };
+  }
+}
+function convertToThreadData(data) {
+  const createdAt = new Date(data.createdAt);
+  const updatedAt = new Date(data.updatedAt);
+  const comments = data.comments.map(
+    (comment) => convertToCommentData(comment)
+  );
+  return {
+    ...data,
+    createdAt,
+    updatedAt,
+    comments
+  };
+}
+function convertToCommentUserReaction(data) {
+  return {
+    ...data,
+    createdAt: new Date(data.createdAt)
+  };
+}
+function convertToInboxNotificationData(data) {
+  const notifiedAt = new Date(data.notifiedAt);
+  const readAt = data.readAt ? new Date(data.readAt) : null;
+  if ("activities" in data) {
+    const activities = data.activities.map((activity) => ({
+      ...activity,
+      createdAt: new Date(activity.createdAt)
+    }));
+    return {
+      ...data,
+      notifiedAt,
+      readAt,
+      activities
+    };
+  }
+  return {
+    ...data,
+    notifiedAt,
+    readAt
+  };
+}
+function convertToSubscriptionData(data) {
+  const createdAt = new Date(data.createdAt);
+  return {
+    ...data,
+    createdAt
+  };
+}
+function convertToUserSubscriptionData(data) {
+  const createdAt = new Date(data.createdAt);
+  return {
+    ...data,
+    createdAt
+  };
+}
+function convertToThreadDeleteInfo(data) {
+  const deletedAt = new Date(data.deletedAt);
+  return {
+    ...data,
+    deletedAt
+  };
+}
+function convertToInboxNotificationDeleteInfo(data) {
+  const deletedAt = new Date(data.deletedAt);
+  return {
+    ...data,
+    deletedAt
+  };
+}
+function convertToSubscriptionDeleteInfo(data) {
+  const deletedAt = new Date(data.deletedAt);
+  return {
+    ...data,
+    deletedAt
+  };
+}
+
+// src/lib/fancy-console.ts
+var fancy_console_exports = {};
+__export(fancy_console_exports, {
+  error: () => error2,
+  errorWithTitle: () => errorWithTitle,
+  warn: () => warn,
+  warnWithTitle: () => warnWithTitle
+});
+var badge = "background:#0e0d12;border-radius:9999px;color:#fff;padding:3px 7px;font-family:sans-serif;font-weight:600;";
+var bold = "font-weight:600";
+function wrap(method) {
+  return typeof window === "undefined" || process.env.NODE_ENV === "test" ? console[method] : (
+    /* istanbul ignore next */
+    (message, ...args) => console[method]("%cLiveblocks", badge, message, ...args)
+  );
+}
+var warn = wrap("warn");
+var error2 = wrap("error");
+function wrapWithTitle(method) {
+  return typeof window === "undefined" || process.env.NODE_ENV === "test" ? console[method] : (
+    /* istanbul ignore next */
+    (title, message, ...args) => console[method](
+      `%cLiveblocks%c ${title}`,
+      badge,
+      bold,
+      message,
+      ...args
+    )
+  );
+}
+var warnWithTitle = wrapWithTitle("warn");
+var errorWithTitle = wrapWithTitle("error");
+
+// src/lib/guards.ts
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
+function isPlainObject(blob) {
+  return blob !== null && typeof blob === "object" && Object.prototype.toString.call(blob) === "[object Object]";
+}
+function isStartsWithOperator(blob) {
+  return isPlainObject(blob) && typeof blob.startsWith === "string";
+}
+
+// src/lib/autoRetry.ts
+var HttpError = class _HttpError extends Error {
+  response;
+  details;
+  constructor(message, response, details) {
+    super(message);
+    this.name = "HttpError";
+    this.response = response;
+    this.details = details;
+  }
+  static async fromResponse(response) {
+    let bodyAsText;
+    try {
+      bodyAsText = await response.text();
+    } catch {
+    }
+    const bodyAsJson = bodyAsText ? tryParseJson(bodyAsText) : void 0;
+    let bodyAsJsonObject;
+    if (isPlainObject(bodyAsJson)) {
+      bodyAsJsonObject = bodyAsJson;
+    }
+    let message = "";
+    message ||= typeof bodyAsJsonObject?.message === "string" ? bodyAsJsonObject.message : "";
+    message ||= typeof bodyAsJsonObject?.error === "string" ? bodyAsJsonObject.error : "";
+    if (bodyAsJson === void 0) {
+      message ||= bodyAsText || "";
+    }
+    message ||= response.statusText;
+    let path;
+    try {
+      path = new URL(response.url).pathname;
+    } catch {
     }
-    trackedReads?.add(this);
-    return this.#prevValue;
+    message += path !== void 0 ? ` (got status ${response.status} from ${path})` : ` (got status ${response.status})`;
+    const details = bodyAsJsonObject;
+    return new _HttpError(message, response, details);
   }
   /**
-   * Called by the Signal system if one or more of the dependent signals have
-   * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
-   * the actual value if it's being watched, or any of their sinks are being
-   * watched actively.
+   * Convenience accessor for response.status.
    */
-  [kTrigger]() {
-    if (!this.hasWatchers) {
-      return;
-    }
-    const updated = this.#recompute();
-    if (updated) {
-      super[kTrigger]();
-    }
+  get status() {
+    return this.response.status;
   }
 };
-var MutableSignal = class extends AbstractSignal {
-  #state;
-  constructor(initialState) {
-    super();
-    this.#state = initialState;
-  }
-  dispose() {
-    super.dispose();
-    this.#state = "(disposed)";
-  }
-  get() {
-    trackedReads?.add(this);
-    return this.#state;
-  }
-  /**
-   * Invokes a callback function that is allowed to mutate the given state
-   * value. Do not change the value outside of the callback.
-   *
-   * If the callback explicitly returns `false`, it's assumed that the state
-   * was not changed.
-   */
-  mutate(callback) {
-    batch(() => {
-      const result = callback ? callback(this.#state) : true;
-      if (result !== null && typeof result === "object" && "then" in result) {
-        raise("MutableSignal.mutate() does not support async callbacks");
+var DONT_RETRY_4XX = (x) => x instanceof HttpError && x.status >= 400 && x.status < 500;
+async function autoRetry(promiseFn, maxTries, backoff, shouldStopRetrying = DONT_RETRY_4XX) {
+  const fallbackBackoff = backoff.length > 0 ? backoff[backoff.length - 1] : 0;
+  let attempt = 0;
+  while (true) {
+    attempt++;
+    try {
+      return await promiseFn();
+    } catch (err) {
+      if (shouldStopRetrying(err)) {
+        throw err;
       }
-      if (result !== false) {
-        this.markSinksDirty();
-        enqueueTrigger(this);
+      if (attempt >= maxTries) {
+        throw new Error(`Failed after ${maxTries} attempts: ${String(err)}`);
       }
-    });
+    }
+    const delay = backoff[attempt - 1] ?? fallbackBackoff;
+    warn(
+      `Attempt ${attempt} was unsuccessful. Retrying in ${delay} milliseconds.`
+    );
+    await wait(delay);
   }
-};
+}
+
+// src/lib/controlledPromise.ts
+function controlledPromise() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return [promise, resolve, reject];
+}
+function Promise_withResolvers() {
+  const [promise, resolve, reject] = controlledPromise();
+  return { promise, resolve, reject };
+}
 
 // src/lib/stringify.ts
 function replacer(_key, value) {
@@ -3398,159 +3615,6 @@ function shallow2(a, b) {
   );
 }
 
-// src/lib/SortedList.ts
-function bisectRight(arr, x, lt) {
-  let lo = 0;
-  let hi = arr.length;
-  while (lo < hi) {
-    const mid = lo + (hi - lo >> 1);
-    if (lt(x, arr[mid])) {
-      hi = mid;
-    } else {
-      lo = mid + 1;
-    }
-  }
-  return lo;
-}
-var SortedList = class _SortedList {
-  #data;
-  #lt;
-  constructor(alreadySortedList, lt) {
-    this.#lt = lt;
-    this.#data = alreadySortedList;
-  }
-  static with(lt) {
-    return _SortedList.fromAlreadySorted([], lt);
-  }
-  static from(arr, lt) {
-    const sorted = new _SortedList([], lt);
-    for (const item of arr) {
-      sorted.add(item);
-    }
-    return sorted;
-  }
-  static fromAlreadySorted(alreadySorted, lt) {
-    return new _SortedList(alreadySorted, lt);
-  }
-  /**
-   * Clones the sorted list to a new instance.
-   */
-  clone() {
-    return new _SortedList(this.#data.slice(), this.#lt);
-  }
-  /**
-   * Adds a new item to the sorted list, such that it remains sorted.
-   */
-  add(value) {
-    const idx = bisectRight(this.#data, value, this.#lt);
-    this.#data.splice(idx, 0, value);
-  }
-  /**
-   * Removes all values from the sorted list, making it empty again.
-   * Returns whether the list was mutated or not.
-   */
-  clear() {
-    const hadData = this.#data.length > 0;
-    this.#data.length = 0;
-    return hadData;
-  }
-  /**
-   * Removes the first value matching the predicate.
-   * Returns whether the list was mutated or not.
-   */
-  removeBy(predicate, limit = Number.POSITIVE_INFINITY) {
-    let deleted = 0;
-    for (let i = 0; i < this.#data.length; i++) {
-      if (predicate(this.#data[i])) {
-        this.#data.splice(i, 1);
-        deleted++;
-        if (deleted >= limit) {
-          break;
-        } else {
-          i--;
-        }
-      }
-    }
-    return deleted > 0;
-  }
-  /**
-   * Removes the given value from the sorted list, if it exists. The given
-   * value must be `===` to one of the list items. Only the first entry will be
-   * removed if the element exists in the sorted list multiple times.
-   *
-   * Returns whether the list was mutated or not.
-   */
-  remove(value) {
-    const idx = this.#data.indexOf(value);
-    if (idx >= 0) {
-      this.#data.splice(idx, 1);
-      return true;
-    }
-    return false;
-  }
-  at(index) {
-    return this.#data[index];
-  }
-  get length() {
-    return this.#data.length;
-  }
-  *filter(predicate) {
-    for (const item of this.#data) {
-      if (predicate(item)) {
-        yield item;
-      }
-    }
-  }
-  // XXXX If we keep this, add unit tests. Or remove it.
-  *findAllRight(predicate) {
-    for (let i = this.#data.length - 1; i >= 0; i--) {
-      const item = this.#data[i];
-      if (predicate(item, i)) {
-        yield item;
-      }
-    }
-  }
-  [Symbol.iterator]() {
-    return this.#data[Symbol.iterator]();
-  }
-  *iterReversed() {
-    for (let i = this.#data.length - 1; i >= 0; i--) {
-      yield this.#data[i];
-    }
-  }
-  /** Finds the leftmost item that matches the predicate. */
-  find(predicate, start) {
-    const idx = this.findIndex(predicate, start);
-    return idx > -1 ? this.#data.at(idx) : void 0;
-  }
-  /** Finds the leftmost index that matches the predicate. */
-  findIndex(predicate, start = 0) {
-    for (let i = Math.max(0, start); i < this.#data.length; i++) {
-      if (predicate(this.#data[i], i)) {
-        return i;
-      }
-    }
-    return -1;
-  }
-  /** Finds the rightmost item that matches the predicate. */
-  findRight(predicate, start) {
-    const idx = this.findIndexRight(predicate, start);
-    return idx > -1 ? this.#data.at(idx) : void 0;
-  }
-  /** Finds the rightmost index that matches the predicate. */
-  findIndexRight(predicate, start = this.#data.length - 1) {
-    for (let i = Math.min(start, this.#data.length - 1); i >= 0; i--) {
-      if (predicate(this.#data[i], i)) {
-        return i;
-      }
-    }
-    return -1;
-  }
-  get rawArray() {
-    return this.#data;
-  }
-};
-
 // src/lib/TreePool.ts
 var TreePool = class {
   #_items;
@@ -4151,39 +4215,29 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
   };
 }
 function createStore_forUserAiChats() {
-  const allChatsInclDeleted\u03A3 = new MutableSignal(
-    SortedList.with((x, y) => y.createdAt < x.createdAt)
-  );
-  const nonDeletedChats\u03A3 = DerivedSignal.from(
-    () => Array.from(allChatsInclDeleted\u03A3.get()).filter((c) => !c.deletedAt)
-  );
+  const chatsDB = new AiChatDB();
   function upsertMany(chats) {
-    allChatsInclDeleted\u03A3.mutate((list) => {
+    batch(() => {
       for (const chat of chats) {
-        list.removeBy((c) => c.id === chat.id, 1);
-        list.add(chat);
+        chatsDB.upsert(chat);
       }
     });
   }
   function upsert(chat) {
-    upsertMany([chat]);
+    chatsDB.upsert(chat);
   }
   function markDeleted(chatId) {
-    allChatsInclDeleted\u03A3.mutate((list) => {
-      const chat = list.find((c) => c.id === chatId);
-      if (!chat) return false;
-      upsert({ ...chat, deletedAt: now() });
-      return void 0;
-    });
+    chatsDB.markDeleted(chatId);
   }
   function getChatById(chatId) {
-    return Array.from(allChatsInclDeleted\u03A3.get()).find(
-      (chat) => chat.id === chatId
-    );
+    return chatsDB.getEvenIfDeleted(chatId);
+  }
+  function findMany(query) {
+    return chatsDB.signal.get().findMany(query);
   }
   return {
-    chats\u03A3: nonDeletedChats\u03A3,
     getChatById,
+    findMany,
     // Mutations
     upsert,
     upsertMany,
@@ -4396,7 +4450,8 @@ function createAi(config) {
   function getChats(options = {}) {
     return sendClientMsgWithResponse({
       cmd: "get-chats",
-      cursor: options.cursor
+      cursor: options.cursor,
+      query: options.query
     });
   }
   function getOrCreateChat(id, options) {
@@ -4461,7 +4516,9 @@ function createAi(config) {
       deleteMessage: (chatId, messageId) => sendClientMsgWithResponse({ cmd: "delete-message", chatId, messageId }),
       clearChat: (chatId) => sendClientMsgWithResponse({ cmd: "clear-chat", chatId }),
       askUserMessageInChat: async (chatId, userMessage, targetMessageId, options) => {
-        const knowledge = context.knowledge.get();
+        const globalKnowledge = context.knowledge.get();
+        const requestKnowledge = options?.knowledge || [];
+        const combinedKnowledge = [...globalKnowledge, ...requestKnowledge];
         const tools = context.toolsStore.getToolDescriptions(chatId);
         const resp = await sendClientMsgWithResponse({
           cmd: "ask-in-chat",
@@ -4472,9 +4529,8 @@ function createAi(config) {
             copilotId: options?.copilotId,
             stream: options?.stream,
             timeout: options?.timeout,
-            // Knowledge and tools aren't coming from the options, but retrieved
-            // from the global context
-            knowledge: knowledge.length > 0 ? knowledge : void 0,
+            // Combine global knowledge with request-specific knowledge
+            knowledge: combinedKnowledge.length > 0 ? combinedKnowledge : void 0,
             tools: tools.length > 0 ? tools : void 0
           }
         });
@@ -4485,11 +4541,11 @@ function createAi(config) {
       setToolResult,
       getStatus: () => managedSocket.getStatus(),
       signals: {
-        chats\u03A3: context.chatsStore.chats\u03A3,
         getChatMessagesForBranch\u03A3: context.messagesStore.getChatMessagesForBranch\u03A3,
         getTool\u03A3: context.toolsStore.getTool\u03A3
       },
       getChatById: context.chatsStore.getChatById,
+      queryChats: context.chatsStore.findMany,
       registerKnowledgeLayer,
       deregisterKnowledgeLayer,
       updateKnowledge,