react-native-mcp-kit 4.2.0 → 4.2.1

package/dist/modules/fiberTree/utils/serialize.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeFiber = exports.getTextContent = void 0;
+const constants_1 = require("./constants");
+const naming_1 = require("./naming");
+const getTextContent = (fiber) => {
+    if (fiber.tag === constants_1.HOST_TEXT) {
+        return fiber.memoizedProps;
+    }
+    // Check children for text
+    let text = '';
+    let child = fiber.child;
+    while (child) {
+        if (child.tag === constants_1.HOST_TEXT && typeof child.memoizedProps === 'string') {
+            text += child.memoizedProps;
+        }
+        child = child.sibling;
+    }
+    return text || undefined;
+};
+exports.getTextContent = getTextContent;
+// Host components that are just native mirrors of composite wrappers (e.g. RCTView for View)
+const HOST_PASSTHROUGH = new Set(['RCTView', 'RCTText', 'RCTScrollView', 'RCTSafeAreaView']);
+const shouldSkipFiber = (fiber) => {
+    const componentType = (0, naming_1.getComponentType)(fiber);
+    // Skip internal React wrapper nodes (providers, contexts, etc.)
+    if (componentType === 'other' && fiber.tag !== constants_1.HOST_TEXT)
+        return true;
+    // Skip native host mirrors — their composite parent already represents the same component
+    if (componentType === 'host' && HOST_PASSTHROUGH.has((0, naming_1.getComponentName)(fiber)))
+        return true;
+    return false;
+};
+const collectChildren = (fiber, maxDepth, currentDepth) => {
+    const children = [];
+    let child = fiber.child;
+    while (child) {
+        if (shouldSkipFiber(child)) {
+            // Skip this node but collect its children at the same depth
+            children.push(...collectChildren(child, maxDepth, currentDepth));
+        }
+        else {
+            const serialized = (0, exports.serializeFiber)(child, maxDepth, currentDepth + 1);
+            if (serialized) {
+                children.push(serialized);
+            }
+        }
+        child = child.sibling;
+    }
+    return children;
+};
+const serializeFiberUnsafe = (fiber, maxDepth, currentDepth) => {
+    if (shouldSkipFiber(fiber)) {
+        const children = collectChildren(fiber, maxDepth, currentDepth);
+        if (children.length === 1)
+            return children[0];
+        if (children.length > 1) {
+            return {
+                children,
+                name: 'Fragment',
+                props: {},
+                type: 'other',
+            };
+        }
+        return null;
+    }
+    const name = (0, naming_1.getComponentName)(fiber);
+    // Pass raw memoizedProps through — handler-level `applyProjection` runs the
+    // single canonical projectValue walk on the final response, including this
+    // tree. Projecting here would cause double-projection and break path drill.
+    const props = (fiber.memoizedProps ?? {});
+    const mcpId = fiber.memoizedProps?.['data-mcp-id'];
+    const testID = fiber.memoizedProps?.testID;
+    const text = (0, exports.getTextContent)(fiber);
+    const children = collectChildren(fiber, maxDepth, currentDepth);
+    return {
+        children,
+        mcpId,
+        name,
+        props,
+        testID,
+        text,
+        type: (0, naming_1.getComponentType)(fiber),
+    };
+};
+const serializeFiber = (fiber, maxDepth, currentDepth = 0) => {
+    if (!fiber || currentDepth > maxDepth)
+        return null;
+    try {
+        return serializeFiberUnsafe(fiber, maxDepth, currentDepth);
+    }
+    catch {
+        return {
+            children: [],
+            name: (0, naming_1.getComponentName)(fiber),
+            props: { __error: 'Failed to serialize' },
+            type: (0, naming_1.getComponentType)(fiber),
+        };
+    }
+};
+exports.serializeFiber = serializeFiber;
+//# sourceMappingURL=serialize.js.map

package/dist/modules/fiberTree/utils/serialize.js.map

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

package/dist/modules/fiberTree/utils/traverse.d.ts

