@pentoshi/clai 4.8.3 → 4.9.0

package/dist/mcp/discovery.js

@@ -0,0 +1,409 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, dirname, isAbsolute, join, resolve } from "node:path";
+import { safeCwd } from "../os/cwd.js";
+import { buildInputMap } from "./substitution.js";
+import { validateServerEntry } from "./validation.js";
+import { MCP_SOURCE_PRECEDENCE, } from "./types.js";
+function stripComments(text) {
+    let out = "";
+    let inString = false;
+    let inLine = false;
+    let inBlock = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        const next = text[i + 1];
+        if (inLine) {
+            if (ch === "\n") {
+                inLine = false;
+                out += ch;
+            }
+            continue;
+        }
+        if (inBlock) {
+            if (ch === "*" && next === "/") {
+                inBlock = false;
+                i++;
+            }
+            continue;
+        }
+        if (inString) {
+            out += ch;
+            if (ch === "\\") {
+                if (next !== undefined) {
+                    out += next;
+                    i++;
+                }
+                continue;
+            }
+            if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            out += ch;
+            continue;
+        }
+        if (ch === "/" && next === "/") {
+            inLine = true;
+            i++;
+            continue;
+        }
+        if (ch === "/" && next === "*") {
+            inBlock = true;
+            i++;
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+function removeTrailingCommas(text) {
+    let out = "";
+    let inString = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            out += ch;
+            if (ch === "\\") {
+                out += text[i + 1] ?? "";
+                i++;
+                continue;
+            }
+            if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            out += ch;
+            continue;
+        }
+        if (ch === ",") {
+            let j = i + 1;
+            while (j < text.length && /\s/.test(text[j]))
+                j++;
+            if (text[j] === "}" || text[j] === "]")
+                continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+export function parseJsonc(text) {
+    return JSON.parse(removeTrailingCommas(stripComments(text)));
+}
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            out[key] = canonicalize(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+export function computeConfigSignature(config, toolSelection = "all") {
+    const selection = toolSelection === "all" ? "all" : [...toolSelection].sort();
+    return createHash("sha256")
+        .update(JSON.stringify(canonicalize({ config, tools: selection })))
+        .digest("hex")
+        .slice(0, 16);
+}
+function rankFor(kind) {
+    const index = MCP_SOURCE_PRECEDENCE.indexOf(kind);
+    return index === -1 ? MCP_SOURCE_PRECEDENCE.length : index;
+}
+function findRepoRoot(start) {
+    let current = resolve(start);
+    for (;;) {
+        if (existsSync(join(current, ".git")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+function projectDirs(start, repoRoot) {
+    const dirs = [];
+    let current = resolve(start);
+    for (;;) {
+        dirs.push(current);
+        if (repoRoot !== undefined && current === repoRoot)
+            break;
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        if (repoRoot === undefined)
+            break;
+        current = parent;
+    }
+    return dirs;
+}
+function vscodeUserDir(home, platform, env) {
+    if (platform === "win32") {
+        const appData = env.APPDATA;
+        const base = appData && appData.length > 0 ? appData : join(home, "AppData", "Roaming");
+        return join(base, "Code", "User");
+    }
+    if (platform === "darwin") {
+        return join(home, "Library", "Application Support", "Code", "User");
+    }
+    const xdg = env.XDG_CONFIG_HOME;
+    const base = xdg && xdg.length > 0 ? xdg : join(home, ".config");
+    return join(base, "Code", "User");
+}
+function buildSources(options) {
+    const { workspaceFolder, homeDir, platform, env } = options;
+    const sources = [];
+    const envList = env.CLAI_MCP_CONFIG;
+    if (envList && envList.trim().length > 0) {
+        for (const part of envList.split(delimiter)) {
+            const trimmed = part.trim();
+            if (trimmed.length === 0)
+                continue;
+            const path = isAbsolute(trimmed) ? trimmed : resolve(workspaceFolder, trimmed);
+            sources.push({ kind: "clai-env", path, rank: rankFor("clai-env") });
+        }
+    }
+    const repoRoot = findRepoRoot(workspaceFolder);
+    projectDirs(workspaceFolder, repoRoot).forEach((dir, depth) => {
+        sources.push({
+            kind: "clai-project",
+            path: join(dir, ".clai", "mcp.json"),
+            rank: rankFor("clai-project"),
+            depth,
+        });
+        sources.push({
+            kind: "mcp-project",
+            path: join(dir, ".mcp.json"),
+            rank: rankFor("mcp-project"),
+            depth,
+        });
+        if (repoRoot !== undefined && dir === repoRoot) {
+            sources.push({
+                kind: "github-project",
+                path: join(dir, ".github", "mcp.json"),
+                rank: rankFor("github-project"),
+                depth,
+            });
+        }
+        sources.push({
+            kind: "vscode-project",
+            path: join(dir, ".vscode", "mcp.json"),
+            rank: rankFor("vscode-project"),
+            depth,
+        });
+    });
+    const platformConfigDir = platform === "win32"
+        ? env.APPDATA && env.APPDATA.length > 0
+            ? env.APPDATA
+            : join(homeDir, "AppData", "Roaming")
+        : platform === "darwin"
+            ? join(homeDir, "Library", "Application Support")
+            : env.XDG_CONFIG_HOME && env.XDG_CONFIG_HOME.length > 0
+                ? env.XDG_CONFIG_HOME
+                : join(homeDir, ".config");
+    for (const path of [
+        join(homeDir, ".clai", "mcp.json"),
+        join(platformConfigDir, "clai", "mcp.json"),
+    ]) {
+        sources.push({ kind: "clai-user", path, rank: rankFor("clai-user") });
+    }
+    sources.push({
+        kind: "copilot-user",
+        path: join(homeDir, ".copilot", "mcp-config.json"),
+        rank: rankFor("copilot-user"),
+    });
+    sources.push({
+        kind: "claude-user",
+        path: join(homeDir, ".claude.json"),
+        rank: rankFor("claude-user"),
+    });
+    sources.push({
+        kind: "claude-user",
+        path: join(homeDir, ".claude", "settings.json"),
+        rank: rankFor("claude-user"),
+    });
+    const userDir = vscodeUserDir(homeDir, platform, env);
+    sources.push({
+        kind: "vscode-user",
+        path: join(userDir, "mcp.json"),
+        rank: rankFor("vscode-user"),
+    });
+    sources.push({
+        kind: "vscode-user",
+        path: join(userDir, "settings.json"),
+        rank: rankFor("vscode-user"),
+    });
+    return sources.sort((a, b) => {
+        const rankDelta = a.rank - b.rank;
+        if (rankDelta !== 0)
+            return rankDelta;
+        return (a.depth ?? 0) - (b.depth ?? 0);
+    });
+}
+function asObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+const RESERVED_MAP_KEYS = new Set([
+    "mcpServers",
+    "servers",
+    "mcp",
+    "inputs",
+    "projects",
+    "version",
+    "schemaVersion",
+    "mcpVersion",
+    "$schema",
+    "schema",
+]);
+function looksLikeServer(value) {
+    const record = asObject(value);
+    if (!record)
+        return false;
+    return (typeof record.command === "string" ||
+        typeof record.url === "string" ||
+        typeof record.type === "string");
+}
+function supportsBareMap(kind) {
+    return (kind === "clai-env" ||
+        kind === "clai-project" ||
+        kind === "mcp-project" ||
+        kind === "github-project" ||
+        kind === "clai-user" ||
+        kind === "copilot-user");
+}
+function readInputs(root) {
+    const nested = asObject(root.mcp);
+    const rawInputs = Array.isArray(root.inputs)
+        ? root.inputs
+        : nested && Array.isArray(nested.inputs)
+            ? nested.inputs
+            : [];
+    const inputs = [];
+    for (const raw of rawInputs) {
+        const record = asObject(raw);
+        if (!record || typeof record.id !== "string")
+            continue;
+        const input = { id: record.id };
+        if (typeof record.type === "string")
+            input.type = record.type;
+        if (typeof record.description === "string")
+            input.description = record.description;
+        if (typeof record.default === "string")
+            input.default = record.default;
+        if (typeof record.password === "boolean")
+            input.password = record.password;
+        inputs.push(input);
+    }
+    return inputs;
+}
+function extractBlocks(json, kind, workspaceFolder) {
+    const root = asObject(json) ?? {};
+    const inputs = readInputs(root);
+    const servers = {};
+    const claim = (map) => {
+        if (!map)
+            return;
+        for (const [name, entry] of Object.entries(map)) {
+            if (!(name in servers))
+                servers[name] = entry;
+        }
+    };
+    if (kind === "claude-user") {
+        const projects = asObject(root.projects);
+        if (projects) {
+            const project = asObject(projects[workspaceFolder]);
+            if (project)
+                claim(asObject(project.mcpServers));
+        }
+        claim(asObject(root.mcpServers));
+        const nested = asObject(root.mcp);
+        if (nested)
+            claim(asObject(nested.mcpServers));
+        return { servers, inputs };
+    }
+    claim(asObject(root.mcpServers));
+    claim(asObject(root.servers));
+    const nested = asObject(root.mcp);
+    if (nested) {
+        claim(asObject(nested.servers));
+        claim(asObject(nested.mcpServers));
+    }
+    if (Object.keys(servers).length === 0 && supportsBareMap(kind)) {
+        for (const [name, value] of Object.entries(root)) {
+            if (RESERVED_MAP_KEYS.has(name))
+                continue;
+            if (looksLikeServer(value))
+                servers[name] = value;
+        }
+    }
+    return { servers, inputs };
+}
+export function discoverMcpServers(options = {}) {
+    const workspaceFolder = resolve(options.workspaceFolder ?? safeCwd());
+    const env = options.env ?? process.env;
+    const homeDir = options.homeDir ?? env.CLAI_MCP_HOME ?? homedir();
+    const platform = options.platform ?? process.platform;
+    const servers = [];
+    const shadowed = [];
+    const invalid = [];
+    const readSources = [];
+    const warnings = [];
+    const claimedBy = new Map();
+    const seenPaths = new Set();
+    for (const source of buildSources({ workspaceFolder, homeDir, platform, env })) {
+        if (seenPaths.has(source.path))
+            continue;
+        if (!existsSync(source.path))
+            continue;
+        seenPaths.add(source.path);
+        readSources.push(source);
+        let json;
+        try {
+            json = parseJsonc(readFileSync(source.path, "utf8"));
+        }
+        catch (error) {
+            warnings.push(`Failed to parse ${source.path}: ${error.message}`);
+            continue;
+        }
+        const { servers: rawServers, inputs } = extractBlocks(json, source.kind, workspaceFolder);
+        const context = {
+            env,
+            inputs: buildInputMap(inputs),
+            workspaceFolder,
+        };
+        for (const [name, rawEntry] of Object.entries(rawServers)) {
+            const winner = claimedBy.get(name);
+            if (winner) {
+                shadowed.push({ name, source, shadowedBy: winner });
+                continue;
+            }
+            const validation = validateServerEntry(name, rawEntry, context);
+            if (!validation.ok) {
+                invalid.push({ name, source, errors: validation.errors });
+                continue;
+            }
+            claimedBy.set(name, source);
+            servers.push({
+                name,
+                config: validation.server.config,
+                disabled: validation.server.disabled,
+                toolSelection: validation.server.toolSelection,
+                source,
+                signature: computeConfigSignature(validation.server.config, validation.server.toolSelection),
+                secretValues: validation.server.secretValues,
+            });
+        }
+    }
+    return { servers, shadowed, invalid, sources: readSources, warnings };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/mcp/discovery.js.map

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

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