@bestagentkits/render 0.2.0 → 0.3.0

package/dist/mcp/mcp-tool-definitions.js

@@ -0,0 +1,246 @@
+/**
+ * The MCP tool contract: one source of truth for every transport.
+ *
+ * The stdio server and the Streamable HTTP server list tools from here. The
+ * read-only tools (`catalog`, `search-catalog`, `describe`, `recipes`,
+ * `recipe`, `validate`) are complete and pure, so both transports run the very same function. `render`
+ * and `themes` differ only
+ * in where their output goes or where presets come from, so this module owns
+ * their descriptions, input schemas and result shapes, and each transport
+ * supplies the side effect: a local file for stdio, a stored artifact for HTTP.
+ *
+ * No Node-only import is allowed here; the Worker bundles this module.
+ */
+import { recipe, recipes } from '../recipes/index.js';
+import { BLOCK_CATEGORIES } from '../registry/block-module.js';
+import { CATALOG_SEARCH_LIMITS, searchCatalog } from '../registry/catalog-search.js';
+import { DESCRIBE_MANY_LIMIT, describeMany } from '../registry/describe-many.js';
+import { catalog, describe, formatCatalogJson } from '../registry/registry.js';
+import { validate } from '../spec/validate.js';
+import { builtinPresetEntries } from '../theme/presets.js';
+import { failure, ToolArgumentError, text } from './mcp-protocol.js';
+const SPEC_INPUT = {
+    description: 'The Page Spec: YAML or JSON text, or the parsed object.',
+    anyOf: [{ type: 'string' }, { type: 'object' }],
+};
+const THEME_INPUT = {
+    type: 'string',
+    description: 'Optional preset name overriding the spec theme.',
+};
+const NO_INPUT = { type: 'object', properties: {}, additionalProperties: false };
+export function requireString(args, key) {
+    const value = args[key];
+    if (typeof value !== 'string' || value === '') {
+        throw new ToolArgumentError(`"${key}" must be a non-empty string`);
+    }
+    return value;
+}
+/** The optional `theme` argument, normalized: an empty string means "not given". */
+export function optionalTheme(args) {
+    const theme = args.theme;
+    return typeof theme === 'string' && theme !== '' ? theme : undefined;
+}
+/** An optional string argument: absent or empty means "not given". */
+function optionalString(args, key) {
+    const value = args[key];
+    if (value === undefined || value === '')
+        return undefined;
+    if (typeof value !== 'string')
+        throw new ToolArgumentError(`"${key}" must be a string`);
+    return value;
+}
+export const CATALOG_TOOL = {
+    name: 'catalog',
+    description: 'List block types (category, tags, one-line summary) and actions. Pass category for one group. Call once per task, then describe only the types you use.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                enum: [...BLOCK_CATEGORIES],
+                description: 'Optional: list only this category.',
+            },
+        },
+        additionalProperties: false,
+    },
+    run: (args) => {
+        const category = optionalString(args, 'category');
+        return text(formatCatalogJson(catalog(category === undefined ? {} : { category })));
+    },
+};
+export const SEARCH_CATALOG_TOOL = {
+    name: 'search-catalog',
+    description: 'Find block types by intent words, e.g. "sortable table" or "pricing". Returns up to 8 ranked hits with type, category, summary and score.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                maxLength: CATALOG_SEARCH_LIMITS.maxQueryLength,
+                description: 'A few words describing what the block should do.',
+            },
+        },
+        required: ['query'],
+        additionalProperties: false,
+    },
+    run: (args) => text(searchCatalog(requireString(args, 'query'))),
+};
+/** The `types` argument: a non-empty list of non-empty strings. */
+function requireTypes(args) {
+    const value = args.types;
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.length > DESCRIBE_MANY_LIMIT ||
+        !value.every((item) => typeof item === 'string' && item !== '')) {
+        throw new ToolArgumentError(`"types" must be a list of 1 to ${DESCRIBE_MANY_LIMIT} non-empty strings`);
+    }
+    return value;
+}
+export const DESCRIBE_TOOL = {
+    name: 'describe',
+    description: 'Block contracts: props with defaults and bounds, slots, actions, features, network, accessibility. Pass type, or types (up to 12). compact: true gives one line per prop.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: { type: 'string', description: 'Block type from catalog, e.g. "hero".' },
+            types: {
+                type: 'array',
+                items: { type: 'string' },
+                minItems: 1,
+                maxItems: DESCRIBE_MANY_LIMIT,
+                description: 'Several block types; the reply is a list in this order. Use instead of type.',
+            },
+            compact: {
+                type: 'boolean',
+                description: 'One line per prop (kind, required, enum); no prose or examples.',
+            },
+        },
+        additionalProperties: false,
+    },
+    run: (args) => {
+        if (args.compact !== undefined && typeof args.compact !== 'boolean') {
+            throw new ToolArgumentError('"compact" must be a boolean');
+        }
+        const compact = args.compact === true;
+        if (args.types !== undefined) {
+            if (args.type !== undefined) {
+                throw new ToolArgumentError('pass either "type" or "types", not both');
+            }
+            return text(describeMany(requireTypes(args), { compact }));
+        }
+        const type = requireString(args, 'type');
+        // The single-type reply keeps its original shape: one contract object.
+        return text(compact ? describeMany([type], { compact: true })[0] : describe(type));
+    },
+};
+export const RECIPES_TOOL = {
+    name: 'recipes',
+    description: 'List page recipes (name, summary, use cases, block types): complete starter specs for common pages such as dashboard or incident-report. Fetch one with recipe.',
+    inputSchema: NO_INPUT,
+    run: () => text(recipes()),
+};
+export const RECIPE_TOOL = {
+    name: 'recipe',
+    description: 'Get one page recipe as a valid starter Page Spec in YAML. Replace its placeholder text and sample dataset rows, then validate and render.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Recipe name from recipes, e.g. "dashboard".' },
+        },
+        required: ['name'],
+        additionalProperties: false,
+    },
+    run: (args) => text(recipe(requireString(args, 'name')).spec),
+};
+export const VALIDATE_TOOL = {
+    name: 'validate',
+    description: 'Check a Page Spec without rendering. Returns ok plus diagnostics, each with a code and the JSON path to fix.',
+    inputSchema: {
+        type: 'object',
+        properties: { spec: SPEC_INPUT },
+        required: ['spec'],
+        additionalProperties: false,
+    },
+    run: (args) => {
+        const result = validate(args.spec, { source: '<spec>' });
+        return result.ok ? text(result) : failure(result);
+    },
+};
+/** `render` as the local stdio server runs it: the HTML goes to a file. */
+export const LOCAL_RENDER_DEFINITION = {
+    name: 'render',
+    description: 'Compile a Page Spec and write the standalone HTML to `out`. Returns a summary (bytes, hash, features, warnings), never the HTML itself.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            spec: SPEC_INPUT,
+            out: {
+                type: 'string',
+                description: 'HTML file to write (.html or .htm). A relative path resolves against the server working directory; an absolute path is used as given.',
+            },
+            theme: THEME_INPUT,
+        },
+        required: ['spec', 'out'],
+        additionalProperties: false,
+    },
+};
+/**
+ * `render` as a remote server runs it. A remote server cannot write into the
+ * caller's filesystem, so the artifact is stored behind a URL instead and the
+ * reply is the same compact summary plus that URL.
+ */
+export const REMOTE_RENDER_DEFINITION = {
+    name: 'render',
+    description: 'Compile a Page Spec and store the HTML behind a URL. Returns a summary (bytes, hash, features, warnings, artifactUrl, expiresAt), never the HTML. Short-lived unless `share` is true.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            spec: SPEC_INPUT,
+            theme: THEME_INPUT,
+            share: {
+                type: 'boolean',
+                description: 'Publish the artifact as an expiring share link instead of a short-lived one. Requires the share grant.',
+            },
+        },
+        required: ['spec'],
+        additionalProperties: false,
+    },
+};
+export const THEMES_DEFINITION = {
+    name: 'themes',
+    description: 'List theme presets (built-ins plus project or user presets discovered on disk) and any preset file that failed to load.',
+    inputSchema: NO_INPUT,
+};
+export function renderSummary(result) {
+    return {
+        bytes: result.bytes,
+        hash: result.hash,
+        title: result.ir.meta.title,
+        theme: result.theme.name,
+        features: result.features,
+        nodes: result.ir.nodes.length,
+        warnings: result.warnings,
+    };
+}
+/** The `themes` reply for a catalog, sorted by name. */
+export function themesResult(themes) {
+    const presets = themes.sources
+        .map(({ name, origin }) => ({ name, origin }))
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    // A preset file that failed to load is reported, not silently dropped.
+    return text({ presets, problems: themes.problems });
+}
+/**
+ * `themes` for a server with no project or user presets on disk, such as a
+ * remote one: the built-in presets, in the same reply shape as the local tool.
+ */
+export const BUILTIN_THEMES_TOOL = {
+    name: 'themes',
+    description: 'List the built-in theme presets this server renders with.',
+    inputSchema: NO_INPUT,
+    run: () => themesResult({
+        sources: Object.values(builtinPresetEntries()).map(({ name, origin }) => ({ name, origin })),
+        problems: [],
+    }),
+};
+//# sourceMappingURL=mcp-tool-definitions.js.map

