agentdb 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/src/backends/rvf/FederatedSessionManager.d.ts

@@ -0,0 +1,211 @@
+/**
+ * FederatedSessionManager - Cross-Session Federated Learning for AgentDB
+ *
+ * Wraps @ruvector/ruvllm's EphemeralAgent + FederatedCoordinator to provide:
+ * - Agent-scoped trajectory recording per session
+ * - Federated aggregation across all agent sessions
+ * - Warm-start pattern loading for new sessions
+ * - LoRA adapter management for task-specific fine-tuning
+ * - Continual learning pipeline with EWC++ protection
+ *
+ * Architecture:
+ *   Session 1 → EphemeralAgent → aggregate() → FederatedCoordinator → getInitialPatterns()
+ *   Session 2 → EphemeralAgent → aggregate() ↗                      → warm-start new sessions
+ *   Session N → EphemeralAgent → aggregate() ↗
+ *
+ * Security:
+ * - Operates on embeddings only (no user text stored in trajectories)
+ * - Agent IDs validated (length, format)
+ * - Dimension bounded (1-4096)
+ * - Max agents bounded (1-1000)
+ * - Quality scores clamped to [0, 1]
+ * - LoRA rank bounded (1-64)
+ * - Trajectory state is serializable JSON (no executable code)
+ */
+/** Configuration for the federated session manager */
+export interface FederatedConfig {
+    /** Embedding dimension (must match across all sessions) */
+    dimension: number;
+    /** Maximum number of concurrent agents (default: 100) */
+    maxAgents?: number;
+    /** Quality threshold for pattern inclusion (default: 0.4) */
+    qualityThreshold?: number;
+    /** Number of trajectories before auto-consolidation (default: 50) */
+    consolidationInterval?: number;
+    /** LoRA rank for adapter fine-tuning (default: 4) */
+    loraRank?: number;
+    /** LoRA alpha scaling (default: 8) */
+    loraAlpha?: number;
+    /** EWC lambda for catastrophic forgetting prevention (default: 100) */
+    ewcLambda?: number;
+}
+/** Exported session state for persistence */
+export interface SessionState {
+    agentId: string;
+    trajectories: TrajectoryRecord[];
+    stats: SessionStats;
+    sessionDurationMs: number;
+    timestamp: string;
+}
+/** Individual trajectory record */
+export interface TrajectoryRecord {
+    embedding: number[];
+    quality: number;
+    route?: string;
+    context?: string[];
+    timestamp: number;
+}
+/** Session statistics */
+export interface SessionStats {
+    trajectoryCount: number;
+    avgQuality: number;
+    patternsLearned: number;
+    sessionDurationMs: number;
+}
+/** Federated coordinator statistics */
+export interface FederatedStats {
+    totalAgents: number;
+    totalTrajectories: number;
+    patternsLearned: number;
+    avgQuality: number;
+    qualityThreshold: number;
+    contributions: Record<string, number>;
+}
+/** Learned pattern from federated aggregation */
+export interface FederatedPattern {
+    id: string;
+    type: string;
+    embedding: number[];
+    successRate: number;
+    useCount: number;
+    lastUsed: string;
+}
+/**
+ * FederatedSessionManager - Orchestrates cross-session federated learning
+ */
+export declare class FederatedSessionManager {
+    private coordinator;
+    private activeSessions;
+    private loraManager;
+    private dim;
+    private config;
+    private _destroyed;
+    private constructor();
+    /**
+     * Create a new federated session manager.
+     * Lazy-loads @ruvector/ruvllm to avoid hard dependency.
+     */
+    static create(config: FederatedConfig): Promise<FederatedSessionManager>;
+    /**
+     * Check if @ruvector/ruvllm is available.
+     */
+    static isAvailable(): Promise<boolean>;
+    /**
+     * Begin a new agent session.
+     * Returns a session handle for recording trajectories.
+     *
+     * @param agentId - Unique identifier for this agent session
+     * @param warmStart - Whether to load initial patterns from coordinator (default: true)
+     */
+    beginSession(agentId: string, warmStart?: boolean): Promise<SessionHandle>;
+    /**
+     * End a session, aggregate its trajectories, and clean up.
+     *
+     * @param agentId - The agent session to end
+     * @returns Session statistics
+     */
+    endSession(agentId: string): SessionStats;
+    /**
+     * Export a session's state for persistence.
+     * The state can be re-imported in a future session.
+     */
+    exportSession(agentId: string): SessionState;
+    /**
+     * Force consolidation across all aggregated agent data.
+     * Useful for periodic maintenance (e.g., NightlyLearner).
+     */
+    consolidate(): void;
+    /**
+     * Get warm-start patterns for a new session.
+     */
+    getInitialPatterns(k?: number): FederatedPattern[];
+    /**
+     * Find patterns similar to a query embedding.
+     */
+    findPatterns(query: number[], k?: number): FederatedPattern[];
+    /**
+     * Apply the global LoRA transformation to an embedding.
+     */
+    applyLora(embedding: number[]): number[];
+    /**
+     * Create a task-specific LoRA adapter.
+     */
+    createAdapter(name: string, rank?: number): void;
+    /**
+     * Activate a specific LoRA adapter.
+     */
+    activateAdapter(name: string): void;
+    /**
+     * List all registered LoRA adapters.
+     */
+    listAdapters(): string[];
+    /**
+     * Get federated coordinator statistics.
+     */
+    getStats(): FederatedStats;
+    /** Get the number of active sessions */
+    get activeSessionCount(): number;
+    /** Get the configured dimension */
+    get dimension(): number;
+    /** Check if destroyed */
+    get isDestroyed(): boolean;
+    /** Destroy the manager and all active sessions */
+    destroy(): void;
+    /** @internal Record a trajectory from a session handle */
+    _recordTrajectory(agent: any, embedding: number[], quality: number, route?: string): void;
+    private validateAgentId;
+    private ensureAlive;
+}
+/**
+ * SessionHandle - Lightweight handle for recording trajectories within a session
+ */
+export declare class SessionHandle {
+    private agentId;
+    private agent;
+    private manager;
+    private _initialPatterns;
+    private _dim;
+    private _ended;
+    /** @internal */
+    constructor(agentId: string, agent: any, manager: FederatedSessionManager, initialPatterns: FederatedPattern[], dim: number);
+    /**
+     * Record a trajectory (embedding + quality score).
+     *
+     * @param embedding - The query/action embedding
+     * @param quality - Quality score in [0.0, 1.0]
+     * @param route - Optional route label (e.g., "math", "code")
+     */
+    recordTrajectory(embedding: number[] | Float32Array, quality: number, route?: string): void;
+    /**
+     * Get patterns learned during this session.
+     */
+    getPatterns(k?: number): FederatedPattern[];
+    /**
+     * Get the initial warm-start patterns loaded at session start.
+     */
+    get initialPatterns(): FederatedPattern[];
+    /**
+     * Get current session statistics.
+     */
+    getStats(): SessionStats;
+    /**
+     * End this session and aggregate into the coordinator.
+     */
+    end(): SessionStats;
+    /** The agent ID for this session */
+    get id(): string;
+    /** Whether this session has been ended */
+    get isEnded(): boolean;
+    private ensureActive;
+}
+//# sourceMappingURL=FederatedSessionManager.d.ts.map

