pulumi-package-docs 0.8.0 → 0.9.0

package/dist/client/assets/providers._name-C-FSbmVZ.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{s as t}from"./index-DM9VsIdh.js";var n=e(),r=()=>(0,n.jsx)(t,{});export{r as component};

package/dist/client/assets/providers._name.functions._token-B3S8Gcfx.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{c as t}from"./index-DM9VsIdh.js";var n=e(),r=()=>(0,n.jsx)(`main`,{children:(0,n.jsxs)(`p`,{children:[`No function with that name was found.`,` `,(0,n.jsx)(t,{to:`/`,children:`Back to all providers.`})]})});export{r as notFoundComponent};

package/dist/client/assets/providers._name.functions._token-C4VPHGlG.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{n as t,r as n}from"./index-DM9VsIdh.js";import{t as r}from"./MemberDetail-D8jkDkVP.js";var i=e();function a(){let{providerName:e,token:a,fn:o,runtime:s}=t.useLoaderData();return(0,i.jsx)(r,{providerName:e,kind:`Function`,displayName:n(a),token:a,description:o.description,runtime:s,inputProperties:o.inputs?.properties,requiredInputs:o.inputs?.required,outputProperties:o.outputs?.properties,requiredOutputs:o.outputs?.required})}export{a as component};

package/dist/client/assets/providers._name.index-CWHPtoBD.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{c as t}from"./index-DM9VsIdh.js";var n=e(),r=()=>(0,n.jsx)(`main`,{children:(0,n.jsxs)(`p`,{children:[`No local provider with that name was found.`,` `,(0,n.jsx)(t,{to:`/`,children:`Back to all providers.`})]})});export{r as notFoundComponent};

package/dist/client/assets/providers._name.index-nlnQuJ9Q.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{a as t,c as n,i as r,r as i}from"./index-DM9VsIdh.js";import{a,i as o}from"./examples-zkHFEaMt.js";var s=e();function c({token:e,member:t,runtime:c,to:l,providerName:u}){let d=o(a(t.description,c)),f=`deprecationMessage`in t&&t.deprecationMessage;return(0,s.jsxs)(`li`,{className:`doc-list-item`,children:[(0,s.jsx)(n,{to:l,params:{name:u,token:r(e)},children:(0,s.jsx)(`code`,{children:i(e)})}),f&&(0,s.jsx)(`span`,{className:`badge badge-warning`,children:`Deprecated`}),d&&(0,s.jsx)(`p`,{className:`doc-summary`,children:d})]})}function l(){let{ref:e,schema:r,origin:i,error:o,runtime:l}=t.useLoaderData(),u=Object.entries(r?.resources??{}),d=Object.entries(r?.functions??{});return(0,s.jsxs)(`main`,{className:`provider-detail`,children:[(0,s.jsx)(n,{to:`/`,className:`back-link`,children:`← All providers`}),(0,s.jsx)(`h1`,{children:e.name}),(0,s.jsxs)(`p`,{className:`subtitle`,children:[e.source,e.version?` @ ${e.version}`:``,e.parameters?.length?` (${e.parameters.join(` `)})`:``]}),i===`error`||!r?(0,s.jsxs)(`p`,{className:`banner banner-failure`,children:[`Failed to load schema: `,o??`unknown error`]}):(0,s.jsxs)(s.Fragment,{children:[i===`cache`&&(0,s.jsxs)(`p`,{className:`banner banner-info`,children:[`Showing a cached schema (the `,(0,s.jsx)(`code`,{children:`pulumi`}),` CLI call failed on this load).`]}),r.description&&(0,s.jsx)(`p`,{children:a(r.description,l)}),(0,s.jsx)(`h2`,{children:`Resources`}),u.length===0?(0,s.jsx)(`p`,{className:`empty-state`,children:`No resources.`}):(0,s.jsx)(`ul`,{className:`doc-list`,children:u.map(([t,n])=>(0,s.jsx)(c,{token:t,member:n,runtime:l,to:`/providers/$name/resources/$token`,providerName:e.name},t))}),(0,s.jsx)(`h2`,{children:`Functions`}),d.length===0?(0,s.jsx)(`p`,{className:`empty-state`,children:`No functions.`}):(0,s.jsx)(`ul`,{className:`doc-list`,children:d.map(([t,n])=>(0,s.jsx)(c,{token:t,member:n,runtime:l,to:`/providers/$name/functions/$token`,providerName:e.name},t))})]})]})}export{l as component};