package/dist/mcp/mcp-tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-definitions.js","sourceRoot":"","sources":["../../src/mcp/mcp-tool-definitions.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -1,37 +1,10 @@
 /**
- * `ak-render mcp`: the compiler as a Model Context Protocol server over stdio.
+ * Stable entry for the stdio MCP server.
  *
- * The tools mirror the CLI so an agent follows the same loop either way:
- * `catalog` → `describe` → `validate` → `render`. `render` writes the HTML to a
- * file and returns only a summary, because the point of the compiler is to keep
- * presentation bytes out of the model's context.
- *
- * The transport is newline-delimited JSON-RPC 2.0 on stdin/stdout, implemented
- * here without an SDK so the package keeps its single runtime dependency.
- * Nothing in this module touches the network.
- */
-import type { Interface } from 'node:readline';
-export interface McpContext {
-    /** Directory relative `out` paths and theme discovery resolve against. */
-    cwd: string;
-    home: string;
-}
-export interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: string | number | null;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-    };
-}
-/**
- * Answer one JSON-RPC message. Returns `undefined` for notifications and for
- * responses sent to us, which need no reply.
+ * The implementation lives in `src/mcp/`: protocol vocabulary, shared tool
+ * contracts, JSON-RPC routing, and one module per transport. This file keeps
+ * the original import path working for the CLI and for existing callers.
  */
