@farming-labs/docs 0.2.59 → 0.2.60

package/dist/cli/index.mjs

@@ -67,6 +67,7 @@ async function main() {
 		setup: subcommand === "setup",
 		deploymentId: typeof flags.deployment === "string" ? flags.deployment : void 0,
 		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		client: typeof flags.client === "string" ? flags.client : void 0,
 		json: typeof flags.json === "boolean" ? flags.json : void 0
 	};
 	const devOptions = {
@@ -105,10 +106,10 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-B_9ENq8Z.mjs");
+		const { init } = await import("../init-Bd_k06bR.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-CAQlbguk.mjs");
+		const { dev } = await import("../dev-DgY5xGl9.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
 		const { runCloudDeploy } = await import("../cloud-BH_sHX64.mjs");
@@ -138,7 +139,7 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-BAJr3wC2.mjs");
+		const { runMcp } = await import("../mcp-B_yXL5G5.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
 		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DlxriaTs.mjs").then((n) => n.t);
@@ -316,7 +317,8 @@ ${pc.dim("Options for mcp:")}
   ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
   ${pc.cyan("mcp setup --deployment <id>")} Print Docs Cloud hosted MCP setup for a deployment id
   ${pc.cyan("--api-base-url <url>")} Override the hosted Docs Cloud API base URL for ${pc.cyan("mcp setup")}
-  ${pc.cyan("--json")}              Print MCP client JSON only for ${pc.cyan("mcp setup")}
+  ${pc.cyan("--client <name>")}     Emit native config for ${pc.dim("claude-code")}, ${pc.dim("cursor")}, or ${pc.dim("vscode")}
+  ${pc.cyan("--json")}              Print the selected MCP client JSON only for ${pc.cyan("mcp setup")}
 
 ${pc.dim("Options for dev:")}
   ${pc.cyan("--port <number>")}     Run the frameworkless preview on a custom port

package/dist/{dev-CAQlbguk.mjs → dev-DgY5xGl9.mjs}

@@ -1,5 +1,5 @@
 import { i as detectPackageManagerFromProject } from "./utils-6UCLxv4B.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-CfQjpDWW.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-DNw15P-x.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";

package/dist/{init-B_9ENq8Z.mjs → init-Bd_k06bR.mjs}

@@ -1,5 +1,5 @@
 import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-6UCLxv4B.mjs";
-import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-CfQjpDWW.mjs";
+import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-DNw15P-x.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{mcp-BAJr3wC2.mjs → mcp-B_yXL5G5.mjs}

@@ -10,6 +10,16 @@ import { readFileSync } from "node:fs";
 import pc from "picocolors";
 
 //#region src/cli/mcp.ts
+const HOSTED_MCP_CLIENTS = [
+	"claude-code",
+	"cursor",
+	"vscode"
+];
+const HOSTED_MCP_CLIENT_LABELS = {
+	"claude-code": "Claude Code",
+	cursor: "Cursor",
+	vscode: "VS Code"
+};
 async function runMcp(options = {}) {
 	if (options.setup) {
 		printHostedMcpSetup(options);
@@ -35,6 +45,38 @@ async function runMcp(options = {}) {
 function normalizeApiBaseUrl(value) {
 	return (value?.trim() || "https://api.farming-labs.dev").replace(/\/+$/g, "");
 }
+function normalizeHostedMcpClient(value) {
+	const normalized = value?.trim().toLowerCase() || "claude-code";
+	if (normalized === "claude") return "claude-code";
+	if (HOSTED_MCP_CLIENTS.includes(normalized)) return normalized;
+	throw new Error(`Unsupported MCP client "${value}". Expected one of: ${HOSTED_MCP_CLIENTS.join(", ")}.`);
+}
+function createHostedMcpClientConfig(deploymentId, apiBaseUrl, clientName) {
+	const endpoint = `${normalizeApiBaseUrl(apiBaseUrl)}/v1/mcp/${deploymentId.trim()}`;
+	const client = normalizeHostedMcpClient(clientName);
+	if (client === "cursor") return { mcpServers: { "docs-cloud": {
+		url: endpoint,
+		headers: { Authorization: "Bearer ${env:DOCS_CLOUD_API_KEY}" }
+	} } };
+	if (client === "vscode") return {
+		inputs: [{
+			type: "promptString",
+			id: "docs-cloud-api-key",
+			description: "Docs Cloud API key",
+			password: true
+		}],
+		servers: { "docs-cloud": {
+			type: "http",
+			url: endpoint,
+			headers: { Authorization: "Bearer ${input:docs-cloud-api-key}" }
+		} }
+	};
+	return { mcpServers: { "docs-cloud": {
+		type: "http",
+		url: endpoint,
+		headers: { Authorization: "Bearer ${DOCS_CLOUD_API_KEY}" }
+	} } };
+}
 function printHostedMcpSetup(options) {
 	const deploymentId = options.deploymentId?.trim();
 	if (!deploymentId) {
@@ -43,17 +85,9 @@ function printHostedMcpSetup(options) {
 		console.error(`Run ${pc.cyan("npx @farming-labs/docs mcp setup --deployment <deployment-id>")}.`);
 		process.exit(1);
 	}
+	const client = normalizeHostedMcpClient(options.client);
+	const jsonConfig = createHostedMcpClientConfig(deploymentId, options.apiBaseUrl, client);
 	const endpoint = `${normalizeApiBaseUrl(options.apiBaseUrl)}/v1/mcp/${deploymentId}`;
-	const jsonConfig = { mcpServers: { "docs-cloud": {
-		command: "npx",
-		args: [
-			"@farming-labs/docs",
-			"mcp",
-			"setup",
-			"--deployment",
-			deploymentId
-		]
-	} } };
 	if (options.json) {
 		console.log(JSON.stringify(jsonConfig, null, 2));
 		return;
@@ -61,19 +95,18 @@ function printHostedMcpSetup(options) {
 	console.log(pc.bold("Docs Cloud MCP deployment"));
 	console.log(pc.dim(`Deployment: ${deploymentId}`));
 	console.log();
-	console.log(pc.cyan("CLI stdio"));
-	console.log(`  npx @farming-labs/docs mcp setup --deployment ${deploymentId}`);
-	console.log();
-	console.log(pc.cyan("Streamable HTTP"));
+	console.log(pc.cyan("Streamable HTTP (recommended)"));
 	console.log(`  ${endpoint}`);
 	console.log();
 	console.log(pc.cyan("SSE"));
 	console.log(`  ${endpoint}/sse`);
 	console.log();
-	console.log(pc.cyan("MCP client JSON"));
+	console.log(pc.cyan(`MCP client JSON (${HOSTED_MCP_CLIENT_LABELS[client]})`));
 	console.log(JSON.stringify(jsonConfig, null, 2));
 	console.log();
-	console.log(pc.dim("Set DOCS_CLOUD_API_KEY in the agent environment before connecting."));
+	if (client === "vscode") console.log(pc.dim("VS Code prompts for the API key once and stores it securely."));
+	else console.log(pc.dim("The config reads DOCS_CLOUD_API_KEY from the MCP client environment; no secret is embedded."));
+	console.log(pc.dim("Use --client cursor or --client vscode to emit another native format."));
 }
 function readMcpConfig(content) {
 	if (content.match(/mcp\s*:\s*false/)) return false;

package/dist/{templates-CfQjpDWW.mjs → templates-DNw15P-x.mjs}

@@ -886,6 +886,7 @@ function tanstackDocsPublicRouteTemplate(useAlias, filePath, entry) {
 import { createFileRoute } from "@tanstack/react-router";
 import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
 import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+import docsConfig from "${tanstackDocsConfigImport(filePath)}";
 
 const docsEntry = ${JSON.stringify(entry)};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.59",
+  "version": "0.2.60",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",