@@ -0,0 +1,12 @@
+import { type Fiber } from '../../../modules/fiberTree/types';
+export declare const findFiber: (root: Fiber, predicate: (fiber: Fiber) => boolean) => Fiber | null;
+export declare const findAllFibers: (root: Fiber, predicate: (fiber: Fiber) => boolean) => Fiber[];
+export declare const findByMcpId: (root: Fiber, mcpId: string) => Fiber | null;
+export declare const findByTestID: (root: Fiber, testID: string) => Fiber | null;
+export declare const findByName: (root: Fiber, name: string) => Fiber | null;
+export declare const findByText: (root: Fiber, text: string) => Fiber | null;
+export declare const getDirectChildren: (fiber: Fiber) => Fiber[];
+export declare const getSiblings: (fiber: Fiber) => Fiber[];
+export declare const getAncestors: (fiber: Fiber) => Fiber[];
+export declare const findHostFiber: (fiber: Fiber) => Fiber | null;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/modules/fiberTree/utils/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAMvD,eAAO,MAAM,SAAS,SAAU,KAAK,aAAa,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,KAAG,KAAK,GAAG,IAWrF,CAAC;AAEF,eAAO,MAAM,aAAa,SAAU,KAAK,aAAa,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,KAAG,KAAK,EAgBtF,CAAC;AAEF,eAAO,MAAM,WAAW,SAAU,KAAK,SAAS,MAAM,KAAG,KAAK,GAAG,IAIhE,CAAC;AAEF,eAAO,MAAM,YAAY,SAAU,KAAK,UAAU,MAAM,KAAG,KAAK,GAAG,IAIlE,CAAC;AAEF,eAAO,MAAM,UAAU,SAAU,KAAK,QAAQ,MAAM,KAAG,KAAK,GAAG,IAI9D,CAAC;AAEF,eAAO,MAAM,UAAU,SAAU,KAAK,QAAQ,MAAM,KAAG,KAAK,GAAG,IAK9D,CAAC;AAGF,eAAO,MAAM,iBAAiB,UAAW,KAAK,KAAG,KAAK,EAQrD,CAAC;AAGF,eAAO,MAAM,WAAW,UAAW,KAAK,KAAG,KAAK,EAM/C,CAAC;AAGF,eAAO,MAAM,YAAY,UAAW,KAAK,KAAG,KAAK,EAQhD,CAAC;AAGF,eAAO,MAAM,aAAa,UAAW,KAAK,KAAG,KAAK,GAAG,IAUpD,CAAC"}