-export declare function handleMcpMessage(message: unknown, context: McpContext): JsonRpcResponse | undefined;
-/** Answer one line of the stdio transport, or return `undefined` for no reply. */
-export declare function handleMcpLine(line: string, context: McpContext): string | undefined;
-/** Serve MCP on stdin/stdout until stdin closes. Logs go to stderr only. */
-export declare function serveMcp(context?: McpContext): Interface;
+export type { JsonRpcResponse } from './mcp/mcp-protocol.js';
+export { handleMcpLine, handleMcpMessage, type McpContext, serveMcp, } from './mcp/mcp-stdio-transport.js';
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAiB/C,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AASD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAqKD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,UAAU,GAClB,eAAe,GAAG,SAAS,CA8D7B;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CA4BnF;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,OAAO,GAAE,UAAoD,GAAG,SAAS,CAOjG"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,UAAU,EACf,QAAQ,GACT,MAAM,8BAA8B,CAAC"}

package/dist/mcp-server.js

@@ -1,274 +1,9 @@
 /**
- * `ak-render mcp`: the compiler as a Model Context Protocol server over stdio.
+ * Stable entry for the stdio MCP server.
  *
- * The tools mirror the CLI so an agent follows the same loop either way:
- * `catalog` → `describe` → `validate` → `render`. `render` writes the HTML to a
- * file and returns only a summary, because the point of the compiler is to keep
- * presentation bytes out of the model's context.
- *
- * The transport is newline-delimited JSON-RPC 2.0 on stdin/stdout, implemented
- * here without an SDK so the package keeps its single runtime dependency.
- * Nothing in this module touches the network.
- */
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, resolve } from 'node:path';
-import { createInterface } from 'node:readline';
-import { isRenderError } from './errors.js';
-import { catalog, describe } from './registry/registry.js';
-import { compile } from './render/render.js';
-import { validate } from './spec/validate.js';
-import { buildThemeCatalog } from './theme/theme-catalog.js';
-import { PACKAGE_NAME, VERSION } from './version.js';
-/** Protocol revisions this server answers with; the newest is the default. */
-const PROTOCOL_VERSIONS = ['2024-11-05', '2025-03-26', '2025-06-18', '2025-11-25'];
-const LATEST_PROTOCOL = PROTOCOL_VERSIONS[PROTOCOL_VERSIONS.length - 1];
-const INSTRUCTIONS = `AK Render compiles a Page Spec (YAML or JSON) into one self-contained, offline HTML file.
-Loop: call catalog once, describe only the block types you plan to use, validate the spec and fix every diagnostic by its JSON path, then render to a file.
-Describe meaning, not presentation: the compiler owns layout, colour, typography and motion.`;
-const SPEC_INPUT = {
-    description: 'The Page Spec: YAML or JSON text, or the parsed object.',
-    anyOf: [{ type: 'string' }, { type: 'object' }],
-};
-const text = (value) => ({
-    content: [
-        { type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) },
-    ],
-});
-const failure = (value) => ({ ...text(value), isError: true });
-const HTML_FILE = /\.html?$/iu;
-function themeCatalogFor(context) {
-    return buildThemeCatalog({ cwd: context.cwd, home: context.home, discovery: true });
-}
-function requireString(args, key) {
-    const value = args[key];
-    if (typeof value !== 'string' || value === '') {
-        throw new TypeError(`"${key}" must be a non-empty string`);
-    }
-    return value;
-}
-const TOOLS = [
-    {
-        name: 'catalog',
-        description: 'List every block type and action with a one-line summary. Call once per task, then describe only the types you use.',
-        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-        run: () => text(catalog()),
-    },
-    {
-        name: 'describe',
-        description: 'Full contract for one block type: props with defaults and bounds, slots, actions, runtime features, network needs and accessibility.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                type: { type: 'string', description: 'Block type from catalog, e.g. "hero".' },
-            },
-            required: ['type'],
-            additionalProperties: false,
-        },
-        run: (args) => text(describe(requireString(args, 'type'))),
-    },
-    {
-        name: 'validate',
-        description: 'Check a Page Spec without rendering. Returns ok plus diagnostics, each with a code and the JSON path to fix.',
-        inputSchema: {
-            type: 'object',
-            properties: { spec: SPEC_INPUT },
-            required: ['spec'],
-            additionalProperties: false,
-        },
-        run: (args) => {
-            const result = validate(args.spec, { source: '<spec>' });
-            return result.ok ? text(result) : failure(result);
-        },
-    },
-    {
-        name: 'render',
-        description: 'Compile a Page Spec and write the standalone HTML to `out`. Returns a summary (bytes, hash, features, warnings), never the HTML itself.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                spec: SPEC_INPUT,
-                out: {
-                    type: 'string',
-                    description: 'HTML file to write (.html or .htm). A relative path resolves against the server working directory; an absolute path is used as given.',
-                },
-                theme: { type: 'string', description: 'Optional preset name overriding the spec theme.' },
-            },
-            required: ['spec', 'out'],
-            additionalProperties: false,
-        },
-        run: (args, context) => {
-            const out = resolve(context.cwd, requireString(args, 'out'));
-            // The tool only ever writes pages; refusing other extensions keeps a
-            // misdirected call from replacing a config or source file with HTML.
-            if (!HTML_FILE.test(out))
-                throw new TypeError('"out" must end in .html or .htm');
-            const theme = args.theme;
-            const result = compile(args.spec, {
-                source: '<spec>',
-                themeCatalog: themeCatalogFor(context),
-                ...(typeof theme === 'string' && theme !== '' ? { theme } : {}),
-            });
-            mkdirSync(dirname(out), { recursive: true });
-            writeFileSync(out, result.html, 'utf8');
-            return text({
-                out,
-                bytes: result.bytes,
-                hash: result.hash,
-                title: result.ir.meta.title,
-                theme: result.theme.name,
-                features: result.features,
-                nodes: result.ir.nodes.length,
-                warnings: result.warnings,
-            });
-        },
-    },
-    {
-        name: 'themes',
-        description: 'List theme presets (built-ins plus project or user presets discovered on disk) and any preset file that failed to load.',
-        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-        run: (_args, context) => {
-            const themes = themeCatalogFor(context);
-            const presets = themes.sources
-                .map(({ name, origin }) => ({ name, origin }))
-                .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
-            // A preset file that failed to load is reported, not silently dropped.
-            return text({ presets, problems: themes.problems });
-        },
-    },
-];
-function callTool(tool, params, context) {
-    const args = (params.arguments ?? {});
-    try {
-        return tool.run(args, context);
-    }
-    catch (error) {
-        if (isRenderError(error)) {
-            return failure({
-                code: error.code,
-                message: error.message,
-                path: error.path ?? '$',
-                ...(error.details?.diagnostics === undefined
-                    ? {}
-                    : { diagnostics: error.details.diagnostics }),
-            });
-        }
-        return failure(error instanceof Error ? error.message : String(error));
-    }
-}
-function isRequest(message) {
-    return (typeof message === 'object' &&
-        message !== null &&
-        message.jsonrpc === '2.0' &&
-        typeof message.method === 'string');
-}
-/**
- * Answer one JSON-RPC message. Returns `undefined` for notifications and for
- * responses sent to us, which need no reply.
+ * The implementation lives in `src/mcp/`: protocol vocabulary, shared tool
+ * contracts, JSON-RPC routing, and one module per transport. This file keeps
+ * the original import path working for the CLI and for existing callers.
  */
