caplets 0.17.6 → 0.17.7

package/dist/index.js

@@ -4709,7 +4709,7 @@ function generatedToolInputJsonSchema() {
 	return generatedToolInputJsonSchemaForCaplet({ backend: "tool" });
 }
 //#endregion
-//#region ../core/dist/options-BlNyqF_E.js
+//#region ../core/dist/options-CY6p-C9L.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -4805,13 +4805,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
 	};
 }
 function textContent(text) {
@@ -4820,33 +4833,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 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 hasRenderableStructuredContent(value) {
+	if (!isRecord$1(value)) return false;
+	return Object.keys(value).some((key) => key !== "caplets" && key !== "elapsedMs");
 }
-function statusSummary(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return compactJsonText(value);
-	const record = value;
+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 [
-		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);
-}
-function compactStructuredContent(value) {
-	return textContent(statusSummary(value));
+		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$1(value) && "result" in value;
+}
+function isErrorStructuredContent(value) {
+	return isRecord$1(value) && "error" in value;
+}
+function isHttpLikeResult(value) {
+	return isRecord$1(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$1(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$1(value) ? value : void 0;
+}
+function isRecord$1(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function searchToolList(tools, query, limit, compact) {
 	const tokens = query.toLocaleLowerCase().split(/\s+/).filter(Boolean);
@@ -4913,7 +5170,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
 			};
@@ -46622,7 +46884,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)
 			};
@@ -47014,7 +47281,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
 			};
@@ -56623,7 +56895,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
 			};
@@ -57252,7 +57529,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);
@@ -57456,16 +57734,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) {
@@ -57478,20 +57768,21 @@ function annotateCallToolResult(result, metadata) {
 	};
 	return {
 		...result,
+		content: markdownCallToolResultContent(result, markdownContextFor(annotatedMetadata)),
 		_meta: {
 			...isPlainObject$7(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$7(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
 	};
 }
@@ -57926,7 +58217,7 @@ var CapletsEngine = class {
 		}
 	}
 	async completeCliWords(words) {
-		const { completeCliWords } = await Promise.resolve().then(() => completion_DRPTunQd_exports).then((n) => n.r);
+		const { completeCliWords } = await Promise.resolve().then(() => completion_B9niw4HY_exports).then((n) => n.r);
 		return await completeCliWords(words, {
 			config: this.registry.config,
 			managers: {
@@ -58264,8 +58555,8 @@ function hasEnv$1(value) {
 	return value !== void 0 && value.trim() !== "";
 }
 //#endregion
-//#region ../core/dist/completion-DRPTunQd.js
-var completion_DRPTunQd_exports = /* @__PURE__ */ __exportAll$1({
+//#region ../core/dist/completion-B9niw4HY.js
+var completion_B9niw4HY_exports = /* @__PURE__ */ __exportAll$1({
 	a: () => formatCapletList,
 	c: () => resolveCliConfigPaths,
 	i: () => trailingSpaceCompletionToken,
@@ -60129,7 +60420,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 	values: [],
 	hasMore: false
 } };
-var version$1 = "0.18.6";
+var version$1 = "0.18.7";
 var CapletsMcpSession = class {
 	engine;
 	server;
@@ -69403,7 +69694,7 @@ function writeAddResult(writeOut, label, result) {
 }
 //#endregion
 //#region package.json
-var version = "0.17.6";
+var version = "0.17.7";
 //#endregion
 //#region src/index.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caplets",
-  "version": "0.17.6",
+  "version": "0.17.7",
   "description": "Progressive disclosure gateway CLI for MCP servers and native Caplets adapters.",
   "keywords": [
     "caplets",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@caplets/core": "0.18.6"
+    "@caplets/core": "0.18.7"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",