@lanonasis/memory-client 1.0.1 → 2.0.0

package/dist/react/index.d.ts

@@ -0,0 +1,213 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { CoreMemoryClientConfig, CoreMemoryClient, ApiError } from '../core/client';
+export { ApiError, ApiResponse, CoreMemoryClient, CoreMemoryClientConfig, PaginatedResponse } from '../core/client';
+import { MemoryEntry, UpdateMemoryRequest, CreateMemoryRequest, MemorySearchResult, SearchMemoryRequest } from '../core/types';
+export { CreateMemoryRequest, MemoryEntry, MemorySearchResult, MemoryStatus, MemoryTopic, MemoryType, SearchMemoryRequest, UpdateMemoryRequest, UserMemoryStats } from '../core/types';
+
+declare const MemoryContext: react.Context<CoreMemoryClient | null>;
+interface MemoryProviderProps {
+    children: ReactNode;
+    config?: CoreMemoryClientConfig;
+    apiKey?: string;
+    apiUrl?: string;
+    client?: CoreMemoryClient;
+}
+/**
+ * Memory Provider Component
+ *
+ * Wrap your app or component tree with this provider to enable Memory hooks
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <MemoryProvider apiKey={process.env.REACT_APP_LANONASIS_KEY}>
+ *       <YourComponents />
+ *     </MemoryProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function MemoryProvider({ children, config, apiKey, apiUrl, client: providedClient }: MemoryProviderProps): react.FunctionComponentElement<react.ProviderProps<CoreMemoryClient | null>>;
+
+/**
+ * React Hooks for Memory Client
+ *
+ * Provides convenient React hooks for working with memories
+ */
+
+/**
+ * Hook to access the Memory Client instance
+ *
+ * @throws Error if used outside of MemoryProvider
+ */
+declare function useMemoryClient(): {};
+/**
+ * Result type for list/search hooks
+ */
+interface UseMemoriesResult {
+    memories: MemoryEntry[];
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * Hook to list memories with optional filtering
+ *
+ * @example
+ * ```tsx
+ * function MemoryList() {
+ *   const { memories, loading, error, refresh } = useMemories({
+ *     memory_type: 'project',
+ *     limit: 20
+ *   });
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       {memories.map(m => <div key={m.id}>{m.title}</div>)}
+ *       <button onClick={refresh}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemories(options?: {
+    page?: number;
+    limit?: number;
+    memory_type?: string;
+    topic_id?: string;
+    project_ref?: string;
+    status?: string;
+    tags?: string[];
+    sort?: string;
+    order?: 'asc' | 'desc';
+}): UseMemoriesResult;
+/**
+ * Result type for single memory hook
+ */
+interface UseMemoryResult {
+    memory: MemoryEntry | null;
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<void>;
+    update: (updates: UpdateMemoryRequest) => Promise<void>;
+    deleteMemory: () => Promise<void>;
+}
+/**
+ * Hook to fetch and manage a single memory by ID
+ *
+ * @example
+ * ```tsx
+ * function MemoryDetail({ id }: { id: string }) {
+ *   const { memory, loading, error, update, deleteMemory } = useMemory(id);
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!memory) return <div>Memory not found</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{memory.title}</h1>
+ *       <p>{memory.content}</p>
+ *       <button onClick={() => update({ title: 'Updated Title' })}>Update</button>
+ *       <button onClick={deleteMemory}>Delete</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemory(id: string): UseMemoryResult;
+/**
+ * Result type for create memory hook
+ */
+interface UseCreateMemoryResult {
+    createMemory: (memory: CreateMemoryRequest) => Promise<MemoryEntry | null>;
+    loading: boolean;
+    error: ApiError | null;
+}
+/**
+ * Hook to create new memories
+ *
+ * @example
+ * ```tsx
+ * function CreateMemoryForm() {
+ *   const { createMemory, loading, error } = useCreateMemory();
+ *   const [title, setTitle] = useState('');
+ *   const [content, setContent] = useState('');
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const memory = await createMemory({ title, content });
+ *     if (memory) {
+ *       console.log('Created:', memory.id);
+ *       setTitle('');
+ *       setContent('');
+ *     }
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input value={title} onChange={e => setTitle(e.target.value)} />
+ *       <textarea value={content} onChange={e => setContent(e.target.value)} />
+ *       <button type="submit" disabled={loading}>Create</button>
+ *       {error && <div>Error: {error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+declare function useCreateMemory(): UseCreateMemoryResult;
+/**
+ * Result type for search memories hook
+ */
+interface UseSearchMemoriesResult {
+    results: MemorySearchResult[];
+    loading: boolean;
+    error: ApiError | null;
+    search: (query: string, options?: Omit<SearchMemoryRequest, 'query'>) => Promise<void>;
+    totalResults: number;
+    searchTime: number;
+}
+/**
+ * Hook to search memories with debouncing
+ *
+ * @example
+ * ```tsx
+ * function MemorySearch() {
+ *   const { results, loading, error, search } = useSearchMemories();
+ *   const [query, setQuery] = useState('');
+ *
+ *   useEffect(() => {
+ *     if (query.length > 2) {
+ *       search(query, { limit: 10 });
+ *     }
+ *   }, [query, search]);
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={query}
+ *         onChange={e => setQuery(e.target.value)}
+ *         placeholder="Search memories..."
+ *       />
+ *       {loading && <div>Searching...</div>}
+ *       {error && <div>Error: {error.message}</div>}
+ *       {results.map(r => (
+ *         <div key={r.id}>
+ *           <h3>{r.title}</h3>
+ *           <span>Score: {r.similarity_score.toFixed(2)}</span>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useSearchMemories(debounceMs?: number): UseSearchMemoriesResult;
+
+export { MemoryContext, MemoryProvider, useCreateMemory, useMemories, useMemory, useMemoryClient, useSearchMemories };
+export type { MemoryProviderProps, UseCreateMemoryResult, UseMemoriesResult, UseMemoryResult, UseSearchMemoriesResult };

package/dist/react/index.js

@@ -0,0 +1,348 @@
+import { createContext, useMemo, createElement, useContext, useState, useCallback, useEffect, useRef } from 'react';
+import { createMemoryClient } from '../core/client';
+
+/**
+ * React Context Provider for Memory Client
+ *
+ * Provides a Memory Client instance to all child components via React Context
+ */
+const MemoryContext = createContext(null);
+/**
+ * Memory Provider Component
+ *
+ * Wrap your app or component tree with this provider to enable Memory hooks
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <MemoryProvider apiKey={process.env.REACT_APP_LANONASIS_KEY}>
+ *       <YourComponents />
+ *     </MemoryProvider>
+ *   );
+ * }
+ * ```
+ */
+function MemoryProvider({ children, config, apiKey, apiUrl = 'https://api.lanonasis.com', client: providedClient }) {
+    const client = useMemo(() => {
+        if (providedClient) {
+            return providedClient;
+        }
+        return createMemoryClient({
+            apiUrl,
+            apiKey,
+            ...config
+        });
+    }, [providedClient, apiUrl, apiKey, config]);
+    return createElement(MemoryContext.Provider, { value: client }, children);
+}
+
+/**
+ * React Hooks for Memory Client
+ *
+ * Provides convenient React hooks for working with memories
+ */
+/**
+ * Hook to access the Memory Client instance
+ *
+ * @throws Error if used outside of MemoryProvider
+ */
+function useMemoryClient() {
+    const client = useContext(MemoryContext);
+    if (!client) {
+        throw new Error('useMemoryClient must be used within a MemoryProvider');
+    }
+    return client;
+}
+/**
+ * Hook to list memories with optional filtering
+ *
+ * @example
+ * ```tsx
+ * function MemoryList() {
+ *   const { memories, loading, error, refresh } = useMemories({
+ *     memory_type: 'project',
+ *     limit: 20
+ *   });
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       {memories.map(m => <div key={m.id}>{m.title}</div>)}
+ *       <button onClick={refresh}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useMemories(options) {
+    const client = useMemoryClient();
+    const [memories, setMemories] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const loadMemories = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        const result = await client.listMemories(options);
+        if (result.error) {
+            setError({
+                message: result.error,
+                code: 'API_ERROR'
+            });
+            setMemories([]);
+        }
+        else if (result.data) {
+            setMemories(result.data.data);
+        }
+        setLoading(false);
+    }, [client, JSON.stringify(options)]);
+    useEffect(() => {
+        loadMemories();
+    }, [loadMemories]);
+    return {
+        memories,
+        loading,
+        error,
+        refresh: loadMemories
+    };
+}
+/**
+ * Hook to fetch and manage a single memory by ID
+ *
+ * @example
+ * ```tsx
+ * function MemoryDetail({ id }: { id: string }) {
+ *   const { memory, loading, error, update, deleteMemory } = useMemory(id);
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!memory) return <div>Memory not found</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{memory.title}</h1>
+ *       <p>{memory.content}</p>
+ *       <button onClick={() => update({ title: 'Updated Title' })}>Update</button>
+ *       <button onClick={deleteMemory}>Delete</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useMemory(id) {
+    const client = useMemoryClient();
+    const [memory, setMemory] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const loadMemory = useCallback(async () => {
+        if (!id) {
+            setMemory(null);
+            setLoading(false);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        const result = await client.getMemory(id);
+        if (result.error) {
+            setError({
+                message: result.error,
+                code: 'API_ERROR'
+            });
+            setMemory(null);
+        }
+        else if (result.data) {
+            setMemory(result.data);
+        }
+        setLoading(false);
+    }, [client, id]);
+    useEffect(() => {
+        loadMemory();
+    }, [loadMemory]);
+    const update = useCallback(async (updates) => {
+        if (!id)
+            return;
+        const result = await client.updateMemory(id, updates);
+        if (result.error) {
+            setError({
+                message: result.error,
+                code: 'API_ERROR'
+            });
+        }
+        else if (result.data) {
+            setMemory(result.data);
+        }
+    }, [client, id]);
+    const deleteMemory = useCallback(async () => {
+        if (!id)
+            return;
+        const result = await client.deleteMemory(id);
+        if (result.error) {
+            setError({
+                message: result.error,
+                code: 'API_ERROR'
+            });
+        }
+        else {
+            setMemory(null);
+        }
+    }, [client, id]);
+    return {
+        memory,
+        loading,
+        error,
+        refresh: loadMemory,
+        update,
+        deleteMemory
+    };
+}
+/**
+ * Hook to create new memories
+ *
+ * @example
+ * ```tsx
+ * function CreateMemoryForm() {
+ *   const { createMemory, loading, error } = useCreateMemory();
+ *   const [title, setTitle] = useState('');
+ *   const [content, setContent] = useState('');
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const memory = await createMemory({ title, content });
+ *     if (memory) {
+ *       console.log('Created:', memory.id);
+ *       setTitle('');
+ *       setContent('');
+ *     }
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input value={title} onChange={e => setTitle(e.target.value)} />
+ *       <textarea value={content} onChange={e => setContent(e.target.value)} />
+ *       <button type="submit" disabled={loading}>Create</button>
+ *       {error && <div>Error: {error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+function useCreateMemory() {
+    const client = useMemoryClient();
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const createMemory = useCallback(async (memory) => {
+        setLoading(true);
+        setError(null);
+        const result = await client.createMemory(memory);
+        if (result.error) {
+            setError({
+                message: result.error,
+                code: 'API_ERROR'
+            });
+            setLoading(false);
+            return null;
+        }
+        setLoading(false);
+        return result.data || null;
+    }, [client]);
+    return {
+        createMemory,
+        loading,
+        error
+    };
+}
+/**
+ * Hook to search memories with debouncing
+ *
+ * @example
+ * ```tsx
+ * function MemorySearch() {
+ *   const { results, loading, error, search } = useSearchMemories();
+ *   const [query, setQuery] = useState('');
+ *
+ *   useEffect(() => {
+ *     if (query.length > 2) {
+ *       search(query, { limit: 10 });
+ *     }
+ *   }, [query, search]);
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={query}
+ *         onChange={e => setQuery(e.target.value)}
+ *         placeholder="Search memories..."
+ *       />
+ *       {loading && <div>Searching...</div>}
+ *       {error && <div>Error: {error.message}</div>}
+ *       {results.map(r => (
+ *         <div key={r.id}>
+ *           <h3>{r.title}</h3>
+ *           <span>Score: {r.similarity_score.toFixed(2)}</span>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useSearchMemories(debounceMs = 300) {
+    const client = useMemoryClient();
+    const [results, setResults] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [totalResults, setTotalResults] = useState(0);
+    const [searchTime, setSearchTime] = useState(0);
+    const debounceTimer = useRef(null);
+    const search = useCallback(async (query, options) => {
+        // Clear existing timer
+        if (debounceTimer.current) {
+            clearTimeout(debounceTimer.current);
+        }
+        // Set new timer
+        debounceTimer.current = setTimeout(async () => {
+            setLoading(true);
+            setError(null);
+            const result = await client.searchMemories({
+                query,
+                ...options
+            });
+            if (result.error) {
+                setError({
+                    message: result.error,
+                    code: 'API_ERROR'
+                });
+                setResults([]);
+                setTotalResults(0);
+                setSearchTime(0);
+            }
+            else if (result.data) {
+                setResults(result.data.results);
+                setTotalResults(result.data.total_results);
+                setSearchTime(result.data.search_time_ms);
+            }
+            setLoading(false);
+        }, debounceMs);
+    }, [client, debounceMs]);
+    // Cleanup timer on unmount
+    useEffect(() => {
+        return () => {
+            if (debounceTimer.current) {
+                clearTimeout(debounceTimer.current);
+            }
+        };
+    }, []);
+    return {
+        results,
+        loading,
+        error,
+        search,
+        totalResults,
+        searchTime
+    };
+}
+
+export { MemoryContext, MemoryProvider, useCreateMemory, useMemories, useMemory, useMemoryClient, useSearchMemories };
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"sourcesContent":["/**\n * React Context Provider for Memory Client\n *\n * Provides a Memory Client instance to all child components via React Context\n */\n\nimport { createElement, createContext, useMemo, type ReactNode } from 'react';\nimport { createMemoryClient, type CoreMemoryClient, type CoreMemoryClientConfig } from '../core/client';\n\nexport const MemoryContext = createContext<CoreMemoryClient | null>(null);\n\nexport interface MemoryProviderProps {\n  children: ReactNode;\n  config?: CoreMemoryClientConfig;\n  apiKey?: string;\n  apiUrl?: string;\n  client?: CoreMemoryClient;\n}\n\n/**\n * Memory Provider Component\n *\n * Wrap your app or component tree with this provider to enable Memory hooks\n *\n * @example\n * ```tsx\n * function App() {\n *   return (\n *     <MemoryProvider apiKey={process.env.REACT_APP_LANONASIS_KEY}>\n *       <YourComponents />\n *     </MemoryProvider>\n *   );\n * }\n * ```\n */\nexport function MemoryProvider({\n  children,\n  config,\n  apiKey,\n  apiUrl = 'https://api.lanonasis.com',\n  client: providedClient\n}: MemoryProviderProps) {\n  const client = useMemo(() => {\n    if (providedClient) {\n      return providedClient;\n    }\n\n    return createMemoryClient({\n      apiUrl,\n      apiKey,\n      ...config\n    });\n  }, [providedClient, apiUrl, apiKey, config]);\n\n  return createElement(MemoryContext.Provider, { value: client }, children);\n}\n","/**\n * React Hooks for Memory Client\n *\n * Provides convenient React hooks for working with memories\n */\n\nimport { useContext, useEffect, useState, useCallback, useRef } from 'react';\nimport { MemoryContext } from './provider';\nimport type {\n  MemoryEntry,\n  CreateMemoryRequest,\n  UpdateMemoryRequest,\n  SearchMemoryRequest,\n  MemorySearchResult\n} from '../core/types';\nimport type { ApiError } from '../core/client';\n\n/**\n * Hook to access the Memory Client instance\n *\n * @throws Error if used outside of MemoryProvider\n */\nexport function useMemoryClient() {\n  const client = useContext(MemoryContext);\n\n  if (!client) {\n    throw new Error('useMemoryClient must be used within a MemoryProvider');\n  }\n\n  return client;\n}\n\n/**\n * Result type for list/search hooks\n */\nexport interface UseMemoriesResult {\n  memories: MemoryEntry[];\n  loading: boolean;\n  error: ApiError | null;\n  refresh: () => Promise<void>;\n}\n\n/**\n * Hook to list memories with optional filtering\n *\n * @example\n * ```tsx\n * function MemoryList() {\n *   const { memories, loading, error, refresh } = useMemories({\n *     memory_type: 'project',\n *     limit: 20\n *   });\n *\n *   if (loading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {memories.map(m => <div key={m.id}>{m.title}</div>)}\n *       <button onClick={refresh}>Refresh</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemories(options?: {\n  page?: number;\n  limit?: number;\n  memory_type?: string;\n  topic_id?: string;\n  project_ref?: string;\n  status?: string;\n  tags?: string[];\n  sort?: string;\n  order?: 'asc' | 'desc';\n}): UseMemoriesResult {\n  const client = useMemoryClient();\n  const [memories, setMemories] = useState<MemoryEntry[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<ApiError | null>(null);\n\n  const loadMemories = useCallback(async () => {\n    setLoading(true);\n    setError(null);\n\n    const result = await client.listMemories(options);\n\n    if (result.error) {\n      setError({\n        message: result.error,\n        code: 'API_ERROR'\n      });\n      setMemories([]);\n    } else if (result.data) {\n      setMemories(result.data.data);\n    }\n\n    setLoading(false);\n  }, [client, JSON.stringify(options)]);\n\n  useEffect(() => {\n    loadMemories();\n  }, [loadMemories]);\n\n  return {\n    memories,\n    loading,\n    error,\n    refresh: loadMemories\n  };\n}\n\n/**\n * Result type for single memory hook\n */\nexport interface UseMemoryResult {\n  memory: MemoryEntry | null;\n  loading: boolean;\n  error: ApiError | null;\n  refresh: () => Promise<void>;\n  update: (updates: UpdateMemoryRequest) => Promise<void>;\n  deleteMemory: () => Promise<void>;\n}\n\n/**\n * Hook to fetch and manage a single memory by ID\n *\n * @example\n * ```tsx\n * function MemoryDetail({ id }: { id: string }) {\n *   const { memory, loading, error, update, deleteMemory } = useMemory(id);\n *\n *   if (loading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   if (!memory) return <div>Memory not found</div>;\n *\n *   return (\n *     <div>\n *       <h1>{memory.title}</h1>\n *       <p>{memory.content}</p>\n *       <button onClick={() => update({ title: 'Updated Title' })}>Update</button>\n *       <button onClick={deleteMemory}>Delete</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemory(id: string): UseMemoryResult {\n  const client = useMemoryClient();\n  const [memory, setMemory] = useState<MemoryEntry | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<ApiError | null>(null);\n\n  const loadMemory = useCallback(async () => {\n    if (!id) {\n      setMemory(null);\n      setLoading(false);\n      return;\n    }\n\n    setLoading(true);\n    setError(null);\n\n    const result = await client.getMemory(id);\n\n    if (result.error) {\n      setError({\n        message: result.error,\n        code: 'API_ERROR'\n      });\n      setMemory(null);\n    } else if (result.data) {\n      setMemory(result.data);\n    }\n\n    setLoading(false);\n  }, [client, id]);\n\n  useEffect(() => {\n    loadMemory();\n  }, [loadMemory]);\n\n  const update = useCallback(async (updates: UpdateMemoryRequest) => {\n    if (!id) return;\n\n    const result = await client.updateMemory(id, updates);\n\n    if (result.error) {\n      setError({\n        message: result.error,\n        code: 'API_ERROR'\n      });\n    } else if (result.data) {\n      setMemory(result.data);\n    }\n  }, [client, id]);\n\n  const deleteMemory = useCallback(async () => {\n    if (!id) return;\n\n    const result = await client.deleteMemory(id);\n\n    if (result.error) {\n      setError({\n        message: result.error,\n        code: 'API_ERROR'\n      });\n    } else {\n      setMemory(null);\n    }\n  }, [client, id]);\n\n  return {\n    memory,\n    loading,\n    error,\n    refresh: loadMemory,\n    update,\n    deleteMemory\n  };\n}\n\n/**\n * Result type for create memory hook\n */\nexport interface UseCreateMemoryResult {\n  createMemory: (memory: CreateMemoryRequest) => Promise<MemoryEntry | null>;\n  loading: boolean;\n  error: ApiError | null;\n}\n\n/**\n * Hook to create new memories\n *\n * @example\n * ```tsx\n * function CreateMemoryForm() {\n *   const { createMemory, loading, error } = useCreateMemory();\n *   const [title, setTitle] = useState('');\n *   const [content, setContent] = useState('');\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const memory = await createMemory({ title, content });\n *     if (memory) {\n *       console.log('Created:', memory.id);\n *       setTitle('');\n *       setContent('');\n *     }\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       <input value={title} onChange={e => setTitle(e.target.value)} />\n *       <textarea value={content} onChange={e => setContent(e.target.value)} />\n *       <button type=\"submit\" disabled={loading}>Create</button>\n *       {error && <div>Error: {error.message}</div>}\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useCreateMemory(): UseCreateMemoryResult {\n  const client = useMemoryClient();\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<ApiError | null>(null);\n\n  const createMemory = useCallback(async (memory: CreateMemoryRequest): Promise<MemoryEntry | null> => {\n    setLoading(true);\n    setError(null);\n\n    const result = await client.createMemory(memory);\n\n    if (result.error) {\n      setError({\n        message: result.error,\n        code: 'API_ERROR'\n      });\n      setLoading(false);\n      return null;\n    }\n\n    setLoading(false);\n    return result.data || null;\n  }, [client]);\n\n  return {\n    createMemory,\n    loading,\n    error\n  };\n}\n\n/**\n * Result type for search memories hook\n */\nexport interface UseSearchMemoriesResult {\n  results: MemorySearchResult[];\n  loading: boolean;\n  error: ApiError | null;\n  search: (query: string, options?: Omit<SearchMemoryRequest, 'query'>) => Promise<void>;\n  totalResults: number;\n  searchTime: number;\n}\n\n/**\n * Hook to search memories with debouncing\n *\n * @example\n * ```tsx\n * function MemorySearch() {\n *   const { results, loading, error, search } = useSearchMemories();\n *   const [query, setQuery] = useState('');\n *\n *   useEffect(() => {\n *     if (query.length > 2) {\n *       search(query, { limit: 10 });\n *     }\n *   }, [query, search]);\n *\n *   return (\n *     <div>\n *       <input\n *         value={query}\n *         onChange={e => setQuery(e.target.value)}\n *         placeholder=\"Search memories...\"\n *       />\n *       {loading && <div>Searching...</div>}\n *       {error && <div>Error: {error.message}</div>}\n *       {results.map(r => (\n *         <div key={r.id}>\n *           <h3>{r.title}</h3>\n *           <span>Score: {r.similarity_score.toFixed(2)}</span>\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useSearchMemories(debounceMs: number = 300): UseSearchMemoriesResult {\n  const client = useMemoryClient();\n  const [results, setResults] = useState<MemorySearchResult[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<ApiError | null>(null);\n  const [totalResults, setTotalResults] = useState(0);\n  const [searchTime, setSearchTime] = useState(0);\n  const debounceTimer = useRef<NodeJS.Timeout | null>(null);\n\n  const search = useCallback(async (query: string, options?: Omit<SearchMemoryRequest, 'query'>) => {\n    // Clear existing timer\n    if (debounceTimer.current) {\n      clearTimeout(debounceTimer.current);\n    }\n\n    // Set new timer\n    debounceTimer.current = setTimeout(async () => {\n      setLoading(true);\n      setError(null);\n\n      const result = await client.searchMemories({\n        query,\n        ...options\n      });\n\n      if (result.error) {\n        setError({\n          message: result.error,\n          code: 'API_ERROR'\n        });\n        setResults([]);\n        setTotalResults(0);\n        setSearchTime(0);\n      } else if (result.data) {\n        setResults(result.data.results);\n        setTotalResults(result.data.total_results);\n        setSearchTime(result.data.search_time_ms);\n      }\n\n      setLoading(false);\n    }, debounceMs);\n  }, [client, debounceMs]);\n\n  // Cleanup timer on unmount\n  useEffect(() => {\n    return () => {\n      if (debounceTimer.current) {\n        clearTimeout(debounceTimer.current);\n      }\n    };\n  }, []);\n\n  return {\n    results,\n    loading,\n    error,\n    search,\n    totalResults,\n    searchTime\n  };\n}\n"],"names":[],"mappings":"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"}