package/dist/client/assets/providers._name.resources._token-BISpZVHI.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{r as t,t as n}from"./index-DM9VsIdh.js";import{t as r}from"./MemberDetail-D8jkDkVP.js";var i=e();function a(){let{providerName:e,token:a,resource:o,runtime:s}=n.useLoaderData();return(0,i.jsx)(r,{providerName:e,kind:`Resource`,displayName:t(a),token:a,description:o.description,deprecationMessage:o.deprecationMessage,runtime:s,inputProperties:o.inputProperties,requiredInputs:o.requiredInputs,outputProperties:o.properties,requiredOutputs:o.required})}export{a as component};

package/dist/client/assets/providers._name.resources._token-CvMi94a3.js

@@ -0,0 +1 @@
+import{o as e}from"./useSelector-BIt42tGI.js";import{c as t}from"./index-DM9VsIdh.js";var n=e(),r=()=>(0,n.jsx)(`main`,{children:(0,n.jsxs)(`p`,{children:[`No resource with that name was found.`,` `,(0,n.jsx)(t,{to:`/`,children:`Back to all providers.`})]})});export{r as notFoundComponent};

package/dist/client/assets/{routes-DKNWlgPZ.js → routes-DwhZQHE3.js}

@@ -1 +1 @@
-import{o as e}from"./useSelector-BIt42tGI.js";import{i as t,o as n}from"./index-2FzxAhzN.js";var r=e();function i(){let{targetDir:e,project:i,providers:a}=t.useLoaderData();return i?(0,r.jsxs)(`main`,{children:[(0,r.jsx)(`h1`,{children:`Pulumi Package Docs`}),(0,r.jsxs)(`p`,{className:`subtitle`,children:[i.name??`Pulumi project`,` · `,(0,r.jsx)(`code`,{children:i.root})]}),a.length===0?(0,r.jsxs)(`p`,{className:`empty-state`,children:[`This project's `,(0,r.jsx)(`code`,{children:`Pulumi.yaml`}),` has no `,(0,r.jsx)(`code`,{children:`packages`}),` `,`section, so there are no local or parameterized providers to show docs for yet. Add one with `,(0,r.jsx)(`code`,{children:`pulumi package add`}),`.`]}):(0,r.jsx)(`ul`,{className:`provider-list`,children:a.map(e=>(0,r.jsxs)(`li`,{className:`provider-card`,children:[(0,r.jsxs)(n,{to:`/providers/$name`,params:{name:e.name},children:[(0,r.jsx)(`span`,{className:`provider-name`,children:e.name}),(0,r.jsxs)(`span`,{className:`provider-source`,children:[e.source,e.version?` @ ${e.version}`:``,e.parameters?.length?` (${e.parameters.join(` `)})`:``]})]}),e.origin===`error`?(0,r.jsxs)(`p`,{className:`banner banner-failure`,children:[`Failed to load schema: `,e.error]}):(0,r.jsxs)(`p`,{className:`provider-stats`,children:[e.resourceCount,` resource`,e.resourceCount===1?``:`s`,` · `,e.functionCount,` function`,e.functionCount===1?``:`s`,e.origin===`cache`&&(0,r.jsxs)(r.Fragment,{children:[` · `,(0,r.jsx)(`span`,{className:`badge badge-info`,children:`from cache`})]})]})]},e.name))})]}):(0,r.jsxs)(`main`,{children:[(0,r.jsx)(`h1`,{children:`Pulumi Package Docs`}),(0,r.jsxs)(`p`,{className:`empty-state`,children:[`No Pulumi project was found at `,(0,r.jsx)(`code`,{children:e}),` (or any parent directory). Run this from inside a Pulumi project directory, or with`,` `,(0,r.jsx)(`code`,{children:`--dir <path>`}),` pointing at one.`]})]})}export{i as component};
+import{o as e}from"./useSelector-BIt42tGI.js";import{c as t,o as n}from"./index-DM9VsIdh.js";var r=e();function i(){let{targetDir:e,project:i,providers:a}=n.useLoaderData();return i?(0,r.jsxs)(`main`,{children:[(0,r.jsx)(`h1`,{children:`Pulumi Package Docs`}),(0,r.jsxs)(`p`,{className:`subtitle`,children:[i.name??`Pulumi project`,` · `,(0,r.jsx)(`code`,{children:i.root})]}),a.length===0?(0,r.jsxs)(`p`,{className:`empty-state`,children:[`This project's `,(0,r.jsx)(`code`,{children:`Pulumi.yaml`}),` has no `,(0,r.jsx)(`code`,{children:`packages`}),` `,`section, so there are no local or parameterized providers to show docs for yet. Add one with `,(0,r.jsx)(`code`,{children:`pulumi package add`}),`.`]}):(0,r.jsx)(`ul`,{className:`provider-list`,children:a.map(e=>(0,r.jsxs)(`li`,{className:`provider-card`,children:[(0,r.jsxs)(t,{to:`/providers/$name`,params:{name:e.name},children:[(0,r.jsx)(`span`,{className:`provider-name`,children:e.name}),(0,r.jsxs)(`span`,{className:`provider-source`,children:[e.source,e.version?` @ ${e.version}`:``,e.parameters?.length?` (${e.parameters.join(` `)})`:``]})]}),e.origin===`error`?(0,r.jsxs)(`p`,{className:`banner banner-failure`,children:[`Failed to load schema: `,e.error]}):(0,r.jsxs)(`p`,{className:`provider-stats`,children:[e.resourceCount,` resource`,e.resourceCount===1?``:`s`,` · `,e.functionCount,` function`,e.functionCount===1?``:`s`,e.origin===`cache`&&(0,r.jsxs)(r.Fragment,{children:[` · `,(0,r.jsx)(`span`,{className:`badge badge-info`,children:`from cache`})]})]})]},e.name))})]}):(0,r.jsxs)(`main`,{children:[(0,r.jsx)(`h1`,{children:`Pulumi Package Docs`}),(0,r.jsxs)(`p`,{className:`empty-state`,children:[`No Pulumi project was found at `,(0,r.jsx)(`code`,{children:e}),` (or any parent directory). Run this from inside a Pulumi project directory, or with`,` `,(0,r.jsx)(`code`,{children:`--dir <path>`}),` pointing at one.`]})]})}export{i as component};