package/dist/modules/fiberTree/utils/traverse.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findHostFiber = exports.getAncestors = exports.getSiblings = exports.getDirectChildren = exports.findByText = exports.findByName = exports.findByTestID = exports.findByMcpId = exports.findAllFibers = exports.findFiber = void 0;
+const constants_1 = require("./constants");
+const naming_1 = require("./naming");
+const serialize_1 = require("./serialize");
+const findFiber = (root, predicate) => {
+    if (predicate(root))
+        return root;
+    let child = root.child;
+    while (child) {
+        const found = (0, exports.findFiber)(child, predicate);
+        if (found)
+            return found;
+        child = child.sibling;
+    }
+    return null;
+};
+exports.findFiber = findFiber;
+const findAllFibers = (root, predicate) => {
+    const results = [];
+    const walk = (fiber) => {
+        if (predicate(fiber)) {
+            results.push(fiber);
+        }
+        let child = fiber.child;
+        while (child) {
+            walk(child);
+            child = child.sibling;
+        }
+    };
+    walk(root);
+    return results;
+};
+exports.findAllFibers = findAllFibers;
+const findByMcpId = (root, mcpId) => {
+    return (0, exports.findFiber)(root, (fiber) => {
+        return fiber.memoizedProps?.['data-mcp-id'] === mcpId;
+    });
+};
+exports.findByMcpId = findByMcpId;
+const findByTestID = (root, testID) => {
+    return (0, exports.findFiber)(root, (fiber) => {
+        return fiber.memoizedProps?.testID === testID;
+    });
+};
+exports.findByTestID = findByTestID;
+const findByName = (root, name) => {
+    return (0, exports.findFiber)(root, (fiber) => {
+        return (0, naming_1.getComponentName)(fiber) === name;
+    });
+};
+exports.findByName = findByName;
+const findByText = (root, text) => {
+    return (0, exports.findFiber)(root, (fiber) => {
+        const content = (0, serialize_1.getTextContent)(fiber);
+        return content !== undefined && content.includes(text);
+    });
+};
+exports.findByText = findByText;
+// Direct children of a fiber (one level down, not descendants).
+const getDirectChildren = (fiber) => {
+    const out = [];
+    let child = fiber.child;
+    while (child) {
+        out.push(child);
+        child = child.sibling;
+    }
+    return out;
+};
+exports.getDirectChildren = getDirectChildren;
+// Sibling fibers at the same level, excluding `fiber` itself.
+const getSiblings = (fiber) => {
+    const parent = fiber.return;
+    if (!parent)
+        return [];
+    return (0, exports.getDirectChildren)(parent).filter((f) => {
+        return f !== fiber;
+    });
+};
+exports.getSiblings = getSiblings;
+// Ancestors walked upward via `fiber.return`, nearest first.
+const getAncestors = (fiber) => {
+    const out = [];
+    let current = fiber.return;
+    while (current) {
+        out.push(current);
+        current = current.return;
+    }
+    return out;
+};
+exports.getAncestors = getAncestors;
+// Find the nearest host fiber (native component) from a given fiber.
+const findHostFiber = (fiber) => {
+    if (fiber.tag === constants_1.HOST_COMPONENT)
+        return fiber;
+    let child = fiber.child;
+    while (child) {
+        const found = (0, exports.findHostFiber)(child);
+        if (found)
+            return found;
+        child = child.sibling;
+    }
+    return null;
+};
+exports.findHostFiber = findHostFiber;
+//# sourceMappingURL=traverse.js.map

package/dist/modules/fiberTree/utils/traverse.js.map

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

package/dist/server/dispatch.d.ts

@@ -0,0 +1,15 @@
+import { type Bridge } from './bridge';
+import { type DispatchResult, type HostToolEntry } from './helpers';
+import { type HostModule } from './host/types';
+/**
+ * Pre-indexes host tools by full name so dispatch is O(1).
+ */
+export declare const buildHostToolMap: (hostModules: HostModule[]) => Map<string, HostToolEntry>;
+/**
+ * Creates the tool dispatcher used by `call`, `wait_until`, `assert`, and host
+ * tools that chain (`host__tap_fiber` → `fiber_tree__query` + `host__tap`). The
+ * returned function closes over `bridge` + `hostToolMap` so the host context's
+ * own `dispatch` callback can re-enter without losing the original clientId.
+ */
+export declare const createDispatcher: (bridge: Bridge, hostToolMap: Map<string, HostToolEntry>) => ((tool: string, args: Record<string, unknown>, clientId?: string) => Promise<DispatchResult>);
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/server/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/server/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,gBAAgB,gBAAiB,UAAU,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAcrF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,eACD,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,KACtC,CAAC,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC,cAAc,CAAC,CA8F3B,CAAC"}