package/dist/src/backends/rvf/FederatedSessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FederatedSessionManager.d.ts","sourceRoot":"","sources":["../../../../src/backends/rvf/FederatedSessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;GAEG;AACH,qBAAa,uBAAuB;IAElC,OAAO,CAAC,WAAW,CAAa;IAEhC,OAAO,CAAC,cAAc,CAA0B;IAEhD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAKP;;;OAGG;WACU,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmD9E;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BtF;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA+BzC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAS5C;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,kBAAkB,CAAC,CAAC,GAAE,MAAW,GAAG,gBAAgB,EAAE;IAMtD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,GAAE,MAAU,GAAG,gBAAgB,EAAE;IAShE;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAQxC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAahD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMnC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAKxB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAqB1B,wCAAwC;IACxC,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,mCAAmC;IACnC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,yBAAyB;IACzB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,kDAAkD;IAClD,OAAO,IAAI,IAAI;IAiBf,0DAA0D;IAC1D,iBAAiB,CAEf,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IASP,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IAEvB,gBAAgB;gBAEd,OAAO,EAAE,MAAM,EAEf,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,uBAAuB,EAChC,eAAe,EAAE,gBAAgB,EAAE,EACnC,GAAG,EAAE,MAAM;IASb;;;;;;OAMG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAS3F;;OAEG;IACH,WAAW,CAAC,CAAC,GAAE,MAAW,GAAG,gBAAgB,EAAE;IAM/C;;OAEG;IACH,IAAI,eAAe,IAAI,gBAAgB,EAAE,CAExC;IAED;;OAEG;IACH,QAAQ,IAAI,YAAY;IAUxB;;OAEG;IACH,GAAG,IAAI,YAAY;IAMnB,oCAAoC;IACpC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,0CAA0C;IAC1C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,YAAY;CAKrB"}

