caplets 0.12.7 → 0.13.0

package/README.md

@@ -68,6 +68,18 @@ Connect Caplets to any MCP client:
 Ask your agent to use Caplets. It will see a compact capability list first, then inspect
 only the backend it needs.
 
+You can also invoke configured Caplets directly from the CLI for agent-friendly scripts and smoke tests:
+
+```sh
+caplets get-caplet context7
+caplets list-tools context7
+caplets get-tool context7.resolve-library-id
+caplets call-tool context7.resolve-library-id --args '{"libraryName":"react"}'
+caplets call-tool context7.resolve-library-id --args '{"libraryName":"react"}' --field result.id --format json
+```
+
+Direct CLI operation commands print Markdown summaries by default. Add `--format plain` for plain text or `--format json` for machine-readable JSON (`md` is accepted as an alias for `markdown`). If a downstream tool returns `isError: true`, Caplets still exits with status code 1.
+
 ## Agent Plugins
 
 Use Caplets as a normal MCP server everywhere, or install a native agent integration when
@@ -610,7 +622,10 @@ shell snippets.
       "description": "Fetch status for one service.",
       "inputSchema": {
         "type": "object",
-        "properties": { "service": { "type": "string" }, "verbose": { "type": "boolean" } },
+        "properties": {
+          "service": { "type": "string" },
+          "verbose": { "type": "boolean" }
+        },
         "required": ["service"]
       },
       "query": { "verbose": "$input.verbose" }
@@ -693,7 +708,7 @@ an existing destination file.
 
 Use `capletSets` to expose another Caplets collection as nested Caplets. Each child Caplet appears
 as one downstream tool and supports the full Caplets operation set: `get_caplet`, `check_backend`,
