@caplets/core 0.17.0 → 0.18.0

package/dist/index.js

@@ -1,4 +1,6 @@
-import { A as CompleteRequestSchema, At as string, B as InitializedNotificationSchema, C as assertToolsCallTaskCapability, Ct as resolveProjectConfigPath, D as toJsonSchemaCompat, Dt as ZodOptional, E as mergeCapabilities, Et as SERVER_ID_PATTERN, F as ElicitResultSchema, Ft as toSafeError, G as ListResourcesRequestSchema, H as LATEST_PROTOCOL_VERSION, I as EmptyResultSchema, It as __commonJSMin, J as LoggingLevelSchema, K as ListRootsResultSchema, L as ErrorCode, Lt as __require, M as CreateMessageResultWithToolsSchema, Mt as CAPLETS_ERROR_CODES, N as CreateTaskResultSchema, Nt as CapletsError, O as CallToolRequestSchema, Ot as literal, Pt as redactSecrets, Q as SetLevelRequestSchema, R as GetPromptRequestSchema, Rt as __toESM, S as assertClientRequestTaskCapability, St as resolveProjectCapletsRoot, T as Protocol, Tt as validateCapletFile, U as ListPromptsRequestSchema, V as JSONRPCMessageSchema, W as ListResourceTemplatesRequestSchema, X as ReadResourceRequestSchema, Y as McpError, Z as SUPPORTED_PROTOCOL_VERSIONS, _ as readTokenBundle, _t as loadConfigWithSources, a as resolveCapletsServer, at as isJSONRPCResultResponse, b as serializeMessage, bt as resolveCapletsRoot, c as handleServerTool, ct as getParseErrorMessage, d as runGenericOAuthFlow, dt as isZ4Schema, et as assertCompleteRequestPrompt, f as runOAuthFlow, ft as normalizeObjectSchema, g as isTokenBundleExpired, gt as loadConfig, h as deleteTokenBundle, ht as safeParseAsync, i as resolveCapletsMode, it as isJSONRPCRequest, j as CreateMessageResultSchema, jt as url, k as CallToolResultSchema, kt as object, l as ServerRegistry, lt as getSchemaDescription, m as startOAuthFlow, mt as safeParse, nt as isInitializeRequest, o as CapletsEngine, ot as getLiteralValue, p as startGenericOAuthFlow, pt as objectFromShape, q as ListToolsRequestSchema, r as parseServerBaseUrl, rt as isJSONRPCErrorResponse, s as generatedToolInputSchema, st as getObjectShape, t as controlUrlForBase, tt as assertCompleteRequestResourceTemplate, u as capabilityDescription, ut as isSchemaOptional, vt as parseConfig, w as AjvJsonSchemaValidator, wt as discoverCapletFiles, xt as resolveConfigPath, y as ReadBuffer, yt as DEFAULT_AUTH_DIR, z as InitializeRequestSchema } from "./options-CJEOqS87.js";
+import { $ as assertCompleteRequestPrompt, A as CreateMessageResultSchema, At as toSafeError, B as JSONRPCMessageSchema, C as AjvJsonSchemaValidator, D as CallToolRequestSchema, Dt as CAPLETS_ERROR_CODES, E as toJsonSchemaCompat, Et as SERVER_ID_PATTERN, F as EmptyResultSchema, G as ListRootsResultSchema, H as ListPromptsRequestSchema, I as ErrorCode, J as McpError, K as ListToolsRequestSchema, L as GetPromptRequestSchema, M as CreateTaskResultSchema, Nt as __require, O as CallToolResultSchema, Ot as CapletsError, P as ElicitResultSchema, Pt as __toESM, R as InitializeRequestSchema, S as assertToolsCallTaskCapability, St as resolveProjectCapletsRoot, T as mergeCapabilities, Tt as validateCapletFile, U as ListResourceTemplatesRequestSchema, V as LATEST_PROTOCOL_VERSION, W as ListResourcesRequestSchema, X as SUPPORTED_PROTOCOL_VERSIONS, Y as ReadResourceRequestSchema, Z as SetLevelRequestSchema, _t as parseConfig, a as resolveCapletsServer, at as getLiteralValue, bt as resolveCapletsRoot, 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 __commonJSMin, k as CompleteRequestSchema, kt as redactSecrets, 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, w as Protocol, wt as discoverCapletFiles, x as assertClientRequestTaskCapability, xt as resolveConfigPath, y as serializeMessage, z as InitializedNotificationSchema } from "./options-DM1cMRcp.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-B6rce396.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-CxGG6ae3.js";
 import { accessSync, chmodSync, closeSync, constants, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
 import { basename, dirname, join, parse, relative, resolve } from "node:path";
 import { execFileSync } from "node:child_process";
@@ -1319,7 +1321,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 } };
 //#endregion
 //#region package.json