-export function handleMcpMessage(message, context) {
-    if (!isRequest(message)) {
-        const id = message?.id;
-        const isResponse = typeof message === 'object' &&
-            message !== null &&
-            ('result' in message || 'error' in message);
-        if (isResponse)
-            return undefined;
-        return {
-            jsonrpc: '2.0',
-            id: typeof id === 'string' || typeof id === 'number' ? id : null,
-            error: { code: -32600, message: 'invalid request' },
-        };
-    }
-    if (message.id === undefined)
-        return undefined;
-    // MCP requires a string or number id; null is reserved for error replies.
-    if (message.id === null) {
-        return { jsonrpc: '2.0', id: null, error: { code: -32600, message: 'invalid request' } };
-    }
-    const id = message.id;
-    const params = message.params ?? {};
-    const reply = (result) => ({ jsonrpc: '2.0', id, result });
-    switch (message.method) {
-        case 'initialize': {
-            const requested = params.protocolVersion;
-            const protocolVersion = PROTOCOL_VERSIONS.find((version) => version === requested);
-            return reply({
-                protocolVersion: protocolVersion ?? LATEST_PROTOCOL,
-                capabilities: { tools: { listChanged: false } },
-                serverInfo: { name: PACKAGE_NAME, version: VERSION },
-                instructions: INSTRUCTIONS,
-            });
-        }
-        case 'ping':
-            return reply({});
-        case 'tools/list':
-            return reply({
-                tools: TOOLS.map(({ name, description, inputSchema }) => ({
-                    name,
-                    description,
-                    inputSchema,
-                })),
-            });
-        case 'tools/call': {
-            const tool = TOOLS.find((candidate) => candidate.name === params.name);
-            if (tool === undefined) {
-                return {
-                    jsonrpc: '2.0',
-                    id,
-                    error: { code: -32602, message: `unknown tool: ${String(params.name)}` },
-                };
-            }
-            return reply(callTool(tool, params, context));
-        }
-        default:
-            return {
-                jsonrpc: '2.0',
-                id,
-                error: { code: -32601, message: `method not found: ${message.method}` },
-            };
-    }
-}
-/** Answer one line of the stdio transport, or return `undefined` for no reply. */
-export function handleMcpLine(line, context) {
-    if (line.trim() === '')
-        return undefined;
-    let message;
-    try {
-        message = JSON.parse(line);
-    }
-    catch {
-        return JSON.stringify({
-            jsonrpc: '2.0',
-            id: null,
-            error: { code: -32700, message: 'parse error' },
-        });
-    }
-    // Revision 2025-03-26 allows batches: answer each member, omit the silent ones.
-    if (Array.isArray(message)) {
-        if (message.length === 0) {
-            return JSON.stringify({
-                jsonrpc: '2.0',
-                id: null,
-                error: { code: -32600, message: 'invalid request' },
-            });
-        }
-        const responses = message
-            .map((member) => handleMcpMessage(member, context))
-            .filter((response) => response !== undefined);
-        return responses.length === 0 ? undefined : JSON.stringify(responses);
-    }
-    const response = handleMcpMessage(message, context);
-    return response === undefined ? undefined : JSON.stringify(response);
-}
-/** Serve MCP on stdin/stdout until stdin closes. Logs go to stderr only. */
-export function serveMcp(context = { cwd: process.cwd(), home: homedir() }) {
-    const lines = createInterface({ input: process.stdin, crlfDelay: Number.POSITIVE_INFINITY });
-    lines.on('line', (line) => {
-        const response = handleMcpLine(line, context);
-        if (response !== undefined)
-            process.stdout.write(`${response}\n`);
-    });
-    return lines;
-}
+export { handleMcpLine, handleMcpMessage, serveMcp, } from './mcp/mcp-stdio-transport.js';
 //# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,aAAa,EACb,gBAAgB,EAEhB,QAAQ,GACT,MAAM,8BAA8B,CAAC"}