package/dist/server/dispatch.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDispatcher = exports.buildHostToolMap = void 0;
+const protocol_1 = require("../shared/protocol");
+/**
+ * Pre-indexes host tools by full name so dispatch is O(1).
+ */
+const buildHostToolMap = (hostModules) => {
+    const map = new Map();
+    for (const mod of hostModules) {
+        for (const [toolName, tool] of Object.entries(mod.tools)) {
+            const fullName = `${mod.name}${protocol_1.MODULE_SEPARATOR}${toolName}`;
+            map.set(fullName, {
+                handler: tool.handler,
+                moduleName: mod.name,
+                timeout: tool.timeout,
+                toolName,
+            });
+        }
+    }
+    return map;
+};
+exports.buildHostToolMap = buildHostToolMap;
+/**
+ * Creates the tool dispatcher used by `call`, `wait_until`, `assert`, and host
+ * tools that chain (`host__tap_fiber` → `fiber_tree__query` + `host__tap`). The
+ * returned function closes over `bridge` + `hostToolMap` so the host context's
+ * own `dispatch` callback can re-enter without losing the original clientId.
+ */
+const createDispatcher = (bridge, hostToolMap) => {
+    const dispatch = async (tool, args, clientId) => {
+        const hostEntry = hostToolMap.get(tool);
+        if (hostEntry) {
+            try {
+                const result = await hostEntry.handler(args, {
+                    bridge,
+                    dispatch: (nextTool, nextArgs, nextClientId) => {
+                        return dispatch(nextTool, nextArgs, nextClientId ?? clientId);
+                    },
+                    requestedClientId: clientId,
+                });
+                return { ok: true, result };
+            }
+            catch (err) {
+                return { error: `Host tool "${tool}" threw: ${err.message}`, ok: false };
+            }
+        }
+        const resolution = bridge.resolveClient(clientId);
+        if (!resolution.ok)
+            return { error: resolution.error, ok: false };
+        const client = resolution.client;
+        let mod;
+        let moduleName = '';
+        let methodName = '';
+        for (const m of client.modules) {
+            const prefix = `${m.name}${protocol_1.MODULE_SEPARATOR}`;
+            if (tool.startsWith(prefix)) {
+                mod = m;
+                moduleName = m.name;
+                methodName = tool.slice(prefix.length);
+                break;
+            }
+        }
+        if (!mod) {
+            if (tool.startsWith(protocol_1.DYNAMIC_PREFIX)) {
+                moduleName = `${protocol_1.MODULE_SEPARATOR}dynamic`;
+                methodName = tool.slice(protocol_1.DYNAMIC_PREFIX.length);
+            }
+            else {
+                const idx = tool.indexOf(protocol_1.MODULE_SEPARATOR);
+                if (idx <= 0) {
+                    return {
+                        error: `Invalid tool name "${tool}". Use "module${protocol_1.MODULE_SEPARATOR}method" format.`,
+                        ok: false,
+                    };
+                }
+                moduleName = tool.slice(0, idx);
+                methodName = tool.slice(idx + protocol_1.MODULE_SEPARATOR.length);
+            }
+            try {
+                const result = await bridge.call(client.id, moduleName, methodName, args);
+                return { ok: true, result };
+            }
+            catch {
+                const allModules = client.modules
+                    .map((m) => {
+                    return m.name;
+                })
+                    .join(', ');
+                const dynNames = [...client.dynamicTools.keys()].join(', ');
+                return {
+                    error: `Tool "${tool}" not found on client '${client.id}'. Modules: ${allModules || '(none)'}. Dynamic: ${dynNames || '(none)'}`,
+                    ok: false,
+                };
+            }
+        }
+        const toolDef = mod.tools.find((t) => {
+            return t.name === methodName;
+        });
+        if (!toolDef) {
+            return {
+                error: `Tool "${methodName}" not found in module "${moduleName}" on client '${client.id}'. Available: ${mod.tools
+                    .map((t) => {
+                    return t.name;
+                })
+                    .join(', ')}`,
+                ok: false,
+            };
+        }
+        try {
+            const result = await bridge.call(client.id, moduleName, methodName, args, toolDef.timeout);
+            return { ok: true, result };
+        }
+        catch (err) {
+            return { error: err.message, ok: false };
+        }
+    };
+    return dispatch;
+};
+exports.createDispatcher = createDispatcher;
+//# sourceMappingURL=dispatch.js.map

package/dist/server/dispatch.js.map

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

package/dist/server/helpers.d.ts