-`check_mcp_server`, `list_tools`, `search_tools`, `get_tool`, and `call_tool`.
+`list_tools`, `search_tools`, `get_tool`, and `call_tool`.
 
 ```json
 {
@@ -891,7 +906,6 @@ Available operations:
 
 - `get_caplet`: return the configured capability card without starting the downstream server.
 - `check_backend`: verify the selected backend, whether MCP, OpenAPI, GraphQL, HTTP, CLI, or nested Caplets.
-- `check_mcp_server`: start or connect to an MCP server and verify its tool list.
 - `list_tools`: return compact downstream tool metadata.
 - `search_tools`: search downstream tool names and descriptions within this Caplet.
 - `get_tool`: return full metadata for one exact downstream tool.

package/dist/index.js

@@ -180,7 +180,7 @@ const allowsEval = /* @__PURE__ */ cached(() => {
 		return false;
 	}
 });
-function isPlainObject$7(o) {
+function isPlainObject$8(o) {
 	if (isObject(o) === false) return false;
 	const ctor = o.constructor;
 	if (ctor === void 0) return true;
@@ -191,7 +191,7 @@ function isPlainObject$7(o) {
 	return true;
 }
 function shallowClone(o) {
-	if (isPlainObject$7(o)) return { ...o };
+	if (isPlainObject$8(o)) return { ...o };
 	if (Array.isArray(o)) return [...o];
 	if (o instanceof Map) return new Map(o);
 	if (o instanceof Set) return new Set(o);
@@ -274,7 +274,7 @@ function omit(schema, mask) {
 	}));
 }
 function extend(schema, shape) {
-	if (!isPlainObject$7(shape)) throw new Error("Invalid input to extend: expected a plain object");
+	if (!isPlainObject$8(shape)) throw new Error("Invalid input to extend: expected a plain object");
 	const checks = schema._zod.def.checks;
 	if (checks && checks.length > 0) {
 		const existingShape = schema._zod.def.shape;
@@ -290,7 +290,7 @@ function extend(schema, shape) {
 	} }));
 }
 function safeExtend(schema, shape) {
-	if (!isPlainObject$7(shape)) throw new Error("Invalid input to safeExtend: expected a plain object");
+	if (!isPlainObject$8(shape)) throw new Error("Invalid input to safeExtend: expected a plain object");
 	return clone(schema, mergeDefs(schema._zod.def, { get shape() {
 		const _shape = {
 			...schema._zod.def.shape,
@@ -1904,7 +1904,7 @@ function mergeValues$1(a, b) {
 		valid: true,
 		data: a
 	};
-	if (isPlainObject$7(a) && isPlainObject$7(b)) {
+	if (isPlainObject$8(a) && isPlainObject$8(b)) {
 		const bKeys = Object.keys(b);
 		const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
 		const newObj = {
@@ -1980,7 +1980,7 @@ const $ZodRecord = /* @__PURE__ */ $constructor("$ZodRecord", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload, ctx) => {
 		const input = payload.value;
-		if (!isPlainObject$7(input)) {
+		if (!isPlainObject$8(input)) {
 			payload.issues.push({
 				expected: "record",
 				code: "invalid_type",
@@ -12268,7 +12268,7 @@ var Protocol = class {
 		};
 	}
 };
-function isPlainObject$6(value) {
+function isPlainObject$7(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function mergeCapabilities(base, additional) {
@@ -12278,7 +12278,7 @@ function mergeCapabilities(base, additional) {
 		const addValue = additional[k];
 		if (addValue === void 0) continue;
 		const baseValue = result[k];
-		if (isPlainObject$6(baseValue) && isPlainObject$6(addValue)) result[k] = {
+		if (isPlainObject$7(baseValue) && isPlainObject$7(addValue)) result[k] = {
 			...baseValue,
 			...addValue
 		};
@@ -19930,7 +19930,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 } };
 //#endregion
 //#region ../core/package.json
-var version$1 = "0.13.1";
+var version$1 = "0.14.0";
 //#endregion
 //#region ../../node_modules/.pnpm/unist-util-stringify-position@4.0.0/node_modules/unist-util-stringify-position/lib/index.js
 /**
@@ -27877,19 +27877,19 @@ function loadCapletFilesWithPaths(root) {
 		if (servers[candidate.id] || openapiEndpoints[candidate.id] || graphqlEndpoints[candidate.id] || httpApis[candidate.id] || cliTools[candidate.id] || capletSets[candidate.id]) throw new CapletsError("CONFIG_INVALID", `Duplicate Caplet ID ${candidate.id} under ${root}`);
 		paths[candidate.id] = candidate.path;
 		const config = readCapletFile(candidate.path);
-		if (isPlainObject$5(config) && config.backend === "openapi") {
+		if (isPlainObject$6(config) && config.backend === "openapi") {
 			const { backend: _backend, ...endpoint } = config;
 			openapiEndpoints[candidate.id] = endpoint;
-		} else if (isPlainObject$5(config) && config.backend === "graphql") {
+		} else if (isPlainObject$6(config) && config.backend === "graphql") {
 			const { backend: _backend, ...endpoint } = config;
 			graphqlEndpoints[candidate.id] = endpoint;
-		} else if (isPlainObject$5(config) && config.backend === "http") {
+		} else if (isPlainObject$6(config) && config.backend === "http") {
 			const { backend: _backend, ...endpoint } = config;
 			httpApis[candidate.id] = endpoint;
-		} else if (isPlainObject$5(config) && config.backend === "cli") {
+		} else if (isPlainObject$6(config) && config.backend === "cli") {
 			const { backend: _backend, ...endpoint } = config;
 			cliTools[candidate.id] = endpoint;
-		} else if (isPlainObject$5(config) && config.backend === "caplets") {
+		} else if (isPlainObject$6(config) && config.backend === "caplets") {
 			const { backend: _backend, ...endpoint } = config;
 			capletSets[candidate.id] = endpoint;
 		} else servers[candidate.id] = config;
@@ -28043,7 +28043,7 @@ function parseFrontmatter(text, path) {
 			value: text
 		});
 		matter(file, { strip: true });
-		if (!isPlainObject$5(file.data.matter) || Object.keys(file.data.matter).length === 0) throw new Error("empty frontmatter");
+		if (!isPlainObject$6(file.data.matter) || Object.keys(file.data.matter).length === 0) throw new Error("empty frontmatter");
 		return {
 			frontmatter: file.data.matter,
 			body: String(file)
@@ -28052,7 +28052,7 @@ function parseFrontmatter(text, path) {
 		throw new CapletsError("CONFIG_INVALID", `Caplet file at ${path} has invalid YAML frontmatter`, redactSecrets(error));
 	}
 }
-function isPlainObject$5(value) {
+function isPlainObject$6(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function validateCapletId(id, path) {
@@ -28673,7 +28673,7 @@ function normalizeLocalPaths(input, baseDir) {
 }
 function normalizeEndpointPaths(endpoints, baseDir, normalize) {
 	if (!endpoints) return;
-	return Object.fromEntries(Object.entries(endpoints).map(([id, endpoint]) => [id, isPlainObject$4(endpoint) ? normalize(endpoint, baseDir) : endpoint]));
+	return Object.fromEntries(Object.entries(endpoints).map(([id, endpoint]) => [id, isPlainObject$5(endpoint) ? normalize(endpoint, baseDir) : endpoint]));
 }
 function normalizeOpenApiPath(endpoint, baseDir) {
 	return {
@@ -28682,7 +28682,7 @@ function normalizeOpenApiPath(endpoint, baseDir) {
 	};
 }
 function normalizeGraphQlPath(endpoint, baseDir) {
-	const operations = isPlainObject$4(endpoint.operations) ? Object.fromEntries(Object.entries(endpoint.operations).map(([name, operation]) => [name, isPlainObject$4(operation) ? {
+	const operations = isPlainObject$5(endpoint.operations) ? Object.fromEntries(Object.entries(endpoint.operations).map(([name, operation]) => [name, isPlainObject$5(operation) ? {
 		...operation,
 		documentPath: normalizeLocalPath(operation.documentPath, baseDir)
 	} : operation])) : endpoint.operations;
@@ -28693,7 +28693,7 @@ function normalizeGraphQlPath(endpoint, baseDir) {
 	};
 }
 function normalizeCliToolsPaths(endpoint, baseDir) {
-	const actions = isPlainObject$4(endpoint.actions) ? Object.fromEntries(Object.entries(endpoint.actions).map(([name, action]) => [name, isPlainObject$4(action) ? {
+	const actions = isPlainObject$5(endpoint.actions) ? Object.fromEntries(Object.entries(endpoint.actions).map(([name, action]) => [name, isPlainObject$5(action) ? {
 		...action,
 		cwd: normalizeLocalPath(action.cwd, baseDir)
 	} : action])) : endpoint.actions;
@@ -28896,7 +28896,7 @@ function isPublicMetadataPath(path) {
 	if (path.length < 3 || path[0] !== "mcpServers" && path[0] !== "openapiEndpoints" && path[0] !== "graphqlEndpoints" && path[0] !== "httpApis" && path[0] !== "cliTools" && path[0] !== "capletSets") return false;
 	return NON_INTERPOLATED_SERVER_FIELDS.has(path[2] ?? "");
 }
-function isPlainObject$4(value) {
+function isPlainObject$5(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function hasEnvReference(value) {
@@ -29066,9 +29066,9 @@ function validateInput(action, input) {
 	if (!schema) return;
 	const required = Array.isArray(schema.required) ? schema.required : [];
 	for (const key of required) if (typeof key === "string" && (input[key] === void 0 || input[key] === null)) throw new CapletsError("REQUEST_INVALID", `CLI tool ${action.name} requires input ${key}`);
-	const properties = isPlainObject$3(schema.properties) ? schema.properties : {};
+	const properties = isPlainObject$4(schema.properties) ? schema.properties : {};
 	for (const [key, property] of Object.entries(properties)) {
-		if (input[key] === void 0 || !isPlainObject$3(property) || typeof property.type !== "string") continue;
+		if (input[key] === void 0 || !isPlainObject$4(property) || typeof property.type !== "string") continue;
 		if (!matchesJsonType(input[key], property.type)) throw new CapletsError("REQUEST_INVALID", `CLI tool ${action.name} input ${key} must be ${property.type}`);
 	}
 }
@@ -29078,7 +29078,7 @@ function matchesJsonType(value, type) {
 		case "number":
 		case "integer": return typeof value === "number" && (type === "number" || Number.isInteger(value));
 		case "boolean": return typeof value === "boolean";
-		case "object": return isPlainObject$3(value);
+		case "object": return isPlainObject$4(value);
 		case "array": return Array.isArray(value);
 		case "null": return value === null;
 		default: return true;
@@ -29169,7 +29169,7 @@ function isExecutable(path) {
 function isAbortError$1(error) {
 	return error instanceof Error && error.name === "AbortError";
 }
-function isPlainObject$3(value) {
+function isPlainObject$4(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 //#endregion
@@ -48425,7 +48425,7 @@ function resolveMapping(mapping, input) {
 function resolveMappingToRecord(mapping, input, name) {
 	if (mapping === void 0) return {};
 	const resolved = resolveMapping(mapping, input);
-	if (!isPlainObject$2(resolved)) throw new CapletsError("REQUEST_INVALID", `HTTP action ${name} mapping must resolve to an object`);
+	if (!isPlainObject$3(resolved)) throw new CapletsError("REQUEST_INVALID", `HTTP action ${name} mapping must resolve to an object`);
 	return resolved;
 }
 function valueAtPath(input, path) {
@@ -48520,9 +48520,9 @@ function buildActionUrl(base, actionPath, options = {}) {
 	return baseUrl;
 }
 function asRecord$1(value) {
-	return isPlainObject$2(value) ? value : {};
+	return isPlainObject$3(value) ? value : {};
 }
-function isPlainObject$2(value) {
+function isPlainObject$3(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 //#endregion
@@ -58455,14 +58455,12 @@ function openApiCacheKey(endpoint) {
 //#endregion
 //#region ../core/src/capability-description.ts
 function capabilityDescription(server) {
-	const backendName = server.backend === "mcp" ? "MCP server" : server.backend === "openapi" ? "OpenAPI endpoint" : server.backend === "graphql" ? "GraphQL endpoint" : server.backend === "http" ? "HTTP API" : server.backend === "cli" ? "CLI tools" : server.backend === "caplets" ? "nested Caplets" : "backend";
-	const checkOperation = server.backend === "mcp" ? "check_mcp_server" : "check_backend";
 	const hint = [
-		`Use this Caplet to inspect and call tools from its ${backendName} backend.`,
+		`Use this Caplet to inspect and call tools from its ${server.backend === "mcp" ? "MCP server" : server.backend === "openapi" ? "OpenAPI endpoint" : server.backend === "graphql" ? "GraphQL endpoint" : server.backend === "http" ? "HTTP API" : server.backend === "cli" ? "CLI tools" : server.backend === "caplets" ? "nested Caplets" : "backend"} backend.`,
 		"",
 		"Recommended flow:",
 		"- Read the full Caplet card: {\"operation\":\"get_caplet\"}",
-		`- Check the backend: {"operation":"${checkOperation}"}`,
+		"- Check the backend: {\"operation\":\"check_backend\"}",
 		"- Discover tools: {\"operation\":\"list_tools\"} or {\"operation\":\"search_tools\",\"query\":\"<what you need>\"}",
 		"- Read one tool schema: {\"operation\":\"get_tool\",\"tool\":\"<tool name>\"}",
 		"- Invoke one downstream tool: {\"operation\":\"call_tool\",\"tool\":\"<tool name>\",\"arguments\":{...}}",
@@ -58599,7 +58597,6 @@ function graphQlSource(server) {
 const operations = [
 	"get_caplet",
 	"check_backend",
-	"check_mcp_server",
 	"list_tools",
 	"search_tools",
 	"get_tool",
@@ -58608,7 +58605,7 @@ const operations = [
 const generatedToolInputDescriptions = {
 	operation: [
 		"Caplets wrapper operation to perform for this configured Caplet backend.",
-		"Use get_caplet to read the full Caplet card, check_backend to check any backend, check_mcp_server to check an MCP backend, list_tools or search_tools to discover downstream tools, get_tool to read a downstream input schema, and call_tool to run one downstream tool, operation, action, CLI command, or child Caplet.",
+		"Use get_caplet to read the full Caplet card, check_backend to check backend availability, list_tools or search_tools to discover downstream tools, get_tool to read a downstream input schema, and call_tool to run one downstream tool, operation, action, CLI command, or child Caplet.",
 		"For call_tool, pass downstream inputs only inside the top-level \"arguments\" object."
 	].join(" "),
 	query: "Required only for search_tools. Example: {\"operation\":\"search_tools\",\"query\":\"web search\",\"limit\":5}. Do not use query for call_tool; put downstream query values under arguments.query.",
@@ -58661,7 +58658,7 @@ function generatedToolInputJsonSchema() {
 //#region ../core/src/field-selection.ts
 function projectStructuredContent(value, outputSchema, fields) {
 	validateFieldSelection(outputSchema, fields);
-	if (!isPlainObject$1(value)) throwInvalid("Field selection requires object structured content");
+	if (!isPlainObject$2(value)) throwInvalid("Field selection requires object structured content");
 	const result = createJsonObject();
 	for (const field of fields) {
 		const projected = projectPath(value, outputSchema, field.split("."));
@@ -58670,7 +58667,7 @@ function projectStructuredContent(value, outputSchema, fields) {
 	return result;
 }
 function validateFieldSelection(outputSchema, fields) {
-	if (!isPlainObject$1(outputSchema)) throwInvalid("Field selection requires an output schema");
+	if (!isPlainObject$2(outputSchema)) throwInvalid("Field selection requires an output schema");
 	if (!Array.isArray(fields) || fields.some((field) => typeof field !== "string")) throwInvalid("Field selection requires an array of field paths");
 	for (const field of fields) validateSchemaPath(outputSchema, field.split("."), field);
 }
@@ -58694,7 +58691,7 @@ function projectPath(value, schema, path) {
 		return value.map((item) => projectPath(item, itemSchema, path) ?? {});
 	}
 	const segment = path[0];
-	if (!isPlainObject$1(value) || !Object.prototype.hasOwnProperty.call(value, segment)) return;
+	if (!isPlainObject$2(value) || !Object.prototype.hasOwnProperty.call(value, segment)) return;
 	const rest = path.slice(1);
 	const propertySchema = getSchemaProperty(schema, segment);
 	const projected = projectPath(value[segment], propertySchema, rest);
@@ -58706,24 +58703,24 @@ function pruneToSchema(value, schema) {
 		const itemSchema = arrayItemSchema(schema);
 		return value.map((item) => pruneToSchema(item, itemSchema));
 	}
-	if (!isPlainObject$1(value)) return cloneJsonValue(value);
-	const properties = isPlainObject$1(schema) ? schema.properties : void 0;
-	if (!isPlainObject$1(properties)) return cloneJsonValue(value);
+	if (!isPlainObject$2(value)) return cloneJsonValue(value);
+	const properties = isPlainObject$2(schema) ? schema.properties : void 0;
+	if (!isPlainObject$2(properties)) return cloneJsonValue(value);
 	const result = createJsonObject();
 	for (const [key, nestedSchema] of Object.entries(properties)) if (isSupportedSegment(key) && Object.prototype.hasOwnProperty.call(value, key)) result[key] = pruneToSchema(value[key], nestedSchema);
 	return result;
 }
 function getSchemaProperty(schema, segment) {
-	const properties = isPlainObject$1(schema) ? schema.properties : void 0;
+	const properties = isPlainObject$2(schema) ? schema.properties : void 0;
 	if (!properties || !Object.prototype.hasOwnProperty.call(properties, segment)) return;
 	return properties[segment];
 }
 function arrayItemSchema(schema) {
-	if (!isPlainObject$1(schema) || Array.isArray(schema.items)) return;
+	if (!isPlainObject$2(schema) || Array.isArray(schema.items)) return;
 	return schema.items;
 }
 function mergeValue(target, value) {
-	if (!isPlainObject$1(value)) return;
+	if (!isPlainObject$2(value)) return;
 	for (const [key, nested] of Object.entries(value)) {
 		if (!isSupportedSegment(key)) continue;
 		target[key] = mergeNested(target[key], nested);
@@ -58732,7 +58729,7 @@ function mergeValue(target, value) {
 function mergeNested(existing, next) {
 	if (next === void 0) return existing;
 	if (Array.isArray(existing) && Array.isArray(next)) return Array.from({ length: Math.max(existing.length, next.length) }, (_, index) => mergeNested(existing[index], next[index]));
-	if (isPlainObject$1(existing) && isPlainObject$1(next)) {
+	if (isPlainObject$2(existing) && isPlainObject$2(next)) {
 		const merged = Object.assign(createJsonObject(), existing);
 		mergeValue(merged, next);
 		return merged;
@@ -58742,7 +58739,7 @@ function mergeNested(existing, next) {
 function isSupportedSegment(segment) {
 	return segment !== "" && segment !== "*" && segment !== "__proto__" && segment !== "prototype" && segment !== "constructor" && !/^\d+$/.test(segment);
 }
-function isPlainObject$1(value) {
+function isPlainObject$2(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function createJsonObject() {
@@ -58750,7 +58747,7 @@ function createJsonObject() {
 }
 function cloneJsonValue(value) {
 	if (Array.isArray(value)) return value.map(cloneJsonValue);
-	if (isPlainObject$1(value)) {
+	if (isPlainObject$2(value)) {
 		const result = createJsonObject();
 		for (const [key, nested] of Object.entries(value)) if (isSupportedSegment(key)) result[key] = cloneJsonValue(nested);
 		return result;
@@ -58773,9 +58770,6 @@ async function handleServerTool(server, request, registry, downstream, openapi,
 	switch (parsed.operation) {
 		case "get_caplet": return jsonResult(registry.detail(server));
 		case "check_backend": return jsonResult(await backendFor(server, downstream, openapi, graphql, http, cli, caplets).check(server));
-		case "check_mcp_server":
-			if (server.backend !== "mcp") throw new CapletsError("REQUEST_INVALID", "check_mcp_server is only valid for MCP-backed Caplets; use check_backend");
-			return jsonResult(await downstream.checkServer(server));
 		case "list_tools": {
 			const backend = backendFor(server, downstream, openapi, graphql, http, cli, caplets);
 			const tools = await backend.listTools(server);
@@ -58826,7 +58820,6 @@ function validateOperationRequest(request, maxSearchLimit) {
 	switch (value.operation) {
 		case "get_caplet":
 		case "check_backend":
-		case "check_mcp_server":
 		case "list_tools":
 			allowed([]);
 			return { operation: value.operation };
@@ -58856,7 +58849,7 @@ function validateOperationRequest(request, maxSearchLimit) {
 				"fields"
 			]);
 			if (!value.tool) throw new CapletsError("REQUEST_INVALID", "call_tool requires tool");
-			if (!isPlainObject(value.arguments)) throw new CapletsError("REQUEST_INVALID", "call_tool.arguments must be a JSON object");
+			if (!isPlainObject$1(value.arguments)) throw new CapletsError("REQUEST_INVALID", "call_tool.arguments must be a JSON object");
 			return value.fields === void 0 ? {
 				operation: "call_tool",
 				tool: value.tool,
@@ -58877,7 +58870,7 @@ function jsonResult(value) {
 	return {
 		content: [{
 			type: "text",
-			text: JSON.stringify(value, null, 2)
+			text: "Result available in structuredContent.result."
 		}],
 		structuredContent: { result: value }
 	};
@@ -58885,7 +58878,7 @@ function jsonResult(value) {
 function projectCallToolResult(result, outputSchema, fields) {
 	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");
+	if (!isPlainObject$1(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,
@@ -58896,7 +58889,7 @@ function projectCallToolResult(result, outputSchema, fields) {
 		structuredContent: projected
 	};
 }
-function isPlainObject(value) {
+function isPlainObject$1(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function backendFor(server, downstream, openapi, graphql, http, cli, caplets) {
@@ -62992,7 +62985,7 @@ async function loginAuth(serverId, options) {
 		};
 		if (server.backend === "mcp") await runOAuthFlow(server, flowOptions);
 		else await runGenericOAuthFlow(server, flowOptions);
-		options.writeOut(`Authenticated ${serverId}\n`);
+		options.writeOut(`Authenticated \`${serverId}\`.\n`);
 	} catch (error) {
 		options.writeErr(`${JSON.stringify(toSafeError(error, "AUTH_FAILED"), null, 2)}\n`);
 		process.exitCode = 1;
@@ -63000,25 +62993,47 @@ async function loginAuth(serverId, options) {
 }
 function logoutAuth(serverId, options) {
 	assertLoginTarget(findAuthTarget(serverId, loadConfig(options.configPath)), serverId);
-	if (deleteTokenBundle(serverId, options.authDir)) options.writeOut(`Deleted OAuth credentials for ${serverId}\n`);
-	else options.writeOut(`No OAuth credentials found for ${serverId}\n`);
+	if (deleteTokenBundle(serverId, options.authDir)) options.writeOut(`Deleted OAuth credentials for \`${serverId}\`.\n`);
+	else options.writeOut(`No OAuth credentials found for \`${serverId}\`.\n`);
 }
 function listAuth(options) {
 	const servers = authTargets(loadConfig(options.configPath)).sort((left, right) => left.server.localeCompare(right.server));
+	const format = options.format ?? "plain";
+	if (format === "json") {
+		const rows = servers.map((server) => {
+			const bundle = readTokenBundle(server.server, options.authDir);
+			const status = !bundle ? "missing" : isTokenBundleExpired(bundle) ? "expired" : "authenticated";
+			return {
+				server: server.server,
+				status,
+				...bundle?.expiresAt ? { expiresAt: bundle.expiresAt } : {},
+				...bundle?.scope ? { scope: bundle.scope } : {}
+			};
+		});
+		options.writeOut(`${JSON.stringify(rows, null, 2)}\n`);
+		return;
+	}
 	if (servers.length === 0) {
-		options.writeOut("No configured remote OAuth servers found.\n");
+		options.writeOut(format === "markdown" ? "## OAuth credentials\n\nNo configured remote OAuth servers found.\n" : "No configured remote OAuth servers found.\n");
 		return;
 	}
+	if (format === "markdown") options.writeOut("## OAuth credentials\n\n");
+	else options.writeOut("OAuth credentials\n\n");
 	for (const server of servers) {
 		const bundle = readTokenBundle(server.server, options.authDir);
 		const status = !bundle ? "missing" : isTokenBundleExpired(bundle) ? "expired" : "authenticated";
+		const details = [bundle?.expiresAt ? `expires ${bundle.expiresAt}` : void 0, bundle?.scope ? `scope ${bundle.scope}` : void 0].filter(Boolean).join("; ");
+		if (format === "markdown") {
+			options.writeOut(`- \`${server.server}\` — ${status}${details ? ` (${details})` : ""}\n`);
+			continue;
+		}
 		options.writeOut([
 			server.server,
-			status,
-			bundle?.expiresAt ? `expires ${bundle.expiresAt}` : void 0,
-			bundle?.scope ? `scope ${bundle.scope}` : void 0
-		].filter(Boolean).join("	"));
-		options.writeOut("\n");
+			`  Status: ${status}`,
+			...bundle?.expiresAt ? [`  Expires: ${bundle.expiresAt}`] : [],
+			...bundle?.scope ? [`  Scope: ${bundle.scope}`] : []
+		].join("\n"));
+		options.writeOut("\n\n");
 	}
 }
 function findAuthTarget(serverId, config = loadConfig()) {
@@ -63118,24 +63133,49 @@ function allCaplets(config) {
 		...Object.values(config.cliTools)
 	];
 }