package/dist/src/backends/rvf/FederatedSessionManager.js

@@ -0,0 +1,389 @@
+/**
+ * FederatedSessionManager - Cross-Session Federated Learning for AgentDB
+ *
+ * Wraps @ruvector/ruvllm's EphemeralAgent + FederatedCoordinator to provide:
+ * - Agent-scoped trajectory recording per session
+ * - Federated aggregation across all agent sessions
+ * - Warm-start pattern loading for new sessions
+ * - LoRA adapter management for task-specific fine-tuning
+ * - Continual learning pipeline with EWC++ protection
+ *
+ * Architecture:
+ *   Session 1 → EphemeralAgent → aggregate() → FederatedCoordinator → getInitialPatterns()
+ *   Session 2 → EphemeralAgent → aggregate() ↗                      → warm-start new sessions
+ *   Session N → EphemeralAgent → aggregate() ↗
+ *
+ * Security:
+ * - Operates on embeddings only (no user text stored in trajectories)
+ * - Agent IDs validated (length, format)
+ * - Dimension bounded (1-4096)
+ * - Max agents bounded (1-1000)
+ * - Quality scores clamped to [0, 1]
+ * - LoRA rank bounded (1-64)
+ * - Trajectory state is serializable JSON (no executable code)
+ */
+// Bounds
+const MAX_DIMENSION = 4096;
+const MAX_AGENTS = 1000;
+const MAX_LORA_RANK = 64;
+const MAX_AGENT_ID_LENGTH = 256;
+const MAX_PATTERNS_K = 100;
+/**
+ * FederatedSessionManager - Orchestrates cross-session federated learning
+ */
+export class FederatedSessionManager {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    coordinator = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    activeSessions = new Map();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    loraManager = null;
+    dim;
+    config;
+    _destroyed = false;
+    constructor(config) {
+        this.dim = config.dimension;
+        this.config = config;
+    }
+    /**
+     * Create a new federated session manager.
+     * Lazy-loads @ruvector/ruvllm to avoid hard dependency.
+     */
+    static async create(config) {
+        if (!Number.isFinite(config.dimension) || config.dimension < 1 || config.dimension > MAX_DIMENSION) {
+            throw new Error(`dimension must be between 1 and ${MAX_DIMENSION}`);
+        }
+        const instance = new FederatedSessionManager(config);
+        const maxAgents = Math.min(Math.max(1, config.maxAgents ?? 100), MAX_AGENTS);
+        const loraRank = Math.min(Math.max(1, config.loraRank ?? 4), MAX_LORA_RANK);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const ruvllm = await import('@ruvector/ruvllm');
+            instance.coordinator = new ruvllm.FederatedCoordinator({
+                dimension: config.dimension,
+                maxAgents,
+            });
+            if (config.qualityThreshold !== undefined) {
+                instance.coordinator.setQualityThreshold(Math.min(Math.max(0, config.qualityThreshold), 1));
+            }
+            if (config.consolidationInterval !== undefined) {
+                instance.coordinator.setConsolidationInterval(Math.max(1, config.consolidationInterval));
+            }
+            // Initialize LoRA manager for task-specific adapters
+            instance.loraManager = new ruvllm.LoraManager();
+            // Create a default adapter
+            instance.loraManager.create('default', {
+                inputDim: config.dimension,
+                outputDim: config.dimension,
+                rank: loraRank,
+                alpha: config.loraAlpha ?? loraRank * 2,
+            });
+            instance.loraManager.activate('default');
+        }
+        catch (error) {
+            throw new Error(`Federated session manager initialization failed.\n` +
+                `Install with: npm install @ruvector/ruvllm\n` +
+                `Error: ${error.message}`);
+        }
+        return instance;
+    }
+    /**
+     * Check if @ruvector/ruvllm is available.
+     */
+    static async isAvailable() {
+        try {
+            await import('@ruvector/ruvllm');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Begin a new agent session.
+     * Returns a session handle for recording trajectories.
+     *
+     * @param agentId - Unique identifier for this agent session
+     * @param warmStart - Whether to load initial patterns from coordinator (default: true)
+     */
+    async beginSession(agentId, warmStart = true) {
+        this.ensureAlive();
+        this.validateAgentId(agentId);
+        if (this.activeSessions.has(agentId)) {
+            throw new Error(`Session already active for agent: ${agentId}`);
+        }
+        const agent = this.coordinator.createAgent(agentId);
+        this.activeSessions.set(agentId, agent);
+        // Warm-start with coordinator patterns
+        let initialPatterns = [];
+        if (warmStart) {
+            initialPatterns = this.coordinator.getInitialPatterns(10);
+        }
+        return new SessionHandle(agentId, agent, this, initialPatterns, this.dim);
+    }
+    /**
+     * End a session, aggregate its trajectories, and clean up.
+     *
+     * @param agentId - The agent session to end
+     * @returns Session statistics
+     */
+    endSession(agentId) {
+        this.ensureAlive();
+        const agent = this.activeSessions.get(agentId);
+        if (!agent) {
+            throw new Error(`No active session for agent: ${agentId}`);
+        }
+        // Force learn to extract patterns
+        agent.forceLearn();
+        // Aggregate into coordinator
+        this.coordinator.aggregate(agent);
+        // Extract stats before cleanup
+        const stats = {
+            trajectoryCount: agent.trajectoryCount(),
+            avgQuality: agent.avgQuality() || 0,
+            patternsLearned: agent.getPatterns(MAX_PATTERNS_K).length,
+            sessionDurationMs: agent.uptimeSeconds() * 1000,
+        };
+        this.activeSessions.delete(agentId);
+        // Auto-consolidate if coordinator says it's time
+        if (this.coordinator.shouldConsolidate()) {
+            this.coordinator.forceConsolidate();
+        }
+        return stats;
+    }
+    /**
+     * Export a session's state for persistence.
+     * The state can be re-imported in a future session.
+     */
+    exportSession(agentId) {
+        this.ensureAlive();
+        const agent = this.activeSessions.get(agentId);
+        if (!agent) {
+            throw new Error(`No active session for agent: ${agentId}`);
+        }
+        return agent.exportState();
+    }
+    /**
+     * Force consolidation across all aggregated agent data.
+     * Useful for periodic maintenance (e.g., NightlyLearner).
+     */
+    consolidate() {
+        this.ensureAlive();
+        this.coordinator.forceConsolidate();
+    }
+    /**
+     * Get warm-start patterns for a new session.
+     */
+    getInitialPatterns(k = 10) {
+        this.ensureAlive();
+        const safeK = Math.min(Math.max(1, k), MAX_PATTERNS_K);
+        return this.coordinator.getInitialPatterns(safeK);
+    }
+    /**
+     * Find patterns similar to a query embedding.
+     */
+    findPatterns(query, k = 5) {
+        this.ensureAlive();
+        if (query.length !== this.dim) {
+            throw new Error(`Query dimension ${query.length} does not match configured dimension ${this.dim}`);
+        }
+        const safeK = Math.min(Math.max(1, k), MAX_PATTERNS_K);
+        return this.coordinator.findPatterns(query, safeK);
+    }
+    /**
+     * Apply the global LoRA transformation to an embedding.
+     */
+    applyLora(embedding) {
+        this.ensureAlive();
+        if (!this.loraManager) {
+            return embedding;
+        }
+        return this.loraManager.forward(embedding);
+    }
+    /**
+     * Create a task-specific LoRA adapter.
+     */
+    createAdapter(name, rank) {
+        this.ensureAlive();
+        if (!this.loraManager)
+            return;
+        const safeRank = Math.min(Math.max(1, rank ?? this.config.loraRank ?? 4), MAX_LORA_RANK);
+        this.loraManager.create(name, {
+            inputDim: this.dim,
+            outputDim: this.dim,
+            rank: safeRank,
+            alpha: safeRank * 2,
+        });
+    }
+    /**
+     * Activate a specific LoRA adapter.
+     */
+    activateAdapter(name) {
+        this.ensureAlive();
+        if (!this.loraManager)
+            return;
+        this.loraManager.activate(name);
+    }
+    /**
+     * List all registered LoRA adapters.
+     */
+    listAdapters() {
+        if (!this.loraManager)
+            return [];
+        return this.loraManager.list();
+    }
+    /**
+     * Get federated coordinator statistics.
+     */
+    getStats() {
+        this.ensureAlive();
+        const raw = this.coordinator.stats();
+        const contributions = this.coordinator.getContributions();
+        return {
+            totalAgents: raw.totalAgents,
+            totalTrajectories: raw.totalTrajectories,
+            patternsLearned: raw.patternsLearned,
+            avgQuality: raw.avgQuality,
+            qualityThreshold: raw.qualityThreshold,
+            contributions,
+        };
+    }
+    /** Get the number of active sessions */
+    get activeSessionCount() {
+        return this.activeSessions.size;
+    }
+    /** Get the configured dimension */
+    get dimension() {
+        return this.dim;
+    }
+    /** Check if destroyed */
+    get isDestroyed() {
+        return this._destroyed;
+    }
+    /** Destroy the manager and all active sessions */
+    destroy() {
+        if (!this._destroyed) {
+            this.activeSessions.clear();
+            if (this.loraManager) {
+                this.loraManager.clear();
+                this.loraManager = null;
+            }
+            if (this.coordinator) {
+                this.coordinator.clear();
+                this.coordinator = null;
+            }
+            this._destroyed = true;
+        }
+    }
+    // --- Internal ---
+    /** @internal Record a trajectory from a session handle */
+    _recordTrajectory(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agent, embedding, quality, route) {
+        const safeQuality = Math.min(Math.max(0, quality), 1);
+        if (route) {
+            agent.processTaskWithRoute(embedding, route, safeQuality);
+        }
+        else {
+            agent.processTask(embedding, safeQuality);
+        }
+    }
+    validateAgentId(id) {
+        if (!id || id.length === 0 || id.length > MAX_AGENT_ID_LENGTH) {
+            throw new Error(`Agent ID must be 1-${MAX_AGENT_ID_LENGTH} characters`);
+        }
+        if (id.includes('\0')) {
+            throw new Error('Agent ID must not contain null bytes');
+        }
+    }
+    ensureAlive() {
+        if (this._destroyed) {
+            throw new Error('FederatedSessionManager has been destroyed. Create a new instance.');
+        }
+    }
+}
+/**
+ * SessionHandle - Lightweight handle for recording trajectories within a session
+ */
+export class SessionHandle {
+    agentId;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agent;
+    manager;
+    _initialPatterns;
+    _dim;
+    _ended = false;
+    /** @internal */
+    constructor(agentId, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agent, manager, initialPatterns, dim) {
+        this.agentId = agentId;
+        this.agent = agent;
+        this.manager = manager;
+        this._initialPatterns = initialPatterns;
+        this._dim = dim;
+    }
+    /**
+     * Record a trajectory (embedding + quality score).
+     *
+     * @param embedding - The query/action embedding
+     * @param quality - Quality score in [0.0, 1.0]
+     * @param route - Optional route label (e.g., "math", "code")
+     */
+    recordTrajectory(embedding, quality, route) {
+        this.ensureActive();
+        const arr = embedding instanceof Float32Array ? Array.from(embedding) : embedding;
+        if (arr.length !== this._dim) {
+            throw new Error(`Embedding dimension ${arr.length} does not match configured dimension ${this._dim}`);
+        }
+        this.manager._recordTrajectory(this.agent, arr, quality, route);
+    }
+    /**
+     * Get patterns learned during this session.
+     */
+    getPatterns(k = 10) {
+        this.ensureActive();
+        this.agent.forceLearn();
+        return this.agent.getPatterns(Math.min(Math.max(1, k), MAX_PATTERNS_K));
+    }
+    /**
+     * Get the initial warm-start patterns loaded at session start.
+     */
+    get initialPatterns() {
+        return this._initialPatterns;
+    }
+    /**
+     * Get current session statistics.
+     */
+    getStats() {
+        this.ensureActive();
+        return {
+            trajectoryCount: this.agent.trajectoryCount(),
+            avgQuality: this.agent.avgQuality() || 0,
+            patternsLearned: this.agent.getPatterns(MAX_PATTERNS_K).length,
+            sessionDurationMs: this.agent.uptimeSeconds() * 1000,
+        };
+    }
+    /**
+     * End this session and aggregate into the coordinator.
+     */
+    end() {
+        this.ensureActive();
+        this._ended = true;
+        return this.manager.endSession(this.agentId);
+    }
+    /** The agent ID for this session */
+    get id() {
+        return this.agentId;
+    }
+    /** Whether this session has been ended */
+    get isEnded() {
+        return this._ended;
+    }
+    ensureActive() {
+        if (this._ended) {
+            throw new Error(`Session ${this.agentId} has already ended.`);
+        }
+    }
+}
+//# sourceMappingURL=FederatedSessionManager.js.map

package/dist/src/backends/rvf/FederatedSessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FederatedSessionManager.js","sourceRoot":"","sources":["../../../../src/backends/rvf/FederatedSessionManager.ts"],"names":[],"mappings":"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"}