@equationalapplications/expo-llm-wiki 2.2.0 → 2.4.0

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type * as SQLite from 'expo-sqlite';\nimport { WikiMemory, type WikiOptions } from '@equationalapplications/core-llm-wiki';\nimport { createExpoAdapter } from './adapter';\n\n// Re-exports all core types and utilities. The `createWiki` exported below\n// intentionally shadows the one from @equationalapplications/core-llm-wiki, binding the expo-sqlite adapter.\nexport * from '@equationalapplications/core-llm-wiki';\nexport * from '@equationalapplications/react-llm-wiki';\n\nexport function createWiki(db: SQLite.SQLiteDatabase, options: WikiOptions): WikiMemory {\n  return new WikiMemory(createExpoAdapter(db), options);\n}\n"],"mappings":";;;;;AACA,SAAS,kBAAoC;AAK7C,cAAc;AACd,cAAc;AAEP,SAAS,WAAW,IAA2B,SAAkC;AACtF,SAAO,IAAI,WAAW,kBAAkB,EAAE,GAAG,OAAO;AACtD;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@equationalapplications/expo-llm-wiki",
-  "version": "2.2.0",
-  "description": "A standalone, general-purpose React Native/Expo package for LLM Wiki Memory.",
+  "version": "2.4.0",
+  "description": "Expo/React Native adapter for @equationalapplications/core-llm-wiki.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -11,67 +11,40 @@
       "require": "./dist/index.js",
       "import": "./dist/index.mjs"
     },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "require": "./dist/react/index.js",
-      "import": "./dist/react/index.mjs"
+    "./factory": {
+      "types": "./dist/factory.d.ts",
+      "require": "./dist/factory.js",
+      "import": "./dist/factory.mjs"
     }
   },
-  "scripts": {
-    "build": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react",
-    "dev": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "files": [
     "dist",
     "LICENSE",
     "README.md"
   ],
-  "keywords": [
-    "expo",
-    "react-native",
-    "llm",
-    "memory",
-    "sqlite",
-    "fts5"
-  ],
-  "author": "",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "dependencies": {
+    "@equationalapplications/core-llm-wiki": "2.4.0",
+    "@equationalapplications/react-llm-wiki": "2.4.0"
+  },
   "peerDependencies": {
     "expo-sqlite": "^14.0.0 || ^15.0.0 || ^55.0.0",
     "react": ">=17"
   },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=20"
-  },
   "devDependencies": {
-    "@semantic-release/changelog": "^6.0.0",
-    "@semantic-release/git": "^10.0.0",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.0.0",
-    "@types/react": "^19.0.0",
-    "@vitest/coverage-v8": "^4.1.5",
-    "better-sqlite3": "^12.9.0",
-    "expo-sqlite": "^55.0.15",
-    "react": "19.2.0",
-    "semantic-release": "^24.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^4.1.5"
+    "typescript": "^5.4.0",
+    "vitest": "4.1.5"
   },
-  "dependencies": {
-    "expo": "^55.0.18",
-    "react-native": "0.83.6"
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/dist/WikiMemory-CjlQ68X0.d.mts

@@ -1,180 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    pruneRetainSoftDeletedFor?: number;
-    autoLibrarianThreshold?: number;
-    autoHealThreshold?: number;
-    orphanAfterDays?: number | null;
-    staleInferredAfterDays?: number | null;
-    maxChunkLength?: number;
-    chunkOverlap?: number;
-    chunkConcurrency?: number;
-    /**
-     * Static caller-supplied synonym expansions applied at query time.
-     * Keys must match the same normalization pipeline used by query formatting:
-     * the query is lowercased, stripped to `[a-z0-9 ]`, split into tokens, and
-     * only tokens with length >= 3 are considered for synonym lookup.
-     * Values are appended to the FTS5 query token list (multi-word values are
-     * split into tokens), then deduped and sliced to 12.
-     */
-    synonymMap?: Record<string, string[]>;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-interface MemoryDump {
-    generatedAt: number;
-    entities: Record<string, MemoryBundle>;
-}
-interface FormattedMemoryDump {
-    manifest: string;
-    files: Array<{
-        name: string;
-        content: string;
-    }>;
-}
-interface FormatContextOptions {
-    format?: 'markdown' | 'plain';
-    maxFacts?: number;
-    maxTasks?: number;
-    maxEvents?: number;
-    includeConfidence?: boolean;
-    includeTags?: boolean;
-    factWeights?: {
-        confidence?: number;
-        accessCount?: number;
-        recency?: number;
-    };
-}
-interface EntityStatus {
-    ingesting: boolean;
-    librarian: boolean;
-    heal: boolean;
-}
-declare class WikiBusyError extends Error {
-    readonly operation: 'ingest' | 'librarian' | 'heal' | 'prune';
-    readonly entityId: string;
-    constructor(operation: 'ingest' | 'librarian' | 'heal' | 'prune', entityId: string);
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    private activeMaintenanceJobs;
-    private activeIngestJobs;
-    private _librarianKey;
-    private _healKey;
-    private _warnCrossEntityCollision;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    getMemoryBundle(entityId: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    private runLibrarianThenMaybeHeal;
-    private _doRunLibrarian;
-    private _doRunHeal;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    getEntityStatus(entityId: string): EntityStatus;
-    private _getFullBundle;
-    exportDump(entityIds?: string[]): Promise<MemoryDump>;
-    importDump(dump: MemoryDump, opts?: {
-        merge?: boolean;
-    }): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        sourceHash?: string;
-        clearAll?: boolean;
-    }): Promise<{
-        deleted: {
-            entries: number;
-            tasks: number;
-        };
-    }>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-        maxChunkLength?: number;
-        chunkOverlap?: number;
-        chunkConcurrency?: number;
-    }): Promise<{
-        truncated: boolean;
-        chunks: number;
-    }>;
-}
-
-export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type FormatContextOptions as d, type MemoryBundle as e, WikiBusyError as f, type WikiCheckpoint as g, type WikiConfig as h, type WikiEvent as i, type WikiFact as j, type WikiTask as k };

