@revealui/ai 0.2.8 → 0.2.9

package/dist/memory/persistence/crdt-persistence.js

@@ -7,6 +7,9 @@
 import { randomUUID } from 'node:crypto';
 import { agentContexts, crdtOperations } from '@revealui/db/schema';
 import { and, eq, gte } from 'drizzle-orm';
+import { LWWRegister } from '../crdt/lww-register.js';
+import { ORSet } from '../crdt/or-set.js';
+import { PNCounter } from '../crdt/pn-counter.js';
 import { findAgentContextById } from '../utils/sql-helpers.js';
 // =============================================================================
 // CRDT Persistence
@@ -198,4 +201,68 @@ export class CRDTPersistence {
         }
         return result;
     }
+    /**
+     * Rebuilds CRDT state by replaying operations from the log.
+     *
+     * @param crdtId - CRDT instance identifier
+     * @param crdtType - Type of CRDT to rebuild
+     * @param nodeId - Node ID for the rebuilt CRDT
+     * @param since - Optional timestamp to replay from (defaults to 0 = all)
+     * @returns Rebuilt CRDT instance, or null if no operations found
+     */
+    async replayOperations(crdtId, crdtType, nodeId, since = 0) {
+        const operations = await this.getOperationsSince(crdtId, since);
+        if (operations.length === 0) {
+            return null;
+        }
+        if (crdtType === 'lww_register') {
+            const register = new LWWRegister(nodeId, null, 0);
+            for (const op of operations) {
+                if (op.operationType === 'set') {
+                    register.set(op.payload.value, op.timestamp);
+                }
+            }
+            return register;
+        }
+        if (crdtType === 'or_set') {
+            const set = new ORSet(nodeId);
+            for (const op of operations) {
+                if (op.operationType === 'add') {
+                    set.add(op.payload.value);
+                }
+                else if (op.operationType === 'remove' && typeof op.payload.tag === 'string') {
+                    set.remove(op.payload.tag);
+                }
+            }
+            return set;
+        }
+        if (crdtType === 'pn_counter') {
+            const counter = new PNCounter(nodeId);
+            for (const op of operations) {
+                if (op.operationType === 'increment') {
+                    counter.increment(typeof op.payload.delta === 'number' ? op.payload.delta : 1);
+                }
+                else if (op.operationType === 'decrement') {
+                    counter.decrement(typeof op.payload.delta === 'number' ? op.payload.delta : 1);
+                }
+            }
+            return counter;
+        }
+        return null;
+    }
+    /**
+     * Deletes operations older than a timestamp (for cleanup after compaction).
+     *
+     * @param crdtId - CRDT instance identifier
+     * @param before - Unix timestamp (milliseconds)  -  delete operations older than this
+     * @returns Number of operations deleted
+     */
+    async deleteOperationsBefore(crdtId, before) {
+        const { lt } = await import('drizzle-orm');
+        const result = await this.db
+            .delete(crdtOperations)
+            .where(and(eq(crdtOperations.crdtId, crdtId), lt(crdtOperations.timestamp, before)))
+            .returning();
+        return result.length;
+    }
 }

package/dist/memory/preferences/user-preferences-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-preferences-manager.d.ts","sourceRoot":"","sources":["../../../src/memory/preferences/user-preferences-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAe5E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,MAAM,CAAkD;IAEhE;;;;;;OAMG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ;IAcxD;;;;OAIG;IACH,cAAc,IAAI,eAAe;IAIjC;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAsB1D;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAUlD;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAgBnC;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAiChD;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB;IAM5D;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoF3B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+E3B;;;;OAIG;IACH,MAAM,IAAI,eAAe,CAAC,eAAe,CAAC;IAI1C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,eAAe,CAAC,eAAe,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,GACX,sBAAsB;IAMzB;;;;OAIG;IACH,KAAK,IAAI,sBAAsB;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}
+{"version":3,"file":"user-preferences-manager.d.ts","sourceRoot":"","sources":["../../../src/memory/preferences/user-preferences-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAe5E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,MAAM,CAAkD;IAEhE;;;;;;OAMG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ;IAcxD;;;;OAIG;IACH,cAAc,IAAI,eAAe;IAIjC;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAsB1D;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAUlD;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAkBnC;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAyChD;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB;IAM5D;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoF3B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+E3B;;;;OAIG;IACH,MAAM,IAAI,eAAe,CAAC,eAAe,CAAC;IAI1C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,eAAe,CAAC,eAAe,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,GACX,sBAAsB;IAMzB;;;;OAIG;IACH,KAAK,IAAI,sBAAsB;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

package/dist/memory/preferences/user-preferences-manager.js

@@ -114,7 +114,10 @@ export class UserPreferencesManager {
         const keys = key.split('.');
         let value = prefs;
         for (const k of keys) {
-            if (value && typeof value === 'object' && k in value) {
+            // Guard against prototype pollution reads
+            if (k === '__proto__' || k === 'constructor' || k === 'prototype')
+                return undefined;
+            if (value && typeof value === 'object' && Object.hasOwn(value, k)) {
                 value = value[k];
             }
             else {
@@ -138,6 +141,13 @@ export class UserPreferencesManager {
             throw new ValidationError(`Invalid preference key: "${key}"`);
         }
         const parentKeys = keys.slice(0, -1);
+        // Guard against prototype pollution
+        const ForbiddenKeys = new Set(['__proto__', 'constructor', 'prototype']);
+        for (const k of keys) {
+            if (ForbiddenKeys.has(k)) {
+                throw new ValidationError(`Forbidden preference key segment: "${k}"`);
+            }
+        }
         // Navigate to parent object in cloned structure
         let parent = prefs;
         for (const k of parentKeys) {

package/dist/memory/stores/episodic-memory.js

@@ -268,9 +268,9 @@ export class EpisodicMemory {
         }
         catch (error) {
             // Embedding generation failed (e.g. embedding service unavailable).
-            // Return empty results — do NOT fall back to getAll(), which would dump the
+            // Return empty results  -  do NOT fall back to getAll(), which would dump the
             // entire memory store into agent context regardless of relevance.
-            void (error instanceof Error ? error.message : String(error)); // Semantic search failed — return empty results
+            void (error instanceof Error ? error.message : String(error)); // Semantic search failed  -  return empty results
             return [];
         }
     }

package/dist/memory/stores/working-memory.d.ts

@@ -12,6 +12,7 @@ import type { AgentDefinition } from '@revealui/contracts/agents';
 import { type LWWRegisterData } from '../crdt/lww-register.js';
 import { type ORSetData } from '../crdt/or-set.js';
 import type { CRDTPersistence } from '../persistence/crdt-persistence.js';
+import type { SyncManager } from '../sync/sync-manager.js';
 export interface SessionState {
     status: 'active' | 'paused' | 'completed';
     focus?: {
@@ -56,19 +57,23 @@ export declare class WorkingMemory {
     private sessionId;
     private nodeId;
     private persistence?;
+    private syncManager?;
     /**
      * Creates a new WorkingMemory instance.
      *
      * @param sessionId - Unique session identifier
      * @param nodeId - Unique node identifier (for CRDT operations)
      * @param persistence - Optional persistence adapter
+     * @param syncManager - Optional sync manager for operation logging
      */
-    constructor(sessionId: string, nodeId: string, persistence?: CRDTPersistence);
+    constructor(sessionId: string, nodeId: string, persistence?: CRDTPersistence, syncManager?: SyncManager);
     /**
      * Sets the entire context object.
      *
      * @param context - Context data to set
      */
+    /** Logs a CRDT operation to the sync manager (fire-and-forget). */
+    private logOp;
     /**
      * Sets the entire context object.
      *
@@ -199,7 +204,7 @@ export declare class WorkingMemory {
      * @param persistence - Optional persistence adapter
      * @returns New WorkingMemory instance
      */
-    static fromData(data: WorkingMemoryData, persistence?: CRDTPersistence): WorkingMemory;
+    static fromData(data: WorkingMemoryData, persistence?: CRDTPersistence, syncManager?: SyncManager): WorkingMemory;
     /**
      * Creates a copy of this WorkingMemory.
      *

package/dist/memory/stores/working-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"working-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/working-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"working-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/working-memory.ts"],"names":[],"mappings":"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"}

package/dist/memory/stores/working-memory.js

@@ -36,17 +36,20 @@ export class WorkingMemory {
     sessionId;
     nodeId;
     persistence;
+    syncManager;
     /**
      * Creates a new WorkingMemory instance.
      *
      * @param sessionId - Unique session identifier
      * @param nodeId - Unique node identifier (for CRDT operations)
      * @param persistence - Optional persistence adapter
+     * @param syncManager - Optional sync manager for operation logging
      */
-    constructor(sessionId, nodeId, persistence) {
+    constructor(sessionId, nodeId, persistence, syncManager) {
         this.sessionId = sessionId;
         this.nodeId = nodeId;
         this.persistence = persistence;
+        this.syncManager = syncManager;
         // Initialize CRDTs
         this.context = new LWWRegister(nodeId, {});
         this.sessionState = new LWWRegister(nodeId, {
@@ -59,6 +62,13 @@ export class WorkingMemory {
      *
      * @param context - Context data to set
      */
+    /** Logs a CRDT operation to the sync manager (fire-and-forget). */
+    logOp(crdtType, operationType, payload) {
+        if (!this.syncManager)
+            return;
+        const crdtId = `working-memory:${this.sessionId}`;
+        void this.syncManager.logOperation(crdtId, crdtType, operationType, payload);
+    }
     /**
      * Sets the entire context object.
      *
@@ -72,6 +82,7 @@ export class WorkingMemory {
      */
     setContext(context) {
         this.context.set(context);
+        this.logOp('lww_register', 'set', { value: context, key: 'context' });
     }
     /**
      * Gets the current context.
@@ -89,10 +100,9 @@ export class WorkingMemory {
      */
     updateContext(updates) {
         const current = this.context.get();
-        this.context.set({
-            ...current,
-            ...updates,
-        });
+        const merged = { ...current, ...updates };
+        this.context.set(merged);
+        this.logOp('lww_register', 'set', { value: merged, key: 'context' });
     }
     /**
      * Gets a specific context value.
@@ -131,10 +141,9 @@ export class WorkingMemory {
      */
     setContextValue(key, value) {
         const current = this.context.get();
-        this.context.set({
-            ...current,
-            [key]: value,
-        });
+        const updated = { ...current, [key]: value };
+        this.context.set(updated);
+        this.logOp('lww_register', 'set', { value: updated, key: 'context' });
     }
     /**
      * Adds an agent to the active agents set.
@@ -143,7 +152,9 @@ export class WorkingMemory {
      * @returns Unique tag for this agent addition
      */
     addAgent(agent) {
-        return this.activeAgents.add(agent);
+        const tag = this.activeAgents.add(agent);
+        this.logOp('or_set', 'add', { value: agent, tag });
+        return tag;
     }
     /**
      * Removes an agent by tag.
@@ -152,7 +163,11 @@ export class WorkingMemory {
      * @returns true if agent was removed
      */
     removeAgent(tag) {
-        return this.activeAgents.remove(tag);
+        const removed = this.activeAgents.remove(tag);
+        if (removed) {
+            this.logOp('or_set', 'remove', { tag });
+        }
+        return removed;
     }
     /**
      * Removes an agent by ID (removes all instances).
@@ -201,10 +216,9 @@ export class WorkingMemory {
      */
     updateSessionState(state) {
         const current = this.sessionState.get();
-        this.sessionState.set({
-            ...current,
-            ...state,
-        });
+        const merged = { ...current, ...state };
+        this.sessionState.set(merged);
+        this.logOp('lww_register', 'set', { value: merged, key: 'sessionState' });
     }
     /**
      * Gets the current session state.
@@ -297,8 +311,8 @@ export class WorkingMemory {
      * @param persistence - Optional persistence adapter
      * @returns New WorkingMemory instance
      */
-    static fromData(data, persistence) {
-        const memory = new WorkingMemory(data.sessionId, data.nodeId, persistence);
+    static fromData(data, persistence, syncManager) {
+        const memory = new WorkingMemory(data.sessionId, data.nodeId, persistence, syncManager);
         memory.context = LWWRegister.fromData(data.context);
         memory.sessionState = LWWRegister.fromData(data.sessionState);
         memory.activeAgents = ORSet.fromData(data.activeAgents);

package/dist/memory/sync/index.d.ts

@@ -0,0 +1,2 @@
+export { type SyncDelta, SyncManager, type SyncResult, type SyncState } from './sync-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/memory/sync/index.js

@@ -0,0 +1 @@
+export { SyncManager } from './sync-manager.js';

package/dist/memory/sync/sync-manager.d.ts

@@ -0,0 +1,104 @@
+/**
+ * CRDT Sync Manager
+ *
+ * Coordinates state synchronization between distributed nodes.
+ * Supports both full-state merge and delta-based sync via the operation log.
+ *
+ * Architecture:
+ * - State-based sync: serialize → transfer → merge (simple, higher bandwidth)
+ * - Op-based sync: log ops → transfer deltas → replay (efficient, requires op log)
+ * - Anti-entropy: periodic full-state reconciliation to catch missed ops
+ *
+ * Transport-agnostic: the SyncManager produces/consumes serialized payloads.
+ * The actual transport (HTTP, WebSocket, message queue) is the caller's concern.
+ */
+import type { LWWRegisterData } from '../crdt/lww-register.js';
+import type { ORSetData } from '../crdt/or-set.js';
+import type { PNCounterData } from '../crdt/pn-counter.js';
+import type { CRDTOperationPayload, CRDTPersistence, CRDTType } from '../persistence/crdt-persistence.js';
+import type { WorkingMemory } from '../stores/working-memory.js';
+export interface SyncState {
+    /** CRDT instance identifier */
+    crdtId: string;
+    /** Node that produced this state */
+    sourceNodeId: string;
+    /** Timestamp of this state snapshot */
+    timestamp: number;
+    /** Serialized CRDT states (composite) */
+    states: Record<string, LWWRegisterData<unknown> | ORSetData<unknown> | PNCounterData>;
+}
+export interface SyncDelta {
+    /** CRDT instance identifier */
+    crdtId: string;
+    /** Node that produced these operations */
+    sourceNodeId: string;
+    /** Operations since last sync point */
+    operations: CRDTOperationPayload[];
+    /** Timestamp of the last synced operation (for next delta request) */
+    lastSyncTimestamp: number;
+}
+export interface SyncResult {
+    /** Whether state changed as a result of sync */
+    changed: boolean;
+    /** Number of operations applied */
+    operationsApplied: number;
+    /** Number of conflicts resolved */
+    conflictsResolved: number;
+    /** Timestamp to use for next delta sync */
+    syncTimestamp: number;
+}
+export declare class SyncManager {
+    private nodeId;
+    private persistence;
+    /** Tracks the last sync timestamp per remote node */
+    private syncPoints;
+    constructor(nodeId: string, persistence: CRDTPersistence);
+    /**
+     * Produces a full-state snapshot for transfer to another node.
+     * The receiving node calls `mergeRemoteState()` with this payload.
+     */
+    getLocalState(crdtId: string): Promise<SyncState>;
+    /**
+     * Merges a remote node's full state into local state.
+     * Uses CRDT merge semantics  -  order doesn't matter, result is deterministic.
+     *
+     * @returns WorkingMemory with merged state (caller decides whether to persist)
+     */
+    mergeRemoteWorkingMemory(local: WorkingMemory, remote: WorkingMemory): {
+        merged: WorkingMemory;
+        changed: boolean;
+    };
+    /**
+     * Produces a delta payload (operations since a timestamp) for efficient sync.
+     * The receiving node calls `applyDelta()` with this payload.
+     */
+    getDelta(crdtId: string, since: number): Promise<SyncDelta>;
+    /**
+     * Applies a delta from a remote node by replaying operations.
+     * Logs each remote operation locally for future delta requests from other nodes.
+     */
+    applyDelta(delta: SyncDelta): Promise<SyncResult>;
+    /**
+     * Logs a local operation to the persistence layer.
+     * Called by memory stores when they mutate CRDT state.
+     */
+    logOperation(crdtId: string, crdtType: CRDTType, operationType: CRDTOperationPayload['operationType'], payload: Record<string, unknown>): Promise<void>;
+    /**
+     * Gets the last sync timestamp for a remote node.
+     * Used to request only new operations on the next sync.
+     */
+    getSyncPoint(remoteNodeId: string): number;
+    /**
+     * Sets the sync point for a remote node (e.g., after initial full-state sync).
+     */
+    setSyncPoint(remoteNodeId: string, timestamp: number): void;
+    /**
+     * Gets all tracked sync points.
+     */
+    getAllSyncPoints(): Map<string, number>;
+    /**
+     * Gets this manager's node ID.
+     */
+    getNodeId(): string;
+}
+//# sourceMappingURL=sync-manager.d.ts.map

package/dist/memory/sync/sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/memory/sync/sync-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAkB;IACrC,qDAAqD;IACrD,OAAO,CAAC,UAAU,CAAkC;gBAExC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe;IAKxD;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBvD;;;;;OAKG;IACH,wBAAwB,CACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,aAAa,GACpB;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAgB9C;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAYjE;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBvD;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,oBAAoB,CAAC,eAAe,CAAC,EACpD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAWhB;;;OAGG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

package/dist/memory/sync/sync-manager.js

@@ -0,0 +1,137 @@
+/**
+ * CRDT Sync Manager
+ *
+ * Coordinates state synchronization between distributed nodes.
+ * Supports both full-state merge and delta-based sync via the operation log.
+ *
+ * Architecture:
+ * - State-based sync: serialize → transfer → merge (simple, higher bandwidth)
+ * - Op-based sync: log ops → transfer deltas → replay (efficient, requires op log)
+ * - Anti-entropy: periodic full-state reconciliation to catch missed ops
+ *
+ * Transport-agnostic: the SyncManager produces/consumes serialized payloads.
+ * The actual transport (HTTP, WebSocket, message queue) is the caller's concern.
+ */
+// =============================================================================
+// SyncManager
+// =============================================================================
+export class SyncManager {
+    nodeId;
+    persistence;
+    /** Tracks the last sync timestamp per remote node */
+    syncPoints = new Map();
+    constructor(nodeId, persistence) {
+        this.nodeId = nodeId;
+        this.persistence = persistence;
+    }
+    /**
+     * Produces a full-state snapshot for transfer to another node.
+     * The receiving node calls `mergeRemoteState()` with this payload.
+     */
+    async getLocalState(crdtId) {
+        const states = await this.persistence.loadCompositeState(crdtId);
+        const stateRecord = {};
+        for (const [key, data] of states) {
+            stateRecord[key] = data;
+        }
+        return {
+            crdtId,
+            sourceNodeId: this.nodeId,
+            timestamp: Date.now(),
+            states: stateRecord,
+        };
+    }
+    /**
+     * Merges a remote node's full state into local state.
+     * Uses CRDT merge semantics  -  order doesn't matter, result is deterministic.
+     *
+     * @returns WorkingMemory with merged state (caller decides whether to persist)
+     */
+    mergeRemoteWorkingMemory(local, remote) {
+        const localData = local.toData();
+        const remoteData = remote.toData();
+        // Quick equality check  -  if timestamps match, nothing changed
+        if (localData.context.timestamp === remoteData.context.timestamp &&
+            localData.sessionState.timestamp === remoteData.sessionState.timestamp) {
+            return { merged: local, changed: false };
+        }
+        const merged = local.merge(remote);
+        return { merged, changed: true };
+    }
+    /**
+     * Produces a delta payload (operations since a timestamp) for efficient sync.
+     * The receiving node calls `applyDelta()` with this payload.
+     */
+    async getDelta(crdtId, since) {
+        const operations = await this.persistence.getOperationsSince(crdtId, since);
+        return {
+            crdtId,
+            sourceNodeId: this.nodeId,
+            operations,
+            lastSyncTimestamp: operations.length > 0 ? (operations[operations.length - 1]?.timestamp ?? since) : since,
+        };
+    }
+    /**
+     * Applies a delta from a remote node by replaying operations.
+     * Logs each remote operation locally for future delta requests from other nodes.
+     */
+    async applyDelta(delta) {
+        let applied = 0;
+        for (const op of delta.operations) {
+            // Skip operations from our own node (already applied locally)
+            if (op.nodeId === this.nodeId) {
+                continue;
+            }
+            // Log the remote operation locally
+            await this.persistence.appendOperation(op);
+            applied++;
+        }
+        // Update sync point for this remote node
+        this.syncPoints.set(delta.sourceNodeId, delta.lastSyncTimestamp);
+        return {
+            changed: applied > 0,
+            operationsApplied: applied,
+            conflictsResolved: 0, // CRDTs resolve conflicts automatically
+            syncTimestamp: delta.lastSyncTimestamp,
+        };
+    }
+    /**
+     * Logs a local operation to the persistence layer.
+     * Called by memory stores when they mutate CRDT state.
+     */
+    async logOperation(crdtId, crdtType, operationType, payload) {
+        await this.persistence.appendOperation({
+            crdtId,
+            crdtType,
+            operationType,
+            payload,
+            nodeId: this.nodeId,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Gets the last sync timestamp for a remote node.
+     * Used to request only new operations on the next sync.
+     */
+    getSyncPoint(remoteNodeId) {
+        return this.syncPoints.get(remoteNodeId) ?? 0;
+    }
+    /**
+     * Sets the sync point for a remote node (e.g., after initial full-state sync).
+     */
+    setSyncPoint(remoteNodeId, timestamp) {
+        this.syncPoints.set(remoteNodeId, timestamp);
+    }
+    /**
+     * Gets all tracked sync points.
+     */
+    getAllSyncPoints() {
+        return new Map(this.syncPoints);
+    }
+    /**
+     * Gets this manager's node ID.
+     */
+    getNodeId() {
+        return this.nodeId;
+    }
+}

package/dist/memory/utils/validation.js

@@ -118,7 +118,7 @@ export function estimateObjectSize(obj) {
     const type = typeof obj;
     if (type === 'string') {
         // UTF-16 char units × 2 bytes each. This over-estimates multi-byte UTF-8 code
-        // points but is intentionally conservative — the limit stays tighter than the
+        // points but is intentionally conservative  -  the limit stays tighter than the
         // real in-process memory cost, which is what we want for a safety bound.
         return obj.length * 2 + 8;
     }

package/dist/memory/vector/vector-memory-service.d.ts

@@ -41,7 +41,7 @@ export declare class VectorMemoryService {
     /**
      * Search for similar memories using vector similarity.
      *
-     * @param queryEmbedding - Query embedding vector (768 dimensions — Ollama nomic-embed-text)
+     * @param queryEmbedding - Query embedding vector (768 dimensions  -  Ollama nomic-embed-text)
      * @param options - Search options (filtering, limits, etc.)
      * @returns Array of memories with similarity scores, sorted by similarity (highest first)
      *

package/dist/memory/vector/vector-memory-service.js

@@ -42,7 +42,7 @@ export class VectorMemoryService {
     /**
      * Search for similar memories using vector similarity.
      *
-     * @param queryEmbedding - Query embedding vector (768 dimensions — Ollama nomic-embed-text)
+     * @param queryEmbedding - Query embedding vector (768 dimensions  -  Ollama nomic-embed-text)
      * @param options - Search options (filtering, limits, etc.)
      * @returns Array of memories with similarity scores, sorted by similarity (highest first)
      *

package/dist/orchestration/agent.d.ts

@@ -22,7 +22,7 @@ export interface AgentConfig {
     webSearchProvider?: WebSearchProvider;
     /**
      * Capability tags used by AgentOrchestrator.findBestAgent() for routing.
-     * Example: ['cms', 'search', 'ticket', 'summarize']
+     * Example: ['admin', 'search', 'ticket', 'summarize']
      */
     capabilities?: string[];
 }
@@ -70,7 +70,7 @@ export interface Agent {
      */
     tools: Tool[];
     /**
-     * Memory system (optional — agents without memory skip episodic recall)
+     * Memory system (optional  -  agents without memory skip episodic recall)
      */
     memory?: EpisodicMemory;
     /**

package/dist/orchestration/defaults.d.ts

@@ -15,7 +15,7 @@ import type { Tool } from '../tools/base.js';
 export declare const WORKSPACE_AGENT_DEFAULT_TOOLS: Tool[];
 /**
  * Returns the workspace agent default tool set, optionally merged with
- * additional tools (e.g. CMS tools, MCP-discovered tools).
+ * additional tools (e.g. admin tools, MCP-discovered tools).
  */
 export declare function getWorkspaceAgentTools(additionalTools?: Tool[]): Tool[];
 //# sourceMappingURL=defaults.d.ts.map

package/dist/orchestration/defaults.js

@@ -15,7 +15,7 @@ import { webSearchTool } from '../tools/web/index.js';
 export const WORKSPACE_AGENT_DEFAULT_TOOLS = [webSearchTool];
 /**
  * Returns the workspace agent default tool set, optionally merged with
- * additional tools (e.g. CMS tools, MCP-discovered tools).
+ * additional tools (e.g. admin tools, MCP-discovered tools).
  */
 export function getWorkspaceAgentTools(additionalTools = []) {
     return [...WORKSPACE_AGENT_DEFAULT_TOOLS, ...additionalTools];

package/dist/orchestration/orchestrator.d.ts

@@ -51,11 +51,11 @@ export declare class AgentOrchestrator {
      * Find the best agent for a task.
      *
      * Routing priority:
-     * 1. Capability intersection — agent whose AgentConfig.capabilities overlaps
+     * 1. Capability intersection  -  agent whose AgentConfig.capabilities overlaps
      *    with task.requiredCapabilities (highest-overlap agent wins)
-     * 2. Tool-name substring match — agent has a tool whose name includes the
+     * 2. Tool-name substring match  -  agent has a tool whose name includes the
      *    task type string (legacy fallback)
-     * 3. First registered agent — last-resort fallback
+     * 3. First registered agent  -  last-resort fallback
      */
     private findBestAgent;
     /**