@memoryintelligence/react 2.0.0

package/README.md

@@ -0,0 +1,344 @@
+# @memoryintelligence/react
+
+Official React hooks for [Memory Intelligence](https://memoryintelligence.io) SDK.
+
+## Installation
+
+```bash
+npm install @memoryintelligence/react @memoryintelligence/sdk
+# or
+yarn add @memoryintelligence/react @memoryintelligence/sdk
+```
+
+## Quick Start
+
+### 1. Setup Provider
+
+Wrap your app with `MemoryClientProvider`:
+
+```tsx
+import { MemoryClientProvider } from '@memoryintelligence/react';
+
+function App() {
+  return (
+    <MemoryClientProvider config={{ apiKey: process.env.REACT_APP_MI_API_KEY }}>
+      <YourApp />
+    </MemoryClientProvider>
+  );
+}
+```
+
+### 2. Use Hooks
+
+```tsx
+import { useMemorySearch, useDriftSubscription } from '@memoryintelligence/react';
+
+function SearchPage() {
+  const { search, data, loading } = useMemorySearch();
+
+  return (
+    <div>
+      <button onClick={() => search('project planning')}>Search</button>
+      {loading && <p>Searching...</p>}
+      {data && <Results results={data.results} />}
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### MemoryClientProvider
+
+Provides Memory Intelligence client to child components.
+
+```tsx
+<MemoryClientProvider 
+  config={{
+    apiKey: string;
+    baseUrl?: string;
+    wsUrl?: string;
+    userUlid?: string;
+    orgUlid?: string;
+  }}
+>
+  {children}
+</MemoryClientProvider>
+```
+
+### useMemoryClient
+
+Access the Memory Intelligence client directly.
+
+```tsx
+const client = useMemoryClient();
+const umo = await client.umo.process('content');
+```
+
+### useMemorySearch
+
+Search memories with reactive state management.
+
+```tsx
+const { search, data, loading, error, reset } = useMemorySearch();
+
+// Trigger search
+await search('query', { limit: 10, scope: Scope.USER });
+
+// Access results
+console.log(data?.results);
+```
+
+### useMemoryProcess
+
+Process content into Meaning Objects.
+
+```tsx
+const { process, data, loading, error, reset } = useMemoryProcess();
+
+// Process content
+await process('Meeting notes about Q2 strategy', {
+  source: 'web_form',
+  metadata: { category: 'meetings' }
+});
+
+// Access created UMO
+console.log(data?.umo_id);
+```
+
+### useDriftSubscription
+
+Subscribe to real-time entity meaning changes.
+
+```tsx
+const { updates, latestUpdate, connected, error, clearUpdates } = useDriftSubscription({
+  entityUlids: ['01ARZ3NDEV5ARZ3ND']
+});
+
+// Access updates
+updates.forEach(update => {
+  console.log(update.canonicalName, update.driftEpoch);
+});
+```
+
+**Options:**
+- `options.entityUlids` - Array of entity ULIDs to watch
+- `options.orgUlid` - Organization filter
+- `maxUpdates` - Maximum updates to retain (default: 50)
+
+**Returns:**
+- `updates` - Array of drift updates (newest first)
+- `latestUpdate` - Most recent update
+- `connected` - WebSocket connection status
+- `error` - Error if any
+- `clearUpdates()` - Clear update history
+
+### useComputeProgress
+
+Track long-running compute operations with progress.
+
+```tsx
+const { progress, result, isComplete, error, reset } = useComputeProgress(
+  'analyze_decision_process',
+  { narrative_ulid: '01ARZ3NDFQ69G5FAVSV4RRFF' }
+);
+
+// Access progress
+if (progress) {
+  console.log(`${progress.progressPercent}%: ${progress.message}`);
+}
+
+// Access result when complete
+if (isComplete && result) {
+  console.log(result.result);
+}
+```
+
+**Options:**
+- `enabled` - Whether to start subscription (default: true)
+
+**Returns:**
+- `progress` - Current progress update
+- `result` - Final result when complete
+- `connected` - WebSocket connection status
+- `error` - Error if any
+- `isComplete` - Whether operation finished
+- `reset()` - Reset state
+
+## Examples
+
+### Drift Monitor Component
+
+```tsx
+import { useDriftSubscription } from '@memoryintelligence/react';
+
+function DriftMonitor({ entityUlid }) {
+  const { updates, connected, error } = useDriftSubscription({
+    entityUlids: [entityUlid]
+  });
+
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      <div className="status">
+        {connected ? '🟢 Live' : '⚪ Disconnected'}
+      </div>
+
+      <div className="updates">
+        {updates.map((update, i) => (
+          <div key={i} className={!update.meaningStable ? 'warning' : ''}>
+            <h4>{update.canonicalName}</h4>
+            <p>Epoch: {update.driftEpoch} | Magnitude: {update.driftMagnitude.toFixed(3)}</p>
+            
+            {!update.meaningStable && (
+              <div className="alert">
+                <strong>Meaning Changed</strong>
+                <p>{update.explainHuman.driftSummary}</p>
+                <ul>
+                  {update.explainHuman.whatChanged.changes.map((change, j) => (
+                    <li key={j}>{change}</li>
+                  ))}
+                </ul>
+              </div>
+            )}
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+### Search with Form
+
+```tsx
+import { useState } from 'react';
+import { useMemorySearch } from '@memoryintelligence/react';
+
+function SearchBox() {
+  const [query, setQuery] = useState('');
+  const { search, data, loading, error } = useMemorySearch();
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await search(query, { limit: 20 });
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input
+        value={query}
+        onChange={(e) => setQuery(e.target.value)}
+        placeholder="Search memories..."
+      />
+      <button type="submit" disabled={loading}>
+        {loading ? 'Searching...' : 'Search'}
+      </button>
+
+      {error && <div className="error">{error.message}</div>}
+
+      {data && (
+        <div className="results">
+          <p>Found {data.count} results</p>
+          <ul>
+            {data.results.map((result) => (
+              <li key={result.umo_id}>
+                <h3>{result.summary}</h3>
+                <p>Score: {result.score.toFixed(3)}</p>
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </form>
+  );
+}
+```
+
+### Capture Form
+
+```tsx
+import { useState } from 'react';
+import { useMemoryProcess } from '@memoryintelligence/react';
+
+function CaptureForm() {
+  const [content, setContent] = useState('');
+  const { process, data, loading, error, reset } = useMemoryProcess();
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await process(content, { source: 'web_form' });
+    setContent(''); // Clear on success
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <textarea
+        value={content}
+        onChange={(e) => setContent(e.target.value)}
+        placeholder="Enter your memory..."
+        rows={6}
+      />
+      <button type="submit" disabled={loading || !content}>
+        {loading ? 'Processing...' : 'Capture Memory'}
+      </button>
+
+      {error && <div className="error">{error.message}</div>}
+      {data && <div className="success">Created: {data.umo_id}</div>}
+    </form>
+  );
+}
+```
+
+### Compute Progress
+
+```tsx
+import { useComputeProgress } from '@memoryintelligence/react';
+
+function AnalysisProgress({ narrativeUlid }) {
+  const { progress, result, isComplete, error } = useComputeProgress(
+    'analyze_decision_process',
+    { narrative_ulid: narrativeUlid }
+  );
+
+  if (error) return <div>Error: {error.message}</div>;
+
+  if (isComplete && result) {
+    return (
+      <div className="complete">
+        <h3>Analysis Complete</h3>
+        <p>Execution time: {result.executionTimeMs}ms</p>
+        <pre>{JSON.stringify(result.result, null, 2)}</pre>
+      </div>
+    );
+  }
+
+  return (
+    <div className="progress">
+      <h3>Analyzing...</h3>
+      {progress && (
+        <>
+          <progress value={progress.progressPercent} max={100} />
+          <p>{progress.progressPercent}%: {progress.message}</p>
+        </>
+      )}
+    </div>
+  );
+}
+```
+
+## TypeScript Support
+
+Fully typed with TypeScript. All hooks include proper type inference:
+
+```tsx
+import type { SearchResponse, MeaningObject } from '@memoryintelligence/react';
+
+const { data } = useMemorySearch(); // data: SearchResponse | null
+const { data: umo } = useMemoryProcess(); // umo: MeaningObject | null
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,225 @@
+'use strict';
+
+var react = require('react');
+var sdk = require('@memoryintelligence/sdk');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/MemoryClientProvider.tsx
+var MemoryClientContext = react.createContext({
+  client: null,
+  isReady: false
+});
+function MemoryClientProvider({ config, children }) {
+  const [client, setClient] = react.useState(null);
+  const [isReady, setIsReady] = react.useState(false);
+  react.useEffect(() => {
+    const newClient = new sdk.MemoryClient(config);
+    setClient(newClient);
+    setIsReady(true);
+    return () => {
+      if ("disconnect" in newClient && typeof newClient.disconnect === "function") {
+        newClient.disconnect();
+      }
+    };
+  }, [config.apiKey, config.baseUrl, config.wsUrl, config.userUlid, config.orgUlid]);
+  return /* @__PURE__ */ jsxRuntime.jsx(MemoryClientContext.Provider, { value: { client, isReady }, children });
+}
+function useMemoryClient() {
+  const { client, isReady } = react.useContext(MemoryClientContext);
+  if (!isReady || !client) {
+    throw new Error("useMemoryClient must be used within MemoryClientProvider");
+  }
+  return client;
+}
+function useDriftSubscription(options, maxUpdates = 50) {
+  const client = useMemoryClient();
+  const [updates, setUpdates] = react.useState([]);
+  const [latestUpdate, setLatestUpdate] = react.useState(null);
+  const [connected, setConnected] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const subscriptionRef = react.useRef(null);
+  const clearUpdates = react.useCallback(() => {
+    setUpdates([]);
+    setLatestUpdate(null);
+  }, []);
+  react.useEffect(() => {
+    const subscription = client.drift.watch(options);
+    subscriptionRef.current = subscription;
+    subscription.on("connected", () => {
+      setConnected(true);
+      setError(null);
+    });
+    subscription.on("disconnected", () => {
+      setConnected(false);
+    });
+    subscription.on("update", (update) => {
+      setLatestUpdate(update);
+      setUpdates((prev) => [update, ...prev].slice(0, maxUpdates));
+    });
+    subscription.on("error", (err) => {
+      setError(err);
+      setConnected(false);
+    });
+    subscription.start().catch((err) => {
+      setError(err);
+    });
+    return () => {
+      subscription.stop();
+    };
+  }, [
+    client,
+    maxUpdates,
+    JSON.stringify(options.entityUlids),
+    options.orgUlid
+  ]);
+  return {
+    updates,
+    latestUpdate,
+    connected,
+    error,
+    clearUpdates
+  };
+}
+function useComputeProgress(functionName, parameters, enabled = true) {
+  const client = useMemoryClient();
+  const [progress, setProgress] = react.useState(null);
+  const [result, setResult] = react.useState(null);
+  const [connected, setConnected] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [isComplete, setIsComplete] = react.useState(false);
+  const subscriptionRef = react.useRef(null);
+  const reset = react.useCallback(() => {
+    setProgress(null);
+    setResult(null);
+    setError(null);
+    setIsComplete(false);
+  }, []);
+  react.useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    reset();
+    const subscription = client.compute.watch(functionName, parameters);
+    subscriptionRef.current = subscription;
+    subscription.on("connected", () => {
+      setConnected(true);
+      setError(null);
+    });
+    subscription.on("disconnected", () => {
+      setConnected(false);
+    });
+    subscription.on("progress", (progressUpdate) => {
+      setProgress(progressUpdate);
+    });
+    subscription.on("result", (resultData) => {
+      setResult(resultData);
+      setIsComplete(true);
+      setConnected(false);
+    });
+    subscription.on("error", (err) => {
+      setError(err);
+      setConnected(false);
+    });
+    subscription.start().catch((err) => {
+      setError(err);
+    });
+    return () => {
+      subscription.stop();
+    };
+  }, [
+    client,
+    functionName,
+    JSON.stringify(parameters),
+    enabled,
+    reset
+  ]);
+  return {
+    progress,
+    result,
+    connected,
+    error,
+    isComplete,
+    reset
+  };
+}
+function useMemorySearch() {
+  const client = useMemoryClient();
+  const [data, setData] = react.useState(null);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const search = react.useCallback(
+    async (query, options) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await client.umo.search(query, options);
+        setData(response);
+        return response;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Search failed");
+        setError(error2);
+        throw error2;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  const reset = react.useCallback(() => {
+    setData(null);
+    setError(null);
+    setLoading(false);
+  }, []);
+  return {
+    search,
+    data,
+    loading,
+    error,
+    reset
+  };
+}
+function useMemoryProcess() {
+  const client = useMemoryClient();
+  const [data, setData] = react.useState(null);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const process = react.useCallback(
+    async (content, options) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const umo = await client.umo.process(content, options);
+        setData(umo);
+        return umo;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Process failed");
+        setError(error2);
+        throw error2;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  const reset = react.useCallback(() => {
+    setData(null);
+    setError(null);
+    setLoading(false);
+  }, []);
+  return {
+    process,
+    data,
+    loading,
+    error,
+    reset
+  };
+}
+
+exports.MemoryClientProvider = MemoryClientProvider;
+exports.useComputeProgress = useComputeProgress;
+exports.useDriftSubscription = useDriftSubscription;
+exports.useMemoryClient = useMemoryClient;
+exports.useMemoryProcess = useMemoryProcess;
+exports.useMemorySearch = useMemorySearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/MemoryClientProvider.tsx","../src/useDriftSubscription.ts","../src/useComputeProgress.ts","../src/useMemorySearch.ts","../src/useMemoryProcess.ts"],"names":["createContext","useState","useEffect","MemoryClient","jsx","useContext","useRef","useCallback","error"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * React context provider for Memory Intelligence client.\n */\n\nimport React, { createContext, useContext, useEffect, useState } from 'react';\nimport { MemoryClient, type MemoryClientConfig } from '@memoryintelligence/sdk';\n\nexport interface MemoryClientContextValue {\n  client: MemoryClient | null;\n  isReady: boolean;\n}\n\nconst MemoryClientContext = createContext<MemoryClientContextValue>({\n  client: null,\n  isReady: false,\n});\n\nexport interface MemoryClientProviderProps {\n  config: MemoryClientConfig;\n  children: React.ReactNode;\n}\n\n/**\n * Provider component for Memory Intelligence client.\n * \n * @example\n * ```tsx\n * <MemoryClientProvider config={{ apiKey: process.env.MI_API_KEY }}>\n *   <App />\n * </MemoryClientProvider>\n * ```\n */\nexport function MemoryClientProvider({ config, children }: MemoryClientProviderProps) {\n  const [client, setClient] = useState<MemoryClient | null>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    const newClient = new MemoryClient(config);\n    setClient(newClient);\n    setIsReady(true);\n\n    return () => {\n      // Cleanup WebSocket connections if client has disconnect method\n      if ('disconnect' in newClient && typeof newClient.disconnect === 'function') {\n        newClient.disconnect();\n      }\n    };\n  }, [config.apiKey, config.baseUrl, config.wsUrl, config.userUlid, config.orgUlid]);\n\n  return (\n    <MemoryClientContext.Provider value={{ client, isReady }}>\n      {children}\n    </MemoryClientContext.Provider>\n  );\n}\n\n/**\n * Hook to access the Memory Intelligence client from context.\n * \n * @throws Error if used outside MemoryClientProvider\n */\nexport function useMemoryClient(): MemoryClient {\n  const { client, isReady } = useContext(MemoryClientContext);\n\n  if (!isReady || !client) {\n    throw new Error('useMemoryClient must be used within MemoryClientProvider');\n  }\n\n  return client;\n}\n","/**\n * React hook for drift subscriptions.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { DriftSubscription, DriftUpdate, DriftSubscriptionOptions } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseDriftSubscriptionResult {\n  updates: DriftUpdate[];\n  latestUpdate: DriftUpdate | null;\n  connected: boolean;\n  error: Error | null;\n  clearUpdates: () => void;\n}\n\n/**\n * Hook for subscribing to drift updates.\n * \n * @param options - Subscription options\n * @param maxUpdates - Maximum number of updates to keep (default: 50)\n * @returns Drift subscription state\n * \n * @example\n * ```tsx\n * function DriftMonitor({ entityUlid }) {\n *   const { updates, connected, error } = useDriftSubscription({\n *     entityUlids: [entityUlid]\n *   });\n * \n *   if (error) return <div>Error: {error.message}</div>;\n * \n *   return (\n *     <div>\n *       <p>Status: {connected ? 'Connected' : 'Disconnected'}</p>\n *       {updates.map((update, i) => (\n *         <div key={i}>{update.canonicalName} - Epoch {update.driftEpoch}</div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDriftSubscription(\n  options: DriftSubscriptionOptions,\n  maxUpdates: number = 50\n): UseDriftSubscriptionResult {\n  const client = useMemoryClient();\n  const [updates, setUpdates] = useState<DriftUpdate[]>([]);\n  const [latestUpdate, setLatestUpdate] = useState<DriftUpdate | null>(null);\n  const [connected, setConnected] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const subscriptionRef = useRef<DriftSubscription | null>(null);\n\n  const clearUpdates = useCallback(() => {\n    setUpdates([]);\n    setLatestUpdate(null);\n  }, []);\n\n  useEffect(() => {\n    const subscription = client.drift.watch(options);\n    subscriptionRef.current = subscription;\n\n    subscription.on('connected', () => {\n      setConnected(true);\n      setError(null);\n    });\n\n    subscription.on('disconnected', () => {\n      setConnected(false);\n    });\n\n    subscription.on('update', (update) => {\n      setLatestUpdate(update);\n      setUpdates((prev) => [update, ...prev].slice(0, maxUpdates));\n    });\n\n    subscription.on('error', (err: any) => {\n      setError(err);\n      setConnected(false);\n    });\n\n    subscription.start().catch((err) => {\n      setError(err);\n    });\n\n    return () => {\n      subscription.stop();\n    };\n  }, [\n    client,\n    maxUpdates,\n    JSON.stringify(options.entityUlids),\n    options.orgUlid,\n  ]);\n\n  return {\n    updates,\n    latestUpdate,\n    connected,\n    error,\n    clearUpdates,\n  };\n}\n","/**\n * React hook for compute operation progress tracking.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { ComputeSubscription, ComputeProgress, ComputeResult } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseComputeProgressResult<T = any> {\n  progress: ComputeProgress | null;\n  result: ComputeResult<T> | null;\n  connected: boolean;\n  error: Error | null;\n  isComplete: boolean;\n  reset: () => void;\n}\n\n/**\n * Hook for tracking compute operation progress.\n * \n * @param functionName - Name of compute function\n * @param parameters - Function parameters\n * @param enabled - Whether to start the subscription (default: true)\n * @returns Compute progress state\n * \n * @example\n * ```tsx\n * function AnalysisProgress({ narrativeUlid }) {\n *   const { progress, result, isComplete, error } = useComputeProgress(\n *     'analyze_decision_process',\n *     { narrative_ulid: narrativeUlid }\n *   );\n * \n *   if (error) return <div>Error: {error.message}</div>;\n *   if (isComplete && result) {\n *     return <div>Analysis complete: {JSON.stringify(result.result)}</div>;\n *   }\n * \n *   return (\n *     <div>\n *       {progress && (\n *         <div>\n *           <progress value={progress.progressPercent} max={100} />\n *           <p>{progress.message}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useComputeProgress<T = any>(\n  functionName: string,\n  parameters: Record<string, any>,\n  enabled: boolean = true\n): UseComputeProgressResult<T> {\n  const client = useMemoryClient();\n  const [progress, setProgress] = useState<ComputeProgress | null>(null);\n  const [result, setResult] = useState<ComputeResult<T> | null>(null);\n  const [connected, setConnected] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [isComplete, setIsComplete] = useState(false);\n  const subscriptionRef = useRef<ComputeSubscription<T> | null>(null);\n\n  const reset = useCallback(() => {\n    setProgress(null);\n    setResult(null);\n    setError(null);\n    setIsComplete(false);\n  }, []);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    reset();\n\n    const subscription = client.compute.watch<T>(functionName, parameters);\n    subscriptionRef.current = subscription;\n\n    subscription.on('connected', () => {\n      setConnected(true);\n      setError(null);\n    });\n\n    subscription.on('disconnected', () => {\n      setConnected(false);\n    });\n\n    subscription.on('progress', (progressUpdate) => {\n      setProgress(progressUpdate as ComputeProgress);\n    });\n\n    subscription.on('result', (resultData) => {\n      setResult(resultData as ComputeResult<T>);\n      setIsComplete(true);\n      setConnected(false); // Auto-unsubscribes after result\n    });\n\n    subscription.on('error', (err: any) => {\n      setError(err);\n      setConnected(false);\n    });\n\n    subscription.start().catch((err) => {\n      setError(err);\n    });\n\n    return () => {\n      subscription.stop();\n    };\n  }, [\n    client,\n    functionName,\n    JSON.stringify(parameters),\n    enabled,\n    reset,\n  ]);\n\n  return {\n    progress,\n    result,\n    connected,\n    error,\n    isComplete,\n    reset,\n  };\n}\n","/**\n * React hook for memory search.\n */\n\nimport { useState, useCallback } from 'react';\nimport type { SearchResponse, Scope, ExplainLevel } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseMemorySearchOptions {\n  userUlid?: string;\n  limit?: number;\n  scope?: Scope;\n  scopeId?: string;\n  explain?: ExplainLevel;\n}\n\nexport interface UseMemorySearchResult {\n  search: (query: string, options?: UseMemorySearchOptions) => Promise<SearchResponse>;\n  data: SearchResponse | null;\n  loading: boolean;\n  error: Error | null;\n  reset: () => void;\n}\n\n/**\n * Hook for memory search operations.\n * \n * @returns Search function and state\n * \n * @example\n * ```tsx\n * function SearchBox() {\n *   const { search, data, loading, error } = useMemorySearch();\n *   const [query, setQuery] = useState('');\n * \n *   const handleSearch = async () => {\n *     await search(query, { limit: 10 });\n *   };\n * \n *   return (\n *     <div>\n *       <input value={query} onChange={(e) => setQuery(e.target.value)} />\n *       <button onClick={handleSearch} disabled={loading}>Search</button>\n *       {loading && <p>Searching...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && (\n *         <ul>\n *           {data.results.map((result) => (\n *             <li key={result.umo_id}>{result.summary}</li>\n *           ))}\n *         </ul>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemorySearch(): UseMemorySearchResult {\n  const client = useMemoryClient();\n  const [data, setData] = useState<SearchResponse | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const search = useCallback(\n    async (query: string, options?: UseMemorySearchOptions): Promise<SearchResponse> => {\n      setLoading(true);\n      setError(null);\n\n      try {\n        const response = await client.umo.search(query, options);\n        setData(response);\n        return response;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Search failed');\n        setError(error);\n        throw error;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setError(null);\n    setLoading(false);\n  }, []);\n\n  return {\n    search,\n    data,\n    loading,\n    error,\n    reset,\n  };\n}\n","/**\n * React hook for processing content into memories.\n */\n\nimport { useState, useCallback } from 'react';\nimport type {\n  MeaningObject,\n  RetentionPolicy,\n  PIIHandling,\n  ProvenanceMode,\n  Scope,\n} from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface ProcessOptions {\n  userUlid?: string;\n  retentionPolicy?: RetentionPolicy;\n  piiHandling?: PIIHandling;\n  provenanceMode?: ProvenanceMode;\n  scope?: Scope;\n  scopeId?: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UseMemoryProcessResult {\n  process: (content: string, options?: ProcessOptions) => Promise<MeaningObject>;\n  data: MeaningObject | null;\n  loading: boolean;\n  error: Error | null;\n  reset: () => void;\n}\n\n/**\n * Hook for processing content into Meaning Objects.\n * \n * @returns Process function and state\n * \n * @example\n * ```tsx\n * function CaptureForm() {\n *   const { process, data, loading, error } = useMemoryProcess();\n *   const [content, setContent] = useState('');\n * \n *   const handleSubmit = async () => {\n *     await process(content, { source: 'web_form' });\n *     setContent(''); // Clear after success\n *   };\n * \n *   return (\n *     <div>\n *       <textarea value={content} onChange={(e) => setContent(e.target.value)} />\n *       <button onClick={handleSubmit} disabled={loading}>Capture</button>\n *       {loading && <p>Processing...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && <p>Created: {data.umo_id}</p>}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemoryProcess(): UseMemoryProcessResult {\n  const client = useMemoryClient();\n  const [data, setData] = useState<MeaningObject | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const process = useCallback(\n    async (content: string, options?: ProcessOptions): Promise<MeaningObject> => {\n      setLoading(true);\n      setError(null);\n\n      try {\n        const umo = await client.umo.process(content, options);\n        setData(umo);\n        return umo;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Process failed');\n        setError(error);\n        throw error;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setError(null);\n    setLoading(false);\n  }, []);\n\n  return {\n    process,\n    data,\n    loading,\n    error,\n    reset,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,224 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { MemoryClient, MemoryClientConfig, DriftUpdate, DriftSubscriptionOptions, ComputeProgress, ComputeResult, Scope, ExplainLevel, SearchResponse, RetentionPolicy, PIIHandling, ProvenanceMode, MeaningObject } from '@memoryintelligence/sdk';
+export { ComputeProgress, ComputeResult, DriftSubscriptionOptions, DriftUpdate, ExplainLevel, MeaningObject, PIIHandling, ProvenanceMode, RetentionPolicy, Scope, SearchResponse, SearchResult } from '@memoryintelligence/sdk';
+
+interface MemoryClientContextValue {
+    client: MemoryClient | null;
+    isReady: boolean;
+}
+interface MemoryClientProviderProps {
+    config: MemoryClientConfig;
+    children: React.ReactNode;
+}
+/**
+ * Provider component for Memory Intelligence client.
+ *
+ * @example
+ * ```tsx
+ * <MemoryClientProvider config={{ apiKey: process.env.MI_API_KEY }}>
+ *   <App />
+ * </MemoryClientProvider>
+ * ```
+ */
+declare function MemoryClientProvider({ config, children }: MemoryClientProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the Memory Intelligence client from context.
+ *
+ * @throws Error if used outside MemoryClientProvider
+ */
+declare function useMemoryClient(): MemoryClient;
+
+/**
+ * React hook for drift subscriptions.
+ */
+
+interface UseDriftSubscriptionResult {
+    updates: DriftUpdate[];
+    latestUpdate: DriftUpdate | null;
+    connected: boolean;
+    error: Error | null;
+    clearUpdates: () => void;
+}
+/**
+ * Hook for subscribing to drift updates.
+ *
+ * @param options - Subscription options
+ * @param maxUpdates - Maximum number of updates to keep (default: 50)
+ * @returns Drift subscription state
+ *
+ * @example
+ * ```tsx
+ * function DriftMonitor({ entityUlid }) {
+ *   const { updates, connected, error } = useDriftSubscription({
+ *     entityUlids: [entityUlid]
+ *   });
+ *
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <p>Status: {connected ? 'Connected' : 'Disconnected'}</p>
+ *       {updates.map((update, i) => (
+ *         <div key={i}>{update.canonicalName} - Epoch {update.driftEpoch}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useDriftSubscription(options: DriftSubscriptionOptions, maxUpdates?: number): UseDriftSubscriptionResult;
+
+/**
+ * React hook for compute operation progress tracking.
+ */
+
+interface UseComputeProgressResult<T = any> {
+    progress: ComputeProgress | null;
+    result: ComputeResult<T> | null;
+    connected: boolean;
+    error: Error | null;
+    isComplete: boolean;
+    reset: () => void;
+}
+/**
+ * Hook for tracking compute operation progress.
+ *
+ * @param functionName - Name of compute function
+ * @param parameters - Function parameters
+ * @param enabled - Whether to start the subscription (default: true)
+ * @returns Compute progress state
+ *
+ * @example
+ * ```tsx
+ * function AnalysisProgress({ narrativeUlid }) {
+ *   const { progress, result, isComplete, error } = useComputeProgress(
+ *     'analyze_decision_process',
+ *     { narrative_ulid: narrativeUlid }
+ *   );
+ *
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isComplete && result) {
+ *     return <div>Analysis complete: {JSON.stringify(result.result)}</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       {progress && (
+ *         <div>
+ *           <progress value={progress.progressPercent} max={100} />
+ *           <p>{progress.message}</p>
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useComputeProgress<T = any>(functionName: string, parameters: Record<string, any>, enabled?: boolean): UseComputeProgressResult<T>;
+
+/**
+ * React hook for memory search.
+ */
+
+interface UseMemorySearchOptions {
+    userUlid?: string;
+    limit?: number;
+    scope?: Scope;
+    scopeId?: string;
+    explain?: ExplainLevel;
+}
+interface UseMemorySearchResult {
+    search: (query: string, options?: UseMemorySearchOptions) => Promise<SearchResponse>;
+    data: SearchResponse | null;
+    loading: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook for memory search operations.
+ *
+ * @returns Search function and state
+ *
+ * @example
+ * ```tsx
+ * function SearchBox() {
+ *   const { search, data, loading, error } = useMemorySearch();
+ *   const [query, setQuery] = useState('');
+ *
+ *   const handleSearch = async () => {
+ *     await search(query, { limit: 10 });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input value={query} onChange={(e) => setQuery(e.target.value)} />
+ *       <button onClick={handleSearch} disabled={loading}>Search</button>
+ *       {loading && <p>Searching...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {data && (
+ *         <ul>
+ *           {data.results.map((result) => (
+ *             <li key={result.umo_id}>{result.summary}</li>
+ *           ))}
+ *         </ul>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemorySearch(): UseMemorySearchResult;
+
+/**
+ * React hook for processing content into memories.
+ */
+
+interface ProcessOptions {
+    userUlid?: string;
+    retentionPolicy?: RetentionPolicy;
+    piiHandling?: PIIHandling;
+    provenanceMode?: ProvenanceMode;
+    scope?: Scope;
+    scopeId?: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UseMemoryProcessResult {
+    process: (content: string, options?: ProcessOptions) => Promise<MeaningObject>;
+    data: MeaningObject | null;
+    loading: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook for processing content into Meaning Objects.
+ *
+ * @returns Process function and state
+ *
+ * @example
+ * ```tsx
+ * function CaptureForm() {
+ *   const { process, data, loading, error } = useMemoryProcess();
+ *   const [content, setContent] = useState('');
+ *
+ *   const handleSubmit = async () => {
+ *     await process(content, { source: 'web_form' });
+ *     setContent(''); // Clear after success
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <textarea value={content} onChange={(e) => setContent(e.target.value)} />
+ *       <button onClick={handleSubmit} disabled={loading}>Capture</button>
+ *       {loading && <p>Processing...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {data && <p>Created: {data.umo_id}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemoryProcess(): UseMemoryProcessResult;
+
+export { type MemoryClientContextValue, MemoryClientProvider, type MemoryClientProviderProps, type ProcessOptions, type UseComputeProgressResult, type UseDriftSubscriptionResult, type UseMemoryProcessResult, type UseMemorySearchOptions, type UseMemorySearchResult, useComputeProgress, useDriftSubscription, useMemoryClient, useMemoryProcess, useMemorySearch };

package/dist/index.d.ts

@@ -0,0 +1,224 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { MemoryClient, MemoryClientConfig, DriftUpdate, DriftSubscriptionOptions, ComputeProgress, ComputeResult, Scope, ExplainLevel, SearchResponse, RetentionPolicy, PIIHandling, ProvenanceMode, MeaningObject } from '@memoryintelligence/sdk';
+export { ComputeProgress, ComputeResult, DriftSubscriptionOptions, DriftUpdate, ExplainLevel, MeaningObject, PIIHandling, ProvenanceMode, RetentionPolicy, Scope, SearchResponse, SearchResult } from '@memoryintelligence/sdk';
+
+interface MemoryClientContextValue {
+    client: MemoryClient | null;
+    isReady: boolean;
+}
+interface MemoryClientProviderProps {
+    config: MemoryClientConfig;
+    children: React.ReactNode;
+}
+/**
+ * Provider component for Memory Intelligence client.
+ *
+ * @example
+ * ```tsx
+ * <MemoryClientProvider config={{ apiKey: process.env.MI_API_KEY }}>
+ *   <App />
+ * </MemoryClientProvider>
+ * ```
+ */
+declare function MemoryClientProvider({ config, children }: MemoryClientProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the Memory Intelligence client from context.
+ *
+ * @throws Error if used outside MemoryClientProvider
+ */
+declare function useMemoryClient(): MemoryClient;
+
+/**
+ * React hook for drift subscriptions.
+ */
+
+interface UseDriftSubscriptionResult {
+    updates: DriftUpdate[];
+    latestUpdate: DriftUpdate | null;
+    connected: boolean;
+    error: Error | null;
+    clearUpdates: () => void;
+}
+/**
+ * Hook for subscribing to drift updates.
+ *
+ * @param options - Subscription options
+ * @param maxUpdates - Maximum number of updates to keep (default: 50)
+ * @returns Drift subscription state
+ *
+ * @example
+ * ```tsx
+ * function DriftMonitor({ entityUlid }) {
+ *   const { updates, connected, error } = useDriftSubscription({
+ *     entityUlids: [entityUlid]
+ *   });
+ *
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <p>Status: {connected ? 'Connected' : 'Disconnected'}</p>
+ *       {updates.map((update, i) => (
+ *         <div key={i}>{update.canonicalName} - Epoch {update.driftEpoch}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useDriftSubscription(options: DriftSubscriptionOptions, maxUpdates?: number): UseDriftSubscriptionResult;
+
+/**
+ * React hook for compute operation progress tracking.
+ */
+
+interface UseComputeProgressResult<T = any> {
+    progress: ComputeProgress | null;
+    result: ComputeResult<T> | null;
+    connected: boolean;
+    error: Error | null;
+    isComplete: boolean;
+    reset: () => void;
+}
+/**
+ * Hook for tracking compute operation progress.
+ *
+ * @param functionName - Name of compute function
+ * @param parameters - Function parameters
+ * @param enabled - Whether to start the subscription (default: true)
+ * @returns Compute progress state
+ *
+ * @example
+ * ```tsx
+ * function AnalysisProgress({ narrativeUlid }) {
+ *   const { progress, result, isComplete, error } = useComputeProgress(
+ *     'analyze_decision_process',
+ *     { narrative_ulid: narrativeUlid }
+ *   );
+ *
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isComplete && result) {
+ *     return <div>Analysis complete: {JSON.stringify(result.result)}</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       {progress && (
+ *         <div>
+ *           <progress value={progress.progressPercent} max={100} />
+ *           <p>{progress.message}</p>
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useComputeProgress<T = any>(functionName: string, parameters: Record<string, any>, enabled?: boolean): UseComputeProgressResult<T>;
+
+/**
+ * React hook for memory search.
+ */
+
+interface UseMemorySearchOptions {
+    userUlid?: string;
+    limit?: number;
+    scope?: Scope;
+    scopeId?: string;
+    explain?: ExplainLevel;
+}
+interface UseMemorySearchResult {
+    search: (query: string, options?: UseMemorySearchOptions) => Promise<SearchResponse>;
+    data: SearchResponse | null;
+    loading: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook for memory search operations.
+ *
+ * @returns Search function and state
+ *
+ * @example
+ * ```tsx
+ * function SearchBox() {
+ *   const { search, data, loading, error } = useMemorySearch();
+ *   const [query, setQuery] = useState('');
+ *
+ *   const handleSearch = async () => {
+ *     await search(query, { limit: 10 });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input value={query} onChange={(e) => setQuery(e.target.value)} />
+ *       <button onClick={handleSearch} disabled={loading}>Search</button>
+ *       {loading && <p>Searching...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {data && (
+ *         <ul>
+ *           {data.results.map((result) => (
+ *             <li key={result.umo_id}>{result.summary}</li>
+ *           ))}
+ *         </ul>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemorySearch(): UseMemorySearchResult;
+
+/**
+ * React hook for processing content into memories.
+ */
+
+interface ProcessOptions {
+    userUlid?: string;
+    retentionPolicy?: RetentionPolicy;
+    piiHandling?: PIIHandling;
+    provenanceMode?: ProvenanceMode;
+    scope?: Scope;
+    scopeId?: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UseMemoryProcessResult {
+    process: (content: string, options?: ProcessOptions) => Promise<MeaningObject>;
+    data: MeaningObject | null;
+    loading: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * Hook for processing content into Meaning Objects.
+ *
+ * @returns Process function and state
+ *
+ * @example
+ * ```tsx
+ * function CaptureForm() {
+ *   const { process, data, loading, error } = useMemoryProcess();
+ *   const [content, setContent] = useState('');
+ *
+ *   const handleSubmit = async () => {
+ *     await process(content, { source: 'web_form' });
+ *     setContent(''); // Clear after success
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <textarea value={content} onChange={(e) => setContent(e.target.value)} />
+ *       <button onClick={handleSubmit} disabled={loading}>Capture</button>
+ *       {loading && <p>Processing...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {data && <p>Created: {data.umo_id}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMemoryProcess(): UseMemoryProcessResult;
+
+export { type MemoryClientContextValue, MemoryClientProvider, type MemoryClientProviderProps, type ProcessOptions, type UseComputeProgressResult, type UseDriftSubscriptionResult, type UseMemoryProcessResult, type UseMemorySearchOptions, type UseMemorySearchResult, useComputeProgress, useDriftSubscription, useMemoryClient, useMemoryProcess, useMemorySearch };

package/dist/index.js

@@ -0,0 +1,218 @@
+import { createContext, useState, useEffect, useContext, useRef, useCallback } from 'react';
+import { MemoryClient } from '@memoryintelligence/sdk';
+import { jsx } from 'react/jsx-runtime';
+
+// src/MemoryClientProvider.tsx
+var MemoryClientContext = createContext({
+  client: null,
+  isReady: false
+});
+function MemoryClientProvider({ config, children }) {
+  const [client, setClient] = useState(null);
+  const [isReady, setIsReady] = useState(false);
+  useEffect(() => {
+    const newClient = new MemoryClient(config);
+    setClient(newClient);
+    setIsReady(true);
+    return () => {
+      if ("disconnect" in newClient && typeof newClient.disconnect === "function") {
+        newClient.disconnect();
+      }
+    };
+  }, [config.apiKey, config.baseUrl, config.wsUrl, config.userUlid, config.orgUlid]);
+  return /* @__PURE__ */ jsx(MemoryClientContext.Provider, { value: { client, isReady }, children });
+}
+function useMemoryClient() {
+  const { client, isReady } = useContext(MemoryClientContext);
+  if (!isReady || !client) {
+    throw new Error("useMemoryClient must be used within MemoryClientProvider");
+  }
+  return client;
+}
+function useDriftSubscription(options, maxUpdates = 50) {
+  const client = useMemoryClient();
+  const [updates, setUpdates] = useState([]);
+  const [latestUpdate, setLatestUpdate] = useState(null);
+  const [connected, setConnected] = useState(false);
+  const [error, setError] = useState(null);
+  const subscriptionRef = useRef(null);
+  const clearUpdates = useCallback(() => {
+    setUpdates([]);
+    setLatestUpdate(null);
+  }, []);
+  useEffect(() => {
+    const subscription = client.drift.watch(options);
+    subscriptionRef.current = subscription;
+    subscription.on("connected", () => {
+      setConnected(true);
+      setError(null);
+    });
+    subscription.on("disconnected", () => {
+      setConnected(false);
+    });
+    subscription.on("update", (update) => {
+      setLatestUpdate(update);
+      setUpdates((prev) => [update, ...prev].slice(0, maxUpdates));
+    });
+    subscription.on("error", (err) => {
+      setError(err);
+      setConnected(false);
+    });
+    subscription.start().catch((err) => {
+      setError(err);
+    });
+    return () => {
+      subscription.stop();
+    };
+  }, [
+    client,
+    maxUpdates,
+    JSON.stringify(options.entityUlids),
+    options.orgUlid
+  ]);
+  return {
+    updates,
+    latestUpdate,
+    connected,
+    error,
+    clearUpdates
+  };
+}
+function useComputeProgress(functionName, parameters, enabled = true) {
+  const client = useMemoryClient();
+  const [progress, setProgress] = useState(null);
+  const [result, setResult] = useState(null);
+  const [connected, setConnected] = useState(false);
+  const [error, setError] = useState(null);
+  const [isComplete, setIsComplete] = useState(false);
+  const subscriptionRef = useRef(null);
+  const reset = useCallback(() => {
+    setProgress(null);
+    setResult(null);
+    setError(null);
+    setIsComplete(false);
+  }, []);
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    reset();
+    const subscription = client.compute.watch(functionName, parameters);
+    subscriptionRef.current = subscription;
+    subscription.on("connected", () => {
+      setConnected(true);
+      setError(null);
+    });
+    subscription.on("disconnected", () => {
+      setConnected(false);
+    });
+    subscription.on("progress", (progressUpdate) => {
+      setProgress(progressUpdate);
+    });
+    subscription.on("result", (resultData) => {
+      setResult(resultData);
+      setIsComplete(true);
+      setConnected(false);
+    });
+    subscription.on("error", (err) => {
+      setError(err);
+      setConnected(false);
+    });
+    subscription.start().catch((err) => {
+      setError(err);
+    });
+    return () => {
+      subscription.stop();
+    };
+  }, [
+    client,
+    functionName,
+    JSON.stringify(parameters),
+    enabled,
+    reset
+  ]);
+  return {
+    progress,
+    result,
+    connected,
+    error,
+    isComplete,
+    reset
+  };
+}
+function useMemorySearch() {
+  const client = useMemoryClient();
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const search = useCallback(
+    async (query, options) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await client.umo.search(query, options);
+        setData(response);
+        return response;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Search failed");
+        setError(error2);
+        throw error2;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  const reset = useCallback(() => {
+    setData(null);
+    setError(null);
+    setLoading(false);
+  }, []);
+  return {
+    search,
+    data,
+    loading,
+    error,
+    reset
+  };
+}
+function useMemoryProcess() {
+  const client = useMemoryClient();
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const process = useCallback(
+    async (content, options) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const umo = await client.umo.process(content, options);
+        setData(umo);
+        return umo;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Process failed");
+        setError(error2);
+        throw error2;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  const reset = useCallback(() => {
+    setData(null);
+    setError(null);
+    setLoading(false);
+  }, []);
+  return {
+    process,
+    data,
+    loading,
+    error,
+    reset
+  };
+}
+
+export { MemoryClientProvider, useComputeProgress, useDriftSubscription, useMemoryClient, useMemoryProcess, useMemorySearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/MemoryClientProvider.tsx","../src/useDriftSubscription.ts","../src/useComputeProgress.ts","../src/useMemorySearch.ts","../src/useMemoryProcess.ts"],"names":["useState","useEffect","useRef","useCallback","error"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * React context provider for Memory Intelligence client.\n */\n\nimport React, { createContext, useContext, useEffect, useState } from 'react';\nimport { MemoryClient, type MemoryClientConfig } from '@memoryintelligence/sdk';\n\nexport interface MemoryClientContextValue {\n  client: MemoryClient | null;\n  isReady: boolean;\n}\n\nconst MemoryClientContext = createContext<MemoryClientContextValue>({\n  client: null,\n  isReady: false,\n});\n\nexport interface MemoryClientProviderProps {\n  config: MemoryClientConfig;\n  children: React.ReactNode;\n}\n\n/**\n * Provider component for Memory Intelligence client.\n * \n * @example\n * ```tsx\n * <MemoryClientProvider config={{ apiKey: process.env.MI_API_KEY }}>\n *   <App />\n * </MemoryClientProvider>\n * ```\n */\nexport function MemoryClientProvider({ config, children }: MemoryClientProviderProps) {\n  const [client, setClient] = useState<MemoryClient | null>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    const newClient = new MemoryClient(config);\n    setClient(newClient);\n    setIsReady(true);\n\n    return () => {\n      // Cleanup WebSocket connections if client has disconnect method\n      if ('disconnect' in newClient && typeof newClient.disconnect === 'function') {\n        newClient.disconnect();\n      }\n    };\n  }, [config.apiKey, config.baseUrl, config.wsUrl, config.userUlid, config.orgUlid]);\n\n  return (\n    <MemoryClientContext.Provider value={{ client, isReady }}>\n      {children}\n    </MemoryClientContext.Provider>\n  );\n}\n\n/**\n * Hook to access the Memory Intelligence client from context.\n * \n * @throws Error if used outside MemoryClientProvider\n */\nexport function useMemoryClient(): MemoryClient {\n  const { client, isReady } = useContext(MemoryClientContext);\n\n  if (!isReady || !client) {\n    throw new Error('useMemoryClient must be used within MemoryClientProvider');\n  }\n\n  return client;\n}\n","/**\n * React hook for drift subscriptions.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { DriftSubscription, DriftUpdate, DriftSubscriptionOptions } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseDriftSubscriptionResult {\n  updates: DriftUpdate[];\n  latestUpdate: DriftUpdate | null;\n  connected: boolean;\n  error: Error | null;\n  clearUpdates: () => void;\n}\n\n/**\n * Hook for subscribing to drift updates.\n * \n * @param options - Subscription options\n * @param maxUpdates - Maximum number of updates to keep (default: 50)\n * @returns Drift subscription state\n * \n * @example\n * ```tsx\n * function DriftMonitor({ entityUlid }) {\n *   const { updates, connected, error } = useDriftSubscription({\n *     entityUlids: [entityUlid]\n *   });\n * \n *   if (error) return <div>Error: {error.message}</div>;\n * \n *   return (\n *     <div>\n *       <p>Status: {connected ? 'Connected' : 'Disconnected'}</p>\n *       {updates.map((update, i) => (\n *         <div key={i}>{update.canonicalName} - Epoch {update.driftEpoch}</div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDriftSubscription(\n  options: DriftSubscriptionOptions,\n  maxUpdates: number = 50\n): UseDriftSubscriptionResult {\n  const client = useMemoryClient();\n  const [updates, setUpdates] = useState<DriftUpdate[]>([]);\n  const [latestUpdate, setLatestUpdate] = useState<DriftUpdate | null>(null);\n  const [connected, setConnected] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const subscriptionRef = useRef<DriftSubscription | null>(null);\n\n  const clearUpdates = useCallback(() => {\n    setUpdates([]);\n    setLatestUpdate(null);\n  }, []);\n\n  useEffect(() => {\n    const subscription = client.drift.watch(options);\n    subscriptionRef.current = subscription;\n\n    subscription.on('connected', () => {\n      setConnected(true);\n      setError(null);\n    });\n\n    subscription.on('disconnected', () => {\n      setConnected(false);\n    });\n\n    subscription.on('update', (update) => {\n      setLatestUpdate(update);\n      setUpdates((prev) => [update, ...prev].slice(0, maxUpdates));\n    });\n\n    subscription.on('error', (err: any) => {\n      setError(err);\n      setConnected(false);\n    });\n\n    subscription.start().catch((err) => {\n      setError(err);\n    });\n\n    return () => {\n      subscription.stop();\n    };\n  }, [\n    client,\n    maxUpdates,\n    JSON.stringify(options.entityUlids),\n    options.orgUlid,\n  ]);\n\n  return {\n    updates,\n    latestUpdate,\n    connected,\n    error,\n    clearUpdates,\n  };\n}\n","/**\n * React hook for compute operation progress tracking.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { ComputeSubscription, ComputeProgress, ComputeResult } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseComputeProgressResult<T = any> {\n  progress: ComputeProgress | null;\n  result: ComputeResult<T> | null;\n  connected: boolean;\n  error: Error | null;\n  isComplete: boolean;\n  reset: () => void;\n}\n\n/**\n * Hook for tracking compute operation progress.\n * \n * @param functionName - Name of compute function\n * @param parameters - Function parameters\n * @param enabled - Whether to start the subscription (default: true)\n * @returns Compute progress state\n * \n * @example\n * ```tsx\n * function AnalysisProgress({ narrativeUlid }) {\n *   const { progress, result, isComplete, error } = useComputeProgress(\n *     'analyze_decision_process',\n *     { narrative_ulid: narrativeUlid }\n *   );\n * \n *   if (error) return <div>Error: {error.message}</div>;\n *   if (isComplete && result) {\n *     return <div>Analysis complete: {JSON.stringify(result.result)}</div>;\n *   }\n * \n *   return (\n *     <div>\n *       {progress && (\n *         <div>\n *           <progress value={progress.progressPercent} max={100} />\n *           <p>{progress.message}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useComputeProgress<T = any>(\n  functionName: string,\n  parameters: Record<string, any>,\n  enabled: boolean = true\n): UseComputeProgressResult<T> {\n  const client = useMemoryClient();\n  const [progress, setProgress] = useState<ComputeProgress | null>(null);\n  const [result, setResult] = useState<ComputeResult<T> | null>(null);\n  const [connected, setConnected] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [isComplete, setIsComplete] = useState(false);\n  const subscriptionRef = useRef<ComputeSubscription<T> | null>(null);\n\n  const reset = useCallback(() => {\n    setProgress(null);\n    setResult(null);\n    setError(null);\n    setIsComplete(false);\n  }, []);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    reset();\n\n    const subscription = client.compute.watch<T>(functionName, parameters);\n    subscriptionRef.current = subscription;\n\n    subscription.on('connected', () => {\n      setConnected(true);\n      setError(null);\n    });\n\n    subscription.on('disconnected', () => {\n      setConnected(false);\n    });\n\n    subscription.on('progress', (progressUpdate) => {\n      setProgress(progressUpdate as ComputeProgress);\n    });\n\n    subscription.on('result', (resultData) => {\n      setResult(resultData as ComputeResult<T>);\n      setIsComplete(true);\n      setConnected(false); // Auto-unsubscribes after result\n    });\n\n    subscription.on('error', (err: any) => {\n      setError(err);\n      setConnected(false);\n    });\n\n    subscription.start().catch((err) => {\n      setError(err);\n    });\n\n    return () => {\n      subscription.stop();\n    };\n  }, [\n    client,\n    functionName,\n    JSON.stringify(parameters),\n    enabled,\n    reset,\n  ]);\n\n  return {\n    progress,\n    result,\n    connected,\n    error,\n    isComplete,\n    reset,\n  };\n}\n","/**\n * React hook for memory search.\n */\n\nimport { useState, useCallback } from 'react';\nimport type { SearchResponse, Scope, ExplainLevel } from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface UseMemorySearchOptions {\n  userUlid?: string;\n  limit?: number;\n  scope?: Scope;\n  scopeId?: string;\n  explain?: ExplainLevel;\n}\n\nexport interface UseMemorySearchResult {\n  search: (query: string, options?: UseMemorySearchOptions) => Promise<SearchResponse>;\n  data: SearchResponse | null;\n  loading: boolean;\n  error: Error | null;\n  reset: () => void;\n}\n\n/**\n * Hook for memory search operations.\n * \n * @returns Search function and state\n * \n * @example\n * ```tsx\n * function SearchBox() {\n *   const { search, data, loading, error } = useMemorySearch();\n *   const [query, setQuery] = useState('');\n * \n *   const handleSearch = async () => {\n *     await search(query, { limit: 10 });\n *   };\n * \n *   return (\n *     <div>\n *       <input value={query} onChange={(e) => setQuery(e.target.value)} />\n *       <button onClick={handleSearch} disabled={loading}>Search</button>\n *       {loading && <p>Searching...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && (\n *         <ul>\n *           {data.results.map((result) => (\n *             <li key={result.umo_id}>{result.summary}</li>\n *           ))}\n *         </ul>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemorySearch(): UseMemorySearchResult {\n  const client = useMemoryClient();\n  const [data, setData] = useState<SearchResponse | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const search = useCallback(\n    async (query: string, options?: UseMemorySearchOptions): Promise<SearchResponse> => {\n      setLoading(true);\n      setError(null);\n\n      try {\n        const response = await client.umo.search(query, options);\n        setData(response);\n        return response;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Search failed');\n        setError(error);\n        throw error;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setError(null);\n    setLoading(false);\n  }, []);\n\n  return {\n    search,\n    data,\n    loading,\n    error,\n    reset,\n  };\n}\n","/**\n * React hook for processing content into memories.\n */\n\nimport { useState, useCallback } from 'react';\nimport type {\n  MeaningObject,\n  RetentionPolicy,\n  PIIHandling,\n  ProvenanceMode,\n  Scope,\n} from '@memoryintelligence/sdk';\nimport { useMemoryClient } from './MemoryClientProvider.js';\n\nexport interface ProcessOptions {\n  userUlid?: string;\n  retentionPolicy?: RetentionPolicy;\n  piiHandling?: PIIHandling;\n  provenanceMode?: ProvenanceMode;\n  scope?: Scope;\n  scopeId?: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UseMemoryProcessResult {\n  process: (content: string, options?: ProcessOptions) => Promise<MeaningObject>;\n  data: MeaningObject | null;\n  loading: boolean;\n  error: Error | null;\n  reset: () => void;\n}\n\n/**\n * Hook for processing content into Meaning Objects.\n * \n * @returns Process function and state\n * \n * @example\n * ```tsx\n * function CaptureForm() {\n *   const { process, data, loading, error } = useMemoryProcess();\n *   const [content, setContent] = useState('');\n * \n *   const handleSubmit = async () => {\n *     await process(content, { source: 'web_form' });\n *     setContent(''); // Clear after success\n *   };\n * \n *   return (\n *     <div>\n *       <textarea value={content} onChange={(e) => setContent(e.target.value)} />\n *       <button onClick={handleSubmit} disabled={loading}>Capture</button>\n *       {loading && <p>Processing...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && <p>Created: {data.umo_id}</p>}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMemoryProcess(): UseMemoryProcessResult {\n  const client = useMemoryClient();\n  const [data, setData] = useState<MeaningObject | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const process = useCallback(\n    async (content: string, options?: ProcessOptions): Promise<MeaningObject> => {\n      setLoading(true);\n      setError(null);\n\n      try {\n        const umo = await client.umo.process(content, options);\n        setData(umo);\n        return umo;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Process failed');\n        setError(error);\n        throw error;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setError(null);\n    setLoading(false);\n  }, []);\n\n  return {\n    process,\n    data,\n    loading,\n    error,\n    reset,\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@memoryintelligence/react",
+  "version": "2.0.0",
+  "description": "React hooks for Memory Intelligence SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "memory-intelligence",
+    "react",
+    "hooks",
+    "drift",
+    "websocket",
+    "subscriptions"
+  ],
+  "author": "Memory Intelligence",
+  "license": "MIT",
+  "peerDependencies": {
+    "@memoryintelligence/sdk": "^2.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@memoryintelligence/sdk": "file:../js",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.18",
+    "@vitejs/plugin-react": "^4.3.4",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "vitest": "^1.6.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/somewhere11/MemoryIntelligence",
+    "directory": "sdk/react"
+  }
+}