@caplets/core 0.18.6 → 0.18.8

package/dist/generated-tool-input-schema.d.ts

@@ -49,11 +49,11 @@ export declare function generatedToolInputSchemaForCaplet(caplet: CapletSchemaBa
     arguments: z.ZodOptional<z.ZodObject<{}, z.core.$catchall<z.ZodAny>>>;
     fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     operation: z.ZodEnum<{
-        get_caplet: "get_caplet";
-        check_backend: "check_backend";
         list_tools: "list_tools";
         search_tools: "search_tools";
         get_tool: "get_tool";
+        check_backend: "check_backend";
+        get_caplet: "get_caplet";
         call_tool: "call_tool";
     }>;
 }, z.core.$strict>;
@@ -64,11 +64,11 @@ export declare const generatedToolInputSchema: z.ZodObject<{
     arguments: z.ZodOptional<z.ZodObject<{}, z.core.$catchall<z.ZodAny>>>;
     fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     operation: z.ZodEnum<{
-        get_caplet: "get_caplet";
-        check_backend: "check_backend";
         list_tools: "list_tools";
         search_tools: "search_tools";
         get_tool: "get_tool";
+        check_backend: "check_backend";
+        get_caplet: "get_caplet";
         call_tool: "call_tool";
     }>;
 }, z.core.$strict>;

package/dist/generated-tool-input-schema.js

@@ -1,2 +1,2 @@
-import { a as generatedToolInputJsonSchemaForCaplet, c as mcpOperations, i as generatedToolInputJsonSchema, l as operations, n as completionRefSchema, o as generatedToolInputSchema, r as generatedToolInputDescriptions, s as generatedToolInputSchemaForCaplet, t as completionArgumentSchema } from "./generated-tool-input-schema-BYoyY-l-.js";
+import { a as generatedToolInputJsonSchemaForCaplet, c as mcpOperations, i as generatedToolInputJsonSchema, l as operations, n as completionRefSchema, o as generatedToolInputSchema, r as generatedToolInputDescriptions, s as generatedToolInputSchemaForCaplet, t as completionArgumentSchema } from "./generated-tool-input-schema-MbYF5jMW.js";
 export { completionArgumentSchema, completionRefSchema, generatedToolInputDescriptions, generatedToolInputJsonSchema, generatedToolInputJsonSchemaForCaplet, generatedToolInputSchema, generatedToolInputSchemaForCaplet, mcpOperations, operations };

package/dist/graphql.d.ts

@@ -1,4 +1,4 @@
-import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types";
 import type { GraphQlEndpointConfig } from "./config";
 import type { CompactTool } from "./downstream";
 import type { ServerRegistry } from "./registry";

package/dist/http-actions.d.ts

@@ -1,4 +1,4 @@
-import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types";
 import type { HttpApiConfig } from "./config";
 import type { CompactTool } from "./downstream";
 import type { ServerRegistry } from "./registry";

package/dist/index.d.ts

@@ -3,5 +3,7 @@ export { runCli, createProgram } from "./cli";
 export { parseConfig, loadConfig } from "./config";
 export { capabilityDescription, ServerRegistry } from "./registry";
 export { generatedToolInputSchema, handleServerTool } from "./tools";
+export { hasRenderableStructuredContent, markdownCallToolResultContent, markdownStructuredContent, } from "./result-content";
+export type { ResultMarkdownContext } from "./result-content";
 export { serveCaplets, serveHttp, serveResolvedCaplets, serveStdio } from "./serve";
 export type { HttpServeOptions, RawServeOptions, ServeOptions, StdioServeOptions } from "./serve";

package/dist/index.js

