@equationalapplications/core-llm-wiki 4.8.0 → 4.10.1

package/dist/{testing-hfpeX01Q.d.mts → testing-CDIDE4Jd.d.mts}

@@ -52,6 +52,12 @@ interface WikiConfig {
     hybridWeight?: number;
     /** Global prompt overrides for text generation calls (`ingestDocument`, `runLibrarian`, `runHeal`). Does not affect embedding generation. Runtime overrides on individual method calls take precedence. */
     prompts?: PromptOverrides;
+    /**
+     * When true, entry and task mutations append an event to the internal outbox table.
+     * The table is always created; this flag only controls whether writes occur.
+     * @default false
+     */
+    enableOutbox?: boolean;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -363,6 +369,16 @@ declare class PrunePartialFailureError extends Error {
 }
 declare const HOOK_TIMEOUT_MARKER: unique symbol;
 
+interface WikiOutboxEvent<T = unknown> {
+    id: string;
+    entity_id: string;
+    table_name: string;
+    record_id: string;
+    operation: 'INSERT' | 'UPDATE' | 'DELETE';
+    payload: T;
+    created_at: number;
+}
+
 /**
  * Abstract base for all repositories.
  * Provides db accessor + prefix-aware helpers.
@@ -379,8 +395,11 @@ declare abstract class BaseRepository {
 }
 
 declare class OutboxRepository extends BaseRepository {
+    private enableOutbox;
+    constructor(db: SQLiteAdapter, prefix: string, enableOutbox?: boolean);
     /**
      * Insert a new outbox event within the provided transaction.
+     * No-op when enableOutbox is false.
      * `tx` is required — callers must always pass the active transaction
      * so the write is atomic with the main table mutation.
      */
@@ -392,7 +411,7 @@ declare class OutboxRepository extends BaseRepository {
         payload: any;
     }, tx: SQLiteAdapter): Promise<void>;
     /**
-     * Fetch pending outbox rows ordered by created_at ASC.
+     * Fetch pending outbox rows ordered by created_at ASC, rowid ASC.
      * Reads directly from `this.db` (not a transaction).
      */
     fetchPending(limit?: number): Promise<any[]>;
@@ -1107,6 +1126,16 @@ declare class WikiMemory {
         truncated: boolean;
         chunks: number;
     }>;
+    /**
+     * Returns up to `limit` unprocessed outbox events, oldest first.
+     * Works regardless of enableOutbox value — allows draining after disabling.
+     */
+    getUnprocessedOutboxEvents(limit?: number): Promise<WikiOutboxEvent[]>;
+    /**
+     * Deletes the given event IDs from the outbox table.
+     * Call after successfully committing events to the external system.
+     */
+    markOutboxEventsProcessed(eventIds: string[]): Promise<void>;
 }
 
-export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiTask as r, EmbeddingService as s, IngestionService as t, MaintenanceService as u, RetrievalService as v, SearchService as w, WriteService as x };
+export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiOutboxEvent as r, type WikiTask as s, EmbeddingService as t, IngestionService as u, MaintenanceService as v, RetrievalService as w, SearchService as x, WriteService as y };

package/dist/{testing-hfpeX01Q.d.ts → testing-CDIDE4Jd.d.ts}

@@ -52,6 +52,12 @@ interface WikiConfig {
     hybridWeight?: number;
     /** Global prompt overrides for text generation calls (`ingestDocument`, `runLibrarian`, `runHeal`). Does not affect embedding generation. Runtime overrides on individual method calls take precedence. */
     prompts?: PromptOverrides;
+    /**
+     * When true, entry and task mutations append an event to the internal outbox table.
+     * The table is always created; this flag only controls whether writes occur.
+     * @default false
+     */
+    enableOutbox?: boolean;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -363,6 +369,16 @@ declare class PrunePartialFailureError extends Error {
 }
 declare const HOOK_TIMEOUT_MARKER: unique symbol;
 
+interface WikiOutboxEvent<T = unknown> {
+    id: string;
+    entity_id: string;
+    table_name: string;
+    record_id: string;
+    operation: 'INSERT' | 'UPDATE' | 'DELETE';
+    payload: T;
+    created_at: number;
+}
+
 /**
  * Abstract base for all repositories.
  * Provides db accessor + prefix-aware helpers.
@@ -379,8 +395,11 @@ declare abstract class BaseRepository {
 }
 
 declare class OutboxRepository extends BaseRepository {
+    private enableOutbox;
+    constructor(db: SQLiteAdapter, prefix: string, enableOutbox?: boolean);
     /**
      * Insert a new outbox event within the provided transaction.
+     * No-op when enableOutbox is false.
      * `tx` is required — callers must always pass the active transaction
      * so the write is atomic with the main table mutation.
      */
@@ -392,7 +411,7 @@ declare class OutboxRepository extends BaseRepository {
         payload: any;
     }, tx: SQLiteAdapter): Promise<void>;
     /**
-     * Fetch pending outbox rows ordered by created_at ASC.
+     * Fetch pending outbox rows ordered by created_at ASC, rowid ASC.
      * Reads directly from `this.db` (not a transaction).
      */
     fetchPending(limit?: number): Promise<any[]>;
@@ -1107,6 +1126,16 @@ declare class WikiMemory {
         truncated: boolean;
         chunks: number;
     }>;
+    /**
+     * Returns up to `limit` unprocessed outbox events, oldest first.
+     * Works regardless of enableOutbox value — allows draining after disabling.
+     */
+    getUnprocessedOutboxEvents(limit?: number): Promise<WikiOutboxEvent[]>;
+    /**
+     * Deletes the given event IDs from the outbox table.
+     * Call after successfully committing events to the external system.
+     */
+    markOutboxEventsProcessed(eventIds: string[]): Promise<void>;
 }
 
-export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiTask as r, EmbeddingService as s, IngestionService as t, MaintenanceService as u, RetrievalService as v, SearchService as w, WriteService as x };
+export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiOutboxEvent as r, type WikiTask as s, EmbeddingService as t, IngestionService as u, MaintenanceService as v, RetrievalService as w, SearchService as x, WriteService as y };

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-export { s as EmbeddingService, I as ImportExportService, t as IngestionService, J as JobManager, J as JobManagerType, u as MaintenanceService, v as RetrievalService, w as SearchService, w as SearchServiceType, q as WikiMemoryTestAccess, x as WriteService } from './testing-hfpeX01Q.mjs';
+export { t as EmbeddingService, I as ImportExportService, u as IngestionService, J as JobManager, J as JobManagerType, v as MaintenanceService, w as RetrievalService, x as SearchService, x as SearchServiceType, q as WikiMemoryTestAccess, y as WriteService } from './testing-CDIDE4Jd.mjs';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,2 +1,2 @@
-export { s as EmbeddingService, I as ImportExportService, t as IngestionService, J as JobManager, J as JobManagerType, u as MaintenanceService, v as RetrievalService, w as SearchService, w as SearchServiceType, q as WikiMemoryTestAccess, x as WriteService } from './testing-hfpeX01Q.js';
+export { t as EmbeddingService, I as ImportExportService, u as IngestionService, J as JobManager, J as JobManagerType, v as MaintenanceService, w as RetrievalService, x as SearchService, x as SearchServiceType, q as WikiMemoryTestAccess, y as WriteService } from './testing-CDIDE4Jd.js';
 import 'minisearch';