@pellux/goodvibes-sdk 0.33.26 → 0.33.27

package/dist/platform/mcp/config.js

@@ -1,67 +1,186 @@
 /**
  * MCP server configuration — scans multiple locations in precedence order.
  */
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
 import { logger } from '../utils/logger.js';
 import { summarizeError } from '../utils/error-display.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function optionalStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === 'string')
+        ? [...value]
+        : undefined;
+}
+function optionalStringRecord(value) {
+    if (!isRecord(value))
+        return undefined;
+    const entries = Object.entries(value).filter((entry) => typeof entry[1] === 'string');
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function normalizeServerConfig(name, raw) {
+    if (typeof raw.command !== 'string' || !raw.command.trim())
+        return null;
+    return {
+        name,
+        command: raw.command,
+        args: optionalStringArray(raw.args) ?? [],
+        env: optionalStringRecord(raw.env),
+        role: typeof raw.role === 'string' ? raw.role : undefined,
+        trustMode: typeof raw.trustMode === 'string' ? raw.trustMode : undefined,
+        allowedPaths: optionalStringArray(raw.allowedPaths),
+        allowedHosts: optionalStringArray(raw.allowedHosts),
+    };
+}
+export function getMcpConfigLocations(roots) {
+    const cwd = roots.workingDirectory;
+    const home = roots.homeDirectory;
+    return [
+        {
+            scope: 'global',
+            kind: 'global-xdg',
+            path: join(home, '.config', 'mcp', 'mcp.json'),
+            writable: true,
+        },
+        {
+            scope: 'external',
+            kind: 'global-dotdir',
+            path: join(home, '.mcp', 'mcp.json'),
+            writable: false,
+        },
+        {
+            scope: 'external',
+            kind: 'claude-desktop',
+            path: join(home, '.config', 'claude', 'claude_desktop_config.json'),
+            writable: false,
+        },
+        {
+            scope: 'external',
+            kind: 'project-mcp',
+            path: join(cwd, '.mcp', 'mcp.json'),
+            writable: false,
+        },
+        {
+            scope: 'project',
+            kind: 'project-goodvibes',
+            path: join(cwd, '.goodvibes', 'mcp.json'),
+            writable: true,
+        },
+    ];
+}
+function writableMcpConfigLocation(roots, scope) {
+    const location = getMcpConfigLocations(roots).find((entry) => entry.scope === scope && entry.writable);
+    if (!location)
+        throw new Error(`No writable MCP config location is available for scope '${scope}'.`);
+    return location;
+}
+function parseMcpServers(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (isRecord(raw.mcpServers)) {
+        const servers = [];
+        for (const [name, value] of Object.entries(raw.mcpServers)) {
+            if (!isRecord(value))
+                continue;
+            const server = normalizeServerConfig(name, value);
+            if (server)
+                servers.push(server);
+        }
+        return servers;
+    }
+    if (isMcpConfig(raw))
+        return raw.servers.map((server) => ({ ...server }));
+    return null;
+}
+function readMcpConfigAtPath(path) {
+    if (!existsSync(path))
+        return { servers: [] };
+    const raw = JSON.parse(readFileSync(path, 'utf-8'));
+    const servers = parseMcpServers(raw);
+    return { servers: servers ?? [] };
+}
+function assertServerConfig(server) {
+    if (!server.name.trim())
+        throw new Error('MCP server name is required.');
+    if (server.name.includes(':') || server.name.includes('/')) {
+        throw new Error('MCP server name may not contain ":" or "/".');
+    }
+    if (!server.command.trim())
+        throw new Error('MCP server command is required.');
+}
+function writeMcpConfigFile(path, config) {
+    mkdirSync(dirname(path), { recursive: true });
+    const normalized = {
+        servers: config.servers.map((server) => {
+            assertServerConfig(server);
+            return {
+                name: server.name,
+                command: server.command,
+                ...(server.args !== undefined ? { args: [...server.args] } : {}),
+                ...(server.env !== undefined ? { env: { ...server.env } } : {}),
+                ...(server.role !== undefined ? { role: server.role } : {}),
+                ...(server.trustMode !== undefined ? { trustMode: server.trustMode } : {}),
+                ...(server.allowedPaths !== undefined ? { allowedPaths: [...server.allowedPaths] } : {}),
+                ...(server.allowedHosts !== undefined ? { allowedHosts: [...server.allowedHosts] } : {}),
+            };
+        }),
+    };
+    writeFileSync(path, `${JSON.stringify(normalized, null, 2)}\n`);
+}
 /**
  * loadMcpConfig - Scan multiple locations in precedence order (later wins).
  * Returns merged config from all found files. Returns empty config on failure.
  */
 export function loadMcpConfig(roots) {
-    const cwd = roots.workingDirectory;
-    const home = roots.homeDirectory;
-    // Scan locations in precedence order (later wins)
-    const locations = [
-        join(home, '.config', 'mcp', 'mcp.json'), // global XDG
-        join(home, '.mcp', 'mcp.json'), // global dotdir
-        join(home, '.config', 'claude', 'claude_desktop_config.json'), // Claude Desktop
-        join(cwd, '.mcp', 'mcp.json'), // project-local
-        join(cwd, '.goodvibes', 'mcp.json'), // goodvibes project
-    ];
-    const merged = { servers: [] };
+    return { servers: loadMcpEffectiveConfig(roots).servers.map((entry) => entry.server) };
+}
+export function loadMcpEffectiveConfig(roots) {
+    const locations = getMcpConfigLocations(roots);
     const serversByName = new Map();
-    for (const path of locations) {
+    for (const location of locations) {
         try {
-            if (!existsSync(path))
-                continue;
-            const raw = JSON.parse(readFileSync(path, 'utf-8'));
-            // Handle Claude Desktop format
-            if (typeof raw === 'object' && raw !== null && 'mcpServers' in raw) {
-                const obj = raw;
-                if (typeof obj['mcpServers'] === 'object' && obj['mcpServers'] !== null) {
-                    for (const [name, srv] of Object.entries(obj['mcpServers'])) {
-                        const s = srv;
-                        if (typeof s.command === 'string') {
-                            serversByName.set(name, {
-                                name,
-                                command: s.command,
-                                args: Array.isArray(s.args) ? s.args.filter((a) => typeof a === 'string') : [],
-                                env: typeof s.env === 'object' && s.env ? Object.fromEntries(Object.entries(s.env).filter(([, v]) => typeof v === 'string')) : undefined,
-                                role: typeof s.role === 'string' ? s.role : undefined,
-                                trustMode: typeof s.trustMode === 'string' ? s.trustMode : undefined,
-                                allowedPaths: Array.isArray(s.allowedPaths) ? s.allowedPaths.filter((v) => typeof v === 'string') : undefined,
-                                allowedHosts: Array.isArray(s.allowedHosts) ? s.allowedHosts.filter((v) => typeof v === 'string') : undefined,
-                            });
-                        }
-                    }
-                }
+            if (!existsSync(location.path))
                 continue;
-            }
-            // Handle goodvibes format
-            if (isMcpConfig(raw)) {
-                for (const srv of raw.servers) {
-                    serversByName.set(srv.name, srv);
-                }
+            const config = readMcpConfigAtPath(location.path);
+            for (const server of config.servers) {
+                serversByName.set(server.name, { server, source: location });
             }
         }
         catch (err) {
-            logger.warn(`[MCP] Failed to read ${path}`, { error: summarizeError(err) });
+            logger.warn(`[MCP] Failed to read ${location.path}`, { error: summarizeError(err) });
         }
     }
-    merged.servers = [...serversByName.values()];
-    return merged;
+    return {
+        servers: [...serversByName.values()],
+        locations,
+    };
+}
+export function loadWritableMcpConfig(roots, scope) {
+    const location = writableMcpConfigLocation(roots, scope);
+    return readMcpConfigAtPath(location.path);
+}
+export function upsertMcpServerConfig(roots, scope, server) {
+    assertServerConfig(server);
+    const location = writableMcpConfigLocation(roots, scope);
+    const current = readMcpConfigAtPath(location.path);
+    const nextServers = current.servers.filter((entry) => entry.name !== server.name);
+    nextServers.push({ ...server });
+    nextServers.sort((a, b) => a.name.localeCompare(b.name));
+    const config = { servers: nextServers };
+    writeMcpConfigFile(location.path, config);
+    return { path: location.path, config };
+}
+export function removeMcpServerConfig(roots, scope, serverName) {
+    if (!serverName.trim())
+        throw new Error('MCP server name is required.');
+    const location = writableMcpConfigLocation(roots, scope);
+    const current = readMcpConfigAtPath(location.path);
+    const config = { servers: current.servers.filter((entry) => entry.name !== serverName) };
+    const removed = config.servers.length !== current.servers.length;
+    if (removed || existsSync(location.path))
+        writeMcpConfigFile(location.path, config);
+    return { path: location.path, removed, config };
 }
 /** Type guard for McpConfig (goodvibes format) */
 function isMcpConfig(v) {

package/dist/platform/mcp/index.d.ts

@@ -1,8 +1,8 @@
 export { McpRegistry } from './registry.js';
-export type { RegisteredTool } from './registry.js';
+export type { McpReloadResult, McpReloadServerResult, RegisteredTool } from './registry.js';
 export { McpClient } from './client.js';
 export { createMcpApi } from './mcp-api.js';
 export type { McpApi, McpApiRegistry, McpSandboxBindingRecord, McpServerRecord, McpServerSecurityRecord, } from './mcp-api.js';
-export { loadMcpConfig } from './config.js';
-export type { McpConfig, McpConfigRoots, McpServerConfig } from './config.js';
+export { getMcpConfigLocations, loadMcpConfig, loadMcpEffectiveConfig, loadWritableMcpConfig, removeMcpServerConfig, upsertMcpServerConfig, } from './config.js';
+export type { McpConfig, McpConfigLocation, McpConfigRoots, McpConfigScope, McpEffectiveConfig, McpServerConfig, McpServerConfigEntry, } from './config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/platform/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,MAAM,EACN,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,MAAM,EACN,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/platform/mcp/index.js

@@ -1,4 +1,4 @@
 export { McpRegistry } from './registry.js';
 export { McpClient } from './client.js';
 export { createMcpApi } from './mcp-api.js';
-export { loadMcpConfig } from './config.js';
+export { getMcpConfigLocations, loadMcpConfig, loadMcpEffectiveConfig, loadWritableMcpConfig, removeMcpServerConfig, upsertMcpServerConfig, } from './config.js';

package/dist/platform/mcp/mcp-api.d.ts

@@ -1,4 +1,6 @@
 import type { RegisteredTool } from './registry.js';
+import type { McpConfigRoots, McpConfigScope, McpEffectiveConfig, McpServerConfig } from './config.js';
+import type { McpReloadResult } from './registry.js';
 import type { McpDecisionRecord, McpServerRole, McpTrustMode, QuarantineReason, SchemaFreshness } from '../runtime/mcp/types.js';
 export interface McpServerRecord {
     readonly name: string;
@@ -25,6 +27,17 @@ export interface McpSandboxBindingRecord {
     readonly startupStatus?: 'verified' | 'planned' | 'failed' | undefined;
 }
 export interface McpApi {
+    getEffectiveConfig(roots: McpConfigRoots): McpEffectiveConfig;
+    reload(roots: McpConfigRoots): Promise<McpReloadResult>;
+    upsertServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverConfig: McpServerConfig): Promise<{
+        readonly path: string;
+        readonly reload: McpReloadResult;
+    }>;
+    removeServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverName: string): Promise<{
+        readonly path: string;
+        readonly removed: boolean;
+        readonly reload: McpReloadResult;
+    }>;
     listServerNames(): readonly string[];
     listServers(): readonly McpServerRecord[];
     listServerSecurity(): readonly McpServerSecurityRecord[];
@@ -38,6 +51,17 @@ export interface McpApi {
 }
 export interface McpApiRegistry {
     readonly serverNames: readonly string[];
+    getEffectiveConfig(roots: McpConfigRoots): McpEffectiveConfig;
+    reload(roots: McpConfigRoots): Promise<McpReloadResult>;
+    upsertServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverConfig: McpServerConfig): Promise<{
+        readonly path: string;
+        readonly reload: McpReloadResult;
+    }>;
+    removeServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverName: string): Promise<{
+        readonly path: string;
+        readonly removed: boolean;
+        readonly reload: McpReloadResult;
+    }>;
     listServers(): readonly McpServerRecord[];
     listServerSecurity(): readonly McpServerSecurityRecord[];
     listServerSandboxBindings(): readonly McpSandboxBindingRecord[];

package/dist/platform/mcp/mcp-api.d.ts.map

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

package/dist/platform/mcp/mcp-api.js

@@ -1,5 +1,17 @@
 export function createMcpApi(registry) {
     return {
+        getEffectiveConfig(roots) {
+            return registry.getEffectiveConfig(roots);
+        },
+        reload(roots) {
+            return registry.reload(roots);
+        },
+        upsertServerConfig(roots, scope, serverConfig) {
+            return registry.upsertServerConfig(roots, scope, serverConfig);
+        },
+        removeServerConfig(roots, scope, serverName) {
+            return registry.removeServerConfig(roots, scope, serverName);
+        },
         listServerNames() {
             return registry.serverNames;
         },

package/dist/platform/mcp/registry.d.ts

@@ -1,11 +1,10 @@
 import { McpClient } from './client.js';
 import type { McpToolSchema } from './client.js';
-import type { McpServerConfig } from './config.js';
+import type { McpConfigRoots, McpConfigScope, McpEffectiveConfig, McpServerConfig } from './config.js';
 import type { HookDispatcher } from '../hooks/dispatcher.js';
 import type { McpDecisionRecord, QuarantineReason, SchemaFreshness } from '../runtime/mcp/types.js';
 import type { RuntimeEventBus } from '../runtime/events/index.js';
 import type { ConfigManager } from '../config/manager.js';
-import type { McpConfigRoots } from './config.js';
 import { type SandboxSessionRegistry } from '../runtime/sandbox/session-registry.js';
 export interface RegisteredTool {
     /** Fully-qualified tool name: mcp:<server>:<tool> */
@@ -14,8 +13,21 @@ export interface RegisteredTool {
     toolName: string;
     description: string;
 }
+export interface McpReloadServerResult {
+    readonly name: string;
+    readonly action: 'added' | 'changed' | 'removed' | 'unchanged';
+    readonly connected: boolean;
+}
+export interface McpReloadResult {
+    readonly added: number;
+    readonly changed: number;
+    readonly removed: number;
+    readonly unchanged: number;
+    readonly servers: readonly McpReloadServerResult[];
+}
 export declare class McpRegistry {
     private clients;
+    private serverConfigs;
     private permissions;
     private freshness;
     private runtimeBus;
@@ -39,6 +51,18 @@ export declare class McpRegistry {
      * Exposed for programmatic use (testing, dynamic registration).
      */
     connectServer(serverConfig: McpServerConfig): Promise<void>;
+    reload(roots: McpConfigRoots): Promise<McpReloadResult>;
+    getEffectiveConfig(roots: McpConfigRoots): McpEffectiveConfig;
+    upsertServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverConfig: McpServerConfig): Promise<{
+        readonly path: string;
+        readonly reload: McpReloadResult;
+    }>;
+    removeServerConfig(roots: McpConfigRoots, scope: McpConfigScope, serverName: string): Promise<{
+        readonly path: string;
+        readonly removed: boolean;
+        readonly reload: McpReloadResult;
+    }>;
+    applyConfig(serverConfigs: readonly McpServerConfig[]): Promise<McpReloadResult>;
     /**
      * listAllTools — Return all registered tools (name + description) from all connected servers.
      * Only loads tool names and descriptions — full schemas are NOT fetched here.
@@ -58,6 +82,7 @@ export declare class McpRegistry {
      * disconnectAll — Stop all connected MCP server processes.
      */
     disconnectAll(): Promise<void>;
+    disconnectServer(serverName: string, reason?: string): Promise<boolean>;
     /**
      * getClient — Get the McpClient for a given server name (for advanced use).
      */

package/dist/platform/mcp/registry.d.ts.map

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

package/dist/platform/mcp/registry.js

@@ -8,11 +8,11 @@
  * Tool namespace: mcp:<server-name>:<tool-name>
  */
 import { logger } from '../utils/logger.js';
-import { loadMcpConfig } from './config.js';
+import { loadMcpEffectiveConfig, removeMcpServerConfig, upsertMcpServerConfig, } from './config.js';
 import { McpClient } from './client.js';
 import { McpPermissionManager } from '../runtime/mcp/permissions.js';
 import { McpSchemaFreshnessTracker } from '../runtime/mcp/schema-freshness.js';
-import { emitMcpConfigured, emitMcpPolicyUpdated, emitMcpSchemaQuarantineApproved, emitMcpSchemaQuarantined, } from '../runtime/emitters/mcp.js';
+import { emitMcpConfigured, emitMcpDisconnected, emitMcpPolicyUpdated, emitMcpSchemaQuarantineApproved, emitMcpSchemaQuarantined, } from '../runtime/emitters/mcp.js';
 import { getSandboxConfigSnapshot } from '../runtime/sandbox/manager.js';
 import {} from '../runtime/sandbox/session-registry.js';
 import { resolveSandboxCommandPlan } from '../runtime/sandbox/backend.js';
@@ -20,8 +20,12 @@ import { summarizeError } from '../utils/error-display.js';
 function compactEnv(env) {
     return Object.fromEntries(Object.entries(env).filter((entry) => typeof entry[1] === 'string'));
 }
+function sameServerConfig(a, b) {
+    return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+}
 export class McpRegistry {
     clients = new Map();
+    serverConfigs = new Map();
     permissions = new McpPermissionManager();
     freshness = new McpSchemaFreshnessTracker();
     runtimeBus = null;
@@ -45,16 +49,74 @@ export class McpRegistry {
      * Errors on individual servers are logged but do not abort the whole startup.
      */
     async connectAll(roots) {
-        const mcpConfig = loadMcpConfig(roots);
-        await Promise.allSettled(mcpConfig.servers.map((serverConfig) => this._connectServer(serverConfig)));
+        await this.reload(roots);
     }
     /**
      * connectServer — Connect a single MCP server by config.
      * Exposed for programmatic use (testing, dynamic registration).
      */
     async connectServer(serverConfig) {
+        this.serverConfigs.set(serverConfig.name, serverConfig);
         await this._connectServer(serverConfig);
     }
+    async reload(roots) {
+        const effective = loadMcpEffectiveConfig(roots);
+        return this.applyConfig(effective.servers.map((entry) => entry.server));
+    }
+    getEffectiveConfig(roots) {
+        return loadMcpEffectiveConfig(roots);
+    }
+    async upsertServerConfig(roots, scope, serverConfig) {
+        const written = upsertMcpServerConfig(roots, scope, serverConfig);
+        return { path: written.path, reload: await this.reload(roots) };
+    }
+    async removeServerConfig(roots, scope, serverName) {
+        const written = removeMcpServerConfig(roots, scope, serverName);
+        return { path: written.path, removed: written.removed, reload: await this.reload(roots) };
+    }
+    async applyConfig(serverConfigs) {
+        const next = new Map(serverConfigs.map((serverConfig) => [serverConfig.name, serverConfig]));
+        const results = [];
+        let added = 0;
+        let changed = 0;
+        let removed = 0;
+        let unchanged = 0;
+        for (const name of [...this.serverConfigs.keys()]) {
+            if (next.has(name))
+                continue;
+            await this.disconnectServer(name, 'config-removed');
+            this.serverConfigs.delete(name);
+            removed += 1;
+            results.push({ name, action: 'removed', connected: false });
+        }
+        for (const [name, serverConfig] of next) {
+            const previous = this.serverConfigs.get(name);
+            if (previous && sameServerConfig(previous, serverConfig)) {
+                unchanged += 1;
+                const client = this.clients.get(name);
+                if (!client?.isConnected) {
+                    await this._connectServer(serverConfig);
+                }
+                results.push({ name, action: 'unchanged', connected: this.clients.get(name)?.isConnected ?? false });
+                continue;
+            }
+            if (previous) {
+                await this.disconnectServer(name, 'config-changed');
+                changed += 1;
+            }
+            else {
+                added += 1;
+            }
+            this.serverConfigs.set(name, serverConfig);
+            await this._connectServer(serverConfig);
+            results.push({
+                name,
+                action: previous ? 'changed' : 'added',
+                connected: this.clients.get(name)?.isConnected ?? false,
+            });
+        }
+        return { added, changed, removed, unchanged, servers: results };
+    }
     /**
      * listAllTools — Return all registered tools (name + description) from all connected servers.
      * Only loads tool names and descriptions — full schemas are NOT fetched here.
@@ -194,6 +256,38 @@ export class McpRegistry {
         }
         this.sandboxSessionByServer.clear();
     }
+    async disconnectServer(serverName, reason = 'manual') {
+        const client = this.clients.get(serverName);
+        if (!client)
+            return false;
+        await client.disconnect();
+        this.clients.delete(serverName);
+        const sessionId = this.sandboxSessionByServer.get(serverName);
+        if (sessionId) {
+            this.sandboxSessions.stop(sessionId);
+            this.sandboxSessionByServer.delete(serverName);
+        }
+        if (this.runtimeBus) {
+            emitMcpDisconnected(this.runtimeBus, {
+                sessionId: 'mcp-registry',
+                traceId: `mcp-registry:${serverName}:disconnected`,
+                source: 'mcp-registry',
+            }, { serverId: serverName, reason, willRetry: false });
+        }
+        const disconnectedEvent = {
+            path: 'Lifecycle:mcp:disconnected',
+            phase: 'Lifecycle',
+            category: 'mcp',
+            specific: 'disconnected',
+            sessionId: '',
+            timestamp: Date.now(),
+            payload: { server: serverName, reason },
+        };
+        this.hookDispatcher.fire(disconnectedEvent).catch((err) => {
+            logger.warn('Lifecycle:mcp:disconnected hook error', { error: summarizeError(err) });
+        });
+        return true;
+    }
     /**
      * getClient — Get the McpClient for a given server name (for advanced use).
      */
@@ -202,15 +296,15 @@ export class McpRegistry {
     }
     /** Connected server names. */
     get serverNames() {
-        return Array.from(this.clients.keys());
+        return Array.from(new Set([...this.serverConfigs.keys(), ...this.clients.keys()])).sort();
     }
     /**
      * listServers — Return status info for all known servers (connected or not).
      */
     listServers() {
-        return Array.from(this.clients.entries()).map(([name, client]) => ({
+        return this.serverNames.map((name) => ({
             name,
-            connected: client.isConnected,
+            connected: this.clients.get(name)?.isConnected ?? false,
         }));
     }
     listServerSecurity() {
@@ -283,10 +377,14 @@ export class McpRegistry {
     // ---------------------------------------------------------------------------
     async _connectServer(serverConfig) {
         const { name } = serverConfig;
-        if (this.clients.has(name)) {
+        const existing = this.clients.get(name);
+        if (existing?.isConnected) {
             logger.info('McpRegistry: server already registered', { name });
             return;
         }
+        if (existing) {
+            await this.disconnectServer(name, 'reconnect');
+        }
         let sandboxSessionId = null;
         let processSpec;
         if (this.sandboxConfigManager) {

package/dist/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.33.26';
+let version = '0.33.27';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.33.26",
+  "version": "0.33.27",
   "description": "TypeScript SDK for building GoodVibes operator, peer, web, mobile, and daemon-connected apps with typed contracts, auth, realtime events, and transport layers.",
   "keywords": [
     "goodvibes",
@@ -449,14 +449,14 @@
   "sideEffects": false,
   "type": "module",
   "dependencies": {
-    "@pellux/goodvibes-contracts": "0.33.26",
-    "@pellux/goodvibes-daemon-sdk": "0.33.26",
-    "@pellux/goodvibes-errors": "0.33.26",
-    "@pellux/goodvibes-operator-sdk": "0.33.26",
-    "@pellux/goodvibes-peer-sdk": "0.33.26",
-    "@pellux/goodvibes-transport-core": "0.33.26",
-    "@pellux/goodvibes-transport-http": "0.33.26",
-    "@pellux/goodvibes-transport-realtime": "0.33.26"
+    "@pellux/goodvibes-contracts": "0.33.27",
+    "@pellux/goodvibes-daemon-sdk": "0.33.27",
+    "@pellux/goodvibes-errors": "0.33.27",
+    "@pellux/goodvibes-operator-sdk": "0.33.27",
+    "@pellux/goodvibes-peer-sdk": "0.33.27",
+    "@pellux/goodvibes-transport-core": "0.33.27",
+    "@pellux/goodvibes-transport-http": "0.33.27",
+    "@pellux/goodvibes-transport-realtime": "0.33.27"
   },
   "optionalDependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",