@@ -1,6 +1,6 @@
-import { $ as assertCompleteRequestPrompt, A as CreateMessageResultSchema, At as CAPLETS_ERROR_CODES, B as JSONRPCMessageSchema, C as AjvJsonSchemaValidator, Ct as resolveCapletsRoot, D as CallToolRequestSchema, Dt as discoverCapletFiles, E as toJsonSchemaCompat, Et as resolveProjectConfigPath, F as EmptyResultSchema, G as ListRootsResultSchema, H as ListPromptsRequestSchema, I as ErrorCode, It as __require, J as McpError, K as ListToolsRequestSchema, L as GetPromptRequestSchema, Lt as __toESM, M as CreateTaskResultSchema, Mt as redactSecrets, Nt as toSafeError, O as CallToolResultSchema, Ot as validateCapletFile, P as ElicitResultSchema, Pt as __commonJSMin, R as InitializeRequestSchema, S as assertToolsCallTaskCapability, T as mergeCapabilities, Tt as resolveProjectCapletsRoot, U as ListResourceTemplatesRequestSchema, V as LATEST_PROTOCOL_VERSION, W as ListResourcesRequestSchema, X as SUPPORTED_PROTOCOL_VERSIONS, Y as ReadResourceRequestSchema, Z as SetLevelRequestSchema, _t as loadGlobalConfig, a as resolveCapletsServer, at as getLiteralValue, bt as parseConfig, c as ServerRegistry, ct as getSchemaDescription, d as runOAuthFlow, dt as normalizeObjectSchema, et as assertCompleteRequestResourceTemplate, f as startGenericOAuthFlow, ft as objectFromShape, g as readTokenBundle, gt as loadConfigWithSources, h as isTokenBundleExpired, ht as loadConfig, i as resolveCapletsMode, it as isJSONRPCResultResponse, j as CreateMessageResultWithToolsSchema, jt as CapletsError, k as CompleteRequestSchema, kt as SERVER_ID_PATTERN, l as capabilityDescription, lt as isSchemaOptional, m as deleteTokenBundle, mt as safeParseAsync, nt as isJSONRPCErrorResponse, o as CapletsEngine, ot as getObjectShape, p as startOAuthFlow, pt as safeParse, q as LoggingLevelSchema, r as parseServerBaseUrl, rt as isJSONRPCRequest, s as handleServerTool, st as getParseErrorMessage, t as controlUrlForBase, tt as isInitializeRequest, u as runGenericOAuthFlow, ut as isZ4Schema, v as ReadBuffer, vt as loadLocalOverlayConfigWithSources, w as Protocol, wt as resolveConfigPath, x as assertClientRequestTaskCapability, y as serializeMessage, yt as loadProjectConfig, z as InitializedNotificationSchema } from "./options-BlNyqF_E.js";
-import { A as url, C as object, D as string, b as literal, d as ZodOptional, o as generatedToolInputSchema, s as generatedToolInputSchemaForCaplet } from "./generated-tool-input-schema-BYoyY-l-.js";
-import { a as formatCapletList, c as resolveCliConfigPaths, l as cliCommands, n as completionScript, o as formatConfigPaths, s as listCaplets, t as completeCliWords, u as completionShells } from "./completion-DRPTunQd.js";
+import { $ as assertCompleteRequestPrompt, A as CreateMessageResultSchema, At as hasRenderableStructuredContent, B as JSONRPCMessageSchema, Bt as __toESM, C as AjvJsonSchemaValidator, Ct as resolveCapletsRoot, D as CallToolRequestSchema, Dt as discoverCapletFiles, E as toJsonSchemaCompat, Et as resolveProjectConfigPath, F as EmptyResultSchema, Ft as redactSecrets, G as ListRootsResultSchema, H as ListPromptsRequestSchema, I as ErrorCode, It as toSafeError, J as McpError, K as ListToolsRequestSchema, L as GetPromptRequestSchema, Lt as __commonJSMin, M as CreateTaskResultSchema, Mt as markdownStructuredContent, Nt as CAPLETS_ERROR_CODES, O as CallToolResultSchema, Ot as validateCapletFile, P as ElicitResultSchema, Pt as CapletsError, R as InitializeRequestSchema, S as assertToolsCallTaskCapability, T as mergeCapabilities, Tt as resolveProjectCapletsRoot, U as ListResourceTemplatesRequestSchema, V as LATEST_PROTOCOL_VERSION, W as ListResourcesRequestSchema, X as SUPPORTED_PROTOCOL_VERSIONS, Y as ReadResourceRequestSchema, Z as SetLevelRequestSchema, _t as loadGlobalConfig, a as resolveCapletsServer, at as getLiteralValue, bt as parseConfig, c as ServerRegistry, ct as getSchemaDescription, d as runOAuthFlow, dt as normalizeObjectSchema, et as assertCompleteRequestResourceTemplate, f as startGenericOAuthFlow, ft as objectFromShape, g as readTokenBundle, gt as loadConfigWithSources, h as isTokenBundleExpired, ht as loadConfig, i as resolveCapletsMode, it as isJSONRPCResultResponse, j as CreateMessageResultWithToolsSchema, jt as markdownCallToolResultContent, k as CompleteRequestSchema, kt as SERVER_ID_PATTERN, l as capabilityDescription, lt as isSchemaOptional, m as deleteTokenBundle, mt as safeParseAsync, nt as isJSONRPCErrorResponse, o as CapletsEngine, ot as getObjectShape, p as startOAuthFlow, pt as safeParse, q as LoggingLevelSchema, r as parseServerBaseUrl, rt as isJSONRPCRequest, s as handleServerTool, st as getParseErrorMessage, t as controlUrlForBase, tt as isInitializeRequest, u as runGenericOAuthFlow, ut as isZ4Schema, v as ReadBuffer, vt as loadLocalOverlayConfigWithSources, w as Protocol, wt as resolveConfigPath, x as assertClientRequestTaskCapability, y as serializeMessage, yt as loadProjectConfig, z as InitializedNotificationSchema, zt as __require } from "./options--RoZwWjs.js";
+import { A as url, C as object, D as string, b as literal, d as ZodOptional, o as generatedToolInputSchema, s as generatedToolInputSchemaForCaplet } from "./generated-tool-input-schema-MbYF5jMW.js";
+import { a as formatCapletList, c as resolveCliConfigPaths, l as cliCommands, n as completionScript, o as formatConfigPaths, s as listCaplets, t as completeCliWords, u as completionShells } from "./completion-DvWQk5qR.js";
 import { accessSync, chmodSync, closeSync, constants, copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
 import { execFileSync } from "node:child_process";
@@ -1320,7 +1320,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 } };
 //#endregion
 //#region package.json
