@caplets/core 0.18.6 → 0.18.7

package/dist/auth.d.ts

@@ -1,5 +1,5 @@
-import { type AuthResult, type OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
-import type { OAuthClientInformationMixed, OAuthClientMetadata, OAuthTokens } from "@modelcontextprotocol/sdk/shared/auth.js";
+import { type AuthResult, type OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth";
+import type { OAuthClientInformationMixed, OAuthClientMetadata, OAuthTokens } from "@modelcontextprotocol/sdk/shared/auth";
 import { type StoredOAuthTokenBundle } from "./auth/store";
 import type { CapletServerConfig } from "./config";
 import { CapletsError } from "./errors";

package/dist/caplet-sets.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 CapletSetConfig } from "./config";
 import { type CompactTool } from "./downstream";
 import { ServerRegistry } from "./registry";

package/dist/cli-tools.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 { CliToolsConfig } from "./config";
 import type { CompactTool } from "./downstream";
 import type { ServerRegistry } from "./registry";

package/dist/{completion-DRPTunQd.js → completion-B9niw4HY.js}

@@ -1,4 +1,4 @@
-import { Ct as resolveCapletsRoot, Et as resolveProjectConfigPath, Ft as __exportAll, St as DEFAULT_COMPLETION_CACHE_DIR, gt as loadConfigWithSources, jt as CapletsError, wt as resolveConfigPath, xt as DEFAULT_AUTH_DIR } from "./options-BlNyqF_E.js";
+import { Ct as resolveCapletsRoot, Et as resolveProjectConfigPath, Pt as CapletsError, Rt as __exportAll, St as DEFAULT_COMPLETION_CACHE_DIR, gt as loadConfigWithSources, wt as resolveConfigPath, xt as DEFAULT_AUTH_DIR } from "./options-CY6p-C9L.js";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { createHash } from "node:crypto";

package/dist/downstream.d.ts

@@ -1,4 +1,4 @@
-import { type Prompt, type Resource, type ResourceTemplate as McpResourceTemplate, type CompatibilityCallToolResult, type Tool } from "@modelcontextprotocol/sdk/types.js";
+import { type Prompt, type Resource, type ResourceTemplate as McpResourceTemplate, type CompatibilityCallToolResult, type Tool } from "@modelcontextprotocol/sdk/types";
 import type { CapletServerConfig } from "./config";
 import type { ServerRegistry } from "./registry";
 export type CompactTool = {

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/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 { $ 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-CY6p-C9L.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 { 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-B9niw4HY.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.7";
 //#endregion
 //#region src/serve/session.ts
 var CapletsMcpSession = class {
@@ -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,4 +1,4 @@
-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 { 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-CY6p-C9L.js";
 import { a as generatedToolInputJsonSchemaForCaplet, i as generatedToolInputJsonSchema, l as operations, o as generatedToolInputSchema } from "./generated-tool-input-schema-BYoyY-l-.js";
 //#region src/native/options.ts
 const DEFAULT_POLL_INTERVAL_MS = 3e4;

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-CY6p-C9L.js}

@@ -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 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 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 statusSummary(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return compactJsonText(value);
-	const record = value;
+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 [
-		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);
+		title === "# Result" || title === "# Error" ? "# Error" : title,
+		"",
+		`## ${code}`,
+		"",
+		message,
+		"",
+		"## Details",
+		"",
+		jsonFence(error ?? value)
+	].join("\n");
+}
+function isDiscoveryWrapper(value) {
+	return isRecord(value) && "result" in value;
+}
+function isErrorStructuredContent(value) {
+	return isRecord(value) && "error" in 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 compactStructuredContent(value) {
-	return textContent(statusSummary(value));
+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 [
+		"```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 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
 			};
@@ -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-B9niw4HY.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 };

package/dist/result-content.d.ts

@@ -1,14 +1,34 @@
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 export type TextContentBlock = {
     type: "text";
     text: string;
 };
+type ContentBlockLike = {
+    type: string;
+    text?: string;
+} & Record<string, unknown>;
+type CallToolResultLike = {
+    content?: ContentBlockLike[];
+    structuredContent?: unknown;
+    isError?: boolean | undefined;
+};
+export type ResultMarkdownContext = {
+    title?: string | undefined;
+    backend?: string | undefined;
+    operation?: string | undefined;
+    tool?: string | undefined;
+    uri?: string | undefined;
+    prompt?: string | undefined;
+    fields?: string[] | undefined;
+    isError?: boolean | undefined;
+};
 export declare function structuredOnlyContent(): [];
 export declare function textContent(text: string): TextContentBlock[];
 export declare function compactJsonText(value: unknown, maxLength?: number): string;
 export declare function compactText(value: string, maxLength?: number): string;
-export declare function resultKeys(value: unknown): string;
-export declare function statusSummary(value: unknown): string;
-export declare function compactStructuredContent(value: unknown): TextContentBlock[];
-export declare function compactCallToolResultContent(result: CallToolResult): TextContentBlock[];
+export declare function markdownStructuredContent(value: unknown, context?: ResultMarkdownContext): TextContentBlock[];
+export declare function markdownCallToolResultContent(result: CallToolResultLike, context?: ResultMarkdownContext): TextContentBlock[];
+export declare function compactStructuredContent(value: unknown, context?: ResultMarkdownContext): TextContentBlock[];
+export declare function compactCallToolResultContent(result: CallToolResultLike, context?: ResultMarkdownContext): TextContentBlock[];
+export declare function hasRenderableStructuredContent(value: unknown): boolean;
 export declare function byteLimitHint(maxBytes: number): string;
+export {};

package/dist/runtime.d.ts

@@ -1,4 +1,4 @@
-import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport";
 import type { CapletsConfig } from "./config";
 import { type ToolServer } from "./serve/session";
 type CapletsRuntimeOptions = {

package/dist/serve/session.d.ts

@@ -1,5 +1,5 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport";
 import type { CapletsEngine } from "../engine";
 export type ToolServer = Pick<McpServer, "registerTool" | "connect" | "close">;
 export type CapletsMcpSessionOptions = {

package/dist/tool-search.d.ts

@@ -1,2 +1,2 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { Tool } from "@modelcontextprotocol/sdk/types";
 export declare function searchToolList<T>(tools: Tool[], query: string, limit: number, compact: (tool: Tool) => T): T[];

package/dist/tools.d.ts

@@ -1,4 +1,4 @@
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types";
 import type { CapletSetManager } from "./caplet-sets";
 import type { CapletConfig } from "./config";
 import type { CliToolsManager } from "./cli-tools";
@@ -7,6 +7,7 @@ import type { GraphQLManager } from "./graphql";
 import type { HttpActionManager } from "./http-actions";
 import type { OpenApiManager } from "./openapi";
 import type { ServerRegistry } from "./registry";
+import { type ResultMarkdownContext } from "./result-content";
 export { generatedToolInputSchema } from "./generated-tool-input-schema";
 export type GeneratedServerToolRequest = RequiredOperationRequest;
 export declare function handleServerTool(server: CapletConfig, request: unknown, registry: ServerRegistry, downstream: DownstreamManager, openapi?: OpenApiManager, graphql?: GraphQLManager, http?: HttpActionManager, cli?: CliToolsManager, caplets?: CapletSetManager): Promise<any>;
@@ -81,5 +82,5 @@ export declare function metadataFor(server: CapletConfig, operation: RequiredOpe
 export declare function annotateMcpResult<T extends object>(result: T, metadata: CapletResultMetadata): T;
 export declare function jsonResult(value: unknown, metadata?: CapletResultMetadata): CallToolResult;
 export declare function annotateCallToolResult<T extends object>(result: T, metadata: CapletResultMetadata): T & CallToolResult;
-export declare function projectCallToolResult<T extends object>(result: T, outputSchema: unknown, fields: string[]): T & CallToolResult;
+export declare function projectCallToolResult<T extends object>(result: T, outputSchema: unknown, fields: string[], context?: ResultMarkdownContext): T & CallToolResult;
 export declare function extractArtifacts(result: unknown): CapletArtifact[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caplets/core",
-  "version": "0.18.6",
+  "version": "0.18.7",
   "description": "Core runtime library for Caplets progressive disclosure gateways.",
   "keywords": [
     "caplets",