@equationalapplications/react-llm-wiki 2.6.0 → 3.0.0

package/README.md

@@ -2,11 +2,16 @@
 
 React hooks and web utilities for @equationalapplications/core-llm-wiki, designed for web and Expo.
 
+> Inspired by [Andrej Karpathy's LLM Wiki memory spec](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).
+
 ## Features
 
-- **Reactive reads** — Auto-refetch on `entityId` or query changes
-- **Mutation hooks** — `useWikiWrite`, `useWikiIngest`, `useWikiForget`, etc.
+- **Semantic search** — Vector embeddings with optional `embed` function and MiniSearch fallback
+- **Retrieval tuning** — Per-call overrides for hybrid scoring, pre-filtering, result limits
+- **Reactive reads** — Auto-refetch on `entityId`, query, or `options` changes
+- **Mutation hooks** — `useWikiWrite`, `useWikiIngest`, `useWikiForget`, `useWikiMaintenance`, etc.
 - **Shared context** — Single `WikiProvider` per app, use anywhere
+- **Full-featured memory** — Facts, tasks, events, maintenance jobs (librarian, heal, reembed, prune)
 
 ## Installation
 
@@ -14,13 +19,51 @@ React hooks and web utilities for @equationalapplications/core-llm-wiki, designe
 npm install @equationalapplications/react-llm-wiki
 ```
 
+## Semantic Search Setup
+
+Enable vector-based retrieval by providing an `embed` function in `WikiOptions`:
+
+```typescript
+import { WikiProvider, createWiki } from '@equationalapplications/react-llm-wiki';
+
+const wiki = createWiki(adapter, {
+  config: {
+    preFilterLimit: 50,    // Optimize for wikis with 500+ facts
+    hybridWeight: 0.7,     // Blend semantic (70%) + keyword (30%)
+  },
+  llmProvider: {
+    generateText: async ({ systemPrompt, userPrompt }) => {
+      // Your LLM
+      return 'Model output';
+    },
+    embed: async (text: string) => {
+      // Your embedding service
+      const res = await fetch('https://your-app.example.com/api/embed', { 
+        method: 'POST', 
+        body: JSON.stringify({ text }) 
+      });
+      const { embedding } = await res.json();
+      return embedding; // number[]
+    },
+  },
+  onRetrievalFallback: (error) => {
+    console.warn('Embeddings unavailable, using keyword search:', error);
+  },
+});
+
+await wiki.setup();
+
+<WikiProvider wiki={wiki}>
+  <App />
+</WikiProvider>
+```
+
 ## Setup
 
 **React** (with any `SQLiteAdapter`):
 
 ```typescript
-import { WikiProvider } from '@equationalapplications/react-llm-wiki';
-import { createWiki } from '@equationalapplications/react-llm-wiki';
+import { WikiProvider, createWiki } from '@equationalapplications/react-llm-wiki';
 
 // Create wiki instance and initialize tables
 const wiki = createWiki(adapter, options);
@@ -47,63 +90,196 @@ await wiki.setup();
 </WikiProvider>
 ```
 
+## Configuration
+
+All `WikiConfig` fields are optional:
+
+```typescript
+const wiki = createWiki(adapter, {
+  llmProvider: { /* ... */ },
+  config: {
+    tablePrefix: 'llm_wiki_',          // default: 'llm_wiki_'
+    maxResults: 10,                    // default: 10
+    autoLibrarianThreshold: 20,        // default: 20 — events before librarian auto-runs
+    autoHealThreshold: 100,            // default: 100 — events before heal auto-runs
+    maxChunkLength: 12000,             // default: 12000 (char count per ingestDocument chunk)
+    chunkOverlap: 400,                 // default: 400 (overlap between chunks in characters)
+    chunkConcurrency: 1,               // default: 1 (parallel LLM calls per ingestDocument)
+    pruneRetainSoftDeletedFor: 7,      // default: 7 (days before hard-deleting soft-deleted facts)
+    pruneEventsAfter: 30,              // default: 30 (days before hard-deleting old events)
+    orphanAfterDays: 30,               // default: 30 (days before runHeal flags sourceless facts; null to disable)
+    staleInferredAfterDays: 60,        // default: 60 (days before runHeal downgrades inferred facts; null to disable)
+    preFilterLimit: 50,                // default: undefined — MiniSearch pre-filter before cosine scan; recommended for >500 facts
+    hybridWeight: 0.7,                 // default: undefined — blend semantic (1.0) ↔ keyword (0.0); pure semantic when unset
+  },
+});
+```
+
+## Retrieval Tuning
+
+Optimize `read()` performance and blend retrieval strategies:
+
+```typescript
+const config = {
+  // Limit cosine similarity scoring to top-K MiniSearch keyword candidates
+  preFilterLimit: 50,
+  
+  // Blend semantic and keyword scores (0.0 = pure keyword, 1.0 = pure semantic)
+  hybridWeight: 0.7,
+  
+  // Max results returned per read
+  maxResults: 10,
+};
+
+const wiki = createWiki(adapter, {
+  config,
+  llmProvider: { /* ... */ },
+});
+```
+
+**Hybrid scoring blends:**
+- `hybridWeight: 1.0` → pure semantic scoring among the candidates being scored; if `preFilterLimit` is set, semantic scoring is still limited to the top-K MiniSearch matches
+- `hybridWeight: 0.5` → balanced semantic + keyword (50/50 blend)
+- `hybridWeight: 0.0` → pure keyword ranking, skips `embed()` entirely (no LLM API cost)
+
+**Per-call overrides:**
+
+```typescript
+const { data } = useMemoryRead('user-123', 'preferences', {
+  maxResults: 5,
+  preFilterLimit: 20,      // Tighter pre-filter for speed
+  hybridWeight: 0.5,       // More keyword weight
+});
+```
+
 ## Hooks
 
-### `useMemoryRead(entityId, query)`
+### `useMemoryRead(entityId, query, options?)`
 
-Fetch memory reactively.
+Fetch memory reactively. Auto-refetches when `entityId`, `query`, `wiki`, or `options` change, including per-call overrides such as `maxResults`, `preFilterLimit`, and `hybridWeight`.
 
 ```typescript
 const { data, isPending, error, refetch } = useMemoryRead('user-123', 'preferences');
+
+if (isPending) return <div>Loading...</div>;
+if (error) return <div>Error: {error.message}</div>;
+
+return (
+  <div>
+    {data?.facts.map(fact => (
+      <div key={fact.id}>
+        <strong>{fact.title}</strong>: {fact.body}
+      </div>
+    ))}
+  </div>
+);
+```
+
+**With tuning overrides:**
+
+```typescript
+const { data } = useMemoryRead('user-123', 'preferences', {
+  maxResults: 5,
+  hybridWeight: 0.8,
+});
 ```
 
 ### `useWikiWrite()`
 
-Mutate facts.
+Record observations and events. The librarian job extracts facts from accumulated events. This does not currently invalidate `useMemoryRead()` results automatically, so existing readers keep their previous `data` until their inputs change or `refetch()` is called.
 
 ```typescript
 const { execute, isPending, error } = useWikiWrite();
-await execute('user-123', { event_type: 'observation', summary: '...' });
+
+const handleSave = async () => {
+  try {
+    await execute('user-123', { 
+      event_type: 'observation', 
+      summary: 'User prefers async/await' 
+    });
+  } catch (e) {
+    console.error('Write failed:', e);
+  }
+};
+
+return <button onClick={handleSave} disabled={isPending}>Save</button>;
 ```
 
 ### `useWikiIngest()`
 
-Ingest documents.
+Ingest documents into memory. Parses facts and tasks from document chunks.
 
 ```typescript
 const { execute, isPending, error } = useWikiIngest();
-await execute('user-123', {
-  sourceRef: 'doc-readme',
-  sourceHash: 'a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2',
-  documentChunk: 'raw document text...',
-});
+
+const handleIngest = async (document: string) => {
+  const sourceHash = await calculateHash(document);
+  try {
+    await execute('user-123', {
+      sourceRef: 'doc-readme',
+      sourceHash,
+      documentChunk: document,
+    });
+  } catch (e) {
+    console.error('Ingest failed:', e);
+  }
+};
 ```
 
 ### `useWikiForget()`
 
-Forget entries.
+Delete entries from memory by ID.
 
 ```typescript
 const { execute, isPending, error } = useWikiForget();
-await execute('user-123', { entryId: 'fact-456' });
+
+const handleDelete = async (factId: string) => {
+  try {
+    await execute('user-123', { entryId: factId });
+  } catch (e) {
+    console.error('Delete failed:', e);
+  }
+};
 ```
 
 ### `useWikiMaintenance()`
 
-Run background maintenance.
+Run background maintenance jobs: librarian (deduplication/fact extraction), heal (LLM-driven fact review: removes orphaned facts, downgrades stale inferences, repairs incorrect facts), reembed (convert TEXT embeddings to BLOB / update after model change), prune (hard-delete soft-deleted entries/tasks after the retention window and prune old events).
 
 ```typescript
-const { runLibrarian, runHeal, isPending, error } = useWikiMaintenance();
+const { runLibrarian, runHeal, runReembed, runPrune, isPending, error, lastResult } = useWikiMaintenance();
+
+// Deduplicate and consolidate facts from events
 await runLibrarian('user-123');
+
+// LLM-driven fact review: remove orphaned/stale facts, repair incorrect inferences
+await runHeal('user-123');
+
+// Re-embed all facts with the current provider (e.g. after switching models or
+// enabling an embed provider for the first time — default always re-embeds all):
+const { embedded, skipped, failed } = await runReembed('user-123');
+// After a round-trip export/import on the same model, skip facts that already have vectors:
+const { embedded: embeddedRoundtrip, skipped: skippedRoundtrip, failed: failedRoundtrip } = await runReembed('user-123', { skipExisting: true });
+
+// Hard-delete soft-deleted entries/tasks after retention and prune old events
+await runPrune('user-123');
 ```
 
+> **`lastResult` note**: `runLibrarian`, `runHeal`, and `runPrune` each update `lastResult` on success. `runReembed` intentionally does not — it clears `lastResult` to null at start but leaves it null on completion. This avoids a source-breaking change to the `MaintenanceResult` type for consumers that exhaustively switch on `lastResult.operation`. Use the `Promise` return value to inspect reembed results.
+
 ### `useWikiHasChanged()`
 
 Check if a source document has changed since last ingest.
 
 ```typescript
 const { execute, lastResult, isPending, error } = useWikiHasChanged();
-const changed = await execute('user-123', 'doc-readme', 'a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2');
+
+const handleCheckChanges = async (sourceRef: string, sourceHash: string) => {
+  const changed = await execute('user-123', sourceRef, sourceHash);
+  if (changed) {
+    console.log('Document has been updated, re-ingest recommended');
+  }
+};
 ```
 
 ### `useWikiExport()`
@@ -116,6 +292,79 @@ await execute(['user-123']);
 // lastResult: MemoryDump | null
 ```
 
+## Component Lifecycle
+
+```mermaid
+flowchart TD
+    A["<WikiProvider wiki={wiki}>"] --> B["App Components"]
+    B --> C{"Use Hook?"}
+    C -->|"useMemoryRead(entityId, query, options?)"| D["[Read Memory]"]
+    C -->|"useWikiWrite()"| E["[Write Memory]"]
+    C -->|"useWikiIngest()"| F["[Ingest Document]"]
+    C -->|"useWikiForget()"| G["[Delete Memory]"]
+    C -->|"useWikiMaintenance()"| H["[Run Jobs]"]
+    D --> I{"entityId, query,<br/>ReadOptions, or wiki changed?"}
+    I -->|"Yes"| J["Auto-refetch"]
+    I -->|"No"| K["Return cached data"]
+    J --> L["Trigger read()"]
+    L --> M["Embed query<br/>if embed available"]
+    M --> N["Phase 1: Score facts<br/>Phase 2: Fetch winners"]
+    N --> O["Update component state"]
+    O --> P["Re-render with data"]
+    E --> Q["Execute write()"]
+    F --> Q
+    G --> Q
+    H --> Q
+    Q --> R["Write completes"]
+```
+
+**Data flow:**
+1. **Wrap app** with `<WikiProvider wiki={wiki}>` — provides wiki context
+2. **Use hooks** in components — access memory reactively
+3. **Read operations** auto-refetch when `entityId`, `query`, `wiki`, or `ReadOptions` values change; call `refetch()` to refresh manually
+4. **Write operations** (write, ingest, forget, maintenance) do not automatically re-trigger `useMemoryRead`; call `refetch()` after a write to refresh read results
+5. **Re-render** with new data flowing back to UI
+
+## Retrieval Engine Internals
+
+```mermaid
+flowchart TD
+    A["read(entityId, query)"] --> B{hybridWeight = 0?}
+    B -->|Yes| C["MiniSearch only<br/>(skip embed)"]
+    B -->|No| D{embed available?}
+    D -->|No| C
+    D -->|Yes| F["Embed query"]
+    F -->|throws| E["onRetrievalFallback<br/>callback"]
+    E --> C
+    F -->|succeeds| G{preFilterLimit<br/>active?}
+    G -->|Yes| H["MiniSearch pre-filter<br/>top K candidates"]
+    H --> I["Phase 1: Cosine score<br/>top K candidates"]
+    G -->|No| J["Phase 1: Cosine score<br/>all facts"]
+    J --> K["Cache vectors<br/>in-memory<br/>(full scan only)"]
+    K --> L{hybridWeight = 1?}
+    I --> L
+    L -->|Yes| M["Pure semantic<br/>ranking"]
+    L -->|No| N["Hybrid blend:<br/>semantic + keyword<br/>via MiniSearch"]
+    M --> O["Phase 2: Fetch full rows<br/>top maxResults"]
+    N --> O
+    C --> P["MiniSearch ranking"]
+    P --> O
+    O --> R["Track access"]
+    R --> Q["Return MemoryBundle"]
+```
+
+The flowchart shows:
+1. **Fast-path** when `hybridWeight = 0` (pure keyword, no embed cost)
+2. **Fallback chain** when embed unavailable (MiniSearch silently) or throws (`onRetrievalFallback` callback, then MiniSearch)
+3. **Pre-filtering** to limit cosine scoring to top-K keyword matches (O(N) → O(K))
+4. **Two-phase SELECT**: phase 1 scores all/filtered facts with minimal columns, phase 2 fetches full rows for winners
+5. **Hybrid scoring** to blend semantic and keyword rankings
+6. **Vector caching** on full scans only; reads with `preFilterLimit` active skip cache population
+
 ## License
 
 MIT
+
+---
+
+Made with ❤️ by Equational Applications LLC. [https://equationalapplications.com/](https://equationalapplications.com/)

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { WikiMemory, MemoryBundle, WikiEvent, MemoryDump } from '@equationalapplications/core-llm-wiki';
+import { WikiMemory, ReadOptions, MemoryBundle, WikiEvent, MemoryDump } from '@equationalapplications/core-llm-wiki';
 export * from '@equationalapplications/core-llm-wiki';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
@@ -9,7 +9,7 @@ declare function WikiProvider({ wiki, children }: {
 }): react_jsx_runtime.JSX.Element;
 declare function useWiki(): WikiMemory;
 
-declare function useMemoryRead(entityId: string, query: string): {
+declare function useMemoryRead(entityId: string, query: string, options?: ReadOptions): {
     data: MemoryBundle | null;
     isPending: boolean;
     error: Error | null;
@@ -47,6 +47,14 @@ declare function useWikiMaintenance(): {
         tasks: number;
         events: number;
     }>;
+    runReembed: (entityId?: string, opts?: {
+        force?: boolean;
+        skipExisting?: boolean;
+    }) => Promise<{
+        embedded: number;
+        skipped: number;
+        failed: number;
+    }>;
     lastResult: MaintenanceResult | null;
     isPending: boolean;
     error: Error | null;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { WikiMemory, MemoryBundle, WikiEvent, MemoryDump } from '@equationalapplications/core-llm-wiki';
+import { WikiMemory, ReadOptions, MemoryBundle, WikiEvent, MemoryDump } from '@equationalapplications/core-llm-wiki';
 export * from '@equationalapplications/core-llm-wiki';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
@@ -9,7 +9,7 @@ declare function WikiProvider({ wiki, children }: {
 }): react_jsx_runtime.JSX.Element;
 declare function useWiki(): WikiMemory;
 
-declare function useMemoryRead(entityId: string, query: string): {
+declare function useMemoryRead(entityId: string, query: string, options?: ReadOptions): {
     data: MemoryBundle | null;
     isPending: boolean;
     error: Error | null;
@@ -47,6 +47,14 @@ declare function useWikiMaintenance(): {
         tasks: number;
         events: number;
     }>;
+    runReembed: (entityId?: string, opts?: {
+        force?: boolean;
+        skipExisting?: boolean;
+    }) => Promise<{
+        embedded: number;
+        skipped: number;
+        failed: number;
+    }>;
     lastResult: MaintenanceResult | null;
     isPending: boolean;
     error: Error | null;

package/dist/index.js

@@ -49,13 +49,35 @@ function useWiki() {
 
 // src/useMemoryRead.ts
 var import_react2 = require("react");
-function useMemoryRead(entityId, query) {
+function normalizeReadOptionsKey(opts) {
+  if (!opts) return "";
+  const normalized = {};
+  if (opts.maxResults !== void 0 && opts.maxResults !== null) {
+    normalized.maxResults = Number.isFinite(opts.maxResults) ? Math.max(0, Math.trunc(opts.maxResults)) : 10;
+  }
+  if (opts.preFilterLimit !== void 0) {
+    if (opts.preFilterLimit === null || !Number.isFinite(opts.preFilterLimit)) {
+      normalized.preFilterLimit = null;
+    } else {
+      normalized.preFilterLimit = Math.max(0, Math.trunc(opts.preFilterLimit));
+    }
+  }
+  if (opts.hybridWeight !== void 0 && opts.hybridWeight !== null) {
+    normalized.hybridWeight = Number.isNaN(opts.hybridWeight) ? null : Math.max(0, Math.min(1, opts.hybridWeight));
+  }
+  const sortedKeys = Object.keys(normalized).sort();
+  return sortedKeys.length ? JSON.stringify(normalized, sortedKeys) : "";
+}
+function useMemoryRead(entityId, query, options) {
   const wiki = useWiki();
   const [data, setData] = (0, import_react2.useState)(null);
   const [isPending, setIsPending] = (0, import_react2.useState)(false);
   const [error, setError] = (0, import_react2.useState)(null);
   const wikiRef = (0, import_react2.useRef)(wiki);
   wikiRef.current = wiki;
+  const optionsRef = (0, import_react2.useRef)(options);
+  optionsRef.current = options;
+  const optionsStr = normalizeReadOptionsKey(options);
   const fetchQueue = (0, import_react2.useRef)({ inFlight: false, pending: null });
   const scheduleFetch = (0, import_react2.useRef)(function schedule(eid, q) {
     const fq = fetchQueue.current;
@@ -65,7 +87,7 @@ function useMemoryRead(entityId, query) {
     }
     fq.inFlight = true;
     setIsPending(true);
-    wikiRef.current.read(eid, q).then(
+    wikiRef.current.read(eid, q, optionsRef.current).then(
       (result) => {
         setData(result);
         setError(null);
@@ -86,7 +108,7 @@ function useMemoryRead(entityId, query) {
   });
   (0, import_react2.useEffect)(() => {
     scheduleFetch.current(entityId, query);
-  }, [entityId, query, wiki]);
+  }, [entityId, query, wiki, optionsStr]);
   const refetch = (0, import_react2.useCallback)(() => {
     scheduleFetch.current(entityId, query);
   }, [entityId, query]);
@@ -185,7 +207,23 @@ function useWikiMaintenance() {
     },
     []
   );
-  return { runLibrarian, runHeal, runPrune, lastResult, isPending, error };
+  const runReembed = (0, import_react4.useCallback)(async (entityId, opts) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      return await wikiRef.current.runReembed(entityId, opts);
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      pendingCount.current -= 1;
+      if (pendingCount.current === 0) setIsPending(false);
+    }
+  }, []);
+  return { runLibrarian, runHeal, runPrune, runReembed, lastResult, isPending, error };
 }
 
 // src/useWikiIngest.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/WikiContext.tsx","../src/useMemoryRead.ts","../src/useWikiWrite.ts","../src/useWikiMaintenance.ts","../src/useWikiIngest.ts","../src/useWikiForget.ts","../src/useWikiExport.ts","../src/useWikiHasChanged.ts"],"sourcesContent":["export * from '@equationalapplications/core-llm-wiki';\nexport { WikiProvider, useWiki } from './WikiContext';\nexport { useMemoryRead } from './useMemoryRead';\nexport { useWikiWrite } from './useWikiWrite';\nexport { useWikiMaintenance } from './useWikiMaintenance';\nexport type { MaintenanceResult } from './useWikiMaintenance';\nexport { useWikiIngest } from './useWikiIngest';\nexport { useWikiForget } from './useWikiForget';\nexport { useWikiExport } from './useWikiExport';\nexport { useWikiHasChanged } from './useWikiHasChanged';\n","import React, { createContext, useContext, type ReactNode } from 'react';\nimport { WikiMemory } from '@equationalapplications/core-llm-wiki';\n\nconst WikiContext = createContext<WikiMemory | null>(null);\n\nexport function WikiProvider({ wiki, children }: { wiki: WikiMemory; children: ReactNode }) {\n  return <WikiContext.Provider value={wiki}>{children}</WikiContext.Provider>;\n}\n\nexport function useWiki(): WikiMemory {\n  const wiki = useContext(WikiContext);\n  if (!wiki) throw new Error('useWiki must be used within WikiProvider');\n  return wiki;\n}\n","import { useState, useEffect, useCallback, useRef } from 'react';\nimport type { MemoryBundle } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\nexport function useMemoryRead(entityId: string, query: string) {\n  const wiki = useWiki();\n  const [data, setData] = useState<MemoryBundle | null>(null);\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const fetchQueue = useRef<{\n    inFlight: boolean;\n    pending: { entityId: string; query: string } | null;\n  }>({ inFlight: false, pending: null });\n\n  // Stable scheduler: refs keep it from going stale across renders.\n  // In-flight results are never discarded — spec requires them to land before\n  // starting the next fetch with latest args.\n  const scheduleFetch = useRef(function schedule(eid: string, q: string) {\n    const fq = fetchQueue.current;\n    if (fq.inFlight) {\n      fq.pending = { entityId: eid, query: q };\n      return;\n    }\n    fq.inFlight = true;\n    setIsPending(true);\n\n    wikiRef.current.read(eid, q).then(\n      (result) => { setData(result); setError(null); },\n      (e: unknown) => { setError(e instanceof Error ? e : new Error(String(e))); }\n    ).finally(() => {\n      fq.inFlight = false;\n      const next = fq.pending;\n      fq.pending = null;\n      if (next) {\n        scheduleFetch.current(next.entityId, next.query);\n      } else {\n        setIsPending(false);\n      }\n    });\n  });\n\n  useEffect(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query, wiki]);\n\n  const refetch = useCallback(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query]);\n\n  return { data, isPending, error, refetch };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport type { WikiEvent } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\ntype WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;\n\nexport function useWikiWrite() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<void | null>(null);\n\n  const execute = useCallback(async (entityId: string, event: WriteEvent): Promise<void> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.write(entityId, event);\n      setLastResult(undefined);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport type MaintenanceResult =\n  | { operation: 'librarian' | 'heal'; result: undefined }\n  | { operation: 'prune'; result: { entries: number; tasks: number; events: number } };\n\nexport function useWikiMaintenance() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MaintenanceResult | null>(null);\n  // Counter so any overlapping maintenance operation keeps isPending=true until all complete\n  const pendingCount = useRef(0);\n\n  const runLibrarian = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runLibrarian(entityId);\n      setLastResult({ operation: 'librarian', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runHeal = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runHeal(entityId);\n      setLastResult({ operation: 'heal', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runPrune = useCallback(\n    async (\n      entityId: string,\n      options?: {\n        retainSoftDeletedFor?: number | null;\n        retainEventsFor?: number | null;\n        vacuum?: boolean;\n      }\n    ): Promise<{ entries: number; tasks: number; events: number }> => {\n      setError(null);\n      pendingCount.current += 1;\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.runPrune(entityId, options);\n        setLastResult({ operation: 'prune', result });\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        pendingCount.current -= 1;\n        if (pendingCount.current === 0) setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { runLibrarian, runHeal, runPrune, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface IngestParams {\n  sourceRef: string;\n  sourceHash: string;\n  documentChunk: string;\n  maxChunkLength?: number;\n}\n\ntype IngestResult = { truncated: boolean; chunks: number };\n\nexport function useWikiIngest() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<IngestResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: IngestParams): Promise<IngestResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.ingestDocument(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface ForgetParams {\n  entryId?: string;\n  taskId?: string;\n  sourceRef?: string;\n  sourceHash?: string;\n  clearAll?: boolean;\n}\n\ntype ForgetResult = { deleted: { entries: number; tasks: number } };\n\nexport function useWikiForget() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<ForgetResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: ForgetParams): Promise<ForgetResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.forget(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\nimport type { MemoryDump } from '@equationalapplications/core-llm-wiki';\n\nexport function useWikiExport() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MemoryDump | null>(null);\n\n  const execute = useCallback(async (entityIds?: string[]): Promise<MemoryDump> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.exportDump(entityIds);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport function useWikiHasChanged() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<boolean | null>(null);\n\n  const execute = useCallback(\n    async (entityId: string, sourceRef: string, sourceHash: string): Promise<boolean> => {\n      setError(null);\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);\n        setLastResult(result);\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { execute, lastResult, isPending, error };\n}\n"],"mappings":"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","names":["import_react","import_react","error","import_react","import_react","import_react","import_react","import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/WikiContext.tsx","../src/useMemoryRead.ts","../src/useWikiWrite.ts","../src/useWikiMaintenance.ts","../src/useWikiIngest.ts","../src/useWikiForget.ts","../src/useWikiExport.ts","../src/useWikiHasChanged.ts"],"sourcesContent":["export * from '@equationalapplications/core-llm-wiki';\nexport { WikiProvider, useWiki } from './WikiContext';\nexport { useMemoryRead } from './useMemoryRead';\nexport { useWikiWrite } from './useWikiWrite';\nexport { useWikiMaintenance } from './useWikiMaintenance';\nexport type { MaintenanceResult } from './useWikiMaintenance';\nexport { useWikiIngest } from './useWikiIngest';\nexport { useWikiForget } from './useWikiForget';\nexport { useWikiExport } from './useWikiExport';\nexport { useWikiHasChanged } from './useWikiHasChanged';\n","import React, { createContext, useContext, type ReactNode } from 'react';\nimport { WikiMemory } from '@equationalapplications/core-llm-wiki';\n\nconst WikiContext = createContext<WikiMemory | null>(null);\n\nexport function WikiProvider({ wiki, children }: { wiki: WikiMemory; children: ReactNode }) {\n  return <WikiContext.Provider value={wiki}>{children}</WikiContext.Provider>;\n}\n\nexport function useWiki(): WikiMemory {\n  const wiki = useContext(WikiContext);\n  if (!wiki) throw new Error('useWiki must be used within WikiProvider');\n  return wiki;\n}\n","import { useState, useEffect, useCallback, useRef } from 'react';\nimport type { MemoryBundle, ReadOptions } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\n/**\n * Normalize a ReadOptions object to a canonical string suitable for use as a\n * React effect dependency key. Normalization ensures:\n *  - `undefined` and `{}` produce the same empty string (no spurious refetch)\n *  - Non-serializable numbers are coerced to their effective values before\n *    stringifying, matching how WikiMemory.read() resolves them:\n *      · maxResults: NaN/±Infinity → 10 (read()'s hardcoded fallback, overrides config)\n *      · preFilterLimit: NaN/±Infinity → null (disables config-level limit, same as null)\n *      · hybridWeight: NaN → null (explicitly disables config-level weight; distinct from\n *        undefined which defers to config); ±Infinity → clamped to 0/1\n *  - Keys are sorted so insertion-order differences never cause spurious refetches\n */\nfunction normalizeReadOptionsKey(opts?: ReadOptions): string {\n  if (!opts) return '';\n  const normalized: Record<string, unknown> = {};\n\n  // maxResults: undefined or null → omit (defer to config/default via ??);\n  // non-finite (NaN/±Infinity) → 10 (read()'s hardcoded fallback, bypasses config);\n  // finite → clamp to non-negative integer.\n  if (opts.maxResults !== undefined && opts.maxResults !== null) {\n    normalized.maxResults = Number.isFinite(opts.maxResults)\n      ? Math.max(0, Math.trunc(opts.maxResults))\n      : 10;\n  }\n\n  // preFilterLimit: undefined → omit (defer to config);\n  // null or non-finite → null (disables config-level limit);\n  // finite → clamp to non-negative integer.\n  if (opts.preFilterLimit !== undefined) {\n    if (opts.preFilterLimit === null || !Number.isFinite(opts.preFilterLimit)) {\n      normalized.preFilterLimit = null;\n    } else {\n      normalized.preFilterLimit = Math.max(0, Math.trunc(opts.preFilterLimit));\n    }\n  }\n\n  // hybridWeight: undefined or null → omit (defer to config via ??);\n  // NaN → null (explicitly disables config hybrid weight; distinct from omitting);\n  // ±Infinity and out-of-range finite → clamp to [0, 1].\n  if (opts.hybridWeight !== undefined && opts.hybridWeight !== null) {\n    normalized.hybridWeight = Number.isNaN(opts.hybridWeight)\n      ? null\n      : Math.max(0, Math.min(1, opts.hybridWeight));\n  }\n\n  const sortedKeys = Object.keys(normalized).sort();\n  return sortedKeys.length ? JSON.stringify(normalized, sortedKeys) : '';\n}\n\nexport function useMemoryRead(entityId: string, query: string, options?: ReadOptions) {\n  const wiki = useWiki();\n  const [data, setData] = useState<MemoryBundle | null>(null);\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // Serialize a normalized form of options so:\n  //  - `undefined` and `{}` map to the same string (no spurious refetch)\n  //  - non-finite hybridWeight (±Infinity, NaN) is coerced to its effective value before\n  //    stringifying (JSON.stringify turns Infinity/NaN to `null`, losing type information)\n  //  - keys are sorted so insertion-order differences don't cause spurious refetches\n  const optionsStr = normalizeReadOptionsKey(options);\n\n  const fetchQueue = useRef<{\n    inFlight: boolean;\n    pending: { entityId: string; query: string } | null;\n  }>({ inFlight: false, pending: null });\n\n  // Stable scheduler: refs keep it from going stale across renders.\n  // In-flight results are never discarded — spec requires them to land before\n  // starting the next fetch with latest args.\n  const scheduleFetch = useRef(function schedule(eid: string, q: string) {\n    const fq = fetchQueue.current;\n    if (fq.inFlight) {\n      fq.pending = { entityId: eid, query: q };\n      return;\n    }\n    fq.inFlight = true;\n    setIsPending(true);\n\n    wikiRef.current.read(eid, q, optionsRef.current).then(\n      (result) => { setData(result); setError(null); },\n      (e: unknown) => { setError(e instanceof Error ? e : new Error(String(e))); }\n    ).finally(() => {\n      fq.inFlight = false;\n      const next = fq.pending;\n      fq.pending = null;\n      if (next) {\n        scheduleFetch.current(next.entityId, next.query);\n      } else {\n        setIsPending(false);\n      }\n    });\n  });\n\n  useEffect(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query, wiki, optionsStr]);\n\n  const refetch = useCallback(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query]);\n\n  return { data, isPending, error, refetch };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport type { WikiEvent } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\ntype WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;\n\nexport function useWikiWrite() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<void | null>(null);\n\n  const execute = useCallback(async (entityId: string, event: WriteEvent): Promise<void> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.write(entityId, event);\n      setLastResult(undefined);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport type MaintenanceResult =\n  | { operation: 'librarian' | 'heal'; result: undefined }\n  | { operation: 'prune'; result: { entries: number; tasks: number; events: number } };\n\nexport function useWikiMaintenance() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MaintenanceResult | null>(null);\n  // Counter so any overlapping maintenance operation keeps isPending=true until all complete\n  const pendingCount = useRef(0);\n\n  const runLibrarian = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runLibrarian(entityId);\n      setLastResult({ operation: 'librarian', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runHeal = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runHeal(entityId);\n      setLastResult({ operation: 'heal', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runPrune = useCallback(\n    async (\n      entityId: string,\n      options?: {\n        retainSoftDeletedFor?: number | null;\n        retainEventsFor?: number | null;\n        vacuum?: boolean;\n      }\n    ): Promise<{ entries: number; tasks: number; events: number }> => {\n      setError(null);\n      pendingCount.current += 1;\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.runPrune(entityId, options);\n        setLastResult({ operation: 'prune', result });\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        pendingCount.current -= 1;\n        if (pendingCount.current === 0) setIsPending(false);\n      }\n    },\n    []\n  );\n\n  const runReembed = useCallback(async (entityId?: string, opts?: { force?: boolean; skipExisting?: boolean }): Promise<{ embedded: number; skipped: number; failed: number }> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      // runReembed returns its result directly; it does not update the shared\n      // MaintenanceResult/lastResult field (which only tracks librarian, heal, prune).\n      // Using the return value directly avoids widening the MaintenanceResult union\n      // in a way that would break existing consumers that exhaustively switch on\n      // lastResult.operation.\n      return await wikiRef.current.runReembed(entityId, opts);\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  return { runLibrarian, runHeal, runPrune, runReembed, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface IngestParams {\n  sourceRef: string;\n  sourceHash: string;\n  documentChunk: string;\n  maxChunkLength?: number;\n}\n\ntype IngestResult = { truncated: boolean; chunks: number };\n\nexport function useWikiIngest() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<IngestResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: IngestParams): Promise<IngestResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.ingestDocument(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface ForgetParams {\n  entryId?: string;\n  taskId?: string;\n  sourceRef?: string;\n  sourceHash?: string;\n  clearAll?: boolean;\n}\n\ntype ForgetResult = { deleted: { entries: number; tasks: number } };\n\nexport function useWikiForget() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<ForgetResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: ForgetParams): Promise<ForgetResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.forget(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\nimport type { MemoryDump } from '@equationalapplications/core-llm-wiki';\n\nexport function useWikiExport() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MemoryDump | null>(null);\n\n  const execute = useCallback(async (entityIds?: string[]): Promise<MemoryDump> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.exportDump(entityIds);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport function useWikiHasChanged() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<boolean | null>(null);\n\n  const execute = useCallback(\n    async (entityId: string, sourceRef: string, sourceHash: string): Promise<boolean> => {\n      setError(null);\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);\n        setLastResult(result);\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { execute, lastResult, isPending, error };\n}\n"],"mappings":"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","names":["import_react","import_react","error","import_react","import_react","import_react","import_react","import_react"]}

package/dist/index.mjs

@@ -16,13 +16,35 @@ function useWiki() {
 
 // src/useMemoryRead.ts
 import { useState, useEffect, useCallback, useRef } from "react";
-function useMemoryRead(entityId, query) {
+function normalizeReadOptionsKey(opts) {
+  if (!opts) return "";
+  const normalized = {};
+  if (opts.maxResults !== void 0 && opts.maxResults !== null) {
+    normalized.maxResults = Number.isFinite(opts.maxResults) ? Math.max(0, Math.trunc(opts.maxResults)) : 10;
+  }
+  if (opts.preFilterLimit !== void 0) {
+    if (opts.preFilterLimit === null || !Number.isFinite(opts.preFilterLimit)) {
+      normalized.preFilterLimit = null;
+    } else {
+      normalized.preFilterLimit = Math.max(0, Math.trunc(opts.preFilterLimit));
+    }
+  }
+  if (opts.hybridWeight !== void 0 && opts.hybridWeight !== null) {
+    normalized.hybridWeight = Number.isNaN(opts.hybridWeight) ? null : Math.max(0, Math.min(1, opts.hybridWeight));
+  }
+  const sortedKeys = Object.keys(normalized).sort();
+  return sortedKeys.length ? JSON.stringify(normalized, sortedKeys) : "";
+}
+function useMemoryRead(entityId, query, options) {
   const wiki = useWiki();
   const [data, setData] = useState(null);
   const [isPending, setIsPending] = useState(false);
   const [error, setError] = useState(null);
   const wikiRef = useRef(wiki);
   wikiRef.current = wiki;
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const optionsStr = normalizeReadOptionsKey(options);
   const fetchQueue = useRef({ inFlight: false, pending: null });
   const scheduleFetch = useRef(function schedule(eid, q) {
     const fq = fetchQueue.current;
@@ -32,7 +54,7 @@ function useMemoryRead(entityId, query) {
     }
     fq.inFlight = true;
     setIsPending(true);
-    wikiRef.current.read(eid, q).then(
+    wikiRef.current.read(eid, q, optionsRef.current).then(
       (result) => {
         setData(result);
         setError(null);
@@ -53,7 +75,7 @@ function useMemoryRead(entityId, query) {
   });
   useEffect(() => {
     scheduleFetch.current(entityId, query);
-  }, [entityId, query, wiki]);
+  }, [entityId, query, wiki, optionsStr]);
   const refetch = useCallback(() => {
     scheduleFetch.current(entityId, query);
   }, [entityId, query]);
@@ -152,7 +174,23 @@ function useWikiMaintenance() {
     },
     []
   );
-  return { runLibrarian, runHeal, runPrune, lastResult, isPending, error };
+  const runReembed = useCallback3(async (entityId, opts) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      return await wikiRef.current.runReembed(entityId, opts);
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      pendingCount.current -= 1;
+      if (pendingCount.current === 0) setIsPending(false);
+    }
+  }, []);
+  return { runLibrarian, runHeal, runPrune, runReembed, lastResult, isPending, error };
 }
 
 // src/useWikiIngest.ts

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/WikiContext.tsx","../src/useMemoryRead.ts","../src/useWikiWrite.ts","../src/useWikiMaintenance.ts","../src/useWikiIngest.ts","../src/useWikiForget.ts","../src/useWikiExport.ts","../src/useWikiHasChanged.ts"],"sourcesContent":["export * from '@equationalapplications/core-llm-wiki';\nexport { WikiProvider, useWiki } from './WikiContext';\nexport { useMemoryRead } from './useMemoryRead';\nexport { useWikiWrite } from './useWikiWrite';\nexport { useWikiMaintenance } from './useWikiMaintenance';\nexport type { MaintenanceResult } from './useWikiMaintenance';\nexport { useWikiIngest } from './useWikiIngest';\nexport { useWikiForget } from './useWikiForget';\nexport { useWikiExport } from './useWikiExport';\nexport { useWikiHasChanged } from './useWikiHasChanged';\n","import React, { createContext, useContext, type ReactNode } from 'react';\nimport { WikiMemory } from '@equationalapplications/core-llm-wiki';\n\nconst WikiContext = createContext<WikiMemory | null>(null);\n\nexport function WikiProvider({ wiki, children }: { wiki: WikiMemory; children: ReactNode }) {\n  return <WikiContext.Provider value={wiki}>{children}</WikiContext.Provider>;\n}\n\nexport function useWiki(): WikiMemory {\n  const wiki = useContext(WikiContext);\n  if (!wiki) throw new Error('useWiki must be used within WikiProvider');\n  return wiki;\n}\n","import { useState, useEffect, useCallback, useRef } from 'react';\nimport type { MemoryBundle } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\nexport function useMemoryRead(entityId: string, query: string) {\n  const wiki = useWiki();\n  const [data, setData] = useState<MemoryBundle | null>(null);\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const fetchQueue = useRef<{\n    inFlight: boolean;\n    pending: { entityId: string; query: string } | null;\n  }>({ inFlight: false, pending: null });\n\n  // Stable scheduler: refs keep it from going stale across renders.\n  // In-flight results are never discarded — spec requires them to land before\n  // starting the next fetch with latest args.\n  const scheduleFetch = useRef(function schedule(eid: string, q: string) {\n    const fq = fetchQueue.current;\n    if (fq.inFlight) {\n      fq.pending = { entityId: eid, query: q };\n      return;\n    }\n    fq.inFlight = true;\n    setIsPending(true);\n\n    wikiRef.current.read(eid, q).then(\n      (result) => { setData(result); setError(null); },\n      (e: unknown) => { setError(e instanceof Error ? e : new Error(String(e))); }\n    ).finally(() => {\n      fq.inFlight = false;\n      const next = fq.pending;\n      fq.pending = null;\n      if (next) {\n        scheduleFetch.current(next.entityId, next.query);\n      } else {\n        setIsPending(false);\n      }\n    });\n  });\n\n  useEffect(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query, wiki]);\n\n  const refetch = useCallback(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query]);\n\n  return { data, isPending, error, refetch };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport type { WikiEvent } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\ntype WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;\n\nexport function useWikiWrite() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<void | null>(null);\n\n  const execute = useCallback(async (entityId: string, event: WriteEvent): Promise<void> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.write(entityId, event);\n      setLastResult(undefined);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport type MaintenanceResult =\n  | { operation: 'librarian' | 'heal'; result: undefined }\n  | { operation: 'prune'; result: { entries: number; tasks: number; events: number } };\n\nexport function useWikiMaintenance() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MaintenanceResult | null>(null);\n  // Counter so any overlapping maintenance operation keeps isPending=true until all complete\n  const pendingCount = useRef(0);\n\n  const runLibrarian = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runLibrarian(entityId);\n      setLastResult({ operation: 'librarian', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runHeal = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runHeal(entityId);\n      setLastResult({ operation: 'heal', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runPrune = useCallback(\n    async (\n      entityId: string,\n      options?: {\n        retainSoftDeletedFor?: number | null;\n        retainEventsFor?: number | null;\n        vacuum?: boolean;\n      }\n    ): Promise<{ entries: number; tasks: number; events: number }> => {\n      setError(null);\n      pendingCount.current += 1;\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.runPrune(entityId, options);\n        setLastResult({ operation: 'prune', result });\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        pendingCount.current -= 1;\n        if (pendingCount.current === 0) setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { runLibrarian, runHeal, runPrune, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface IngestParams {\n  sourceRef: string;\n  sourceHash: string;\n  documentChunk: string;\n  maxChunkLength?: number;\n}\n\ntype IngestResult = { truncated: boolean; chunks: number };\n\nexport function useWikiIngest() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<IngestResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: IngestParams): Promise<IngestResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.ingestDocument(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface ForgetParams {\n  entryId?: string;\n  taskId?: string;\n  sourceRef?: string;\n  sourceHash?: string;\n  clearAll?: boolean;\n}\n\ntype ForgetResult = { deleted: { entries: number; tasks: number } };\n\nexport function useWikiForget() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<ForgetResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: ForgetParams): Promise<ForgetResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.forget(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\nimport type { MemoryDump } from '@equationalapplications/core-llm-wiki';\n\nexport function useWikiExport() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MemoryDump | null>(null);\n\n  const execute = useCallback(async (entityIds?: string[]): Promise<MemoryDump> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.exportDump(entityIds);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport function useWikiHasChanged() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<boolean | null>(null);\n\n  const execute = useCallback(\n    async (entityId: string, sourceRef: string, sourceHash: string): Promise<boolean> => {\n      setError(null);\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);\n        setLastResult(result);\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { execute, lastResult, isPending, error };\n}\n"],"mappings":"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","names":["useState","useCallback","useRef","useRef","useState","useCallback","error","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback"]}
+{"version":3,"sources":["../src/index.ts","../src/WikiContext.tsx","../src/useMemoryRead.ts","../src/useWikiWrite.ts","../src/useWikiMaintenance.ts","../src/useWikiIngest.ts","../src/useWikiForget.ts","../src/useWikiExport.ts","../src/useWikiHasChanged.ts"],"sourcesContent":["export * from '@equationalapplications/core-llm-wiki';\nexport { WikiProvider, useWiki } from './WikiContext';\nexport { useMemoryRead } from './useMemoryRead';\nexport { useWikiWrite } from './useWikiWrite';\nexport { useWikiMaintenance } from './useWikiMaintenance';\nexport type { MaintenanceResult } from './useWikiMaintenance';\nexport { useWikiIngest } from './useWikiIngest';\nexport { useWikiForget } from './useWikiForget';\nexport { useWikiExport } from './useWikiExport';\nexport { useWikiHasChanged } from './useWikiHasChanged';\n","import React, { createContext, useContext, type ReactNode } from 'react';\nimport { WikiMemory } from '@equationalapplications/core-llm-wiki';\n\nconst WikiContext = createContext<WikiMemory | null>(null);\n\nexport function WikiProvider({ wiki, children }: { wiki: WikiMemory; children: ReactNode }) {\n  return <WikiContext.Provider value={wiki}>{children}</WikiContext.Provider>;\n}\n\nexport function useWiki(): WikiMemory {\n  const wiki = useContext(WikiContext);\n  if (!wiki) throw new Error('useWiki must be used within WikiProvider');\n  return wiki;\n}\n","import { useState, useEffect, useCallback, useRef } from 'react';\nimport type { MemoryBundle, ReadOptions } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\n/**\n * Normalize a ReadOptions object to a canonical string suitable for use as a\n * React effect dependency key. Normalization ensures:\n *  - `undefined` and `{}` produce the same empty string (no spurious refetch)\n *  - Non-serializable numbers are coerced to their effective values before\n *    stringifying, matching how WikiMemory.read() resolves them:\n *      · maxResults: NaN/±Infinity → 10 (read()'s hardcoded fallback, overrides config)\n *      · preFilterLimit: NaN/±Infinity → null (disables config-level limit, same as null)\n *      · hybridWeight: NaN → null (explicitly disables config-level weight; distinct from\n *        undefined which defers to config); ±Infinity → clamped to 0/1\n *  - Keys are sorted so insertion-order differences never cause spurious refetches\n */\nfunction normalizeReadOptionsKey(opts?: ReadOptions): string {\n  if (!opts) return '';\n  const normalized: Record<string, unknown> = {};\n\n  // maxResults: undefined or null → omit (defer to config/default via ??);\n  // non-finite (NaN/±Infinity) → 10 (read()'s hardcoded fallback, bypasses config);\n  // finite → clamp to non-negative integer.\n  if (opts.maxResults !== undefined && opts.maxResults !== null) {\n    normalized.maxResults = Number.isFinite(opts.maxResults)\n      ? Math.max(0, Math.trunc(opts.maxResults))\n      : 10;\n  }\n\n  // preFilterLimit: undefined → omit (defer to config);\n  // null or non-finite → null (disables config-level limit);\n  // finite → clamp to non-negative integer.\n  if (opts.preFilterLimit !== undefined) {\n    if (opts.preFilterLimit === null || !Number.isFinite(opts.preFilterLimit)) {\n      normalized.preFilterLimit = null;\n    } else {\n      normalized.preFilterLimit = Math.max(0, Math.trunc(opts.preFilterLimit));\n    }\n  }\n\n  // hybridWeight: undefined or null → omit (defer to config via ??);\n  // NaN → null (explicitly disables config hybrid weight; distinct from omitting);\n  // ±Infinity and out-of-range finite → clamp to [0, 1].\n  if (opts.hybridWeight !== undefined && opts.hybridWeight !== null) {\n    normalized.hybridWeight = Number.isNaN(opts.hybridWeight)\n      ? null\n      : Math.max(0, Math.min(1, opts.hybridWeight));\n  }\n\n  const sortedKeys = Object.keys(normalized).sort();\n  return sortedKeys.length ? JSON.stringify(normalized, sortedKeys) : '';\n}\n\nexport function useMemoryRead(entityId: string, query: string, options?: ReadOptions) {\n  const wiki = useWiki();\n  const [data, setData] = useState<MemoryBundle | null>(null);\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // Serialize a normalized form of options so:\n  //  - `undefined` and `{}` map to the same string (no spurious refetch)\n  //  - non-finite hybridWeight (±Infinity, NaN) is coerced to its effective value before\n  //    stringifying (JSON.stringify turns Infinity/NaN to `null`, losing type information)\n  //  - keys are sorted so insertion-order differences don't cause spurious refetches\n  const optionsStr = normalizeReadOptionsKey(options);\n\n  const fetchQueue = useRef<{\n    inFlight: boolean;\n    pending: { entityId: string; query: string } | null;\n  }>({ inFlight: false, pending: null });\n\n  // Stable scheduler: refs keep it from going stale across renders.\n  // In-flight results are never discarded — spec requires them to land before\n  // starting the next fetch with latest args.\n  const scheduleFetch = useRef(function schedule(eid: string, q: string) {\n    const fq = fetchQueue.current;\n    if (fq.inFlight) {\n      fq.pending = { entityId: eid, query: q };\n      return;\n    }\n    fq.inFlight = true;\n    setIsPending(true);\n\n    wikiRef.current.read(eid, q, optionsRef.current).then(\n      (result) => { setData(result); setError(null); },\n      (e: unknown) => { setError(e instanceof Error ? e : new Error(String(e))); }\n    ).finally(() => {\n      fq.inFlight = false;\n      const next = fq.pending;\n      fq.pending = null;\n      if (next) {\n        scheduleFetch.current(next.entityId, next.query);\n      } else {\n        setIsPending(false);\n      }\n    });\n  });\n\n  useEffect(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query, wiki, optionsStr]);\n\n  const refetch = useCallback(() => {\n    scheduleFetch.current(entityId, query);\n  }, [entityId, query]);\n\n  return { data, isPending, error, refetch };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport type { WikiEvent } from '@equationalapplications/core-llm-wiki';\nimport { useWiki } from './WikiContext';\n\ntype WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;\n\nexport function useWikiWrite() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<void | null>(null);\n\n  const execute = useCallback(async (entityId: string, event: WriteEvent): Promise<void> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.write(entityId, event);\n      setLastResult(undefined);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport type MaintenanceResult =\n  | { operation: 'librarian' | 'heal'; result: undefined }\n  | { operation: 'prune'; result: { entries: number; tasks: number; events: number } };\n\nexport function useWikiMaintenance() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MaintenanceResult | null>(null);\n  // Counter so any overlapping maintenance operation keeps isPending=true until all complete\n  const pendingCount = useRef(0);\n\n  const runLibrarian = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runLibrarian(entityId);\n      setLastResult({ operation: 'librarian', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runHeal = useCallback(async (entityId: string): Promise<void> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      await wikiRef.current.runHeal(entityId);\n      setLastResult({ operation: 'heal', result: undefined });\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  const runPrune = useCallback(\n    async (\n      entityId: string,\n      options?: {\n        retainSoftDeletedFor?: number | null;\n        retainEventsFor?: number | null;\n        vacuum?: boolean;\n      }\n    ): Promise<{ entries: number; tasks: number; events: number }> => {\n      setError(null);\n      pendingCount.current += 1;\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.runPrune(entityId, options);\n        setLastResult({ operation: 'prune', result });\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        pendingCount.current -= 1;\n        if (pendingCount.current === 0) setIsPending(false);\n      }\n    },\n    []\n  );\n\n  const runReembed = useCallback(async (entityId?: string, opts?: { force?: boolean; skipExisting?: boolean }): Promise<{ embedded: number; skipped: number; failed: number }> => {\n    setError(null);\n    pendingCount.current += 1;\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      // runReembed returns its result directly; it does not update the shared\n      // MaintenanceResult/lastResult field (which only tracks librarian, heal, prune).\n      // Using the return value directly avoids widening the MaintenanceResult union\n      // in a way that would break existing consumers that exhaustively switch on\n      // lastResult.operation.\n      return await wikiRef.current.runReembed(entityId, opts);\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      pendingCount.current -= 1;\n      if (pendingCount.current === 0) setIsPending(false);\n    }\n  }, []);\n\n  return { runLibrarian, runHeal, runPrune, runReembed, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface IngestParams {\n  sourceRef: string;\n  sourceHash: string;\n  documentChunk: string;\n  maxChunkLength?: number;\n}\n\ntype IngestResult = { truncated: boolean; chunks: number };\n\nexport function useWikiIngest() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<IngestResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: IngestParams): Promise<IngestResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.ingestDocument(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\ninterface ForgetParams {\n  entryId?: string;\n  taskId?: string;\n  sourceRef?: string;\n  sourceHash?: string;\n  clearAll?: boolean;\n}\n\ntype ForgetResult = { deleted: { entries: number; tasks: number } };\n\nexport function useWikiForget() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<ForgetResult | null>(null);\n\n  const execute = useCallback(async (entityId: string, params: ForgetParams): Promise<ForgetResult> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.forget(entityId, params);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\nimport type { MemoryDump } from '@equationalapplications/core-llm-wiki';\n\nexport function useWikiExport() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<MemoryDump | null>(null);\n\n  const execute = useCallback(async (entityIds?: string[]): Promise<MemoryDump> => {\n    setError(null);\n    setIsPending(true);\n    setLastResult(null);\n    try {\n      const result = await wikiRef.current.exportDump(entityIds);\n      setLastResult(result);\n      return result;\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      setError(err);\n      throw err;\n    } finally {\n      setIsPending(false);\n    }\n  }, []);\n\n  return { execute, lastResult, isPending, error };\n}\n","import { useState, useCallback, useRef } from 'react';\nimport { useWiki } from './WikiContext';\n\nexport function useWikiHasChanged() {\n  const wiki = useWiki();\n  const wikiRef = useRef(wiki);\n  wikiRef.current = wiki;\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [lastResult, setLastResult] = useState<boolean | null>(null);\n\n  const execute = useCallback(\n    async (entityId: string, sourceRef: string, sourceHash: string): Promise<boolean> => {\n      setError(null);\n      setIsPending(true);\n      setLastResult(null);\n      try {\n        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);\n        setLastResult(result);\n        return result;\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    []\n  );\n\n  return { execute, lastResult, isPending, error };\n}\n"],"mappings":"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","names":["useState","useCallback","useRef","useRef","useState","useCallback","error","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback","useState","useCallback","useRef","useRef","useState","useCallback"]}

package/dist/js.d.mts

@@ -1,4 +1,4 @@
-import { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
+import { WikiMemory, ReadOptions, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
 export * from '@equationalapplications/core-llm-wiki';
 
 /**
@@ -12,9 +12,9 @@ export * from '@equationalapplications/core-llm-wiki';
  */
 
 /**
- * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.
+ * Standalone read helper. Equivalent to `wiki.read(entityId, query, options)`.
  */
-declare function read(wiki: WikiMemory, entityId: string, query: string): Promise<MemoryBundle>;
+declare function read(wiki: WikiMemory, entityId: string, query: string, options?: ReadOptions): Promise<MemoryBundle>;
 /**
  * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.
  */

package/dist/js.d.ts

@@ -1,4 +1,4 @@
-import { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
+import { WikiMemory, ReadOptions, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
 export * from '@equationalapplications/core-llm-wiki';
 
 /**
@@ -12,9 +12,9 @@ export * from '@equationalapplications/core-llm-wiki';
  */
 
 /**
- * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.
+ * Standalone read helper. Equivalent to `wiki.read(entityId, query, options)`.
  */
-declare function read(wiki: WikiMemory, entityId: string, query: string): Promise<MemoryBundle>;
+declare function read(wiki: WikiMemory, entityId: string, query: string, options?: ReadOptions): Promise<MemoryBundle>;
 /**
  * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.
  */

package/dist/js.js

@@ -26,8 +26,8 @@ __export(js_exports, {
 });
 module.exports = __toCommonJS(js_exports);
 __reExport(js_exports, require("@equationalapplications/core-llm-wiki"), module.exports);
-function read(wiki, entityId, query) {
-  return wiki.read(entityId, query);
+function read(wiki, entityId, query, options) {
+  return wiki.read(entityId, query, options);
 }
 function write(wiki, entityId, event) {
   return wiki.write(entityId, event);

package/dist/js.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/js.ts"],"sourcesContent":["/**\n * Vanilla-JS entry for @equationalapplications/react-llm-wiki.\n * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory\n * without bundling React or any hook code.\n *\n * Provides:\n *   - All core exports (createWiki, WikiMemory, types, …)\n *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods\n */\nexport * from '@equationalapplications/core-llm-wiki';\n\nimport type { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';\n\n/**\n * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.\n */\nexport function read(\n  wiki: WikiMemory,\n  entityId: string,\n  query: string,\n): Promise<MemoryBundle> {\n  return wiki.read(entityId, query);\n}\n\n/**\n * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.\n */\nexport function write(\n  wiki: WikiMemory,\n  entityId: string,\n  event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>,\n): Promise<void> {\n  return wiki.write(entityId, event);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAAc,kDATd;AAgBO,SAAS,KACd,MACA,UACA,OACuB;AACvB,SAAO,KAAK,KAAK,UAAU,KAAK;AAClC;AAKO,SAAS,MACd,MACA,UACA,OACe;AACf,SAAO,KAAK,MAAM,UAAU,KAAK;AACnC;","names":[]}
+{"version":3,"sources":["../src/js.ts"],"sourcesContent":["/**\n * Vanilla-JS entry for @equationalapplications/react-llm-wiki.\n * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory\n * without bundling React or any hook code.\n *\n * Provides:\n *   - All core exports (createWiki, WikiMemory, types, …)\n *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods\n */\nexport * from '@equationalapplications/core-llm-wiki';\n\nimport type { WikiMemory, MemoryBundle, WikiEvent, ReadOptions } from '@equationalapplications/core-llm-wiki';\n\n/**\n * Standalone read helper. Equivalent to `wiki.read(entityId, query, options)`.\n */\nexport function read(\n  wiki: WikiMemory,\n  entityId: string,\n  query: string,\n  options?: ReadOptions,\n): Promise<MemoryBundle> {\n  return wiki.read(entityId, query, options);\n}\n\n/**\n * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.\n */\nexport function write(\n  wiki: WikiMemory,\n  entityId: string,\n  event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>,\n): Promise<void> {\n  return wiki.write(entityId, event);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAAc,kDATd;AAgBO,SAAS,KACd,MACA,UACA,OACA,SACuB;AACvB,SAAO,KAAK,KAAK,UAAU,OAAO,OAAO;AAC3C;AAKO,SAAS,MACd,MACA,UACA,OACe;AACf,SAAO,KAAK,MAAM,UAAU,KAAK;AACnC;","names":[]}

package/dist/js.mjs

@@ -1,7 +1,7 @@
 // src/js.ts
 export * from "@equationalapplications/core-llm-wiki";
-function read(wiki, entityId, query) {
-  return wiki.read(entityId, query);
+function read(wiki, entityId, query, options) {
+  return wiki.read(entityId, query, options);
 }
 function write(wiki, entityId, event) {
   return wiki.write(entityId, event);

package/dist/js.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/js.ts"],"sourcesContent":["/**\n * Vanilla-JS entry for @equationalapplications/react-llm-wiki.\n * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory\n * without bundling React or any hook code.\n *\n * Provides:\n *   - All core exports (createWiki, WikiMemory, types, …)\n *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods\n */\nexport * from '@equationalapplications/core-llm-wiki';\n\nimport type { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';\n\n/**\n * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.\n */\nexport function read(\n  wiki: WikiMemory,\n  entityId: string,\n  query: string,\n): Promise<MemoryBundle> {\n  return wiki.read(entityId, query);\n}\n\n/**\n * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.\n */\nexport function write(\n  wiki: WikiMemory,\n  entityId: string,\n  event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>,\n): Promise<void> {\n  return wiki.write(entityId, event);\n}\n"],"mappings":";AASA,cAAc;AAOP,SAAS,KACd,MACA,UACA,OACuB;AACvB,SAAO,KAAK,KAAK,UAAU,KAAK;AAClC;AAKO,SAAS,MACd,MACA,UACA,OACe;AACf,SAAO,KAAK,MAAM,UAAU,KAAK;AACnC;","names":[]}
+{"version":3,"sources":["../src/js.ts"],"sourcesContent":["/**\n * Vanilla-JS entry for @equationalapplications/react-llm-wiki.\n * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory\n * without bundling React or any hook code.\n *\n * Provides:\n *   - All core exports (createWiki, WikiMemory, types, …)\n *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods\n */\nexport * from '@equationalapplications/core-llm-wiki';\n\nimport type { WikiMemory, MemoryBundle, WikiEvent, ReadOptions } from '@equationalapplications/core-llm-wiki';\n\n/**\n * Standalone read helper. Equivalent to `wiki.read(entityId, query, options)`.\n */\nexport function read(\n  wiki: WikiMemory,\n  entityId: string,\n  query: string,\n  options?: ReadOptions,\n): Promise<MemoryBundle> {\n  return wiki.read(entityId, query, options);\n}\n\n/**\n * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.\n */\nexport function write(\n  wiki: WikiMemory,\n  entityId: string,\n  event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>,\n): Promise<void> {\n  return wiki.write(entityId, event);\n}\n"],"mappings":";AASA,cAAc;AAOP,SAAS,KACd,MACA,UACA,OACA,SACuB;AACvB,SAAO,KAAK,KAAK,UAAU,OAAO,OAAO;AAC3C;AAKO,SAAS,MACd,MACA,UACA,OACe;AACf,SAAO,KAAK,MAAM,UAAU,KAAK;AACnC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/react-llm-wiki",
-  "version": "2.6.0",
+  "version": "3.0.0",
   "description": "React hooks and web utilities for LLM Wiki Memory.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,7 +28,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@equationalapplications/core-llm-wiki": "2.6.0"
+    "@equationalapplications/core-llm-wiki": "3.0.0"
   },
   "peerDependencies": {
     "react": ">=17"
@@ -49,7 +49,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "test": "echo 'React hook tests disabled pending vitest 5.x stable (see packages/react/vitest.config.ts)'",
+    "test": "vitest run",
     "test:watch": "vitest"
   }
 }