@sesamespace/hivemind 0.1.0

package/dist/context.js

@@ -0,0 +1,153 @@
+const SWITCH_PATTERNS = [
+    /^switch\s+to\s+(\S+)/i,
+    /^context:\s*(\S+)/i,
+    /^@(\S+)\s/,
+    /^working\s+on\s+(\S+)/i,
+];
+export class ContextManager {
+    contexts = new Map();
+    activeContext = "global";
+    memory;
+    constructor(memory) {
+        this.memory = memory;
+        // Global context always exists
+        this.contexts.set("global", {
+            name: "global",
+            description: "Global context — identity, preferences, cross-cutting knowledge",
+            created_at: new Date().toISOString(),
+            last_active: new Date().toISOString(),
+        });
+    }
+    async createContext(name, description = "") {
+        if (this.contexts.has(name)) {
+            return this.contexts.get(name);
+        }
+        const metadata = {
+            name,
+            description,
+            created_at: new Date().toISOString(),
+            last_active: new Date().toISOString(),
+        };
+        this.contexts.set(name, metadata);
+        // Register context with memory daemon
+        try {
+            await this.memory.createContext(name, description);
+        }
+        catch (err) {
+            console.error(`Failed to register context '${name}' with daemon:`, err.message);
+        }
+        return metadata;
+    }
+    async deleteContext(name) {
+        if (name === "global") {
+            console.error("Cannot delete global context");
+            return false;
+        }
+        if (!this.contexts.has(name)) {
+            return false;
+        }
+        this.contexts.delete(name);
+        if (this.activeContext === name) {
+            this.activeContext = "global";
+        }
+        try {
+            await this.memory.deleteContext(name);
+        }
+        catch (err) {
+            console.error(`Failed to delete context '${name}' from daemon:`, err.message);
+        }
+        return true;
+    }
+    listContexts() {
+        return Array.from(this.contexts.values());
+    }
+    getContext(name) {
+        return this.contexts.get(name);
+    }
+    getActiveContext() {
+        return this.activeContext;
+    }
+    switchContext(name) {
+        const previousContext = this.activeContext;
+        const isNew = !this.contexts.has(name);
+        if (isNew) {
+            this.contexts.set(name, {
+                name,
+                description: "",
+                created_at: new Date().toISOString(),
+                last_active: new Date().toISOString(),
+            });
+        }
+        this.activeContext = name;
+        this.touchContext(name);
+        return { previousContext, activeContext: name, isNew };
+    }
+    /**
+     * Parse a message and determine if it's a context switch command.
+     * Returns the context name if a switch is detected, null otherwise.
+     */
+    parseContextSwitch(message) {
+        for (const pattern of SWITCH_PATTERNS) {
+            const match = message.match(pattern);
+            if (match) {
+                return match[1].toLowerCase();
+            }
+        }
+        return null;
+    }
+    /**
+     * Infer context from message content by checking known context names.
+     * Returns the best matching context or current active context.
+     */
+    inferContext(message) {
+        const lower = message.toLowerCase();
+        for (const [name] of this.contexts) {
+            if (name === "global")
+                continue;
+            if (lower.includes(name.toLowerCase())) {
+                return name;
+            }
+        }
+        return this.activeContext;
+    }
+    /**
+     * Route a message: check for explicit switch, then infer context.
+     * Returns the resolved context name and whether a switch happened.
+     */
+    routeMessage(message) {
+        // Check for explicit switch command
+        const switchTarget = this.parseContextSwitch(message);
+        if (switchTarget) {
+            const result = this.switchContext(switchTarget);
+            return { context: switchTarget, switched: true, switchedTo: result.activeContext };
+        }
+        // Infer from content
+        const inferred = this.inferContext(message);
+        if (inferred !== this.activeContext) {
+            this.touchContext(inferred);
+            return { context: inferred, switched: false };
+        }
+        this.touchContext(this.activeContext);
+        return { context: this.activeContext, switched: false };
+    }
+    /**
+     * Returns contexts that should be searched: active context + global.
+     */
+    getSearchContexts() {
+        const contexts = [this.activeContext];
+        if (this.activeContext !== "global") {
+            contexts.push("global");
+        }
+        return contexts;
+    }
+    hasContext(name) {
+        return this.contexts.has(name);
+    }
+    touchContext(name) {
+        const ctx = this.contexts.get(name);
+        if (ctx) {
+            ctx.last_active = new Date().toISOString();
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/fleet/fleet-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Fleet Manager — high-level orchestration layer on top of PrimaryClient.
+ *
+ * Provides:
+ *   - Worker provisioning (register by URL)
+ *   - Context assignment and migration between workers
+ *   - Aggregate fleet status / dashboard data
+ *   - Worker discovery and removal
+ */
+import { PrimaryClient } from "./primary-client.js";
+import type { WorkerInfo, WorkerHealthStatus, WorkerCapabilities, ContextAssignResponse, WorkerStatus, WorkerActivity } from "./worker-protocol.js";
+export interface WorkerSummary {
+    id: string;
+    url: string;
+    health: WorkerHealthStatus;
+    contexts: string[];
+    current_task: string | null;
+    activity: WorkerActivity;
+    uptime_seconds: number | null;
+    capabilities: WorkerCapabilities;
+    last_heartbeat: string;
+}
+export interface FleetDashboard {
+    total_workers: number;
+    healthy: number;
+    degraded: number;
+    unreachable: number;
+    total_contexts: number;
+    workers: WorkerSummary[];
+    unassigned_contexts: string[];
+    generated_at: string;
+}
+export interface MigrationResult {
+    context_name: string;
+    from_worker: string;
+    to_worker: string;
+    success: boolean;
+    reason?: string;
+}
+export declare class FleetManager {
+    private primary;
+    private latestHealth;
+    private latestStatus;
+    private knownContexts;
+    constructor(primary?: PrimaryClient);
+    getPrimary(): PrimaryClient;
+    /**
+     * Register a new worker by URL. Probes the worker's health endpoint
+     * to discover capabilities, then registers it with the Primary.
+     */
+    addWorker(url: string): Promise<WorkerInfo>;
+    /** Remove a worker from the fleet, unassigning its contexts first. */
+    removeWorker(workerId: string): Promise<boolean>;
+    /** Assign a context to a specific worker. */
+    assignContext(workerId: string, contextName: string, description?: string): Promise<ContextAssignResponse>;
+    /** Migrate a context from one worker to another. */
+    migrateContext(contextName: string, toWorkerId: string): Promise<MigrationResult>;
+    /** Refresh health for all workers. */
+    refreshHealth(): Promise<void>;
+    /** Record a status report (called when worker POSTs status to Primary). */
+    recordStatus(workerId: string, status: WorkerStatus): void;
+    /** Get the full fleet dashboard. */
+    getDashboard(): Promise<FleetDashboard>;
+    /** Get a quick status summary without refreshing health. */
+    getStatusSnapshot(): FleetDashboard;
+    /**
+     * Scan a list of candidate URLs for workers. Returns the URLs
+     * that responded to a health probe. Useful for auto-detecting
+     * workers on a local network.
+     */
+    discoverWorkers(candidateUrls: string[]): Promise<string[]>;
+    /**
+     * Scan a subnet-style range for workers. Generates URLs for
+     * a base IP with ports and probes them.
+     * Example: scanSubnet("192.168.1", [10, 11, 12], 3100)
+     */
+    scanSubnet(baseIp: string, hostIds: number[], port: number): Promise<string[]>;
+    /** Track a context name so it appears in unassigned lists. */
+    registerContext(contextName: string): void;
+    /** Start health polling (delegates to PrimaryClient). */
+    startHealthPolling(intervalMs?: number): void;
+    /** Stop health polling. */
+    stopHealthPolling(): void;
+    private probeWorker;
+}
+//# sourceMappingURL=fleet-manager.d.ts.map

package/dist/fleet/fleet-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-manager.d.ts","sourceRoot":"","sources":["../../src/fleet/fleet-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,aAAa,CAA0B;gBAEnC,OAAO,CAAC,EAAE,aAAa;IAInC,UAAU,IAAI,aAAa;IAM3B;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBjD,sEAAsE;IAChE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IActD,6CAA6C;IACvC,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,SAAK,GACf,OAAO,CAAC,qBAAqB,CAAC;IAQjC,oDAAoD;IAC9C,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;IAiD3B,sCAAsC;IAChC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBpC,2EAA2E;IAC3E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAI1D,oCAAoC;IAC9B,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAiD7C,4DAA4D;IAC5D,iBAAiB,IAAI,cAAc;IAgDnC;;;;OAIG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BjE;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpB,8DAA8D;IAC9D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,yDAAyD;IACzD,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C,2BAA2B;IAC3B,iBAAiB,IAAI,IAAI;YAMX,WAAW;CA+B1B"}

package/dist/fleet/fleet-manager.js

@@ -0,0 +1,298 @@
+/**
+ * Fleet Manager — high-level orchestration layer on top of PrimaryClient.
+ *
+ * Provides:
+ *   - Worker provisioning (register by URL)
+ *   - Context assignment and migration between workers
+ *   - Aggregate fleet status / dashboard data
+ *   - Worker discovery and removal
+ */
+import { PrimaryClient } from "./primary-client.js";
+import { WORKER_ROUTES, HEALTH_TIMEOUT_MS, } from "./worker-protocol.js";
+export class FleetManager {
+    primary;
+    latestHealth = new Map();
+    latestStatus = new Map();
+    knownContexts = new Set();
+    constructor(primary) {
+        this.primary = primary ?? new PrimaryClient();
+    }
+    getPrimary() {
+        return this.primary;
+    }
+    // --- Worker Provisioning ---
+    /**
+     * Register a new worker by URL. Probes the worker's health endpoint
+     * to discover capabilities, then registers it with the Primary.
+     */
+    async addWorker(url) {
+        // Normalise trailing slash
+        const baseUrl = url.replace(/\/+$/, "");
+        // Probe worker health to discover capabilities
+        const capabilities = await this.probeWorker(baseUrl);
+        const reg = this.primary.handleRegistration({ url: baseUrl, capabilities });
+        const worker = this.primary.getWorker(reg.worker_id);
+        if (!worker) {
+            throw new Error("Worker registered but not found in registry");
+        }
+        return worker;
+    }
+    /** Remove a worker from the fleet, unassigning its contexts first. */
+    async removeWorker(workerId) {
+        const worker = this.primary.getWorker(workerId);
+        if (!worker)
+            return false;
+        // Unassign all contexts from this worker
+        for (const ctx of [...worker.assigned_contexts]) {
+            await this.primary.unassignContext(workerId, ctx);
+        }
+        return this.primary.deregister(workerId);
+    }
+    // --- Context Assignment ---
+    /** Assign a context to a specific worker. */
+    async assignContext(workerId, contextName, description = "") {
+        const result = await this.primary.assignContext(workerId, contextName, description);
+        if (result.accepted) {
+            this.knownContexts.add(contextName);
+        }
+        return result;
+    }
+    /** Migrate a context from one worker to another. */
+    async migrateContext(contextName, toWorkerId) {
+        const fromWorker = this.primary.findWorkerForContext(contextName);
+        if (!fromWorker) {
+            // Context isn't assigned anywhere — just assign to target
+            const resp = await this.primary.assignContext(toWorkerId, contextName);
+            return {
+                context_name: contextName,
+                from_worker: "(none)",
+                to_worker: toWorkerId,
+                success: resp.accepted,
+                reason: resp.accepted ? undefined : resp.reason,
+            };
+        }
+        if (fromWorker.id === toWorkerId) {
+            return {
+                context_name: contextName,
+                from_worker: fromWorker.id,
+                to_worker: toWorkerId,
+                success: false,
+                reason: "Context already assigned to this worker",
+            };
+        }
+        // Assign to new worker first, then unassign from old
+        const assignResult = await this.primary.assignContext(toWorkerId, contextName);
+        if (!assignResult.accepted) {
+            return {
+                context_name: contextName,
+                from_worker: fromWorker.id,
+                to_worker: toWorkerId,
+                success: false,
+                reason: assignResult.reason ?? "Target worker rejected assignment",
+            };
+        }
+        await this.primary.unassignContext(fromWorker.id, contextName);
+        return {
+            context_name: contextName,
+            from_worker: fromWorker.id,
+            to_worker: toWorkerId,
+            success: true,
+        };
+    }
+    // --- Status & Health ---
+    /** Refresh health for all workers. */
+    async refreshHealth() {
+        const workers = this.primary.getWorkers();
+        const checks = workers.map(async (w) => {
+            const health = await this.primary.checkHealth(w.id);
+            if (health) {
+                this.latestHealth.set(w.id, health);
+            }
+            else {
+                // Mark unreachable but keep stale data
+                this.latestHealth.set(w.id, {
+                    worker_id: w.id,
+                    status: "unreachable",
+                    uptime_seconds: 0,
+                    assigned_contexts: w.assigned_contexts,
+                    active_context: null,
+                    memory_daemon_ok: false,
+                    ollama_ok: false,
+                });
+            }
+        });
+        await Promise.all(checks);
+    }
+    /** Record a status report (called when worker POSTs status to Primary). */
+    recordStatus(workerId, status) {
+        this.latestStatus.set(workerId, status);
+    }
+    /** Get the full fleet dashboard. */
+    async getDashboard() {
+        await this.refreshHealth();
+        const workers = this.primary.getWorkers();
+        let healthy = 0;
+        let degraded = 0;
+        let unreachable = 0;
+        let totalContexts = 0;
+        const workerSummaries = workers.map((w) => {
+            const health = this.latestHealth.get(w.id);
+            const status = this.latestStatus.get(w.id);
+            const healthStatus = health?.status ?? "unreachable";
+            if (healthStatus === "healthy")
+                healthy++;
+            else if (healthStatus === "degraded")
+                degraded++;
+            else
+                unreachable++;
+            totalContexts += w.assigned_contexts.length;
+            return {
+                id: w.id,
+                url: w.url,
+                health: healthStatus,
+                contexts: w.assigned_contexts,
+                current_task: status?.current_task ?? null,
+                activity: status?.activity ?? "idle",
+                uptime_seconds: health?.uptime_seconds ?? null,
+                capabilities: w.capabilities,
+                last_heartbeat: w.last_heartbeat,
+            };
+        });
+        // Determine unassigned contexts
+        const assignedContexts = new Set(workers.flatMap((w) => w.assigned_contexts));
+        const unassigned = [...this.knownContexts].filter((c) => !assignedContexts.has(c));
+        return {
+            total_workers: workers.length,
+            healthy,
+            degraded,
+            unreachable,
+            total_contexts: totalContexts,
+            workers: workerSummaries,
+            unassigned_contexts: unassigned,
+            generated_at: new Date().toISOString(),
+        };
+    }
+    /** Get a quick status summary without refreshing health. */
+    getStatusSnapshot() {
+        const workers = this.primary.getWorkers();
+        let healthy = 0;
+        let degraded = 0;
+        let unreachable = 0;
+        let totalContexts = 0;
+        const workerSummaries = workers.map((w) => {
+            const health = this.latestHealth.get(w.id);
+            const status = this.latestStatus.get(w.id);
+            const healthStatus = health?.status ?? "unreachable";
+            if (healthStatus === "healthy")
+                healthy++;
+            else if (healthStatus === "degraded")
+                degraded++;
+            else
+                unreachable++;
+            totalContexts += w.assigned_contexts.length;
+            return {
+                id: w.id,
+                url: w.url,
+                health: healthStatus,
+                contexts: w.assigned_contexts,
+                current_task: status?.current_task ?? null,
+                activity: status?.activity ?? "idle",
+                uptime_seconds: health?.uptime_seconds ?? null,
+                capabilities: w.capabilities,
+                last_heartbeat: w.last_heartbeat,
+            };
+        });
+        const assignedContexts = new Set(workers.flatMap((w) => w.assigned_contexts));
+        const unassigned = [...this.knownContexts].filter((c) => !assignedContexts.has(c));
+        return {
+            total_workers: workers.length,
+            healthy,
+            degraded,
+            unreachable,
+            total_contexts: totalContexts,
+            workers: workerSummaries,
+            unassigned_contexts: unassigned,
+            generated_at: new Date().toISOString(),
+        };
+    }
+    // --- Worker Discovery ---
+    /**
+     * Scan a list of candidate URLs for workers. Returns the URLs
+     * that responded to a health probe. Useful for auto-detecting
+     * workers on a local network.
+     */
+    async discoverWorkers(candidateUrls) {
+        const found = [];
+        const probes = candidateUrls.map(async (url) => {
+            const baseUrl = url.replace(/\/+$/, "");
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+                const resp = await fetch(`${baseUrl}${WORKER_ROUTES.health}`, {
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (resp.ok) {
+                    found.push(baseUrl);
+                }
+            }
+            catch {
+                // Not reachable, skip
+            }
+        });
+        await Promise.all(probes);
+        return found;
+    }
+    /**
+     * Scan a subnet-style range for workers. Generates URLs for
+     * a base IP with ports and probes them.
+     * Example: scanSubnet("192.168.1", [10, 11, 12], 3100)
+     */
+    async scanSubnet(baseIp, hostIds, port) {
+        const urls = hostIds.map((id) => `http://${baseIp}.${id}:${port}`);
+        return this.discoverWorkers(urls);
+    }
+    /** Track a context name so it appears in unassigned lists. */
+    registerContext(contextName) {
+        this.knownContexts.add(contextName);
+    }
+    /** Start health polling (delegates to PrimaryClient). */
+    startHealthPolling(intervalMs) {
+        this.primary.startHealthPolling(intervalMs);
+    }
+    /** Stop health polling. */
+    stopHealthPolling() {
+        this.primary.stopHealthPolling();
+    }
+    // --- Internal ---
+    async probeWorker(baseUrl) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+            const resp = await fetch(`${baseUrl}${WORKER_ROUTES.health}`, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (resp.ok) {
+                const health = (await resp.json());
+                return {
+                    max_contexts: health.assigned_contexts.length + 4, // assume capacity
+                    has_ollama: health.ollama_ok,
+                    has_memory_daemon: health.memory_daemon_ok,
+                    available_models: [],
+                };
+            }
+        }
+        catch {
+            // Fall through to defaults
+        }
+        // Return default capabilities if probe fails
+        return {
+            max_contexts: 4,
+            has_ollama: false,
+            has_memory_daemon: false,
+            available_models: [],
+        };
+    }
+}
+//# sourceMappingURL=fleet-manager.js.map

package/dist/fleet/fleet-manager.js.map

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

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

@@ -0,0 +1,91 @@
+/**
+ * Cross-machine memory sync.
+ *
+ * Workers periodically push key L3 knowledge back to the Primary.
+ * Primary can push Global context updates (L3 + L2 episodes) to workers.
+ *
+ * Conflict resolution:
+ *   - L3: last-write-wins (compared by updated_at timestamp)
+ *   - L2: append-only (episodes are never overwritten, only added)
+ *
+ * Sync protocol:
+ *   POST /sync/pull  — Worker sends L3 knowledge to Primary
+ *   POST /sync/push  — Primary sends Global context updates to Worker
+ */
+import type { MemoryClient } from "../memory-client.js";
+import type { PrimaryClient } from "./primary-client.js";
+import type { WorkerServer } from "./worker-server.js";
+import type { SyncPullRequest, SyncPullResponse, SyncPushRequest, SyncPushResponse, SyncL3Entry } from "./worker-protocol.js";
+export interface WorkerSyncOptions {
+    workerId: string;
+    primaryUrl: string;
+    memory: MemoryClient;
+    server: WorkerServer;
+    syncIntervalMs?: number;
+}
+/**
+ * Worker-side memory sync. Periodically sends L3 knowledge from assigned
+ * contexts back to the Primary, and accepts Global context pushes.
+ */
+export declare class WorkerMemorySync {
+    private workerId;
+    private primaryUrl;
+    private memory;
+    private syncTimer;
+    private syncIntervalMs;
+    private knownL2Ids;
+    private knownL3Ids;
+    constructor(opts: WorkerSyncOptions);
+    /** Start periodic sync (Worker -> Primary). */
+    start(contextNames: () => string[]): void;
+    /** Stop periodic sync. */
+    stop(): void;
+    /**
+     * Pull L3 knowledge from all assigned contexts and send to Primary.
+     * Called periodically by the sync timer.
+     */
+    pullTowardsPrimary(contextNames: string[]): Promise<void>;
+    /**
+     * Handle an incoming push of Global context updates from the Primary.
+     * L3: last-write-wins. L2: append-only.
+     */
+    handlePush(req: SyncPushRequest): Promise<SyncPushResponse>;
+    getSyncIntervalMs(): number;
+}
+export interface PrimarySyncOptions {
+    primary: PrimaryClient;
+    memory: MemoryClient;
+    syncIntervalMs?: number;
+}
+/**
+ * Primary-side memory sync. Handles incoming L3 pulls from workers and
+ * can push Global context updates out to all workers.
+ */
+export declare class PrimaryMemorySync {
+    private primary;
+    private memory;
+    private syncIntervalMs;
+    private pushTimer;
+    private l3Store;
+    private lastPushAt;
+    constructor(opts: PrimarySyncOptions);
+    /**
+     * Handle an incoming pull — Worker sending L3 knowledge to Primary.
+     * Uses last-write-wins for conflict resolution.
+     */
+    handlePull(req: SyncPullRequest): Promise<SyncPullResponse>;
+    /**
+     * Push Global context updates to all workers.
+     * Fetches current Global L3 knowledge and recent L2 episodes,
+     * then pushes to every registered worker.
+     */
+    pushGlobalToAll(): Promise<Map<string, SyncPushResponse | null>>;
+    /** Start periodic Global push to all workers. */
+    startPushLoop(): void;
+    /** Stop periodic push. */
+    stopPushLoop(): void;
+    /** Get all synced L3 entries the Primary has received. */
+    getSyncedEntries(): SyncL3Entry[];
+    getSyncIntervalMs(): number;
+}
+//# sourceMappingURL=memory-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-sync.d.ts","sourceRoot":"","sources":["../../src/fleet/memory-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AA8B9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAAkC;gBAExC,IAAI,EAAE,iBAAiB;IAUnC,+CAA+C;IAC/C,KAAK,CAAC,YAAY,EAAE,MAAM,MAAM,EAAE,GAAG,IAAI;IASzC,0BAA0B;IAC1B,IAAI,IAAI,IAAI;IAOZ;;;OAGG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC/D;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqDjE,iBAAiB,IAAI,MAAM;CAG5B;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAqC;gBAE3C,IAAI,EAAE,kBAAkB;IASpC;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuCjE;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAmDtE,iDAAiD;IACjD,aAAa,IAAI,IAAI;IASrB,0BAA0B;IAC1B,YAAY,IAAI,IAAI;IAOpB,0DAA0D;IAC1D,gBAAgB,IAAI,WAAW,EAAE;IAIjC,iBAAiB,IAAI,MAAM;CAG5B"}