package/dist/WikiMemory-CjlQ68X0.d.ts

@@ -1,180 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    pruneRetainSoftDeletedFor?: number;
-    autoLibrarianThreshold?: number;
-    autoHealThreshold?: number;
-    orphanAfterDays?: number | null;
-    staleInferredAfterDays?: number | null;
-    maxChunkLength?: number;
-    chunkOverlap?: number;
-    chunkConcurrency?: number;
-    /**
-     * Static caller-supplied synonym expansions applied at query time.
-     * Keys must match the same normalization pipeline used by query formatting:
-     * the query is lowercased, stripped to `[a-z0-9 ]`, split into tokens, and
-     * only tokens with length >= 3 are considered for synonym lookup.
-     * Values are appended to the FTS5 query token list (multi-word values are
-     * split into tokens), then deduped and sliced to 12.
-     */
-    synonymMap?: Record<string, string[]>;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-interface MemoryDump {
-    generatedAt: number;
-    entities: Record<string, MemoryBundle>;
-}
-interface FormattedMemoryDump {
-    manifest: string;
-    files: Array<{
-        name: string;
-        content: string;
-    }>;
-}
-interface FormatContextOptions {
-    format?: 'markdown' | 'plain';
-    maxFacts?: number;
-    maxTasks?: number;
-    maxEvents?: number;
-    includeConfidence?: boolean;
-    includeTags?: boolean;
-    factWeights?: {
-        confidence?: number;
-        accessCount?: number;
-        recency?: number;
-    };
-}
-interface EntityStatus {
-    ingesting: boolean;
-    librarian: boolean;
-    heal: boolean;
-}
-declare class WikiBusyError extends Error {
-    readonly operation: 'ingest' | 'librarian' | 'heal' | 'prune';
-    readonly entityId: string;
-    constructor(operation: 'ingest' | 'librarian' | 'heal' | 'prune', entityId: string);
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    private activeMaintenanceJobs;
-    private activeIngestJobs;
-    private _librarianKey;
-    private _healKey;
-    private _warnCrossEntityCollision;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    getMemoryBundle(entityId: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    private runLibrarianThenMaybeHeal;
-    private _doRunLibrarian;
-    private _doRunHeal;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    getEntityStatus(entityId: string): EntityStatus;
-    private _getFullBundle;
-    exportDump(entityIds?: string[]): Promise<MemoryDump>;
-    importDump(dump: MemoryDump, opts?: {
-        merge?: boolean;
-    }): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        sourceHash?: string;
-        clearAll?: boolean;
-    }): Promise<{
-        deleted: {
-            entries: number;
-            tasks: number;
-        };
-    }>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-        maxChunkLength?: number;
-        chunkOverlap?: number;
-        chunkConcurrency?: number;
-    }): Promise<{
-        truncated: boolean;
-        chunks: number;
-    }>;
-}
-
-export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type FormatContextOptions as d, type MemoryBundle as e, WikiBusyError as f, type WikiCheckpoint as g, type WikiConfig as h, type WikiEvent as i, type WikiFact as j, type WikiTask as k };

package/dist/react/index.d.mts

@@ -1,79 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { a as WikiMemory, e as MemoryBundle, i as WikiEvent, M as MemoryDump } from '../WikiMemory-CjlQ68X0.mjs';
-import 'expo-sqlite';
-
-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;
-};
-
-declare function useWikiMaintenance(): {
-    runLibrarian: (entityId: string) => Promise<void>;
-    runHeal: (entityId: string) => Promise<void>;
-    lastResult: void | 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;
-};
-
-export { WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };

package/dist/react/index.d.ts

@@ -1,79 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { a as WikiMemory, e as MemoryBundle, i as WikiEvent, M as MemoryDump } from '../WikiMemory-CjlQ68X0.js';
-import 'expo-sqlite';
-
-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;
-};
-
-declare function useWikiMaintenance(): {
-    runLibrarian: (entityId: string) => Promise<void>;
-    runHeal: (entityId: string) => Promise<void>;
-    lastResult: void | 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;
-};
-
-export { WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };