caplets 0.2.0 → 0.2.1

package/dist/index.js

@@ -19847,7 +19847,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 } };
 //#endregion
 //#region package.json
-var version = "0.2.0";
+var version = "0.2.1";
 //#endregion
 //#region node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 /**
@@ -20001,6 +20001,7 @@ const FORBIDDEN_HEADERS = new Set([
 ]);
 join(homedir(), ".caplets", "config.json");
 join(homedir(), ".caplets", "auth");
+const PROJECT_CONFIG_FILE = join(".caplets", "config.json");
 const remoteAuthSchema = discriminatedUnion("type", [
 	object({ type: literal("none") }).strict(),
 	object({
@@ -20111,15 +20112,43 @@ const configFileSchema = object({
 function resolveConfigPath(path) {
 	return path ?? join(homedir(), ".caplets", "config.json");
 }
-function loadConfig(path = resolveConfigPath()) {
-	if (!existsSync(path)) throw new CapletsError("CONFIG_NOT_FOUND", `Caplets config not found at ${path}`);
+function resolveProjectConfigPath(cwd = process.cwd()) {
+	return join(cwd, PROJECT_CONFIG_FILE);
+}
+function loadConfig(path = resolveConfigPath(), projectPath = resolveProjectConfigPath()) {
+	const hasUserConfig = existsSync(path);
+	const hasProjectConfig = existsSync(projectPath);
+	if (!hasUserConfig && !hasProjectConfig) throw new CapletsError("CONFIG_NOT_FOUND", `Caplets config not found at ${path} or ${projectPath}`);
 	try {
-		return parseConfig(JSON.parse(readFileSync(path, "utf8")));
+		return parseConfig(mergeConfigInputs(hasProjectConfig ? readConfigFile(projectPath) : void 0, hasUserConfig ? readConfigFile(path) : void 0));
 	} catch (error) {
 		if (error instanceof CapletsError) throw error;
 		throw new CapletsError("CONFIG_INVALID", "Caplets config is not valid JSON", redactSecrets(error));
 	}
 }
+function readConfigFile(path) {
+	try {
+		return JSON.parse(readFileSync(path, "utf8"));
+	} catch (error) {
+		throw new CapletsError("CONFIG_INVALID", `Caplets config at ${path} is not valid JSON`, redactSecrets(error));
+	}
+}
+function mergeConfigInputs(projectConfig, userConfig) {
+	if (projectConfig === void 0) return userConfig;
+	if (userConfig === void 0) return projectConfig;
+	if (!isPlainConfigObject(projectConfig) || !isPlainConfigObject(userConfig)) return userConfig;
+	return {
+		...userConfig,
+		...projectConfig,
+		mcpServers: {
+			...userConfig.mcpServers,
+			...projectConfig.mcpServers
+		}
+	};
+}
+function isPlainConfigObject(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function parseConfig(input) {
 	const parsed = configFileSchema.safeParse(interpolateServer(input));
 	if (!parsed.success) throw new CapletsError("CONFIG_INVALID", "Caplets config is invalid", parsed.error.issues);
@@ -23477,11 +23506,11 @@ var FileOAuthProvider = class {
 	codeVerifier() {
 		return this.verifier;
 	}
-	async addClientAuthentication(headers, params) {
+	addClientAuthentication = async (headers, params) => {
 		if (this.server.auth?.type !== "oauth2" || !this.server.auth.clientSecret) return;
 		params.set("client_secret", this.server.auth.clientSecret);
 		headers.set("content-type", "application/x-www-form-urlencoded");
-	}
+	};
 };
 async function runOAuthFlow(server, options = {}) {
 	if (server.transport === "stdio" || !server.url || server.auth?.type !== "oauth2") throw new CapletsError("REQUEST_INVALID", `${server.server} is not a configured OAuth remote server`);
@@ -23815,7 +23844,16 @@ var ServerRegistry = class {
 	}
 };
 function capabilityDescription(server) {
-	const hint = `Use this tool to inspect and call tools from ${server.server}. Start with search_tools or list_tools; use get_tool for schema; use call_tool to invoke.`;
+	const hint = [
+		`Use this Caplets wrapper to inspect and call tools from ${server.server}.`,
+		"",
+		"Recommended flow:",
+		"- 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\":{...}}",
+		"",
+		"Important: call_tool requires a top-level \"arguments\" JSON object containing the downstream tool inputs. Do not put downstream arguments at the top level of this wrapper request."
+	].join("\n");
 	return `${server.name}\n\n${server.description}\n\n${hint}`;
 }
 //#endregion
@@ -23829,11 +23867,15 @@ const operations = [
 	"call_tool"
 ];
 const generatedToolInputSchema = object({
-	operation: _enum(operations).describe("Operation to perform for this configured MCP server."),
-	query: string().optional().describe("Required for search_tools."),
-	limit: number$1().int().positive().optional().describe("Optional for search_tools; defaults to configured limit."),
-	tool: string().optional().describe("Exact downstream tool name for get_tool or call_tool."),
-	arguments: record(string(), unknown()).optional().describe("JSON object arguments for call_tool.")
+	operation: _enum(operations).describe([
+		"Caplets wrapper operation to perform for this configured MCP server.",
+		"Use 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.",
+		"For call_tool, pass downstream inputs only inside the top-level \"arguments\" object."
+	].join(" ")),
+	query: string().optional().describe("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."),
+	limit: number$1().int().positive().optional().describe("Optional only for search_tools; defaults to the configured search limit. For downstream result limits, use call_tool.arguments with the downstream schema field name."),
+	tool: string().optional().describe("Exact downstream tool name for get_tool or call_tool. Example: {\"operation\":\"get_tool\",\"tool\":\"web_search_exa\"} before calling it."),
+	arguments: record(string(), unknown()).optional().describe("Required JSON object only for call_tool. Put every downstream tool input inside this object. Example: {\"operation\":\"call_tool\",\"tool\":\"web_search_exa\",\"arguments\":{\"query\":\"latest MCP docs\",\"numResults\":3}}. Do not send downstream inputs as top-level query, limit, url, path, or other fields.")
 }).strict();
 async function handleServerTool(server, request, registry, downstream) {
 	const parsed = validateOperationRequest(request, registry.config.options.maxSearchLimit);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caplets",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Progressive disclosure gateway for MCP servers.",
   "keywords": [
     "caplets",