-function formatCapletList(rows) {
+function formatCapletList(rows, format = "plain") {
+	return format === "markdown" ? formatCapletListMarkdown(rows) : formatCapletListPlain(rows);
+}
+function formatCapletListMarkdown(rows) {
+	if (rows.length === 0) return "## Configured Caplets\n\nNo configured Caplets found.\n";
+	const heading = [
+		"## Configured Caplets",
+		"",
+		`${rows.length} ${rows.length === 1 ? "Caplet" : "Caplets"} shown.`,
+		""
+	];
+	const entries = rows.flatMap((row) => [
+		`- \`${row.server}\` — ${row.name}`,
+		`  - Backend: ${row.backend}`,
+		`  - Status: ${row.status}`,
+		`  - Source: ${row.source}`,
+		...row.disabled ? ["  - Disabled: true"] : [],
+		...row.path ? [`  - Path: ${row.path}`] : []
+	]);
+	const warnings = rows.flatMap((row) => row.shadows.map((shadow) => `Warning: ${formatSourceKind(row.source)} Caplet ${row.server} shadows ${formatSourceKind(shadow.kind)} Caplet at ${shadow.path}`));
+	if (warnings.length === 0) return `${[...heading, ...entries].join("\n")}\n`;
+	return `${[
+		...heading,
+		...entries,
+		"",
+		"Warnings:",
+		...warnings.map((warning) => `- ${warning}`)
+	].join("\n")}\n`;
+}
+function formatCapletListPlain(rows) {
 	if (rows.length === 0) return "No configured Caplets found.\n";
-	const table = formatTable([[
-		"server",
-		"backend",
-		"status",
-		"source",
-		"name"
-	], ...rows.map((row) => [
+	const entries = rows.map((row) => [
 		row.server,
-		row.backend,
-		row.status,
-		row.source,
-		row.name
-	])]);
+		`  Name: ${row.name}`,
+		`  Backend: ${row.backend}`,
+		`  Status: ${row.status}`,
+		`  Source: ${row.source}`,
+		...row.disabled ? ["  Disabled: true"] : [],
+		...row.path ? [`  Path: ${row.path}`] : []
+	].join("\n")).join("\n\n");
 	const warnings = rows.flatMap((row) => row.shadows.map((shadow) => `Warning: ${formatSourceKind(row.source)} Caplet ${row.server} shadows ${formatSourceKind(shadow.kind)} Caplet at ${shadow.path}`));
-	if (warnings.length === 0) return `${table}\n`;
-	return `${table}\n${warnings.join("\n")}\n`;
+	if (warnings.length === 0) return `Configured Caplets (${rows.length})\n\n${entries}\n`;
+	return `Configured Caplets (${rows.length})\n\n${entries}\n\n${warnings.join("\n")}\n`;
 }
 function formatSourceKind(kind) {
 	if (kind.startsWith("project")) return "project";
@@ -63155,28 +63195,35 @@ function resolveCliConfigPaths(envConfigPath, authDir) {
 		envConfig: envConfigPath ?? null
 	};
 }
-function formatConfigPaths(paths) {
+function formatConfigPaths(paths, format = "plain") {
+	if (format === "markdown") return formatConfigPathsMarkdown(paths);
+	return formatConfigPathsPlain(paths);
+}
+function formatConfigPathsMarkdown(paths) {
 	return [
-		`userConfig: ${paths.userConfig}`,
-		`projectConfig: ${paths.projectConfig}`,
-		`userRoot: ${paths.userRoot}`,
-		`stateRoot: ${paths.stateRoot}`,
-		`projectRoot: ${paths.projectRoot}`,
-		`authDir: ${paths.authDir}`,
-		`envConfig: ${paths.envConfig ?? "unset"}`
+		"## Caplets paths",
+		"",
+		`- User config: ${paths.userConfig}`,
+		`- Project config: ${paths.projectConfig}`,
+		`- User Caplets root: ${paths.userRoot}`,
+		`- State root: ${paths.stateRoot}`,
+		`- Project Caplets root: ${paths.projectRoot}`,
+		`- Auth directory: ${paths.authDir}`,
+		`- CAPLETS_CONFIG: ${paths.envConfig ?? "unset"}`
 	].join("\n") + "\n";
 }
-function formatTable(rows) {
-	const firstRow = rows[0];
-	if (!firstRow) return "";
-	const widths = firstRow.map((_, column) => Math.max(...rows.map((row) => row[column]?.length ?? 0)));
-	return rows.map((row) => formatTableRow(row, widths)).join("\n");
-}
-function formatTableRow(row, widths) {
-	return row.map((value, column) => {
-		if (column === row.length - 1) return value;
-		return value.padEnd((widths[column] ?? 0) + 2);
-	}).join("").trimEnd();
+function formatConfigPathsPlain(paths) {
+	return [
+		"Caplets paths",
+		"",
+		`User config: ${paths.userConfig}`,
+		`Project config: ${paths.projectConfig}`,
+		`User root: ${paths.userRoot}`,
+		`State root: ${paths.stateRoot}`,
+		`Project root: ${paths.projectRoot}`,
+		`Auth directory: ${paths.authDir}`,
+		`CAPLETS_CONFIG: ${paths.envConfig ?? "unset"}`
+	].join("\n") + "\n";
 }
 //#endregion
 //#region ../core/src/cli/install.ts
@@ -63425,7 +63472,7 @@ async function runCli(args, io = {}) {
 		]);
 	} catch (error) {
 		if (error instanceof CommanderError) {
-			if (error.code === "commander.helpDisplayed" || error.code === "commander.version") return;
+			if (error.code === "commander.helpDisplayed" || error.code === "commander.version" || error.message === "(outputHelp)") return;
 			throw new CapletsError("REQUEST_INVALID", error.message);
 		}
 		throw error;
@@ -63434,6 +63481,9 @@ async function runCli(args, io = {}) {
 function createProgram(io = {}) {
 	const writeOut = io.writeOut ?? ((value) => process.stdout.write(value));
 	const writeErr = io.writeErr ?? ((value) => process.stderr.write(value));
+	const setExitCode = io.setExitCode ?? ((code) => {
+		process.exitCode = code;
+	});
 	const program = new Command();
 	program.name("caplets").description("Progressive-disclosure gateway for MCP servers.").version(io.version ?? version$1).exitOverride().configureOutput({
 		writeOut,
@@ -63447,13 +63497,13 @@ function createProgram(io = {}) {
 			force: Boolean(options.force)
 		})}\n`);
 	});
-	program.command("list").description("List configured Caplets.").option("--all", "include disabled Caplets").option("--json", "print JSON output").action((options) => {
+	program.command("list").description("List configured Caplets.").option("--all", "include disabled Caplets").option("--json", "print JSON output").option("--format <format>", "output format: plain, markdown, md, or json", parseOutputFormat).action((options) => {
 		const rows = listCaplets(loadConfigWithSources(envConfigPath()), { includeDisabled: Boolean(options.all) });
-		if (options.json) {
+		if (options.json || options.format === "json") {
 			writeOut(`${JSON.stringify(rows, null, 2)}\n`);
 			return;
 		}
-		writeOut(formatCapletList(rows));
+		writeOut(formatCapletList(rows, options.format ?? "plain"));
 	});
 	program.command("install").description("Install Caplets from a repo's caplets directory.").argument("<repo>", "local repo path, Git URL, or GitHub owner/repo").argument("[caplets...]", "optional Caplet IDs to install").option("-g, --global", "install to the user Caplets root").option("--force", "overwrite installed Caplets").action((repo, capletIds, options) => {
 		const result = installCaplets(repo, {
@@ -63499,17 +63549,88 @@ function createProgram(io = {}) {
 			destinationRoot: addDestinationRoot(options)
 		}));
 	});
+	program.command("get-caplet").description("Print a configured Caplet card.").argument("<caplet>", "configured Caplet ID").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => {
+		await executeOperation(caplet, { operation: "get_caplet" }, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
+	program.command("check-backend").description("Check backend availability for a configured Caplet.").argument("<caplet>", "configured Caplet ID").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => {
+		await executeOperation(caplet, { operation: "check_backend" }, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
+	program.command("list-tools").description("List downstream tools for a configured Caplet.").argument("<caplet>", "configured Caplet ID").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => {
+		await executeOperation(caplet, { operation: "list_tools" }, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
+	program.command("search-tools").description("Search downstream tools for a configured Caplet.").argument("<caplet>", "configured Caplet ID").argument("<query>", "search query").option("--limit <n>", "maximum number of tools to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, query, options) => {
+		await executeOperation(caplet, options.limit === void 0 ? {
+			operation: "search_tools",
+			query
+		} : {
+			operation: "search_tools",
+			query,
+			limit: options.limit
+		}, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
+	program.command("get-tool").description("Print one downstream tool schema.").argument("<caplet.tool>", "qualified target, split on the first dot").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (target, options) => {
+		const { caplet, tool } = parseQualifiedTarget(target);
+		await executeOperation(caplet, {
+			operation: "get_tool",
+			tool
+		}, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
+	program.command("call-tool").description("Call one downstream tool.").argument("<caplet.tool>", "qualified target, split on the first dot").option("--args <json-object>", "JSON object of downstream tool arguments").option("--field <path>", "project a field from structured output", collect, []).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (target, options) => {
+		const { caplet, tool } = parseQualifiedTarget(target);
+		await executeOperation(caplet, {
+			operation: "call_tool",
+			tool,
+			arguments: parseCallToolArgs(options.args),
+			...options.field && options.field.length > 0 ? { fields: options.field } : {}
+		}, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			format: options.format
+		});
+	});
 	const config = program.command("config").description("Inspect Caplets config locations.");
 	config.command("path").description("Print the effective user config path.").action(() => {
 		writeOut(`${resolveConfigPath(envConfigPath())}\n`);
 	});
-	config.command("paths").description("Print resolved Caplets config, root, and auth paths.").option("--json", "print JSON output").action((options) => {
+	config.command("paths").description("Print resolved Caplets config, root, and auth paths.").option("--json", "print JSON output").option("--format <format>", "output format: plain, markdown, md, or json", parseOutputFormat).action((options) => {
 		const paths = resolveCliConfigPaths(envConfigPath(), io.authDir);
-		if (options.json) {
+		if (options.json || options.format === "json") {
 			writeOut(`${JSON.stringify(paths, null, 2)}\n`);
 			return;
 		}
-		writeOut(formatConfigPaths(paths));
+		writeOut(formatConfigPaths(paths, options.format ?? "plain"));
 	});
 	const auth = program.command("auth").description("Manage OAuth credentials for remote servers.");
 	auth.command("login").description("Authenticate a configured remote OAuth server.").argument("<server>", "configured server ID").option("--no-open", "print the authorization URL without opening a browser").action(async (serverId, options) => {
@@ -63530,10 +63651,11 @@ function createProgram(io = {}) {
 			...io.authDir ? { authDir: io.authDir } : {}
 		});
 	});
-	auth.command("list").description("List servers with stored OAuth credentials.").action(() => {
+	auth.command("list").description("List servers with stored OAuth credentials.").option("--json", "print JSON output").option("--format <format>", "output format: plain, markdown, md, or json", parseOutputFormat).action((options) => {
 		const configPath = envConfigPath();
 		listAuth({
 			writeOut,
+			format: options.json || options.format === "json" ? "json" : options.format ?? "plain",
 			...configPath ? { configPath } : {},
 			...io.authDir ? { authDir: io.authDir } : {}
 		});
@@ -63547,6 +63669,284 @@ function collect(value, previous) {
 	previous.push(value);
 	return previous;
 }
+function parsePositiveInteger(value) {
+	const parsed = Number(value);
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new CapletsError("REQUEST_INVALID", `Expected a positive integer, got ${value}`);
+	return parsed;
+}
+function parseOutputFormat(value) {
+	switch (value.toLocaleLowerCase()) {
+		case "markdown":
+		case "md": return "markdown";
+		case "plain": return "plain";
+		case "json": return "json";
+		default: throw new CapletsError("REQUEST_INVALID", `Expected output format markdown, md, plain, or json; got ${value}`);
+	}
+}
+function parseQualifiedTarget(target) {
+	const dot = target.indexOf(".");
+	if (dot <= 0 || dot === target.length - 1) throw new CapletsError("REQUEST_INVALID", "Expected qualified target in the form <caplet>.<tool>");
+	return {
+		caplet: target.slice(0, dot),
+		tool: target.slice(dot + 1)
+	};
+}
+function parseCallToolArgs(value) {
+	if (value === void 0) return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(value);
+	} catch (error) {
+		throw new CapletsError("REQUEST_INVALID", "call-tool --args must be valid JSON", error);
+	}
+	if (!isPlainObject(parsed)) throw new CapletsError("REQUEST_INVALID", "call-tool --args must be a JSON object");
+	return parsed;
+}
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+async function executeOperation(caplet, request, io) {
+	const configPath = envConfigPath();
+	const engine = new CapletsEngine({
+		...configPath ? { configPath } : {},
+		...io.authDir ? { authDir: io.authDir } : {},
+		watch: false,
+		writeErr: io.writeErr
+	});
+	try {
+		const result = await engine.execute(caplet, request);
+		const output = cliOutputForOperation(result, {
+			...request,
+			caplet
+		}, io.format ?? "markdown");
+		io.writeOut(typeof output === "string" ? `${output}\n` : `${JSON.stringify(output, null, 2)}\n`);
+		if (isPlainObject(result) && result.isError === true) io.setExitCode(1);
+	} finally {
+		await engine.close();
+	}
+}
+function cliOutputForOperation(result, request, format) {
+	if (format === "json" || !isPlainObject(result)) return jsonPayloadForOperation(result, request.operation);
+	return format === "markdown" ? markdownSummaryForOperation(result, request) : plainSummaryForOperation(result, request);
+}
+function jsonPayloadForOperation(result, operation) {
+	if (operation === "call_tool" || !isPlainObject(result)) return result;
+	const structuredContent = result.structuredContent;
+	if (!isPlainObject(structuredContent) || !("result" in structuredContent)) return result;
+	return structuredContent.result;
+}
+function markdownSummaryForOperation(result, request) {
+	const operation = request.operation;
+	const payload = jsonPayloadForOperation(result, operation);
+	if (!isPlainObject(payload)) return String(payload);
+	switch (operation) {
+		case "get_caplet": return [
+			`## Caplet \`${String(payload.caplet ?? "unknown")}\``,
+			"",
+			`**Name:** ${String(payload.name ?? "Unnamed")}`,
+			`**Description:** ${String(payload.description ?? "No description.")}`,
+			payload.backend ? `**Backend:** ${backendType(payload.backend)}` : void 0,
+			"",
+			"Next:",
+			`- List tools: \`caplets list-tools ${String(payload.caplet ?? "<caplet>")}\``,
+			`- Search tools: \`caplets search-tools ${String(payload.caplet ?? "<caplet>")} <query>\``
+		].filter((line) => line !== void 0).join("\n");
+		case "check_backend": return [
+			`## Backend \`${String(payload.server ?? "caplet")}\``,
+			"",
+			`- Status: ${String(payload.status ?? "unknown")}`,
+			typeof payload.toolCount === "number" ? `- Tools: ${payload.toolCount}` : void 0,
+			typeof payload.elapsedMs === "number" ? `- Elapsed: ${payload.elapsedMs}ms` : void 0,
+			"",
+			"Next:",
+			`- List tools: \`caplets list-tools ${String(payload.server ?? "<caplet>")}\``
+		].filter((line) => line !== void 0).join("\n");
+		case "list_tools": {
+			const tools = Array.isArray(payload.tools) ? payload.tools : [];
+			return [
+				`## Tools for \`${String(payload.server ?? "caplet")}\``,
+				"",
+				`${tools.length} ${tools.length === 1 ? "tool" : "tools"} found.`,
+				"",
+				...formatToolLines(tools, "markdown"),
+				"",
+				"Next:",
+				`- Inspect a tool: \`caplets get-tool ${String(payload.server ?? "<caplet>")}.<tool>\``,
+				`- Call a tool: \`caplets call-tool ${String(payload.server ?? "<caplet>")}.<tool> --args '{...}'\``,
+				"- Machine output: add `--format json`"
+			].join("\n");
+		}
+		case "search_tools": {
+			const tools = Array.isArray(payload.tools) ? payload.tools : [];
+			return [
+				`## Matches for ${JSON.stringify(String(payload.query ?? ""))} in \`${String(payload.server ?? "caplet")}\``,
+				"",
+				`${tools.length} ${tools.length === 1 ? "match" : "matches"} found.`,
+				"",
+				...formatToolLines(tools, "markdown"),
+				"",
+				"Next:",
+				tools.length > 0 ? `- Inspect the first match: \`caplets get-tool ${String(payload.server ?? "<caplet>")}.${firstToolName(tools) ?? "<tool>"}\`` : `- Try a broader query or list tools: \`caplets list-tools ${String(payload.server ?? "<caplet>")}\``
+			].join("\n");
+		}
+		case "get_tool": {
+			const tool = isPlainObject(payload.tool) ? payload.tool : {};
+			const target = `${String(payload.server ?? "<caplet>")}.${String(tool.name ?? "<tool>")}`;
+			return [
+				`## Tool \`${target}\``,
+				"",
+				tool.description ? compactDescription(String(tool.description)) : void 0,
+				"",
+				"Input:",
+				`- ${schemaSummary(tool.inputSchema)}`,
+				"",
+				"Output:",
+				`- ${tool.outputSchema ? schemaSummary(tool.outputSchema) : "not declared"}`,
+				"",
+				"Next:",
+				`- Call: \`caplets call-tool ${target} --args '{...}'\``,
+				"- Full schema: add `--format json`"
+			].filter((line) => line !== void 0).join("\n");
+		}
+		case "call_tool": return [
+			`## Call \`${`${String(request.caplet ?? "<caplet>")}.${String(request.tool ?? "unknown")}`}\``,
+			"",
+			`- Status: ${payload.isError === true ? "failed" : "succeeded"}`,
+			callStatusLine(payload) ? `- ${callStatusLine(payload)}` : void 0,
+			`- Result: ${summarizeCallResult(payload)}`,
+			"",
+			"Use `--format json` to inspect the full structured result."
+		].filter((line) => line !== void 0).join("\n");
+		default: return JSON.stringify(payload, null, 2);
+	}
+}
+function plainSummaryForOperation(result, request) {
+	const operation = request.operation;
+	const payload = jsonPayloadForOperation(result, operation);
+	if (!isPlainObject(payload)) return String(payload);
+	switch (operation) {
+		case "get_caplet": return [
+			`Caplet: ${String(payload.caplet ?? "unknown")}`,
+			`Name: ${String(payload.name ?? "Unnamed")}`,
+			`Description: ${String(payload.description ?? "No description.")}`,
+			payload.backend ? `Backend: ${backendType(payload.backend)}` : void 0,
+			`Next: caplets list-tools ${String(payload.caplet ?? "<caplet>")} or caplets search-tools ${String(payload.caplet ?? "<caplet>")} <query>`
+		].filter((line) => Boolean(line)).join("\n");
+		case "check_backend": return [
+			`Backend: ${String(payload.server ?? "caplet")} is ${String(payload.status ?? "unknown")}`,
+			typeof payload.toolCount === "number" ? `Tools: ${payload.toolCount}` : void 0,
+			typeof payload.elapsedMs === "number" ? `Elapsed: ${payload.elapsedMs}ms` : void 0,
+			`Next: caplets list-tools ${String(payload.server ?? "<caplet>")}`
+		].filter((line) => Boolean(line)).join("\n");
+		case "list_tools": {
+			const tools = Array.isArray(payload.tools) ? payload.tools : [];
+			return [
+				`Tools for ${String(payload.server ?? "caplet")} (${tools.length}):`,
+				...formatToolLines(tools, "plain"),
+				`Next: caplets get-tool ${String(payload.server ?? "<caplet>")}.<tool> or caplets call-tool ${String(payload.server ?? "<caplet>")}.<tool> --args '{...}'`
+			].join("\n");
+		}
+		case "search_tools": {
+			const tools = Array.isArray(payload.tools) ? payload.tools : [];
+			return [
+				`Matches for ${JSON.stringify(String(payload.query ?? ""))} in ${String(payload.server ?? "caplet")} (${tools.length}):`,
+				...formatToolLines(tools, "plain"),
+				tools.length > 0 ? `Next: caplets get-tool ${String(payload.server ?? "<caplet>")}.${firstToolName(tools) ?? "<tool>"}` : `Next: try caplets list-tools ${String(payload.server ?? "<caplet>")} or a broader query.`
+			].join("\n");
+		}
+		case "get_tool": {
+			const tool = isPlainObject(payload.tool) ? payload.tool : {};
+			const target = `${String(payload.server ?? "<caplet>")}.${String(tool.name ?? "<tool>")}`;
+			return [
+				`Tool: ${target}`,
+				tool.description ? `Description: ${compactDescription(String(tool.description))}` : void 0,
+				`Input: ${schemaSummary(tool.inputSchema)}`,
+				`Output: ${tool.outputSchema ? schemaSummary(tool.outputSchema) : "not declared"}`,
+				`Next: caplets call-tool ${target} --args '{...}'`,
+				"Use --format json to inspect full schemas and descriptions."
+			].filter((line) => Boolean(line)).join("\n");
+		}
+		case "call_tool": return [
+			`Call ${`${String(request.caplet ?? "<caplet>")}.${String(request.tool ?? "unknown")}`} ${payload.isError === true ? "failed" : "succeeded"}.`,
+			callStatusLine(payload),
+			`Result: ${summarizeCallResult(payload)}`,
+			"Use --format json to inspect the full structured result."
+		].filter((line) => Boolean(line)).join("\n");
+		default: return JSON.stringify(payload, null, 2);
+	}
+}
+function formatToolLines(tools, format) {
+	if (tools.length === 0) return ["- none"];
+	return tools.map((tool) => {
+		if (!isPlainObject(tool)) return `- ${String(tool)}`;
+		const name = String(tool.tool ?? tool.name ?? "unknown");
+		const displayName = format === "markdown" ? `\`${name}\`` : name;
+		const flags = [tool.hasInputSchema ? "input" : void 0, tool.hasOutputSchema ? "output" : void 0].filter(Boolean).join(", ");
+		return `- ${displayName}${flags ? ` (${flags})` : ""}${tool.description ? ` — ${compactDescription(String(tool.description))}` : ""}`;
+	});
+}
+function compactDescription(value) {
+	const firstParagraph = value.trim().split(/\n\s*\n/u)[0] ?? "";
+	const collapsed = (firstParagraph.match(/^.*?(?:[.!?](?=\s|$)|$)/u)?.[0] ?? firstParagraph).replace(/\s+/gu, " ").trim();
+	return collapsed.length > 140 ? `${collapsed.slice(0, 137).trimEnd()}...` : collapsed;
+}
+function firstToolName(tools) {
+	const first = tools[0];
+	return isPlainObject(first) && typeof first.tool === "string" ? first.tool : void 0;
+}
+function backendType(value) {
+	return isPlainObject(value) && typeof value.type === "string" ? value.type : "unknown";
+}
+function callStatusLine(payload) {
+	const structured = isPlainObject(payload.structuredContent) ? payload.structuredContent : payload;
+	return typeof structured.exitCode === "number" ? `Exit code: ${structured.exitCode}` : void 0;
+}
+function summarizeCallResult(payload) {
+	const structured = isPlainObject(payload.structuredContent) ? payload.structuredContent : payload;
+	const preview = previewValue(preferredPreviewValue(structured));
+	if (preview) return preview;
+	const keys = Object.keys(structured).filter((key) => key !== "elapsedMs");
+	return keys.length > 0 ? `structured keys: ${keys.join(", ")}` : "no structured content";
+}
+function preferredPreviewValue(value) {
+	if (!isPlainObject(value)) return value;
+	if ("result" in value) return value.result;
+	if ("json" in value) return value.json;
+	if (typeof value.text === "string") return value.text;
+	if (typeof value.stdout === "string" && value.stdout.trim()) return value.stdout.trim();
+	return value;
+}
+function previewValue(value) {
+	if (typeof value === "string") return truncatePreview(value);
+	if (typeof value === "number" || typeof value === "boolean" || value === null) return String(value);
+	if (Array.isArray(value)) return truncatePreview(JSON.stringify(value));
+	if (isPlainObject(value)) {
+		const entries = Object.entries(value).slice(0, 4);
+		if (entries.length === 0) return "empty object";
+		return truncatePreview(entries.map(([key, entryValue]) => `${key}: ${previewScalar(entryValue)}`).join(", "));
+	}
+}
+function previewScalar(value) {
+	if (typeof value === "string") return JSON.stringify(truncatePreview(value, 80));
+	if (typeof value === "number" || typeof value === "boolean" || value === null) return String(value);
+	if (Array.isArray(value)) return `[${value.length} item${value.length === 1 ? "" : "s"}]`;
+	if (isPlainObject(value)) return `{${Object.keys(value).slice(0, 3).join(", ")}${Object.keys(value).length > 3 ? ", ..." : ""}}`;
+	return typeof value;
+}
+function truncatePreview(value, maxLength = 180) {
+	const collapsed = value.replace(/\s+/gu, " ").trim();
+	return collapsed.length > maxLength ? `${collapsed.slice(0, maxLength - 3).trimEnd()}...` : collapsed;
+}
+function schemaSummary(schema) {
+	if (!isPlainObject(schema)) return "not declared";
+	const properties = isPlainObject(schema.properties) ? Object.keys(schema.properties) : [];
+	const required = Array.isArray(schema.required) ? schema.required.filter((value) => typeof value === "string") : [];
+	return [
+		typeof schema.type === "string" ? `type ${schema.type}` : void 0,
+		properties.length > 0 ? `properties ${properties.join(", ")}` : "no declared properties",
+		required.length > 0 ? `required ${required.join(", ")}` : "no required fields"
+	].filter((part) => Boolean(part)).join("; ");
+}
 function addDestinationRoot(options) {
 	return options.global ? resolveCapletsRoot(resolveConfigPath(envConfigPath())) : resolveProjectCapletsRoot();
 }
@@ -63559,7 +63959,7 @@ function writeAddResult(writeOut, label, result) {
 }
 //#endregion
 //#region package.json
-var version = "0.12.7";
+var version = "0.13.0";
 //#endregion
 //#region src/index.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caplets",
-  "version": "0.12.7",
+  "version": "0.13.0",
   "description": "Progressive disclosure gateway CLI for MCP servers and native Caplets adapters.",
   "keywords": [
     "caplets",
@@ -33,21 +33,23 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@caplets/core": "0.13.1"
+    "@modelcontextprotocol/sdk": "^1.29.0"
   },
   "devDependencies": {
     "@types/node": "^25.7.0",
+    "@typescript/native-preview": "7.0.0-dev.20260515.1",
     "rolldown": "^1.0.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.6",
+    "@caplets/core": "0.14.0"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "build": "rm -rf dist && rolldown -c",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests"
+    "build:watch": "rm -rf dist && rolldown -c --watch",
+    "typecheck": "tsgo --noEmit",
+    "test": "vitest run"
   }
 }