@aexol/spectral 0.2.5 → 0.2.7

package/dist/mcp/proxy-modes.js

@@ -0,0 +1,714 @@
+import { getServerPrefix, parseUiPromptHandoff } from "./types.js";
+import { lazyConnect, updateServerMetadata, updateMetadataCache, getFailureAgeSeconds, updateStatusBar } from "./init.js";
+import { buildToolMetadata, getToolNames, findToolByName, formatSchema } from "./tool-metadata.js";
+import { transformMcpContent } from "./tool-registrar.js";
+import { maybeStartUiSession } from "./ui-session.js";
+import { formatAuthRequiredMessage, truncateAtWord } from "./utils.js";
+import { authenticate, supportsOAuth } from "./mcp-auth-flow.js";
+function getAuthRequiredMessage(state, serverName, defaultMessage = `Server "${serverName}" requires OAuth authentication. Run /mcp-auth ${serverName} first.`) {
+    return formatAuthRequiredMessage(state.config, serverName, defaultMessage);
+}
+function getAuthFailedMessage(state, serverName, message) {
+    const customGuidance = state.config.settings?.authRequiredMessage;
+    if (customGuidance) {
+        return `OAuth authentication failed for "${serverName}": ${message}. ${getAuthRequiredMessage(state, serverName)}`;
+    }
+    return `OAuth authentication failed for "${serverName}": ${message}. Run /mcp-auth ${serverName} first.`;
+}
+async function attemptAutoAuth(state, serverName) {
+    if (state.config.settings?.autoAuth !== true) {
+        return { status: "skipped" };
+    }
+    const definition = state.config.mcpServers[serverName];
+    if (!definition || !supportsOAuth(definition) || !definition.url) {
+        return { status: "skipped" };
+    }
+    const oauthConfig = definition.oauth;
+    const grantType = oauthConfig?.grantType ?? "authorization_code";
+    if (!state.ui && grantType !== "client_credentials") {
+        return {
+            status: "failed",
+            message: getAuthRequiredMessage(state, serverName, `Server "${serverName}" requires OAuth authentication. Run /mcp-auth ${serverName} in an interactive session.`),
+        };
+    }
+    try {
+        await authenticate(serverName, definition.url, definition);
+        return { status: "success" };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            status: "failed",
+            message: getAuthFailedMessage(state, serverName, message),
+        };
+    }
+}
+export function executeUiMessages(state) {
+    const sessions = state.completedUiSessions;
+    if (sessions.length === 0) {
+        return {
+            content: [{ type: "text", text: "No UI session messages available." }],
+            details: { sessions: 0 },
+        };
+    }
+    const output = [];
+    output.push(`UI Session Messages (${sessions.length} session${sessions.length > 1 ? "s" : ""}):\n`);
+    const allPrompts = [];
+    const allIntents = sessions.flatMap((session) => session.messages.intents);
+    const parsedHandoffs = [];
+    for (const session of sessions) {
+        const timestamp = session.completedAt.toLocaleTimeString();
+        output.push(`\n## ${session.serverName} / ${session.toolName} (${timestamp}, ${session.reason})`);
+        const plainPrompts = [];
+        for (const prompt of session.messages.prompts) {
+            allPrompts.push(prompt);
+            const handoff = parseUiPromptHandoff(prompt);
+            if (handoff) {
+                parsedHandoffs.push(handoff);
+            }
+            else {
+                plainPrompts.push(prompt);
+            }
+        }
+        if (plainPrompts.length > 0) {
+            output.push("\n### Prompts:");
+            for (const prompt of plainPrompts) {
+                output.push(`- ${prompt}`);
+            }
+        }
+        const intentsForSession = [
+            ...session.messages.intents,
+            ...session.messages.prompts
+                .map((prompt) => parseUiPromptHandoff(prompt))
+                .filter((handoff) => !!handoff)
+                .map((handoff) => ({ intent: handoff.intent, params: handoff.params })),
+        ];
+        if (intentsForSession.length > 0) {
+            output.push("\n### Intents:");
+            for (const intent of intentsForSession) {
+                const params = intent.params ? ` (${JSON.stringify(intent.params)})` : "";
+                output.push(`- ${intent.intent}${params}`);
+            }
+        }
+        if (session.messages.notifications.length > 0) {
+            output.push("\n### Notifications:");
+            for (const notification of session.messages.notifications) {
+                output.push(`- ${notification}`);
+            }
+        }
+    }
+    const count = sessions.length;
+    state.completedUiSessions = [];
+    return {
+        content: [{ type: "text", text: output.join("\n") }],
+        details: {
+            sessions: count,
+            prompts: allPrompts,
+            intents: [...allIntents, ...parsedHandoffs.map(({ intent, params }) => ({ intent, params }))],
+            handoffs: parsedHandoffs,
+            cleared: true,
+        },
+    };
+}
+export function executeStatus(state) {
+    const servers = [];
+    for (const name of Object.keys(state.config.mcpServers)) {
+        const connection = state.manager.getConnection(name);
+        const metadata = state.toolMetadata.get(name);
+        const toolCount = metadata?.length ?? 0;
+        const failedAgo = getFailureAgeSeconds(state, name);
+        let status = "not connected";
+        if (connection?.status === "connected") {
+            status = "connected";
+        }
+        else if (connection?.status === "needs-auth") {
+            status = "needs-auth";
+        }
+        else if (failedAgo !== null) {
+            status = "failed";
+        }
+        else if (metadata !== undefined) {
+            status = "cached";
+        }
+        servers.push({ name, status, toolCount, failedAgo });
+    }
+    const totalTools = servers.reduce((sum, s) => sum + s.toolCount, 0);
+    const connectedCount = servers.filter(s => s.status === "connected").length;
+    let text = `MCP: ${connectedCount}/${servers.length} servers, ${totalTools} tools\n\n`;
+    for (const server of servers) {
+        if (server.status === "connected") {
+            text += `✓ ${server.name} (${server.toolCount} tools)\n`;
+            continue;
+        }
+        if (server.status === "needs-auth") {
+            text += `⚠ ${server.name} (needs auth)\n`;
+            continue;
+        }
+        if (server.status === "cached") {
+            text += `○ ${server.name} (${server.toolCount} tools, cached)\n`;
+            continue;
+        }
+        if (server.status === "failed") {
+            text += `✗ ${server.name} (failed ${server.failedAgo ?? 0}s ago)\n`;
+            continue;
+        }
+        text += `○ ${server.name} (not connected)\n`;
+    }
+    if (servers.length > 0) {
+        text += `\nmcp({ server: "name" }) to list tools, mcp({ search: "..." }) to search`;
+    }
+    return {
+        content: [{ type: "text", text: text.trim() }],
+        details: { mode: "status", servers, totalTools, connectedCount },
+    };
+}
+export function executeDescribe(state, toolName) {
+    let serverName;
+    let toolMeta;
+    for (const [server, metadata] of state.toolMetadata.entries()) {
+        const found = findToolByName(metadata, toolName);
+        if (found) {
+            serverName = server;
+            toolMeta = found;
+            break;
+        }
+    }
+    if (!serverName || !toolMeta) {
+        return {
+            content: [{ type: "text", text: `Tool "${toolName}" not found. Use mcp({ search: "..." }) to search.` }],
+            details: { mode: "describe", error: "tool_not_found", requestedTool: toolName },
+        };
+    }
+    let text = `${toolMeta.name}\n`;
+    text += `Server: ${serverName}\n`;
+    if (toolMeta.resourceUri) {
+        text += `Type: Resource (reads from ${toolMeta.resourceUri})\n`;
+    }
+    text += `\n${toolMeta.description || "(no description)"}\n`;
+    if (toolMeta.inputSchema && !toolMeta.resourceUri) {
+        text += `\nParameters:\n${formatSchema(toolMeta.inputSchema)}`;
+    }
+    else if (toolMeta.resourceUri) {
+        text += `\nNo parameters required (resource tool).`;
+    }
+    else {
+        text += `\nNo parameters defined.`;
+    }
+    return {
+        content: [{ type: "text", text: text.trim() }],
+        details: { mode: "describe", tool: toolMeta, server: serverName },
+    };
+}
+export function executeSearch(state, query, regex, server, includeSchemas) {
+    const showSchemas = includeSchemas !== false;
+    const matches = [];
+    let pattern;
+    try {
+        if (regex) {
+            pattern = new RegExp(query, "i");
+        }
+        else {
+            const terms = query.trim().split(/\s+/).filter(t => t.length > 0);
+            if (terms.length === 0) {
+                return {
+                    content: [{ type: "text", text: "Search query cannot be empty" }],
+                    details: { mode: "search", error: "empty_query" },
+                };
+            }
+            const escaped = terms.map(t => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+            pattern = new RegExp(escaped.join("|"), "i");
+        }
+    }
+    catch {
+        return {
+            content: [{ type: "text", text: `Invalid regex: ${query}` }],
+            details: { mode: "search", error: "invalid_pattern", query },
+        };
+    }
+    for (const [serverName, metadata] of state.toolMetadata.entries()) {
+        if (server && serverName !== server)
+            continue;
+        for (const tool of metadata) {
+            if (pattern.test(tool.name) || pattern.test(tool.description)) {
+                matches.push({
+                    server: serverName,
+                    tool,
+                });
+            }
+        }
+    }
+    const totalCount = matches.length;
+    if (totalCount === 0) {
+        const msg = server
+            ? `No tools matching "${query}" in "${server}"`
+            : `No tools matching "${query}"`;
+        return {
+            content: [{ type: "text", text: msg }],
+            details: { mode: "search", matches: [], count: 0, query },
+        };
+    }
+    let text = `Found ${totalCount} tool${totalCount === 1 ? "" : "s"} matching "${query}":\n\n`;
+    for (const match of matches) {
+        if (showSchemas) {
+            text += `${match.tool.name}\n`;
+            text += `  ${match.tool.description || "(no description)"}\n`;
+            if (match.tool.inputSchema && !match.tool.resourceUri) {
+                text += `\n  Parameters:\n${formatSchema(match.tool.inputSchema, "    ")}\n`;
+            }
+            else if (match.tool.resourceUri) {
+                text += `  No parameters (resource tool).\n`;
+            }
+            text += "\n";
+        }
+        else {
+            text += `- ${match.tool.name}`;
+            if (match.tool.description) {
+                text += ` - ${truncateAtWord(match.tool.description, 50)}`;
+            }
+            text += "\n";
+        }
+    }
+    return {
+        content: [{ type: "text", text: text.trim() }],
+        details: {
+            mode: "search",
+            matches: matches.map(m => ({ server: m.server, tool: m.tool.name })),
+            count: totalCount,
+            query,
+        },
+    };
+}
+export function executeList(state, server) {
+    if (!state.config.mcpServers[server]) {
+        return {
+            content: [{ type: "text", text: `Server "${server}" not found. Use mcp({}) to see available servers.` }],
+            details: { mode: "list", server, tools: [], count: 0, error: "not_found" },
+        };
+    }
+    const metadata = state.toolMetadata.get(server);
+    const toolNames = metadata?.map(m => m.name) ?? [];
+    const connection = state.manager.getConnection(server);
+    if (toolNames.length === 0) {
+        if (connection?.status === "connected") {
+            return {
+                content: [{ type: "text", text: `Server "${server}" has no tools.` }],
+                details: { mode: "list", server, tools: [], count: 0 },
+            };
+        }
+        if (metadata !== undefined) {
+            return {
+                content: [{ type: "text", text: `Server "${server}" has no cached tools (not connected).` }],
+                details: { mode: "list", server, tools: [], count: 0, cached: true },
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Server "${server}" is configured but not connected. Use mcp({ restart: "${server}" }) to force restart it.` }],
+            details: { mode: "list", server, tools: [], count: 0, error: "not_connected" },
+        };
+    }
+    const cachedNote = connection?.status === "connected" ? "" : " (not connected, cached)";
+    let text = `${server} (${toolNames.length} tools${cachedNote}):\n\n`;
+    const descMap = new Map();
+    if (metadata) {
+        for (const m of metadata) {
+            descMap.set(m.name, m.description);
+        }
+    }
+    for (const tool of toolNames) {
+        const desc = descMap.get(tool) ?? "";
+        const truncated = truncateAtWord(desc, 50);
+        text += `- ${tool}`;
+        if (truncated)
+            text += ` - ${truncated}`;
+        text += "\n";
+    }
+    return {
+        content: [{ type: "text", text: text.trim() }],
+        details: { mode: "list", server, tools: toolNames, count: toolNames.length },
+    };
+}
+export async function executeConnect(state, serverName) {
+    const definition = state.config.mcpServers[serverName];
+    if (!definition) {
+        return {
+            content: [{ type: "text", text: `Server "${serverName}" not found. Use mcp({}) to see available servers.` }],
+            details: { mode: "connect", error: "not_found", server: serverName },
+        };
+    }
+    try {
+        if (state.ui) {
+            state.ui.setStatus("mcp", `MCP: connecting to ${serverName}...`);
+        }
+        // Force close any stale/dead connection before reconnecting.
+        // The connect() method returns cached connections that may be dead
+        // (e.g., after the server process was killed by pkill).
+        await state.manager.close(serverName);
+        let connection = await state.manager.connect(serverName, definition);
+        if (connection.status === "needs-auth") {
+            const autoAuth = await attemptAutoAuth(state, serverName);
+            if (autoAuth.status === "failed") {
+                return {
+                    content: [{ type: "text", text: autoAuth.message }],
+                    details: { mode: "connect", error: "auth_required", server: serverName, message: autoAuth.message },
+                };
+            }
+            if (autoAuth.status === "success") {
+                await state.manager.close(serverName);
+                connection = await state.manager.connect(serverName, definition);
+            }
+            if (connection.status === "needs-auth") {
+                const message = getAuthRequiredMessage(state, serverName);
+                return {
+                    content: [{ type: "text", text: message }],
+                    details: { mode: "connect", error: "auth_required", server: serverName, message },
+                };
+            }
+        }
+        const prefix = state.config.settings?.toolPrefix ?? "server";
+        const { metadata } = buildToolMetadata(connection.tools, connection.resources, definition, serverName, prefix);
+        state.toolMetadata.set(serverName, metadata);
+        updateMetadataCache(state, serverName);
+        state.failureTracker.delete(serverName);
+        updateStatusBar(state);
+        return executeList(state, serverName);
+    }
+    catch (error) {
+        state.failureTracker.set(serverName, Date.now());
+        updateStatusBar(state);
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Failed to connect to "${serverName}": ${message}` }],
+            details: { mode: "connect", error: "connect_failed", server: serverName, message },
+        };
+    }
+}
+export async function executeCall(state, toolName, args, serverOverride, getPiTools) {
+    let serverName = serverOverride;
+    let toolMeta;
+    let autoAuthAttempted = false;
+    const prefixMode = state.config.settings?.toolPrefix ?? "server";
+    if (serverName && !state.config.mcpServers[serverName]) {
+        return {
+            content: [{ type: "text", text: `Server "${serverName}" not found. Use mcp({}) to see available servers.` }],
+            details: { mode: "call", error: "server_not_found", server: serverName },
+        };
+    }
+    if (serverName) {
+        toolMeta = findToolByName(state.toolMetadata.get(serverName), toolName);
+    }
+    else {
+        for (const [server, metadata] of state.toolMetadata.entries()) {
+            const found = findToolByName(metadata, toolName);
+            if (found) {
+                serverName = server;
+                toolMeta = found;
+                break;
+            }
+        }
+    }
+    if (serverName && !toolMeta) {
+        const connected = await lazyConnect(state, serverName);
+        if (connected) {
+            toolMeta = findToolByName(state.toolMetadata.get(serverName), toolName);
+        }
+        else {
+            const needsAuthConnection = state.manager.getConnection(serverName);
+            if (needsAuthConnection?.status === "needs-auth") {
+                if (!autoAuthAttempted) {
+                    autoAuthAttempted = true;
+                    const autoAuth = await attemptAutoAuth(state, serverName);
+                    if (autoAuth.status === "failed") {
+                        return {
+                            content: [{ type: "text", text: autoAuth.message }],
+                            details: { mode: "call", error: "auth_required", server: serverName, message: autoAuth.message },
+                        };
+                    }
+                    if (autoAuth.status === "success") {
+                        await state.manager.close(serverName);
+                        state.failureTracker.delete(serverName);
+                        const connectedAfterAuth = await lazyConnect(state, serverName);
+                        if (connectedAfterAuth) {
+                            toolMeta = findToolByName(state.toolMetadata.get(serverName), toolName);
+                            if (!toolMeta) {
+                                return {
+                                    content: [{ type: "text", text: `Tool "${toolName}" not found on "${serverName}" after reconnect.` }],
+                                    details: { mode: "call", error: "tool_not_found_after_reconnect", requestedTool: toolName },
+                                };
+                            }
+                        }
+                    }
+                }
+                if (!toolMeta && state.manager.getConnection(serverName)?.status === "needs-auth") {
+                    const message = getAuthRequiredMessage(state, serverName);
+                    return {
+                        content: [{ type: "text", text: message }],
+                        details: { mode: "call", error: "auth_required", server: serverName, message },
+                    };
+                }
+            }
+            if (!toolMeta) {
+                const failedAgo = getFailureAgeSeconds(state, serverName);
+                if (failedAgo !== null) {
+                    return {
+                        content: [{ type: "text", text: `Server "${serverName}" not available (last failed ${failedAgo}s ago). Use mcp({ restart: "${serverName}" }) to force restart it.` }],
+                        details: { mode: "call", error: "server_backoff", server: serverName },
+                    };
+                }
+            }
+        }
+    }
+    let prefixMatchedServer;
+    if (!serverName && !toolMeta && prefixMode !== "none") {
+        const candidates = Object.keys(state.config.mcpServers)
+            .map(name => ({ name, prefix: getServerPrefix(name, prefixMode) }))
+            .filter(c => c.prefix && toolName.startsWith(c.prefix + "_"))
+            .sort((a, b) => b.prefix.length - a.prefix.length);
+        for (const { name: configuredServer } of candidates) {
+            const existingConnection = state.manager.getConnection(configuredServer);
+            const failedAgo = getFailureAgeSeconds(state, configuredServer);
+            if (failedAgo !== null && existingConnection?.status !== "needs-auth")
+                continue;
+            let connected = await lazyConnect(state, configuredServer);
+            if (!connected && state.manager.getConnection(configuredServer)?.status === "needs-auth" && !autoAuthAttempted) {
+                autoAuthAttempted = true;
+                const autoAuth = await attemptAutoAuth(state, configuredServer);
+                if (autoAuth.status === "failed") {
+                    return {
+                        content: [{ type: "text", text: autoAuth.message }],
+                        details: { mode: "call", error: "auth_required", server: configuredServer, message: autoAuth.message },
+                    };
+                }
+                if (autoAuth.status === "success") {
+                    await state.manager.close(configuredServer);
+                    state.failureTracker.delete(configuredServer);
+                    connected = await lazyConnect(state, configuredServer);
+                }
+            }
+            if (!connected)
+                continue;
+            if (!prefixMatchedServer)
+                prefixMatchedServer = configuredServer;
+            toolMeta = findToolByName(state.toolMetadata.get(configuredServer), toolName);
+            if (toolMeta) {
+                serverName = configuredServer;
+                break;
+            }
+        }
+    }
+    if (!serverName || !toolMeta) {
+        const nativeTool = !serverOverride
+            ? getPiTools?.().find((tool) => tool.name === toolName && tool.name !== "mcp")
+            : undefined;
+        if (nativeTool) {
+            return {
+                content: [{ type: "text", text: `"${toolName}" is a native Pi tool. Call ${toolName} directly instead of using mcp({ tool: "${toolName}" }).` }],
+                details: { mode: "call", error: "native_tool", requestedTool: toolName },
+            };
+        }
+        const hintServer = serverName ?? prefixMatchedServer;
+        const available = hintServer ? getToolNames(state, hintServer) : [];
+        let msg = `Tool "${toolName}" not found.`;
+        if (available.length > 0) {
+            msg += ` Server "${hintServer}" has: ${available.join(", ")}`;
+        }
+        else {
+            msg += ` Use mcp({ search: "..." }) to search.`;
+        }
+        return {
+            content: [{ type: "text", text: msg }],
+            details: { mode: "call", error: "tool_not_found", requestedTool: toolName, hintServer },
+        };
+    }
+    let connection = state.manager.getConnection(serverName);
+    if (connection?.status === "needs-auth") {
+        if (!autoAuthAttempted) {
+            autoAuthAttempted = true;
+            const autoAuth = await attemptAutoAuth(state, serverName);
+            if (autoAuth.status === "failed") {
+                return {
+                    content: [{ type: "text", text: autoAuth.message }],
+                    details: { mode: "call", error: "auth_required", server: serverName, message: autoAuth.message },
+                };
+            }
+            if (autoAuth.status === "success") {
+                await state.manager.close(serverName);
+                state.failureTracker.delete(serverName);
+                connection = state.manager.getConnection(serverName);
+            }
+        }
+        if (connection?.status === "needs-auth") {
+            const message = getAuthRequiredMessage(state, serverName);
+            return {
+                content: [{ type: "text", text: message }],
+                details: { mode: "call", error: "auth_required", server: serverName, message },
+            };
+        }
+    }
+    if (!connection || connection.status !== "connected") {
+        const failedAgo = getFailureAgeSeconds(state, serverName);
+        if (failedAgo !== null) {
+            return {
+                content: [{ type: "text", text: `Server "${serverName}" not available (last failed ${failedAgo}s ago). Use mcp({ restart: "${serverName}" }) to force restart it.` }],
+                details: { mode: "call", error: "server_backoff", server: serverName },
+            };
+        }
+        const definition = state.config.mcpServers[serverName];
+        if (!definition) {
+            return {
+                content: [{ type: "text", text: `Server "${serverName}" not connected. Use mcp({ restart: "${serverName}" }) to force restart it.` }],
+                details: { mode: "call", error: "server_not_connected", server: serverName },
+            };
+        }
+        try {
+            if (state.ui) {
+                state.ui.setStatus("mcp", `MCP: connecting to ${serverName}...`);
+            }
+            connection = await state.manager.connect(serverName, definition);
+            if (connection.status === "needs-auth") {
+                if (!autoAuthAttempted) {
+                    autoAuthAttempted = true;
+                    const autoAuth = await attemptAutoAuth(state, serverName);
+                    if (autoAuth.status === "failed") {
+                        return {
+                            content: [{ type: "text", text: autoAuth.message }],
+                            details: { mode: "call", error: "auth_required", server: serverName, message: autoAuth.message },
+                        };
+                    }
+                    if (autoAuth.status === "success") {
+                        await state.manager.close(serverName);
+                        connection = await state.manager.connect(serverName, definition);
+                    }
+                }
+                if (connection.status === "needs-auth") {
+                    const message = getAuthRequiredMessage(state, serverName);
+                    return {
+                        content: [{ type: "text", text: message }],
+                        details: { mode: "call", error: "auth_required", server: serverName, message },
+                    };
+                }
+            }
+            state.failureTracker.delete(serverName);
+            updateServerMetadata(state, serverName);
+            updateMetadataCache(state, serverName);
+            updateStatusBar(state);
+            toolMeta = findToolByName(state.toolMetadata.get(serverName), toolName);
+            if (!toolMeta) {
+                const available = getToolNames(state, serverName);
+                const hint = available.length > 0
+                    ? `Available tools on "${serverName}": ${available.join(", ")}`
+                    : `Server "${serverName}" has no tools.`;
+                return {
+                    content: [{ type: "text", text: `Tool "${toolName}" not found on "${serverName}" after reconnect. ${hint}` }],
+                    details: { mode: "call", error: "tool_not_found_after_reconnect", requestedTool: toolName },
+                };
+            }
+        }
+        catch (error) {
+            state.failureTracker.set(serverName, Date.now());
+            updateStatusBar(state);
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Failed to connect to "${serverName}": ${message}` }],
+                details: { mode: "call", error: "connect_failed", message },
+            };
+        }
+    }
+    let uiSession = null;
+    try {
+        state.manager.touch(serverName);
+        state.manager.incrementInFlight(serverName);
+        if (toolMeta.resourceUri) {
+            const result = await connection.client.readResource({ uri: toolMeta.resourceUri });
+            const content = (result.contents ?? []).map(c => ({
+                type: "text",
+                text: "text" in c ? c.text : ("blob" in c ? `[Binary data: ${c.mimeType ?? "unknown"}]` : JSON.stringify(c)),
+            }));
+            return {
+                content: content.length > 0 ? content : [{ type: "text", text: "(empty resource)" }],
+                details: { mode: "call", resourceUri: toolMeta.resourceUri, server: serverName },
+            };
+        }
+        uiSession = toolMeta.uiResourceUri
+            ? await maybeStartUiSession(state, {
+                serverName,
+                toolName: toolMeta.originalName,
+                toolArgs: args ?? {},
+                uiResourceUri: toolMeta.uiResourceUri,
+                streamMode: toolMeta.uiStreamMode,
+            })
+            : null;
+        const resultPromise = connection.client.callTool({
+            name: toolMeta.originalName,
+            arguments: args ?? {},
+            _meta: uiSession?.requestMeta,
+        });
+        if (toolMeta.uiResourceUri) {
+            const result = await resultPromise;
+            uiSession?.sendToolResult(result);
+            const mcpContent = (result.content ?? []);
+            const content = transformMcpContent(mcpContent);
+            const mcpText = content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            if (result.isError) {
+                let errorWithSchema = `Error: ${mcpText || "Tool execution failed"}`;
+                if (toolMeta.inputSchema) {
+                    errorWithSchema += `\n\nExpected parameters:\n${formatSchema(toolMeta.inputSchema)}`;
+                }
+                return {
+                    content: [{ type: "text", text: errorWithSchema }],
+                    details: { mode: "call", error: "tool_error", mcpResult: result },
+                };
+            }
+            const resultText = mcpText || "(empty result)";
+            const uiMessage = uiSession?.reused
+                ? "Updated the open UI."
+                : "📺 Interactive UI is now open in your browser. I'll respond to your prompts and intents as you interact with it.";
+            return {
+                content: [{ type: "text", text: `${resultText}\n\n${uiMessage}` }],
+                details: { mode: "call", mcpResult: result, server: serverName, tool: toolMeta.originalName, uiOpen: true },
+            };
+        }
+        const result = await resultPromise;
+        const mcpContent = (result.content ?? []);
+        const content = transformMcpContent(mcpContent);
+        if (result.isError) {
+            const errorText = content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n") || "Tool execution failed";
+            let errorWithSchema = `Error: ${errorText}`;
+            if (toolMeta.inputSchema) {
+                errorWithSchema += `\n\nExpected parameters:\n${formatSchema(toolMeta.inputSchema)}`;
+            }
+            return {
+                content: [{ type: "text", text: errorWithSchema }],
+                details: { mode: "call", error: "tool_error", mcpResult: result },
+            };
+        }
+        return {
+            content: content.length > 0 ? content : [{ type: "text", text: "(empty result)" }],
+            details: { mode: "call", mcpResult: result, server: serverName, tool: toolMeta.originalName },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        uiSession?.sendToolCancelled(message);
+        let errorWithSchema = `Failed to call tool: ${message}`;
+        if (toolMeta.inputSchema) {
+            errorWithSchema += `\n\nExpected parameters:\n${formatSchema(toolMeta.inputSchema)}`;
+        }
+        return {
+            content: [{ type: "text", text: errorWithSchema }],
+            details: { mode: "call", error: "call_failed", message },
+        };
+    }
+    finally {
+        if (uiSession?.reused) {
+            uiSession.close();
+        }
+        state.manager.decrementInFlight(serverName);
+        state.manager.touch(serverName);
+    }
+}