@equationalapplications/react-llm-wiki 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Equational Applications
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# @equationalapplications/react-llm-wiki
+
+React hooks and web utilities for @equationalapplications/core-llm-wiki, designed for web and Expo.
+
+## Features
+
+- **Reactive reads** — Auto-refetch on `entityId` or query changes
+- **Mutation hooks** — `useWikiWrite`, `useWikiIngest`, `useWikiForget`, etc.
+- **Shared context** — Single `WikiProvider` per app, use anywhere
+
+## Installation
+
+```bash
+npm install @equationalapplications/react-llm-wiki
+```
+
+## Setup
+
+**React** (with any `SQLiteAdapter`):
+
+```typescript
+import { WikiProvider } from '@equationalapplications/react-llm-wiki';
+import { createWiki } from '@equationalapplications/react-llm-wiki';
+
+// Create wiki instance and initialize tables
+const wiki = createWiki(adapter, options);
+await wiki.setup();
+
+// Wrap app
+<WikiProvider wiki={wiki}>
+  <App />
+</WikiProvider>
+```
+
+**Expo / React Native** (`@equationalapplications/expo-llm-wiki` re-exports both `createWiki` and `WikiProvider`):
+
+```typescript
+import { createWiki, WikiProvider } from '@equationalapplications/expo-llm-wiki';
+import { openDatabaseSync } from 'expo-sqlite';
+
+const db = openDatabaseSync('wiki.db');
+const wiki = createWiki(db, options);
+await wiki.setup();
+
+<WikiProvider wiki={wiki}>
+  <App />
+</WikiProvider>
+```
+
+## Hooks
+
+### `useMemoryRead(entityId, query)`
+
+Fetch memory reactively.
+
+```typescript
+const { data, isPending, error, refetch } = useMemoryRead('user-123', 'preferences');
+```
+
+### `useWikiWrite()`
+
+Mutate facts.
+
+```typescript
+const { execute, isPending, error } = useWikiWrite();
+await execute('user-123', { event_type: 'observation', summary: '...' });
+```
+
+### `useWikiIngest()`
+
+Ingest documents.
+
+```typescript
+const { execute, isPending, error } = useWikiIngest();
+await execute('user-123', {
+  sourceRef: 'doc-readme',
+  sourceHash: 'a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2',
+  documentChunk: 'raw document text...',
+});
+```
+
+### `useWikiForget()`
+
+Forget entries.
+
+```typescript
+const { execute, isPending, error } = useWikiForget();
+await execute('user-123', { entryId: 'fact-456' });
+```
+
+### `useWikiMaintenance()`
+
+Run background maintenance.
+
+```typescript
+const { runLibrarian, runHeal, isPending, error } = useWikiMaintenance();
+await runLibrarian('user-123');
+```
+
+### `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');
+```
+
+### `useWikiExport()`
+
+Export memory dump.
+
+```typescript
+const { execute, lastResult, isPending, error } = useWikiExport();
+await execute(['user-123']);
+// lastResult: MemoryDump | null
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,106 @@
+import { WikiMemory, 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';
+
+declare function WikiProvider({ wiki, children }: {
+    wiki: WikiMemory;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useWiki(): WikiMemory;
+
+declare function useMemoryRead(entityId: string, query: string): {
+    data: MemoryBundle | null;
+    isPending: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+
+type WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;
+declare function useWikiWrite(): {
+    execute: (entityId: string, event: WriteEvent) => Promise<void>;
+    lastResult: void | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+type MaintenanceResult = {
+    operation: 'librarian' | 'heal';
+    result: undefined;
+} | {
+    operation: 'prune';
+    result: {
+        entries: number;
+        tasks: number;
+        events: number;
+    };
+};
+declare function useWikiMaintenance(): {
+    runLibrarian: (entityId: string) => Promise<void>;
+    runHeal: (entityId: string) => Promise<void>;
+    runPrune: (entityId: string, options?: {
+        retainSoftDeletedFor?: number | null;
+        retainEventsFor?: number | null;
+        vacuum?: boolean;
+    }) => Promise<{
+        entries: number;
+        tasks: number;
+        events: number;
+    }>;
+    lastResult: MaintenanceResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+interface IngestParams {
+    sourceRef: string;
+    sourceHash: string;
+    documentChunk: string;
+    maxChunkLength?: number;
+}
+type IngestResult = {
+    truncated: boolean;
+    chunks: number;
+};
+declare function useWikiIngest(): {
+    execute: (entityId: string, params: IngestParams) => Promise<IngestResult>;
+    lastResult: IngestResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+interface ForgetParams {
+    entryId?: string;
+    taskId?: string;
+    sourceRef?: string;
+    sourceHash?: string;
+    clearAll?: boolean;
+}
+type ForgetResult = {
+    deleted: {
+        entries: number;
+        tasks: number;
+    };
+};
+declare function useWikiForget(): {
+    execute: (entityId: string, params: ForgetParams) => Promise<ForgetResult>;
+    lastResult: ForgetResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+declare function useWikiExport(): {
+    execute: (entityIds?: string[]) => Promise<MemoryDump>;
+    lastResult: MemoryDump | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+declare function useWikiHasChanged(): {
+    execute: (entityId: string, sourceRef: string, sourceHash: string) => Promise<boolean>;
+    lastResult: boolean | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+export { type MaintenanceResult, WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiHasChanged, useWikiIngest, useWikiMaintenance, useWikiWrite };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { WikiMemory, 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';
+
+declare function WikiProvider({ wiki, children }: {
+    wiki: WikiMemory;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useWiki(): WikiMemory;
+
+declare function useMemoryRead(entityId: string, query: string): {
+    data: MemoryBundle | null;
+    isPending: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+
+type WriteEvent = Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>;
+declare function useWikiWrite(): {
+    execute: (entityId: string, event: WriteEvent) => Promise<void>;
+    lastResult: void | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+type MaintenanceResult = {
+    operation: 'librarian' | 'heal';
+    result: undefined;
+} | {
+    operation: 'prune';
+    result: {
+        entries: number;
+        tasks: number;
+        events: number;
+    };
+};
+declare function useWikiMaintenance(): {
+    runLibrarian: (entityId: string) => Promise<void>;
+    runHeal: (entityId: string) => Promise<void>;
+    runPrune: (entityId: string, options?: {
+        retainSoftDeletedFor?: number | null;
+        retainEventsFor?: number | null;
+        vacuum?: boolean;
+    }) => Promise<{
+        entries: number;
+        tasks: number;
+        events: number;
+    }>;
+    lastResult: MaintenanceResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+interface IngestParams {
+    sourceRef: string;
+    sourceHash: string;
+    documentChunk: string;
+    maxChunkLength?: number;
+}
+type IngestResult = {
+    truncated: boolean;
+    chunks: number;
+};
+declare function useWikiIngest(): {
+    execute: (entityId: string, params: IngestParams) => Promise<IngestResult>;
+    lastResult: IngestResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+interface ForgetParams {
+    entryId?: string;
+    taskId?: string;
+    sourceRef?: string;
+    sourceHash?: string;
+    clearAll?: boolean;
+}
+type ForgetResult = {
+    deleted: {
+        entries: number;
+        tasks: number;
+    };
+};
+declare function useWikiForget(): {
+    execute: (entityId: string, params: ForgetParams) => Promise<ForgetResult>;
+    lastResult: ForgetResult | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+declare function useWikiExport(): {
+    execute: (entityIds?: string[]) => Promise<MemoryDump>;
+    lastResult: MemoryDump | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+declare function useWikiHasChanged(): {
+    execute: (entityId: string, sourceRef: string, sourceHash: string) => Promise<boolean>;
+    lastResult: boolean | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+export { type MaintenanceResult, WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiHasChanged, useWikiIngest, useWikiMaintenance, useWikiWrite };

package/dist/index.js

@@ -0,0 +1,318 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  WikiProvider: () => WikiProvider,
+  useMemoryRead: () => useMemoryRead,
+  useWiki: () => useWiki,
+  useWikiExport: () => useWikiExport,
+  useWikiForget: () => useWikiForget,
+  useWikiHasChanged: () => useWikiHasChanged,
+  useWikiIngest: () => useWikiIngest,
+  useWikiMaintenance: () => useWikiMaintenance,
+  useWikiWrite: () => useWikiWrite
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@equationalapplications/core-llm-wiki"), module.exports);
+
+// src/WikiContext.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var WikiContext = (0, import_react.createContext)(null);
+function WikiProvider({ wiki, children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(WikiContext.Provider, { value: wiki, children });
+}
+function useWiki() {
+  const wiki = (0, import_react.useContext)(WikiContext);
+  if (!wiki) throw new Error("useWiki must be used within WikiProvider");
+  return wiki;
+}
+
+// src/useMemoryRead.ts
+var import_react2 = require("react");
+function useMemoryRead(entityId, query) {
+  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 fetchQueue = (0, import_react2.useRef)({ inFlight: false, pending: null });
+  const scheduleFetch = (0, import_react2.useRef)(function schedule(eid, q) {
+    const fq = fetchQueue.current;
+    if (fq.inFlight) {
+      fq.pending = { entityId: eid, query: q };
+      return;
+    }
+    fq.inFlight = true;
+    setIsPending(true);
+    wikiRef.current.read(eid, q).then(
+      (result) => {
+        setData(result);
+        setError(null);
+      },
+      (e) => {
+        setError(e instanceof Error ? e : new Error(String(e)));
+      }
+    ).finally(() => {
+      fq.inFlight = false;
+      const next = fq.pending;
+      fq.pending = null;
+      if (next) {
+        scheduleFetch.current(next.entityId, next.query);
+      } else {
+        setIsPending(false);
+      }
+    });
+  });
+  (0, import_react2.useEffect)(() => {
+    scheduleFetch.current(entityId, query);
+  }, [entityId, query, wiki]);
+  const refetch = (0, import_react2.useCallback)(() => {
+    scheduleFetch.current(entityId, query);
+  }, [entityId, query]);
+  return { data, isPending, error, refetch };
+}
+
+// src/useWikiWrite.ts
+var import_react3 = require("react");
+function useWikiWrite() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react3.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react3.useState)(false);
+  const [error, setError] = (0, import_react3.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react3.useState)(null);
+  const execute = (0, import_react3.useCallback)(async (entityId, event) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.write(entityId, event);
+      setLastResult(void 0);
+    } catch (e) {
+      const error2 = e instanceof Error ? e : new Error(String(e));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiMaintenance.ts
+var import_react4 = require("react");
+function useWikiMaintenance() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react4.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react4.useState)(null);
+  const pendingCount = (0, import_react4.useRef)(0);
+  const runLibrarian = (0, import_react4.useCallback)(async (entityId) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.runLibrarian(entityId);
+      setLastResult({ operation: "librarian", result: void 0 });
+    } 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);
+    }
+  }, []);
+  const runHeal = (0, import_react4.useCallback)(async (entityId) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.runHeal(entityId);
+      setLastResult({ operation: "heal", result: void 0 });
+    } 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);
+    }
+  }, []);
+  const runPrune = (0, import_react4.useCallback)(
+    async (entityId, options) => {
+      setError(null);
+      pendingCount.current += 1;
+      setIsPending(true);
+      setLastResult(null);
+      try {
+        const result = await wikiRef.current.runPrune(entityId, options);
+        setLastResult({ operation: "prune", result });
+        return result;
+      } 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, lastResult, isPending, error };
+}
+
+// src/useWikiIngest.ts
+var import_react5 = require("react");
+function useWikiIngest() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react5.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react5.useState)(false);
+  const [error, setError] = (0, import_react5.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react5.useState)(null);
+  const execute = (0, import_react5.useCallback)(async (entityId, params) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.ingestDocument(entityId, params);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiForget.ts
+var import_react6 = require("react");
+function useWikiForget() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react6.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react6.useState)(false);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react6.useState)(null);
+  const execute = (0, import_react6.useCallback)(async (entityId, params) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.forget(entityId, params);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiExport.ts
+var import_react7 = require("react");
+function useWikiExport() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react7.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react7.useState)(false);
+  const [error, setError] = (0, import_react7.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react7.useState)(null);
+  const execute = (0, import_react7.useCallback)(async (entityIds) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.exportDump(entityIds);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiHasChanged.ts
+var import_react8 = require("react");
+function useWikiHasChanged() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react8.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react8.useState)(false);
+  const [error, setError] = (0, import_react8.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react8.useState)(null);
+  const execute = (0, import_react8.useCallback)(
+    async (entityId, sourceRef, sourceHash) => {
+      setError(null);
+      setIsPending(true);
+      setLastResult(null);
+      try {
+        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);
+        setLastResult(result);
+        return result;
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    []
+  );
+  return { execute, lastResult, isPending, error };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WikiProvider,
+  useMemoryRead,
+  useWiki,
+  useWikiExport,
+  useWikiForget,
+  useWikiHasChanged,
+  useWikiIngest,
+  useWikiMaintenance,
+  useWikiWrite,
+  ...require("@equationalapplications/core-llm-wiki")
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/dist/index.mjs

@@ -0,0 +1,283 @@
+// src/index.ts
+export * from "@equationalapplications/core-llm-wiki";
+
+// src/WikiContext.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var WikiContext = createContext(null);
+function WikiProvider({ wiki, children }) {
+  return /* @__PURE__ */ jsx(WikiContext.Provider, { value: wiki, children });
+}
+function useWiki() {
+  const wiki = useContext(WikiContext);
+  if (!wiki) throw new Error("useWiki must be used within WikiProvider");
+  return wiki;
+}
+
+// src/useMemoryRead.ts
+import { useState, useEffect, useCallback, useRef } from "react";
+function useMemoryRead(entityId, query) {
+  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 fetchQueue = useRef({ inFlight: false, pending: null });
+  const scheduleFetch = useRef(function schedule(eid, q) {
+    const fq = fetchQueue.current;
+    if (fq.inFlight) {
+      fq.pending = { entityId: eid, query: q };
+      return;
+    }
+    fq.inFlight = true;
+    setIsPending(true);
+    wikiRef.current.read(eid, q).then(
+      (result) => {
+        setData(result);
+        setError(null);
+      },
+      (e) => {
+        setError(e instanceof Error ? e : new Error(String(e)));
+      }
+    ).finally(() => {
+      fq.inFlight = false;
+      const next = fq.pending;
+      fq.pending = null;
+      if (next) {
+        scheduleFetch.current(next.entityId, next.query);
+      } else {
+        setIsPending(false);
+      }
+    });
+  });
+  useEffect(() => {
+    scheduleFetch.current(entityId, query);
+  }, [entityId, query, wiki]);
+  const refetch = useCallback(() => {
+    scheduleFetch.current(entityId, query);
+  }, [entityId, query]);
+  return { data, isPending, error, refetch };
+}
+
+// src/useWikiWrite.ts
+import { useState as useState2, useCallback as useCallback2, useRef as useRef2 } from "react";
+function useWikiWrite() {
+  const wiki = useWiki();
+  const wikiRef = useRef2(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState2(false);
+  const [error, setError] = useState2(null);
+  const [lastResult, setLastResult] = useState2(null);
+  const execute = useCallback2(async (entityId, event) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.write(entityId, event);
+      setLastResult(void 0);
+    } catch (e) {
+      const error2 = e instanceof Error ? e : new Error(String(e));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiMaintenance.ts
+import { useState as useState3, useCallback as useCallback3, useRef as useRef3 } from "react";
+function useWikiMaintenance() {
+  const wiki = useWiki();
+  const wikiRef = useRef3(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState3(false);
+  const [error, setError] = useState3(null);
+  const [lastResult, setLastResult] = useState3(null);
+  const pendingCount = useRef3(0);
+  const runLibrarian = useCallback3(async (entityId) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.runLibrarian(entityId);
+      setLastResult({ operation: "librarian", result: void 0 });
+    } 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);
+    }
+  }, []);
+  const runHeal = useCallback3(async (entityId) => {
+    setError(null);
+    pendingCount.current += 1;
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      await wikiRef.current.runHeal(entityId);
+      setLastResult({ operation: "heal", result: void 0 });
+    } 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);
+    }
+  }, []);
+  const runPrune = useCallback3(
+    async (entityId, options) => {
+      setError(null);
+      pendingCount.current += 1;
+      setIsPending(true);
+      setLastResult(null);
+      try {
+        const result = await wikiRef.current.runPrune(entityId, options);
+        setLastResult({ operation: "prune", result });
+        return result;
+      } 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, lastResult, isPending, error };
+}
+
+// src/useWikiIngest.ts
+import { useState as useState4, useCallback as useCallback4, useRef as useRef4 } from "react";
+function useWikiIngest() {
+  const wiki = useWiki();
+  const wikiRef = useRef4(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState4(false);
+  const [error, setError] = useState4(null);
+  const [lastResult, setLastResult] = useState4(null);
+  const execute = useCallback4(async (entityId, params) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.ingestDocument(entityId, params);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiForget.ts
+import { useState as useState5, useCallback as useCallback5, useRef as useRef5 } from "react";
+function useWikiForget() {
+  const wiki = useWiki();
+  const wikiRef = useRef5(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState5(false);
+  const [error, setError] = useState5(null);
+  const [lastResult, setLastResult] = useState5(null);
+  const execute = useCallback5(async (entityId, params) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.forget(entityId, params);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiExport.ts
+import { useState as useState6, useCallback as useCallback6, useRef as useRef6 } from "react";
+function useWikiExport() {
+  const wiki = useWiki();
+  const wikiRef = useRef6(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState6(false);
+  const [error, setError] = useState6(null);
+  const [lastResult, setLastResult] = useState6(null);
+  const execute = useCallback6(async (entityIds) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.exportDump(entityIds);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
+
+// src/useWikiHasChanged.ts
+import { useState as useState7, useCallback as useCallback7, useRef as useRef7 } from "react";
+function useWikiHasChanged() {
+  const wiki = useWiki();
+  const wikiRef = useRef7(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState7(false);
+  const [error, setError] = useState7(null);
+  const [lastResult, setLastResult] = useState7(null);
+  const execute = useCallback7(
+    async (entityId, sourceRef, sourceHash) => {
+      setError(null);
+      setIsPending(true);
+      setLastResult(null);
+      try {
+        const result = await wikiRef.current.hasChanged(entityId, sourceRef, sourceHash);
+        setLastResult(result);
+        return result;
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    []
+  );
+  return { execute, lastResult, isPending, error };
+}
+export {
+  WikiProvider,
+  useMemoryRead,
+  useWiki,
+  useWikiExport,
+  useWikiForget,
+  useWikiHasChanged,
+  useWikiIngest,
+  useWikiMaintenance,
+  useWikiWrite
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"]}

package/dist/js.d.mts

@@ -0,0 +1,23 @@
+import { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
+export * from '@equationalapplications/core-llm-wiki';
+
+/**
+ * Vanilla-JS entry for @equationalapplications/react-llm-wiki.
+ * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory
+ * without bundling React or any hook code.
+ *
+ * Provides:
+ *   - All core exports (createWiki, WikiMemory, types, …)
+ *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods
+ */
+
+/**
+ * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.
+ */
+declare function read(wiki: WikiMemory, entityId: string, query: string): Promise<MemoryBundle>;
+/**
+ * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.
+ */
+declare function write(wiki: WikiMemory, entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
+
+export { read, write };

package/dist/js.d.ts

@@ -0,0 +1,23 @@
+import { WikiMemory, MemoryBundle, WikiEvent } from '@equationalapplications/core-llm-wiki';
+export * from '@equationalapplications/core-llm-wiki';
+
+/**
+ * Vanilla-JS entry for @equationalapplications/react-llm-wiki.
+ * Import from '@equationalapplications/react-llm-wiki/js' to use WikiMemory
+ * without bundling React or any hook code.
+ *
+ * Provides:
+ *   - All core exports (createWiki, WikiMemory, types, …)
+ *   - Standalone read() / write() helpers that wrap the WikiMemory instance methods
+ */
+
+/**
+ * Standalone read helper. Equivalent to `wiki.read(entityId, query)`.
+ */
+declare function read(wiki: WikiMemory, entityId: string, query: string): Promise<MemoryBundle>;
+/**
+ * Standalone write helper. Equivalent to `wiki.write(entityId, event)`.
+ */
+declare function write(wiki: WikiMemory, entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
+
+export { read, write };

package/dist/js.js

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/js.ts
+var js_exports = {};
+__export(js_exports, {
+  read: () => read,
+  write: () => write
+});
+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 write(wiki, entityId, event) {
+  return wiki.write(entityId, event);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  read,
+  write,
+  ...require("@equationalapplications/core-llm-wiki")
+});
+//# sourceMappingURL=js.js.map

package/dist/js.js.map

@@ -0,0 +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":[]}

package/dist/js.mjs

@@ -0,0 +1,13 @@
+// src/js.ts
+export * from "@equationalapplications/core-llm-wiki";
+function read(wiki, entityId, query) {
+  return wiki.read(entityId, query);
+}
+function write(wiki, entityId, event) {
+  return wiki.write(entityId, event);
+}
+export {
+  read,
+  write
+};
+//# sourceMappingURL=js.mjs.map

package/dist/js.mjs.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@equationalapplications/react-llm-wiki",
+  "version": "2.4.0",
+  "description": "React hooks and web utilities for LLM Wiki Memory.",
+  "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"
+    },
+    "./js": {
+      "types": "./dist/js.d.ts",
+      "import": "./dist/js.mjs",
+      "require": "./dist/js.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@equationalapplications/core-llm-wiki": "2.4.0"
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "happy-dom": "^20.9.0",
+    "jsdom": "^29.0.0",
+    "react": "19.2.5",
+    "react-dom": "19.2.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "4.1.5"
+  },
+  "scripts": {
+    "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:watch": "vitest"
+  }
+}