@@ -0,0 +1,97 @@
+import { type Bridge, type ClientEntry } from './bridge';
+import { type HostModule, type HostToolHandler } from './host/types';
+export type TextContent = {
+    text: string;
+    type: 'text';
+};
+export type ImageContent = {
+    data: string;
+    mimeType: string;
+    type: 'image';
+};
+export interface HostToolEntry {
+    handler: HostToolHandler['handler'];
+    moduleName: string;
+    toolName: string;
+    timeout?: number;
+}
+export interface ToolDescriptorShape {
+    description: string;
+    name: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface ToolGroup {
+    description: string | undefined;
+    module: string;
+    tools: Array<{
+        description: string;
+        name: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+}
+export type DispatchResult = {
+    ok: true;
+    result: unknown;
+} | {
+    error: string;
+    ok: false;
+};
+/**
+ * Shared state passed to every MCP tool registration in `src/server/tools/`.
+ * The McpServerWrapper constructs one and hands it to each `register<Tool>`
+ * function so the tool files stay decoupled from the class.
+ */
+export interface ServerContext {
+    bridge: Bridge;
+    dispatchTool: (tool: string, args: Record<string, unknown>, clientId?: string) => Promise<DispatchResult>;
+    formatResult: (result: unknown) => Array<TextContent | ImageContent>;
+    hostModules: HostModule[];
+    hostToolMap: Map<string, HostToolEntry>;
+    listToolGroups: (client: ClientEntry) => ToolGroup[];
+}
+export declare const jsonError: (msg: string) => {
+    content: TextContent[];
+};
+/**
+ * Parse a `call`-style args argument that may arrive as a JSON string (older
+ * clients) or a plain object (new form). Returns { ok, args } or { ok: false,
+ * error } on malformed JSON.
+ */
+export declare const parseCallArgs: (raw: unknown) => {
+    args: Record<string, unknown>;
+    ok: true;
+} | {
+    error: string;
+    ok: false;
+};
+/**
+ * Recursively serializes a value to JSON with sorted object keys, producing a
+ * stable canonical form that's safe to use as a dedup Map key. Arrays keep
+ * their original order — caller is responsible for normalizing them when
+ * order-independence is desired.
+ */
+export declare const canonicalize: (value: unknown) => string;
+/**
+ * Produces a canonical key for a ToolGroup that's independent of tool
+ * registration order. Two modules with the same name + tools (regardless of
+ * order) + descriptions + schemas produce the same key.
+ */
+export declare const canonicalizeGroup: (group: ToolGroup) => string;
+/**
+ * Looks up a full tool descriptor on a client by its full name
+ * (`module__method`). Checks both static modules and dynamic tools registered
+ * via useMcpTool. Returns null if the tool is not on this client.
+ */
+export declare const findToolInClient: (client: ClientEntry, toolFullName: string) => ToolDescriptorShape | null;
+/**
+ * Builds the per-client list of ToolGroup entries that `list_tools` deduplicates
+ * across clients. Static modules are passed through; dynamic tools are grouped
+ * under a synthetic `<module> (dynamic)` group per source module.
+ */
+export declare const buildToolGroups: (client: ClientEntry) => ToolGroup[];
+/**
+ * Detects image-content payloads (from host__screenshot) and passes them
+ * through as MCP image blocks; everything else is JSON-serialized text.
+ */
+export declare const formatResult: (result: unknown) => Array<TextContent | ImageContent>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/server/helpers.d.ts.map

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

package/dist/server/helpers.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatResult = exports.buildToolGroups = exports.findToolInClient = exports.canonicalizeGroup = exports.canonicalize = exports.parseCallArgs = exports.jsonError = void 0;
+const protocol_1 = require("../shared/protocol");
+const jsonError = (msg) => {
+    return {
+        content: [{ text: JSON.stringify({ error: msg }), type: 'text' }],
+    };
+};
+exports.jsonError = jsonError;
+/**
+ * Parse a `call`-style args argument that may arrive as a JSON string (older
+ * clients) or a plain object (new form). Returns { ok, args } or { ok: false,
+ * error } on malformed JSON.
+ */
+const parseCallArgs = (raw) => {
+    if (raw === undefined || raw === null)
+        return { args: {}, ok: true };
+    if (typeof raw === 'string') {
+        if (raw.length === 0)
+            return { args: {}, ok: true };
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return { args: parsed, ok: true };
+            }
+            return { error: 'Parsed args must be an object.', ok: false };
+        }
+        catch {
+            return { error: 'Invalid JSON in args.', ok: false };
+        }
+    }
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return { args: raw, ok: true };
+    }
+    return { error: 'args must be an object or a JSON string.', ok: false };
+};
+exports.parseCallArgs = parseCallArgs;
+/**
+ * Recursively serializes a value to JSON with sorted object keys, producing a
+ * stable canonical form that's safe to use as a dedup Map key. Arrays keep
+ * their original order — caller is responsible for normalizing them when
+ * order-independence is desired.
+ */
+const canonicalize = (value) => {
+    return JSON.stringify(value, (_key, v) => {
+        if (v && typeof v === 'object' && !Array.isArray(v)) {
+            const sorted = {};
+            for (const k of Object.keys(v).sort()) {
+                sorted[k] = v[k];
+            }
+            return sorted;
+        }
+        return v;
+    });
+};
+exports.canonicalize = canonicalize;
+/**
+ * Produces a canonical key for a ToolGroup that's independent of tool
+ * registration order. Two modules with the same name + tools (regardless of
+ * order) + descriptions + schemas produce the same key.
+ */
+const canonicalizeGroup = (group) => {
+    const normalized = {
+        description: group.description,
+        module: group.module,
+        tools: [...group.tools].sort((a, b) => {
+            return a.name.localeCompare(b.name);
+        }),
+    };
+    return (0, exports.canonicalize)(normalized);
+};
+exports.canonicalizeGroup = canonicalizeGroup;
+/**
+ * Looks up a full tool descriptor on a client by its full name
+ * (`module__method`). Checks both static modules and dynamic tools registered
+ * via useMcpTool. Returns null if the tool is not on this client.
+ */
+const findToolInClient = (client, toolFullName) => {
+    for (const mod of client.modules) {
+        const prefix = `${mod.name}${protocol_1.MODULE_SEPARATOR}`;
+        if (toolFullName.startsWith(prefix)) {
+            const methodName = toolFullName.slice(prefix.length);
+            const toolDef = mod.tools.find((t) => {
+                return t.name === methodName;
+            });
+            if (toolDef) {
+                return {
+                    description: toolDef.description,
+                    inputSchema: toolDef.inputSchema,
+                    name: toolFullName,
+                };
+            }
+        }
+    }
+    const dynamicEntry = client.dynamicTools.get(toolFullName);
+    if (dynamicEntry) {
+        return {
+            description: dynamicEntry.description,
+            inputSchema: dynamicEntry.inputSchema,
+            name: toolFullName,
+        };
+    }
+    return null;
+};
+exports.findToolInClient = findToolInClient;
+/**
+ * Builds the per-client list of ToolGroup entries that `list_tools` deduplicates
+ * across clients. Static modules are passed through; dynamic tools are grouped
+ * under a synthetic `<module> (dynamic)` group per source module.
+ */
+const buildToolGroups = (client) => {
+    const groups = client.modules.map((mod) => {
+        return {
+            description: mod.description,
+            module: mod.name,
+            tools: mod.tools.map((t) => {
+                return {
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                    name: `${mod.name}${protocol_1.MODULE_SEPARATOR}${t.name}`,
+                };
+            }),
+        };
+    });
+    if (client.dynamicTools.size > 0) {
+        const dynamicByModule = new Map();
+        for (const [fullName, info] of client.dynamicTools) {
+            const existing = dynamicByModule.get(info.module) ?? [];
+            existing.push({
+                description: info.description,
+                inputSchema: info.inputSchema,
+                name: fullName,
+            });
+            dynamicByModule.set(info.module, existing);
+        }
+        for (const [module, dynTools] of dynamicByModule) {
+            groups.push({
+                description: 'Dynamically registered tools from useMcpTool hooks',
+                module: `${module} (dynamic)`,
+                tools: dynTools,
+            });
+        }
+    }
+    return groups;
+};
+exports.buildToolGroups = buildToolGroups;
+/**
+ * Detects image-content payloads (from host__screenshot) and passes them
+ * through as MCP image blocks; everything else is JSON-serialized text.
+ */
+const formatResult = (result) => {
+    if (Array.isArray(result) && result.length > 0) {
+        const first = result[0];
+        if (typeof first === 'object' && first !== null && 'type' in first && first.type === 'image') {
+            return result;
+        }
+    }
+    return [{ text: JSON.stringify(result, null, 2), type: 'text' }];
+};
+exports.formatResult = formatResult;
+//# sourceMappingURL=helpers.js.map