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

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';
 
 /**
@@ -475,6 +476,11 @@ type SendMessageArgs = BaseSendMessageArgs & {
      * This is typically formatted memories from useMemoryStorage.
      */
     memoryContext?: string;
+    /**
+     * Search context to inject as a system message.
+     * This is typically formatted search results from useSearch.
+     */
+    searchContext?: string;
 };
 type SendMessageResult = {
     data: LlmapiChatCompletionResponse;
@@ -732,6 +738,8 @@ interface BaseSendMessageWithStorageArgs {
     files?: FileMetadata[];
     onData?: (chunk: string) => void;
     memoryContext?: string;
+    searchContext?: string;
+    sources?: SearchSource[];
 }
 interface BaseUseChatStorageResult {
     isLoading: boolean;
@@ -904,6 +912,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 +1796,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

@@ -1238,7 +1238,8 @@ function useChat(options) {
       onData,
       runTools = true,
       headers,
-      memoryContext
+      memoryContext,
+      searchContext
     }) => {
       const messagesValidation = validateMessages(messages);
       if (!messagesValidation.valid) {
@@ -1264,6 +1265,22 @@ function useChat(options) {
         };
         messagesWithContext = [memorySystemMessage, ...messages];
       }
+      if (searchContext) {
+        const searchSystemMessage = {
+          role: "system",
+          content: [
+            {
+              type: "text",
+              text: "Here are the search results for the user's query. Use this information to respond to the user's request:"
+            },
+            {
+              type: "text",
+              text: searchContext
+            }
+          ]
+        };
+        messagesWithContext = [searchSystemMessage, ...messagesWithContext];
+      }
       let messagesWithToolContext = messagesWithContext;
       const shouldRunTools = runTools && tools && tools.length > 0;
       if (shouldRunTools) {
@@ -2149,7 +2166,9 @@ function useChatStorage(options) {
         onData: perRequestOnData,
         runTools,
         headers,
-        memoryContext
+        memoryContext,
+        searchContext,
+        sources
       } = args;
       let convId;
       try {
@@ -2215,7 +2234,8 @@ function useChatStorage(options) {
         onData: perRequestOnData,
         runTools,
         headers,
-        memoryContext
+        memoryContext,
+        searchContext
       });
       const responseDuration = (Date.now() - startTime) / 1e3;
       if (result.error || !result.data) {
@@ -2232,19 +2252,24 @@ function useChatStorage(options) {
               model: responseModel,
               usage: convertUsageToStored(abortedResult.data?.usage),
               responseDuration,
-              wasStopped: true
+              wasStopped: true,
+              sources
             });
             const completionData = abortedResult.data || {
               id: `aborted-${Date.now()}`,
               model: responseModel,
-              choices: [{
-                index: 0,
-                message: {
-                  role: "assistant",
-                  content: [{ type: "text", text: assistantContent2 }]
-                },
-                finish_reason: "stop"
-              }],
+              choices: [
+                {
+                  index: 0,
+                  message: {
+                    role: "assistant",
+                    content: [
+                      { type: "text", text: assistantContent2 }
+                    ]
+                  },
+                  finish_reason: "stop"
+                }
+              ],
               usage: void 0
             };
             return {
@@ -2303,7 +2328,12 @@ function useChatStorage(options) {
   );
   const updateMessageEmbedding = useCallback2(
     async (uniqueId, vector, embeddingModel) => {
-      return updateMessageEmbeddingOp(storageCtx, uniqueId, vector, embeddingModel);
+      return updateMessageEmbeddingOp(
+        storageCtx,
+        uniqueId,
+        vector,
+        embeddingModel
+      );
     },
     [storageCtx]
   );
@@ -2327,36 +2357,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 +2414,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 +3618,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 +3632,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 +5235,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.20251218162622",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",