dino-spec 13.6.0 → 14.0.1

package/dist/mcp/__tests__/dynamic-updates.test.js

@@ -0,0 +1,314 @@
+/**
+ * Dynamic MCP Tool Updates Tests - v14.0.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { DynamicUpdateHandler, dynamicUpdateHandler, notifyPhaseTransition, notifyFeatureFlagChange, notifyToolRegistration, notifyFocusChange, manualRefresh, createListChangedNotification, formatDynamicUpdateResult, DYNAMIC_UPDATES_FEATURE_FLAG, MIN_UPDATE_INTERVAL_MS, DEFAULT_DEBOUNCE_MS, } from '../dynamic-updates.js';
+describe('Dynamic MCP Tool Updates', () => {
+    let handler;
+    beforeEach(() => {
+        handler = new DynamicUpdateHandler();
+    });
+    afterEach(() => {
+        handler.reset();
+        dynamicUpdateHandler.reset();
+    });
+    describe('Constants', () => {
+        it('should have correct feature flag name', () => {
+            expect(DYNAMIC_UPDATES_FEATURE_FLAG).toBe('enableDynamicToolUpdates');
+        });
+        it('should have minimum update interval', () => {
+            expect(MIN_UPDATE_INTERVAL_MS).toBe(100);
+        });
+        it('should have default debounce delay', () => {
+            expect(DEFAULT_DEBOUNCE_MS).toBe(50);
+        });
+    });
+    describe('DynamicUpdateHandler', () => {
+        describe('enabled state', () => {
+            it('should be enabled by default', () => {
+                expect(handler.isEnabled()).toBe(true);
+            });
+            it('should allow enabling and disabling', () => {
+                handler.setEnabled(false);
+                expect(handler.isEnabled()).toBe(false);
+                handler.setEnabled(true);
+                expect(handler.isEnabled()).toBe(true);
+            });
+            it('should not execute updates when disabled', async () => {
+                handler.setEnabled(false);
+                const result = await handler.forceUpdate('manual_refresh');
+                expect(result.toolsRefreshed).toBe(0);
+                expect(result.cachesCleared).toEqual([]);
+                expect(result.durationMs).toBe(0);
+            });
+        });
+        describe('handleListChanged', () => {
+            it('should execute update with phase_transition trigger', async () => {
+                const result = await handler.handleListChanged('phase_transition');
+                expect(result.toolsRefreshed).toBeGreaterThanOrEqual(0);
+                expect(result.cachesCleared).toContain('phase_cache');
+                expect(result.durationMs).toBeGreaterThanOrEqual(0);
+            });
+            it('should execute update with feature_flag_change trigger', async () => {
+                const result = await handler.handleListChanged('feature_flag_change');
+                expect(result.cachesCleared).toContain('phase_cache');
+            });
+            it('should execute update with tool_registration trigger', async () => {
+                const result = await handler.handleListChanged('tool_registration');
+                expect(result.cachesCleared).toContain('phase_cache');
+            });
+            it('should execute update with focus_change trigger', async () => {
+                const result = await handler.handleListChanged('focus_change');
+                expect(result.cachesCleared).toContain('phase_cache');
+            });
+            it('should debounce rapid updates', async () => {
+                // With debouncing, the last call wins and all previous promises resolve with its result
+                // We test that rapid calls don't cause errors and eventually resolve
+                const results = [];
+                // Create promises that will all resolve when the debounced update completes
+                const promise1 = handler.handleListChanged('phase_transition').then(r => { results.push(r); return r; });
+                const promise2 = handler.handleListChanged('feature_flag_change').then(r => { results.push(r); return r; });
+                const promise3 = handler.handleListChanged('tool_registration').then(r => { results.push(r); return r; });
+                // Wait for debounce timeout plus a buffer
+                await new Promise(resolve => setTimeout(resolve, DEFAULT_DEBOUNCE_MS + 50));
+                // The last promise should have resolved by now
+                const result3 = await promise3;
+                // All results should be the same (the debounced result)
+                expect(result3.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            }, 5000); // Explicit shorter timeout
+        });
+        describe('forceUpdate', () => {
+            it('should execute update immediately', async () => {
+                const result = await handler.forceUpdate('manual_refresh');
+                expect(result.cachesCleared).toContain('phase_cache');
+                expect(result.durationMs).toBeGreaterThanOrEqual(0);
+            });
+            it('should respect minimum interval', async () => {
+                // First update
+                const result1 = await handler.forceUpdate('manual_refresh');
+                expect(result1.cachesCleared).toContain('phase_cache');
+                // Immediate second update should be throttled
+                const result2 = await handler.forceUpdate('manual_refresh');
+                expect(result2.toolsRefreshed).toBe(0);
+                expect(result2.cachesCleared).toEqual([]);
+            });
+            it('should execute after minimum interval passes', async () => {
+                // First update
+                await handler.forceUpdate('manual_refresh');
+                // Wait for minimum interval
+                await new Promise(resolve => setTimeout(resolve, MIN_UPDATE_INTERVAL_MS + 10));
+                // Second update should execute
+                const result = await handler.forceUpdate('manual_refresh');
+                expect(result.cachesCleared).toContain('phase_cache');
+            });
+        });
+        describe('notification callback', () => {
+            it('should call notification callback when set', async () => {
+                const callback = vi.fn();
+                handler.setNotificationCallback(callback);
+                await handler.forceUpdate('manual_refresh');
+                expect(callback).toHaveBeenCalledTimes(1);
+                expect(callback).toHaveBeenCalledWith(expect.objectContaining({
+                    type: 'tools/list_changed',
+                    timestamp: expect.any(String),
+                }));
+            });
+            it('should not send notification when callback not set', async () => {
+                const result = await handler.forceUpdate('manual_refresh');
+                expect(result.notificationSent).toBe(false);
+            });
+            it('should indicate notification sent when callback is set', async () => {
+                handler.setNotificationCallback(() => { });
+                const result = await handler.forceUpdate('manual_refresh');
+                expect(result.notificationSent).toBe(true);
+            });
+        });
+        describe('listeners', () => {
+            it('should notify listeners on update', async () => {
+                const listener = vi.fn();
+                handler.addListener(listener);
+                await handler.forceUpdate('manual_refresh');
+                expect(listener).toHaveBeenCalledTimes(1);
+                expect(listener).toHaveBeenCalledWith(expect.objectContaining({
+                    cachesCleared: expect.arrayContaining(['phase_cache']),
+                }));
+            });
+            it('should support multiple listeners', async () => {
+                const listener1 = vi.fn();
+                const listener2 = vi.fn();
+                handler.addListener(listener1);
+                handler.addListener(listener2);
+                await handler.forceUpdate('manual_refresh');
+                expect(listener1).toHaveBeenCalledTimes(1);
+                expect(listener2).toHaveBeenCalledTimes(1);
+            });
+            it('should allow removing listeners', async () => {
+                const listener = vi.fn();
+                handler.addListener(listener);
+                handler.removeListener(listener);
+                await handler.forceUpdate('manual_refresh');
+                expect(listener).not.toHaveBeenCalled();
+            });
+            it('should handle listener errors gracefully', async () => {
+                const errorListener = vi.fn(() => {
+                    throw new Error('Listener error');
+                });
+                const normalListener = vi.fn();
+                handler.addListener(errorListener);
+                handler.addListener(normalListener);
+                // Should not throw
+                await handler.forceUpdate('manual_refresh');
+                expect(errorListener).toHaveBeenCalled();
+                expect(normalListener).toHaveBeenCalled();
+            });
+        });
+        describe('history', () => {
+            it('should record updates in history', async () => {
+                await handler.forceUpdate('manual_refresh');
+                const history = handler.getHistory();
+                expect(history.length).toBe(1);
+                expect(history[0].trigger).toBe('manual_refresh');
+                expect(history[0].timestamp).toBeTruthy();
+            });
+            it('should record multiple updates', async () => {
+                await handler.forceUpdate('manual_refresh');
+                await new Promise(resolve => setTimeout(resolve, MIN_UPDATE_INTERVAL_MS + 10));
+                await handler.forceUpdate('phase_transition');
+                const history = handler.getHistory();
+                expect(history.length).toBe(2);
+                expect(history[0].trigger).toBe('manual_refresh');
+                expect(history[1].trigger).toBe('phase_transition');
+            });
+            it('should limit history size', async () => {
+                // Force many updates
+                for (let i = 0; i < 60; i++) {
+                    await handler.forceUpdate('manual_refresh');
+                    // Need to wait for minimum interval
+                    await new Promise(resolve => setTimeout(resolve, MIN_UPDATE_INTERVAL_MS + 5));
+                }
+                const history = handler.getHistory();
+                expect(history.length).toBeLessThanOrEqual(50);
+            });
+        });
+        describe('getTimeSinceLastUpdate', () => {
+            it('should return Infinity when no updates', () => {
+                expect(handler.getTimeSinceLastUpdate()).toBe(Infinity);
+            });
+            it('should return time since last update', async () => {
+                await handler.forceUpdate('manual_refresh');
+                // Wait a bit
+                await new Promise(resolve => setTimeout(resolve, 50));
+                const timeSince = handler.getTimeSinceLastUpdate();
+                expect(timeSince).toBeGreaterThanOrEqual(50);
+                expect(timeSince).toBeLessThan(1000);
+            });
+        });
+        describe('getStats', () => {
+            it('should return correct stats', async () => {
+                await handler.forceUpdate('manual_refresh');
+                await new Promise(resolve => setTimeout(resolve, MIN_UPDATE_INTERVAL_MS + 10));
+                await handler.forceUpdate('phase_transition');
+                const stats = handler.getStats();
+                expect(stats.enabled).toBe(true);
+                expect(stats.historyCount).toBe(2);
+                expect(stats.triggerCounts.manual_refresh).toBe(1);
+                expect(stats.triggerCounts.phase_transition).toBe(1);
+            });
+            it('should track listener count', () => {
+                const listener = vi.fn();
+                handler.addListener(listener);
+                const stats = handler.getStats();
+                expect(stats.listenerCount).toBe(1);
+            });
+        });
+        describe('reset', () => {
+            it('should clear all state', async () => {
+                handler.addListener(() => { });
+                handler.setNotificationCallback(() => { });
+                await handler.forceUpdate('manual_refresh');
+                handler.reset();
+                const stats = handler.getStats();
+                expect(stats.historyCount).toBe(0);
+                expect(stats.listenerCount).toBe(0);
+                expect(handler.getTimeSinceLastUpdate()).toBe(Infinity);
+            });
+        });
+    });
+    describe('Helper Functions', () => {
+        describe('notifyPhaseTransition', () => {
+            it('should trigger update with phase_transition', async () => {
+                const result = await notifyPhaseTransition();
+                expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            });
+        });
+        describe('notifyFeatureFlagChange', () => {
+            it('should trigger update with feature_flag_change', async () => {
+                const result = await notifyFeatureFlagChange();
+                expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            });
+        });
+        describe('notifyToolRegistration', () => {
+            it('should trigger update with tool_registration', async () => {
+                const result = await notifyToolRegistration();
+                expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            });
+        });
+        describe('notifyFocusChange', () => {
+            it('should trigger update with focus_change', async () => {
+                const result = await notifyFocusChange();
+                expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            });
+        });
+        describe('manualRefresh', () => {
+            it('should trigger immediate update', async () => {
+                const result = await manualRefresh();
+                expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+            });
+        });
+        describe('createListChangedNotification', () => {
+            it('should create valid notification', () => {
+                const notification = createListChangedNotification();
+                expect(notification.type).toBe('tools/list_changed');
+                expect(notification.timestamp).toBeTruthy();
+                expect(new Date(notification.timestamp)).toBeInstanceOf(Date);
+            });
+        });
+        describe('formatDynamicUpdateResult', () => {
+            it('should format result correctly', () => {
+                const result = {
+                    toolsRefreshed: 42,
+                    cachesCleared: ['phase_cache', 'tool_cache'],
+                    durationMs: 15,
+                    notificationSent: true,
+                };
+                const formatted = formatDynamicUpdateResult(result);
+                expect(formatted).toContain('Dynamic Update Result');
+                expect(formatted).toContain('Tools refreshed: 42');
+                expect(formatted).toContain('phase_cache, tool_cache');
+                expect(formatted).toContain('Duration: 15ms');
+                expect(formatted).toContain('Notification sent: yes');
+            });
+            it('should handle empty caches', () => {
+                const result = {
+                    toolsRefreshed: 0,
+                    cachesCleared: [],
+                    durationMs: 0,
+                    notificationSent: false,
+                };
+                const formatted = formatDynamicUpdateResult(result);
+                expect(formatted).toContain('Caches cleared: none');
+                expect(formatted).toContain('Notification sent: no');
+            });
+        });
+    });
+    describe('Global Instance', () => {
+        it('should expose global dynamicUpdateHandler', () => {
+            expect(dynamicUpdateHandler).toBeInstanceOf(DynamicUpdateHandler);
+        });
+        it('should allow using global instance', async () => {
+            const result = await dynamicUpdateHandler.forceUpdate('manual_refresh');
+            expect(result.cachesCleared.length).toBeGreaterThanOrEqual(0);
+        });
+    });
+});
+//# sourceMappingURL=dynamic-updates.test.js.map

package/dist/mcp/__tests__/dynamic-updates.test.js.map

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

package/dist/mcp/dynamic-updates.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Dynamic MCP Tool Updates - v14.0.0
+ *
+ * Handles dynamic tool list updates and cache invalidation.
+ * When tools change (due to phase transitions or feature flag changes),
+ * this module notifies clients via the tools/list_changed notification.
+ *
+ * Features:
+ * - ListChanged notification support
+ * - Phase cache invalidation
+ * - Registry refresh coordination
+ * - Debounced update handling
+ *
+ * Reference: MCP Protocol tools/list_changed notification
+ */
+/**
+ * List changed notification
+ */
+export interface ListChangedNotification {
+    type: 'tools/list_changed';
+    timestamp: string;
+}
+/**
+ * Dynamic update result
+ */
+export interface DynamicUpdateResult {
+    toolsRefreshed: number;
+    cachesCleared: string[];
+    durationMs: number;
+    notificationSent: boolean;
+}
+/**
+ * Update trigger reason
+ */
+export type UpdateTrigger = 'phase_transition' | 'feature_flag_change' | 'tool_registration' | 'manual_refresh' | 'focus_change';
+/**
+ * Update listener callback
+ */
+export type UpdateListener = (result: DynamicUpdateResult) => void;
+/**
+ * Feature flag for dynamic updates
+ */
+export declare const DYNAMIC_UPDATES_FEATURE_FLAG = "enableDynamicToolUpdates";
+/**
+ * Minimum interval between updates (ms)
+ */
+export declare const MIN_UPDATE_INTERVAL_MS = 100;
+/**
+ * Default debounce delay for updates (ms)
+ */
+export declare const DEFAULT_DEBOUNCE_MS = 50;
+/**
+ * Handler for dynamic MCP tool updates
+ *
+ * Coordinates tool list refreshes and cache invalidation when
+ * the available tools change.
+ */
+export declare class DynamicUpdateHandler {
+    private lastUpdateTime;
+    private pendingUpdate;
+    private pendingResolvers;
+    private listeners;
+    private updateHistory;
+    private maxHistorySize;
+    private enabled;
+    private notificationCallback;
+    /**
+     * Enable or disable dynamic updates
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if dynamic updates are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Set the notification callback for sending list_changed notifications
+     */
+    setNotificationCallback(callback: (notification: ListChangedNotification) => void): void;
+    /**
+     * Add a listener for update events
+     */
+    addListener(listener: UpdateListener): void;
+    /**
+     * Remove an update listener
+     */
+    removeListener(listener: UpdateListener): void;
+    /**
+     * Handle a list changed event
+     *
+     * This is the main entry point for triggering dynamic updates.
+     * Debounces rapid updates to avoid excessive cache clearing.
+     * All pending promises resolve with the same result when the debounced update executes.
+     */
+    handleListChanged(trigger: UpdateTrigger): Promise<DynamicUpdateResult>;
+    /**
+     * Execute the actual update
+     */
+    private executeUpdate;
+    /**
+     * Force an immediate update without debouncing
+     */
+    forceUpdate(trigger: UpdateTrigger): Promise<DynamicUpdateResult>;
+    /**
+     * Record update in history
+     */
+    private recordUpdate;
+    /**
+     * Get update history
+     */
+    getHistory(): Array<{
+        timestamp: string;
+        trigger: UpdateTrigger;
+        result: DynamicUpdateResult;
+    }>;
+    /**
+     * Get time since last update (ms)
+     */
+    getTimeSinceLastUpdate(): number;
+    /**
+     * Get stats about dynamic updates
+     */
+    getStats(): {
+        enabled: boolean;
+        lastUpdateTime: number;
+        timeSinceLastUpdate: number;
+        historyCount: number;
+        listenerCount: number;
+        triggerCounts: Record<UpdateTrigger, number>;
+    };
+    /**
+     * Clear handler state (for testing)
+     */
+    reset(): void;
+}
+/**
+ * Global dynamic update handler instance
+ */
+export declare const dynamicUpdateHandler: DynamicUpdateHandler;
+/**
+ * Trigger a dynamic update from phase transition
+ */
+export declare function notifyPhaseTransition(): Promise<DynamicUpdateResult>;
+/**
+ * Trigger a dynamic update from feature flag change
+ */
+export declare function notifyFeatureFlagChange(): Promise<DynamicUpdateResult>;
+/**
+ * Trigger a dynamic update from tool registration
+ */
+export declare function notifyToolRegistration(): Promise<DynamicUpdateResult>;
+/**
+ * Trigger a dynamic update from focus change
+ */
+export declare function notifyFocusChange(): Promise<DynamicUpdateResult>;
+/**
+ * Trigger a manual refresh
+ */
+export declare function manualRefresh(): Promise<DynamicUpdateResult>;
+/**
+ * Create list_changed notification for sending to client
+ */
+export declare function createListChangedNotification(): ListChangedNotification;
+/**
+ * Format dynamic update result for display
+ */
+export declare function formatDynamicUpdateResult(result: DynamicUpdateResult): string;
+//# sourceMappingURL=dynamic-updates.d.ts.map

package/dist/mcp/dynamic-updates.d.ts.map

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