promptspeak-mcp-server 0.1.0

package/dist/multi_agent/lru-cache.js

@@ -0,0 +1,310 @@
+/**
+ * ===============================================================================
+ * LRU CACHE WITH TTL SUPPORT
+ * ===============================================================================
+ *
+ * LRU Cache with TTL support for multi-agent state management.
+ * Prevents unbounded memory growth from stored intents, bindings, and missions.
+ *
+ * Features:
+ * - Least Recently Used eviction when capacity is reached
+ * - Time-To-Live (TTL) for automatic expiration
+ * - Optional eviction callback for cleanup
+ * - Efficient O(1) get/set operations using Map ordering
+ *
+ * ===============================================================================
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// LRU CACHE CLASS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * LRU Cache with TTL support.
+ *
+ * Uses Map's insertion order to track recency efficiently.
+ * When an item is accessed, it's deleted and re-inserted to move it to the end.
+ */
+export class LRUCache {
+    cache = new Map();
+    config;
+    constructor(config) {
+        if (config.maxSize <= 0) {
+            throw new Error('LRUCache maxSize must be greater than 0');
+        }
+        this.config = {
+            maxSize: config.maxSize,
+            ttlMs: config.ttlMs ?? Infinity,
+            onEvict: config.onEvict ?? (() => { }),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // CORE OPERATIONS
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Set a value in the cache.
+     * Evicts LRU entry if at capacity and key doesn't exist.
+     */
+    set(key, value) {
+        // If key exists, delete first to reset position
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.config.maxSize) {
+            // Evict LRU (first entry in Map)
+            this.evictLRU();
+        }
+        const now = Date.now();
+        this.cache.set(key, {
+            value,
+            lastAccess: now,
+            createdAt: now,
+        });
+    }
+    /**
+     * Get a value from the cache.
+     * Returns undefined if not found or expired.
+     * Updates access time and position for LRU tracking.
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        // Check TTL
+        if (Date.now() - entry.createdAt > this.config.ttlMs) {
+            this.delete(key);
+            return undefined;
+        }
+        // Update access time and move to end (most recently used)
+        entry.lastAccess = Date.now();
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /**
+     * Check if a key exists and is not expired.
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Delete an entry from the cache.
+     * Invokes the onEvict callback if entry exists.
+     */
+    delete(key) {
+        const entry = this.cache.get(key);
+        if (entry) {
+            this.config.onEvict(key, entry.value);
+            return this.cache.delete(key);
+        }
+        return false;
+    }
+    /**
+     * Clear all entries from the cache.
+     * Invokes onEvict callback for each entry.
+     */
+    clear() {
+        this.cache.forEach((entry, key) => {
+            this.config.onEvict(key, entry.value);
+        });
+        this.cache.clear();
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // EVICTION
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Evict the least recently used entry.
+     * Uses Map iteration order (oldest first).
+     */
+    evictLRU() {
+        // Find the oldest entry by lastAccess time
+        let oldestKey;
+        let oldestAccess = Infinity;
+        this.cache.forEach((entry, key) => {
+            if (entry.lastAccess < oldestAccess) {
+                oldestAccess = entry.lastAccess;
+                oldestKey = key;
+            }
+        });
+        if (oldestKey) {
+            this.delete(oldestKey);
+        }
+    }
+    /**
+     * Clean up expired entries.
+     * Returns the number of entries evicted.
+     */
+    cleanup() {
+        const now = Date.now();
+        let evicted = 0;
+        // Collect keys to delete (avoid modifying during iteration)
+        const keysToDelete = [];
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt > this.config.ttlMs) {
+                keysToDelete.push(key);
+            }
+        });
+        keysToDelete.forEach(key => {
+            this.delete(key);
+            evicted++;
+        });
+        return evicted;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // ACCESSORS
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Get all values in the cache (excluding expired).
+     */
+    values() {
+        const now = Date.now();
+        const result = [];
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt <= this.config.ttlMs) {
+                result.push(entry.value);
+            }
+        });
+        return result;
+    }
+    /**
+     * Get all keys in the cache (excluding expired).
+     */
+    keys() {
+        const now = Date.now();
+        const result = [];
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt <= this.config.ttlMs) {
+                result.push(key);
+            }
+        });
+        return result;
+    }
+    /**
+     * Get all entries as [key, value] pairs (excluding expired).
+     */
+    entries() {
+        const now = Date.now();
+        const result = [];
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt <= this.config.ttlMs) {
+                result.push([key, entry.value]);
+            }
+        });
+        return result;
+    }
+    /**
+     * Get the current number of entries (may include expired entries).
+     * Use cleanup() first for accurate count.
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Get cache statistics.
+     */
+    stats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.config.maxSize,
+            ttlMs: this.config.ttlMs,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // ITERATION
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Iterate over cache entries with forEach.
+     * Excludes expired entries.
+     */
+    forEach(callback) {
+        const now = Date.now();
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt <= this.config.ttlMs) {
+                callback(entry.value, key);
+            }
+        });
+    }
+    /**
+     * Filter entries matching a predicate.
+     * Excludes expired entries.
+     */
+    filter(predicate) {
+        const now = Date.now();
+        const result = [];
+        this.cache.forEach((entry, key) => {
+            if (now - entry.createdAt <= this.config.ttlMs && predicate(entry.value, key)) {
+                result.push(entry.value);
+            }
+        });
+        return result;
+    }
+    /**
+     * Find first entry matching a predicate.
+     * Excludes expired entries.
+     * Note: Uses Array.from for early exit support.
+     */
+    find(predicate) {
+        const now = Date.now();
+        const entriesArray = Array.from(this.cache.entries());
+        for (let i = 0; i < entriesArray.length; i++) {
+            const [key, entry] = entriesArray[i];
+            if (now - entry.createdAt <= this.config.ttlMs && predicate(entry.value, key)) {
+                return entry.value;
+            }
+        }
+        return undefined;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // TTL MANAGEMENT
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Update the TTL for a specific entry.
+     * Useful for extending the life of active items.
+     */
+    touch(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        // Reset creation time to extend TTL
+        entry.createdAt = Date.now();
+        entry.lastAccess = Date.now();
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return true;
+    }
+    /**
+     * Get the remaining TTL for an entry in milliseconds.
+     * Returns 0 if expired or not found.
+     */
+    ttlRemaining(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return 0;
+        const remaining = this.config.ttlMs - (Date.now() - entry.createdAt);
+        return Math.max(0, remaining);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// FACTORY FUNCTIONS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create an LRU cache with common presets.
+ */
+export function createLRUCache(maxSize, options) {
+    return new LRUCache({
+        maxSize,
+        ttlMs: options?.ttlMs,
+        onEvict: options?.onEvict,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// TIME CONSTANTS
+// ─────────────────────────────────────────────────────────────────────────────
+/** One hour in milliseconds */
+export const ONE_HOUR_MS = 60 * 60 * 1000;
+/** 12 hours in milliseconds */
+export const TWELVE_HOURS_MS = 12 * ONE_HOUR_MS;
+/** 24 hours in milliseconds */
+export const TWENTY_FOUR_HOURS_MS = 24 * ONE_HOUR_MS;
+/** 7 days in milliseconds */
+export const SEVEN_DAYS_MS = 7 * TWENTY_FOUR_HOURS_MS;
+//# sourceMappingURL=lru-cache.js.map

package/dist/multi_agent/lru-cache.js.map

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

package/dist/multi_agent/mission.d.ts

@@ -0,0 +1,151 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MISSION MANAGER
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Manages multi-agent missions - coordinated operations with a single Intent.
+ *
+ * A Mission is:
+ * - A coordinated multi-agent operation
+ * - Governed by a single Commander's Intent
+ * - Executed by multiple agents with different roles
+ * - Tracked through phases to completion
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import type { Mission, MissionStatus, CreateMissionRequest, CreateMissionResponse, AgentRole } from './intent-types.js';
+import type { MissionManagerDeps } from './container.js';
+/**
+ * Manages multi-agent missions.
+ * Uses LRU cache to prevent unbounded memory growth.
+ * Active missions are kept alive via touch(), completed missions expire after 7 days.
+ */
+export declare class MissionManager {
+    private missions;
+    private readonly intentManager;
+    private readonly agentRegistry;
+    /**
+     * Create a MissionManager instance.
+     *
+     * @param deps - Optional dependencies for testing/DI. Falls back to singletons.
+     * @param deps.intentManager - IntentManager instance for intent operations
+     * @param deps.agentRegistry - AgentRegistry instance for agent operations
+     *
+     * @example
+     * // Production usage (uses default singletons)
+     * const manager = new MissionManager();
+     *
+     * @example
+     * // Testing with mocks
+     * const manager = new MissionManager({
+     *   intentManager: mockIntentManager,
+     *   agentRegistry: mockAgentRegistry,
+     * });
+     */
+    constructor(deps?: MissionManagerDeps);
+    /**
+     * Create a new mission.
+     */
+    createMission(request: CreateMissionRequest): Promise<CreateMissionResponse>;
+    /**
+     * Get a mission by ID.
+     */
+    getMission(missionId: string): Mission | undefined;
+    /**
+     * List all missions, optionally filtered.
+     */
+    listMissions(filters?: {
+        status?: MissionStatus;
+        namespace?: string;
+    }): Mission[];
+    /**
+     * Get cache statistics for monitoring.
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+        ttlMs: number;
+    };
+    /**
+     * Cleanup expired entries from cache.
+     * Returns the number of entries evicted.
+     */
+    cleanup(): number;
+    /**
+     * Touch a mission to extend its TTL (for active missions).
+     */
+    private touchMission;
+    /**
+     * Check if mission status indicates it's still active.
+     */
+    private isActiveMission;
+    /**
+     * Assign an agent to a mission.
+     */
+    assignAgent(missionId: string, agentId: string, role: AgentRole, assignedBy: string, missionOverride?: Mission): Promise<{
+        success: boolean;
+        binding_id?: string;
+        error?: string;
+    }>;
+    /**
+     * Remove an agent from a mission.
+     */
+    removeAgent(missionId: string, agentId: string): boolean;
+    /**
+     * Start a mission.
+     */
+    startMission(missionId: string): boolean;
+    /**
+     * Pause a mission.
+     */
+    pauseMission(missionId: string): boolean;
+    /**
+     * Resume a paused mission.
+     */
+    resumeMission(missionId: string): boolean;
+    /**
+     * Complete a mission.
+     */
+    completeMission(missionId: string, success: boolean): boolean;
+    /**
+     * Abort a mission.
+     */
+    abortMission(missionId: string, reason?: string): boolean;
+    /**
+     * Update mission progress.
+     */
+    updateProgress(missionId: string, progress: {
+        phase?: string;
+        percent_complete?: number;
+        milestone_achieved?: string;
+        blocker?: string;
+        blocker_resolved?: string;
+    }): boolean;
+    /**
+     * Get mission status summary.
+     */
+    getMissionStatus(missionId: string): {
+        status: MissionStatus;
+        progress: Mission['progress'];
+        agents: number;
+        duration_ms?: number;
+    } | undefined;
+    /**
+     * Get mission statistics.
+     */
+    getStats(): {
+        total: number;
+        byStatus: Record<MissionStatus, number>;
+        activeAgents: number;
+    };
+}
+export declare const missionManager: MissionManager;
+export declare const createMission: (request: CreateMissionRequest) => Promise<CreateMissionResponse>;
+export declare const getMission: (id: string) => Mission | undefined;
+export declare const listMissions: (filters?: {
+    status?: MissionStatus;
+    namespace?: string;
+}) => Mission[];
+export declare const startMission: (id: string) => boolean;
+export declare const completeMission: (id: string, success: boolean) => boolean;
+//# sourceMappingURL=mission.d.ts.map

package/dist/multi_agent/mission.d.ts.map

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