@pentoshi/clai 4.8.4 → 4.10.0

package/dist/mcp/manager.js

@@ -0,0 +1,300 @@
+import { discoverMcpServers } from "./discovery.js";
+import { McpClient } from "./client.js";
+import { redactSecrets } from "./format.js";
+import { toToolMetadata } from "./results.js";
+import { allocateWireNames, canonicalToolName, toolIdentity, } from "./names.js";
+import { McpTransportError } from "./transport.js";
+import { StdioTransport } from "./transport-stdio.js";
+import { LegacySseTransport, StreamableHttpTransport, } from "./transport-http.js";
+const DEFAULT_CONNECT_CONCURRENCY = 4;
+const DEFAULT_CONNECT_TIMEOUT_MS = 30_000;
+const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
+async function runBounded(items, limit, worker) {
+    if (items.length === 0)
+        return;
+    let index = 0;
+    const size = Math.max(1, Math.min(limit, items.length));
+    const runners = Array.from({ length: size }, async () => {
+        while (index < items.length) {
+            const current = items[index++];
+            await worker(current);
+        }
+    });
+    await Promise.all(runners);
+}
+export class McpManager {
+    options;
+    connections = new Map();
+    discovery = {
+        servers: [],
+        shadowed: [],
+        invalid: [],
+        sources: [],
+        warnings: [],
+    };
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get connectTimeoutMs() {
+        return this.options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+    }
+    get requestTimeoutMs() {
+        return this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    createTransport(definition) {
+        if (this.options.transportFactory)
+            return this.options.transportFactory(definition);
+        const config = definition.config;
+        if (config.transport === "stdio") {
+            return new StdioTransport(config, { requestTimeoutMs: this.requestTimeoutMs });
+        }
+        const httpOptions = { requestTimeoutMs: this.requestTimeoutMs };
+        if (config.transport === "sse")
+            return new LegacySseTransport(config, httpOptions);
+        return new StreamableHttpTransport(config, httpOptions);
+    }
+    getDiscovery() {
+        return this.discovery;
+    }
+    async refresh(options = {}) {
+        this.discovery = discoverMcpServers(this.options.discovery ?? {});
+        const next = new Map();
+        for (const definition of this.discovery.servers)
+            next.set(definition.name, definition);
+        for (const [name, state] of [...this.connections]) {
+            if (!next.has(name)) {
+                await this.disposeConnection(state);
+                this.connections.delete(name);
+            }
+        }
+        const toConnect = [];
+        for (const definition of this.discovery.servers) {
+            if (definition.disabled) {
+                const existing = this.connections.get(definition.name);
+                if (existing)
+                    await this.disposeConnection(existing);
+                this.connections.set(definition.name, {
+                    definition,
+                    client: undefined,
+                    status: "disabled",
+                    tools: [],
+                    detail: "disabled by configuration",
+                    serverInfo: undefined,
+                    protocolVersion: undefined,
+                });
+                continue;
+            }
+            const existing = this.connections.get(definition.name);
+            const reusable = existing !== undefined &&
+                existing.status === "ready" &&
+                existing.definition.signature === definition.signature &&
+                options.force !== true;
+            if (reusable) {
+                existing.definition = definition;
+                continue;
+            }
+            if (existing)
+                await this.disposeConnection(existing);
+            this.connections.set(definition.name, {
+                definition,
+                client: undefined,
+                status: "connecting",
+                tools: [],
+                detail: undefined,
+                serverInfo: undefined,
+                protocolVersion: undefined,
+            });
+            toConnect.push(definition);
+        }
+        await runBounded(toConnect, this.options.connectConcurrency ?? DEFAULT_CONNECT_CONCURRENCY, (definition) => this.connect(definition));
+        return this.snapshot();
+    }
+    forceRefresh() {
+        return this.refresh({ force: true });
+    }
+    async reconnect(name) {
+        const definition = this.discovery.servers.find((server) => server.name === name) ??
+            this.connections.get(name)?.definition;
+        if (!definition)
+            return this.snapshot();
+        const existing = this.connections.get(name);
+        if (existing)
+            await this.disposeConnection(existing);
+        if (definition.disabled) {
+            this.connections.set(name, {
+                definition,
+                client: undefined,
+                status: "disabled",
+                tools: [],
+                detail: "disabled by configuration",
+                serverInfo: undefined,
+                protocolVersion: undefined,
+            });
+            return this.snapshot();
+        }
+        this.connections.set(name, {
+            definition,
+            client: undefined,
+            status: "connecting",
+            tools: [],
+            detail: undefined,
+            serverInfo: undefined,
+            protocolVersion: undefined,
+        });
+        await this.connect(definition);
+        return this.snapshot();
+    }
+    async connect(definition) {
+        const state = this.connections.get(definition.name);
+        if (!state)
+            return;
+        let client;
+        try {
+            const transport = this.createTransport(definition);
+            client = new McpClient(transport, this.options.clientOptions ?? {});
+            const init = await client.initialize({ timeoutMs: this.connectTimeoutMs });
+            state.client = client;
+            state.serverInfo = init.serverInfo;
+            state.protocolVersion = init.protocolVersion;
+            try {
+                const descriptors = await client.listTools({ timeoutMs: this.connectTimeoutMs });
+                const selected = descriptors
+                    .filter((descriptor) => definition.toolSelection === "all" ||
+                    definition.toolSelection.includes(descriptor.name))
+                    .filter((descriptor, index, list) => list.findIndex((candidate) => candidate.name === descriptor.name) === index)
+                    .sort((a, b) => a.name.localeCompare(b.name));
+                const allocated = allocateWireNames(selected.map((descriptor) => ({
+                    serverName: definition.name,
+                    toolName: descriptor.name,
+                })));
+                state.tools = selected.map((descriptor) => toToolMetadata(definition.name, descriptor, allocated.get(toolIdentity(definition.name, descriptor.name))));
+                state.status = "ready";
+                state.detail = undefined;
+            }
+            catch (error) {
+                state.status = "degraded";
+                state.tools = [];
+                state.detail = describeError(error, definition.secretValues);
+            }
+        }
+        catch (error) {
+            state.status = "error";
+            state.tools = [];
+            state.detail = describeError(error, definition.secretValues);
+            if (client)
+                await client.close().catch(() => undefined);
+            state.client = undefined;
+        }
+    }
+    reconcileToolNames() {
+        const all = [...this.connections.values()].flatMap((state) => state.status === "ready"
+            ? state.tools.map((tool) => ({
+                serverName: tool.serverName,
+                toolName: tool.toolName,
+            }))
+            : []);
+        const allocated = allocateWireNames(all);
+        for (const state of this.connections.values()) {
+            state.tools = state.tools.map((tool) => ({
+                ...tool,
+                canonicalName: canonicalToolName(tool.serverName, tool.toolName),
+                wireName: allocated.get(toolIdentity(tool.serverName, tool.toolName)) ??
+                    tool.wireName,
+            }));
+        }
+    }
+    async disposeConnection(state) {
+        const client = state.client;
+        state.client = undefined;
+        if (client)
+            await client.close().catch(() => undefined);
+    }
+    async closeAll() {
+        const states = [...this.connections.values()];
+        this.connections.clear();
+        await Promise.all(states.map((state) => this.disposeConnection(state)));
+    }
+    snapshot() {
+        this.reconcileToolNames();
+        const statuses = [];
+        const tools = [];
+        const byCanonical = new Map();
+        const byWire = new Map();
+        const ordered = [...this.connections.values()].sort((a, b) => a.definition.name.localeCompare(b.definition.name));
+        for (const state of ordered) {
+            statuses.push(this.toStatus(state));
+            if (state.status === "ready") {
+                for (const tool of state.tools) {
+                    if (byCanonical.has(tool.canonicalName))
+                        continue;
+                    byCanonical.set(tool.canonicalName, tool);
+                    byWire.set(tool.wireName, tool);
+                    tools.push(tool);
+                }
+            }
+        }
+        const snapshot = {
+            createdAt: Date.now(),
+            statuses: Object.freeze(statuses),
+            tools: Object.freeze(tools),
+            toolsByCanonicalName: byCanonical,
+            toolsByWireName: byWire,
+            shadowed: this.discovery.shadowed,
+            invalid: this.discovery.invalid,
+        };
+        return Object.freeze(snapshot);
+    }
+    toStatus(state) {
+        const base = {
+            name: state.definition.name,
+            status: state.status,
+            transport: state.definition.config.transport,
+            source: state.definition.source,
+            toolCount: state.tools.length,
+            signature: state.definition.signature,
+        };
+        return {
+            ...base,
+            ...(state.detail !== undefined ? { detail: state.detail } : {}),
+            ...(state.serverInfo !== undefined ? { serverInfo: state.serverInfo } : {}),
+            ...(state.protocolVersion !== undefined ? { protocolVersion: state.protocolVersion } : {}),
+        };
+    }
+    getTool(name) {
+        this.reconcileToolNames();
+        for (const state of this.connections.values()) {
+            if (state.status !== "ready")
+                continue;
+            const found = state.tools.find((tool) => tool.canonicalName === name || tool.wireName === name);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    listTools() {
+        return this.snapshot().tools.slice();
+    }
+    async callTool(name, args, options = {}) {
+        const tool = this.getTool(name);
+        if (!tool) {
+            throw new McpTransportError("protocol", `Unknown MCP tool "${name}".`);
+        }
+        const state = this.connections.get(tool.serverName);
+        if (!state || !state.client || state.status !== "ready") {
+            throw new McpTransportError("closed", `MCP server "${tool.serverName}" is not ready.`);
+        }
+        return await state.client.callTool(tool.toolName, args, {
+            timeoutMs: this.requestTimeoutMs,
+            ...options,
+        });
+    }
+}
+function describeError(error, secretValues = []) {
+    const text = error instanceof McpTransportError
+        ? `${error.kind}: ${error.message}`
+        : error instanceof Error
+            ? error.message
+            : String(error);
+    return redactSecrets(text, secretValues);
+}
+//# sourceMappingURL=manager.js.map

package/dist/mcp/manager.js.map

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

package/dist/mcp/mentions.d.ts

@@ -0,0 +1,9 @@
+export interface McpMentionRange {
+    readonly start: number;
+    readonly end: number;
+    readonly name: string;
+}
+export declare function formatMcpToken(name: string): string;
+export declare function hasMcpMentionSyntax(text: string): boolean;
+export declare function findMcpMentions(text: string, known: ReadonlySet<string>): McpMentionRange[];
+export declare function mcpMentionNames(text: string, known: ReadonlySet<string>): string[];

package/dist/mcp/mentions.js

@@ -0,0 +1,44 @@
+const TOKEN_RE = /(^|[^\w:/\\.-])@mcp:([A-Za-z0-9][A-Za-z0-9_.-]*)/g;
+const TRAILING_PUNCTUATION = /[._-]+$/;
+export function formatMcpToken(name) {
+    return `@mcp:${name}`;
+}
+export function hasMcpMentionSyntax(text) {
+    return text.includes("@mcp:");
+}
+function resolveName(raw, known) {
+    let candidate = raw;
+    while (candidate.length > 0) {
+        if (known.has(candidate))
+            return candidate;
+        const trimmed = candidate.replace(TRAILING_PUNCTUATION, "");
+        if (trimmed === candidate)
+            return undefined;
+        candidate = trimmed;
+    }
+    return undefined;
+}
+export function findMcpMentions(text, known) {
+    if (!text || known.size === 0 || !hasMcpMentionSyntax(text))
+        return [];
+    const out = [];
+    const pattern = new RegExp(TOKEN_RE.source, TOKEN_RE.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+        const lead = match[1] ?? "";
+        const raw = match[2] ?? "";
+        const name = resolveName(raw, known);
+        if (!name)
+            continue;
+        const start = match.index + lead.length;
+        out.push({ start, end: start + formatMcpToken(name).length, name });
+    }
+    return out;
+}
+export function mcpMentionNames(text, known) {
+    const seen = new Set();
+    for (const mention of findMcpMentions(text, known))
+        seen.add(mention.name);
+    return [...seen];
+}
+//# sourceMappingURL=mentions.js.map

package/dist/mcp/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../../src/mcp/mentions.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AACrE,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAEvC,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,KAA0B;IAC1D,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,SAAS,GAAG,OAAO,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA0B;IAE1B,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACvE,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/mcp/names.d.ts

@@ -0,0 +1,15 @@
+export declare const MCP_CANONICAL_PREFIX: "mcp.";
+export declare const MCP_WIRE_PREFIX: "mcp_";
+export declare const MCP_WIRE_MAX_LENGTH = 64;
+export declare function canonicalToolName(serverName: string, toolName: string): string;
+export declare function isCanonicalToolName(value: string): boolean;
+export declare function toolIdentity(serverName: string, toolName: string): string;
+export interface WireNameInput {
+    readonly serverName: string;
+    readonly toolName: string;
+}
+export declare class WireNameAllocator {
+    private readonly used;
+    assign(input: WireNameInput): string;
+}
+export declare function allocateWireNames(inputs: readonly WireNameInput[]): Map<string, string>;

package/dist/mcp/names.js

@@ -0,0 +1,59 @@
+import { createHash } from "node:crypto";
+export const MCP_CANONICAL_PREFIX = "mcp.";
+export const MCP_WIRE_PREFIX = "mcp_";
+export const MCP_WIRE_MAX_LENGTH = 64;
+const MIN_HASH_LENGTH = 8;
+const NON_WIRE_CHAR = /[^A-Za-z0-9]+/g;
+const IDENTITY_SEPARATOR = "\u0000";
+export function canonicalToolName(serverName, toolName) {
+    return `${MCP_CANONICAL_PREFIX}${serverName}.${toolName}`;
+}
+export function isCanonicalToolName(value) {
+    return value.startsWith(MCP_CANONICAL_PREFIX) && value.length > MCP_CANONICAL_PREFIX.length;
+}
+export function toolIdentity(serverName, toolName) {
+    return `${serverName}${IDENTITY_SEPARATOR}${toolName}`;
+}
+function sanitizeSegment(raw) {
+    const replaced = raw.replace(NON_WIRE_CHAR, "_").replace(/^_+|_+$/g, "");
+    const value = replaced.length > 0 ? replaced : "x";
+    return { value, normalized: value !== raw };
+}
+function hashFor(identity, length) {
+    return createHash("sha256").update(identity).digest("hex").slice(0, length);
+}
+function withHash(base, identity, length) {
+    const suffix = `_${hashFor(identity, length)}`;
+    const room = Math.max(MCP_WIRE_PREFIX.length, MCP_WIRE_MAX_LENGTH - suffix.length);
+    const head = base.length > room ? base.slice(0, room) : base;
+    return `${head}${suffix}`;
+}
+export class WireNameAllocator {
+    used = new Map();
+    assign(input) {
+        const identity = toolIdentity(input.serverName, input.toolName);
+        const server = sanitizeSegment(input.serverName);
+        const tool = sanitizeSegment(input.toolName);
+        const base = `${MCP_WIRE_PREFIX}${server.value}_${tool.value}`;
+        const collides = this.used.has(base) && this.used.get(base) !== identity;
+        const mustHash = server.normalized || tool.normalized || base.length > MCP_WIRE_MAX_LENGTH || collides;
+        let hashLength = MIN_HASH_LENGTH;
+        let candidate = mustHash ? withHash(base, identity, hashLength) : base;
+        while (this.used.has(candidate) && this.used.get(candidate) !== identity) {
+            hashLength += 4;
+            candidate = withHash(base, identity, hashLength);
+        }
+        this.used.set(candidate, identity);
+        return candidate;
+    }
+}
+export function allocateWireNames(inputs) {
+    const sorted = [...inputs].sort((a, b) => toolIdentity(a.serverName, a.toolName).localeCompare(toolIdentity(b.serverName, b.toolName)));
+    const allocator = new WireNameAllocator();
+    const byIdentity = new Map();
+    for (const input of sorted) {
+        byIdentity.set(toolIdentity(input.serverName, input.toolName), allocator.assign(input));
+    }
+    return byIdentity;
+}
+//# sourceMappingURL=names.js.map

package/dist/mcp/names.js.map

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

package/dist/mcp/results.d.ts

@@ -0,0 +1,6 @@
+import type { RiskLevel } from "../types.js";
+import type { McpNormalizedResult, McpToolAnnotations, McpToolDescriptor, McpToolMetadata } from "./types.js";
+export declare function deriveRisk(annotations: McpToolAnnotations): RiskLevel;
+export declare function parseToolDescriptor(value: unknown): McpToolDescriptor | undefined;
+export declare function toToolMetadata(serverName: string, descriptor: McpToolDescriptor, wireName: string): McpToolMetadata;
+export declare function normalizeToolResult(raw: unknown): McpNormalizedResult;

package/dist/mcp/results.js

@@ -0,0 +1,182 @@
+import { canonicalToolName } from "./names.js";
+function coerceSchema(schema) {
+    if (typeof schema === "object" &&
+        schema !== null &&
+        schema.type === "object") {
+        const record = schema;
+        const properties = typeof record.properties === "object" && record.properties !== null
+            ? record.properties
+            : {};
+        const required = Array.isArray(record.required)
+            ? record.required.filter((entry) => typeof entry === "string")
+            : undefined;
+        const additionalProperties = typeof record.additionalProperties === "boolean"
+            ? record.additionalProperties
+            : undefined;
+        return {
+            type: "object",
+            properties,
+            ...(required !== undefined ? { required } : {}),
+            ...(additionalProperties !== undefined ? { additionalProperties } : {}),
+        };
+    }
+    return { type: "object", properties: {} };
+}
+function readAnnotations(value) {
+    if (typeof value !== "object" || value === null)
+        return {};
+    const record = value;
+    const result = {};
+    if (typeof record.title === "string")
+        result.title = record.title;
+    if (typeof record.readOnlyHint === "boolean")
+        result.readOnlyHint = record.readOnlyHint;
+    if (typeof record.destructiveHint === "boolean")
+        result.destructiveHint = record.destructiveHint;
+    if (typeof record.idempotentHint === "boolean")
+        result.idempotentHint = record.idempotentHint;
+    if (typeof record.openWorldHint === "boolean")
+        result.openWorldHint = record.openWorldHint;
+    return result;
+}
+export function deriveRisk(annotations) {
+    if (annotations.readOnlyHint === true)
+        return "safe";
+    return "confirm";
+}
+export function parseToolDescriptor(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const record = value;
+    if (typeof record.name !== "string" || record.name.length === 0)
+        return undefined;
+    const descriptor = { name: record.name };
+    if (typeof record.title === "string")
+        descriptor.title = record.title;
+    if (typeof record.description === "string")
+        descriptor.description = record.description;
+    if (typeof record.inputSchema === "object" && record.inputSchema !== null) {
+        descriptor.inputSchema = record.inputSchema;
+    }
+    if ("annotations" in record)
+        descriptor.annotations = readAnnotations(record.annotations);
+    return descriptor;
+}
+export function toToolMetadata(serverName, descriptor, wireName) {
+    const annotations = descriptor.annotations ?? {};
+    const readOnly = annotations.readOnlyHint === true;
+    const destructive = readOnly ? false : annotations.destructiveHint ?? true;
+    const idempotent = annotations.idempotentHint ?? false;
+    const openWorld = annotations.openWorldHint ?? false;
+    const title = descriptor.title ?? annotations.title;
+    const base = {
+        canonicalName: canonicalToolName(serverName, descriptor.name),
+        wireName,
+        serverName,
+        toolName: descriptor.name,
+        description: descriptor.description ?? "",
+        inputSchema: coerceSchema(descriptor.inputSchema),
+        risk: deriveRisk(annotations),
+        readOnly,
+        destructive,
+        idempotent,
+        openWorld,
+        annotations,
+    };
+    return title !== undefined ? { ...base, title } : base;
+}
+function readContentImages(content) {
+    const images = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type !== "image")
+            continue;
+        const data = record.data;
+        const mimeType = record.mimeType;
+        if (typeof data === "string" && typeof mimeType === "string") {
+            images.push({ mediaType: mimeType, dataBase64: data });
+        }
+    }
+    return images;
+}
+function readContentResources(content) {
+    const resources = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type !== "resource")
+            continue;
+        const resource = record.resource;
+        if (typeof resource !== "object" || resource === null)
+            continue;
+        const res = resource;
+        const uri = typeof res.uri === "string" ? res.uri : "";
+        const normalized = { uri };
+        if (typeof res.mimeType === "string")
+            normalized.mimeType = res.mimeType;
+        if (typeof res.text === "string")
+            normalized.text = res.text;
+        if (typeof res.blob === "string")
+            normalized.blobBase64 = res.blob;
+        resources.push(normalized);
+    }
+    return resources;
+}
+function readContentText(content) {
+    const parts = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type === "text" && typeof record.text === "string") {
+            parts.push(record.text);
+        }
+        else if (record.type === "resource") {
+            const resource = record.resource;
+            if (resource && typeof resource.text === "string") {
+                const uri = typeof resource.uri === "string" ? resource.uri : "resource";
+                parts.push(`[${uri}]\n${resource.text}`);
+            }
+            else if (resource && typeof resource.uri === "string") {
+                parts.push(`[resource ${resource.uri}]`);
+            }
+        }
+        else if (record.type === "image") {
+            const mime = typeof record.mimeType === "string" ? record.mimeType : "image";
+            parts.push(`[image ${mime}]`);
+        }
+        else if (record.type === "audio") {
+            const mime = typeof record.mimeType === "string" ? record.mimeType : "audio";
+            parts.push(`[audio ${mime}]`);
+        }
+    }
+    return parts.join("\n");
+}
+export function normalizeToolResult(raw) {
+    const record = typeof raw === "object" && raw !== null ? raw : {};
+    const isError = record.isError === true;
+    const content = Array.isArray(record.content) ? record.content : [];
+    const images = readContentImages(content);
+    const resources = readContentResources(content);
+    const chatImages = images.map((image) => ({
+        mediaType: image.mediaType,
+        dataBase64: image.dataBase64,
+    }));
+    let text = readContentText(content);
+    if (text.length === 0 && typeof record.structuredContent === "object" && record.structuredContent !== null) {
+        text = JSON.stringify(record.structuredContent);
+    }
+    return {
+        ok: !isError,
+        isError,
+        text,
+        images,
+        resources,
+        chatImages,
+        raw,
+    };
+}
+//# sourceMappingURL=results.js.map