-var version = "0.18.6";
+var version = "0.18.8";
 //#endregion
 //#region src/serve/session.ts
 var CapletsMcpSession = class {
@@ -7349,7 +7349,7 @@ var SSEStreamingApi = class extends StreamingApi {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@hono+mcp@0.3.0_@modelcontextprotocol+sdk@1.29.0_zod@4.4.3__hono-rate-limiter@0.5.3_hono@4.12.23__hono@4.12.23_zod@4.4.3/node_modules/@hono/mcp/dist/index.js
+//#region ../../node_modules/.pnpm/@hono+mcp@0.3.0_@modelcontextprotocol+sdk@1.29.0_zod@4.4.3__hono-rate-limiter@0.5.3_hon_db5d1ad1945c3abb4411768ead465a9b/node_modules/@hono/mcp/dist/index.js
 let isOldBunVersion = () => {
 	const version = typeof Bun !== "undefined" ? Bun.version : void 0;
 	if (version === void 0) return false;
@@ -10737,4 +10737,4 @@ function writeAddResult(writeOut, label, result) {
 	writeOut(result.text);
 }
 //#endregion
-export { CapletsRuntime, ServerRegistry, capabilityDescription, createProgram, generatedToolInputSchema, handleServerTool, loadConfig, parseConfig, runCli, serveCaplets, serveHttp, serveResolvedCaplets, serveStdio };
+export { CapletsRuntime, ServerRegistry, capabilityDescription, createProgram, generatedToolInputSchema, handleServerTool, hasRenderableStructuredContent, loadConfig, markdownCallToolResultContent, markdownStructuredContent, parseConfig, runCli, serveCaplets, serveHttp, serveResolvedCaplets, serveStdio };

package/dist/native.js

@@ -1,5 +1,5 @@
-import { Q as ToolListChangedNotificationSchema, _ as StreamableHTTPClientTransport, a as resolveCapletsServer, b as Client, bt as parseConfig, i as resolveCapletsMode, jt as CapletsError, l as capabilityDescription, n as mcpUrlForBase, o as CapletsEngine, vt as loadLocalOverlayConfigWithSources } from "./options-BlNyqF_E.js";
-import { a as generatedToolInputJsonSchemaForCaplet, i as generatedToolInputJsonSchema, l as operations, o as generatedToolInputSchema } from "./generated-tool-input-schema-BYoyY-l-.js";
+import { Pt as CapletsError, Q as ToolListChangedNotificationSchema, _ as StreamableHTTPClientTransport, a as resolveCapletsServer, b as Client, bt as parseConfig, i as resolveCapletsMode, l as capabilityDescription, n as mcpUrlForBase, o as CapletsEngine, vt as loadLocalOverlayConfigWithSources } from "./options--RoZwWjs.js";
+import { a as generatedToolInputJsonSchemaForCaplet, i as generatedToolInputJsonSchema, l as operations, o as generatedToolInputSchema } from "./generated-tool-input-schema-MbYF5jMW.js";
 //#region src/native/options.ts
 const DEFAULT_POLL_INTERVAL_MS = 3e4;
 function resolveNativeCapletsServiceOptions(input = {}, env = process.env) {

package/dist/openapi.d.ts

@@ -1,4 +1,4 @@
-import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { CompatibilityCallToolResult, Tool } from "@modelcontextprotocol/sdk/types";
 import type { OpenApiEndpointConfig } from "./config";
 import type { CompactTool } from "./downstream";
 import type { ServerRegistry } from "./registry";

package/dist/{options-BlNyqF_E.js → options--RoZwWjs.js}

@@ -1,4 +1,4 @@
-import { A as url, B as clone, C as object$1, D as string, E as record, F as $ZodType, H as normalizeParams, I as parse$2, L as parseAsync, M as toJSONSchema, N as _coercedNumber, O as union, P as $ZodObject, R as safeParse$1, S as number$1, T as preprocess, U as $constructor, V as defineLazy, W as NEVER, _ as custom, b as literal, c as mcpOperations, f as _enum, g as boolean, h as array, i as generatedToolInputJsonSchema, j as datetime, k as unknown, l as operations, m as any, p as _null, s as generatedToolInputSchemaForCaplet, u as ZodNumber$1, v as discriminatedUnion, w as optional, x as looseObject, y as intersection, z as safeParseAsync$1 } from "./generated-tool-input-schema-BYoyY-l-.js";
+import { A as url, B as clone, C as object$1, D as string, E as record, F as $ZodType, H as normalizeParams, I as parse$2, L as parseAsync, M as toJSONSchema, N as _coercedNumber, O as union, P as $ZodObject, R as safeParse$1, S as number$1, T as preprocess, U as $constructor, V as defineLazy, W as NEVER, _ as custom, b as literal, c as mcpOperations, f as _enum, g as boolean, h as array, i as generatedToolInputJsonSchema, j as datetime, k as unknown, l as operations, m as any, p as _null, s as generatedToolInputSchemaForCaplet, u as ZodNumber$1, v as discriminatedUnion, w as optional, x as looseObject, y as intersection, z as safeParseAsync$1 } from "./generated-tool-input-schema-MbYF5jMW.js";
 import { createRequire } from "node:module";
 import { accessSync, chmodSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import minpath, { basename, delimiter, dirname, extname, isAbsolute, join, parse, posix, relative, resolve, win32 } from "node:path";
@@ -108,13 +108,26 @@ function toSafeError(error, fallback = "INTERNAL_ERROR") {
 }
 function errorResult(error, fallback) {
 	const safe = toSafeError(error, fallback);
+	const structuredContent = { error: safe };
 	return {
 		isError: true,
 		content: [{
 			type: "text",
-			text: `${safe.code}: ${safe.message}`
+			text: [
+				"# Error",
+				"",
+				`## ${safe.code}`,
+				"",
+				safe.message,
+				"",
+				"## Details",
+				"",
+				"```json",
+				JSON.stringify(safe, null, 2),
+				"```"
+			].join("\n")
 		}],
-		structuredContent: { error: safe }
+		structuredContent
 	};
 }
 //#endregion
@@ -125,33 +138,277 @@ function textContent(text) {
 		text
 	}] : [];
 }
-function compactJsonText(value, maxLength = 600) {
-	return compactText(JSON.stringify(value) ?? String(value), maxLength);
+function markdownStructuredContent(value, context = {}) {
+	return textContent(renderStructuredMarkdown(value, context));
 }
-function compactText(value, maxLength = 600) {
-	const collapsed = value.replace(/\s+/gu, " ").trim();
-	return collapsed.length > maxLength ? `${collapsed.slice(0, maxLength - 1).trimEnd()}…` : collapsed;
+function markdownCallToolResultContent(result, context = {}) {
+	const downstreamText = textBlocksToString(result.content);
+	const structuredContent = result.structuredContent;
+	const hasStructured = hasRenderableStructuredContent(structuredContent);
+	if (context.backend === "mcp" && hasStructured) {
+		const renderedStructured = markdownStructuredContent(structuredContent, context)[0]?.text;
+		if (downstreamText && downstreamText === renderedStructured) return textContent(downstreamText);
+		return [...result.content ?? [], {
+			type: "text",
+			text: [
+				"## Structured Content",
+				"",
+				jsonFence(structuredContent)
+			].join("\n")
+		}];
+	}
+	if (hasStructured) return markdownStructuredContent(structuredContent, {
+		...context,
+		isError: context.isError ?? result.isError
+	});
+	if (downstreamText) return textContent(downstreamText);
+	return textContent(renderStructuredMarkdown(result, context));
+}
+function hasRenderableStructuredContent(value) {
+	if (!isRecord(value)) return false;
+	return Object.keys(value).some((key) => key !== "caplets" && key !== "elapsedMs");
+}
+function renderStructuredMarkdown(value, context) {
+	const title = markdownTitle(context);
+	if (isDiscoveryWrapper(value)) return renderDiscoveryWrapper(value, context, title);
+	if (context.isError || isErrorStructuredContent(value)) return renderErrorMarkdown(value, title);
+	if (context.backend === "cli" || isCliResult(value)) return renderCliMarkdown(value, title);
+	if (context.backend === "graphql" && isHttpLikeResult(value) || isGraphQlHttpResult(value)) return renderGraphQlMarkdown(value, title);
+	if (isHttpLikeResult(value)) return renderHttpMarkdown(value, title);
+	return [
+		title,
+		"",
+		"## Result",
+		"",
+		jsonFence(value)
+	].join("\n");
+}
+function markdownTitle(context) {
+	if (context.title) return `# ${context.title}`;
+	const parts = [context.operation, context.tool ?? context.uri ?? context.prompt].filter((part) => Boolean(part));
+	return parts.length > 0 ? `# ${parts.join(" ")}` : "# Result";
+}
+function renderHttpMarkdown(value, title) {
+	const record = asRecord$2(value) ?? {};
+	const lines = [
+		title,
+		"",
+		"## Response",
+		""
+	];
+	const status = typeof record.status === "number" ? record.status : void 0;
+	const statusText = typeof record.statusText === "string" ? record.statusText : void 0;
+	if (status !== void 0 || statusText) lines.push(`- **Status:** \`${[status, statusText].filter(Boolean).join(" ")}\``);
+	if (typeof record.elapsedMs === "number") lines.push(`- **Elapsed:** \`${record.elapsedMs} ms\``);
+	lines.push("", "## Headers", "", jsonFence(record.headers ?? {}), "", "## Body", "", renderBodyValue(record.body));
+	const additional = omitKeys(record, [
+		"status",
+		"statusText",
+		"headers",
+		"body",
+		"elapsedMs"
+	]);
+	if (Object.keys(additional).length > 0) lines.push("", "## Additional Fields", "", jsonFence(additional));
+	return lines.join("\n");
+}
+function renderGraphQlMarkdown(value, title) {
+	const record = asRecord$2(value) ?? {};
+	const body = asRecord$2(record.body);
+	if (!body || !("data" in body) && !("errors" in body)) return renderHttpMarkdown(value, title);
+	const lines = [
+		title,
+		"",
+		"## Response",
+		""
+	];
+	const status = typeof record.status === "number" ? record.status : void 0;
+	const statusText = typeof record.statusText === "string" ? record.statusText : void 0;
+	if (status !== void 0 || statusText) lines.push(`- **Status:** \`${[status, statusText].filter(Boolean).join(" ")}\``);
+	if (typeof record.elapsedMs === "number") lines.push(`- **Elapsed:** \`${record.elapsedMs} ms\``);
+	if ("data" in body) lines.push("", "## Data", "", jsonFence(body.data));
+	if ("errors" in body) lines.push("", "## Errors", "", jsonFence(body.errors));
+	lines.push("", "## Headers", "", jsonFence(record.headers ?? {}), "", "## Full Body", "", jsonFence(record.body));
+	const additional = omitKeys(record, [
+		"status",
+		"statusText",
+		"headers",
+		"body",
+		"elapsedMs"
+	]);
+	if (Object.keys(additional).length > 0) lines.push("", "## Additional Fields", "", jsonFence(additional));
+	return lines.join("\n");
+}
+function renderCliMarkdown(value, title) {
+	const record = asRecord$2(value) ?? {};
+	const lines = [
+		title,
+		"",
+		"## Command Result",
+		""
+	];
+	if ("exitCode" in record) lines.push(`- **Exit code:** \`${String(record.exitCode)}\``);
+	if ("signal" in record) lines.push(`- **Signal:** \`${String(record.signal)}\``);
+	if (typeof record.elapsedMs === "number") lines.push(`- **Elapsed:** \`${record.elapsedMs} ms\``);
+	lines.push("", "## stdout", "", textFenceOrEmpty(record.stdout, "No stdout."));
+	lines.push("", "## stderr", "", textFenceOrEmpty(record.stderr, "No stderr."));
+	if ("json" in record) lines.push("", "## Parsed JSON", "", jsonFence(record.json));
+	if ("jsonParseError" in record) lines.push("", "## JSON Parse Error", "", jsonFence(record.jsonParseError));
+	const additional = omitKeys(record, [
+		"exitCode",
+		"signal",
+		"stdout",
+		"stderr",
+		"elapsedMs",
+		"json",
+		"jsonParseError"
+	]);
+	if (Object.keys(additional).length > 0) lines.push("", "## Additional Fields", "", jsonFence(additional));
+	return lines.join("\n");
+}
+function renderDiscoveryWrapper(value, context, title) {
+	const result = asRecord$2(value.result);
+	const lines = [title, ""];
+	if (context.operation === "list_tools" || context.operation === "search_tools") lines.push("## Tools", "", renderNamedList(arrayValue(result?.tools), "tool"), "");
+	else if (context.operation === "list_resources" || context.operation === "search_resources") lines.push("## Resources", "", renderNamedList(arrayValue(result?.resources ?? result?.matches), "uri"), "");
+	else if (context.operation === "list_resource_templates") lines.push("## Resource Templates", "", renderNamedList(arrayValue(result?.resourceTemplates), "uriTemplate"), "");
+	else if (context.operation === "list_prompts" || context.operation === "search_prompts") lines.push("## Prompts", "", renderNamedList(arrayValue(result?.prompts), "prompt"), "");
+	else if (context.operation === "get_tool") lines.push("## Tool", "", renderToolSummary(asRecord$2(result?.tool)), "");
+	else if (context.operation === "check_backend") lines.push("## Backend Status", "", renderBackendStatus(result), "");
+	else if (context.operation === "get_caplet") lines.push("## Caplet", "", renderCapletSummary(result), "");
+	lines.push("## Full Result", "", jsonFence(value.result));
+	if (value.caplets !== void 0) lines.push("", "## Caplets Metadata", "", jsonFence(value.caplets));
+	return lines.join("\n");
+}
+function renderErrorMarkdown(value, title) {
+	const error = asRecord$2(asRecord$2(value)?.error) ?? asRecord$2(value);
+	const code = typeof error?.code === "string" ? error.code : "Error";
+	const message = typeof error?.message === "string" ? error.message : "Tool call failed.";
+	return [
+		title === "# Result" || title === "# Error" ? "# Error" : title,
+		"",
+		`## ${code}`,
+		"",
+		message,
+		"",
+		"## Details",
+		"",
+		jsonFence(error ?? value)
+	].join("\n");
+}
+function isDiscoveryWrapper(value) {
+	return isRecord(value) && "result" in value;
 }
-function resultKeys(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return "scalar result";
-	const keys = Object.keys(value).filter((key) => key !== "elapsedMs");
-	return keys.length > 0 ? `structured keys: ${keys.join(", ")}` : "empty structured result";
+function isErrorStructuredContent(value) {
+	return isRecord(value) && "error" in value;
 }
-function statusSummary(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return compactJsonText(value);
-	const record = value;
+function isHttpLikeResult(value) {
+	return isRecord(value) && ("status" in value || "statusText" in value || "body" in value);
+}
+function isGraphQlHttpResult(value) {
+	if (!isHttpLikeResult(value)) return false;
+	const body = asRecord$2(value.body);
+	return Boolean(body && ("data" in body || "errors" in body));
+}
+function isCliResult(value) {
+	return isRecord(value) && ("exitCode" in value || "stdout" in value || "stderr" in value);
+}
+function renderBodyValue(value) {
+	if (value === void 0) return "_No response body._";
+	if (typeof value === "string") return textFenceOrEmpty(value, "No response body.");
+	return jsonFence(value);
+}
+function textFenceOrEmpty(value, emptyMessage) {
+	if (typeof value !== "string" || value.length === 0) return `_${emptyMessage}_`;
 	return [
-		typeof record.status === "number" ? `status ${record.status}` : void 0,
-		typeof record.statusText === "string" && record.statusText ? record.statusText : void 0,
-		typeof record.exitCode === "number" ? `exit ${record.exitCode}` : void 0,
-		"body" in record ? "body" : void 0,
-		"json" in record ? "json" : void 0,
-		typeof record.stdout === "string" && record.stdout ? "stdout" : void 0,
-		typeof record.stderr === "string" && record.stderr ? "stderr" : void 0
-	].filter((part) => Boolean(part)).join("; ") || resultKeys(record);
+		"```text",
+		escapeCodeFence(value),
+		"```"
+	].join("\n");
+}
+function jsonFence(value) {
+	return [
+		"```json",
+		escapeCodeFence(JSON.stringify(value, null, 2) ?? "null"),
+		"```"
+	].join("\n");
+}
+function escapeCodeFence(value) {
+	return value.replace(/```/gu, "`​``");
+}
+function textBlocksToString(content) {
+	if (!Array.isArray(content)) return "";
+	return content.filter((item) => Boolean(item && typeof item === "object" && item.type === "text" && typeof item.text === "string")).map((item) => item.text).filter(Boolean).join("\n");
+}
+function renderNamedList(items, nameKey) {
+	if (items.length === 0) return "_No items._";
+	return items.map((item, index) => {
+		const record = asRecord$2(item);
+		const name = stringValue(record?.[nameKey]) ?? stringValue(record?.name) ?? `Item ${index + 1}`;
+		const description = stringValue(record?.description);
+		return description ? `${index + 1}. \`${name}\` — ${description}` : `${index + 1}. \`${name}\``;
+	}).join("\n");
+}
+function renderToolSummary(tool) {
+	if (!tool) return "_Tool details unavailable._";
+	const lines = [];
+	const name = stringValue(tool.name);
+	const description = stringValue(tool.description);
+	if (name) lines.push(`- **Name:** \`${name}\``);
+	if (description) lines.push(`- **Description:** ${description}`);
+	if (tool.inputSchema !== void 0) lines.push("", "### Input Schema", "", jsonFence(tool.inputSchema));
+	if (tool.outputSchema !== void 0) lines.push("", "### Output Schema", "", jsonFence(tool.outputSchema));
+	if (tool.annotations !== void 0) lines.push("", "### Annotations", "", jsonFence(tool.annotations));
+	return lines.length > 0 ? lines.join("\n") : jsonFence(tool);
+}
+function renderBackendStatus(result) {
+	if (!result) return "_Backend status unavailable._";
+	const lines = [];
+	for (const key of [
+		"id",
+		"status",
+		"toolCount",
+		"resourceCount",
+		"resourceTemplateCount",
+		"promptCount",
+		"elapsedMs"
+	]) if (result[key] !== void 0) {
+		const label = key === "elapsedMs" ? "Elapsed" : humanizeKey(key);
+		const suffix = key === "elapsedMs" ? " ms" : "";
+		lines.push(`- **${label}:** \`${String(result[key])}${suffix}\``);
+	}
+	if (result.error !== void 0) lines.push("", "### Error", "", jsonFence(result.error));
+	return lines.length > 0 ? lines.join("\n") : jsonFence(result);
+}
+function renderCapletSummary(result) {
+	if (!result) return "_Caplet details unavailable._";
+	const lines = [];
+	for (const key of [
+		"id",
+		"name",
+		"description"
+	]) if (result[key] !== void 0) lines.push(`- **${humanizeKey(key)}:** ${String(result[key])}`);
+	const backend = asRecord$2(result.backend);
+	if (backend?.type !== void 0) lines.push(`- **Backend:** \`${String(backend.type)}\``);
+	return lines.length > 0 ? lines.join("\n") : jsonFence(result);
+}
+function omitKeys(record, keys) {
+	const omitted = new Set(keys);
+	return Object.fromEntries(Object.entries(record).filter(([key]) => !omitted.has(key)));
+}
+function arrayValue(value) {
+	return Array.isArray(value) ? value : [];
+}
+function stringValue(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function humanizeKey(key) {
+	return key.replace(/([A-Z])/gu, " $1").replace(/^./u, (char) => char.toUpperCase());
 }
-function compactStructuredContent(value) {
-	return textContent(statusSummary(value));
+function asRecord$2(value) {
+	return isRecord(value) ? value : void 0;
+}
+function isRecord(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 //#endregion
 //#region src/tool-search.ts
@@ -222,7 +479,12 @@ var CliToolsManager = class {
 			const result = await spawnCommand(execution, controller.signal, () => Date.now() - startedAt);
 			const structured = parseStructuredResult(action, result, result.exitCode !== 0);
 			return {
-				content: compactStructuredContent(structured),
+				content: markdownStructuredContent(structured, {
+					title: `${config.name} call_tool ${toolName}`,
+					backend: "cli",
+					operation: "call_tool",
+					tool: toolName
+				}),
 				structuredContent: structured,
 				isError: result.exitCode !== 0
 			};
@@ -442,7 +704,7 @@ const ZodIssueCode$1 = {
 };
 /** @deprecated Do not use. Stub definition, only included for zod-to-json-schema compatibility. */
 var ZodFirstPartyTypeKind$1;
-(function(ZodFirstPartyTypeKind) {})(ZodFirstPartyTypeKind$1 || (ZodFirstPartyTypeKind$1 = {}));
+ZodFirstPartyTypeKind$1 || (ZodFirstPartyTypeKind$1 = {});
 //#endregion
 //#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/coerce.js
 function number(params) {
@@ -13201,7 +13463,7 @@ ZodEffects.createWithPreprocess;
 ZodPipeline.create;
 //#endregion
 //#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/mini/schemas.js
-const ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
+const ZodMiniType = /*@__PURE__*/ $constructor("ZodMiniType", (inst, def) => {
 	if (!inst._zod) throw new Error("Uninitialized schema in ZodMiniType.");
 	$ZodType.init(inst, def);
 	inst.def = def;
@@ -13229,12 +13491,12 @@ const ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
 	});
 	inst.apply = (fn) => fn(inst);
 });
-const ZodMiniObject = /* @__PURE__ */ $constructor("ZodMiniObject", (inst, def) => {
+const ZodMiniObject = /*@__PURE__*/ $constructor("ZodMiniObject", (inst, def) => {
 	$ZodObject.init(inst, def);
 	ZodMiniType.init(inst, def);
 	defineLazy(inst, "shape", () => def.shape);
 });
-/* @__NO_SIDE_EFFECTS__ */
+// @__NO_SIDE_EFFECTS__
 function object(shape, params) {
 	return new ZodMiniObject({
 		type: "object",
@@ -15702,7 +15964,7 @@ function parseStringDef(def, refs) {
 		case "toLowerCase":
 		case "toUpperCase":
 		case "trim": break;
-		default: ((_) => {})(check);
+		default:
 	}
 	return res;
 }
@@ -42654,7 +42916,12 @@ var GraphQLManager = class {
 				body
 			};
 			return {
-				content: compactStructuredContent(result),
+				content: markdownStructuredContent(result, {
+					title: `${endpoint.name} call_tool ${toolName}`,
+					backend: "graphql",
+					operation: "call_tool",
+					tool: toolName
+				}),
 				structuredContent: result,
 				isError: !response.ok || Boolean(body && typeof body === "object" && "errors" in body && body.errors)
 			};
@@ -43048,7 +43315,12 @@ var HttpActionManager = class {
 			});
 			const parsed = await readResponse$1(response, api, Date.now() - startedAt);
 			return {
-				content: compactStructuredContent(parsed),
+				content: markdownStructuredContent(parsed, {
+					title: `${api.name} call_tool ${toolName}`,
+					backend: "http",
+					operation: "call_tool",
+					tool: toolName
+				}),
 				structuredContent: parsed,
 				isError: !response.ok
 			};
@@ -52839,7 +53111,12 @@ var OpenApiManager = class {
 			});
 			const parsed = await readResponse(response);
 			return {
-				content: compactStructuredContent(parsed),
+				content: markdownStructuredContent(parsed, {
+					title: `${endpoint.name} call_tool ${toolName}`,
+					backend: "openapi",
+					operation: "call_tool",
+					tool: toolName
+				}),
 				structuredContent: parsed,
 				isError: response.ok ? false : true
 			};
@@ -53476,7 +53753,8 @@ async function handleServerTool(server, request, registry, downstream, openapi,
 			const tool = await backend.getTool(server, parsed.tool);
 			if (!tool.outputSchema) throw new CapletsError("REQUEST_INVALID", "Field selection requires an output schema");
 			validateFieldSelection(tool.outputSchema, parsed.fields);
-			return annotateCallToolResult(projectCallToolResult(await backend.callTool(server, parsed.tool, parsed.arguments), tool.outputSchema, parsed.fields), metadataFor(server, "call_tool", parsed.tool, startedAt));
+			const metadata = metadataFor(server, "call_tool", parsed.tool, startedAt);
+			return annotateCallToolResult(projectCallToolResult(await backend.callTool(server, parsed.tool, parsed.arguments), tool.outputSchema, parsed.fields, markdownContextFor(metadata)), metadata);
 		}
 		case "list_resources": {
 			const backend = mcpBackendFor(server, downstream);
@@ -53680,16 +53958,28 @@ function annotateMcpResult(result, metadata) {
 		}
 	};
 }
+function markdownContextFor(metadata) {
+	return {
+		title: [
+			metadata.name,
+			metadata.operation,
+			metadata.tool ?? metadata.uri ?? metadata.prompt
+		].filter(Boolean).join(" "),
+		backend: metadata.backend,
+		operation: metadata.operation,
+		...metadata.tool ? { tool: metadata.tool } : {},
+		...metadata.uri ? { uri: metadata.uri } : {},
+		...metadata.prompt ? { prompt: metadata.prompt } : {}
+	};
+}
 function jsonResult(value, metadata) {
+	const structuredContent = {
+		...metadata === void 0 ? {} : { caplets: metadata },
+		result: value
+	};
 	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(value, null, 2)
-		}],
-		structuredContent: {
-			...metadata === void 0 ? {} : { caplets: metadata },
-			result: value
-		}
+		content: markdownStructuredContent(structuredContent, metadata ? markdownContextFor(metadata) : { title: "Result" }),
+		structuredContent
 	};
 }
 function annotateCallToolResult(result, metadata) {
@@ -53702,20 +53992,21 @@ function annotateCallToolResult(result, metadata) {
 	};
 	return {
 		...result,
+		content: markdownCallToolResultContent(result, markdownContextFor(annotatedMetadata)),
 		_meta: {
 			...isPlainObject(existingMeta) ? existingMeta : {},
 			caplets: annotatedMetadata
 		}
 	};
 }
-function projectCallToolResult(result, outputSchema, fields) {
+function projectCallToolResult(result, outputSchema, fields, context = {}) {
 	if (result.isError === true) return result;
 	const structuredContent = result.structuredContent;
 	if (!isPlainObject(structuredContent)) throw new CapletsError("DOWNSTREAM_PROTOCOL_ERROR", "Field selection requires the downstream tool to return object structuredContent");
 	const projected = projectStructuredContent(structuredContent, outputSchema, fields);
 	return {
 		...result,
-		content: compactStructuredContent(projected),
+		content: markdownStructuredContent(projected, context),
 		structuredContent: projected
 	};
 }
@@ -54154,7 +54445,7 @@ var CapletsEngine = class {
 		}
 	}
 	async completeCliWords(words) {
-		const { completeCliWords } = await import("./completion-DRPTunQd.js").then((n) => n.r);
+		const { completeCliWords } = await import("./completion-DvWQk5qR.js").then((n) => n.r);
 		return await completeCliWords(words, {
 			config: this.registry.config,
 			managers: {
@@ -54494,4 +54785,4 @@ function hasEnv(value) {
 	return value !== void 0 && value.trim() !== "";
 }
 //#endregion
-export { assertCompleteRequestPrompt as $, CreateMessageResultSchema as A, CAPLETS_ERROR_CODES as At, JSONRPCMessageSchema as B, AjvJsonSchemaValidator as C, resolveCapletsRoot as Ct, CallToolRequestSchema as D, discoverCapletFiles as Dt, toJsonSchemaCompat as E, resolveProjectConfigPath as Et, EmptyResultSchema as F, __exportAll as Ft, ListRootsResultSchema as G, ListPromptsRequestSchema as H, ErrorCode as I, __require as It, McpError as J, ListToolsRequestSchema as K, GetPromptRequestSchema as L, __toESM as Lt, CreateTaskResultSchema as M, redactSecrets as Mt, DEFAULT_NEGOTIATED_PROTOCOL_VERSION as N, toSafeError as Nt, CallToolResultSchema as O, validateCapletFile as Ot, ElicitResultSchema as P, __commonJSMin as Pt, ToolListChangedNotificationSchema as Q, InitializeRequestSchema as R, assertToolsCallTaskCapability as S, DEFAULT_COMPLETION_CACHE_DIR as St, mergeCapabilities as T, resolveProjectCapletsRoot as Tt, ListResourceTemplatesRequestSchema as U, LATEST_PROTOCOL_VERSION as V, ListResourcesRequestSchema as W, SUPPORTED_PROTOCOL_VERSIONS as X, ReadResourceRequestSchema as Y, SetLevelRequestSchema as Z, StreamableHTTPClientTransport as _, loadGlobalConfig as _t, resolveCapletsServer as a, getLiteralValue as at, Client as b, parseConfig as bt, ServerRegistry as c, getSchemaDescription as ct, runOAuthFlow as d, normalizeObjectSchema as dt, assertCompleteRequestResourceTemplate as et, startGenericOAuthFlow as f, objectFromShape as ft, readTokenBundle as g, loadConfigWithSources as gt, isTokenBundleExpired as h, loadConfig as ht, resolveCapletsMode as i, isJSONRPCResultResponse as it, CreateMessageResultWithToolsSchema as j, CapletsError as jt, CompleteRequestSchema as k, SERVER_ID_PATTERN as kt, capabilityDescription as l, isSchemaOptional as lt, deleteTokenBundle as m, safeParseAsync as mt, mcpUrlForBase as n, isJSONRPCErrorResponse as nt, CapletsEngine as o, getObjectShape as ot, startOAuthFlow as p, safeParse as pt, LoggingLevelSchema as q, parseServerBaseUrl as r, isJSONRPCRequest as rt, handleServerTool as s, getParseErrorMessage as st, controlUrlForBase as t, isInitializeRequest as tt, runGenericOAuthFlow as u, isZ4Schema as ut, ReadBuffer as v, loadLocalOverlayConfigWithSources as vt, Protocol as w, resolveConfigPath as wt, assertClientRequestTaskCapability as x, DEFAULT_AUTH_DIR as xt, serializeMessage as y, loadProjectConfig as yt, InitializedNotificationSchema as z };
+export { assertCompleteRequestPrompt as $, CreateMessageResultSchema as A, hasRenderableStructuredContent as At, JSONRPCMessageSchema as B, __toESM as Bt, AjvJsonSchemaValidator as C, resolveCapletsRoot as Ct, CallToolRequestSchema as D, discoverCapletFiles as Dt, toJsonSchemaCompat as E, resolveProjectConfigPath as Et, EmptyResultSchema as F, redactSecrets as Ft, ListRootsResultSchema as G, ListPromptsRequestSchema as H, ErrorCode as I, toSafeError as It, McpError as J, ListToolsRequestSchema as K, GetPromptRequestSchema as L, __commonJSMin as Lt, CreateTaskResultSchema as M, markdownStructuredContent as Mt, DEFAULT_NEGOTIATED_PROTOCOL_VERSION as N, CAPLETS_ERROR_CODES as Nt, CallToolResultSchema as O, validateCapletFile as Ot, ElicitResultSchema as P, CapletsError as Pt, ToolListChangedNotificationSchema as Q, InitializeRequestSchema as R, __exportAll as Rt, assertToolsCallTaskCapability as S, DEFAULT_COMPLETION_CACHE_DIR as St, mergeCapabilities as T, resolveProjectCapletsRoot as Tt, ListResourceTemplatesRequestSchema as U, LATEST_PROTOCOL_VERSION as V, ListResourcesRequestSchema as W, SUPPORTED_PROTOCOL_VERSIONS as X, ReadResourceRequestSchema as Y, SetLevelRequestSchema as Z, StreamableHTTPClientTransport as _, loadGlobalConfig as _t, resolveCapletsServer as a, getLiteralValue as at, Client as b, parseConfig as bt, ServerRegistry as c, getSchemaDescription as ct, runOAuthFlow as d, normalizeObjectSchema as dt, assertCompleteRequestResourceTemplate as et, startGenericOAuthFlow as f, objectFromShape as ft, readTokenBundle as g, loadConfigWithSources as gt, isTokenBundleExpired as h, loadConfig as ht, resolveCapletsMode as i, isJSONRPCResultResponse as it, CreateMessageResultWithToolsSchema as j, markdownCallToolResultContent as jt, CompleteRequestSchema as k, SERVER_ID_PATTERN as kt, capabilityDescription as l, isSchemaOptional as lt, deleteTokenBundle as m, safeParseAsync as mt, mcpUrlForBase as n, isJSONRPCErrorResponse as nt, CapletsEngine as o, getObjectShape as ot, startOAuthFlow as p, safeParse as pt, LoggingLevelSchema as q, parseServerBaseUrl as r, isJSONRPCRequest as rt, handleServerTool as s, getParseErrorMessage as st, controlUrlForBase as t, isInitializeRequest as tt, runGenericOAuthFlow as u, isZ4Schema as ut, ReadBuffer as v, loadLocalOverlayConfigWithSources as vt, Protocol as w, resolveConfigPath as wt, assertClientRequestTaskCapability as x, DEFAULT_AUTH_DIR as xt, serializeMessage as y, loadProjectConfig as yt, InitializedNotificationSchema as z, __require as zt };