mindcache 3.4.2 → 3.4.3

package/dist/server.js

@@ -0,0 +1,2280 @@
+'use strict';
+
+var syncProtocol = require('y-protocols/sync');
+var encoding = require('lib0/encoding');
+var decoding = require('lib0/decoding');
+var Y = require('yjs');
+var yIndexeddb = require('y-indexeddb');
+var diff = require('fast-diff');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var syncProtocol__namespace = /*#__PURE__*/_interopNamespace(syncProtocol);
+var encoding__namespace = /*#__PURE__*/_interopNamespace(encoding);
+var decoding__namespace = /*#__PURE__*/_interopNamespace(decoding);
+var Y__namespace = /*#__PURE__*/_interopNamespace(Y);
+var diff__default = /*#__PURE__*/_interopDefault(diff);
+
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/local/IndexedDBAdapter.ts
+var IndexedDBAdapter_exports = {};
+__export(IndexedDBAdapter_exports, {
+  IndexedDBAdapter: () => exports.IndexedDBAdapter
+});
+exports.IndexedDBAdapter = void 0;
+var init_IndexedDBAdapter = __esm({
+  "src/local/IndexedDBAdapter.ts"() {
+    exports.IndexedDBAdapter = class {
+      constructor(config = {}) {
+        this.config = config;
+        this.dbName = config.dbName || "mindcache_db";
+        this.storeName = config.storeName || "mindcache_store";
+        this.key = config.key || "mindcache_data";
+      }
+      mindcache = null;
+      unsubscribe = null;
+      saveTimeout = null;
+      db = null;
+      dbName;
+      storeName;
+      key;
+      async attach(mc) {
+        if (this.mindcache) {
+          this.detach();
+        }
+        this.mindcache = mc;
+        await this.initDB();
+        await this.load();
+        const listener = () => {
+          if (this.mindcache) {
+            this.scheduleSave();
+          }
+        };
+        mc.subscribeToAll(listener);
+        this.unsubscribe = () => mc.unsubscribeFromAll(listener);
+        console.log("\u{1F5C4}\uFE0F IndexedDBAdapter: Attached to MindCache instance");
+      }
+      detach() {
+        if (this.unsubscribe) {
+          this.unsubscribe();
+          this.unsubscribe = null;
+        }
+        if (this.saveTimeout) {
+          clearTimeout(this.saveTimeout);
+          this.saveTimeout = null;
+        }
+        this.mindcache = null;
+        if (this.db) {
+          this.db.close();
+          this.db = null;
+        }
+      }
+      initDB() {
+        return new Promise((resolve, reject) => {
+          const request = indexedDB.open(this.dbName);
+          request.onerror = () => {
+            console.error("MindCache: IndexedDB error:", request.error);
+            reject(request.error);
+          };
+          request.onsuccess = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(this.storeName)) {
+              const currentVersion = db.version;
+              db.close();
+              const upgradeRequest = indexedDB.open(this.dbName, currentVersion + 1);
+              upgradeRequest.onerror = () => {
+                console.error("MindCache: IndexedDB upgrade error:", upgradeRequest.error);
+                reject(upgradeRequest.error);
+              };
+              upgradeRequest.onupgradeneeded = () => {
+                const upgradeDb = upgradeRequest.result;
+                if (!upgradeDb.objectStoreNames.contains(this.storeName)) {
+                  upgradeDb.createObjectStore(this.storeName);
+                }
+              };
+              upgradeRequest.onsuccess = () => {
+                this.db = upgradeRequest.result;
+                resolve();
+              };
+            } else {
+              this.db = db;
+              resolve();
+            }
+          };
+          request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(this.storeName)) {
+              db.createObjectStore(this.storeName);
+            }
+          };
+        });
+      }
+      load() {
+        if (!this.db || !this.mindcache) {
+          return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+          try {
+            const transaction = this.db.transaction([this.storeName], "readonly");
+            const store = transaction.objectStore(this.storeName);
+            const request = store.get(this.key);
+            request.onsuccess = () => {
+              if (request.result) {
+                this.mindcache.deserialize(request.result);
+                console.log("\u{1F5C4}\uFE0F IndexedDBAdapter: Loaded data from IndexedDB");
+              }
+              resolve();
+            };
+            request.onerror = () => {
+              console.error("MindCache: Failed to load from IndexedDB:", request.error);
+              resolve();
+            };
+          } catch (error) {
+            console.error("MindCache: Error accessing IndexedDB for load:", error);
+            resolve();
+          }
+        });
+      }
+      scheduleSave() {
+        if (this.saveTimeout) {
+          clearTimeout(this.saveTimeout);
+        }
+        this.saveTimeout = setTimeout(() => {
+          this.save();
+          this.saveTimeout = null;
+        }, this.config.debounceMs ?? 1e3);
+      }
+      save() {
+        if (!this.db || !this.mindcache) {
+          return;
+        }
+        try {
+          const data = this.mindcache.serialize();
+          const transaction = this.db.transaction([this.storeName], "readwrite");
+          const store = transaction.objectStore(this.storeName);
+          const request = store.put(data, this.key);
+          request.onsuccess = () => {
+            console.log("\u{1F5C4}\uFE0F IndexedDBAdapter: Saved to IndexedDB");
+          };
+          request.onerror = () => {
+            console.error("MindCache: Failed to save to IndexedDB:", request.error);
+          };
+        } catch (error) {
+          console.error("MindCache: Error accessing IndexedDB for save:", error);
+        }
+      }
+    };
+  }
+});
+
+// src/cloud/CloudAdapter.ts
+var CloudAdapter_exports = {};
+__export(CloudAdapter_exports, {
+  CloudAdapter: () => exports.CloudAdapter
+});
+var RECONNECT_DELAY, MAX_RECONNECT_DELAY; exports.CloudAdapter = void 0;
+var init_CloudAdapter = __esm({
+  "src/cloud/CloudAdapter.ts"() {
+    RECONNECT_DELAY = 1e3;
+    MAX_RECONNECT_DELAY = 3e4;
+    exports.CloudAdapter = class {
+      // Track if initial sync is complete
+      constructor(config) {
+        this.config = config;
+        if (!config.baseUrl) {
+          throw new Error("MindCache Cloud: baseUrl is required. Please provide the cloud API URL in your configuration.");
+        }
+        this.setupNetworkDetection();
+      }
+      ws = null;
+      mindcache = null;
+      unsubscribe = null;
+      reconnectAttempts = 0;
+      reconnectTimeout = null;
+      _state = "disconnected";
+      _isOnline = true;
+      // Browser network status
+      listeners = {};
+      token = null;
+      handleOnline = null;
+      handleOffline = null;
+      _synced = false;
+      /** Browser network status - instantly updated via navigator.onLine */
+      get isOnline() {
+        return this._isOnline;
+      }
+      setupNetworkDetection() {
+        if (typeof window === "undefined" || typeof navigator === "undefined") {
+          return;
+        }
+        this._isOnline = navigator.onLine;
+        this.handleOnline = () => {
+          console.log("\u2601\uFE0F CloudAdapter: Network is back online");
+          this._isOnline = true;
+          this.emit("network_online");
+          if (this._state === "disconnected" || this._state === "error") {
+            this.connect();
+          }
+        };
+        this.handleOffline = () => {
+          console.log("\u2601\uFE0F CloudAdapter: Network went offline");
+          this._isOnline = false;
+          this.emit("network_offline");
+          if (this._state === "connected" || this._state === "connecting") {
+            this._state = "disconnected";
+            this.emit("disconnected");
+          }
+        };
+        window.addEventListener("online", this.handleOnline);
+        window.addEventListener("offline", this.handleOffline);
+      }
+      cleanupNetworkDetection() {
+        if (typeof window === "undefined") {
+          return;
+        }
+        if (this.handleOnline) {
+          window.removeEventListener("online", this.handleOnline);
+        }
+        if (this.handleOffline) {
+          window.removeEventListener("offline", this.handleOffline);
+        }
+      }
+      setToken(token) {
+        this.token = token;
+      }
+      setTokenProvider(provider) {
+        this.config.tokenProvider = provider;
+      }
+      get state() {
+        return this._state;
+      }
+      attach(mc) {
+        if (this.mindcache) {
+          this.detach();
+        }
+        this.mindcache = mc;
+        mc.doc.on("update", (update, origin) => {
+          if (origin !== this && this.ws && this.ws.readyState === WebSocket.OPEN) {
+            const encoder = encoding__namespace.createEncoder();
+            syncProtocol__namespace.writeUpdate(encoder, update);
+            this.sendBinary(encoding__namespace.toUint8Array(encoder));
+          }
+        });
+        console.log("\u2601\uFE0F CloudAdapter: Attached to MindCache instance");
+      }
+      detach() {
+        if (this.unsubscribe) {
+          this.unsubscribe();
+          this.unsubscribe = null;
+        }
+        this.mindcache = null;
+      }
+      async fetchTokenWithApiKey() {
+        if (!this.config.apiKey) {
+          throw new Error("API key is required to fetch token");
+        }
+        const httpBaseUrl = this.config.baseUrl.replace("wss://", "https://").replace("ws://", "http://");
+        const isDelegate = this.config.apiKey.startsWith("del_") && this.config.apiKey.includes(":");
+        const authHeader = isDelegate ? `ApiKey ${this.config.apiKey}` : `Bearer ${this.config.apiKey}`;
+        const response = await fetch(`${httpBaseUrl}/api/ws-token`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": authHeader
+          },
+          body: JSON.stringify({
+            instanceId: this.config.instanceId,
+            permission: "write"
+          })
+        });
+        if (!response.ok) {
+          const error = await response.json().catch(() => ({ error: "Failed to get token" }));
+          throw new Error(error.error || `Failed to get WebSocket token: ${response.status}`);
+        }
+        const data = await response.json();
+        return data.token;
+      }
+      async connect() {
+        if (this._state === "connecting" || this._state === "connected") {
+          return;
+        }
+        this._state = "connecting";
+        try {
+          if (!this.token) {
+            if (this.config.tokenProvider) {
+              this.token = await this.config.tokenProvider();
+            } else if (this.config.apiKey) {
+              this.token = await this.fetchTokenWithApiKey();
+            }
+          }
+          let url = `${this.config.baseUrl}/sync/${this.config.instanceId}`;
+          if (this.token) {
+            url += `?token=${encodeURIComponent(this.token)}`;
+            this.token = null;
+          } else {
+            throw new Error("MindCache Cloud: No authentication method available. Provide apiKey or tokenProvider.");
+          }
+          this.ws = new WebSocket(url);
+          this.ws.binaryType = "arraybuffer";
+          this.setupWebSocket();
+        } catch (error) {
+          this._state = "error";
+          this.emit("error", error);
+          this.scheduleReconnect();
+        }
+      }
+      disconnect() {
+        if (this.reconnectTimeout) {
+          clearTimeout(this.reconnectTimeout);
+          this.reconnectTimeout = null;
+        }
+        if (this.ws) {
+          this.ws.close();
+          this.ws = null;
+        }
+        this.cleanupNetworkDetection();
+        this._state = "disconnected";
+        this.emit("disconnected");
+      }
+      on(event, listener) {
+        if (!this.listeners[event]) {
+          this.listeners[event] = [];
+        }
+        this.listeners[event].push(listener);
+      }
+      off(event, listener) {
+        if (this.listeners[event]) {
+          this.listeners[event] = this.listeners[event].filter((l) => l !== listener);
+        }
+      }
+      emit(event, ...args) {
+        if (this.listeners[event]) {
+          this.listeners[event].forEach((listener) => listener(...args));
+        }
+      }
+      setupWebSocket() {
+        if (!this.ws) {
+          return;
+        }
+        this.ws.onopen = () => {
+          if (this.mindcache) {
+            const encoder = encoding__namespace.createEncoder();
+            syncProtocol__namespace.writeSyncStep1(encoder, this.mindcache.doc);
+            this.sendBinary(encoding__namespace.toUint8Array(encoder));
+          }
+        };
+        this.ws.onmessage = (event) => {
+          try {
+            if (typeof event.data === "string") {
+              const msg = JSON.parse(event.data);
+              if (msg.type === "auth_success") {
+                this._state = "connected";
+                this.reconnectAttempts = 0;
+                this.emit("connected");
+              } else if (msg.type === "auth_error" || msg.type === "error") {
+                this._state = "error";
+                this.emit("error", new Error(msg.error));
+              } else {
+                console.debug("MindCache Cloud: Received message type:", msg.type, msg);
+              }
+            } else {
+              const encoder = encoding__namespace.createEncoder();
+              const decoder = decoding__namespace.createDecoder(new Uint8Array(event.data));
+              if (this.mindcache) {
+                const messageType = syncProtocol__namespace.readSyncMessage(decoder, encoder, this.mindcache.doc, this);
+                if (encoding__namespace.length(encoder) > 0) {
+                  this.sendBinary(encoding__namespace.toUint8Array(encoder));
+                }
+                if (!this._synced && (messageType === 1 || messageType === 2)) {
+                  this._synced = true;
+                  this.emit("synced");
+                }
+              }
+            }
+          } catch (error) {
+            console.error("MindCache Cloud: Failed to handle message:", error);
+          }
+        };
+        this.ws.onclose = () => {
+          this._state = "disconnected";
+          this.emit("disconnected");
+          this.scheduleReconnect();
+        };
+        this.ws.onerror = () => {
+          this._state = "error";
+          this.emit("error", new Error("WebSocket connection failed"));
+        };
+      }
+      sendBinary(data) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+          this.ws.send(data);
+        }
+      }
+      scheduleReconnect() {
+        if (this.reconnectTimeout) {
+          return;
+        }
+        const delay = Math.min(
+          RECONNECT_DELAY * Math.pow(2, this.reconnectAttempts),
+          MAX_RECONNECT_DELAY
+        );
+        this.reconnectTimeout = setTimeout(async () => {
+          this.reconnectTimeout = null;
+          this.reconnectAttempts++;
+          this.connect();
+        }, delay);
+      }
+    };
+  }
+});
+
+// src/core/types.ts
+var DEFAULT_KEY_ATTRIBUTES = {
+  type: "text",
+  contentTags: [],
+  systemTags: [],
+  // Keys are private by default - explicitly add SystemPrompt/LLMRead/LLMWrite to enable LLM access
+  zIndex: 0
+};
+var SystemTagHelpers = {
+  /** Check if key is writable by LLM */
+  isLLMWritable: (attrs) => attrs.systemTags.includes("LLMWrite"),
+  /** Check if key is readable by LLM (in context or via tools) */
+  isLLMReadable: (attrs) => attrs.systemTags.includes("SystemPrompt") || attrs.systemTags.includes("LLMRead"),
+  /** Check if key is included in system prompt */
+  isInSystemPrompt: (attrs) => attrs.systemTags.includes("SystemPrompt"),
+  /** Check if key is protected from deletion */
+  isProtected: (attrs) => attrs.systemTags.includes("protected"),
+  /** Check if key uses template injection */
+  hasTemplateInjection: (attrs) => attrs.systemTags.includes("ApplyTemplate")
+};
+
+// src/core/MindCache.ts
+var MindCache = class {
+  // Public doc for adapter access
+  doc;
+  rootMap;
+  // Key -> EntryMap({value, attributes})
+  // Cache listeners
+  listeners = {};
+  globalListeners = [];
+  // Metadata
+  version = "3.3.2";
+  // Internal flag to prevent sync loops when receiving remote updates
+  // (Less critical with Yjs but kept for API compat)
+  normalizeSystemTags(tags) {
+    const normalized = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const tag of tags) {
+      if (["SystemPrompt", "LLMRead", "LLMWrite", "protected", "ApplyTemplate"].includes(tag)) {
+        if (!seen.has(tag)) {
+          seen.add(tag);
+          normalized.push(tag);
+        }
+      }
+    }
+    return normalized;
+  }
+  // Cloud sync state
+  _cloudAdapter = null;
+  _connectionState = "disconnected";
+  _isLoaded = true;
+  // Default true for local mode
+  _cloudConfig = null;
+  // Access level for system operations
+  _accessLevel = "user";
+  _initPromise = null;
+  // Y-IndexedDB provider
+  _idbProvider = null;
+  // Undo Managers Cache
+  _undoManagers = /* @__PURE__ */ new Map();
+  // Global Undo Manager (watches entire rootMap)
+  _globalUndoManager = null;
+  // History tracking
+  _history = [];
+  _historyOptions = { maxEntries: 100, snapshotInterval: 10 };
+  _historyEnabled = false;
+  constructor(options) {
+    this.doc = options?.doc || new Y__namespace.Doc();
+    this.rootMap = this.doc.getMap("mindcache");
+    this.rootMap.observeDeep((events) => {
+      const keysAffected = /* @__PURE__ */ new Set();
+      events.forEach((event) => {
+        if (event.target === this.rootMap) {
+          const mapEvent = event;
+          mapEvent.keysChanged.forEach((key) => keysAffected.add(key));
+        } else if (event.target.parent === this.rootMap) {
+          for (const [key, val] of this.rootMap) {
+            if (val === event.target) {
+              keysAffected.add(key);
+              break;
+            }
+          }
+        } else {
+          let current = event.target;
+          while (current && current.parent) {
+            if (current.parent.parent === this.rootMap) {
+              for (const [key, val] of this.rootMap) {
+                if (val === current.parent) {
+                  keysAffected.add(key);
+                  break;
+                }
+              }
+              break;
+            }
+            current = current.parent;
+          }
+        }
+      });
+      keysAffected.forEach((key) => {
+        const entryMap = this.rootMap.get(key);
+        if (entryMap) {
+          const value = entryMap.get("value");
+          const attrs = entryMap.get("attributes");
+          const resolvedValue = attrs?.type === "document" && value instanceof Y__namespace.Text ? value.toString() : value;
+          if (this.listeners[key]) {
+            this.listeners[key].forEach((l) => l(resolvedValue));
+          }
+        } else {
+          if (this.listeners[key]) {
+            this.listeners[key].forEach((l) => l(void 0));
+          }
+        }
+      });
+      this.notifyGlobalListeners();
+    });
+    this.initGlobalUndoManager();
+    if (options?.accessLevel) {
+      this._accessLevel = options.accessLevel;
+    }
+    const initPromises = [];
+    if (options?.cloud) {
+      this._cloudConfig = options.cloud;
+      this._isLoaded = false;
+      this._connectionState = "disconnected";
+      initPromises.push(this._initCloud());
+      if (typeof window !== "undefined") {
+        const dbName = `mindcache_cloud_${options.cloud.instanceId}`;
+        initPromises.push(this._initYIndexedDB(dbName));
+      }
+      this.enableHistory(options.history);
+    }
+    if (options?.indexedDB && !options?.cloud) {
+      this._isLoaded = false;
+      initPromises.push(this._initYIndexedDB(options.indexedDB.dbName || "mindcache_yjs_db"));
+      this.enableHistory(options.history);
+    }
+    if (initPromises.length > 0) {
+      this._initPromise = Promise.all(initPromises).then(() => {
+        if (!this._cloudConfig) {
+          this._isLoaded = true;
+        }
+      });
+    }
+  }
+  // Helper: Get or Create UndoManager for a key
+  getUndoManager(key) {
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return void 0;
+    }
+    if (!this._undoManagers.has(key)) {
+      const um = new Y__namespace.UndoManager(entryMap, {
+        captureTimeout: 500
+      });
+      this._undoManagers.set(key, um);
+    }
+    return this._undoManagers.get(key);
+  }
+  /**
+   * Undo changes for a specific key
+   */
+  undo(key) {
+    const um = this.getUndoManager(key);
+    if (um) {
+      um.undo();
+    }
+  }
+  /**
+   * Redo changes for a specific key
+   */
+  redo(key) {
+    const um = this.getUndoManager(key);
+    if (um) {
+      um.redo();
+    }
+  }
+  getHistory(key) {
+    const um = this.getUndoManager(key);
+    if (!um) {
+      return [];
+    }
+    return um.undoStack;
+  }
+  // Initialize global undo manager (watches entire rootMap)
+  initGlobalUndoManager() {
+    if (!this._globalUndoManager) {
+      this._globalUndoManager = new Y__namespace.UndoManager(this.rootMap, {
+        captureTimeout: 500
+      });
+    }
+  }
+  /**
+   * Undo all recent local changes (across all keys)
+   * Only undoes YOUR changes, not changes from other users in cloud mode
+   */
+  undoAll() {
+    this.initGlobalUndoManager();
+    this._globalUndoManager?.undo();
+  }
+  /**
+   * Redo previously undone local changes
+   */
+  redoAll() {
+    this.initGlobalUndoManager();
+    this._globalUndoManager?.redo();
+  }
+  /**
+   * Check if there are changes to undo globally
+   */
+  canUndoAll() {
+    this.initGlobalUndoManager();
+    return (this._globalUndoManager?.undoStack.length ?? 0) > 0;
+  }
+  /**
+   * Check if there are changes to redo globally
+   */
+  canRedoAll() {
+    this.initGlobalUndoManager();
+    return (this._globalUndoManager?.redoStack.length ?? 0) > 0;
+  }
+  // Enable history tracking (called for IndexedDB and Cloud modes)
+  enableHistory(options) {
+    if (this._historyEnabled) {
+      return;
+    }
+    this._historyEnabled = true;
+    if (options) {
+      this._historyOptions = { ...this._historyOptions, ...options };
+    }
+    this.rootMap.observeDeep((events) => {
+      const keysAffected = /* @__PURE__ */ new Set();
+      events.forEach((event) => {
+        if (event.target === this.rootMap) {
+          const mapEvent = event;
+          mapEvent.keysChanged.forEach((key) => keysAffected.add(key));
+        } else {
+          let current = event.target;
+          while (current && current.parent) {
+            if (current.parent === this.rootMap) {
+              for (const [key, val] of this.rootMap) {
+                if (val === current) {
+                  keysAffected.add(key);
+                  break;
+                }
+              }
+              break;
+            }
+            current = current.parent;
+          }
+        }
+      });
+      if (keysAffected.size > 0) {
+        const entry = {
+          id: this.generateId(),
+          timestamp: Date.now(),
+          keysAffected: Array.from(keysAffected)
+        };
+        this._history.push(entry);
+        const max = this._historyOptions.maxEntries || 100;
+        if (this._history.length > max) {
+          this._history = this._history.slice(-max);
+        }
+      }
+    });
+  }
+  generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+  }
+  /**
+   * Get global history of all changes (available in IndexedDB and Cloud modes)
+   */
+  getGlobalHistory() {
+    return [...this._history];
+  }
+  /**
+   * Check if history tracking is enabled
+   */
+  get historyEnabled() {
+    return this._historyEnabled;
+  }
+  /**
+   * Restore to a specific version (time travel)
+   * Note: Full implementation requires storing update binaries, which is not yet implemented.
+   * @returns false - not yet fully implemented
+   */
+  restoreToVersion(_versionId) {
+    console.warn("restoreToVersion: Full implementation requires storing update binaries. Not yet implemented.");
+    return false;
+  }
+  get accessLevel() {
+    return this._accessLevel;
+  }
+  get hasSystemAccess() {
+    return this._accessLevel === "system";
+  }
+  async _initCloud() {
+    if (!this._cloudConfig) {
+      return;
+    }
+    const CloudAdapter2 = await this._getCloudAdapterClass();
+    if (!this._cloudConfig.baseUrl) ;
+    const baseUrl = (this._cloudConfig.baseUrl || "https://api.mindcache.dev").replace("https://", "wss://").replace("http://", "ws://");
+    const adapter = new CloudAdapter2({
+      instanceId: this._cloudConfig.instanceId,
+      projectId: this._cloudConfig.projectId || "default",
+      baseUrl,
+      apiKey: this._cloudConfig.apiKey
+    });
+    if (this._cloudConfig.tokenProvider) {
+      adapter.setTokenProvider(this._cloudConfig.tokenProvider);
+    } else if (this._cloudConfig.tokenEndpoint) {
+      const tokenEndpoint = this._cloudConfig.tokenEndpoint;
+      const instanceId = this._cloudConfig.instanceId;
+      let resolvedBaseUrl;
+      if (tokenEndpoint.startsWith("http://") || tokenEndpoint.startsWith("https://")) {
+        resolvedBaseUrl = tokenEndpoint;
+      } else if (typeof window !== "undefined" && window.location?.origin) {
+        resolvedBaseUrl = `${window.location.origin}${tokenEndpoint.startsWith("/") ? "" : "/"}${tokenEndpoint}`;
+      } else {
+        resolvedBaseUrl = tokenEndpoint;
+      }
+      adapter.setTokenProvider(async () => {
+        const url = resolvedBaseUrl.includes("?") ? `${resolvedBaseUrl}&instanceId=${instanceId}` : `${resolvedBaseUrl}?instanceId=${instanceId}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error("Failed to get token");
+        }
+        const data = await response.json();
+        return data.token;
+      });
+    }
+    adapter.on("connected", () => {
+      this._connectionState = "connected";
+      this.notifyGlobalListeners();
+    });
+    adapter.on("disconnected", () => {
+      this._connectionState = "disconnected";
+      this.notifyGlobalListeners();
+    });
+    adapter.on("error", () => {
+      this._connectionState = "error";
+      this.notifyGlobalListeners();
+    });
+    adapter.on("synced", () => {
+      this._isLoaded = true;
+      this.notifyGlobalListeners();
+    });
+    adapter.attach(this);
+    this._cloudAdapter = adapter;
+    this._connectionState = "connecting";
+    adapter.connect();
+  }
+  async _initYIndexedDB(dbName) {
+    if (typeof window === "undefined") {
+      return;
+    }
+    this._idbProvider = new yIndexeddb.IndexeddbPersistence(dbName, this.doc);
+    return new Promise((resolve) => {
+      if (!this._idbProvider) {
+        return resolve();
+      }
+      this._idbProvider.on("synced", () => {
+        this._isLoaded = true;
+        resolve();
+      });
+    });
+  }
+  // Legacy IndexedDB method stub
+  async _initIndexedDB(_config) {
+  }
+  async _getIndexedDBAdapterClass() {
+    const { IndexedDBAdapter: IndexedDBAdapter2 } = await Promise.resolve().then(() => (init_IndexedDBAdapter(), IndexedDBAdapter_exports));
+    return IndexedDBAdapter2;
+  }
+  get connectionState() {
+    return this._connectionState;
+  }
+  get isLoaded() {
+    return this._isLoaded;
+  }
+  async _getCloudAdapterClass() {
+    const { CloudAdapter: CloudAdapter2 } = await Promise.resolve().then(() => (init_CloudAdapter(), CloudAdapter_exports));
+    return CloudAdapter2;
+  }
+  get isCloud() {
+    return this._cloudConfig !== null;
+  }
+  /**
+   * Browser network status. Returns true if online or in local-only mode.
+   * In cloud mode, this updates instantly when network status changes.
+   */
+  get isOnline() {
+    if (!this._cloudAdapter) {
+      if (typeof navigator !== "undefined") {
+        return navigator.onLine;
+      }
+      return true;
+    }
+    return this._cloudAdapter.isOnline;
+  }
+  async waitForSync() {
+    if (this._isLoaded) {
+      return;
+    }
+    if (this._initPromise) {
+      await this._initPromise;
+    }
+    if (this._isLoaded) {
+      return;
+    }
+    return new Promise((resolve) => {
+      if (this._isLoaded) {
+        return resolve();
+      }
+      const interval = setInterval(() => {
+        if (this._isLoaded) {
+          clearInterval(interval);
+          resolve();
+        }
+      }, 100);
+    });
+  }
+  disconnect() {
+    if (this._cloudAdapter) {
+      this._cloudAdapter.disconnect();
+      this._cloudAdapter.detach();
+      this._cloudAdapter = null;
+      this._connectionState = "disconnected";
+    }
+    if (this._idbProvider) {
+      this._idbProvider.destroy();
+      this._idbProvider = null;
+    }
+  }
+  // Serialize state
+  serialize() {
+    const json = {};
+    for (const [key, val] of this.rootMap) {
+      const entryMap = val;
+      const attrs = entryMap.get("attributes");
+      let value = entryMap.get("value");
+      if (attrs?.type === "document" && value instanceof Y__namespace.Text) {
+        value = value.toString();
+      }
+      json[key] = {
+        value,
+        attributes: attrs
+      };
+    }
+    return json;
+  }
+  // Deserialize state (for IndexedDBAdapter compatibility)
+  deserialize(data) {
+    if (!data || typeof data !== "object") {
+      return;
+    }
+    this.doc.transact(() => {
+      for (const key of this.rootMap.keys()) {
+        this.rootMap.delete(key);
+      }
+      for (const [key, entry] of Object.entries(data)) {
+        if (key.startsWith("$")) {
+          continue;
+        }
+        const entryMap = new Y__namespace.Map();
+        this.rootMap.set(key, entryMap);
+        entryMap.set("value", entry.value);
+        const attrs = entry.attributes || {};
+        const normalizedAttrs = {
+          type: attrs.type || "text",
+          contentType: attrs.contentType,
+          contentTags: attrs.contentTags || [],
+          systemTags: this.normalizeSystemTags(attrs.systemTags || []),
+          zIndex: attrs.zIndex ?? 0
+        };
+        entryMap.set("attributes", normalizedAttrs);
+      }
+    });
+  }
+  encodeFileToBase64(file) {
+    return new Promise((resolve, reject) => {
+      if (typeof FileReader !== "undefined") {
+        const reader = new FileReader();
+        reader.onload = () => {
+          const result = reader.result;
+          const base64Data = result.split(",")[1];
+          resolve(base64Data);
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(file);
+      } else {
+        reject(new Error("FileReader not available in Node.js environment. Use set_base64() method instead."));
+      }
+    });
+  }
+  createDataUrl(base64Data, contentType) {
+    return `data:${contentType};base64,${base64Data}`;
+  }
+  validateContentType(type, contentType) {
+    if (type === "text" || type === "json") {
+      return true;
+    }
+    if (!contentType) {
+      return false;
+    }
+    if (type === "image") {
+      return contentType.startsWith("image/");
+    }
+    if (type === "file") {
+      return true;
+    }
+    return false;
+  }
+  // InjectSTM replacement (private helper)
+  _injectSTMInternal(template, _processingStack) {
+    return template.replace(/\{\{([^}]+)\}\}/g, (_, key) => {
+      const val = this.get_value(key.trim(), _processingStack);
+      return val !== void 0 ? String(val) : `{{${key}}}`;
+    });
+  }
+  /**
+   * Replace {{key}} placeholders in a template string with values from MindCache.
+   * @param template The template string with {{key}} placeholders
+   * @returns The template with placeholders replaced by values
+   */
+  injectSTM(template) {
+    return this._injectSTMInternal(template, /* @__PURE__ */ new Set());
+  }
+  // Public API Methods
+  getAll() {
+    const result = {};
+    for (const [key] of this.rootMap) {
+      result[key] = this.get_value(key);
+    }
+    result["$date"] = this.get_value("$date");
+    result["$time"] = this.get_value("$time");
+    return result;
+  }
+  /**
+   * Get all entries with their full structure (value + attributes).
+   * Use this for UI/admin interfaces that need to display key properties.
+   * Unlike serialize(), this format is stable and won't change.
+   */
+  getAllEntries() {
+    const result = {};
+    for (const [key] of this.rootMap) {
+      const value = this.get_value(key);
+      const attributes = this.get_attributes(key);
+      if (attributes) {
+        result[key] = { value, attributes };
+      }
+    }
+    return result;
+  }
+  get_value(key, _processingStack) {
+    if (key === "$date") {
+      const today = /* @__PURE__ */ new Date();
+      return today.toISOString().split("T")[0];
+    }
+    if (key === "$time") {
+      const now = /* @__PURE__ */ new Date();
+      return now.toTimeString().split(" ")[0];
+    }
+    if (key === "$version") {
+      return this.version;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return void 0;
+    }
+    const attributes = entryMap.get("attributes");
+    const value = entryMap.get("value");
+    if (attributes?.type === "document" && value instanceof Y__namespace.Text) {
+      return value.toString();
+    }
+    if (_processingStack && _processingStack.has(key)) {
+      return `{{${key}}}`;
+    }
+    if (attributes?.systemTags?.includes("ApplyTemplate")) {
+      if (typeof value === "string") {
+        const stack = _processingStack || /* @__PURE__ */ new Set();
+        stack.add(key);
+        return this._injectSTMInternal(value, stack);
+      }
+    }
+    return value;
+  }
+  get_attributes(key) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return {
+        type: "text",
+        contentTags: [],
+        systemTags: ["SystemPrompt", "protected"],
+        zIndex: 999999
+      };
+    }
+    const entryMap = this.rootMap.get(key);
+    return entryMap ? entryMap.get("attributes") : void 0;
+  }
+  /**
+   * Update only the attributes of a key without modifying the value.
+   * Useful for updating tags, permissions etc. on document type keys.
+   */
+  set_attributes(key, attributes) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return;
+    }
+    this.doc.transact(() => {
+      const existingAttrs = entryMap.get("attributes");
+      const mergedAttrs = { ...existingAttrs, ...attributes };
+      if (mergedAttrs.systemTags) {
+        mergedAttrs.systemTags = this.normalizeSystemTags(mergedAttrs.systemTags);
+      }
+      entryMap.set("attributes", mergedAttrs);
+      const currentValue = entryMap.get("value");
+      if (mergedAttrs.type === "document" && !(currentValue instanceof Y__namespace.Text)) {
+        const strValue = typeof currentValue === "string" ? currentValue : String(currentValue ?? "");
+        entryMap.set("value", new Y__namespace.Text(strValue));
+        this.getUndoManager(key);
+      } else if (mergedAttrs.type !== "document" && currentValue instanceof Y__namespace.Text) {
+        entryMap.set("value", currentValue.toString());
+      }
+    });
+  }
+  set_value(key, value, attributes) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return;
+    }
+    const existingEntry = this.rootMap.get(key);
+    if (existingEntry) {
+      const existingAttrs = existingEntry.get("attributes");
+      if (existingAttrs?.type === "document") {
+        if (!attributes?.type || attributes.type === "document") {
+          if (typeof value === "string") {
+            this._replaceDocumentText(key, value);
+          }
+          if (attributes) {
+            this.set_attributes(key, attributes);
+          }
+          return;
+        }
+      }
+    }
+    if (!existingEntry && attributes?.type === "document") {
+      this.set_document(key, typeof value === "string" ? value : "", attributes);
+      return;
+    }
+    let entryMap = this.rootMap.get(key);
+    const isNewEntry = !entryMap;
+    if (isNewEntry) {
+      entryMap = new Y__namespace.Map();
+      this.rootMap.set(key, entryMap);
+    }
+    this.getUndoManager(key);
+    this.doc.transact(() => {
+      const oldAttributes = isNewEntry ? {
+        ...DEFAULT_KEY_ATTRIBUTES
+      } : entryMap.get("attributes");
+      const finalAttributes = attributes ? { ...oldAttributes, ...attributes } : oldAttributes;
+      let normalizedAttributes = { ...finalAttributes };
+      if (finalAttributes.systemTags) {
+        normalizedAttributes.systemTags = this.normalizeSystemTags(finalAttributes.systemTags);
+      }
+      let valueToSet = value;
+      if (normalizedAttributes.type === "document" && !(valueToSet instanceof Y__namespace.Text)) {
+        valueToSet = new Y__namespace.Text(typeof value === "string" ? value : String(value ?? ""));
+      } else if (normalizedAttributes.type !== "document" && valueToSet instanceof Y__namespace.Text) {
+        valueToSet = valueToSet.toString();
+      }
+      entryMap.set("value", valueToSet);
+      entryMap.set("attributes", normalizedAttributes);
+    });
+  }
+  /**
+   * LLM-safe method to write a value to a key.
+   * This method:
+   * - Only updates the value, never modifies attributes/systemTags
+   * - Checks LLMWrite permission before writing
+   * - Returns false if key doesn't exist or lacks LLMWrite permission
+   *
+   * Used by create_vercel_ai_tools() to prevent LLMs from escalating privileges.
+   */
+  llm_set_key(key, value) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    if (!attributes?.systemTags?.includes("LLMWrite")) {
+      return false;
+    }
+    if (attributes.type === "document") {
+      if (typeof value === "string") {
+        this._replaceDocumentText(key, value);
+      }
+      return true;
+    }
+    this.doc.transact(() => {
+      entryMap.set("value", value);
+    });
+    return true;
+  }
+  delete_key(key) {
+    if (key === "$date" || key === "$time") {
+      return;
+    }
+    this.rootMap.delete(key);
+  }
+  clear() {
+    const keys = Array.from(this.rootMap.keys());
+    this.doc.transact(() => {
+      keys.forEach((k) => this.rootMap.delete(k));
+    });
+  }
+  // ============================================
+  // Restored Methods (from v2.x)
+  // ============================================
+  /**
+   * Check if a key exists in MindCache.
+   */
+  has(key) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return true;
+    }
+    return this.rootMap.has(key);
+  }
+  /**
+   * Delete a key from MindCache.
+   * @returns true if the key existed and was deleted
+   */
+  delete(key) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    if (!this.rootMap.has(key)) {
+      return false;
+    }
+    this.rootMap.delete(key);
+    this.notifyGlobalListeners();
+    if (this.listeners[key]) {
+      this.listeners[key].forEach((listener) => listener(void 0));
+    }
+    return true;
+  }
+  /** @deprecated Use get_value instead */
+  get(key) {
+    return this.get_value(key);
+  }
+  /** @deprecated Use set_value instead */
+  set(key, value) {
+    this.set_value(key, value);
+  }
+  /**
+   * Update multiple values at once from an object.
+   * @deprecated Use set_value for individual keys
+   */
+  update(data) {
+    this.doc.transact(() => {
+      for (const [key, value] of Object.entries(data)) {
+        if (key !== "$date" && key !== "$time" && key !== "$version") {
+          this.set_value(key, value);
+        }
+      }
+    });
+    this.notifyGlobalListeners();
+  }
+  /**
+   * Get the number of keys in MindCache.
+   */
+  size() {
+    return this.rootMap.size + 2;
+  }
+  /**
+   * Get all keys in MindCache (including temporal keys).
+   */
+  keys() {
+    const keys = Array.from(this.rootMap.keys());
+    keys.push("$date", "$time");
+    return keys;
+  }
+  /**
+   * Get all values in MindCache (including temporal values).
+   */
+  values() {
+    const result = [];
+    for (const [key] of this.rootMap) {
+      result.push(this.get_value(key));
+    }
+    result.push(this.get_value("$date"));
+    result.push(this.get_value("$time"));
+    return result;
+  }
+  /**
+   * Get all key-value entries (including temporal entries).
+   */
+  entries() {
+    const result = [];
+    for (const [key] of this.rootMap) {
+      result.push([key, this.get_value(key)]);
+    }
+    result.push(["$date", this.get_value("$date")]);
+    result.push(["$time", this.get_value("$time")]);
+    return result;
+  }
+  /**
+   * Unsubscribe from key changes.
+   * @deprecated Use the cleanup function returned by subscribe() instead
+   */
+  unsubscribe(key, listener) {
+    if (this.listeners[key]) {
+      this.listeners[key] = this.listeners[key].filter((l) => l !== listener);
+    }
+  }
+  /**
+   * Get the STM as a formatted string for LLM context.
+   * @deprecated Use get_system_prompt() instead
+   */
+  getSTM() {
+    return this.get_system_prompt();
+  }
+  /**
+   * Get the STM as an object with values directly (no attributes).
+   * Includes system keys ($date, $time).
+   * @deprecated Use getAll() for full STM format
+   */
+  getSTMObject() {
+    const result = {};
+    for (const [key] of this.rootMap) {
+      result[key] = this.get_value(key);
+    }
+    result["$date"] = this.get_value("$date");
+    result["$time"] = this.get_value("$time");
+    return result;
+  }
+  /**
+   * Add a content tag to a key.
+   * @returns true if the tag was added, false if key doesn't exist or tag already exists
+   */
+  addTag(key, tag) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    const contentTags = attributes?.contentTags || [];
+    if (contentTags.includes(tag)) {
+      return false;
+    }
+    this.doc.transact(() => {
+      const newContentTags = [...contentTags, tag];
+      entryMap.set("attributes", {
+        ...attributes,
+        contentTags: newContentTags,
+        tags: newContentTags
+        // Sync legacy tags array
+      });
+    });
+    this.notifyGlobalListeners();
+    return true;
+  }
+  /**
+   * Remove a content tag from a key.
+   * @returns true if the tag was removed
+   */
+  removeTag(key, tag) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    const contentTags = attributes?.contentTags || [];
+    const tagIndex = contentTags.indexOf(tag);
+    if (tagIndex === -1) {
+      return false;
+    }
+    this.doc.transact(() => {
+      const newContentTags = contentTags.filter((t) => t !== tag);
+      entryMap.set("attributes", {
+        ...attributes,
+        contentTags: newContentTags,
+        tags: newContentTags
+        // Sync legacy tags array
+      });
+    });
+    this.notifyGlobalListeners();
+    return true;
+  }
+  /**
+   * Get all content tags for a key.
+   */
+  getTags(key) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return [];
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return [];
+    }
+    const attributes = entryMap.get("attributes");
+    return attributes?.contentTags || [];
+  }
+  /**
+   * Get all unique content tags across all keys.
+   */
+  getAllTags() {
+    const allTags = /* @__PURE__ */ new Set();
+    for (const [, val] of this.rootMap) {
+      const entryMap = val;
+      const attributes = entryMap.get("attributes");
+      if (attributes?.contentTags) {
+        attributes.contentTags.forEach((tag) => allTags.add(tag));
+      }
+    }
+    return Array.from(allTags);
+  }
+  /**
+   * Check if a key has a specific content tag.
+   */
+  hasTag(key, tag) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    return attributes?.contentTags?.includes(tag) || false;
+  }
+  /**
+   * Get all keys with a specific content tag as formatted string.
+   */
+  getTagged(tag) {
+    const entries = [];
+    const keys = this.getSortedKeys();
+    keys.forEach((key) => {
+      if (this.hasTag(key, tag)) {
+        entries.push([key, this.get_value(key)]);
+      }
+    });
+    return entries.map(([key, value]) => `${key}: ${value}`).join(", ");
+  }
+  /**
+   * Get array of keys with a specific content tag.
+   */
+  getKeysByTag(tag) {
+    const keys = this.getSortedKeys();
+    return keys.filter((key) => this.hasTag(key, tag));
+  }
+  // ============================================
+  // System Tag Methods (requires system access level)
+  // ============================================
+  /**
+   * Add a system tag to a key (requires system access).
+   * System tags: 'SystemPrompt', 'LLMRead', 'LLMWrite', 'readonly', 'protected', 'ApplyTemplate'
+   */
+  systemAddTag(key, tag) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemAddTag requires system access level");
+      return false;
+    }
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    const systemTags = attributes?.systemTags || [];
+    if (systemTags.includes(tag)) {
+      return false;
+    }
+    this.doc.transact(() => {
+      const newSystemTags = [...systemTags, tag];
+      const normalizedTags = this.normalizeSystemTags(newSystemTags);
+      entryMap.set("attributes", {
+        ...attributes,
+        systemTags: normalizedTags
+      });
+    });
+    this.notifyGlobalListeners();
+    return true;
+  }
+  /**
+   * Remove a system tag from a key (requires system access).
+   */
+  systemRemoveTag(key, tag) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemRemoveTag requires system access level");
+      return false;
+    }
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    const systemTags = attributes?.systemTags || [];
+    const tagIndex = systemTags.indexOf(tag);
+    if (tagIndex === -1) {
+      return false;
+    }
+    this.doc.transact(() => {
+      const newSystemTags = systemTags.filter((t) => t !== tag);
+      entryMap.set("attributes", {
+        ...attributes,
+        systemTags: newSystemTags
+      });
+    });
+    this.notifyGlobalListeners();
+    return true;
+  }
+  /**
+   * Get all system tags for a key (requires system access).
+   */
+  systemGetTags(key) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemGetTags requires system access level");
+      return [];
+    }
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return [];
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return [];
+    }
+    const attributes = entryMap.get("attributes");
+    return attributes?.systemTags || [];
+  }
+  /**
+   * Check if a key has a specific system tag (requires system access).
+   */
+  systemHasTag(key, tag) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemHasTag requires system access level");
+      return false;
+    }
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    const attributes = entryMap.get("attributes");
+    return attributes?.systemTags?.includes(tag) || false;
+  }
+  /**
+   * Set all system tags for a key at once (requires system access).
+   */
+  systemSetTags(key, tags) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemSetTags requires system access level");
+      return false;
+    }
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return false;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return false;
+    }
+    this.doc.transact(() => {
+      const attributes = entryMap.get("attributes");
+      entryMap.set("attributes", {
+        ...attributes,
+        systemTags: [...tags]
+      });
+    });
+    this.notifyGlobalListeners();
+    return true;
+  }
+  /**
+   * Get all keys with a specific system tag (requires system access).
+   */
+  systemGetKeysByTag(tag) {
+    if (!this.hasSystemAccess) {
+      console.warn("MindCache: systemGetKeysByTag requires system access level");
+      return [];
+    }
+    const keys = this.getSortedKeys();
+    return keys.filter((key) => this.systemHasTag(key, tag));
+  }
+  /**
+   * Helper to get sorted keys (by zIndex).
+   */
+  getSortedKeys() {
+    const entries = [];
+    for (const [key, val] of this.rootMap) {
+      const entryMap = val;
+      const attributes = entryMap.get("attributes");
+      entries.push({ key, zIndex: attributes?.zIndex ?? 0 });
+    }
+    return entries.sort((a, b) => a.zIndex - b.zIndex).map((e) => e.key);
+  }
+  /**
+   * Serialize to JSON string.
+   */
+  toJSON() {
+    return JSON.stringify(this.serialize());
+  }
+  /**
+   * Deserialize from JSON string.
+   */
+  fromJSON(jsonString) {
+    try {
+      const data = JSON.parse(jsonString);
+      this.deserialize(data);
+    } catch (error) {
+      console.error("MindCache: Failed to deserialize JSON:", error);
+    }
+  }
+  /**
+   * Export to Markdown format.
+   */
+  toMarkdown() {
+    const now = /* @__PURE__ */ new Date();
+    const lines = [];
+    const appendixEntries = [];
+    let appendixCounter = 0;
+    lines.push("# MindCache STM Export");
+    lines.push("");
+    lines.push(`Export Date: ${now.toISOString().split("T")[0]}`);
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push("## STM Entries");
+    lines.push("");
+    const sortedKeys = this.getSortedKeys();
+    sortedKeys.forEach((key) => {
+      const entryMap = this.rootMap.get(key);
+      if (!entryMap) {
+        return;
+      }
+      const attributes = entryMap.get("attributes");
+      const value = entryMap.get("value");
+      if (attributes?.systemTags?.includes("protected")) {
+        return;
+      }
+      lines.push(`### ${key}`);
+      const entryType = attributes?.type || "text";
+      lines.push(`- **Type**: \`${entryType}\``);
+      lines.push(`- **System Tags**: \`${attributes?.systemTags?.join(", ") || "none"}\``);
+      lines.push(`- **Z-Index**: \`${attributes?.zIndex ?? 0}\``);
+      if (attributes?.contentTags && attributes.contentTags.length > 0) {
+        lines.push(`- **Tags**: \`${attributes.contentTags.join("`, `")}\``);
+      }
+      if (attributes?.contentType) {
+        lines.push(`- **Content Type**: \`${attributes.contentType}\``);
+      }
+      if (entryType === "image" || entryType === "file") {
+        const label = String.fromCharCode(65 + appendixCounter);
+        appendixCounter++;
+        lines.push(`- **Value**: [See Appendix ${label}]`);
+        appendixEntries.push({
+          key,
+          type: entryType,
+          contentType: attributes?.contentType || "application/octet-stream",
+          base64: value,
+          label
+        });
+      } else if (entryType === "json") {
+        lines.push("- **Value**:");
+        lines.push("```json");
+        try {
+          const jsonValue = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+          lines.push(jsonValue);
+        } catch {
+          lines.push(String(value));
+        }
+        lines.push("```");
+      } else {
+        lines.push("- **Value**:");
+        lines.push("```");
+        lines.push(String(value));
+        lines.push("```");
+      }
+      lines.push("");
+    });
+    if (appendixEntries.length > 0) {
+      lines.push("---");
+      lines.push("");
+      lines.push("## Appendix: Binary Data");
+      lines.push("");
+      appendixEntries.forEach((entry) => {
+        lines.push(`### Appendix ${entry.label}: ${entry.key}`);
+        lines.push(`- **Type**: \`${entry.type}\``);
+        lines.push(`- **Content Type**: \`${entry.contentType}\``);
+        lines.push("- **Base64 Data**:");
+        lines.push("```");
+        lines.push(entry.base64);
+        lines.push("```");
+        lines.push("");
+      });
+    }
+    return lines.join("\n");
+  }
+  /**
+   * Import from Markdown format.
+   */
+  fromMarkdown(markdown) {
+    const lines = markdown.split("\n");
+    let currentKey = null;
+    let currentAttributes = {};
+    let currentValue = null;
+    let inCodeBlock = false;
+    let codeBlockContent = [];
+    for (const line of lines) {
+      if (line.startsWith("### ") && !line.startsWith("### Appendix")) {
+        if (currentKey && currentValue !== null) {
+          this.set_value(currentKey, currentValue.trim(), currentAttributes);
+        }
+        currentKey = line.substring(4).trim();
+        currentAttributes = {};
+        currentValue = null;
+        continue;
+      }
+      if (line.startsWith("### Appendix ")) {
+        const match = line.match(/### Appendix ([A-Z]): (.+)/);
+        if (match) {
+          currentKey = match[2];
+        }
+        continue;
+      }
+      if (line.startsWith("- **Type**:")) {
+        const type = line.match(/`(.+)`/)?.[1];
+        if (type) {
+          currentAttributes.type = type;
+        }
+        continue;
+      }
+      if (line.startsWith("- **System Tags**:")) {
+        const tagsStr = line.match(/`([^`]+)`/)?.[1] || "";
+        if (tagsStr !== "none") {
+          currentAttributes.systemTags = tagsStr.split(", ").filter((t) => t);
+        }
+        continue;
+      }
+      if (line.startsWith("- **Z-Index**:")) {
+        const zIndex = parseInt(line.match(/`(\d+)`/)?.[1] || "0", 10);
+        currentAttributes.zIndex = zIndex;
+        continue;
+      }
+      if (line.startsWith("- **Tags**:")) {
+        const tags = line.match(/`([^`]+)`/g)?.map((t) => t.slice(1, -1)) || [];
+        currentAttributes.contentTags = tags;
+        continue;
+      }
+      if (line.startsWith("- **Content Type**:")) {
+        currentAttributes.contentType = line.match(/`(.+)`/)?.[1];
+        continue;
+      }
+      if (line.startsWith("- **Value**:") && !line.includes("[See Appendix")) {
+        const afterValue = line.substring(12).trim();
+        if (afterValue === "") {
+          currentValue = "";
+        } else if (afterValue === "```" || afterValue === "```json") {
+          inCodeBlock = true;
+          codeBlockContent = [];
+          currentValue = "";
+        } else if (afterValue.startsWith("```")) {
+          inCodeBlock = true;
+          codeBlockContent = [afterValue.substring(3)];
+          currentValue = "";
+        } else {
+          currentValue = afterValue;
+        }
+        continue;
+      }
+      const trimmedLine = line.trim();
+      if (trimmedLine === "```json" || trimmedLine === "```") {
+        if (inCodeBlock) {
+          inCodeBlock = false;
+          if (currentKey && codeBlockContent.length > 0) {
+            currentValue = codeBlockContent.join("\n");
+          }
+          codeBlockContent = [];
+        } else {
+          inCodeBlock = true;
+          codeBlockContent = [];
+        }
+        continue;
+      }
+      if (inCodeBlock) {
+        codeBlockContent.push(line);
+      } else if (currentKey && currentValue !== null) {
+        currentValue += "\n" + line;
+      }
+    }
+    if (currentKey && currentValue !== null) {
+      this.set_value(currentKey, currentValue.trim(), currentAttributes);
+    }
+    const hasParsedKeys = lines.some((line) => line.startsWith("### ") && !line.startsWith("### Appendix"));
+    if (!hasParsedKeys && markdown.trim().length > 0) {
+      this.set_value("imported_content", markdown.trim(), {
+        type: "text",
+        systemTags: ["SystemPrompt", "LLMWrite"],
+        // Default assumptions
+        zIndex: 0
+      });
+    }
+  }
+  /**
+   * Set base64 binary data.
+   */
+  set_base64(key, base64Data, contentType, type = "file", attributes) {
+    if (!this.validateContentType(type, contentType)) {
+      throw new Error(`Invalid content type ${contentType} for type ${type}`);
+    }
+    const fileAttributes = {
+      type,
+      contentType,
+      ...attributes
+    };
+    this.set_value(key, base64Data, fileAttributes);
+  }
+  /**
+   * Add an image from base64 data.
+   */
+  add_image(key, base64Data, contentType = "image/jpeg", attributes) {
+    if (!contentType.startsWith("image/")) {
+      throw new Error(`Invalid image content type: ${contentType}. Must start with 'image/'`);
+    }
+    this.set_base64(key, base64Data, contentType, "image", attributes);
+  }
+  /**
+   * Get the data URL for an image or file key.
+   */
+  get_data_url(key) {
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return void 0;
+    }
+    const attributes = entryMap.get("attributes");
+    if (attributes?.type !== "image" && attributes?.type !== "file") {
+      return void 0;
+    }
+    if (!attributes?.contentType) {
+      return void 0;
+    }
+    const value = entryMap.get("value");
+    return this.createDataUrl(value, attributes.contentType);
+  }
+  /**
+   * Get the base64 data for an image or file key.
+   */
+  get_base64(key) {
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return void 0;
+    }
+    const attributes = entryMap.get("attributes");
+    if (attributes?.type !== "image" && attributes?.type !== "file") {
+      return void 0;
+    }
+    return entryMap.get("value");
+  }
+  // File methods
+  async set_file(key, file, attributes) {
+    const base64 = await this.encodeFileToBase64(file);
+    const dataUrl = this.createDataUrl(base64, file.type);
+    this.set_value(key, dataUrl, {
+      ...attributes,
+      type: "file",
+      contentType: file.type
+    });
+  }
+  set_image(key, file, attributes) {
+    return this.set_file(key, file, {
+      ...attributes,
+      type: "image"
+      // Override to image
+    });
+  }
+  // Document methods for collaborative editing
+  /**
+   * Create or get a collaborative document key.
+   * Uses Y.Text for character-level concurrent editing.
+   *
+   * Note: This exposes Yjs Y.Text directly for editor bindings (y-quill, y-codemirror, etc.)
+   */
+  set_document(key, initialText, attributes) {
+    if (key === "$date" || key === "$time" || key === "$version") {
+      return;
+    }
+    let entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      entryMap = new Y__namespace.Map();
+      this.rootMap.set(key, entryMap);
+      const yText = new Y__namespace.Text(initialText || "");
+      entryMap.set("value", yText);
+      entryMap.set("attributes", {
+        ...DEFAULT_KEY_ATTRIBUTES,
+        type: "document",
+        contentTags: [],
+        systemTags: ["SystemPrompt", "LLMWrite"],
+        tags: [],
+        zIndex: 0,
+        ...attributes
+      });
+    }
+    this.getUndoManager(key);
+  }
+  /**
+   * Get the Y.Text object for a document key.
+   * Use this to bind to editors (Quill, CodeMirror, Monaco, etc.)
+   *
+   * @returns Y.Text or undefined if key doesn't exist or isn't a document
+   */
+  get_document(key) {
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return void 0;
+    }
+    const attrs = entryMap.get("attributes");
+    if (attrs?.type !== "document") {
+      return void 0;
+    }
+    const value = entryMap.get("value");
+    if (value instanceof Y__namespace.Text) {
+      return value;
+    }
+    return void 0;
+  }
+  /**
+   * Insert text at a position in a document key.
+   */
+  insert_text(key, index, text) {
+    const yText = this.get_document(key);
+    if (yText) {
+      yText.insert(index, text);
+    }
+  }
+  /**
+   * Delete text from a document key.
+   */
+  delete_text(key, index, length2) {
+    const yText = this.get_document(key);
+    if (yText) {
+      yText.delete(index, length2);
+    }
+  }
+  /**
+   * Replace all text in a document key (private - use set_value for public API).
+   * Uses diff-based updates when changes are < diffThreshold (default 80%).
+   * This preserves concurrent edits and provides better undo granularity.
+   */
+  _replaceDocumentText(key, newText, diffThreshold = 0.8) {
+    const yText = this.get_document(key);
+    if (!yText) {
+      return;
+    }
+    const oldText = yText.toString();
+    if (oldText === newText) {
+      return;
+    }
+    if (oldText.length === 0) {
+      yText.insert(0, newText);
+      return;
+    }
+    const diffs = diff__default.default(oldText, newText);
+    let changedChars = 0;
+    for (const [op, text] of diffs) {
+      if (op !== 0) {
+        changedChars += text.length;
+      }
+    }
+    const changeRatio = changedChars / Math.max(oldText.length, newText.length);
+    if (changeRatio > diffThreshold) {
+      this.doc.transact(() => {
+        yText.delete(0, yText.length);
+        yText.insert(0, newText);
+      });
+      return;
+    }
+    this.doc.transact(() => {
+      let cursor = 0;
+      for (const [op, text] of diffs) {
+        if (op === 0) {
+          cursor += text.length;
+        } else if (op === -1) {
+          yText.delete(cursor, text.length);
+        } else if (op === 1) {
+          yText.insert(cursor, text);
+          cursor += text.length;
+        }
+      }
+    });
+  }
+  // ... (subscribe methods)
+  subscribe(key, listener) {
+    if (!this.listeners[key]) {
+      this.listeners[key] = [];
+    }
+    this.listeners[key].push(listener);
+    return () => {
+      this.listeners[key] = this.listeners[key].filter((l) => l !== listener);
+    };
+  }
+  subscribeToAll(listener) {
+    this.globalListeners.push(listener);
+    return () => {
+      this.globalListeners = this.globalListeners.filter((l) => l !== listener);
+    };
+  }
+  unsubscribeFromAll(listener) {
+    this.globalListeners = this.globalListeners.filter((l) => l !== listener);
+  }
+  notifyGlobalListeners() {
+    this.globalListeners.forEach((l) => l());
+  }
+  // Sanitize key name for use in tool names
+  sanitizeKeyForTool(key) {
+    return key.replace(/[^a-zA-Z0-9_-]/g, "_");
+  }
+  // Find original key from sanitized tool name
+  findKeyFromSanitizedTool(sanitizedKey) {
+    for (const [key] of this.rootMap) {
+      if (this.sanitizeKeyForTool(key) === sanitizedKey) {
+        return key;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Generate Vercel AI SDK compatible tools for writable keys.
+   * For document type keys, generates additional tools: append_, insert_, edit_
+   *
+   * Security: All tools use llm_set_key internally which:
+   * - Only modifies VALUES, never attributes/systemTags
+   * - Prevents LLMs from escalating privileges
+   */
+  create_vercel_ai_tools() {
+    const tools = {};
+    for (const [key, val] of this.rootMap) {
+      if (key.startsWith("$")) {
+        continue;
+      }
+      const entryMap = val;
+      const attributes = entryMap.get("attributes");
+      const isWritable = attributes?.systemTags?.includes("LLMWrite");
+      if (!isWritable) {
+        continue;
+      }
+      const sanitizedKey = this.sanitizeKeyForTool(key);
+      const isDocument = attributes?.type === "document";
+      tools[`write_${sanitizedKey}`] = {
+        description: isDocument ? `Rewrite the entire "${key}" document` : `Write a value to the STM key: ${key}`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            value: { type: "string", description: isDocument ? "New document content" : "The value to write" }
+          },
+          required: ["value"]
+        },
+        execute: async ({ value }) => {
+          const success = this.llm_set_key(key, value);
+          if (success) {
+            return {
+              result: `Successfully wrote "${value}" to ${key}`,
+              key,
+              value
+            };
+          }
+          return {
+            result: `Failed to write to ${key} - permission denied or key not found`,
+            key,
+            error: true
+          };
+        }
+      };
+      if (isDocument) {
+        tools[`append_${sanitizedKey}`] = {
+          description: `Append text to the end of "${key}" document`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              text: { type: "string", description: "Text to append" }
+            },
+            required: ["text"]
+          },
+          execute: async ({ text }) => {
+            if (!attributes?.systemTags?.includes("LLMWrite")) {
+              return { result: `Permission denied for ${key}`, key, error: true };
+            }
+            const yText = this.get_document(key);
+            if (yText) {
+              yText.insert(yText.length, text);
+              return {
+                result: `Successfully appended to ${key}`,
+                key,
+                appended: text
+              };
+            }
+            return { result: `Document ${key} not found`, key };
+          }
+        };
+        tools[`insert_${sanitizedKey}`] = {
+          description: `Insert text at a position in "${key}" document`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              index: { type: "number", description: "Position to insert at (0 = start)" },
+              text: { type: "string", description: "Text to insert" }
+            },
+            required: ["index", "text"]
+          },
+          execute: async ({ index, text }) => {
+            if (!attributes?.systemTags?.includes("LLMWrite")) {
+              return { result: `Permission denied for ${key}`, key, error: true };
+            }
+            this.insert_text(key, index, text);
+            return {
+              result: `Successfully inserted text at position ${index} in ${key}`,
+              key,
+              index,
+              inserted: text
+            };
+          }
+        };
+        tools[`edit_${sanitizedKey}`] = {
+          description: `Find and replace text in "${key}" document`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              find: { type: "string", description: "Text to find" },
+              replace: { type: "string", description: "Replacement text" }
+            },
+            required: ["find", "replace"]
+          },
+          execute: async ({ find, replace }) => {
+            if (!attributes?.systemTags?.includes("LLMWrite")) {
+              return { result: `Permission denied for ${key}`, key, error: true };
+            }
+            const yText = this.get_document(key);
+            if (yText) {
+              const text = yText.toString();
+              const idx = text.indexOf(find);
+              if (idx !== -1) {
+                yText.delete(idx, find.length);
+                yText.insert(idx, replace);
+                return {
+                  result: `Successfully replaced "${find}" with "${replace}" in ${key}`,
+                  key,
+                  find,
+                  replace,
+                  index: idx
+                };
+              }
+              return { result: `Text "${find}" not found in ${key}`, key };
+            }
+            return { result: `Document ${key} not found`, key };
+          }
+        };
+      }
+    }
+    return tools;
+  }
+  /**
+   * @deprecated Use create_vercel_ai_tools() instead
+   */
+  get_aisdk_tools() {
+    return this.create_vercel_ai_tools();
+  }
+  /**
+   * Generate a system prompt containing all visible STM keys and their values.
+   * Indicates which tools can be used to modify writable keys.
+   */
+  get_system_prompt() {
+    const lines = [];
+    for (const [key, val] of this.rootMap) {
+      if (key.startsWith("$")) {
+        continue;
+      }
+      const entryMap = val;
+      const attributes = entryMap.get("attributes");
+      const isVisible = attributes?.systemTags?.includes("SystemPrompt") || attributes?.systemTags?.includes("LLMRead");
+      if (!isVisible) {
+        continue;
+      }
+      const value = this.get_value(key);
+      const displayValue = typeof value === "object" ? JSON.stringify(value) : value;
+      const isWritable = attributes?.systemTags?.includes("LLMWrite");
+      const isDocument = attributes?.type === "document";
+      const sanitizedKey = this.sanitizeKeyForTool(key);
+      if (isWritable) {
+        if (isDocument) {
+          lines.push(
+            `${key}: ${displayValue}. Document tools: write_${sanitizedKey}, append_${sanitizedKey}, edit_${sanitizedKey}`
+          );
+        } else {
+          const oldValueHint = displayValue ? ` This tool DOES NOT append \u2014 start your response with the old value (${displayValue})` : "";
+          lines.push(
+            `${key}: ${displayValue}. You can rewrite "${key}" by using the write_${sanitizedKey} tool.${oldValueHint}`
+          );
+        }
+      } else {
+        lines.push(`${key}: ${displayValue}`);
+      }
+    }
+    lines.push(`$date: ${this.get_value("$date")}`);
+    lines.push(`$time: ${this.get_value("$time")}`);
+    return lines.join(", ");
+  }
+  /**
+   * Execute a tool call by name with the given value.
+   * Returns the result or null if tool not found.
+   */
+  executeToolCall(toolName, value) {
+    const match = toolName.match(/^(write|append|insert|edit)_(.+)$/);
+    if (!match) {
+      return null;
+    }
+    const [, action, sanitizedKey] = match;
+    const key = this.findKeyFromSanitizedTool(sanitizedKey);
+    if (!key) {
+      return null;
+    }
+    const entryMap = this.rootMap.get(key);
+    if (!entryMap) {
+      return null;
+    }
+    const attributes = entryMap.get("attributes");
+    const isWritable = attributes?.systemTags?.includes("LLMWrite");
+    if (!isWritable) {
+      return null;
+    }
+    const isDocument = attributes?.type === "document";
+    switch (action) {
+      case "write":
+        if (isDocument) {
+          this._replaceDocumentText(key, value);
+        } else {
+          this.set_value(key, value);
+        }
+        return {
+          result: `Successfully wrote "${value}" to ${key}`,
+          key,
+          value
+        };
+      case "append":
+        if (isDocument) {
+          const yText = this.get_document(key);
+          if (yText) {
+            yText.insert(yText.length, value);
+            return {
+              result: `Successfully appended to ${key}`,
+              key,
+              value
+            };
+          }
+        }
+        return null;
+      case "insert":
+        if (isDocument && typeof value === "object" && value.index !== void 0 && value.text) {
+          this.insert_text(key, value.index, value.text);
+          return {
+            result: `Successfully inserted at position ${value.index} in ${key}`,
+            key,
+            value: value.text
+          };
+        }
+        return null;
+      case "edit":
+        if (isDocument && typeof value === "object" && value.find && value.replace !== void 0) {
+          const yText = this.get_document(key);
+          if (yText) {
+            const text = yText.toString();
+            const idx = text.indexOf(value.find);
+            if (idx !== -1) {
+              yText.delete(idx, value.find.length);
+              yText.insert(idx, value.replace);
+              return {
+                result: `Successfully replaced "${value.find}" with "${value.replace}" in ${key}`,
+                key,
+                value: value.replace
+              };
+            }
+          }
+        }
+        return null;
+      default:
+        return null;
+    }
+  }
+  // Internal method stub for legacy compatibility
+  _setFromRemote(_key, _value, _attributes) {
+  }
+  _deleteFromRemote(_key) {
+  }
+  _clearFromRemote() {
+  }
+};
+
+// src/cloud/index.ts
+init_CloudAdapter();
+init_CloudAdapter();
+
+// src/local/index.ts
+init_IndexedDBAdapter();
+
+exports.DEFAULT_KEY_ATTRIBUTES = DEFAULT_KEY_ATTRIBUTES;
+exports.MindCache = MindCache;
+exports.SystemTagHelpers = SystemTagHelpers;
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map