@agent-native/core 0.20.8 → 0.21.0

package/dist/mcp-client/app-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-result.js","sourceRoot":"","sources":["../../src/mcp-client/app-result.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAAqC,CAAC;AAwC9E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAAiC,CAAC,wBAAwB,CAAC,KAAK,IAAI;QACrE,OAAQ,KAAiC,CAAC,IAAI,KAAK,QAAQ,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAa;IAEb,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,YAAY;QACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC","sourcesContent":["import type { McpTool } from \"./manager.js\";\n\nexport const MCP_ACTION_RESULT_MARKER = \"__agentNativeMcpToolResult\" as const;\n\nexport interface AgentMcpAppResourceContent {\n  uri: string;\n  mimeType?: string;\n  text?: string;\n  blob?: string;\n  _meta?: Record<string, unknown>;\n}\n\nexport interface AgentMcpAppPayload {\n  serverId: string;\n  toolName: string;\n  originalToolName: string;\n  resourceUri: string;\n  toolInput: Record<string, unknown>;\n  toolResult: Record<string, unknown>;\n  tool?: {\n    name: string;\n    title?: string;\n    description?: string;\n    inputSchema?: Record<string, unknown>;\n    outputSchema?: Record<string, unknown>;\n    annotations?: Record<string, unknown>;\n    _meta?: Record<string, unknown>;\n  };\n  resource?: AgentMcpAppResourceContent;\n}\n\nexport interface McpActionResult {\n  [MCP_ACTION_RESULT_MARKER]: true;\n  text: string;\n  raw: unknown;\n  serverId: string;\n  toolName: string;\n  originalToolName: string;\n  input: Record<string, unknown>;\n  mcpApp?: AgentMcpAppPayload;\n}\n\nexport function isMcpActionResult(value: unknown): value is McpActionResult {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    (value as Record<string, unknown>)[MCP_ACTION_RESULT_MARKER] === true &&\n    typeof (value as Record<string, unknown>).text === \"string\"\n  );\n}\n\nexport function toolForMcpAppPayload(\n  tool: McpTool,\n): AgentMcpAppPayload[\"tool\"] {\n  return {\n    name: tool.originalName,\n    ...(tool.title ? { title: tool.title } : {}),\n    description: tool.description,\n    inputSchema: tool.inputSchema,\n    ...(tool.outputSchema ? { outputSchema: tool.outputSchema } : {}),\n    ...(tool.annotations ? { annotations: tool.annotations } : {}),\n    ...(tool._meta ? { _meta: tool._meta } : {}),\n  };\n}\n"]}

package/dist/mcp-client/index.d.ts

@@ -5,7 +5,7 @@
  * to the agent-chat tool-use loop.
  */
 export { loadMcpConfig, autoDetectMcpConfig, type McpConfig, type McpServerConfig, } from "./config.js";
-export { McpClientManager, parseMcpToolName, MCP_TOOL_PREFIX, type McpTool, type McpClientManagerOptions, } from "./manager.js";
+export { McpClientManager, buildMcpToolName, parseMcpToolName, MCP_TOOL_PREFIX, type McpTool, type McpClientManagerOptions, } from "./manager.js";
 export { listRemoteServers, addRemoteServer, removeRemoteServer, validateRemoteUrl, normalizeServerName, mergedConfigKey, parseMergedKey, hashEmail, toHttpServerConfig, toHttpServerConfigAsync, materializeHeaders, type RemoteMcpScope, type StoredRemoteMcpServer, } from "./remote-store.js";
 export { BUILTIN_MCP_CAPABILITIES, getBuiltinMcpCapability, isBuiltinMcpCapabilityAvailable, normalizeBuiltinMcpCapabilityIds, toBuiltinMcpServerConfig, type BuiltinMcpCapability, type BuiltinMcpCapabilityId, } from "./builtin-capabilities.js";
 export { builtinMcpCapabilitiesSettingsKey, listEnabledBuiltinMcpCapabilities, setEnabledBuiltinMcpCapabilities, setBuiltinMcpCapabilityEnabled, type StoredBuiltinMcpCapabilities, } from "./builtin-store.js";
