@1mcp/agent 0.32.2 → 0.33.0-beta1

package/build/core/configChangeHandler.js

@@ -51,16 +51,19 @@ export class ConfigChangeHandler {
         logger.info(`Processing ${changes.length} configuration changes`);
         // Get the latest configuration for all operations
         const newConfig = this.configManager.getTransportConfig();
+        const appliedChanges = [];
         for (const change of changes) {
             try {
-                await this.processChange(change, newConfig);
+                if (await this.processChange(change, newConfig)) {
+                    appliedChanges.push(change);
+                }
             }
             catch (error) {
                 logger.error(`Failed to process change for server ${change.serverName}: ${error}`);
             }
         }
         // Notify clients if capabilities changed
-        await this.notifyClientsIfNeeded(changes, newConfig);
+        await this.notifyClientsIfNeeded(appliedChanges, newConfig);
     }
     /**
      * Process a single configuration change
@@ -73,19 +76,31 @@ export class ConfigChangeHandler {
             meta: { change, fieldsChanged },
         }));
         switch (change.type) {
-            case ConfigChangeType.ADDED:
-                await this.handleServerAdded(change.serverName, newConfig[change.serverName]);
-                break;
+            case ConfigChangeType.ADDED: {
+                const config = newConfig[change.serverName];
+                if (!config) {
+                    logger.warn(`Skipping added server ${change.serverName}: server configuration is missing after reload`);
+                    return false;
+                }
+                await this.handleServerAdded(change.serverName, config);
+                return true;
+            }
             case ConfigChangeType.REMOVED:
                 await this.handleServerRemoved(change.serverName);
-                break;
-            case ConfigChangeType.MODIFIED:
-                await this.handleServerModified(change.serverName, newConfig[change.serverName], change.fieldsChanged);
-                break;
+                return true;
+            case ConfigChangeType.MODIFIED: {
+                const config = newConfig[change.serverName];
+                if (!config) {
+                    logger.warn(`Skipping modified server ${change.serverName}: server configuration is missing after reload`);
+                    return false;
+                }
+                await this.handleServerModified(change.serverName, config, change.fieldsChanged);
+                return true;
+            }
             default: {
                 const _exhaustive = change;
                 logger.warn(`Unknown change type: ${String(_exhaustive)}`);
-                break;
+                return false;
             }
         }
     }
@@ -267,6 +282,7 @@ export class ConfigChangeHandler {
             const { AgentConfigManager } = await import('../core/server/agentConfig.js');
             const { NotificationManager } = await import('../core/notifications/notificationManager.js');
             const { CapabilityAggregator } = await import('../core/capabilities/capabilityAggregator.js');
+            const { createCapabilityNotificationFacts } = await import('../core/capabilities/capabilityNotificationFacts.js');
             const agentConfig = AgentConfigManager.getInstance();
             if (!agentConfig.get('features').clientNotifications) {
                 debugIf('Client notifications disabled, skipping listChanged notifications');
@@ -277,13 +293,14 @@ export class ConfigChangeHandler {
             // Calculate new capabilities
             const capabilityAggregator = new CapabilityAggregator(outboundConnections);
             const changes = await capabilityAggregator.updateCapabilities();
+            const notificationFacts = createCapabilityNotificationFacts(changes);
             if (changes.hasChanges) {
                 debugIf(() => ({
                     message: 'Sending listChanged notifications to clients',
                     meta: {
-                        toolsChanged: changes.current.tools.length > 0,
-                        resourcesChanged: changes.current.resources.length > 0,
-                        promptsChanged: changes.current.prompts.length > 0,
+                        toolsChanged: notificationFacts.refresh.shouldNotifyListChanged,
+                        resourcesChanged: notificationFacts.resourcesChanged,
+                        promptsChanged: notificationFacts.promptsChanged,
                     },
                 }));
                 // Send notifications to all inbound connections
@@ -291,9 +308,9 @@ export class ConfigChangeHandler {
                     try {
                         const notificationManager = new NotificationManager(inboundConnection);
                         notificationManager.handleCapabilityChanges({
-                            toolsChanged: changes.current.tools.length > 0,
-                            resourcesChanged: changes.current.resources.length > 0,
-                            promptsChanged: changes.current.prompts.length > 0,
+                            toolsChanged: notificationFacts.refresh.shouldNotifyListChanged,
+                            resourcesChanged: notificationFacts.resourcesChanged,
+                            promptsChanged: notificationFacts.promptsChanged,
                             hasChanges: true,
                             addedServers: changes.addedServers,
                             removedServers: changes.removedServers,

package/build/core/configChangeHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"configChangeHandler.js","sourceRoot":"","sources":["../../src/core/configChangeHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,QAAQ,CAAsB;IACrC,aAAa,CAAgB;IAErC;;OAEG;IACH,YAAoB,aAA6B;QAC/C,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;QAElE,2BAA2B;QAC3B,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,aAA6B;QACrD,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAClC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,sCAAsC;QACtC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAAC,OAAuB;QACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,MAAM,wBAAwB,CAAC,CAAC;QAElE,kDAAkD;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAE1D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,MAAoB,EAAE,SAA0C;QAC1F,iEAAiE;QACjE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpF,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACb,OAAO,EAAE,cAAc,MAAM,CAAC,IAAI,sBAAsB,MAAM,CAAC,UAAU,EAAE;YAC3E,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;SAChC,CAAC,CAAC,CAAC;QAEJ,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,gBAAgB,CAAC,KAAK;gBACzB,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC9E,MAAM;YAER,KAAK,gBAAgB,CAAC,OAAO;gBAC3B,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAClD,MAAM;YAER,KAAK,gBAAgB,CAAC,QAAQ;gBAC5B,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;gBACvG,MAAM;YAER,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,WAAW,GAAU,MAAM,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC3D,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB,CAAC,UAAkB,EAAE,MAAuB;QACzE,MAAM,CAAC,IAAI,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAClD,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAClD,MAAM,CAAC,IAAI,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,UAAkB,EAClB,MAAuB,EACvB,aAAiC;QAEjC,kCAAkC;QAClC,MAAM,eAAe,GAAG,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE5D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,sBAAsB;YACtB,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxC,wBAAwB;YACxB,MAAM,CAAC,IAAI,CAAC,iCAAiC,UAAU,EAAE,EAAE;gBACzD,MAAM,EAAE;oBACN,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B;aACF,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,4DAA4D;QAC5D,IAAI,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,2CAA2C,UAAU,EAAE,CAAC,CAAC;YACrE,uEAAuE;YACvE,iEAAiE;YACjE,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,sDAAsD;YACtD,MAAM,CAAC,IAAI,CAAC,sDAAsD,UAAU,EAAE,CAAC,CAAC;YAChF,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,aAAiC;QAC7D,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,CAAC,gEAAgE;QAC/E,CAAC;QAED,yCAAyC;QACzC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACvE,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,UAAkB,EAAE,MAAuB;QAC5E,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACb,OAAO,EAAE,gCAAgC,UAAU,EAAE;gBACrD,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;aAC/B,CAAC,CAAC,CAAC;YAEJ,+DAA+D;YAC/D,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,CAAC,mCAAmC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACrE,CAAC;YAED,gDAAgD;YAChD,IAAI,CAAC,gCAAgC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAE1D,wEAAwE;YACxE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YAEhF,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACb,OAAO,EAAE,4CAA4C,UAAU,EAAE;gBACjE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;aAC/B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,wCAAwC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mCAAmC,CAAC,UAAkB,EAAE,MAAuB;QAC3F,IAAI,CAAC;YACH,uDAAuD;YACvD,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAEvE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACb,OAAO,EAAE,6DAA6D,UAAU,EAAE;gBAClF,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,yDAAyD,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3F,4DAA4D;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gCAAgC,CAAC,UAAkB,EAAE,MAAuB;QAClF,IAAI,CAAC;YACH,6DAA6D;YAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,CAAC;YAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAEjD,IAAI,UAAU,EAAE,CAAC;gBACf,yCAAyC;gBACzC,IAAI,UAAU,CAAC,SAAS,IAAI,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;oBAC3D,6CAA6C;oBAC7C,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC1C,CAAC;gBAED,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;oBACb,OAAO,EAAE,mDAAmD,UAAU,EAAE;oBACxE,IAAI,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;iBAChE,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qDAAqD,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YACvF,4DAA4D;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,6BAA6B,CAAC,UAAkB;QAC5D,IAAI,CAAC;YACH,gGAAgG;YAChG,MAAM,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mDAAmD,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,OAAuB,EACvB,UAA2C;QAE3C,kEAAkE;QAClE,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACnD,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBACvF,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBAC9C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;gBAC3C,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,IAAI,oBAAoB,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,4BAA4B;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YAC/E,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,gDAAgD,CAAC,CAAC;YAC/F,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,gDAAgD,CAAC,CAAC;YAEhG,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,mBAAmB,EAAE,CAAC;gBACrD,OAAO,CAAC,mEAAmE,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,qBAAqB,EAAE,CAAC;YAC3E,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,CAAC;YAEjE,6BAA6B;YAC7B,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;YAC3E,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,EAAE,CAAC;YAEhE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;oBACb,OAAO,EAAE,8CAA8C;oBACvD,IAAI,EAAE;wBACJ,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;wBAC9C,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;wBACtD,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;qBACnD;iBACF,CAAC,CAAC,CAAC;gBAEJ,gDAAgD;gBAChD,KAAK,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,kBAAkB,EAAE,CAAC;oBAChE,IAAI,CAAC;wBACH,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;wBACvE,mBAAmB,CAAC,uBAAuB,CAAC;4BAC1C,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;4BAC9C,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;4BACtD,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;4BAClD,UAAU,EAAE,IAAI;4BAChB,YAAY,EAAE,OAAO,CAAC,YAAY;4BAClC,cAAc,EAAE,OAAO,CAAC,cAAc;4BACtC,OAAO,EAAE,OAAO,CAAC,OAAO;4BACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;yBAC3B,CAAC,CAAC;oBACL,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,KAAK,CAAC,uDAAuD,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;oBAC7F,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6CAA6C,KAAK,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI;QACf,yBAAyB;QACzB,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"configChangeHandler.js","sourceRoot":"","sources":["../../src/core/configChangeHandler.ts"],"names":[],"mappings":"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"}

package/build/core/filtering/filterSelection.d.ts

@@ -0,0 +1,72 @@
+import type { InboundConnectionConfig } from '../../core/types/index.js';
+import { TagExpression } from '../../domains/preset/parsers/tagQueryParser.js';
+import type { PresetStrategy, TagQuery } from '../../domains/preset/types/presetTypes.js';
+export type FilterSelectionMode = 'preset' | 'advanced' | 'simple-or' | 'none';
+export type FilterSelectorName = 'preset' | 'tag-filter' | 'filter' | 'tags';
+export interface FilterSelectorInputs {
+    preset?: unknown;
+    tagFilter?: unknown;
+    filter?: unknown;
+    tags?: unknown;
+}
+export interface FilterSelectionPreset {
+    name: string;
+    strategy: PresetStrategy;
+    tagQuery: TagQuery;
+    expression?: string;
+}
+export interface FilterSelectionPresetLookup {
+    getPreset(name: string): FilterSelectionPreset | undefined;
+}
+export interface FilterSelectionCompatibilityLocals {
+    tags?: string[];
+    tagExpression?: TagExpression;
+    tagQuery?: TagQuery;
+    tagFilterMode: FilterSelectionMode;
+    presetName?: string;
+    tagWarnings: string[];
+}
+export interface FilterSelection {
+    mode: FilterSelectionMode;
+    requestedTags: string[];
+    tags?: string[];
+    tagExpression?: TagExpression;
+    tagQuery?: TagQuery;
+    presetName?: string;
+    compatibility: FilterSelectionCompatibilityLocals;
+    runtimeConfig: InboundConnectionConfig;
+}
+export type FilterSelectionError = {
+    code: 'multiple_selectors';
+    message: string;
+    selectors: FilterSelectorName[];
+} | {
+    code: 'invalid_selector';
+    selector: FilterSelectorName;
+    message: string;
+    details?: Record<string, unknown>;
+} | {
+    code: 'preset_not_found';
+    selector: 'preset';
+    message: string;
+} | {
+    code: 'invalid_preset';
+    selector: 'preset';
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type FilterSelectionResult = {
+    ok: true;
+    selection: FilterSelection;
+} | {
+    ok: false;
+    error: FilterSelectionError;
+};
+export interface ResolveFilterSelectionOptions {
+    presetLookup?: FilterSelectionPresetLookup;
+    allowUnknownPreset?: boolean;
+}
+export declare function resolveFilterSelection(inputs: FilterSelectorInputs, options?: ResolveFilterSelectionOptions): FilterSelectionResult;
+export declare function getRequestedTagsFromExpression(expression: TagExpression): string[];
+export declare function getRequestedTagsFromQuery(query: TagQuery): string[];
+//# sourceMappingURL=filterSelection.d.ts.map

package/build/core/filtering/filterSelection.d.ts.map

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

package/build/core/filtering/filterSelection.js

@@ -0,0 +1,262 @@
+import { TagQueryEvaluator } from '../../domains/preset/parsers/tagQueryEvaluator.js';
+import { TagQueryParser } from '../../domains/preset/parsers/tagQueryParser.js';
+import { validateAndSanitizeTags } from '../../utils/validation/sanitization.js';
+const MULTIPLE_SELECTORS_MESSAGE = 'Cannot use multiple filtering parameters simultaneously. Use "preset" for dynamic presets, "tag-filter" for advanced expressions, "filter" for legacy compatibility, or "tags" for simple OR filtering.';
+export function resolveFilterSelection(inputs, options = {}) {
+    const selectors = getPresentSelectors(inputs);
+    if (selectors.length > 1) {
+        return {
+            ok: false,
+            error: {
+                code: 'multiple_selectors',
+                message: MULTIPLE_SELECTORS_MESSAGE,
+                selectors,
+            },
+        };
+    }
+    const selector = selectors[0];
+    if (!selector) {
+        return { ok: true, selection: createSelection({ mode: 'none', requestedTags: [] }) };
+    }
+    switch (selector) {
+        case 'preset':
+            return resolvePresetSelection(inputs.preset, options.presetLookup, options.allowUnknownPreset);
+        case 'tag-filter':
+            return resolveAdvancedSelection(inputs.tagFilter, 'tag-filter');
+        case 'filter':
+            return resolveLegacyFilterSelection(inputs.filter);
+        case 'tags':
+            return resolveSimpleTagsSelection(inputs.tags, 'tags', 'Invalid tags');
+    }
+}
+export function getRequestedTagsFromExpression(expression) {
+    const tags = new Set();
+    function visit(expr) {
+        if (expr.type === 'tag') {
+            if (expr.value) {
+                tags.add(expr.value);
+            }
+            return;
+        }
+        for (const child of expr.children ?? []) {
+            visit(child);
+        }
+    }
+    visit(expression);
+    return Array.from(tags);
+}
+export function getRequestedTagsFromQuery(query) {
+    const tags = new Set();
+    function addTag(value) {
+        if (typeof value === 'string' && value.trim()) {
+            tags.add(value.trim().toLowerCase());
+        }
+    }
+    function visit(value) {
+        if (!value || typeof value !== 'object') {
+            return;
+        }
+        const node = value;
+        addTag(node.tag);
+        for (const child of node.$or ?? []) {
+            visit(child);
+        }
+        for (const child of node.$and ?? []) {
+            visit(child);
+        }
+        visit(node.$not);
+        for (const tag of node.$in ?? []) {
+            addTag(tag);
+        }
+        for (const [key, nested] of Object.entries(node)) {
+            if (key === 'tag' || key === '$or' || key === '$and' || key === '$not' || key === '$in') {
+                continue;
+            }
+            if (key === '$advanced' && typeof nested === 'string') {
+                try {
+                    getRequestedTagsFromExpression(TagQueryParser.parseAdvanced(nested)).forEach((tag) => tags.add(tag));
+                }
+                catch {
+                    // Validation of advanced preset strings happens elsewhere; keep extraction best-effort.
+                }
+                continue;
+            }
+            if (!nested || typeof nested !== 'object') {
+                continue;
+            }
+            const fieldQuery = nested;
+            if (Array.isArray(fieldQuery.$in)) {
+                fieldQuery.$in.forEach(addTag);
+            }
+            addTag(fieldQuery.$not);
+            visit(fieldQuery.$not);
+        }
+    }
+    visit(query);
+    return Array.from(tags);
+}
+function getPresentSelectors(inputs) {
+    const selectors = [];
+    if (inputs.preset !== undefined)
+        selectors.push('preset');
+    if (inputs.tagFilter !== undefined)
+        selectors.push('tag-filter');
+    if (inputs.filter !== undefined)
+        selectors.push('filter');
+    if (inputs.tags !== undefined)
+        selectors.push('tags');
+    return selectors;
+}
+function resolvePresetSelection(rawPreset, presetLookup, allowUnknownPreset = false) {
+    if (typeof rawPreset !== 'string') {
+        return invalidSelector('preset', 'Invalid params: preset must be a string');
+    }
+    const presetName = rawPreset.trim();
+    if (!presetName) {
+        return invalidSelector('preset', 'Invalid params: preset cannot be empty');
+    }
+    const preset = presetLookup?.getPreset(presetName);
+    if (!preset) {
+        if (allowUnknownPreset) {
+            return {
+                ok: true,
+                selection: createSelection({
+                    mode: 'preset',
+                    requestedTags: [],
+                    presetName,
+                }),
+            };
+        }
+        return {
+            ok: false,
+            error: {
+                code: 'preset_not_found',
+                selector: 'preset',
+                message: `Preset '${presetName}' not found`,
+            },
+        };
+    }
+    const validation = TagQueryEvaluator.validateQuery(preset.tagQuery);
+    if (!validation.isValid) {
+        return {
+            ok: false,
+            error: {
+                code: 'invalid_preset',
+                selector: 'preset',
+                message: `Preset '${presetName}' has invalid tag query`,
+                details: { errors: validation.errors },
+            },
+        };
+    }
+    const requestedTags = getRequestedTagsFromQuery(preset.tagQuery);
+    return {
+        ok: true,
+        selection: createSelection({
+            mode: 'preset',
+            requestedTags,
+            tags: requestedTags,
+            tagQuery: preset.tagQuery,
+            presetName,
+        }),
+    };
+}
+function resolveAdvancedSelection(rawExpression, selector) {
+    if (typeof rawExpression !== 'string') {
+        return invalidSelector(selector, `Invalid params: ${selector} must be a string`);
+    }
+    try {
+        const tagExpression = TagQueryParser.parseAdvanced(rawExpression);
+        return {
+            ok: true,
+            selection: createSelection({
+                mode: 'advanced',
+                requestedTags: getRequestedTagsFromExpression(tagExpression),
+                tags: tagExpression.type === 'tag' && tagExpression.value ? [tagExpression.value] : undefined,
+                tagExpression,
+            }),
+        };
+    }
+    catch (error) {
+        return invalidSelector(selector, `Invalid ${selector}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+function resolveLegacyFilterSelection(rawFilter) {
+    if (typeof rawFilter !== 'string') {
+        return invalidSelector('filter', 'Invalid params: filter must be a string');
+    }
+    const advancedResult = resolveAdvancedSelection(rawFilter, 'filter');
+    if (advancedResult.ok) {
+        return advancedResult;
+    }
+    const simpleResult = resolveSimpleTagsSelection(rawFilter, 'filter', 'Invalid filter');
+    if (simpleResult.ok) {
+        return simpleResult;
+    }
+    return simpleResult.error.code === 'invalid_selector'
+        ? simpleResult
+        : invalidSelector('filter', 'Invalid filter: empty or malformed filter expression');
+}
+function resolveSimpleTagsSelection(rawTags, selector, messagePrefix) {
+    if (typeof rawTags !== 'string') {
+        return invalidSelector(selector, `Invalid params: ${selector} must be a string`);
+    }
+    const parsedTags = TagQueryParser.parseSimple(rawTags);
+    if (parsedTags.length === 0) {
+        return invalidSelector(selector, `${messagePrefix}: empty or malformed filter expression`);
+    }
+    const validation = validateAndSanitizeTags(parsedTags);
+    if (validation.errors.length > 0) {
+        return invalidSelector(selector, `${messagePrefix}: ${validation.errors.join('; ')}`, {
+            errors: validation.errors,
+            warnings: validation.warnings,
+            invalidTags: validation.invalidTags,
+        });
+    }
+    return {
+        ok: true,
+        selection: createSelection({
+            mode: 'simple-or',
+            requestedTags: validation.validTags,
+            tags: validation.validTags.length > 0 ? validation.validTags : undefined,
+            tagWarnings: validation.warnings,
+        }),
+    };
+}
+function createSelection(input) {
+    const compatibility = {
+        tags: input.tags,
+        tagExpression: input.tagExpression,
+        tagQuery: input.tagQuery,
+        tagFilterMode: input.mode,
+        presetName: input.presetName,
+        tagWarnings: input.tagWarnings ?? [],
+    };
+    return {
+        mode: input.mode,
+        requestedTags: input.requestedTags,
+        tags: input.tags,
+        tagExpression: input.tagExpression,
+        tagQuery: input.tagQuery,
+        presetName: input.presetName,
+        compatibility,
+        runtimeConfig: {
+            tags: input.tags,
+            tagExpression: input.tagExpression,
+            tagQuery: input.tagQuery,
+            tagFilterMode: input.mode,
+            presetName: input.presetName,
+        },
+    };
+}
+function invalidSelector(selector, message, details) {
+    return {
+        ok: false,
+        error: {
+            code: 'invalid_selector',
+            selector,
+            message,
+            ...(details ? { details } : {}),
+        },
+    };
+}
+//# sourceMappingURL=filterSelection.js.map

package/build/core/filtering/filterSelection.js.map

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

package/build/core/instructions/instructionsDistribution.d.ts

@@ -0,0 +1,52 @@
+export interface InstructionServerSummary {
+    server: string;
+    type?: string;
+    status?: string;
+    available?: boolean;
+    toolCount: number;
+    hasInstructions: boolean;
+}
+export interface InstructionServerInspectResult {
+    kind: 'server';
+    server: string;
+    type?: string;
+    status?: string;
+    available?: boolean;
+    instructions?: string | null;
+    tools: unknown[];
+    totalTools?: number;
+}
+export interface NonServerInstructionInspectResult {
+    kind: Exclude<string, 'server'>;
+}
+export interface InstructionServerDetail extends InstructionServerSummary {
+    instructions?: string | null;
+    note?: string;
+}
+export interface AssembleInstructionDetailInput {
+    summary: InstructionServerSummary;
+    inspected?: InstructionServerInspectResult;
+    cachedInstructions?: string;
+    inspectFailed?: boolean;
+}
+export interface CollectInstructionDetailsInput {
+    servers: InstructionServerSummary[];
+    cachedInstructions?: Record<string, string>;
+    inspectServer: (server: string) => Promise<InstructionServerInspectResult | NonServerInstructionInspectResult>;
+}
+export type InstructionsDistributionTarget = 'codex' | 'claude';
+export type InstructionsDistributionScope = 'global' | 'repo';
+export interface RenderStartupDocManagedBlockInput {
+    target: InstructionsDistributionTarget;
+    scope: InstructionsDistributionScope;
+    startupDocPath: string;
+    managedDocPath: string;
+}
+export declare function shouldEagerlyInspectServer(server: InstructionServerSummary): boolean;
+export declare function assembleInstructionDetail(input: AssembleInstructionDetailInput): InstructionServerDetail;
+export declare function collectInstructionDetails(input: CollectInstructionDetailsInput): Promise<InstructionServerDetail[]>;
+export declare function renderManagedDocContent(): string;
+export declare function renderStartupDocManagedBlock(startupDocPath: string, managedDocPath: string): string;
+export declare function renderStartupDocManagedBlockForClient(input: RenderStartupDocManagedBlockInput): string;
+export declare function upsertStartupDocManagedBlock(existingContent: string, managedBlock: string): string;
+//# sourceMappingURL=instructionsDistribution.d.ts.map

package/build/core/instructions/instructionsDistribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructionsDistribution.d.ts","sourceRoot":"","sources":["../../../src/core/instructions/instructionsDistribution.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,wBAAwB,CAAC;IAClC,SAAS,CAAC,EAAE,8BAA8B,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,8BAA8B,GAAG,iCAAiC,CAAC,CAAC;CAChH;AAED,MAAM,MAAM,8BAA8B,GAAG,OAAO,GAAG,QAAQ,CAAC;AAChE,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,8BAA8B,CAAC;IACvC,KAAK,EAAE,6BAA6B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAMpF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,8BAA8B,GAAG,uBAAuB,CA6BxG;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA0BpC;AAqBD,wBAAgB,uBAAuB,IAAI,MAAM,CAkBhD;AAED,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAOnG;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,iCAAiC,GAAG,MAAM,CAOtG;AAED,wBAAgB,4BAA4B,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAqBlG"}