package/dist/recipes/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Page recipes: complete starter Page Specs for common page kinds.
+ *
+ * A recipe is static data. The YAML sources live in `src/recipes/page-recipes`
+ * and are embedded by `scripts/generate-recipes-module.mjs`, so reading one
+ * never touches the filesystem or the network. Every recipe validates with no
+ * errors and no warnings, which a unit test enforces.
+ */
+export interface PageRecipe {
+    /** Stable kebab-case name, e.g. `dashboard`. */
+    name: string;
+    /** One line on what the page shows. */
+    summary: string;
+    /** Situations the recipe fits. */
+    useCases: string[];
+    /** Every block type the spec uses, nested ones included, sorted. */
+    blocks: string[];
+    /** The starter Page Spec as YAML text. */
+    spec: string;
+}
+/** A recipe listing entry: everything but the spec text. */
+export type PageRecipeSummary = Omit<PageRecipe, 'spec'>;
+/** Every recipe without its spec, sorted by name. */
+export declare function recipes(): PageRecipeSummary[];
+/** The recipe called `name`. An unknown name throws and lists the allowed names. */
+export declare function recipe(name: string): PageRecipe;
+//# sourceMappingURL=index.d.ts.map

package/dist/recipes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAMzD,qDAAqD;AACrD,wBAAgB,OAAO,IAAI,iBAAiB,EAAE,CAM7C;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAS/C"}