@@ -13,13 +13,14 @@ export { mountMcpServersRoutes, buildMergedConfig, builtinMergedConfigKey, type
 export { mountMcpHubRoutes, listHubServers, getHubStatus, isHubServeEnabled, isHubConsumeEnabled, type HubServerRecord, type HubServersResponse, } from "./hub-routes.js";
 export { fetchHubServers } from "./hub-client.js";
 export { isMcpToolAllowedForRequest } from "./visibility.js";
+export { MCP_ACTION_RESULT_MARKER, isMcpActionResult, type AgentMcpAppPayload, type AgentMcpAppResourceContent, type McpActionResult, } from "./app-result.js";
 /**
  * Convert MCP tools into `ActionEntry` values suitable for registration in
  * the agent's action registry. Each tool is marked `http: false` so it's
  * never auto-mounted as an HTTP endpoint — MCP tools are agent-only.
  */
 import type { ActionEntry } from "../agent/production-agent.js";
-import type { McpClientManager } from "./manager.js";
+import type { McpClientManager, McpTool } from "./manager.js";
 export declare function mcpToolsToActionEntries(manager: McpClientManager): Record<string, ActionEntry>;
 /**
  * Mutate a target action dict in place so it matches the current MCP tool set:
@@ -31,4 +32,6 @@ export declare function mcpToolsToActionEntries(manager: McpClientManager): Reco
  * registries in sync after `McpClientManager.reconfigure()` runs.
  */
 export declare function syncMcpActionEntries(manager: McpClientManager, target: Record<string, ActionEntry>): void;
+export declare function isVisibleToMcpApp(tool: McpTool): boolean;
+export declare function flattenMcpToolResult(result: unknown): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp-client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,+BAA+B,EAC/B,gCAAgC,EAChC,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AAE9D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,IAAI,CAaN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,+BAA+B,EAC/B,gCAAgC,EAChC,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAezB;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,IAAI,CAaN;AAqCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAiB5D"}

package/dist/mcp-client/index.js

@@ -5,7 +5,7 @@
  * to the agent-chat tool-use loop.
  */
 export { loadMcpConfig, autoDetectMcpConfig, } from "./config.js";
-export { McpClientManager, parseMcpToolName, MCP_TOOL_PREFIX, } from "./manager.js";
+export { McpClientManager, buildMcpToolName, parseMcpToolName, MCP_TOOL_PREFIX, } from "./manager.js";
 export { listRemoteServers, addRemoteServer, removeRemoteServer, validateRemoteUrl, normalizeServerName, mergedConfigKey, parseMergedKey, hashEmail, toHttpServerConfig, toHttpServerConfigAsync, materializeHeaders, } from "./remote-store.js";
 export { BUILTIN_MCP_CAPABILITIES, getBuiltinMcpCapability, isBuiltinMcpCapabilityAvailable, normalizeBuiltinMcpCapabilityIds, toBuiltinMcpServerConfig, } from "./builtin-capabilities.js";
 export { builtinMcpCapabilitiesSettingsKey, listEnabledBuiltinMcpCapabilities, setEnabledBuiltinMcpCapabilities, setBuiltinMcpCapabilityEnabled, } from "./builtin-store.js";
@@ -14,9 +14,13 @@ export { mountMcpHubRoutes, listHubServers, getHubStatus, isHubServeEnabled, isH
 export { fetchHubServers } from "./hub-client.js";
 export { isMcpToolAllowedForRequest } from "./visibility.js";
 import { isMcpToolAllowedForRequest } from "./visibility.js";
+export { MCP_ACTION_RESULT_MARKER, isMcpActionResult, } from "./app-result.js";
+import { MCP_ACTION_RESULT_MARKER, toolForMcpAppPayload, } from "./app-result.js";
+import { getToolUiResourceUri, isToolVisibilityAppOnly, isToolVisibilityModelOnly, } from "@modelcontextprotocol/ext-apps/app-bridge";
+import { MCP_APP_MIME_TYPE } from "../action.js";
 export function mcpToolsToActionEntries(manager) {
     const entries = {};
-    for (const tool of manager.getTools()) {
+    for (const tool of manager.getTools().filter(isVisibleToModel)) {
         entries[tool.name] = mcpToolToActionEntry(manager, tool);
     }
     return entries;
@@ -32,7 +36,7 @@ export function mcpToolsToActionEntries(manager) {
  */
 export function syncMcpActionEntries(manager, target) {
     const current = new Set();
-    for (const tool of manager.getTools()) {
+    for (const tool of manager.getTools().filter(isVisibleToModel)) {
         current.add(tool.name);
         if (!target[tool.name]) {
             target[tool.name] = mcpToolToActionEntry(manager, tool);
@@ -60,26 +64,7 @@ function mcpToolToActionEntry(manager, tool) {
             }
             try {
                 const result = await manager.callTool(tool.name, args);
-                // MCP tool results are typically `{ content: [{ type: "text", text: ... }], isError? }`.
-                // Flatten text content for the agent's string-based tool result slot.
-                if (result &&
-                    typeof result === "object" &&
-                    Array.isArray(result.content)) {
-                    const parts = result.content;
-                    const text = parts
-                        .map((p) => {
-                        if (p?.type === "text" && typeof p.text === "string")
-                            return p.text;
-                        if (p?.type === "image")
-                            return `[image: ${p?.mimeType ?? "unknown"}]`;
-                        return JSON.stringify(p);
-                    })
-                        .join("\n");
-                    if (result.isError)
-                        return `Error: ${text}`;
-                    return text || "(no output)";
-                }
-                return typeof result === "string" ? result : JSON.stringify(result);
+                return await buildMcpActionResult(manager, tool, args, result);
             }
             catch (err) {
                 return `Error calling MCP tool ${tool.name}: ${err?.message ?? err}`;
@@ -87,4 +72,181 @@ function mcpToolToActionEntry(manager, tool) {
         },
     };
 }
+function isVisibleToModel(tool) {
+    try {
+        return !isToolVisibilityAppOnly(tool.raw);
+    }
+    catch {
+        return true;
+    }
+}
+export function isVisibleToMcpApp(tool) {
+    try {
+        return !isToolVisibilityModelOnly(tool.raw);
+    }
+    catch {
+        return true;
+    }
+}
+export function flattenMcpToolResult(result) {
+    if (result &&
+        typeof result === "object" &&
+        Array.isArray(result.content)) {
+        const parts = result.content;
+        const text = parts.map(formatMcpContentPart).join("\n");
+        const fallback = text ||
+            (hasStructuredContent(result)
+                ? JSON.stringify(result.structuredContent, null, 2)
+                : "(no output)");
+        if (result.isError)
+            return `Error: ${fallback}`;
+        return fallback;
+    }
+    return typeof result === "string" ? result : JSON.stringify(result);
+}
+function formatMcpContentPart(part) {
+    if (part?.type === "text" && typeof part.text === "string") {
+        return part.text;
+    }
+    if (part?.type === "image") {
+        return `[image: ${part?.mimeType ?? "unknown"}]`;
+    }
+    if (part?.type === "resource") {
+        const resource = part.resource ?? {};
+        const uri = typeof resource.uri === "string" ? ` ${resource.uri}` : "";
+        return `[resource: ${resource.mimeType ?? "unknown"}${uri}]`;
+    }
+    if (part?.type === "resource_link") {
+        const uri = typeof part.uri === "string" ? ` ${part.uri}` : "";
+        return `[resource: ${part.mimeType ?? "unknown"}${uri}]`;
+    }
+    return JSON.stringify(part);
+}
+function hasStructuredContent(result) {
+    return (!!result &&
+        typeof result === "object" &&
+        Object.prototype.hasOwnProperty.call(result, "structuredContent"));
+}
+async function buildMcpActionResult(manager, tool, input, raw) {
+    const text = flattenMcpToolResult(raw);
+    const mcpApp = await extractMcpAppPayload(manager, tool, input, raw);
+    return {
+        [MCP_ACTION_RESULT_MARKER]: true,
+        text,
+        raw,
+        serverId: tool.source,
+        toolName: tool.name,
+        originalToolName: tool.originalName,
+        input,
+        ...(mcpApp ? { mcpApp } : {}),
+    };
+}
+async function extractMcpAppPayload(manager, tool, input, raw) {
+    const inlineResource = findInlineMcpAppResource(raw);
+    const resourceUri = inlineResource?.uri ??
+        resourceUriFromTool(tool) ??
+        resourceUriFromResult(raw);
+    if (!resourceUri)
+        return undefined;
+    const resource = inlineResource ?? (await readMcpAppResource(manager, tool, resourceUri));
+    return {
+        serverId: tool.source,
+        toolName: tool.name,
+        originalToolName: tool.originalName,
+        resourceUri,
+        toolInput: input,
+        toolResult: raw && typeof raw === "object"
+            ? { ...raw }
+            : { content: [{ type: "text", text: String(raw ?? "") }] },
+        tool: toolForMcpAppPayload(tool),
+        ...(resource ? { resource } : {}),
+    };
+}
+function resourceUriFromTool(tool) {
+    try {
+        return getToolUiResourceUri(tool.raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resourceUriFromResult(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const meta = raw._meta;
+    const nested = meta?.ui?.resourceUri;
+    if (typeof nested === "string" && nested.startsWith("ui://"))
+        return nested;
+    const flat = meta?.["ui/resourceUri"] ?? meta?.["ui.resourceUri"];
+    if (typeof flat === "string" && flat.startsWith("ui://"))
+        return flat;
+    return findInlineMcpAppResource(raw)?.uri;
+}
+function findInlineMcpAppResource(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const content = Array.isArray(raw.content)
+        ? raw.content
+        : [];
+    for (const part of content) {
+        const resource = normalizeMcpAppResourceContent(part);
+        if (resource)
+            return resource;
+    }
+    return undefined;
+}
+function normalizeMcpAppResourceContent(part) {
+    if (!part || typeof part !== "object")
+        return undefined;
+    const candidate = part.type === "resource"
+        ? part.resource
+        : (part.resource ?? part);
+    if (!candidate || typeof candidate !== "object")
+        return undefined;
+    const uri = candidate.uri;
+    if (typeof uri !== "string" || !uri.startsWith("ui://"))
+        return undefined;
+    const mimeType = typeof candidate.mimeType === "string"
+        ? candidate.mimeType
+        : undefined;
+    if (mimeType && !mimeType.includes(MCP_APP_MIME_TYPE))
+        return undefined;
+    const text = typeof candidate.text === "string"
+        ? candidate.text
+        : undefined;
+    const blob = typeof candidate.blob === "string"
+        ? candidate.blob
+        : undefined;
+    const meta = candidate._meta && typeof candidate._meta === "object"
+        ? candidate._meta
+        : part._meta && typeof part._meta === "object"
+            ? part._meta
+            : undefined;
+    return {
+        uri,
+        ...(mimeType ? { mimeType } : {}),
+        ...(text ? { text } : {}),
+        ...(blob ? { blob } : {}),
+        ...(meta ? { _meta: meta } : {}),
+    };
+}
+async function readMcpAppResource(manager, tool, resourceUri) {
+    try {
+        const result = await manager.readResourceForTool(tool.name, resourceUri);
+        const contents = Array.isArray(result?.contents)
+            ? result.contents
+            : [];
+        for (const content of contents) {
+            const resource = normalizeMcpAppResourceContent(content);
+            if (resource?.uri === resourceUri ||
+                (resource && contents.length === 1)) {
+                return resource;
+            }
+        }
+    }
+    catch (err) {
+        console.warn(`[mcp-client] Failed to read MCP App resource ${resourceUri}: ${err?.message ?? err}`);
+    }
+    return undefined;
+}
 //# sourceMappingURL=index.js.map

package/dist/mcp-client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-client/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP client module — symmetric counterpart to `@agent-native/core/mcp`\n * (the MCP server). Connects to local MCP servers configured in\n * `mcp.config.json` or the `MCP_SERVERS` env var and exposes their tools\n * to the agent-chat tool-use loop.\n */\n\nexport {\n  loadMcpConfig,\n  autoDetectMcpConfig,\n  type McpConfig,\n  type McpServerConfig,\n} from \"./config.js\";\n\nexport {\n  McpClientManager,\n  parseMcpToolName,\n  MCP_TOOL_PREFIX,\n  type McpTool,\n  type McpClientManagerOptions,\n} from \"./manager.js\";\n\nexport {\n  listRemoteServers,\n  addRemoteServer,\n  removeRemoteServer,\n  validateRemoteUrl,\n  normalizeServerName,\n  mergedConfigKey,\n  parseMergedKey,\n  hashEmail,\n  toHttpServerConfig,\n  toHttpServerConfigAsync,\n  materializeHeaders,\n  type RemoteMcpScope,\n  type StoredRemoteMcpServer,\n} from \"./remote-store.js\";\n\nexport {\n  BUILTIN_MCP_CAPABILITIES,\n  getBuiltinMcpCapability,\n  isBuiltinMcpCapabilityAvailable,\n  normalizeBuiltinMcpCapabilityIds,\n  toBuiltinMcpServerConfig,\n  type BuiltinMcpCapability,\n  type BuiltinMcpCapabilityId,\n} from \"./builtin-capabilities.js\";\n\nexport {\n  builtinMcpCapabilitiesSettingsKey,\n  listEnabledBuiltinMcpCapabilities,\n  setEnabledBuiltinMcpCapabilities,\n  setBuiltinMcpCapabilityEnabled,\n  type StoredBuiltinMcpCapabilities,\n} from \"./builtin-store.js\";\n\nexport {\n  mountMcpServersRoutes,\n  buildMergedConfig,\n  builtinMergedConfigKey,\n  type ClientBuiltinCapability,\n} from \"./routes.js\";\n\nexport {\n  mountMcpHubRoutes,\n  listHubServers,\n  getHubStatus,\n  isHubServeEnabled,\n  isHubConsumeEnabled,\n  type HubServerRecord,\n  type HubServersResponse,\n} from \"./hub-routes.js\";\n\nexport { fetchHubServers } from \"./hub-client.js\";\n\nexport { isMcpToolAllowedForRequest } from \"./visibility.js\";\nimport { isMcpToolAllowedForRequest } from \"./visibility.js\";\n\n/**\n * Convert MCP tools into `ActionEntry` values suitable for registration in\n * the agent's action registry. Each tool is marked `http: false` so it's\n * never auto-mounted as an HTTP endpoint — MCP tools are agent-only.\n */\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport type { McpClientManager, McpTool } from \"./manager.js\";\n\nexport function mcpToolsToActionEntries(\n  manager: McpClientManager,\n): Record<string, ActionEntry> {\n  const entries: Record<string, ActionEntry> = {};\n  for (const tool of manager.getTools()) {\n    entries[tool.name] = mcpToolToActionEntry(manager, tool);\n  }\n  return entries;\n}\n\n/**\n * Mutate a target action dict in place so it matches the current MCP tool set:\n * - adds new `mcp__*` keys that aren't in target,\n * - removes `mcp__*` keys that no longer exist in the manager,\n * - leaves non-MCP keys untouched.\n *\n * Used by the agent-chat plugin to keep its `prodActions` / `devActions`\n * registries in sync after `McpClientManager.reconfigure()` runs.\n */\nexport function syncMcpActionEntries(\n  manager: McpClientManager,\n  target: Record<string, ActionEntry>,\n): void {\n  const current = new Set<string>();\n  for (const tool of manager.getTools()) {\n    current.add(tool.name);\n    if (!target[tool.name]) {\n      target[tool.name] = mcpToolToActionEntry(manager, tool);\n    }\n  }\n  for (const key of Object.keys(target)) {\n    if (key.startsWith(\"mcp__\") && !current.has(key)) {\n      delete target[key];\n    }\n  }\n}\n\nfunction mcpToolToActionEntry(\n  manager: McpClientManager,\n  tool: McpTool,\n): ActionEntry {\n  return {\n    tool: {\n      description: tool.description,\n      parameters: tool.inputSchema as any,\n    },\n    http: false,\n    run: async (args: Record<string, string>) => {\n      // Defense-in-depth: even if a cross-scope MCP tool somehow makes it\n      // into the LLM's visible tool list, reject invocation here so we never\n      // execute a user's credentials on behalf of another user.\n      if (!isMcpToolAllowedForRequest(tool.name)) {\n        return `Error: MCP tool ${tool.name} is not available in the current request scope.`;\n      }\n      try {\n        const result = await manager.callTool(tool.name, args);\n        // MCP tool results are typically `{ content: [{ type: \"text\", text: ... }], isError? }`.\n        // Flatten text content for the agent's string-based tool result slot.\n        if (\n          result &&\n          typeof result === \"object\" &&\n          Array.isArray((result as any).content)\n        ) {\n          const parts = (result as any).content as Array<Record<string, any>>;\n          const text = parts\n            .map((p) => {\n              if (p?.type === \"text\" && typeof p.text === \"string\")\n                return p.text;\n              if (p?.type === \"image\")\n                return `[image: ${p?.mimeType ?? \"unknown\"}]`;\n              return JSON.stringify(p);\n            })\n            .join(\"\\n\");\n          if ((result as any).isError) return `Error: ${text}`;\n          return text || \"(no output)\";\n        }\n        return typeof result === \"string\" ? result : JSON.stringify(result);\n      } catch (err: any) {\n        return `Error calling MCP tool ${tool.name}: ${err?.message ?? err}`;\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-client/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP client module — symmetric counterpart to `@agent-native/core/mcp`\n * (the MCP server). Connects to local MCP servers configured in\n * `mcp.config.json` or the `MCP_SERVERS` env var and exposes their tools\n * to the agent-chat tool-use loop.\n */\n\nexport {\n  loadMcpConfig,\n  autoDetectMcpConfig,\n  type McpConfig,\n  type McpServerConfig,\n} from \"./config.js\";\n\nexport {\n  McpClientManager,\n  buildMcpToolName,\n  parseMcpToolName,\n  MCP_TOOL_PREFIX,\n  type McpTool,\n  type McpClientManagerOptions,\n} from \"./manager.js\";\n\nexport {\n  listRemoteServers,\n  addRemoteServer,\n  removeRemoteServer,\n  validateRemoteUrl,\n  normalizeServerName,\n  mergedConfigKey,\n  parseMergedKey,\n  hashEmail,\n  toHttpServerConfig,\n  toHttpServerConfigAsync,\n  materializeHeaders,\n  type RemoteMcpScope,\n  type StoredRemoteMcpServer,\n} from \"./remote-store.js\";\n\nexport {\n  BUILTIN_MCP_CAPABILITIES,\n  getBuiltinMcpCapability,\n  isBuiltinMcpCapabilityAvailable,\n  normalizeBuiltinMcpCapabilityIds,\n  toBuiltinMcpServerConfig,\n  type BuiltinMcpCapability,\n  type BuiltinMcpCapabilityId,\n} from \"./builtin-capabilities.js\";\n\nexport {\n  builtinMcpCapabilitiesSettingsKey,\n  listEnabledBuiltinMcpCapabilities,\n  setEnabledBuiltinMcpCapabilities,\n  setBuiltinMcpCapabilityEnabled,\n  type StoredBuiltinMcpCapabilities,\n} from \"./builtin-store.js\";\n\nexport {\n  mountMcpServersRoutes,\n  buildMergedConfig,\n  builtinMergedConfigKey,\n  type ClientBuiltinCapability,\n} from \"./routes.js\";\n\nexport {\n  mountMcpHubRoutes,\n  listHubServers,\n  getHubStatus,\n  isHubServeEnabled,\n  isHubConsumeEnabled,\n  type HubServerRecord,\n  type HubServersResponse,\n} from \"./hub-routes.js\";\n\nexport { fetchHubServers } from \"./hub-client.js\";\n\nexport { isMcpToolAllowedForRequest } from \"./visibility.js\";\nimport { isMcpToolAllowedForRequest } from \"./visibility.js\";\nexport {\n  MCP_ACTION_RESULT_MARKER,\n  isMcpActionResult,\n  type AgentMcpAppPayload,\n  type AgentMcpAppResourceContent,\n  type McpActionResult,\n} from \"./app-result.js\";\nimport {\n  MCP_ACTION_RESULT_MARKER,\n  toolForMcpAppPayload,\n  type AgentMcpAppPayload,\n  type AgentMcpAppResourceContent,\n  type McpActionResult,\n} from \"./app-result.js\";\nimport {\n  getToolUiResourceUri,\n  isToolVisibilityAppOnly,\n  isToolVisibilityModelOnly,\n} from \"@modelcontextprotocol/ext-apps/app-bridge\";\nimport { MCP_APP_MIME_TYPE } from \"../action.js\";\n\n/**\n * Convert MCP tools into `ActionEntry` values suitable for registration in\n * the agent's action registry. Each tool is marked `http: false` so it's\n * never auto-mounted as an HTTP endpoint — MCP tools are agent-only.\n */\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport type { McpClientManager, McpTool } from \"./manager.js\";\n\nexport function mcpToolsToActionEntries(\n  manager: McpClientManager,\n): Record<string, ActionEntry> {\n  const entries: Record<string, ActionEntry> = {};\n  for (const tool of manager.getTools().filter(isVisibleToModel)) {\n    entries[tool.name] = mcpToolToActionEntry(manager, tool);\n  }\n  return entries;\n}\n\n/**\n * Mutate a target action dict in place so it matches the current MCP tool set:\n * - adds new `mcp__*` keys that aren't in target,\n * - removes `mcp__*` keys that no longer exist in the manager,\n * - leaves non-MCP keys untouched.\n *\n * Used by the agent-chat plugin to keep its `prodActions` / `devActions`\n * registries in sync after `McpClientManager.reconfigure()` runs.\n */\nexport function syncMcpActionEntries(\n  manager: McpClientManager,\n  target: Record<string, ActionEntry>,\n): void {\n  const current = new Set<string>();\n  for (const tool of manager.getTools().filter(isVisibleToModel)) {\n    current.add(tool.name);\n    if (!target[tool.name]) {\n      target[tool.name] = mcpToolToActionEntry(manager, tool);\n    }\n  }\n  for (const key of Object.keys(target)) {\n    if (key.startsWith(\"mcp__\") && !current.has(key)) {\n      delete target[key];\n    }\n  }\n}\n\nfunction mcpToolToActionEntry(\n  manager: McpClientManager,\n  tool: McpTool,\n): ActionEntry {\n  return {\n    tool: {\n      description: tool.description,\n      parameters: tool.inputSchema as any,\n    },\n    http: false,\n    run: async (args: Record<string, string>) => {\n      // Defense-in-depth: even if a cross-scope MCP tool somehow makes it\n      // into the LLM's visible tool list, reject invocation here so we never\n      // execute a user's credentials on behalf of another user.\n      if (!isMcpToolAllowedForRequest(tool.name)) {\n        return `Error: MCP tool ${tool.name} is not available in the current request scope.`;\n      }\n      try {\n        const result = await manager.callTool(tool.name, args);\n        return await buildMcpActionResult(manager, tool, args, result);\n      } catch (err: any) {\n        return `Error calling MCP tool ${tool.name}: ${err?.message ?? err}`;\n      }\n    },\n  };\n}\n\nfunction isVisibleToModel(tool: McpTool): boolean {\n  try {\n    return !isToolVisibilityAppOnly(tool.raw as any);\n  } catch {\n    return true;\n  }\n}\n\nexport function isVisibleToMcpApp(tool: McpTool): boolean {\n  try {\n    return !isToolVisibilityModelOnly(tool.raw as any);\n  } catch {\n    return true;\n  }\n}\n\nexport function flattenMcpToolResult(result: unknown): string {\n  if (\n    result &&\n    typeof result === \"object\" &&\n    Array.isArray((result as any).content)\n  ) {\n    const parts = (result as any).content as Array<Record<string, any>>;\n    const text = parts.map(formatMcpContentPart).join(\"\\n\");\n    const fallback =\n      text ||\n      (hasStructuredContent(result)\n        ? JSON.stringify((result as any).structuredContent, null, 2)\n        : \"(no output)\");\n    if ((result as any).isError) return `Error: ${fallback}`;\n    return fallback;\n  }\n  return typeof result === \"string\" ? result : JSON.stringify(result);\n}\n\nfunction formatMcpContentPart(part: Record<string, any>): string {\n  if (part?.type === \"text\" && typeof part.text === \"string\") {\n    return part.text;\n  }\n  if (part?.type === \"image\") {\n    return `[image: ${part?.mimeType ?? \"unknown\"}]`;\n  }\n  if (part?.type === \"resource\") {\n    const resource = part.resource ?? {};\n    const uri = typeof resource.uri === \"string\" ? ` ${resource.uri}` : \"\";\n    return `[resource: ${resource.mimeType ?? \"unknown\"}${uri}]`;\n  }\n  if (part?.type === \"resource_link\") {\n    const uri = typeof part.uri === \"string\" ? ` ${part.uri}` : \"\";\n    return `[resource: ${part.mimeType ?? \"unknown\"}${uri}]`;\n  }\n  return JSON.stringify(part);\n}\n\nfunction hasStructuredContent(result: unknown): boolean {\n  return (\n    !!result &&\n    typeof result === \"object\" &&\n    Object.prototype.hasOwnProperty.call(result, \"structuredContent\")\n  );\n}\n\nasync function buildMcpActionResult(\n  manager: McpClientManager,\n  tool: McpTool,\n  input: Record<string, unknown>,\n  raw: unknown,\n): Promise<McpActionResult> {\n  const text = flattenMcpToolResult(raw);\n  const mcpApp = await extractMcpAppPayload(manager, tool, input, raw);\n  return {\n    [MCP_ACTION_RESULT_MARKER]: true,\n    text,\n    raw,\n    serverId: tool.source,\n    toolName: tool.name,\n    originalToolName: tool.originalName,\n    input,\n    ...(mcpApp ? { mcpApp } : {}),\n  };\n}\n\nasync function extractMcpAppPayload(\n  manager: McpClientManager,\n  tool: McpTool,\n  input: Record<string, unknown>,\n  raw: unknown,\n): Promise<AgentMcpAppPayload | undefined> {\n  const inlineResource = findInlineMcpAppResource(raw);\n  const resourceUri =\n    inlineResource?.uri ??\n    resourceUriFromTool(tool) ??\n    resourceUriFromResult(raw);\n  if (!resourceUri) return undefined;\n\n  const resource =\n    inlineResource ?? (await readMcpAppResource(manager, tool, resourceUri));\n\n  return {\n    serverId: tool.source,\n    toolName: tool.name,\n    originalToolName: tool.originalName,\n    resourceUri,\n    toolInput: input,\n    toolResult:\n      raw && typeof raw === \"object\"\n        ? ({ ...(raw as Record<string, unknown>) } as Record<string, unknown>)\n        : { content: [{ type: \"text\", text: String(raw ?? \"\") }] },\n    tool: toolForMcpAppPayload(tool),\n    ...(resource ? { resource } : {}),\n  };\n}\n\nfunction resourceUriFromTool(tool: McpTool): string | undefined {\n  try {\n    return getToolUiResourceUri(tool.raw as any);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resourceUriFromResult(raw: unknown): string | undefined {\n  if (!raw || typeof raw !== \"object\") return undefined;\n  const meta = (raw as any)._meta;\n  const nested = meta?.ui?.resourceUri;\n  if (typeof nested === \"string\" && nested.startsWith(\"ui://\")) return nested;\n  const flat = meta?.[\"ui/resourceUri\"] ?? meta?.[\"ui.resourceUri\"];\n  if (typeof flat === \"string\" && flat.startsWith(\"ui://\")) return flat;\n  return findInlineMcpAppResource(raw)?.uri;\n}\n\nfunction findInlineMcpAppResource(\n  raw: unknown,\n): AgentMcpAppResourceContent | undefined {\n  if (!raw || typeof raw !== \"object\") return undefined;\n  const content = Array.isArray((raw as any).content)\n    ? ((raw as any).content as unknown[])\n    : [];\n  for (const part of content) {\n    const resource = normalizeMcpAppResourceContent(part);\n    if (resource) return resource;\n  }\n  return undefined;\n}\n\nfunction normalizeMcpAppResourceContent(\n  part: unknown,\n): AgentMcpAppResourceContent | undefined {\n  if (!part || typeof part !== \"object\") return undefined;\n  const candidate =\n    (part as any).type === \"resource\"\n      ? (part as any).resource\n      : ((part as any).resource ?? part);\n  if (!candidate || typeof candidate !== \"object\") return undefined;\n  const uri = (candidate as any).uri;\n  if (typeof uri !== \"string\" || !uri.startsWith(\"ui://\")) return undefined;\n  const mimeType =\n    typeof (candidate as any).mimeType === \"string\"\n      ? (candidate as any).mimeType\n      : undefined;\n  if (mimeType && !mimeType.includes(MCP_APP_MIME_TYPE)) return undefined;\n  const text =\n    typeof (candidate as any).text === \"string\"\n      ? (candidate as any).text\n      : undefined;\n  const blob =\n    typeof (candidate as any).blob === \"string\"\n      ? (candidate as any).blob\n      : undefined;\n  const meta =\n    (candidate as any)._meta && typeof (candidate as any)._meta === \"object\"\n      ? ((candidate as any)._meta as Record<string, unknown>)\n      : (part as any)._meta && typeof (part as any)._meta === \"object\"\n        ? ((part as any)._meta as Record<string, unknown>)\n        : undefined;\n  return {\n    uri,\n    ...(mimeType ? { mimeType } : {}),\n    ...(text ? { text } : {}),\n    ...(blob ? { blob } : {}),\n    ...(meta ? { _meta: meta } : {}),\n  };\n}\n\nasync function readMcpAppResource(\n  manager: McpClientManager,\n  tool: McpTool,\n  resourceUri: string,\n): Promise<AgentMcpAppResourceContent | undefined> {\n  try {\n    const result = await manager.readResourceForTool(tool.name, resourceUri);\n    const contents = Array.isArray((result as any)?.contents)\n      ? ((result as any).contents as unknown[])\n      : [];\n    for (const content of contents) {\n      const resource = normalizeMcpAppResourceContent(content);\n      if (\n        resource?.uri === resourceUri ||\n        (resource && contents.length === 1)\n      ) {\n        return resource;\n      }\n    }\n  } catch (err: any) {\n    console.warn(\n      `[mcp-client] Failed to read MCP App resource ${resourceUri}: ${err?.message ?? err}`,\n    );\n  }\n  return undefined;\n}\n"]}

package/dist/mcp-client/manager.d.ts

@@ -20,7 +20,18 @@ export interface McpTool {
     description: string;
     /** JSON-Schema input spec forwarded verbatim from the server */
     inputSchema: Record<string, unknown>;
+    /** Optional title as reported by the MCP server */
+    title?: string;
+    /** JSON-Schema output spec forwarded verbatim from the server */
+    outputSchema?: Record<string, unknown>;
+    /** MCP tool annotations forwarded verbatim from the server */
+    annotations?: Record<string, unknown>;
+    /** MCP metadata forwarded verbatim from the server */
+    _meta?: Record<string, unknown>;
+    /** Full raw tool object for extensions that depend on fields core does not know yet. */
+    raw: Record<string, unknown>;
 }
+export declare function buildMcpToolName(serverId: string, toolName: string): string;
 /**
  * Parse a prefixed tool name back into its server id and original tool name.
  * Returns `null` if the name doesn't match the MCP prefix convention.
@@ -102,11 +113,16 @@ export declare class McpClientManager {
     private reconfigureInternal;
     /** Flattened tool list across all connected servers. */
     getTools(): McpTool[];
+    getTool(prefixedName: string): McpTool | null;
+    getToolsForServer(serverId: string): McpTool[];
+    hasServer(serverId: string): boolean;
     /**
      * Invoke an MCP tool by prefixed name. Routes to the owning server based on
      * the `mcp__<serverId>__` prefix.
      */
     callTool(prefixedName: string, args: unknown): Promise<unknown>;
+    readResource(serverId: string, uri: string): Promise<unknown>;
+    readResourceForTool(prefixedName: string, uri: string): Promise<unknown>;
     /** Cleanly close all MCP clients and child processes. */
     stop(): Promise<void>;
     /** Diagnostic snapshot used by `/_agent-native/mcp/status`. */

package/dist/mcp-client/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mcp-client/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAG9D,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,MAAM,WAAW,OAAO;IACtB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS/C;AAED,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwDD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD;6EACyE;IACzE,OAAO,CAAC,gBAAgB,CAAuC;gBAEnD,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,GAAE,uBAA4B;IAK3E,wDAAwD;IACxD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;+EAC2E;IAC3E,SAAS,IAAI,SAAS,GAAG,IAAI;IAI7B,wEAAwE;IACxE,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAGhC;IAED,2EAA2E;IAC3E,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAI/B;IAED;;;OAGG;YACW,OAAO;IA+CrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO1C,OAAO,CAAC,UAAU;IAYlB;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,aAAa;IAkB3B;;;OAGG;YACW,SAAS;YA6BT,aAAa;IAuH3B;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC;QACtD,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;YAUY,mBAAmB;IAyEjC,wDAAwD;IACxD,QAAQ,IAAI,OAAO,EAAE;IASrB;;;OAGG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCrE,yDAAyD;IACnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,+DAA+D;IAC/D,SAAS,IAAI;QACX,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;CAkBF"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mcp-client/manager.ts"],"names":[],"mappings":"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"}

package/dist/mcp-client/manager.js

@@ -8,6 +8,7 @@
  * lets callers add or remove servers at runtime without restarting the process.
  */
 import { formatMcpConnectError } from "./errors.js";
+import { MCP_APP_EXTENSION_ID, MCP_APP_MIME_TYPE } from "../action.js";
 export const MCP_TOOL_PREFIX = "mcp__";
 function isNode() {
     return (typeof process !== "undefined" &&
@@ -17,6 +18,9 @@ function isNode() {
 function buildPrefixedName(serverId, toolName) {
     return `${MCP_TOOL_PREFIX}${serverId}__${toolName}`;
 }
+export function buildMcpToolName(serverId, toolName) {
+    return buildPrefixedName(serverId, toolName);
+}
 /**
  * Parse a prefixed tool name back into its server id and original tool name.
  * Returns `null` if the name doesn't match the MCP prefix convention.
@@ -282,7 +286,15 @@ export class McpClientManager {
                 cwd,
             });
         }
-        const client = new Client({ name: "agent-native-mcp-client", version: "1.0.0" }, { capabilities: {} });
+        const client = new Client({ name: "agent-native-mcp-client", version: "1.0.0" }, {
+            capabilities: {
+                extensions: {
+                    [MCP_APP_EXTENSION_ID]: {
+                        mimeTypes: [MCP_APP_MIME_TYPE],
+                    },
+                },
+            },
+        });
         const recordConnectionError = () => { };
         const restoreClientClose = guardClose(client, recordConnectionError);
         const restoreTransportClose = guardClose(transport, recordConnectionError);
@@ -310,11 +322,16 @@ export class McpClientManager {
                 source: entry.id,
                 name: buildPrefixedName(entry.id, t.name),
                 originalName: t.name,
+                ...(t.title ? { title: t.title } : {}),
                 description: t.description ?? t.name,
                 inputSchema: (t.inputSchema ?? {
                     type: "object",
                     properties: {},
                 }),
+                ...(t.outputSchema ? { outputSchema: t.outputSchema } : {}),
+                ...(t.annotations ? { annotations: t.annotations } : {}),
+                ...(t._meta ? { _meta: t._meta } : {}),
+                raw: { ...t },
             }));
             client.onerror = (error) => {
                 entry.error = formatMcpConnectError(error);
@@ -425,6 +442,20 @@ export class McpClientManager {
         }
         return out;
     }
+    getTool(prefixedName) {
+        const parsed = parseMcpToolName(prefixedName);
+        if (!parsed)
+            return null;
+        const entry = this.servers.get(parsed.serverId);
+        return entry?.tools.find((t) => t.name === prefixedName) ?? null;
+    }
+    getToolsForServer(serverId) {
+        return [...(this.servers.get(serverId)?.tools ?? [])];
+    }
+    hasServer(serverId) {
+        const entry = this.servers.get(serverId);
+        return !!entry?.client && !entry.error;
+    }
     /**
      * Invoke an MCP tool by prefixed name. Routes to the owning server based on
      * the `mcp__<serverId>__` prefix.
@@ -452,6 +483,32 @@ export class McpClientManager {
         });
         return result;
     }
+    async readResource(serverId, uri) {
+        if (!uri.startsWith("ui://")) {
+            throw new Error(`Only ui:// MCP App resources can be read by this host`);
+        }
+        const entry = this.servers.get(serverId);
+        if (!entry || !entry.client) {
+            throw new Error(`MCP server "${serverId}" is not connected${entry?.error ? `: ${entry.error}` : ""}`);
+        }
+        if (typeof entry.client.readResource === "function") {
+            return entry.client.readResource({ uri });
+        }
+        if (typeof entry.client.request === "function") {
+            return entry.client.request({
+                method: "resources/read",
+                params: { uri },
+            });
+        }
+        throw new Error(`MCP server "${serverId}" does not support resources/read`);
+    }
+    async readResourceForTool(prefixedName, uri) {
+        const parsed = parseMcpToolName(prefixedName);
+        if (!parsed) {
+            throw new Error(`Tool name "${prefixedName}" does not look like an MCP tool (expected mcp__<server>__<tool>)`);
+        }
+        return this.readResource(parsed.serverId, uri);
+    }
     /** Cleanly close all MCP clients and child processes. */
     async stop() {
         const entries = Array.from(this.servers.values());