-var version = "0.17.0";
+var version = "0.18.0";
 //#endregion
 //#region src/serve/session.ts
 var CapletsMcpSession = class {
@@ -1363,6 +1365,7 @@ var CapletsMcpSession = class {
 			if (!previousCaplet || serializeCaplet(previousCaplet) !== serializeCaplet(caplet)) tool.update({
 				title: caplet.name,
 				description: capabilityDescription(caplet),
+				paramsSchema: generatedToolInputSchemaForCaplet(caplet).shape,
 				callback: async (request) => this.handleTool(serverId, request),
 				enabled: true
 			});
@@ -1376,7 +1379,7 @@ var CapletsMcpSession = class {
 		return this.server.registerTool(caplet.server, {
 			title: caplet.name,
 			description: capabilityDescription(caplet),
-			inputSchema: generatedToolInputSchema
+			inputSchema: generatedToolInputSchemaForCaplet(caplet).shape
 		}, async (request) => this.handleTool(caplet.server, request));
 	}
 	async handleTool(serverId, request) {
@@ -5042,126 +5045,6 @@ function starterConfig() {
 	}, null, 2);
 }
 //#endregion
-//#region src/cli/inspection.ts
-function listCaplets(configWithSources, options) {
-	const { config, sources, shadows } = configWithSources;
-	return allCaplets(config).filter((server) => options.includeDisabled || !server.disabled).map((server) => ({
-		server: server.server,
-		backend: server.backend,
-		name: server.name,
-		description: server.description,
-		disabled: server.disabled,
-		status: initialServerStatus(server),
-		source: sources[server.server]?.kind ?? "unknown",
-		path: sources[server.server]?.path ?? null,
-		shadows: shadows[server.server] ?? []
-	})).sort((left, right) => left.server.localeCompare(right.server));
-}
-function initialServerStatus(server) {
-	return server.disabled ? "disabled" : "not_started";
-}
-function allCaplets(config) {
-	return [
-		...Object.values(config.mcpServers),
-		...Object.values(config.openapiEndpoints),
-		...Object.values(config.graphqlEndpoints),
-		...Object.values(config.httpApis),
-		...Object.values(config.cliTools)
-	];
-}
-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 entries = rows.map((row) => [
-		row.server,
-		`  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 `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";
-	if (kind.startsWith("global")) return "global";
-	return kind;
-}
-function resolveCliConfigPaths(envConfigPath, authDir) {
-	const configPath = resolveConfigPath(envConfigPath);
-	const effectiveAuthDir = authDir ?? DEFAULT_AUTH_DIR;
-	return {
-		userConfig: configPath,
-		projectConfig: resolveProjectConfigPath(),
-		userRoot: resolveCapletsRoot(configPath),
-		stateRoot: dirname(effectiveAuthDir),
-		projectRoot: resolveProjectCapletsRoot(),
-		authDir: effectiveAuthDir,
-		envConfig: envConfigPath ?? null
-	};
-}
-function formatConfigPaths(paths, format = "plain") {
-	if (format === "markdown") return formatConfigPathsMarkdown(paths);
-	return formatConfigPathsPlain(paths);
-}
-function formatConfigPathsMarkdown(paths) {
-	return [
-		"## 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 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 src/cli/install.ts
 function installCaplets(repo, options = {}) {
 	const source = resolveInstallSource(repo);
@@ -8413,7 +8296,15 @@ const ENGINE_COMMANDS = new Set([
 	"list_tools",
 	"search_tools",
 	"get_tool",
-	"call_tool"
+	"call_tool",
+	"list_resources",
+	"search_resources",
+	"list_resource_templates",
+	"read_resource",
+	"list_prompts",
+	"search_prompts",
+	"get_prompt",
+	"complete"
 ]);
 async function dispatchRemoteCliRequest(request, context) {
 	try {
@@ -8464,6 +8355,16 @@ async function dispatch(request, context) {
 			...optionalProp("force", optionalBoolean(request.arguments, "force"))
 		})
 	};
+	if (request.command === "complete_cli") {
+		const shell = optionalString(request.arguments, "shell") ?? "bash";
+		if (!completionShells.includes(shell)) return [];
+		const engine = new CapletsEngine(context);
+		try {
+			return await engine.completeCliWords(optionalStringArray(request.arguments, "words") ?? [""]);
+		} finally {
+			await engine.close();
+		}
+	}
 	if (request.command === "auth_list") return listAuthRows({
 		...optionalProp("configPath", context.configPath),
 		...optionalProp("authDir", context.authDir)
@@ -8580,6 +8481,12 @@ function requiredString(args, key) {
 	if (typeof value !== "string" || value.length === 0) throw new CapletsError("REQUEST_INVALID", `${key} must be a non-empty string`);
 	return value;
 }
+function optionalString(args, key) {
+	const value = args[key];
+	if (value === void 0) return;
+	if (typeof value !== "string") throw new CapletsError("REQUEST_INVALID", `${key} must be a string`);
+	return value;
+}
 function optionalObject(args, key) {
 	const value = args[key];
 	if (value === void 0) return {};
@@ -9159,6 +9066,9 @@ async function runCli(args, io = {}) {
 		throw error;
 	}
 }
+function normalizeCompletionWords(words) {
+	return words.map((word) => word === "__CAPLETS_TRAILING_SPACE__" ? "" : word);
+}
 function createProgram(io = {}) {
 	const writeOut = io.writeOut ?? ((value) => process.stdout.write(value));
 	const writeErr = io.writeErr ?? ((value) => process.stderr.write(value));
@@ -9173,7 +9083,27 @@ function createProgram(io = {}) {
 		writeErr,
 		outputError: (value, write) => write(value)
 	});
-	program.command("serve").description("Serve configured Caplets as an MCP server.").option("--transport <transport>", "server transport: stdio or http").option("--host <host>", "HTTP bind host").option("--port <port>", "HTTP bind port").option("--path <path>", "HTTP service base path").option("--user <user>", "HTTP Basic Auth username").option("--password <password>", "HTTP Basic Auth password").option("--allow-unauthenticated-http", "allow unauthenticated HTTP serving on non-loopback hosts").option("--trust-proxy", "trust X-Forwarded-* headers from a reverse proxy").action(async (options) => {
+	program.command(cliCommands.completion).description("Print a shell completion script.").argument("<shell>", "completion shell: bash, zsh, fish, powershell, or cmd").action((shell) => {
+		if (!completionShells.includes(shell)) throw new CapletsError("REQUEST_INVALID", "completion shell must be bash, zsh, fish, powershell, or cmd");
+		writeOut(completionScript(shell));
+	});
+	program.command(cliCommands.completeHidden, { hidden: true }).description("Internal shell completion endpoint.").option("--shell <shell>", "completion shell").allowUnknownOption(true).argument("[words...]", "words to complete").action(async (words, options) => {
+		const shell = completionShells.includes(options.shell) ? options.shell : "bash";
+		const remote = remoteClientForCli(io);
+		const configPath = currentConfigPath();
+		const completionWords = normalizeCompletionWords(words);
+		let suggestions = [];
+		try {
+			suggestions = remote ? await remote.request("complete_cli", {
+				shell,
+				words: completionWords
+			}) : await completeCliWords(completionWords, configPath ? { configPath } : {});
+		} catch {
+			suggestions = [];
+		}
+		if (suggestions.length > 0) writeOut(`${suggestions.join("\n")}\n`);
+	});
+	program.command(cliCommands.serve).description("Serve configured Caplets as an MCP server.").option("--transport <transport>", "server transport: stdio or http").option("--host <host>", "HTTP bind host").option("--port <port>", "HTTP bind port").option("--path <path>", "HTTP service base path").option("--user <user>", "HTTP Basic Auth username").option("--password <password>", "HTTP Basic Auth password").option("--allow-unauthenticated-http", "allow unauthenticated HTTP serving on non-loopback hosts").option("--trust-proxy", "trust X-Forwarded-* headers from a reverse proxy").action(async (options) => {
 		const resolved = resolveServeOptions(options);
 		const configPath = currentConfigPath();
 		await (io.serve ?? ((serveOptions) => serveResolvedCaplets(serveOptions, {
@@ -9181,7 +9111,7 @@ function createProgram(io = {}) {
 			...io.authDir ? { authDir: io.authDir } : {}
 		}, writeErr)))(resolved);
 	});
-	program.command("init").description("Create a starter Caplets config file.").option("--force", "overwrite an existing config file").action(async (options) => {
+	program.command(cliCommands.init).description("Create a starter Caplets config file.").option("--force", "overwrite an existing config file").action(async (options) => {
 		const remote = remoteClientForCli(io);
 		if (remote) {
 			writeOut(`Created remote Caplets config at ${(await remote.request("init", { force: Boolean(options.force) })).path}\n`);
@@ -9193,7 +9123,7 @@ 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").option("--format <format>", "output format: plain, markdown, md, or json", parseOutputFormat).action(async (options) => {
+	program.command(cliCommands.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(async (options) => {
 		const includeDisabled = Boolean(options.all);
 		const remote = remoteClientForCli(io);
 		if (remote) {
@@ -9212,7 +9142,7 @@ function createProgram(io = {}) {
 		}
 		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(async (repo, capletIds, options) => {
+	program.command(cliCommands.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(async (repo, capletIds, options) => {
 		const remote = remoteClientForCli(io);
 		if (remote) {
 			if (options.global) writeErr("Warning: --global is not supported in remote mode; the server controls the installation destination.\n");
@@ -9231,7 +9161,7 @@ function createProgram(io = {}) {
 		});
 		for (const caplet of result.installed) writeOut(`Installed ${caplet.id} to ${caplet.destination}\n`);
 	});
-	const add = program.command("add").description("Add generated Caplet files.");
+	const add = program.command(cliCommands.add).description("Add generated Caplet files.");
 	add.command("cli").description("Add a CLI tools Caplet.").argument("<id>", "Caplet ID/display seed").option("--repo <path>", "repository path to inspect").option("--include <items>", "comma-separated generators to include: git,gh,package").option("--command <name>", "single CLI command template to generate").option("-g, --global", "write to the user Caplets root").option("--print", "print generated Caplet text without writing a file").option("--output <path>", "output path").option("--force", "overwrite an existing destination file").action(async (id, options) => {
 		const remote = remoteClientForCli(io);
 		if (remote) {
@@ -9312,7 +9242,7 @@ function createProgram(io = {}) {
 			destinationRoot: addDestinationRoot(options, currentConfigPath())
 		}));
 	});
-	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) => {
+	program.command(cliCommands.getCaplet).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,
@@ -9323,7 +9253,7 @@ function createProgram(io = {}) {
 			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) => {
+	program.command(cliCommands.checkBackend).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,
@@ -9334,7 +9264,7 @@ function createProgram(io = {}) {
 			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) => {
+	program.command(cliCommands.listTools).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,
@@ -9345,7 +9275,7 @@ function createProgram(io = {}) {
 			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) => {
+	program.command(cliCommands.searchTools).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
@@ -9363,7 +9293,7 @@ function createProgram(io = {}) {
 			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) => {
+	program.command(cliCommands.getTool).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",
@@ -9378,7 +9308,7 @@ function createProgram(io = {}) {
 			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) => {
+	program.command(cliCommands.callTool).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",
@@ -9395,7 +9325,119 @@ function createProgram(io = {}) {
 			format: options.format
 		});
 	});
-	const config = program.command("config").description("Inspect Caplets config locations.");
+	program.command(cliCommands.listResources).description("List MCP resources for a configured MCP Caplet.").argument("<caplet>").option("--limit <n>", "maximum number of resources to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => executeOperation(caplet, options.limit === void 0 ? { operation: "list_resources" } : {
+		operation: "list_resources",
+		limit: options.limit
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.searchResources).description("Search MCP resources and resource templates for a configured MCP Caplet.").argument("<caplet>").argument("<query>").option("--limit <n>", "maximum number of matches to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, query, options) => executeOperation(caplet, options.limit === void 0 ? {
+		operation: "search_resources",
+		query
+	} : {
+		operation: "search_resources",
+		query,
+		limit: options.limit
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.listResourceTemplates).description("List MCP resource templates for a configured MCP Caplet.").argument("<caplet>").option("--limit <n>", "maximum number of templates to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => executeOperation(caplet, options.limit === void 0 ? { operation: "list_resource_templates" } : {
+		operation: "list_resource_templates",
+		limit: options.limit
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.readResource).description("Read one MCP resource by URI.").argument("<caplet>").argument("<uri>").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, uri, options) => executeOperation(caplet, {
+		operation: "read_resource",
+		uri
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.listPrompts).description("List MCP prompts for a configured MCP Caplet.").argument("<caplet>").option("--limit <n>", "maximum number of prompts to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => executeOperation(caplet, options.limit === void 0 ? { operation: "list_prompts" } : {
+		operation: "list_prompts",
+		limit: options.limit
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.searchPrompts).description("Search MCP prompts for a configured MCP Caplet.").argument("<caplet>").argument("<query>").option("--limit <n>", "maximum number of prompts to return", parsePositiveInteger).option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, query, options) => executeOperation(caplet, options.limit === void 0 ? {
+		operation: "search_prompts",
+		query
+	} : {
+		operation: "search_prompts",
+		query,
+		limit: options.limit
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	program.command(cliCommands.getPrompt).description("Get one MCP prompt by name.").argument("<caplet.prompt>", "qualified target, split on the first dot").option("--args <json-object>", "JSON object of prompt arguments").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (target, options) => {
+		const { caplet, tool: prompt } = parseQualifiedTarget(target);
+		await executeOperation(caplet, {
+			operation: "get_prompt",
+			prompt,
+			arguments: parseJsonObjectOption(options.args, "get-prompt --args")
+		}, {
+			writeOut,
+			writeErr,
+			setExitCode,
+			authDir: io.authDir,
+			env,
+			remote: remoteClientForCli(io),
+			format: options.format
+		});
+	});
+	program.command(cliCommands.complete).description("Complete an MCP prompt or resource-template argument.").argument("<caplet>").requiredOption("--argument <name>", "argument name").option("--value <value>", "argument prefix", "").option("--prompt <name>", "prompt name to complete").option("--resource-template <uri-template>", "resource template URI to complete").option("--format <format>", "output format: markdown, md, plain, or json", parseOutputFormat).action(async (caplet, options) => executeOperation(caplet, {
+		operation: "complete",
+		ref: completionRefFromOptions(options),
+		argument: {
+			name: options.argument,
+			value: options.value
+		}
+	}, {
+		writeOut,
+		writeErr,
+		setExitCode,
+		authDir: io.authDir,
+		env,
+		remote: remoteClientForCli(io),
+		format: options.format
+	}));
+	const config = program.command(cliCommands.config).description("Inspect Caplets config locations.");
 	config.command("path").description("Print the effective user config path.").action(() => {
 		writeOut(`${resolveConfigPath(currentConfigPath())}\n`);
 	});
@@ -9407,7 +9449,7 @@ function createProgram(io = {}) {
 		}
 		writeOut(formatConfigPaths(paths, options.format ?? "plain"));
 	});
-	const auth = program.command("auth").description("Manage OAuth credentials for remote servers.");
+	const auth = program.command(cliCommands.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) => {
 		const remote = remoteClientForCli(io);
 		if (remote) {
@@ -9492,7 +9534,15 @@ function remoteCommandForOperation(operation) {
 		case "list_tools":
 		case "search_tools":
 		case "get_tool":
-		case "call_tool": return operation;
+		case "call_tool":
+		case "list_resources":
+		case "search_resources":
+		case "list_resource_templates":
+		case "read_resource":
+		case "list_prompts":
+		case "search_prompts":
+		case "get_prompt":
+		case "complete": return operation;
 		default: return;
 	}
 }
@@ -9540,6 +9590,29 @@ function parseCallToolArgs(value) {
 	if (!isPlainObject(parsed)) throw new CapletsError("REQUEST_INVALID", "call-tool --args must be a JSON object");
 	return parsed;
 }
+function parseJsonObjectOption(value, label) {
+	if (value === void 0) return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(value);
+	} catch (error) {
+		throw new CapletsError("REQUEST_INVALID", `${label} must be valid JSON`, error);
+	}
+	if (!isPlainObject(parsed)) throw new CapletsError("REQUEST_INVALID", `${label} must be a JSON object`);
+	return parsed;
+}
+function completionRefFromOptions(options) {
+	if (options.prompt && options.resourceTemplate) throw new CapletsError("REQUEST_INVALID", "complete accepts either --prompt or --resource-template, not both");
+	if (options.prompt) return {
+		type: "prompt",
+		name: options.prompt
+	};
+	if (options.resourceTemplate) return {
+		type: "resourceTemplate",
+		uri: options.resourceTemplate
+	};
+	throw new CapletsError("REQUEST_INVALID", "complete requires --prompt or --resource-template");
+}
 function isPlainObject(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -9670,6 +9743,55 @@ function markdownSummaryForOperation(result, request) {
 			"",
 			"Use `--format json` to inspect the full structured result."
 		].filter((line) => line !== void 0).join("\n");
+		case "list_resources":
+		case "search_resources": {
+			const resources = Array.isArray(payload.resources) ? payload.resources : [];
+			const templates = Array.isArray(payload.resourceTemplates) ? payload.resourceTemplates : [];
+			const matches = Array.isArray(payload.matches) ? payload.matches : [...resources, ...templates];
+			return [
+				`## MCP resources for \`${id}\``,
+				"",
+				`${matches.length} item${matches.length === 1 ? "" : "s"} found.`,
+				"",
+				...formatResourceLines(matches, "markdown")
+			].join("\n");
+		}
+		case "list_resource_templates": {
+			const templates = Array.isArray(payload.resourceTemplates) ? payload.resourceTemplates : [];
+			return [
+				`## MCP resource templates for \`${id}\``,
+				"",
+				...formatResourceLines(templates, "markdown")
+			].join("\n");
+		}
+		case "read_resource": return [
+			`## Resource \`${String(request.uri ?? "")}\``,
+			"",
+			summarizeResourceRead(payload),
+			"",
+			"Use `--format json` to inspect all contents."
+		].join("\n");
+		case "list_prompts":
+		case "search_prompts": {
+			const prompts = Array.isArray(payload.prompts) ? payload.prompts : [];
+			return [
+				`## MCP prompts for \`${id}\``,
+				"",
+				...formatPromptLines(prompts, "markdown")
+			].join("\n");
+		}
+		case "get_prompt": return [
+			`## Prompt \`${String(request.caplet)}.${String(request.prompt)}\``,
+			"",
+			summarizePromptResult(payload),
+			"",
+			"Use `--format json` to inspect all messages."
+		].join("\n");
+		case "complete": return [
+			`## Completion for \`${id}\``,
+			"",
+			summarizeCompletionResult(payload)
+		].join("\n");
 		default: return JSON.stringify(payload, null, 2);
 	}
 }
@@ -9726,6 +9848,33 @@ function plainSummaryForOperation(result, request) {
 			`Result: ${summarizeCallResult(payload)}`,
 			"Use --format json to inspect the full structured result."
 		].filter((line) => Boolean(line)).join("\n");
+		case "list_resources":
+		case "search_resources": {
+			const resources = Array.isArray(payload.resources) ? payload.resources : [];
+			const templates = Array.isArray(payload.resourceTemplates) ? payload.resourceTemplates : [];
+			const matches = Array.isArray(payload.matches) ? payload.matches : [...resources, ...templates];
+			return [`MCP resources for ${id} (${matches.length}):`, ...formatResourceLines(matches, "plain")].join("\n");
+		}
+		case "list_resource_templates": {
+			const templates = Array.isArray(payload.resourceTemplates) ? payload.resourceTemplates : [];
+			return [`MCP resource templates for ${id}:`, ...formatResourceLines(templates, "plain")].join("\n");
+		}
+		case "read_resource": return [
+			`Resource ${String(request.uri ?? "")}`,
+			summarizeResourceRead(payload),
+			"Use --format json to inspect all contents."
+		].join("\n");
+		case "list_prompts":
+		case "search_prompts": {
+			const prompts = Array.isArray(payload.prompts) ? payload.prompts : [];
+			return [`MCP prompts for ${id}:`, ...formatPromptLines(prompts, "plain")].join("\n");
+		}
+		case "get_prompt": return [
+			`Prompt ${String(request.caplet)}.${String(request.prompt)}`,
+			summarizePromptResult(payload),
+			"Use --format json to inspect all messages."
+		].join("\n");
+		case "complete": return [`Completion for ${id}`, summarizeCompletionResult(payload)].join("\n");
 		default: return JSON.stringify(payload, null, 2);
 	}
 }
@@ -9742,6 +9891,44 @@ function formatToolLines(tools, format) {
 		return `- ${displayName}${flags ? ` (${flags})` : ""}${tool.description ? ` — ${compactDescription(String(tool.description))}` : ""}`;
 	});
 }
+function formatResourceLines(resources, format) {
+	if (resources.length === 0) return ["- none"];
+	return resources.map((resource) => {
+		if (!isPlainObject(resource)) return `- ${String(resource)}`;
+		const name = String(resource.uri ?? resource.uriTemplate ?? "unknown");
+		const displayName = format === "markdown" ? `\`${name}\`` : name;
+		const label = typeof resource.name === "string" ? ` (${resource.name})` : "";
+		return `- ${typeof resource.kind === "string" ? `${resource.kind}: ` : ""}${displayName}${label}${resource.description ? ` — ${compactDescription(String(resource.description))}` : ""}`;
+	});
+}
+function formatPromptLines(prompts, format) {
+	if (prompts.length === 0) return ["- none"];
+	return prompts.map((prompt) => {
+		if (!isPlainObject(prompt)) return `- ${String(prompt)}`;
+		const name = String(prompt.prompt ?? prompt.name ?? "unknown");
+		return `- ${format === "markdown" ? `\`${name}\`` : name}${Array.isArray(prompt.arguments) ? ` (${prompt.arguments.length} args)` : ""}${prompt.description ? ` — ${compactDescription(String(prompt.description))}` : ""}`;
+	});
+}
+function summarizeResourceRead(payload) {
+	const contents = Array.isArray(payload.contents) ? payload.contents : [];
+	if (contents.length === 0) return "No contents returned.";
+	const first = contents.find(isPlainObject);
+	if (!first) return `${contents.length} content item${contents.length === 1 ? "" : "s"} returned.`;
+	return previewValue(typeof first.text === "string" ? first.text : first.blob) ?? `${contents.length} content item${contents.length === 1 ? "" : "s"} returned.`;
+}
+function summarizePromptResult(payload) {
+	const messages = Array.isArray(payload.messages) ? payload.messages : [];
+	if (messages.length === 0) return "No messages returned.";
+	const first = messages.find(isPlainObject);
+	if (!first) return `${messages.length} message${messages.length === 1 ? "" : "s"} returned.`;
+	return previewValue((isPlainObject(first.content) ? first.content : void 0)?.text ?? first.content) ?? `${messages.length} message${messages.length === 1 ? "" : "s"} returned.`;
+}
+function summarizeCompletionResult(payload) {
+	const completion = isPlainObject(payload.completion) ? payload.completion : void 0;
+	const values = Array.isArray(completion?.values) ? completion.values : [];
+	if (values.length > 0) return values.map((value) => `- ${String(value)}`).join("\n");
+	return previewValue(payload) ?? "No completions returned.";
+}
 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();

package/dist/native/remote.d.ts

@@ -4,6 +4,7 @@ export type RemoteCapletsTool = {
     name: string;
     title?: string | undefined;
     description?: string | undefined;
+    inputSchema?: unknown;
 };
 export type RemoteCapletsClient = {
     listTools(): Promise<RemoteCapletsTool[]>;