package/dist/mcp/stdio.js

@@ -0,0 +1,449 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse } from "yaml";
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import { promisify } from "node:util";
+//#region src/lib/pulumi/description.ts
+/**
+* Pulumi schema descriptions embed per-language text as HTML-ish spans, e.g.
+* `<span pulumi-lang-nodejs="`length`" pulumi-lang-python="`length`" ...>`length`</span>`.
+* pulumi.com's docs site picks an attribute based on the selected language tab;
+* we don't have tabs, so we resolve each span to the project's own runtime up
+* front and strip the markup rather than rendering (or leaking) raw HTML.
+*/
+var LANG_SPAN_RE = /<span\s+((?:pulumi-lang-[a-z]+="[^"]*"\s*)+)>([\s\S]*?)<\/span>/g;
+var LANG_ATTR_RE = /pulumi-lang-([a-z]+)="([^"]*)"/g;
+function resolveLangSpans(text, runtime) {
+	return text.replace(LANG_SPAN_RE, (_match, attrsSource, fallback) => {
+		if (!runtime) return fallback;
+		LANG_ATTR_RE.lastIndex = 0;
+		let match;
+		while (match = LANG_ATTR_RE.exec(attrsSource)) if (match[1] === runtime) return match[2];
+		return fallback;
+	});
+}
+/** Resolves a schema description's per-language spans for the given Pulumi runtime. */
+function resolveDescription(text, runtime) {
+	if (!text) return text;
+	return resolveLangSpans(text, runtime);
+}
+//#endregion
+//#region src/lib/pulumi/discovery.server.ts
+var PROJECT_FILE_NAMES = ["Pulumi.yaml", "Pulumi.yml"];
+/**
+* The directory of the Pulumi program to inspect. `bin/cli.js` sets this to the
+* directory the user ran `npx pulumi-package-docs` from, since the dev/preview
+* server itself runs with this package's own directory as its cwd.
+*/
+function getTargetDir() {
+	return process.env.PULUMI_LOCAL_DOCS_DIR || process.cwd();
+}
+function findProjectFile(startDir) {
+	let dir = startDir;
+	for (;;) {
+		for (const fileName of PROJECT_FILE_NAMES) {
+			const candidate = join(dir, fileName);
+			if (existsSync(candidate)) return candidate;
+		}
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+function toLocalPackageRefs(packages) {
+	if (!packages || typeof packages !== "object") return [];
+	return Object.entries(packages).map(([name, value]) => {
+		const entry = value ?? {};
+		const parameters = Array.isArray(entry.parameters) ? entry.parameters.filter((p) => typeof p === "string") : void 0;
+		return {
+			name,
+			source: typeof entry.source === "string" ? entry.source : name,
+			version: typeof entry.version === "string" ? entry.version : void 0,
+			parameters
+		};
+	});
+}
+/**
+* Walks up from `startDir` looking for a Pulumi.yaml/Pulumi.yml, then reads its
+* `packages` section to find the local/parameterized providers used by the project.
+*/
+function loadPulumiProject(startDir = getTargetDir()) {
+	const projectFile = findProjectFile(startDir);
+	if (!projectFile) return null;
+	const raw = readFileSync(projectFile, "utf-8");
+	const doc = parse(raw);
+	return {
+		root: dirname(projectFile),
+		name: typeof doc?.name === "string" ? doc.name : void 0,
+		runtime: typeof doc?.runtime === "string" ? doc.runtime : typeof (doc?.runtime)?.name === "string" ? doc.runtime.name : void 0,
+		packages: toLocalPackageRefs(doc?.packages)
+	};
+}
+//#endregion
+//#region src/lib/pulumi/examples.ts
+var CODE_FENCE_RE = /```([a-zA-Z0-9+#-]+)\n([\s\S]*?)```/g;
+function extractExamples(text) {
+	if (!text) return [];
+	return [...text.matchAll(CODE_FENCE_RE)].map((match) => ({
+		language: match[1].toLowerCase(),
+		code: match[2].trimEnd()
+	}));
+}
+/** The description text with any fenced code examples removed. */
+function stripExamples(text) {
+	if (!text) return text;
+	return text.replace(CODE_FENCE_RE, "").trim() || void 0;
+}
+/** A short summary for list views: the first prose paragraph, examples excluded. */
+function summarizeDescription(text) {
+	const stripped = stripExamples(text);
+	if (!stripped) return void 0;
+	return stripped.split(/\n{2,}/)[0]?.trim() || void 0;
+}
+var RUNTIME_LANGUAGES = {
+	nodejs: ["typescript", "javascript"],
+	python: ["python"],
+	go: ["go", "golang"],
+	dotnet: ["csharp"],
+	java: ["java"],
+	yaml: ["yaml"]
+};
+/** Picks the example matching the project's runtime, falling back to the first available one. */
+function pickExample(examples, runtime) {
+	const languages = runtime ? RUNTIME_LANGUAGES[runtime] : void 0;
+	return (languages ? examples.find((example) => languages.includes(example.language)) : void 0) ?? examples[0];
+}
+//#endregion
+//#region src/lib/pulumi/format.ts
+function formatType(prop) {
+	if (!prop) return "any";
+	if (prop.$ref) {
+		const short = prop.$ref.split("/").pop() ?? prop.$ref;
+		return decodeURIComponent(short);
+	}
+	if (prop.type === "array" && prop.items) return `${formatType(prop.items)}[]`;
+	return prop.type ?? "any";
+}
+//#endregion
+//#region src/lib/pulumi/naming.ts
+/**
+* Pulumi schema property names are always camelCase; each language's generated
+* SDK renders them in that language's own convention. This approximates that
+* per-runtime rendering for display purposes (it doesn't reproduce Pulumi's
+* codegen exactly, e.g. its acronym handling, but matches the common case).
+*/
+function toSnakeCase(name) {
+	return name.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").toLowerCase();
+}
+function toPascalCase(name) {
+	if (name.length === 0) return name;
+	return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/** Renders a schema property name the way it would appear in the given Pulumi runtime's generated SDK. */
+function formatPropertyName(name, runtime) {
+	switch (runtime) {
+		case "python": return toSnakeCase(name);
+		case "go":
+		case "dotnet": return toPascalCase(name);
+		default: return name;
+	}
+}
+//#endregion
+//#region src/lib/pulumi/schema.server.ts
+var execFileAsync = promisify(execFile);
+var CLI_TIMEOUT_MS = 6e4;
+var MAX_BUFFER_BYTES = 67108864;
+function cacheFilePath(projectRoot, ref) {
+	const projectHash = createHash("sha256").update(projectRoot).digest("hex").slice(0, 16);
+	const dir = join(tmpdir(), "pulumi-package-docs", projectHash);
+	mkdirSync(dir, { recursive: true });
+	return join(dir, `${ref.name}.json`);
+}
+function readCache(path) {
+	if (!existsSync(path)) return null;
+	try {
+		return JSON.parse(readFileSync(path, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+async function fetchViaCli(projectRoot, ref) {
+	const { stdout } = await execFileAsync("pulumi", [
+		"package",
+		"get-schema",
+		ref.source,
+		...ref.parameters ?? []
+	], {
+		cwd: projectRoot,
+		timeout: CLI_TIMEOUT_MS,
+		maxBuffer: MAX_BUFFER_BYTES
+	});
+	return JSON.parse(stdout);
+}
+/**
+* Resolves the schema for a local package: try the `pulumi` CLI first (it's the
+* source of truth and works for parameterized providers), and fall back to the
+* last schema we successfully cached for this project if the CLI call fails.
+*/
+async function resolveProviderSchema(projectRoot, ref) {
+	const cachePath = cacheFilePath(projectRoot, ref);
+	try {
+		const schema = await fetchViaCli(projectRoot, ref);
+		writeFileSync(cachePath, JSON.stringify(schema));
+		return {
+			ref,
+			schema,
+			origin: "cli"
+		};
+	} catch (cliError) {
+		const cached = readCache(cachePath);
+		if (cached) return {
+			ref,
+			schema: cached,
+			origin: "cache"
+		};
+		return {
+			ref,
+			schema: null,
+			origin: "error",
+			error: cliError instanceof Error ? cliError.message : String(cliError)
+		};
+	}
+}
+//#endregion
+//#region src/lib/pulumi/providers.server.ts
+/**
+* The project + provider summaries shown on the index route and by the MCP
+* `list_providers` tool. Plain async functions (no TanStack Start server-fn
+* wrapper) so they can run either inside the web server or in the stdio MCP
+* process, which has no HTTP server at all.
+*/
+async function loadProjectSummary() {
+	const targetDir = getTargetDir();
+	const project = loadPulumiProject(targetDir);
+	if (!project) return {
+		targetDir,
+		project: null,
+		providers: []
+	};
+	const providers = (await Promise.all(project.packages.map((ref) => resolveProviderSchema(project.root, ref)))).map((entry) => ({
+		name: entry.ref.name,
+		source: entry.ref.source,
+		version: entry.ref.version,
+		parameters: entry.ref.parameters,
+		resourceCount: Object.keys(entry.schema?.resources ?? {}).length,
+		functionCount: Object.keys(entry.schema?.functions ?? {}).length,
+		origin: entry.origin,
+		error: entry.error
+	}));
+	return {
+		targetDir,
+		project: {
+			root: project.root,
+			name: project.name,
+			runtime: project.runtime
+		},
+		providers
+	};
+}
+/** The fully resolved schema for one local provider, or null if the project or provider isn't found. */
+async function loadProviderDetail(name) {
+	const project = loadPulumiProject(getTargetDir());
+	if (!project) return null;
+	const ref = project.packages.find((p) => p.name === name);
+	if (!ref) return null;
+	return {
+		...await resolveProviderSchema(project.root, ref),
+		runtime: project.runtime
+	};
+}
+//#endregion
+//#region src/lib/pulumi/token.ts
+/**
+* Schema tokens look like `random:index/randomString:RandomString` (resources)
+* or `random:index/randomInteger:randomInteger` (functions). The segment after
+* the last colon is the name every generated SDK exports for that member, and
+* is unique within the provider, so it makes a readable display name.
+*/
+function tokenDisplayName(token) {
+	const short = token.split(":").pop();
+	return short && short.length > 0 ? short : token;
+}
+//#endregion
+//#region src/lib/pulumi/mcp.server.ts
+function textResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data, null, 2)
+	}] };
+}
+/** Loads a local provider's resolved schema, throwing a descriptive error a tool call can surface to the client. */
+async function requireProvider(providerName) {
+	const detail = await loadProviderDetail(providerName);
+	if (!detail) throw new Error(`No local provider named "${providerName}" was found. Call list_providers to see the providers declared in this project's Pulumi.yaml.`);
+	if (!detail.schema) throw new Error(`Failed to load the schema for provider "${providerName}": ${detail.error ?? "unknown error"}`);
+	return {
+		...detail,
+		schema: detail.schema
+	};
+}
+function summarizeMember(token, member, runtime) {
+	return {
+		token,
+		name: tokenDisplayName(token),
+		deprecated: Boolean("deprecationMessage" in member && member.deprecationMessage),
+		summary: summarizeDescription(resolveDescription(member.description, runtime))
+	};
+}
+function formatProperties(properties, required, runtime) {
+	const requiredSet = new Set(required ?? []);
+	return Object.entries(properties ?? {}).map(([name, prop]) => ({
+		name: formatPropertyName(name, runtime),
+		type: formatType(prop),
+		required: requiredSet.has(name),
+		description: resolveDescription(prop.description, runtime)
+	}));
+}
+function memberDetail(provider, token, description, runtime, inputs, outputs, deprecationMessage) {
+	const resolved = resolveDescription(description, runtime);
+	const example = pickExample(extractExamples(resolved), runtime);
+	return {
+		provider,
+		token,
+		name: tokenDisplayName(token),
+		deprecationMessage,
+		description: stripExamples(resolved),
+		example: example ?? null,
+		inputs,
+		outputs
+	};
+}
+/**
+* Builds a fresh MCP server with the local-provider-docs tools registered. Transport
+* agnostic: `src/routes/mcp.ts` calls it once per HTTP request (so concurrent requests
+* never share state), and `src/lib/pulumi/stdio.server.ts` calls it once for the
+* lifetime of a stdio process.
+*/
+function createMcpServer() {
+	const server = new McpServer({
+		name: "pulumi-package-docs",
+		version: "0.1.0"
+	});
+	server.registerTool("list_providers", {
+		title: "List local providers",
+		description: "List the local/parameterized Pulumi providers declared in this project's Pulumi.yaml (added with `pulumi package add`), with their source, version, and resource/function counts."
+	}, async () => textResult(await loadProjectSummary()));
+	server.registerTool("list_resources", {
+		title: "List a provider’s resources",
+		description: "List the resource tokens for a local provider, each with a display name, a one-line summary, and whether it is deprecated. Use get_resource for full details (inputs/outputs/example) on one of them.",
+		inputSchema: { provider: z.string().describe("The provider name as it appears in Pulumi.yaml and list_providers, e.g. \"random\".") }
+	}, async ({ provider }) => {
+		const detail = await requireProvider(provider);
+		const resources = Object.entries(detail.schema.resources ?? {}).map(([token, resource]) => summarizeMember(token, resource, detail.runtime));
+		return textResult({
+			provider,
+			resourceCount: resources.length,
+			resources
+		});
+	});
+	server.registerTool("list_functions", {
+		title: "List a provider’s functions",
+		description: "List the function (data source) tokens for a local provider, each with a display name, a one-line summary, and whether it is deprecated. Use get_function for full details (inputs/outputs/example) on one of them.",
+		inputSchema: { provider: z.string().describe("The provider name as it appears in Pulumi.yaml and list_providers, e.g. \"random\".") }
+	}, async ({ provider }) => {
+		const detail = await requireProvider(provider);
+		const functions = Object.entries(detail.schema.functions ?? {}).map(([token, fn]) => summarizeMember(token, fn, detail.runtime));
+		return textResult({
+			provider,
+			functionCount: functions.length,
+			functions
+		});
+	});
+	server.registerTool("get_resource", {
+		title: "Get resource details",
+		description: "Get the full documentation for one resource of a local provider: its description, a usage example (in the Pulumi project’s own language), and its input and output properties (name, type, required, description). Get the exact token from list_resources first.",
+		inputSchema: {
+			provider: z.string().describe("The provider name, e.g. \"random\"."),
+			token: z.string().describe("The resource’s full schema token from list_resources, e.g. \"random:index/randomString:RandomString\".")
+		}
+	}, async ({ provider, token }) => {
+		const detail = await requireProvider(provider);
+		const resource = detail.schema.resources?.[token];
+		if (!resource) throw new Error(`No resource with token "${token}" in provider "${provider}". Call list_resources to find the exact token.`);
+		return textResult(memberDetail(provider, token, resource.description, detail.runtime, formatProperties(resource.inputProperties, resource.requiredInputs, detail.runtime), formatProperties(resource.properties, resource.required, detail.runtime), resource.deprecationMessage));
+	});
+	server.registerTool("get_function", {
+		title: "Get function details",
+		description: "Get the full documentation for one function (data source) of a local provider: its description, a usage example (in the Pulumi project’s own language), and its input and output properties. Get the exact token from list_functions first.",
+		inputSchema: {
+			provider: z.string().describe("The provider name, e.g. \"random\"."),
+			token: z.string().describe("The function’s full schema token from list_functions, e.g. \"random:index/randomInteger:getRandomInteger\".")
+		}
+	}, async ({ provider, token }) => {
+		const detail = await requireProvider(provider);
+		const fn = detail.schema.functions?.[token];
+		if (!fn) throw new Error(`No function with token "${token}" in provider "${provider}". Call list_functions to find the exact token.`);
+		return textResult(memberDetail(provider, token, fn.description, detail.runtime, formatProperties(fn.inputs?.properties, fn.inputs?.required, detail.runtime), formatProperties(fn.outputs?.properties, fn.outputs?.required, detail.runtime)));
+	});
+	server.registerTool("search_members", {
+		title: "Search resources and functions",
+		description: "Search resource and function tokens/descriptions across one or all local providers for a keyword. Use this instead of list_resources/list_functions when a provider is large or you only know roughly what you’re looking for (e.g. \"bucket\", \"random string\").",
+		inputSchema: {
+			query: z.string().describe("Case-insensitive text to search for."),
+			provider: z.string().optional().describe("Limit the search to this provider name. Omit to search all local providers.")
+		}
+	}, async ({ query, provider }) => {
+		const project = loadPulumiProject(getTargetDir());
+		if (!project) return textResult({
+			query,
+			matchCount: 0,
+			matches: []
+		});
+		const refs = provider ? project.packages.filter((p) => p.name === provider) : project.packages;
+		if (provider && refs.length === 0) throw new Error(`No local provider named "${provider}" was found. Call list_providers to see the providers declared in this project's Pulumi.yaml.`);
+		const needle = query.toLowerCase();
+		const matches = [];
+		for (const ref of refs) {
+			const entry = await resolveProviderSchema(project.root, ref);
+			if (!entry.schema) continue;
+			const groups = [["resource", entry.schema.resources], ["function", entry.schema.functions]];
+			for (const [kind, members] of groups) for (const [token, member] of Object.entries(members ?? {})) {
+				const name = tokenDisplayName(token);
+				const summary = summarizeDescription(resolveDescription(member.description, project.runtime));
+				if (`${name} ${token} ${summary ?? ""}`.toLowerCase().includes(needle)) matches.push({
+					provider: ref.name,
+					kind,
+					token,
+					name,
+					summary
+				});
+			}
+		}
+		return textResult({
+			query,
+			matchCount: matches.length,
+			matches: matches.slice(0, 50)
+		});
+	});
+	return server;
+}
+//#endregion
+//#region src/lib/pulumi/stdio.server.ts
+/**
+* Serves the same provider-docs tools as the `/mcp` HTTP route over stdio, for MCP
+* clients that spawn a server process instead of connecting to a URL.
+*
+* Unlike the HTTP route this is a single long-lived server (one process, one client),
+* and stdout is the protocol channel — nothing on this path may write to it, so any
+* diagnostics belong on stderr.
+*/
+async function runStdioMcpServer() {
+	await createMcpServer().connect(new StdioServerTransport());
+}
+//#endregion
+export { runStdioMcpServer };

package/dist/server/assets/{MemberDetail-C5sAHNZW.js → MemberDetail-CdHUSmQD.js}

@@ -1,4 +1,5 @@
-import { c as extractExamples, f as resolveDescription, l as pickExample, o as formatPropertyName, s as formatType, u as stripExamples } from "./router-1INob9fh.js";
+import { a as pickExample, c as resolveDescription, i as extractExamples, o as stripExamples } from "./token-DBEFeZIN.js";
+import { a as formatPropertyName, o as formatType } from "./router-_zs8P-B2.js";
 import { Link } from "@tanstack/react-router";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/CodeExample.tsx

package/dist/server/assets/{_tanstack-start-manifest_v-B0J-S-em.js → _tanstack-start-manifest_v-DNIp6gp3.js}

@@ -7,17 +7,17 @@ var tsrStartManifest = () => ({ routes: {
 			"/mcp",
 			"/providers/$name"
 		],
-		preloads: ["/assets/index-2FzxAhzN.js", "/assets/useSelector-BIt42tGI.js"],
+		preloads: ["/assets/index-DM9VsIdh.js", "/assets/useSelector-BIt42tGI.js"],
 		scripts: [{ attrs: {
 			type: "module",
 			async: !0,
-			src: "/assets/index-2FzxAhzN.js"
+			src: "/assets/index-DM9VsIdh.js"
 		} }]
 	},
 	"/": {
 		filePath: "/home/runner/work/pulumi-package-docs/pulumi-package-docs/src/routes/index.tsx",
 		children: void 0,
-		preloads: ["/assets/routes-DKNWlgPZ.js"]
+		preloads: ["/assets/routes-DwhZQHE3.js"]
 	},
 	"/providers/$name": {
 		filePath: "/home/runner/work/pulumi-package-docs/pulumi-package-docs/src/routes/providers.$name.tsx",
@@ -26,35 +26,33 @@ var tsrStartManifest = () => ({ routes: {
 			"/providers/$name/functions/$token",
 			"/providers/$name/resources/$token"
 		],
-		preloads: ["/assets/providers._name-FmJEVkdV.js"]
+		preloads: ["/assets/providers._name-C-FSbmVZ.js"]
 	},
 	"/providers/$name/": {
 		filePath: "/home/runner/work/pulumi-package-docs/pulumi-package-docs/src/routes/providers.$name.index.tsx",
 		children: void 0,
 		preloads: [
-			"/assets/providers._name.index-C42yQ95z.js",
-			"/assets/providers._name.index-Dm0YiZWP.js",
-			"/assets/token-oQmZfAP3.js"
+			"/assets/providers._name.index-CWHPtoBD.js",
+			"/assets/providers._name.index-nlnQuJ9Q.js",
+			"/assets/examples-zkHFEaMt.js"
 		]
 	},
 	"/providers/$name/functions/$token": {
 		filePath: "/home/runner/work/pulumi-package-docs/pulumi-package-docs/src/routes/providers.$name.functions.$token.tsx",
 		children: void 0,
 		preloads: [
-			"/assets/providers._name.functions._token-BzjmNHea.js",
-			"/assets/providers._name.functions._token-D768U6I-.js",
-			"/assets/MemberDetail-BS9DbqEt.js",
-			"/assets/token-oQmZfAP3.js"
+			"/assets/providers._name.functions._token-B3S8Gcfx.js",
+			"/assets/providers._name.functions._token-C4VPHGlG.js",
+			"/assets/MemberDetail-D8jkDkVP.js"
 		]
 	},
 	"/providers/$name/resources/$token": {
 		filePath: "/home/runner/work/pulumi-package-docs/pulumi-package-docs/src/routes/providers.$name.resources.$token.tsx",
 		children: void 0,
 		preloads: [
-			"/assets/providers._name.resources._token-CIYPoqyA.js",
-			"/assets/MemberDetail-BS9DbqEt.js",
-			"/assets/token-oQmZfAP3.js",
-			"/assets/providers._name.resources._token-D0OLvgo_.js"
+			"/assets/providers._name.resources._token-BISpZVHI.js",
+			"/assets/MemberDetail-D8jkDkVP.js",
+			"/assets/providers._name.resources._token-CvMi94a3.js"
 		]
 	}
 } });

package/dist/server/assets/api-D49ZDhMh.js

@@ -0,0 +1,27 @@
+import { n as TSS_SERVER_FUNCTION, t as createServerFn } from "../server.js";
+import { n as loadProviderDetail, t as loadProjectSummary } from "./providers.server-B1ZHZ5jE.js";
+//#region node_modules/@tanstack/start-server-core/dist/esm/createServerRpc.js
+var createServerRpc = (serverFnMeta, splitImportFn) => {
+	const url = "/_serverFn/" + serverFnMeta.id;
+	return Object.assign(splitImportFn, {
+		url,
+		serverFnMeta,
+		[TSS_SERVER_FUNCTION]: true
+	});
+};
+//#endregion
+//#region src/lib/pulumi/api.ts?tss-serverfn-split
+var listProviders_createServerFn_handler = createServerRpc({
+	id: "a3ba03544bae9a67523c84875835e6e9b6dfa1b22a99b2c4c57d7ae25dbf7350",
+	name: "listProviders",
+	filename: "src/lib/pulumi/api.ts"
+}, (opts) => listProviders.__executeServer(opts));
+var listProviders = createServerFn({ method: "GET" }).handler(listProviders_createServerFn_handler, () => loadProjectSummary());
+var getProvider_createServerFn_handler = createServerRpc({
+	id: "20c32dac0b2237041a59da458130ed4f320ce92dddd59a28b88581987c58d61d",
+	name: "getProvider",
+	filename: "src/lib/pulumi/api.ts"
+}, (opts) => getProvider.__executeServer(opts));
+var getProvider = createServerFn({ method: "GET" }).validator((name) => name).handler(getProvider_createServerFn_handler, ({ data: name }) => loadProviderDetail(name));
+//#endregion
+export { getProvider_createServerFn_handler, listProviders_createServerFn_handler };

package/dist/server/assets/{providers._name.functions._token-Gkw4zt3M.js → providers._name.functions._token-BvkwmQ-L.js}

@@ -1,5 +1,6 @@
-import { a as tokenDisplayName, r as Route } from "./router-1INob9fh.js";
-import { t as MemberDetail } from "./MemberDetail-C5sAHNZW.js";
+import { n as tokenDisplayName } from "./token-DBEFeZIN.js";
+import { r as Route } from "./router-_zs8P-B2.js";
+import { t as MemberDetail } from "./MemberDetail-CdHUSmQD.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/routes/providers.$name.functions.$token.tsx?tsr-split=component
 function FunctionDetail() {

package/dist/server/assets/{providers._name.index-CEXkl-76.js → providers._name.index-DBkfEjsy.js}

@@ -1,4 +1,5 @@
-import { a as tokenDisplayName, d as summarizeDescription, f as resolveDescription, i as Route } from "./router-1INob9fh.js";
+import { c as resolveDescription, n as tokenDisplayName, r as tokenSlug, s as summarizeDescription } from "./token-DBEFeZIN.js";
+import { i as Route } from "./router-_zs8P-B2.js";
 import { Link } from "@tanstack/react-router";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/routes/providers.$name.index.tsx?tsr-split=component
@@ -12,7 +13,7 @@ function MemberListItem({ token, member, runtime, to, providerName }) {
 				to,
 				params: {
 					name: providerName,
-					token
+					token: tokenSlug(token)
 				},
 				children: /* @__PURE__ */ jsx("code", { children: tokenDisplayName(token) })
 			}),

package/dist/server/assets/{providers._name.resources._token-R_i2MmRl.js → providers._name.resources._token-Sl31Qlvd.js}

@@ -1,5 +1,6 @@
-import { a as tokenDisplayName, n as Route } from "./router-1INob9fh.js";
-import { t as MemberDetail } from "./MemberDetail-C5sAHNZW.js";
+import { n as tokenDisplayName } from "./token-DBEFeZIN.js";
+import { n as Route } from "./router-_zs8P-B2.js";
+import { t as MemberDetail } from "./MemberDetail-CdHUSmQD.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/routes/providers.$name.resources.$token.tsx?tsr-split=component
 function ResourceDetail() {