@pentoshi/clai 4.8.4 → 4.10.0

package/dist/mcp/format.d.ts

@@ -0,0 +1,17 @@
+import type { McpDiscoveryResult, McpServerConfig, McpServerDefinition, McpServerStatus, McpSnapshot, McpToolMetadata } from "./types.js";
+export declare function redactSecrets(text: string, secretValues: readonly string[]): string;
+export interface DisplayServerConfig {
+    readonly transport: McpServerConfig["transport"];
+    readonly command?: string | undefined;
+    readonly args?: readonly string[] | undefined;
+    readonly env?: Readonly<Record<string, string>> | undefined;
+    readonly cwd?: string | undefined;
+    readonly url?: string | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
+}
+export declare function redactServerConfig(definition: McpServerDefinition): DisplayServerConfig;
+export declare function formatToolLine(tool: McpToolMetadata): string;
+export declare function formatStatusLine(status: McpServerStatus): string;
+export declare function formatStatuses(statuses: readonly McpServerStatus[]): string;
+export declare function formatCatalog(snapshot: McpSnapshot): string;
+export declare function formatDiscoverySummary(result: McpDiscoveryResult): string;

package/dist/mcp/format.js

@@ -0,0 +1,122 @@
+const SECRET_MASK = "***";
+export function redactSecrets(text, secretValues) {
+    let out = text;
+    for (const secret of secretValues) {
+        if (secret.length === 0)
+            continue;
+        out = out.split(secret).join(SECRET_MASK);
+    }
+    return out;
+}
+export function redactServerConfig(definition) {
+    const config = definition.config;
+    const secrets = definition.secretValues;
+    if (config.transport === "stdio") {
+        const env = {};
+        for (const key of Object.keys(config.env))
+            env[key] = SECRET_MASK;
+        return {
+            transport: "stdio",
+            command: redactSecrets(config.command, secrets),
+            args: config.args.map((arg) => redactSecrets(arg, secrets)),
+            env,
+            ...(config.cwd !== undefined ? { cwd: redactSecrets(config.cwd, secrets) } : {}),
+        };
+    }
+    const headers = {};
+    for (const key of Object.keys(config.headers))
+        headers[key] = SECRET_MASK;
+    return {
+        transport: config.transport,
+        url: redactSecrets(config.url, secrets),
+        headers,
+    };
+}
+function statusSymbol(status) {
+    switch (status) {
+        case "ready":
+            return "ready";
+        case "degraded":
+            return "degraded";
+        case "disabled":
+            return "disabled";
+        case "connecting":
+            return "connecting";
+        default:
+            return "error";
+    }
+}
+function riskLabel(tool) {
+    if (tool.risk === "safe")
+        return "safe";
+    if (tool.destructive)
+        return "confirm/destructive";
+    return "confirm";
+}
+export function formatToolLine(tool) {
+    const summary = tool.description.split("\n")[0]?.trim() ?? "";
+    const trimmed = summary.length > 80 ? `${summary.slice(0, 77)}...` : summary;
+    return `  ${tool.canonicalName} [${riskLabel(tool)}]${trimmed ? ` - ${trimmed}` : ""}`;
+}
+export function formatStatusLine(status) {
+    const info = status.serverInfo ? ` (${status.serverInfo.name} ${status.serverInfo.version})` : "";
+    const detail = status.detail ? ` - ${status.detail}` : "";
+    return `${statusSymbol(status.status)}  ${status.name}${info} [${status.transport} · ${status.source.kind}] tools=${status.toolCount} · ${status.source.path}${detail}`;
+}
+export function formatStatuses(statuses) {
+    if (statuses.length === 0)
+        return "No MCP servers configured.";
+    return statuses.map(formatStatusLine).join("\n");
+}
+export function formatCatalog(snapshot) {
+    const lines = [];
+    for (const status of snapshot.statuses) {
+        lines.push(formatStatusLine(status));
+        const tools = snapshot.tools.filter((tool) => tool.serverName === status.name);
+        for (const tool of tools)
+            lines.push(formatToolLine(tool));
+    }
+    if (snapshot.shadowed.length > 0) {
+        lines.push("");
+        lines.push("Shadowed servers:");
+        for (const entry of snapshot.shadowed) {
+            lines.push(`  ${entry.name} in ${entry.source.path} (shadowed by ${entry.shadowedBy.path})`);
+        }
+    }
+    if (snapshot.invalid.length > 0) {
+        lines.push("");
+        lines.push("Invalid servers:");
+        for (const entry of snapshot.invalid) {
+            lines.push(`  ${entry.name} in ${entry.source.path}: ${entry.errors.join("; ")}`);
+        }
+    }
+    return lines.length > 0 ? lines.join("\n") : "No MCP servers configured.";
+}
+export function formatDiscoverySummary(result) {
+    const lines = [];
+    lines.push(`Sources read: ${result.sources.length}`);
+    for (const source of result.sources) {
+        lines.push(`  [${source.kind}] ${source.path}`);
+    }
+    lines.push(`Servers: ${result.servers.length}`);
+    for (const server of result.servers) {
+        const flag = server.disabled ? " (disabled)" : "";
+        lines.push(`  ${server.name}${flag} [${server.config.transport}] from ${server.source.kind}`);
+    }
+    if (result.shadowed.length > 0) {
+        lines.push(`Shadowed: ${result.shadowed.length}`);
+        for (const entry of result.shadowed) {
+            lines.push(`  ${entry.name} (${entry.source.kind}) < ${entry.shadowedBy.kind}`);
+        }
+    }
+    if (result.invalid.length > 0) {
+        lines.push(`Invalid: ${result.invalid.length}`);
+        for (const entry of result.invalid) {
+            lines.push(`  ${entry.name}: ${entry.errors.join("; ")}`);
+        }
+    }
+    for (const warning of result.warnings)
+        lines.push(`Warning: ${warning}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/mcp/format.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./types.js";
+export { JsonRpcError, LineDecoder, SseDecoder, createNotification, createRequest, encodeLine, encodeMessage, isJsonRpcFailure, isJsonRpcNotification, isJsonRpcRequest, isJsonRpcResponse, isJsonRpcSuccess, parseMessage, resultOrThrow, type SseEvent, } from "./jsonrpc.js";
+export { buildInputMap, substituteVariables, type McpSubstitutionContext, type McpSubstitutionResult, } from "./substitution.js";
+export { validateServerEntry, type ServerValidation, type ValidatedServer, } from "./validation.js";
+export { computeConfigSignature, discoverMcpServers, parseJsonc, } from "./discovery.js";
+export { deriveRisk, normalizeToolResult, parseToolDescriptor, toToolMetadata, } from "./results.js";
+export { displayMcpConfigPath, parseMcpServerSnippet, projectMcpConfigPath, writeProjectMcpServer, type McpConfigWriteResult, type McpServerSnippet, type McpSnippetParseResult, } from "./config-file.js";
+export { MCP_CANONICAL_PREFIX, MCP_WIRE_MAX_LENGTH, MCP_WIRE_PREFIX, WireNameAllocator, allocateWireNames, canonicalToolName, isCanonicalToolName, toolIdentity, } from "./names.js";
+export { McpTransportError, isAbortError, withTimeout, type McpTransport, type McpTransportFailureKind, } from "./transport.js";
+export { StdioTransport, type StdioTransportOptions } from "./transport-stdio.js";
+export { LegacySseTransport, StreamableHttpTransport, type HttpTransportOptions, } from "./transport-http.js";
+export { McpClient, type McpClientOptions } from "./client.js";
+export { McpManager, type McpManagerOptions, type McpTransportFactory, } from "./manager.js";
+export { formatCatalog, formatDiscoverySummary, formatStatuses, formatStatusLine, formatToolLine, redactSecrets, redactServerConfig, type DisplayServerConfig, } from "./format.js";
+export { McpRuntime, type McpRuntimeOptions, type McpRuntimeSelection, type McpRuntimeState, } from "./runtime.js";

package/dist/mcp/index.js

@@ -0,0 +1,16 @@
+export * from "./types.js";
+export { JsonRpcError, LineDecoder, SseDecoder, createNotification, createRequest, encodeLine, encodeMessage, isJsonRpcFailure, isJsonRpcNotification, isJsonRpcRequest, isJsonRpcResponse, isJsonRpcSuccess, parseMessage, resultOrThrow, } from "./jsonrpc.js";
+export { buildInputMap, substituteVariables, } from "./substitution.js";
+export { validateServerEntry, } from "./validation.js";
+export { computeConfigSignature, discoverMcpServers, parseJsonc, } from "./discovery.js";
+export { deriveRisk, normalizeToolResult, parseToolDescriptor, toToolMetadata, } from "./results.js";
+export { displayMcpConfigPath, parseMcpServerSnippet, projectMcpConfigPath, writeProjectMcpServer, } from "./config-file.js";
+export { MCP_CANONICAL_PREFIX, MCP_WIRE_MAX_LENGTH, MCP_WIRE_PREFIX, WireNameAllocator, allocateWireNames, canonicalToolName, isCanonicalToolName, toolIdentity, } from "./names.js";
+export { McpTransportError, isAbortError, withTimeout, } from "./transport.js";
+export { StdioTransport } from "./transport-stdio.js";
+export { LegacySseTransport, StreamableHttpTransport, } from "./transport-http.js";
+export { McpClient } from "./client.js";
+export { McpManager, } from "./manager.js";
+export { formatCatalog, formatDiscoverySummary, formatStatuses, formatStatusLine, formatToolLine, redactSecrets, redactServerConfig, } from "./format.js";
+export { McpRuntime, } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GAEd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAyB,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,UAAU,GAGX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GAIX,MAAM,cAAc,CAAC"}

package/dist/mcp/jsonrpc.d.ts

@@ -0,0 +1,40 @@
+import type { JsonRpcErrorPayload, JsonRpcFailure, JsonRpcId, JsonRpcMessage, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess } from "./types.js";
+export declare const MCP_MAX_FRAME_BYTES: number;
+export declare class JsonRpcError extends Error {
+    readonly code: number;
+    readonly data: unknown;
+    constructor(payload: JsonRpcErrorPayload);
+}
+export declare function createRequest(id: JsonRpcId, method: string, params?: unknown): JsonRpcRequest;
+export declare function createNotification(method: string, params?: unknown): JsonRpcNotification;
+export declare function encodeMessage(message: JsonRpcMessage): string;
+export declare function encodeLine(message: JsonRpcMessage): string;
+export declare function isJsonRpcResponse(value: unknown): value is JsonRpcResponse;
+export declare function isJsonRpcSuccess(value: JsonRpcResponse): value is JsonRpcSuccess;
+export declare function isJsonRpcFailure(value: JsonRpcResponse): value is JsonRpcFailure;
+export declare function isJsonRpcRequest(value: unknown): value is JsonRpcRequest;
+export declare function isJsonRpcNotification(value: unknown): value is JsonRpcNotification;
+export declare function parseMessage(line: string): JsonRpcMessage | undefined;
+export declare function resultOrThrow(response: JsonRpcResponse): unknown;
+export declare class LineDecoder {
+    private buffer;
+    private readonly decoder;
+    private readonly maxBytes;
+    constructor(maxBytes?: number);
+    push(chunk: Uint8Array | string): string[];
+    flush(): string[];
+}
+export interface SseEvent {
+    readonly event: string;
+    readonly data: string;
+    readonly id?: string | undefined;
+}
+export declare class SseDecoder {
+    private buffer;
+    private readonly decoder;
+    private readonly maxBytes;
+    constructor(maxBytes?: number);
+    push(chunk: Uint8Array | string): SseEvent[];
+    private nextBoundary;
+    private parseBlock;
+}

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