@akon-labs/nexus-cli 0.1.9 → 0.1.10

package/dist/extensions/mcp/tool-registrar.js

@@ -0,0 +1,229 @@
+// tool-registrar.ts - MCP content transformation
+// NOTE: Tools are NOT registered with Nexus - only the unified `mcp` proxy tool is registered.
+// This keeps the LLM context small (1 tool instead of 100s).
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const MAX_BINARY_RESOURCE_BYTES = 10 * 1024 * 1024;
+const MAX_SESSION_RESOURCE_BYTES = 100 * 1024 * 1024;
+const MAX_SESSION_RESOURCE_FILES = 10_000; // Bounds metadata from empty or tiny resources.
+const CLEANUP_RETRY_DELAY_MS = 30_000;
+const MAX_CLEANUP_RETRY_ATTEMPTS = 3;
+function createMaterializedResourceSession() {
+    return {
+        directory: undefined,
+        bytes: 0,
+        files: 0,
+        sequence: 0,
+    };
+}
+const defaultMaterializedResourceSession = createMaterializedResourceSession();
+const scopedMaterializedResourceSessions = new WeakMap();
+const pendingCleanupDirectories = new Set();
+const cleanupRetryAttempts = new Map();
+let pendingCleanupRetry;
+function isAbortedScope(scope) {
+    return !!scope && "aborted" in scope && scope.aborted === true;
+}
+function getMaterializedResourceSession(scope) {
+    if (isAbortedScope(scope))
+        return undefined;
+    if (!scope)
+        return defaultMaterializedResourceSession;
+    let session = scopedMaterializedResourceSessions.get(scope);
+    if (!session) {
+        session = createMaterializedResourceSession();
+        scopedMaterializedResourceSessions.set(scope, session);
+    }
+    return session;
+}
+function hasRetryableCleanupDirectory() {
+    for (const directory of pendingCleanupDirectories) {
+        if ((cleanupRetryAttempts.get(directory) ?? 0) < MAX_CLEANUP_RETRY_ATTEMPTS)
+            return true;
+    }
+    return false;
+}
+function schedulePendingCleanupRetry() {
+    if (pendingCleanupRetry || !hasRetryableCleanupDirectory())
+        return;
+    for (const directory of pendingCleanupDirectories) {
+        const attempts = cleanupRetryAttempts.get(directory) ?? 0;
+        if (attempts < MAX_CLEANUP_RETRY_ATTEMPTS)
+            cleanupRetryAttempts.set(directory, attempts + 1);
+    }
+    pendingCleanupRetry = setTimeout(() => {
+        pendingCleanupRetry = undefined;
+        try {
+            drainPendingCleanupDirectories();
+        }
+        catch {
+            // drainPendingCleanupDirectories already retained the paths and rescheduled another retry.
+        }
+    }, CLEANUP_RETRY_DELAY_MS);
+}
+function drainPendingCleanupDirectories() {
+    const failures = [];
+    for (const directory of Array.from(pendingCleanupDirectories)) {
+        try {
+            rmSync(directory, { recursive: true, force: true });
+            pendingCleanupDirectories.delete(directory);
+            cleanupRetryAttempts.delete(directory);
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    if (pendingCleanupDirectories.size === 0 && pendingCleanupRetry) {
+        clearTimeout(pendingCleanupRetry);
+        pendingCleanupRetry = undefined;
+    }
+    if (failures.length > 0) {
+        schedulePendingCleanupRetry();
+        throw new AggregateError(failures, "Failed to clean materialized MCP resources");
+    }
+}
+export function cleanupMaterializedBinaryResources(scope) {
+    const session = scope ? scopedMaterializedResourceSessions.get(scope) : defaultMaterializedResourceSession;
+    if (session?.directory)
+        pendingCleanupDirectories.add(session.directory);
+    if (session) {
+        session.directory = undefined;
+        session.bytes = 0;
+        session.files = 0;
+        session.sequence = 0;
+        if (scope)
+            scopedMaterializedResourceSessions.delete(scope);
+    }
+    drainPendingCleanupDirectories();
+}
+function replaceBlob(resource, text) {
+    delete resource.blob;
+    resource.text = text;
+    return text;
+}
+function omitBinaryResource(resource, reason) {
+    return replaceBlob(resource, [
+        `[Resource: ${resource.uri ?? "(no URI)"}]`,
+        `Binary content omitted: ${reason}`,
+        `MIME type: ${resource.mimeType ?? "application/octet-stream"}`,
+    ].join("\n"));
+}
+function materializeBinaryResource(resource, scope) {
+    const session = getMaterializedResourceSession(scope);
+    if (!session)
+        return omitBinaryResource(resource, "runtime stopped");
+    const decodedBytes = Buffer.byteLength(resource.blob, "base64");
+    if (decodedBytes > MAX_BINARY_RESOURCE_BYTES) {
+        return omitBinaryResource(resource, "decoded size exceeds 10 MiB");
+    }
+    if (session.bytes + decodedBytes > MAX_SESSION_RESOURCE_BYTES || session.files >= MAX_SESSION_RESOURCE_FILES) {
+        return omitBinaryResource(resource, "session resource limit reached");
+    }
+    try {
+        session.directory ??= mkdtempSync(join(tmpdir(), "nexus-mcp-resource-"));
+    }
+    catch {
+        return omitBinaryResource(resource, "could not be saved");
+    }
+    const filePath = join(session.directory, `resource-${++session.sequence}.bin`);
+    session.bytes += decodedBytes;
+    session.files += 1;
+    try {
+        writeFileSync(filePath, Buffer.from(resource.blob, "base64"), { flag: "wx", mode: 0o600 });
+    }
+    catch {
+        try {
+            rmSync(filePath, { force: true });
+            session.bytes -= decodedBytes;
+            session.files -= 1;
+        }
+        catch {
+            // Keep the reservation when a partial file cannot be removed.
+        }
+        return omitBinaryResource(resource, "could not be saved");
+    }
+    return replaceBlob(resource, [
+        `[Resource: ${resource.uri ?? "(no URI)"}]`,
+        `Binary content saved to ${filePath}`,
+        `MIME type: ${resource.mimeType ?? "application/octet-stream"}`,
+    ].join("\n"));
+}
+/**
+ * Transform MCP content types to Nexus content blocks.
+ */
+export function transformMcpResourceContents(contents, scope) {
+    return contents.map((resource) => {
+        if (typeof resource.text === "string")
+            return { type: "text", text: resource.text };
+        if (typeof resource.blob === "string")
+            return { type: "text", text: materializeBinaryResource(resource, scope) };
+        return { type: "text", text: JSON.stringify(resource) };
+    });
+}
+export function transformMcpContent(content, scope) {
+    return content.map((c) => {
+        if (c.type === "text") {
+            return { type: "text", text: c.text ?? "" };
+        }
+        if (c.type === "image") {
+            return {
+                type: "image",
+                data: c.data ?? "",
+                mimeType: c.mimeType ?? "image/png",
+            };
+        }
+        if (c.type === "resource") {
+            const resourceUri = c.resource?.uri ?? "(no URI)";
+            if (c.resource && "blob" in c.resource && typeof c.resource.blob === "string") {
+                const binaryResource = c.resource;
+                return {
+                    type: "text",
+                    text: materializeBinaryResource(binaryResource, scope),
+                };
+            }
+            const resourceContent = c.resource?.text ?? (c.resource ? JSON.stringify(c.resource) : "(no content)");
+            return {
+                type: "text",
+                text: `[Resource: ${resourceUri}]\n${resourceContent}`,
+            };
+        }
+        if (c.type === "resource_link") {
+            const linkName = c.name ?? c.uri ?? "unknown";
+            const linkUri = c.uri ?? "(no URI)";
+            return {
+                type: "text",
+                text: `[Resource Link: ${linkName}]\nURI: ${linkUri}`,
+            };
+        }
+        if (c.type === "audio") {
+            return {
+                type: "text",
+                text: `[Audio content: ${c.mimeType ?? "audio/*"}]`,
+            };
+        }
+        return { type: "text", text: JSON.stringify(c) };
+    });
+}
+/**
+ * Resolve a tool result's content blocks, falling back to structuredContent
+ * when content is empty.
+ */
+export function resolveMcpResultContent(result, scope) {
+    const blocks = transformMcpContent((Array.isArray(result.content) ? result.content : []), scope);
+    if (blocks.length > 0)
+        return blocks;
+    if (result.structuredContent !== undefined && result.structuredContent !== null) {
+        return [{ type: "text", text: stringifyStructuredContent(result.structuredContent) }];
+    }
+    return [];
+}
+function stringifyStructuredContent(value) {
+    try {
+        return JSON.stringify(value, null, 2) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=tool-registrar.js.map

package/dist/extensions/mcp/tool-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registrar.js","sourceRoot":"","sources":["../../../src/extensions/mcp/tool-registrar.ts"],"names":[],"mappings":"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","sourcesContent":["// tool-registrar.ts - MCP content transformation\n// NOTE: Tools are NOT registered with Nexus - only the unified `mcp` proxy tool is registered.\n// This keeps the LLM context small (1 tool instead of 100s).\n\nimport { mkdtempSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { ContentBlock, McpContent } from \"./types.ts\";\n\nconst MAX_BINARY_RESOURCE_BYTES = 10 * 1024 * 1024;\nconst MAX_SESSION_RESOURCE_BYTES = 100 * 1024 * 1024;\nconst MAX_SESSION_RESOURCE_FILES = 10_000; // Bounds metadata from empty or tiny resources.\nconst CLEANUP_RETRY_DELAY_MS = 30_000;\nconst MAX_CLEANUP_RETRY_ATTEMPTS = 3;\ntype MaterializedResourceSession = {\n\tdirectory: string | undefined;\n\tbytes: number;\n\tfiles: number;\n\tsequence: number;\n};\n\nfunction createMaterializedResourceSession(): MaterializedResourceSession {\n\treturn {\n\t\tdirectory: undefined,\n\t\tbytes: 0,\n\t\tfiles: 0,\n\t\tsequence: 0,\n\t};\n}\n\nconst defaultMaterializedResourceSession = createMaterializedResourceSession();\nconst scopedMaterializedResourceSessions = new WeakMap<object, MaterializedResourceSession>();\nconst pendingCleanupDirectories = new Set<string>();\nconst cleanupRetryAttempts = new Map<string, number>();\nlet pendingCleanupRetry: ReturnType<typeof setTimeout> | undefined;\n\nfunction isAbortedScope(scope: object | undefined): boolean {\n\treturn !!scope && \"aborted\" in scope && (scope as { aborted?: unknown }).aborted === true;\n}\n\nfunction getMaterializedResourceSession(scope?: object): MaterializedResourceSession | undefined {\n\tif (isAbortedScope(scope)) return undefined;\n\tif (!scope) return defaultMaterializedResourceSession;\n\tlet session = scopedMaterializedResourceSessions.get(scope);\n\tif (!session) {\n\t\tsession = createMaterializedResourceSession();\n\t\tscopedMaterializedResourceSessions.set(scope, session);\n\t}\n\treturn session;\n}\n\ntype BinaryResource = {\n\turi?: string | undefined;\n\ttext?: string | undefined;\n\tmimeType?: string | undefined;\n\tblob: string;\n};\ntype McpResourceContent = {\n\turi: string;\n\ttext?: string | undefined;\n\tblob?: string | undefined;\n\tmimeType?: string | undefined;\n\t[key: string]: unknown;\n};\n\nfunction hasRetryableCleanupDirectory(): boolean {\n\tfor (const directory of pendingCleanupDirectories) {\n\t\tif ((cleanupRetryAttempts.get(directory) ?? 0) < MAX_CLEANUP_RETRY_ATTEMPTS) return true;\n\t}\n\treturn false;\n}\n\nfunction schedulePendingCleanupRetry(): void {\n\tif (pendingCleanupRetry || !hasRetryableCleanupDirectory()) return;\n\tfor (const directory of pendingCleanupDirectories) {\n\t\tconst attempts = cleanupRetryAttempts.get(directory) ?? 0;\n\t\tif (attempts < MAX_CLEANUP_RETRY_ATTEMPTS) cleanupRetryAttempts.set(directory, attempts + 1);\n\t}\n\tpendingCleanupRetry = setTimeout(() => {\n\t\tpendingCleanupRetry = undefined;\n\t\ttry {\n\t\t\tdrainPendingCleanupDirectories();\n\t\t} catch {\n\t\t\t// drainPendingCleanupDirectories already retained the paths and rescheduled another retry.\n\t\t}\n\t}, CLEANUP_RETRY_DELAY_MS);\n}\n\nfunction drainPendingCleanupDirectories(): void {\n\tconst failures: unknown[] = [];\n\tfor (const directory of Array.from(pendingCleanupDirectories)) {\n\t\ttry {\n\t\t\trmSync(directory, { recursive: true, force: true });\n\t\t\tpendingCleanupDirectories.delete(directory);\n\t\t\tcleanupRetryAttempts.delete(directory);\n\t\t} catch (error) {\n\t\t\tfailures.push(error);\n\t\t}\n\t}\n\tif (pendingCleanupDirectories.size === 0 && pendingCleanupRetry) {\n\t\tclearTimeout(pendingCleanupRetry);\n\t\tpendingCleanupRetry = undefined;\n\t}\n\tif (failures.length > 0) {\n\t\tschedulePendingCleanupRetry();\n\t\tthrow new AggregateError(failures, \"Failed to clean materialized MCP resources\");\n\t}\n}\n\nexport function cleanupMaterializedBinaryResources(scope?: object): void {\n\tconst session = scope ? scopedMaterializedResourceSessions.get(scope) : defaultMaterializedResourceSession;\n\tif (session?.directory) pendingCleanupDirectories.add(session.directory);\n\tif (session) {\n\t\tsession.directory = undefined;\n\t\tsession.bytes = 0;\n\t\tsession.files = 0;\n\t\tsession.sequence = 0;\n\t\tif (scope) scopedMaterializedResourceSessions.delete(scope);\n\t}\n\n\tdrainPendingCleanupDirectories();\n}\n\nfunction replaceBlob(resource: BinaryResource, text: string): string {\n\tdelete (resource as Partial<BinaryResource>).blob;\n\tresource.text = text;\n\treturn text;\n}\n\nfunction omitBinaryResource(resource: BinaryResource, reason: string): string {\n\treturn replaceBlob(\n\t\tresource,\n\t\t[\n\t\t\t`[Resource: ${resource.uri ?? \"(no URI)\"}]`,\n\t\t\t`Binary content omitted: ${reason}`,\n\t\t\t`MIME type: ${resource.mimeType ?? \"application/octet-stream\"}`,\n\t\t].join(\"\\n\"),\n\t);\n}\n\nfunction materializeBinaryResource(resource: BinaryResource, scope?: object): string {\n\tconst session = getMaterializedResourceSession(scope);\n\tif (!session) return omitBinaryResource(resource, \"runtime stopped\");\n\tconst decodedBytes = Buffer.byteLength(resource.blob, \"base64\");\n\tif (decodedBytes > MAX_BINARY_RESOURCE_BYTES) {\n\t\treturn omitBinaryResource(resource, \"decoded size exceeds 10 MiB\");\n\t}\n\tif (session.bytes + decodedBytes > MAX_SESSION_RESOURCE_BYTES || session.files >= MAX_SESSION_RESOURCE_FILES) {\n\t\treturn omitBinaryResource(resource, \"session resource limit reached\");\n\t}\n\n\ttry {\n\t\tsession.directory ??= mkdtempSync(join(tmpdir(), \"nexus-mcp-resource-\"));\n\t} catch {\n\t\treturn omitBinaryResource(resource, \"could not be saved\");\n\t}\n\n\tconst filePath = join(session.directory, `resource-${++session.sequence}.bin`);\n\tsession.bytes += decodedBytes;\n\tsession.files += 1;\n\ttry {\n\t\twriteFileSync(filePath, Buffer.from(resource.blob, \"base64\"), { flag: \"wx\", mode: 0o600 });\n\t} catch {\n\t\ttry {\n\t\t\trmSync(filePath, { force: true });\n\t\t\tsession.bytes -= decodedBytes;\n\t\t\tsession.files -= 1;\n\t\t} catch {\n\t\t\t// Keep the reservation when a partial file cannot be removed.\n\t\t}\n\t\treturn omitBinaryResource(resource, \"could not be saved\");\n\t}\n\n\treturn replaceBlob(\n\t\tresource,\n\t\t[\n\t\t\t`[Resource: ${resource.uri ?? \"(no URI)\"}]`,\n\t\t\t`Binary content saved to ${filePath}`,\n\t\t\t`MIME type: ${resource.mimeType ?? \"application/octet-stream\"}`,\n\t\t].join(\"\\n\"),\n\t);\n}\n\n/**\n * Transform MCP content types to Nexus content blocks.\n */\nexport function transformMcpResourceContents(contents: McpResourceContent[], scope?: object): ContentBlock[] {\n\treturn contents.map((resource) => {\n\t\tif (typeof resource.text === \"string\") return { type: \"text\" as const, text: resource.text };\n\t\tif (typeof resource.blob === \"string\")\n\t\t\treturn { type: \"text\" as const, text: materializeBinaryResource(resource as BinaryResource, scope) };\n\t\treturn { type: \"text\" as const, text: JSON.stringify(resource) };\n\t});\n}\n\nexport function transformMcpContent(content: McpContent[], scope?: object): ContentBlock[] {\n\treturn content.map((c) => {\n\t\tif (c.type === \"text\") {\n\t\t\treturn { type: \"text\" as const, text: c.text ?? \"\" };\n\t\t}\n\t\tif (c.type === \"image\") {\n\t\t\treturn {\n\t\t\t\ttype: \"image\" as const,\n\t\t\t\tdata: c.data ?? \"\",\n\t\t\t\tmimeType: c.mimeType ?? \"image/png\",\n\t\t\t};\n\t\t}\n\t\tif (c.type === \"resource\") {\n\t\t\tconst resourceUri = c.resource?.uri ?? \"(no URI)\";\n\t\t\tif (c.resource && \"blob\" in c.resource && typeof c.resource.blob === \"string\") {\n\t\t\t\tconst binaryResource = c.resource as typeof c.resource & { mimeType?: string; blob: string };\n\t\t\t\treturn {\n\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\ttext: materializeBinaryResource(binaryResource, scope),\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst resourceContent = c.resource?.text ?? (c.resource ? JSON.stringify(c.resource) : \"(no content)\");\n\t\t\treturn {\n\t\t\t\ttype: \"text\" as const,\n\t\t\t\ttext: `[Resource: ${resourceUri}]\\n${resourceContent}`,\n\t\t\t};\n\t\t}\n\t\tif (c.type === \"resource_link\") {\n\t\t\tconst linkName = c.name ?? c.uri ?? \"unknown\";\n\t\t\tconst linkUri = c.uri ?? \"(no URI)\";\n\t\t\treturn {\n\t\t\t\ttype: \"text\" as const,\n\t\t\t\ttext: `[Resource Link: ${linkName}]\\nURI: ${linkUri}`,\n\t\t\t};\n\t\t}\n\t\tif (c.type === \"audio\") {\n\t\t\treturn {\n\t\t\t\ttype: \"text\" as const,\n\t\t\t\ttext: `[Audio content: ${c.mimeType ?? \"audio/*\"}]`,\n\t\t\t};\n\t\t}\n\t\treturn { type: \"text\" as const, text: JSON.stringify(c) };\n\t});\n}\n\n/**\n * Resolve a tool result's content blocks, falling back to structuredContent\n * when content is empty.\n */\nexport function resolveMcpResultContent(result: Record<string, unknown>, scope?: object): ContentBlock[] {\n\tconst blocks = transformMcpContent((Array.isArray(result.content) ? result.content : []) as McpContent[], scope);\n\tif (blocks.length > 0) return blocks;\n\n\tif (result.structuredContent !== undefined && result.structuredContent !== null) {\n\t\treturn [{ type: \"text\" as const, text: stringifyStructuredContent(result.structuredContent) }];\n\t}\n\n\treturn [];\n}\n\nfunction stringifyStructuredContent(value: unknown): string {\n\ttry {\n\t\treturn JSON.stringify(value, null, 2) ?? String(value);\n\t} catch {\n\t\treturn String(value);\n\t}\n}\n"]}

package/dist/extensions/mcp/tool-result-renderer.d.ts

@@ -0,0 +1,83 @@
+import { type Component, Text } from "@earendil-works/pi-tui";
+import type { AgentToolResult, ToolRenderResultOptions } from "../../core/extensions/types.ts";
+type McpToolResultDetails = Record<string, unknown> & {
+    error?: unknown;
+};
+interface RenderTheme {
+    fg: (name: string, text: string) => string;
+    bold?: (text: string) => string;
+}
+export interface McpProxyToolCallInput {
+    tool?: string;
+    args?: string | Record<string, unknown>;
+    connect?: string;
+    describe?: string;
+    search?: string;
+    regex?: boolean;
+    includeSchemas?: boolean;
+    server?: string;
+    action?: string;
+}
+interface McpToolRenderState {
+    compactTitle?: string;
+    compactInputPreview?: string;
+}
+interface McpToolRenderContext {
+    isError: boolean;
+    isPartial?: boolean;
+    expanded?: boolean;
+    state?: McpToolRenderState;
+}
+export type McpToolResultRendering = "compact" | "boxed";
+export interface McpToolRenderOptions {
+    resultRendering: McpToolResultRendering;
+    collapsedResultLines: 1 | 2 | 3;
+}
+export interface McpToolRenderSettings {
+    toolResultRendering?: unknown;
+    collapsedResultLines?: unknown;
+}
+export interface McpToolResultDisplay {
+    lines: string[];
+    truncated: boolean;
+}
+declare class EmptyComponent implements Component {
+    render(): string[];
+    invalidate(): void;
+}
+declare class CompactMcpToolResult implements Component {
+    private rendered;
+    private readonly title;
+    private readonly inputPreview;
+    private readonly display;
+    private readonly theme;
+    constructor(title: string, inputPreview: string, display: McpToolResultDisplay, theme: RenderTheme);
+    render(width: number): string[];
+    invalidate(): void;
+    private renderPrefix;
+}
+declare class CollapsibleText implements Component {
+    private readonly fullText;
+    private readonly footerText;
+    private collapsedText;
+    private collapsedRender;
+    private readonly text;
+    private readonly expanded;
+    private readonly maxCollapsedLines;
+    private readonly preTruncated;
+    constructor(text: string, expanded: boolean, maxCollapsedLines: number, ellipsis: string, expandHint: string, preTruncated?: boolean);
+    render(width: number): string[];
+    invalidate(): void;
+}
+export declare function formatMcpProxyToolCallLines(args: McpProxyToolCallInput, maxInputChars?: number): string[];
+export declare function formatMcpDirectToolCallLines(displayName: string, args: Record<string, unknown>, maxInputChars?: number): string[];
+export declare function resolveMcpToolRenderOptions(settings?: McpToolRenderSettings): McpToolRenderOptions;
+export declare function renderMcpProxyToolCall(args: McpProxyToolCallInput, theme?: RenderTheme, context?: McpToolRenderContext): EmptyComponent | Text;
+export declare function createMcpProxyToolCallRenderer(options: McpToolRenderOptions): (args: McpProxyToolCallInput, theme?: RenderTheme | undefined, context?: McpToolRenderContext | undefined) => EmptyComponent | Text;
+export declare function createMcpDirectToolCallRenderer(displayName: string, options?: McpToolRenderOptions): (args: Record<string, unknown>, theme?: RenderTheme | undefined, context?: McpToolRenderContext | undefined) => EmptyComponent | Text;
+export declare function formatMcpToolResultIdentity(details: McpToolResultDetails | undefined): string | null;
+export declare function formatMcpToolResultLines(result: Pick<AgentToolResult<McpToolResultDetails>, "content">, expanded: boolean, maxCollapsedLines?: number, maxCollapsedChars?: number): McpToolResultDisplay;
+export declare function renderMcpToolResult(result: AgentToolResult<McpToolResultDetails>, options: ToolRenderResultOptions, theme?: RenderTheme, context?: McpToolRenderContext, renderOptions?: McpToolRenderOptions): CollapsibleText | CompactMcpToolResult | Text;
+export declare function createMcpToolResultRenderer(renderOptions: McpToolRenderOptions): (result: AgentToolResult<McpToolResultDetails>, options: ToolRenderResultOptions, theme?: RenderTheme | undefined, context?: McpToolRenderContext | undefined) => CollapsibleText | CompactMcpToolResult | Text;
+export {};
+//# sourceMappingURL=tool-result-renderer.d.ts.map

package/dist/extensions/mcp/tool-result-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-renderer.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/tool-result-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Component, Text, truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\nimport type { AgentToolResult, ToolRenderResultOptions } from \"../../core/extensions/types.ts\";\n\ntype McpToolResultDetails = Record<string, unknown> & { error?: unknown };\ntype McpToolContentBlock = AgentToolResult<McpToolResultDetails>[\"content\"][number];\n\ninterface RenderTheme {\n\tfg: (name: string, text: string) => string;\n\tbold?: (text: string) => string;\n}\n\nconst plainTheme: RenderTheme = { fg: (_name, text) => text };\n\nexport interface McpProxyToolCallInput {\n\ttool?: string;\n\targs?: string | Record<string, unknown>;\n\tconnect?: string;\n\tdescribe?: string;\n\tsearch?: string;\n\tregex?: boolean;\n\tincludeSchemas?: boolean;\n\tserver?: string;\n\taction?: string;\n}\n\ninterface McpToolRenderState {\n\tcompactTitle?: string;\n\tcompactInputPreview?: string;\n}\n\ninterface McpToolRenderContext {\n\tisError: boolean;\n\tisPartial?: boolean;\n\texpanded?: boolean;\n\tstate?: McpToolRenderState;\n}\n\nexport type McpToolResultRendering = \"compact\" | \"boxed\";\n\nexport interface McpToolRenderOptions {\n\tresultRendering: McpToolResultRendering;\n\tcollapsedResultLines: 1 | 2 | 3;\n}\n\nexport interface McpToolRenderSettings {\n\ttoolResultRendering?: unknown;\n\tcollapsedResultLines?: unknown;\n}\n\nexport interface McpToolResultDisplay {\n\tlines: string[];\n\ttruncated: boolean;\n}\n\nconst DEFAULT_MAX_CALL_INPUT_CHARS = 1500;\nconst DEFAULT_MAX_COMPACT_INPUT_CHARS = 240;\nconst DEFAULT_BOXED_COLLAPSED_LINES = 3;\nconst DEFAULT_COMPACT_COLLAPSED_LINES = 1;\nconst DEFAULT_MAX_COLLAPSED_CHARS = 8000;\nconst COLLAPSED_RENDER_CHAR_SLACK = 8;\n\nclass EmptyComponent implements Component {\n\trender(): string[] {\n\t\treturn [];\n\t}\n\n\tinvalidate(): void {}\n}\n\nclass CompactMcpToolResult implements Component {\n\tprivate rendered: { width: number; lines: string[] } | null = null;\n\tprivate readonly title: string;\n\tprivate readonly inputPreview: string;\n\tprivate readonly display: McpToolResultDisplay;\n\tprivate readonly theme: RenderTheme;\n\n\tconstructor(title: string, inputPreview: string, display: McpToolResultDisplay, theme: RenderTheme) {\n\t\tthis.title = title;\n\t\tthis.inputPreview = inputPreview;\n\t\tthis.display = display;\n\t\tthis.theme = theme;\n\t}\n\n\trender(width: number): string[] {\n\t\tconst safeWidth = Math.max(1, Math.floor(width));\n\t\tif (this.rendered?.width === safeWidth) return this.rendered.lines;\n\n\t\tconst resultLines = this.display.lines.filter((line, index, lines) => {\n\t\t\treturn !(this.display.truncated && index === lines.length - 1 && line === \"…\");\n\t\t});\n\t\tconst lines = resultLines.length > 0 ? resultLines : [\"\"];\n\t\tconst bodies = lines.map((line, index) => {\n\t\t\tconst prefix = index === 0 ? this.renderPrefix(safeWidth) : \"\";\n\t\t\treturn `${prefix}${this.theme.fg(\"toolOutput\", line)}`;\n\t\t});\n\t\tconst hiddenText = this.display.truncated || bodies.some((body) => visibleWidth(body) > safeWidth);\n\t\tconst rendered = bodies.map((body, index) => {\n\t\t\tconst suffix = hiddenText && index === bodies.length - 1 ? \" … (Ctrl+O to expand)\" : \"\";\n\t\t\tif (!suffix) return truncateToWidth(body, safeWidth, \"…\");\n\t\t\tif (safeWidth >= suffix.length + 20) {\n\t\t\t\treturn `${truncateToWidth(body, safeWidth - suffix.length, \"…\")}${this.theme.fg(\"muted\", suffix)}`;\n\t\t\t}\n\t\t\tconst shortSuffix = \" (Ctrl+O)\";\n\t\t\tif (safeWidth >= shortSuffix.length + 5) {\n\t\t\t\treturn `${truncateToWidth(body, safeWidth - shortSuffix.length, \"…\")}${this.theme.fg(\"muted\", shortSuffix)}`;\n\t\t\t}\n\t\t\treturn truncateToWidth(this.theme.fg(\"muted\", shortSuffix.trim()), safeWidth, \"…\");\n\t\t});\n\t\tthis.rendered = { width: safeWidth, lines: rendered };\n\t\treturn rendered;\n\t}\n\n\tinvalidate(): void {\n\t\tthis.rendered = null;\n\t}\n\n\tprivate renderPrefix(width: number): string {\n\t\tif (!this.title) return \"\";\n\t\tconst arrow = \" → \";\n\t\tif (!this.inputPreview) return `${this.theme.fg(\"toolTitle\", this.title)}${arrow}`;\n\n\t\tconst maxPrefixWidth = Math.max(12, Math.floor(width * 0.55));\n\t\tconst titleWidth = visibleWidth(this.title);\n\t\tconst inputWidth = Math.max(0, maxPrefixWidth - titleWidth - 1);\n\t\tif (inputWidth <= 3) {\n\t\t\treturn `${this.theme.fg(\"toolTitle\", truncateToWidth(this.title, maxPrefixWidth, \"…\"))}${arrow}`;\n\t\t}\n\n\t\tconst input = truncateToWidth(this.inputPreview, inputWidth, \"…\");\n\t\treturn `${this.theme.fg(\"toolTitle\", this.title)} ${this.theme.fg(\"muted\", input)}${arrow}`;\n\t}\n}\n\nclass CollapsibleText implements Component {\n\tprivate readonly fullText: Text;\n\tprivate readonly footerText: Text;\n\tprivate collapsedText: { charBudget: number; fullyIncluded: boolean; text: Text } | null = null;\n\tprivate collapsedRender: { width: number; charBudget: number; lines: string[] } | null = null;\n\tprivate readonly text: string;\n\tprivate readonly expanded: boolean;\n\tprivate readonly maxCollapsedLines: number;\n\tprivate readonly preTruncated: boolean;\n\n\tconstructor(\n\t\ttext: string,\n\t\texpanded: boolean,\n\t\tmaxCollapsedLines: number,\n\t\tellipsis: string,\n\t\texpandHint: string,\n\t\tpreTruncated = false,\n\t) {\n\t\tthis.text = text;\n\t\tthis.expanded = expanded;\n\t\tthis.maxCollapsedLines = maxCollapsedLines;\n\t\tthis.preTruncated = preTruncated;\n\t\tthis.fullText = new Text(text, 0, 0);\n\t\tthis.footerText = new Text(`${ellipsis}\\n${expandHint}`, 0, 0);\n\t}\n\n\trender(width: number): string[] {\n\t\tif (this.expanded) {\n\t\t\treturn this.fullText.render(width);\n\t\t}\n\n\t\tconst safeWidth = Math.max(1, Math.floor(width));\n\t\tconst charBudget = safeWidth * (this.maxCollapsedLines + 1) * COLLAPSED_RENDER_CHAR_SLACK;\n\t\tif (!this.collapsedText || this.collapsedText.charBudget !== charBudget) {\n\t\t\tconst prefix = this.text.length > charBudget ? this.text.slice(0, charBudget) : this.text;\n\t\t\tthis.collapsedText = {\n\t\t\t\tcharBudget,\n\t\t\t\tfullyIncluded: prefix === this.text,\n\t\t\t\ttext: new Text(prefix, 0, 0),\n\t\t\t};\n\t\t\tthis.collapsedRender = null;\n\t\t}\n\n\t\tconst lines = this.collapsedText.text.render(width);\n\t\tif (!this.preTruncated && this.collapsedText.fullyIncluded && lines.length <= this.maxCollapsedLines)\n\t\t\treturn lines;\n\t\tif (this.collapsedRender?.width === width && this.collapsedRender.charBudget === charBudget) {\n\t\t\treturn this.collapsedRender.lines;\n\t\t}\n\n\t\tconst rendered = [...lines.slice(0, this.maxCollapsedLines), ...this.footerText.render(width)];\n\t\tthis.collapsedRender = { width, charBudget, lines: rendered };\n\t\treturn rendered;\n\t}\n\n\tinvalidate(): void {\n\t\tthis.fullText.invalidate();\n\t\tthis.footerText.invalidate();\n\t\tthis.collapsedText?.text.invalidate();\n\t\tthis.collapsedRender = null;\n\t}\n}\n\nfunction truncateText(value: string, maxChars: number): string {\n\tif (value.length <= maxChars) return value;\n\treturn `${value.slice(0, Math.max(0, maxChars - 1))}…`;\n}\n\nfunction formatJsonish(value: unknown, maxChars: number): string {\n\tif (typeof value === \"string\") {\n\t\ttry {\n\t\t\treturn truncateText(JSON.stringify(JSON.parse(value), null, 2), maxChars);\n\t\t} catch {\n\t\t\treturn truncateText(value, maxChars);\n\t\t}\n\t}\n\n\ttry {\n\t\treturn truncateText(JSON.stringify(value, null, 2), maxChars);\n\t} catch {\n\t\treturn truncateText(String(value), maxChars);\n\t}\n}\n\nfunction hasUsefulObjectContent(value: unknown): boolean {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value) && Object.keys(value).length > 0;\n}\n\nexport function formatMcpProxyToolCallLines(\n\targs: McpProxyToolCallInput,\n\tmaxInputChars = DEFAULT_MAX_CALL_INPUT_CHARS,\n): string[] {\n\tif (args.action === \"ui-messages\") return [`mcp ${args.action}`];\n\n\tif (args.tool) {\n\t\tconst target = args.server ? `${args.tool} @ ${args.server}` : args.tool;\n\t\tconst lines = [`mcp call ${target}`];\n\t\tif (args.args) lines.push(formatJsonish(args.args, maxInputChars));\n\t\treturn lines;\n\t}\n\n\tif (args.connect) return [`mcp connect ${args.connect}`];\n\tif (args.describe) return [`mcp describe ${args.describe}`];\n\n\tif (args.search) {\n\t\tlet line = `mcp search ${args.search}`;\n\t\tif (args.server) line += ` @ ${args.server}`;\n\t\tif (args.regex === true) line += \" (regex)\";\n\t\tif (args.includeSchemas === false) line += \" (schemas hidden)\";\n\t\treturn [line];\n\t}\n\n\tif (args.server) return [`mcp list ${args.server}`];\n\tif (args.action) return [`mcp ${args.action}`];\n\n\treturn [\"mcp status\"];\n}\n\nexport function formatMcpDirectToolCallLines(\n\tdisplayName: string,\n\targs: Record<string, unknown>,\n\tmaxInputChars = DEFAULT_MAX_CALL_INPUT_CHARS,\n): string[] {\n\tif (!hasUsefulObjectContent(args)) return [displayName];\n\treturn [displayName, formatJsonish(args, maxInputChars)];\n}\n\nfunction renderToolCallLines(lines: string[], theme?: RenderTheme) {\n\tconst activeTheme = theme ?? plainTheme;\n\tconst [title = \"mcp\", ...rest] = lines;\n\tconst styledTitle = activeTheme.fg(\"toolTitle\", activeTheme.bold ? activeTheme.bold(title) : title);\n\tconst styledRest = rest.map((line) => activeTheme.fg(\"muted\", line));\n\treturn new Text([styledTitle, ...styledRest].join(\"\\n\"), 0, 0);\n}\n\nfunction formatCompactInputPreview(lines: string[], maxChars = DEFAULT_MAX_COMPACT_INPUT_CHARS): string {\n\treturn truncateText(lines.slice(1).join(\" \").replace(/\\s+/g, \" \").trim(), maxChars);\n}\n\nexport function resolveMcpToolRenderOptions(settings?: McpToolRenderSettings): McpToolRenderOptions {\n\tconst resultRendering = settings?.toolResultRendering === \"boxed\" ? \"boxed\" : \"compact\";\n\tconst collapsedLines = settings?.collapsedResultLines;\n\tconst defaultLines = resultRendering === \"boxed\" ? DEFAULT_BOXED_COLLAPSED_LINES : DEFAULT_COMPACT_COLLAPSED_LINES;\n\treturn {\n\t\tresultRendering,\n\t\tcollapsedResultLines:\n\t\t\tcollapsedLines === 1 || collapsedLines === 2 || collapsedLines === 3 ? collapsedLines : defaultLines,\n\t};\n}\n\nfunction shouldUseCompactFinalRender(options: McpToolRenderOptions, context?: McpToolRenderContext): boolean {\n\treturn (\n\t\toptions.resultRendering === \"compact\" &&\n\t\tcontext !== undefined &&\n\t\tcontext.isPartial === false &&\n\t\tcontext.expanded !== true &&\n\t\tcontext.isError !== true\n\t);\n}\n\nfunction renderToolCall(\n\tlines: string[],\n\ttheme: RenderTheme | undefined,\n\tcontext: McpToolRenderContext | undefined,\n\toptions: McpToolRenderOptions,\n) {\n\tif (context?.state) {\n\t\tcontext.state.compactTitle = lines[0] ?? \"mcp\";\n\t\tcontext.state.compactInputPreview = formatCompactInputPreview(lines);\n\t}\n\tif (shouldUseCompactFinalRender(options, context)) return new EmptyComponent();\n\treturn renderToolCallLines(lines, theme);\n}\n\nexport function renderMcpProxyToolCall(\n\targs: McpProxyToolCallInput,\n\ttheme?: RenderTheme,\n\tcontext?: McpToolRenderContext,\n) {\n\treturn renderToolCall(formatMcpProxyToolCallLines(args), theme, context, resolveMcpToolRenderOptions());\n}\n\nexport function createMcpProxyToolCallRenderer(options: McpToolRenderOptions) {\n\treturn (args: McpProxyToolCallInput, theme?: RenderTheme, context?: McpToolRenderContext) => {\n\t\treturn renderToolCall(formatMcpProxyToolCallLines(args), theme, context, options);\n\t};\n}\n\nexport function createMcpDirectToolCallRenderer(displayName: string, options = resolveMcpToolRenderOptions()) {\n\treturn (args: Record<string, unknown>, theme?: RenderTheme, context?: McpToolRenderContext) => {\n\t\treturn renderToolCall(formatMcpDirectToolCallLines(displayName, args), theme, context, options);\n\t};\n}\n\nfunction blockToLines(block: McpToolContentBlock): string[] {\n\tif (block.type === \"text\") {\n\t\treturn block.text.split(\"\\n\");\n\t}\n\treturn [`[image: ${block.mimeType}]`];\n}\n\nfunction collectCollapsedResultLines(\n\tcontent: AgentToolResult<McpToolResultDetails>[\"content\"],\n\tmaxLines: number,\n\tmaxChars: number,\n): McpToolResultDisplay {\n\tif (content.length === 0) return { lines: [\"(empty result)\"], truncated: false };\n\n\tconst lines: string[] = [];\n\tlet remainingChars = maxChars;\n\tlet truncated = false;\n\n\tconst appendLine = (line: string) => {\n\t\tif (lines.length === 0) {\n\t\t\tconst previewWidth = Math.min(line.length, remainingChars);\n\t\t\tif (line.slice(0, previewWidth).trim() === \"\") {\n\t\t\t\tif (line.length >= remainingChars) {\n\t\t\t\t\ttruncated = true;\n\t\t\t\t\tremainingChars = 0;\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tremainingChars -= line.length + 1;\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\n\t\tif (lines.length >= maxLines || remainingChars <= 0) {\n\t\t\ttruncated = true;\n\t\t\treturn false;\n\t\t}\n\n\t\tif (line.length > remainingChars) {\n\t\t\tlines.push(line.slice(0, remainingChars));\n\t\t\ttruncated = true;\n\t\t\tremainingChars = 0;\n\t\t\treturn false;\n\t\t}\n\n\t\tlines.push(line);\n\t\tremainingChars -= line.length + 1;\n\t\treturn true;\n\t};\n\n\tfor (const block of content) {\n\t\tif (block.type !== \"text\") {\n\t\t\tif (!appendLine(`[image: ${block.mimeType}]`)) break;\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet start = 0;\n\t\twhile (start <= block.text.length) {\n\t\t\tconst newline = block.text.indexOf(\"\\n\", start);\n\t\t\tconst line = newline === -1 ? block.text.slice(start) : block.text.slice(start, newline);\n\t\t\tif (!appendLine(line)) break;\n\t\t\tif (newline === -1) break;\n\t\t\tstart = newline + 1;\n\t\t}\n\n\t\tif (truncated) break;\n\t}\n\n\tif (lines.length === 0) lines.push(truncated ? \"(leading blank output omitted)\" : \"\");\n\tif (truncated && lines.length >= maxLines) lines.push(\"…\");\n\treturn { lines, truncated };\n}\n\nexport function formatMcpToolResultIdentity(details: McpToolResultDetails | undefined): string | null {\n\tif (details?.mode !== \"call\") return null;\n\tconst server =\n\t\ttypeof details.server === \"string\"\n\t\t\t? details.server\n\t\t\t: typeof details.hintServer === \"string\"\n\t\t\t\t? details.hintServer\n\t\t\t\t: null;\n\tif (!server) return null;\n\tif (typeof details.tool === \"string\") return `MCP ${server}/${details.tool}`;\n\tif (typeof details.resourceUri === \"string\") return `MCP ${server} resource ${details.resourceUri}`;\n\tif (typeof details.requestedTool === \"string\") return `MCP ${server}/${details.requestedTool}`;\n\treturn null;\n}\n\nexport function formatMcpToolResultLines(\n\tresult: Pick<AgentToolResult<McpToolResultDetails>, \"content\">,\n\texpanded: boolean,\n\tmaxCollapsedLines = DEFAULT_BOXED_COLLAPSED_LINES,\n\tmaxCollapsedChars = DEFAULT_MAX_COLLAPSED_CHARS,\n): McpToolResultDisplay {\n\tif (!expanded) {\n\t\treturn collectCollapsedResultLines(result.content, maxCollapsedLines, maxCollapsedChars);\n\t}\n\n\tconst allLines = result.content.flatMap(blockToLines);\n\tconst lines = allLines.length > 0 ? allLines : [\"(empty result)\"];\n\treturn { lines, truncated: false };\n}\n\nexport function renderMcpToolResult(\n\tresult: AgentToolResult<McpToolResultDetails>,\n\toptions: ToolRenderResultOptions,\n\ttheme?: RenderTheme,\n\tcontext?: McpToolRenderContext,\n\trenderOptions = resolveMcpToolRenderOptions(),\n) {\n\tconst activeTheme = theme ?? plainTheme;\n\tif (options.isPartial) {\n\t\treturn new Text(activeTheme.fg(\"warning\", \"Running MCP tool...\"), 0, 0);\n\t}\n\n\tconst hasErrorDetails = Boolean(result.details.error);\n\tconst expanded = options.expanded || context?.isError === true || hasErrorDetails;\n\tif (!expanded && renderOptions.resultRendering === \"compact\") {\n\t\tconst display = formatMcpToolResultLines(result, false, renderOptions.collapsedResultLines);\n\t\tconst title = context?.state?.compactTitle ?? formatMcpToolResultIdentity(result.details) ?? \"\";\n\t\tconst inputPreview = context?.state?.compactInputPreview ?? \"\";\n\t\treturn new CompactMcpToolResult(title, inputPreview, display, activeTheme);\n\t}\n\n\tconst display = formatMcpToolResultLines(result, expanded, renderOptions.collapsedResultLines);\n\tconst identity = formatMcpToolResultIdentity(result.details);\n\tconst output = [\n\t\t...(identity ? [activeTheme.fg(\"muted\", identity)] : []),\n\t\t...display.lines.map((line) => activeTheme.fg(\"toolOutput\", line)),\n\t].join(\"\\n\");\n\n\treturn new CollapsibleText(\n\t\toutput,\n\t\texpanded,\n\t\trenderOptions.collapsedResultLines + (identity ? 1 : 0),\n\t\tactiveTheme.fg(\"muted\", \"…\"),\n\t\tactiveTheme.fg(\"muted\", \"(Ctrl+O to expand)\"),\n\t\tdisplay.truncated,\n\t);\n}\n\nexport function createMcpToolResultRenderer(renderOptions: McpToolRenderOptions) {\n\treturn (\n\t\tresult: AgentToolResult<McpToolResultDetails>,\n\t\toptions: ToolRenderResultOptions,\n\t\ttheme?: RenderTheme,\n\t\tcontext?: McpToolRenderContext,\n\t) => renderMcpToolResult(result, options, theme, context, renderOptions);\n}\n"]}