@reverbia/sdk 1.0.0-next.20251217144909 → 1.0.0-next.20251218151654

package/dist/expo/index.cjs

@@ -37,6 +37,9 @@ __export(index_exports, {
   generateConversationId: () => generateConversationId,
   generateUniqueKey: () => generateUniqueKey,
   memoryStorageSchema: () => memoryStorageSchema,
+  sdkMigrations: () => sdkMigrations,
+  sdkModelClasses: () => sdkModelClasses,
+  sdkSchema: () => sdkSchema,
   useChat: () => useChat,
   useChatStorage: () => useChatStorage,
   useImageGeneration: () => useImageGeneration,
@@ -2386,7 +2389,7 @@ var DEFAULT_COMPLETION_MODEL = "openai/gpt-4o";
 
 // src/expo/useMemoryStorage.ts
 var import_client5 = require("@reverbia/sdk");
-async function generateEmbeddingForTextApi(text3, options) {
+async function generateEmbeddingForTextApi(text4, options) {
   const token = options.getToken ? await options.getToken() : null;
   if (!token) {
     throw new Error("No auth token available for embedding generation");
@@ -2394,7 +2397,7 @@ async function generateEmbeddingForTextApi(text3, options) {
   const response = await (0, import_client5.postApiV1Embeddings)({
     baseUrl: options.baseUrl,
     body: {
-      input: text3,
+      input: text4,
       model: options.model
     },
     headers: {
@@ -2411,8 +2414,8 @@ async function generateEmbeddingForTextApi(text3, options) {
   return embedding;
 }
 async function generateEmbeddingForMemoryApi(memory, options) {
-  const text3 = `${memory.type}: ${memory.namespace}/${memory.key} = ${memory.value}. Evidence: ${memory.rawEvidence}`;
-  return generateEmbeddingForTextApi(text3, options);
+  const text4 = `${memory.type}: ${memory.namespace}/${memory.key} = ${memory.value}. Evidence: ${memory.rawEvidence}`;
+  return generateEmbeddingForTextApi(text4, options);
 }
 function useMemoryStorage(options) {
   const {
@@ -2936,6 +2939,122 @@ function useMemoryStorage(options) {
     clearMemories
   };
 }
+
+// src/lib/db/schema.ts
+var import_watermelondb8 = require("@nozbe/watermelondb");
+var import_migrations2 = require("@nozbe/watermelondb/Schema/migrations");
+
+// src/lib/db/settings/models.ts
+var import_watermelondb7 = require("@nozbe/watermelondb");
+var import_decorators3 = require("@nozbe/watermelondb/decorators");
+var ModelPreference = class extends import_watermelondb7.Model {
+};
+ModelPreference.table = "modelPreferences";
+__decorateClass([
+  (0, import_decorators3.text)("wallet_address")
+], ModelPreference.prototype, "walletAddress", 2);
+__decorateClass([
+  (0, import_decorators3.text)("models")
+], ModelPreference.prototype, "models", 2);
+
+// src/lib/db/schema.ts
+var SDK_SCHEMA_VERSION = 4;
+var sdkSchema = (0, import_watermelondb8.appSchema)({
+  version: SDK_SCHEMA_VERSION,
+  tables: [
+    // Chat storage tables
+    (0, import_watermelondb8.tableSchema)({
+      name: "history",
+      columns: [
+        { name: "message_id", type: "number" },
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "role", type: "string", isIndexed: true },
+        { name: "content", type: "string" },
+        { name: "model", type: "string", isOptional: true },
+        { name: "files", type: "string", isOptional: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "vector", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "usage", type: "string", isOptional: true },
+        { name: "sources", type: "string", isOptional: true },
+        { name: "response_duration", type: "number", isOptional: true },
+        { name: "was_stopped", type: "boolean", isOptional: true }
+      ]
+    }),
+    (0, import_watermelondb8.tableSchema)({
+      name: "conversations",
+      columns: [
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "title", type: "string" },
+        { name: "created_at", type: "number" },
+        { name: "updated_at", type: "number" },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Memory storage tables
+    (0, import_watermelondb8.tableSchema)({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Settings storage tables
+    (0, import_watermelondb8.tableSchema)({
+      name: "modelPreferences",
+      columns: [
+        { name: "wallet_address", type: "string", isIndexed: true },
+        { name: "models", type: "string", isOptional: true }
+      ]
+    })
+  ]
+});
+var sdkMigrations = (0, import_migrations2.schemaMigrations)({
+  migrations: [
+    // v2 -> v3: Added was_stopped column to history
+    {
+      toVersion: 3,
+      steps: [
+        (0, import_migrations2.addColumns)({
+          table: "history",
+          columns: [{ name: "was_stopped", type: "boolean", isOptional: true }]
+        })
+      ]
+    },
+    // v3 -> v4: Added settings storage (modelPreferences table)
+    {
+      toVersion: 4,
+      steps: [
+        (0, import_migrations2.createTable)({
+          name: "modelPreferences",
+          columns: [
+            { name: "wallet_address", type: "string", isIndexed: true },
+            { name: "models", type: "string", isOptional: true }
+          ]
+        })
+      ]
+    }
+  ]
+});
+var sdkModelClasses = [
+  Message,
+  Conversation,
+  Memory,
+  ModelPreference
+];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChatConversation,
@@ -2947,6 +3066,9 @@ function useMemoryStorage(options) {
   generateConversationId,
   generateUniqueKey,
   memoryStorageSchema,
+  sdkMigrations,
+  sdkModelClasses,
+  sdkSchema,
   useChat,
   useChatStorage,
   useImageGeneration,

package/dist/expo/index.d.mts

@@ -1,7 +1,8 @@
 import { Database, Model } from '@nozbe/watermelondb';
 import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
-import { Associations } from '@nozbe/watermelondb/Model';
+import Model$1, { Associations } from '@nozbe/watermelondb/Model';
+import { Class } from '@nozbe/watermelondb/types';
 
 /**
  * ExtraFields contains additional metadata
@@ -868,4 +869,77 @@ type UseMemoryStorageResult = BaseUseMemoryStorageResult;
  */
 declare function useMemoryStorage(options: UseMemoryStorageOptions): UseMemoryStorageResult;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type FileMetadata, type MemoryItem, type MemoryType, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsOptions, type UseModelsResult, chatStorageMigrations, chatStorageSchema, generateCompositeKey, generateConversationId, generateUniqueKey, memoryStorageSchema, useChat, useChatStorage, useImageGeneration, useMemoryStorage, useModels };
+/**
+ * Combined WatermelonDB schema for all SDK storage modules.
+ *
+ * This unified schema includes all tables needed by the SDK:
+ * - `history`: Chat message storage with embeddings and metadata
+ * - `conversations`: Conversation metadata and organization
+ * - `memories`: Persistent memory storage with semantic search
+ * - `modelPreferences`: User model preferences and settings
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import LokiJSAdapter from '@nozbe/watermelondb/adapters/lokijs';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const adapter = new LokiJSAdapter({
+ *   schema: sdkSchema,
+ *   migrations: sdkMigrations,
+ *   dbName: 'my-app-db',
+ *   useWebWorker: false,
+ *   useIncrementalIndexedDB: true,
+ * });
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+/**
+ * Combined migrations for all SDK storage modules.
+ *
+ * These migrations handle database schema upgrades from any previous version
+ * to the current version. The SDK manages all migration logic internally,
+ * so consumer apps don't need to handle version arithmetic or migration merging.
+ *
+ * **Minimum supported version: v2**
+ * Migrations from v1 are not supported. Databases at v1 require a fresh install.
+ *
+ * Migration history:
+ * - v2 → v3: Added `was_stopped` column to history table
+ * - v3 → v4: Added `modelPreferences` table for settings storage
+ */
+declare const sdkMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
+/**
+ * Model classes to register with the WatermelonDB database.
+ *
+ * Pass this array directly to the `modelClasses` option when creating
+ * your Database instance.
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkModelClasses: Class<Model$1>[];
+
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type FileMetadata, type MemoryItem, type MemoryType, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsOptions, type UseModelsResult, chatStorageMigrations, chatStorageSchema, generateCompositeKey, generateConversationId, generateUniqueKey, memoryStorageSchema, sdkMigrations, sdkModelClasses, sdkSchema, useChat, useChatStorage, useImageGeneration, useMemoryStorage, useModels };

package/dist/expo/index.d.ts

@@ -1,7 +1,8 @@
 import { Database, Model } from '@nozbe/watermelondb';
 import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
-import { Associations } from '@nozbe/watermelondb/Model';
+import Model$1, { Associations } from '@nozbe/watermelondb/Model';
+import { Class } from '@nozbe/watermelondb/types';
 
 /**
  * ExtraFields contains additional metadata
@@ -868,4 +869,77 @@ type UseMemoryStorageResult = BaseUseMemoryStorageResult;
  */
 declare function useMemoryStorage(options: UseMemoryStorageOptions): UseMemoryStorageResult;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type FileMetadata, type MemoryItem, type MemoryType, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsOptions, type UseModelsResult, chatStorageMigrations, chatStorageSchema, generateCompositeKey, generateConversationId, generateUniqueKey, memoryStorageSchema, useChat, useChatStorage, useImageGeneration, useMemoryStorage, useModels };
+/**
+ * Combined WatermelonDB schema for all SDK storage modules.
+ *
+ * This unified schema includes all tables needed by the SDK:
+ * - `history`: Chat message storage with embeddings and metadata
+ * - `conversations`: Conversation metadata and organization
+ * - `memories`: Persistent memory storage with semantic search
+ * - `modelPreferences`: User model preferences and settings
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import LokiJSAdapter from '@nozbe/watermelondb/adapters/lokijs';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const adapter = new LokiJSAdapter({
+ *   schema: sdkSchema,
+ *   migrations: sdkMigrations,
+ *   dbName: 'my-app-db',
+ *   useWebWorker: false,
+ *   useIncrementalIndexedDB: true,
+ * });
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+/**
+ * Combined migrations for all SDK storage modules.
+ *
+ * These migrations handle database schema upgrades from any previous version
+ * to the current version. The SDK manages all migration logic internally,
+ * so consumer apps don't need to handle version arithmetic or migration merging.
+ *
+ * **Minimum supported version: v2**
+ * Migrations from v1 are not supported. Databases at v1 require a fresh install.
+ *
+ * Migration history:
+ * - v2 → v3: Added `was_stopped` column to history table
+ * - v3 → v4: Added `modelPreferences` table for settings storage
+ */
+declare const sdkMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
+/**
+ * Model classes to register with the WatermelonDB database.
+ *
+ * Pass this array directly to the `modelClasses` option when creating
+ * your Database instance.
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkModelClasses: Class<Model$1>[];
+
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type FileMetadata, type MemoryItem, type MemoryType, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsOptions, type UseModelsResult, chatStorageMigrations, chatStorageSchema, generateCompositeKey, generateConversationId, generateUniqueKey, memoryStorageSchema, sdkMigrations, sdkModelClasses, sdkSchema, useChat, useChatStorage, useImageGeneration, useMemoryStorage, useModels };

package/dist/expo/index.mjs

@@ -2353,7 +2353,7 @@ var DEFAULT_COMPLETION_MODEL = "openai/gpt-4o";
 
 // src/expo/useMemoryStorage.ts
 import { postApiV1Embeddings } from "@reverbia/sdk";
-async function generateEmbeddingForTextApi(text3, options) {
+async function generateEmbeddingForTextApi(text4, options) {
   const token = options.getToken ? await options.getToken() : null;
   if (!token) {
     throw new Error("No auth token available for embedding generation");
@@ -2361,7 +2361,7 @@ async function generateEmbeddingForTextApi(text3, options) {
   const response = await postApiV1Embeddings({
     baseUrl: options.baseUrl,
     body: {
-      input: text3,
+      input: text4,
       model: options.model
     },
     headers: {
@@ -2378,8 +2378,8 @@ async function generateEmbeddingForTextApi(text3, options) {
   return embedding;
 }
 async function generateEmbeddingForMemoryApi(memory, options) {
-  const text3 = `${memory.type}: ${memory.namespace}/${memory.key} = ${memory.value}. Evidence: ${memory.rawEvidence}`;
-  return generateEmbeddingForTextApi(text3, options);
+  const text4 = `${memory.type}: ${memory.namespace}/${memory.key} = ${memory.value}. Evidence: ${memory.rawEvidence}`;
+  return generateEmbeddingForTextApi(text4, options);
 }
 function useMemoryStorage(options) {
   const {
@@ -2903,6 +2903,126 @@ function useMemoryStorage(options) {
     clearMemories
   };
 }
+
+// src/lib/db/schema.ts
+import { appSchema as appSchema3, tableSchema as tableSchema3 } from "@nozbe/watermelondb";
+import {
+  schemaMigrations as schemaMigrations2,
+  addColumns as addColumns2,
+  createTable
+} from "@nozbe/watermelondb/Schema/migrations";
+
+// src/lib/db/settings/models.ts
+import { Model as Model3 } from "@nozbe/watermelondb";
+import { text as text3 } from "@nozbe/watermelondb/decorators";
+var ModelPreference = class extends Model3 {
+};
+ModelPreference.table = "modelPreferences";
+__decorateClass([
+  text3("wallet_address")
+], ModelPreference.prototype, "walletAddress", 2);
+__decorateClass([
+  text3("models")
+], ModelPreference.prototype, "models", 2);
+
+// src/lib/db/schema.ts
+var SDK_SCHEMA_VERSION = 4;
+var sdkSchema = appSchema3({
+  version: SDK_SCHEMA_VERSION,
+  tables: [
+    // Chat storage tables
+    tableSchema3({
+      name: "history",
+      columns: [
+        { name: "message_id", type: "number" },
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "role", type: "string", isIndexed: true },
+        { name: "content", type: "string" },
+        { name: "model", type: "string", isOptional: true },
+        { name: "files", type: "string", isOptional: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "vector", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "usage", type: "string", isOptional: true },
+        { name: "sources", type: "string", isOptional: true },
+        { name: "response_duration", type: "number", isOptional: true },
+        { name: "was_stopped", type: "boolean", isOptional: true }
+      ]
+    }),
+    tableSchema3({
+      name: "conversations",
+      columns: [
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "title", type: "string" },
+        { name: "created_at", type: "number" },
+        { name: "updated_at", type: "number" },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Memory storage tables
+    tableSchema3({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Settings storage tables
+    tableSchema3({
+      name: "modelPreferences",
+      columns: [
+        { name: "wallet_address", type: "string", isIndexed: true },
+        { name: "models", type: "string", isOptional: true }
+      ]
+    })
+  ]
+});
+var sdkMigrations = schemaMigrations2({
+  migrations: [
+    // v2 -> v3: Added was_stopped column to history
+    {
+      toVersion: 3,
+      steps: [
+        addColumns2({
+          table: "history",
+          columns: [{ name: "was_stopped", type: "boolean", isOptional: true }]
+        })
+      ]
+    },
+    // v3 -> v4: Added settings storage (modelPreferences table)
+    {
+      toVersion: 4,
+      steps: [
+        createTable({
+          name: "modelPreferences",
+          columns: [
+            { name: "wallet_address", type: "string", isIndexed: true },
+            { name: "models", type: "string", isOptional: true }
+          ]
+        })
+      ]
+    }
+  ]
+});
+var sdkModelClasses = [
+  Message,
+  Conversation,
+  Memory,
+  ModelPreference
+];
 export {
   Conversation as ChatConversation,
   Message as ChatMessage,
@@ -2913,6 +3033,9 @@ export {
   generateConversationId,
   generateUniqueKey,
   memoryStorageSchema,
+  sdkMigrations,
+  sdkModelClasses,
+  sdkSchema,
   useChat,
   useChatStorage,
   useImageGeneration,

package/dist/react/index.cjs

@@ -64,6 +64,9 @@ __export(index_exports, {
   hasEncryptionKey: () => hasEncryptionKey,
   memoryStorageSchema: () => memoryStorageSchema,
   requestEncryptionKey: () => requestEncryptionKey,
+  sdkMigrations: () => sdkMigrations,
+  sdkModelClasses: () => sdkModelClasses,
+  sdkSchema: () => sdkSchema,
   selectTool: () => selectTool,
   settingsStorageSchema: () => settingsStorageSchema,
   storeDropboxToken: () => storeToken,
@@ -2398,41 +2401,14 @@ function useChatStorage(options) {
   };
 }
 
-// src/react/useMemoryStorage.ts
-var import_react3 = require("react");
-var import_client6 = require("@reverbia/sdk");
-
-// src/lib/db/memory/schema.ts
-var import_watermelondb4 = require("@nozbe/watermelondb");
-var memoryStorageSchema = (0, import_watermelondb4.appSchema)({
-  version: 1,
-  tables: [
-    (0, import_watermelondb4.tableSchema)({
-      name: "memories",
-      columns: [
-        { name: "type", type: "string", isIndexed: true },
-        { name: "namespace", type: "string", isIndexed: true },
-        { name: "key", type: "string", isIndexed: true },
-        { name: "value", type: "string" },
-        { name: "raw_evidence", type: "string" },
-        { name: "confidence", type: "number" },
-        { name: "pii", type: "boolean", isIndexed: true },
-        { name: "composite_key", type: "string", isIndexed: true },
-        { name: "unique_key", type: "string", isIndexed: true },
-        { name: "created_at", type: "number", isIndexed: true },
-        { name: "updated_at", type: "number" },
-        { name: "embedding", type: "string", isOptional: true },
-        { name: "embedding_model", type: "string", isOptional: true },
-        { name: "is_deleted", type: "boolean", isIndexed: true }
-      ]
-    })
-  ]
-});
+// src/lib/db/schema.ts
+var import_watermelondb6 = require("@nozbe/watermelondb");
+var import_migrations2 = require("@nozbe/watermelondb/Schema/migrations");
 
 // src/lib/db/memory/models.ts
-var import_watermelondb5 = require("@nozbe/watermelondb");
+var import_watermelondb4 = require("@nozbe/watermelondb");
 var import_decorators2 = require("@nozbe/watermelondb/decorators");
-var Memory = class extends import_watermelondb5.Model {
+var Memory = class extends import_watermelondb4.Model {
 };
 Memory.table = "memories";
 __decorateClass([
@@ -2478,6 +2454,149 @@ __decorateClass([
   (0, import_decorators2.field)("is_deleted")
 ], Memory.prototype, "isDeleted", 2);
 
+// src/lib/db/settings/models.ts
+var import_watermelondb5 = require("@nozbe/watermelondb");
+var import_decorators3 = require("@nozbe/watermelondb/decorators");
+var ModelPreference = class extends import_watermelondb5.Model {
+};
+ModelPreference.table = "modelPreferences";
+__decorateClass([
+  (0, import_decorators3.text)("wallet_address")
+], ModelPreference.prototype, "walletAddress", 2);
+__decorateClass([
+  (0, import_decorators3.text)("models")
+], ModelPreference.prototype, "models", 2);
+
+// src/lib/db/schema.ts
+var SDK_SCHEMA_VERSION = 4;
+var sdkSchema = (0, import_watermelondb6.appSchema)({
+  version: SDK_SCHEMA_VERSION,
+  tables: [
+    // Chat storage tables
+    (0, import_watermelondb6.tableSchema)({
+      name: "history",
+      columns: [
+        { name: "message_id", type: "number" },
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "role", type: "string", isIndexed: true },
+        { name: "content", type: "string" },
+        { name: "model", type: "string", isOptional: true },
+        { name: "files", type: "string", isOptional: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "vector", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "usage", type: "string", isOptional: true },
+        { name: "sources", type: "string", isOptional: true },
+        { name: "response_duration", type: "number", isOptional: true },
+        { name: "was_stopped", type: "boolean", isOptional: true }
+      ]
+    }),
+    (0, import_watermelondb6.tableSchema)({
+      name: "conversations",
+      columns: [
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "title", type: "string" },
+        { name: "created_at", type: "number" },
+        { name: "updated_at", type: "number" },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Memory storage tables
+    (0, import_watermelondb6.tableSchema)({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Settings storage tables
+    (0, import_watermelondb6.tableSchema)({
+      name: "modelPreferences",
+      columns: [
+        { name: "wallet_address", type: "string", isIndexed: true },
+        { name: "models", type: "string", isOptional: true }
+      ]
+    })
+  ]
+});
+var sdkMigrations = (0, import_migrations2.schemaMigrations)({
+  migrations: [
+    // v2 -> v3: Added was_stopped column to history
+    {
+      toVersion: 3,
+      steps: [
+        (0, import_migrations2.addColumns)({
+          table: "history",
+          columns: [{ name: "was_stopped", type: "boolean", isOptional: true }]
+        })
+      ]
+    },
+    // v3 -> v4: Added settings storage (modelPreferences table)
+    {
+      toVersion: 4,
+      steps: [
+        (0, import_migrations2.createTable)({
+          name: "modelPreferences",
+          columns: [
+            { name: "wallet_address", type: "string", isIndexed: true },
+            { name: "models", type: "string", isOptional: true }
+          ]
+        })
+      ]
+    }
+  ]
+});
+var sdkModelClasses = [
+  Message,
+  Conversation,
+  Memory,
+  ModelPreference
+];
+
+// src/react/useMemoryStorage.ts
+var import_react3 = require("react");
+var import_client6 = require("@reverbia/sdk");
+
+// src/lib/db/memory/schema.ts
+var import_watermelondb7 = require("@nozbe/watermelondb");
+var memoryStorageSchema = (0, import_watermelondb7.appSchema)({
+  version: 1,
+  tables: [
+    (0, import_watermelondb7.tableSchema)({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    })
+  ]
+});
+
 // src/lib/db/memory/types.ts
 function generateCompositeKey(namespace, key) {
   return `${namespace}:${key}`;
@@ -2505,7 +2624,7 @@ function cosineSimilarity2(a, b) {
 }
 
 // src/lib/db/memory/operations.ts
-var import_watermelondb6 = require("@nozbe/watermelondb");
+var import_watermelondb8 = require("@nozbe/watermelondb");
 function memoryToStored(memory) {
   return {
     uniqueId: memory.id,
@@ -2526,7 +2645,7 @@ function memoryToStored(memory) {
   };
 }
 async function getAllMemoriesOp(ctx) {
-  const results = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("is_deleted", false), import_watermelondb6.Q.sortBy("created_at", import_watermelondb6.Q.desc)).fetch();
+  const results = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("is_deleted", false), import_watermelondb8.Q.sortBy("created_at", import_watermelondb8.Q.desc)).fetch();
   return results.map(memoryToStored);
 }
 async function getMemoryByIdOp(ctx, id) {
@@ -2540,18 +2659,18 @@ async function getMemoryByIdOp(ctx, id) {
 }
 async function getMemoriesByNamespaceOp(ctx, namespace) {
   const results = await ctx.memoriesCollection.query(
-    import_watermelondb6.Q.where("namespace", namespace),
-    import_watermelondb6.Q.where("is_deleted", false),
-    import_watermelondb6.Q.sortBy("created_at", import_watermelondb6.Q.desc)
+    import_watermelondb8.Q.where("namespace", namespace),
+    import_watermelondb8.Q.where("is_deleted", false),
+    import_watermelondb8.Q.sortBy("created_at", import_watermelondb8.Q.desc)
   ).fetch();
   return results.map(memoryToStored);
 }
 async function getMemoriesByKeyOp(ctx, namespace, key) {
   const compositeKey = generateCompositeKey(namespace, key);
   const results = await ctx.memoriesCollection.query(
-    import_watermelondb6.Q.where("composite_key", compositeKey),
-    import_watermelondb6.Q.where("is_deleted", false),
-    import_watermelondb6.Q.sortBy("created_at", import_watermelondb6.Q.desc)
+    import_watermelondb8.Q.where("composite_key", compositeKey),
+    import_watermelondb8.Q.where("is_deleted", false),
+    import_watermelondb8.Q.sortBy("created_at", import_watermelondb8.Q.desc)
   ).fetch();
   return results.map(memoryToStored);
 }
@@ -2559,7 +2678,7 @@ async function saveMemoryOp(ctx, opts) {
   const compositeKey = generateCompositeKey(opts.namespace, opts.key);
   const uniqueKey = generateUniqueKey(opts.namespace, opts.key, opts.value);
   const result = await ctx.database.write(async () => {
-    const existing = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("unique_key", uniqueKey)).fetch();
+    const existing = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("unique_key", uniqueKey)).fetch();
     if (existing.length > 0) {
       const existingMemory = existing[0];
       const shouldPreserveEmbedding = existingMemory.value === opts.value && existingMemory.rawEvidence === opts.rawEvidence && existingMemory.type === opts.type && existingMemory.namespace === opts.namespace && existingMemory.key === opts.key && existingMemory.embedding !== void 0 && existingMemory.embedding.length > 0 && !opts.embedding;
@@ -2632,7 +2751,7 @@ async function updateMemoryOp(ctx, id, updates) {
   const newCompositeKey = generateCompositeKey(newNamespace, newKey);
   const newUniqueKey = generateUniqueKey(newNamespace, newKey, newValue);
   if (newUniqueKey !== memory.uniqueKey) {
-    const existing = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("unique_key", newUniqueKey), import_watermelondb6.Q.where("is_deleted", false)).fetch();
+    const existing = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("unique_key", newUniqueKey), import_watermelondb8.Q.where("is_deleted", false)).fetch();
     if (existing.length > 0) {
       return { ok: false, reason: "conflict", conflictingKey: newUniqueKey };
     }
@@ -2688,7 +2807,7 @@ async function deleteMemoryByIdOp(ctx, id) {
 }
 async function deleteMemoryOp(ctx, namespace, key, value) {
   const uniqueKey = generateUniqueKey(namespace, key, value);
-  const results = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("unique_key", uniqueKey)).fetch();
+  const results = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("unique_key", uniqueKey)).fetch();
   if (results.length > 0) {
     await ctx.database.write(async () => {
       await results[0].update((mem) => {
@@ -2699,7 +2818,7 @@ async function deleteMemoryOp(ctx, namespace, key, value) {
 }
 async function deleteMemoriesByKeyOp(ctx, namespace, key) {
   const compositeKey = generateCompositeKey(namespace, key);
-  const results = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("composite_key", compositeKey), import_watermelondb6.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("composite_key", compositeKey), import_watermelondb8.Q.where("is_deleted", false)).fetch();
   await ctx.database.write(async () => {
     for (const memory of results) {
       await memory.update((mem) => {
@@ -2709,7 +2828,7 @@ async function deleteMemoriesByKeyOp(ctx, namespace, key) {
   });
 }
 async function clearAllMemoriesOp(ctx) {
-  const results = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("is_deleted", false)).fetch();
   await ctx.database.write(async () => {
     for (const memory of results) {
       await memory.update((mem) => {
@@ -2719,7 +2838,7 @@ async function clearAllMemoriesOp(ctx) {
   });
 }
 async function searchSimilarMemoriesOp(ctx, queryEmbedding, limit = 10, minSimilarity = 0.6) {
-  const allMemories = await ctx.memoriesCollection.query(import_watermelondb6.Q.where("is_deleted", false)).fetch();
+  const allMemories = await ctx.memoriesCollection.query(import_watermelondb8.Q.where("is_deleted", false)).fetch();
   const memoriesWithEmbeddings = allMemories.filter(
     (m) => m.embedding && m.embedding.length > 0
   );
@@ -3539,11 +3658,11 @@ function useMemoryStorage(options) {
 var import_react4 = require("react");
 
 // src/lib/db/settings/schema.ts
-var import_watermelondb7 = require("@nozbe/watermelondb");
-var settingsStorageSchema = (0, import_watermelondb7.appSchema)({
+var import_watermelondb9 = require("@nozbe/watermelondb");
+var settingsStorageSchema = (0, import_watermelondb9.appSchema)({
   version: 1,
   tables: [
-    (0, import_watermelondb7.tableSchema)({
+    (0, import_watermelondb9.tableSchema)({
       name: "modelPreferences",
       columns: [
         { name: "wallet_address", type: "string", isIndexed: true },
@@ -3553,21 +3672,8 @@ var settingsStorageSchema = (0, import_watermelondb7.appSchema)({
   ]
 });
 
-// src/lib/db/settings/models.ts
-var import_watermelondb8 = require("@nozbe/watermelondb");
-var import_decorators3 = require("@nozbe/watermelondb/decorators");
-var ModelPreference = class extends import_watermelondb8.Model {
-};
-ModelPreference.table = "modelPreferences";
-__decorateClass([
-  (0, import_decorators3.text)("wallet_address")
-], ModelPreference.prototype, "walletAddress", 2);
-__decorateClass([
-  (0, import_decorators3.text)("models")
-], ModelPreference.prototype, "models", 2);
-
 // src/lib/db/settings/operations.ts
-var import_watermelondb9 = require("@nozbe/watermelondb");
+var import_watermelondb10 = require("@nozbe/watermelondb");
 function modelPreferenceToStored(preference) {
   return {
     uniqueId: preference.id,
@@ -3576,12 +3682,12 @@ function modelPreferenceToStored(preference) {
   };
 }
 async function getModelPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.modelPreferencesCollection.query(import_watermelondb9.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.modelPreferencesCollection.query(import_watermelondb10.Q.where("wallet_address", walletAddress)).fetch();
   return results.length > 0 ? modelPreferenceToStored(results[0]) : null;
 }
 async function setModelPreferenceOp(ctx, walletAddress, models) {
   const result = await ctx.database.write(async () => {
-    const results = await ctx.modelPreferencesCollection.query(import_watermelondb9.Q.where("wallet_address", walletAddress)).fetch();
+    const results = await ctx.modelPreferencesCollection.query(import_watermelondb10.Q.where("wallet_address", walletAddress)).fetch();
     if (results.length > 0) {
       const preference = results[0];
       await preference.update((pref) => {
@@ -3599,7 +3705,7 @@ async function setModelPreferenceOp(ctx, walletAddress, models) {
   return modelPreferenceToStored(result);
 }
 async function deleteModelPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.modelPreferencesCollection.query(import_watermelondb9.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.modelPreferencesCollection.query(import_watermelondb10.Q.where("wallet_address", walletAddress)).fetch();
   if (results.length === 0) return false;
   await ctx.database.write(async () => {
     await results[0].destroyPermanently();
@@ -5163,6 +5269,9 @@ function useGoogleDriveBackup(options) {
   hasEncryptionKey,
   memoryStorageSchema,
   requestEncryptionKey,
+  sdkMigrations,
+  sdkModelClasses,
+  sdkSchema,
   selectTool,
   settingsStorageSchema,
   storeDropboxToken,

package/dist/react/index.d.mts

@@ -1,7 +1,8 @@
 import { Database, Model } from '@nozbe/watermelondb';
 import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
-import { Associations } from '@nozbe/watermelondb/Model';
+import Model$1, { Associations } from '@nozbe/watermelondb/Model';
+import { Class } from '@nozbe/watermelondb/types';
 import { ReactNode, JSX } from 'react';
 
 /**
@@ -904,6 +905,79 @@ interface UseChatStorageResult extends BaseUseChatStorageResult {
  */
 declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageResult;
 
+/**
+ * Combined WatermelonDB schema for all SDK storage modules.
+ *
+ * This unified schema includes all tables needed by the SDK:
+ * - `history`: Chat message storage with embeddings and metadata
+ * - `conversations`: Conversation metadata and organization
+ * - `memories`: Persistent memory storage with semantic search
+ * - `modelPreferences`: User model preferences and settings
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import LokiJSAdapter from '@nozbe/watermelondb/adapters/lokijs';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const adapter = new LokiJSAdapter({
+ *   schema: sdkSchema,
+ *   migrations: sdkMigrations,
+ *   dbName: 'my-app-db',
+ *   useWebWorker: false,
+ *   useIncrementalIndexedDB: true,
+ * });
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+/**
+ * Combined migrations for all SDK storage modules.
+ *
+ * These migrations handle database schema upgrades from any previous version
+ * to the current version. The SDK manages all migration logic internally,
+ * so consumer apps don't need to handle version arithmetic or migration merging.
+ *
+ * **Minimum supported version: v2**
+ * Migrations from v1 are not supported. Databases at v1 require a fresh install.
+ *
+ * Migration history:
+ * - v2 → v3: Added `was_stopped` column to history table
+ * - v3 → v4: Added `modelPreferences` table for settings storage
+ */
+declare const sdkMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
+/**
+ * Model classes to register with the WatermelonDB database.
+ *
+ * Pass this array directly to the `modelClasses` option when creating
+ * your Database instance.
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkModelClasses: Class<Model$1>[];
+
 declare const memoryStorageSchema: Readonly<{
     version: _nozbe_watermelondb_Schema.SchemaVersion;
     tables: _nozbe_watermelondb_Schema.TableMap;
@@ -1715,4 +1789,4 @@ interface UseGoogleDriveBackupResult {
  */
 declare function useGoogleDriveBackup(options: UseGoogleDriveBackupOptions): UseGoogleDriveBackupResult;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_TOOL_SELECTOR_MODEL, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type FileMetadata, type GoogleDriveExportResult, type GoogleDriveImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearToken as clearDropboxToken, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getStoredToken as getDropboxToken, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, settingsStorageSchema, storeToken as storeDropboxToken, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_TOOL_SELECTOR_MODEL, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type FileMetadata, type GoogleDriveExportResult, type GoogleDriveImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearToken as clearDropboxToken, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getStoredToken as getDropboxToken, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, sdkMigrations, sdkModelClasses, sdkSchema, selectTool, settingsStorageSchema, storeToken as storeDropboxToken, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };

package/dist/react/index.d.ts

@@ -1,7 +1,8 @@
 import { Database, Model } from '@nozbe/watermelondb';
 import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
-import { Associations } from '@nozbe/watermelondb/Model';
+import Model$1, { Associations } from '@nozbe/watermelondb/Model';
+import { Class } from '@nozbe/watermelondb/types';
 import { ReactNode, JSX } from 'react';
 
 /**
@@ -904,6 +905,79 @@ interface UseChatStorageResult extends BaseUseChatStorageResult {
  */
 declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageResult;
 
+/**
+ * Combined WatermelonDB schema for all SDK storage modules.
+ *
+ * This unified schema includes all tables needed by the SDK:
+ * - `history`: Chat message storage with embeddings and metadata
+ * - `conversations`: Conversation metadata and organization
+ * - `memories`: Persistent memory storage with semantic search
+ * - `modelPreferences`: User model preferences and settings
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import LokiJSAdapter from '@nozbe/watermelondb/adapters/lokijs';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const adapter = new LokiJSAdapter({
+ *   schema: sdkSchema,
+ *   migrations: sdkMigrations,
+ *   dbName: 'my-app-db',
+ *   useWebWorker: false,
+ *   useIncrementalIndexedDB: true,
+ * });
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+/**
+ * Combined migrations for all SDK storage modules.
+ *
+ * These migrations handle database schema upgrades from any previous version
+ * to the current version. The SDK manages all migration logic internally,
+ * so consumer apps don't need to handle version arithmetic or migration merging.
+ *
+ * **Minimum supported version: v2**
+ * Migrations from v1 are not supported. Databases at v1 require a fresh install.
+ *
+ * Migration history:
+ * - v2 → v3: Added `was_stopped` column to history table
+ * - v3 → v4: Added `modelPreferences` table for settings storage
+ */
+declare const sdkMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
+/**
+ * Model classes to register with the WatermelonDB database.
+ *
+ * Pass this array directly to the `modelClasses` option when creating
+ * your Database instance.
+ *
+ * @example
+ * ```typescript
+ * import { Database } from '@nozbe/watermelondb';
+ * import { sdkSchema, sdkMigrations, sdkModelClasses } from '@reverbia/sdk/react';
+ *
+ * const database = new Database({
+ *   adapter,
+ *   modelClasses: sdkModelClasses,
+ * });
+ * ```
+ */
+declare const sdkModelClasses: Class<Model$1>[];
+
 declare const memoryStorageSchema: Readonly<{
     version: _nozbe_watermelondb_Schema.SchemaVersion;
     tables: _nozbe_watermelondb_Schema.TableMap;
@@ -1715,4 +1789,4 @@ interface UseGoogleDriveBackupResult {
  */
 declare function useGoogleDriveBackup(options: UseGoogleDriveBackupOptions): UseGoogleDriveBackupResult;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_TOOL_SELECTOR_MODEL, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type FileMetadata, type GoogleDriveExportResult, type GoogleDriveImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearToken as clearDropboxToken, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getStoredToken as getDropboxToken, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, settingsStorageSchema, storeToken as storeDropboxToken, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_TOOL_SELECTOR_MODEL, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type FileMetadata, type GoogleDriveExportResult, type GoogleDriveImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearToken as clearDropboxToken, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getStoredToken as getDropboxToken, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, sdkMigrations, sdkModelClasses, sdkSchema, selectTool, settingsStorageSchema, storeToken as storeDropboxToken, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };

package/dist/react/index.mjs

@@ -2327,36 +2327,13 @@ function useChatStorage(options) {
   };
 }
 
-// src/react/useMemoryStorage.ts
-import { useCallback as useCallback3, useState as useState3, useMemo as useMemo2, useRef as useRef2 } from "react";
-import { postApiV1ChatCompletions } from "@reverbia/sdk";
-
-// src/lib/db/memory/schema.ts
+// src/lib/db/schema.ts
 import { appSchema as appSchema2, tableSchema as tableSchema2 } from "@nozbe/watermelondb";
-var memoryStorageSchema = appSchema2({
-  version: 1,
-  tables: [
-    tableSchema2({
-      name: "memories",
-      columns: [
-        { name: "type", type: "string", isIndexed: true },
-        { name: "namespace", type: "string", isIndexed: true },
-        { name: "key", type: "string", isIndexed: true },
-        { name: "value", type: "string" },
-        { name: "raw_evidence", type: "string" },
-        { name: "confidence", type: "number" },
-        { name: "pii", type: "boolean", isIndexed: true },
-        { name: "composite_key", type: "string", isIndexed: true },
-        { name: "unique_key", type: "string", isIndexed: true },
-        { name: "created_at", type: "number", isIndexed: true },
-        { name: "updated_at", type: "number" },
-        { name: "embedding", type: "string", isOptional: true },
-        { name: "embedding_model", type: "string", isOptional: true },
-        { name: "is_deleted", type: "boolean", isIndexed: true }
-      ]
-    })
-  ]
-});
+import {
+  schemaMigrations as schemaMigrations2,
+  addColumns as addColumns2,
+  createTable
+} from "@nozbe/watermelondb/Schema/migrations";
 
 // src/lib/db/memory/models.ts
 import { Model as Model2 } from "@nozbe/watermelondb";
@@ -2407,6 +2384,149 @@ __decorateClass([
   field2("is_deleted")
 ], Memory.prototype, "isDeleted", 2);
 
+// src/lib/db/settings/models.ts
+import { Model as Model3 } from "@nozbe/watermelondb";
+import { text as text3 } from "@nozbe/watermelondb/decorators";
+var ModelPreference = class extends Model3 {
+};
+ModelPreference.table = "modelPreferences";
+__decorateClass([
+  text3("wallet_address")
+], ModelPreference.prototype, "walletAddress", 2);
+__decorateClass([
+  text3("models")
+], ModelPreference.prototype, "models", 2);
+
+// src/lib/db/schema.ts
+var SDK_SCHEMA_VERSION = 4;
+var sdkSchema = appSchema2({
+  version: SDK_SCHEMA_VERSION,
+  tables: [
+    // Chat storage tables
+    tableSchema2({
+      name: "history",
+      columns: [
+        { name: "message_id", type: "number" },
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "role", type: "string", isIndexed: true },
+        { name: "content", type: "string" },
+        { name: "model", type: "string", isOptional: true },
+        { name: "files", type: "string", isOptional: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "vector", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "usage", type: "string", isOptional: true },
+        { name: "sources", type: "string", isOptional: true },
+        { name: "response_duration", type: "number", isOptional: true },
+        { name: "was_stopped", type: "boolean", isOptional: true }
+      ]
+    }),
+    tableSchema2({
+      name: "conversations",
+      columns: [
+        { name: "conversation_id", type: "string", isIndexed: true },
+        { name: "title", type: "string" },
+        { name: "created_at", type: "number" },
+        { name: "updated_at", type: "number" },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Memory storage tables
+    tableSchema2({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    }),
+    // Settings storage tables
+    tableSchema2({
+      name: "modelPreferences",
+      columns: [
+        { name: "wallet_address", type: "string", isIndexed: true },
+        { name: "models", type: "string", isOptional: true }
+      ]
+    })
+  ]
+});
+var sdkMigrations = schemaMigrations2({
+  migrations: [
+    // v2 -> v3: Added was_stopped column to history
+    {
+      toVersion: 3,
+      steps: [
+        addColumns2({
+          table: "history",
+          columns: [{ name: "was_stopped", type: "boolean", isOptional: true }]
+        })
+      ]
+    },
+    // v3 -> v4: Added settings storage (modelPreferences table)
+    {
+      toVersion: 4,
+      steps: [
+        createTable({
+          name: "modelPreferences",
+          columns: [
+            { name: "wallet_address", type: "string", isIndexed: true },
+            { name: "models", type: "string", isOptional: true }
+          ]
+        })
+      ]
+    }
+  ]
+});
+var sdkModelClasses = [
+  Message,
+  Conversation,
+  Memory,
+  ModelPreference
+];
+
+// src/react/useMemoryStorage.ts
+import { useCallback as useCallback3, useState as useState3, useMemo as useMemo2, useRef as useRef2 } from "react";
+import { postApiV1ChatCompletions } from "@reverbia/sdk";
+
+// src/lib/db/memory/schema.ts
+import { appSchema as appSchema3, tableSchema as tableSchema3 } from "@nozbe/watermelondb";
+var memoryStorageSchema = appSchema3({
+  version: 1,
+  tables: [
+    tableSchema3({
+      name: "memories",
+      columns: [
+        { name: "type", type: "string", isIndexed: true },
+        { name: "namespace", type: "string", isIndexed: true },
+        { name: "key", type: "string", isIndexed: true },
+        { name: "value", type: "string" },
+        { name: "raw_evidence", type: "string" },
+        { name: "confidence", type: "number" },
+        { name: "pii", type: "boolean", isIndexed: true },
+        { name: "composite_key", type: "string", isIndexed: true },
+        { name: "unique_key", type: "string", isIndexed: true },
+        { name: "created_at", type: "number", isIndexed: true },
+        { name: "updated_at", type: "number" },
+        { name: "embedding", type: "string", isOptional: true },
+        { name: "embedding_model", type: "string", isOptional: true },
+        { name: "is_deleted", type: "boolean", isIndexed: true }
+      ]
+    })
+  ]
+});
+
 // src/lib/db/memory/types.ts
 function generateCompositeKey(namespace, key) {
   return `${namespace}:${key}`;
@@ -3468,11 +3588,11 @@ function useMemoryStorage(options) {
 import { useCallback as useCallback4, useState as useState4, useMemo as useMemo3, useEffect as useEffect2 } from "react";
 
 // src/lib/db/settings/schema.ts
-import { appSchema as appSchema3, tableSchema as tableSchema3 } from "@nozbe/watermelondb";
-var settingsStorageSchema = appSchema3({
+import { appSchema as appSchema4, tableSchema as tableSchema4 } from "@nozbe/watermelondb";
+var settingsStorageSchema = appSchema4({
   version: 1,
   tables: [
-    tableSchema3({
+    tableSchema4({
       name: "modelPreferences",
       columns: [
         { name: "wallet_address", type: "string", isIndexed: true },
@@ -3482,19 +3602,6 @@ var settingsStorageSchema = appSchema3({
   ]
 });
 
-// src/lib/db/settings/models.ts
-import { Model as Model3 } from "@nozbe/watermelondb";
-import { text as text3 } from "@nozbe/watermelondb/decorators";
-var ModelPreference = class extends Model3 {
-};
-ModelPreference.table = "modelPreferences";
-__decorateClass([
-  text3("wallet_address")
-], ModelPreference.prototype, "walletAddress", 2);
-__decorateClass([
-  text3("models")
-], ModelPreference.prototype, "models", 2);
-
 // src/lib/db/settings/operations.ts
 import { Q as Q3 } from "@nozbe/watermelondb";
 function modelPreferenceToStored(preference) {
@@ -5098,6 +5205,9 @@ export {
   hasEncryptionKey,
   memoryStorageSchema,
   requestEncryptionKey,
+  sdkMigrations,
+  sdkModelClasses,
+  sdkSchema,
   selectTool,
   settingsStorageSchema,
   storeToken as storeDropboxToken,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251217144909",
+  "version": "1.0.0-next.20251218151654",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",