@pentoshi/clai 4.8.4 → 4.9.0

package/dist/mcp/jsonrpc.js

@@ -0,0 +1,175 @@
+import { McpTransportError } from "./transport.js";
+export const MCP_MAX_FRAME_BYTES = 16 * 1024 * 1024;
+export class JsonRpcError extends Error {
+    code;
+    data;
+    constructor(payload) {
+        super(payload.message);
+        this.name = "JsonRpcError";
+        this.code = payload.code;
+        this.data = payload.data;
+    }
+}
+export function createRequest(id, method, params) {
+    return params === undefined
+        ? { jsonrpc: "2.0", id, method }
+        : { jsonrpc: "2.0", id, method, params };
+}
+export function createNotification(method, params) {
+    return params === undefined
+        ? { jsonrpc: "2.0", method }
+        : { jsonrpc: "2.0", method, params };
+}
+export function encodeMessage(message) {
+    return JSON.stringify(message);
+}
+export function encodeLine(message) {
+    return `${JSON.stringify(message)}\n`;
+}
+export function isJsonRpcResponse(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    if (record.jsonrpc !== "2.0")
+        return false;
+    if (!("id" in record))
+        return false;
+    return "result" in record || "error" in record;
+}
+export function isJsonRpcSuccess(value) {
+    return "result" in value;
+}
+export function isJsonRpcFailure(value) {
+    return "error" in value;
+}
+export function isJsonRpcRequest(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return record.jsonrpc === "2.0" && typeof record.method === "string" && "id" in record;
+}
+export function isJsonRpcNotification(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return (record.jsonrpc === "2.0" &&
+        typeof record.method === "string" &&
+        !("id" in record));
+}
+export function parseMessage(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (isJsonRpcResponse(parsed) ||
+        isJsonRpcRequest(parsed) ||
+        isJsonRpcNotification(parsed)) {
+        return parsed;
+    }
+    return undefined;
+}
+export function resultOrThrow(response) {
+    if (isJsonRpcFailure(response))
+        throw new JsonRpcError(response.error);
+    return response.result;
+}
+export class LineDecoder {
+    buffer = "";
+    decoder = new TextDecoder();
+    maxBytes;
+    constructor(maxBytes = MCP_MAX_FRAME_BYTES) {
+        this.maxBytes = maxBytes > 0 ? maxBytes : MCP_MAX_FRAME_BYTES;
+    }
+    push(chunk) {
+        this.buffer +=
+            typeof chunk === "string" ? chunk : this.decoder.decode(chunk, { stream: true });
+        const lines = [];
+        let index = this.buffer.indexOf("\n");
+        while (index !== -1) {
+            const line = this.buffer.slice(0, index).replace(/\r$/, "");
+            this.buffer = this.buffer.slice(index + 1);
+            if (line.length > 0)
+                lines.push(line);
+            index = this.buffer.indexOf("\n");
+        }
+        if (this.buffer.length > this.maxBytes) {
+            this.buffer = "";
+            throw new McpTransportError("too-large", `MCP message exceeded the ${this.maxBytes}-byte line framing limit before a newline arrived.`);
+        }
+        return lines;
+    }
+    flush() {
+        const remaining = this.buffer.replace(/\r$/, "");
+        this.buffer = "";
+        return remaining.length > 0 ? [remaining] : [];
+    }
+}
+export class SseDecoder {
+    buffer = "";
+    decoder = new TextDecoder();
+    maxBytes;
+    constructor(maxBytes = MCP_MAX_FRAME_BYTES) {
+        this.maxBytes = maxBytes > 0 ? maxBytes : MCP_MAX_FRAME_BYTES;
+    }
+    push(chunk) {
+        this.buffer +=
+            typeof chunk === "string" ? chunk : this.decoder.decode(chunk, { stream: true });
+        const events = [];
+        let boundary = this.nextBoundary();
+        while (boundary) {
+            const block = this.buffer.slice(0, boundary.index);
+            this.buffer = this.buffer.slice(boundary.index + boundary.length);
+            const parsed = this.parseBlock(block);
+            if (parsed)
+                events.push(parsed);
+            boundary = this.nextBoundary();
+        }
+        if (this.buffer.length > this.maxBytes) {
+            this.buffer = "";
+            throw new McpTransportError("too-large", `MCP SSE event exceeded the ${this.maxBytes}-byte framing limit before a boundary arrived.`);
+        }
+        return events;
+    }
+    nextBoundary() {
+        const lf = this.buffer.indexOf("\n\n");
+        const crlf = this.buffer.indexOf("\r\n\r\n");
+        if (lf === -1 && crlf === -1)
+            return undefined;
+        if (crlf !== -1 && (lf === -1 || crlf < lf)) {
+            return { index: crlf, length: 4 };
+        }
+        return { index: lf, length: 2 };
+    }
+    parseBlock(block) {
+        let event = "message";
+        const dataLines = [];
+        let id;
+        for (const rawLine of block.split(/\r?\n/)) {
+            if (rawLine.length === 0 || rawLine.startsWith(":"))
+                continue;
+            const colon = rawLine.indexOf(":");
+            const field = colon === -1 ? rawLine : rawLine.slice(0, colon);
+            let value = colon === -1 ? "" : rawLine.slice(colon + 1);
+            if (value.startsWith(" "))
+                value = value.slice(1);
+            if (field === "event")
+                event = value;
+            else if (field === "data")
+                dataLines.push(value);
+            else if (field === "id")
+                id = value;
+        }
+        if (dataLines.length === 0)
+            return undefined;
+        return id === undefined
+            ? { event, data: dataLines.join("\n") }
+            : { event, data: dataLines.join("\n"), id };
+    }
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/mcp/jsonrpc.js.map

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

package/dist/mcp/manager.d.ts

@@ -0,0 +1,36 @@
+import { type McpClientOptions } from "./client.js";
+import { type McpTransport } from "./transport.js";
+import type { McpDiscoveryOptions, McpDiscoveryResult, McpNormalizedResult, McpRequestOptions, McpServerDefinition, McpSnapshot, McpToolMetadata } from "./types.js";
+export type McpTransportFactory = (definition: McpServerDefinition) => McpTransport;
+export interface McpManagerOptions {
+    readonly discovery?: McpDiscoveryOptions | undefined;
+    readonly connectConcurrency?: number | undefined;
+    readonly connectTimeoutMs?: number | undefined;
+    readonly requestTimeoutMs?: number | undefined;
+    readonly transportFactory?: McpTransportFactory | undefined;
+    readonly clientOptions?: McpClientOptions | undefined;
+}
+export declare class McpManager {
+    private readonly options;
+    private readonly connections;
+    private discovery;
+    constructor(options?: McpManagerOptions);
+    private get connectTimeoutMs();
+    private get requestTimeoutMs();
+    private createTransport;
+    getDiscovery(): McpDiscoveryResult;
+    refresh(options?: {
+        force?: boolean;
+    }): Promise<McpSnapshot>;
+    forceRefresh(): Promise<McpSnapshot>;
+    reconnect(name: string): Promise<McpSnapshot>;
+    private connect;
+    private reconcileToolNames;
+    private disposeConnection;
+    closeAll(): Promise<void>;
+    snapshot(): McpSnapshot;
+    private toStatus;
+    getTool(name: string): McpToolMetadata | undefined;
+    listTools(): McpToolMetadata[];
+    callTool(name: string, args: Record<string, unknown>, options?: McpRequestOptions): Promise<McpNormalizedResult>;
+}

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>;