@lanonasis/memory-client 1.0.1 → 2.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,235 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { CoreMemoryClientConfig, CoreMemoryClient } from '../core/client';
+export { 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>>;
+
+/**
+ * Error handling for Memory Client
+ * Browser-safe, no Node.js dependencies
+ */
+/**
+ * Standardized error codes for programmatic error handling
+ */
+declare const ERROR_CODES: readonly ["API_ERROR", "AUTH_ERROR", "VALIDATION_ERROR", "TIMEOUT_ERROR", "RATE_LIMIT_ERROR", "NOT_FOUND", "NETWORK_ERROR", "FORBIDDEN", "CONFLICT", "SERVER_ERROR"];
+type ErrorCode = typeof ERROR_CODES[number];
+/**
+ * Structured API error response - replaces plain string errors
+ * Enables programmatic error handling with typed codes
+ */
+interface ApiErrorResponse {
+    /** Machine-readable error code for programmatic handling */
+    code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code if from API response */
+    statusCode?: number;
+    /** Additional error details (validation errors, etc.) */
+    details?: unknown;
+    /** Request ID for debugging/support */
+    requestId?: string;
+    /** Timestamp when error occurred */
+    timestamp?: string;
+}
+
+/**
+ * Hook to access the Memory Client instance
+ *
+ * @throws Error if used outside of MemoryProvider
+ */
+declare function useMemoryClient(): CoreMemoryClient;
+/**
+ * Result type for list/search hooks
+ */
+interface UseMemoriesResult {
+    memories: MemoryEntry[];
+    loading: boolean;
+    error: ApiErrorResponse | 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: ApiErrorResponse | 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: ApiErrorResponse | 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: ApiErrorResponse | 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 { ApiErrorResponse, ErrorCode, MemoryProviderProps, UseCreateMemoryResult, UseMemoriesResult, UseMemoryResult, UseSearchMemoriesResult };

package/dist/react/index.js

@@ -0,0 +1,333 @@
+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(result.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(result.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(result.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(result.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(result.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,
+                status: options?.status ?? 'active',
+                limit: options?.limit ?? 20,
+                threshold: options?.threshold ?? 0.7,
+                ...options
+            });
+            if (result.error) {
+                setError(result.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 { ApiErrorResponse } from '../core/errors';\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: ApiErrorResponse | 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<ApiErrorResponse | 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(result.error);\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: ApiErrorResponse | 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<ApiErrorResponse | 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(result.error);\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(result.error);\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(result.error);\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: ApiErrorResponse | 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<ApiErrorResponse | 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(result.error);\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: ApiErrorResponse | 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<ApiErrorResponse | null>(null);\n  const [totalResults, setTotalResults] = useState(0);\n  const [searchTime, setSearchTime] = useState(0);\n  const debounceTimer = useRef<ReturnType<typeof setTimeout> | 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        status: options?.status ?? 'active',\n        limit: options?.limit ?? 20,\n        threshold: options?.threshold ?? 0.7,\n        ...options\n      });\n\n      if (result.error) {\n        setError(result.error);\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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"}