@bestagentkits/render 0.1.1-next.1 → 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

@@ -0,0 +1,10 @@
+/**
+ * Stable entry for the stdio MCP server.
+ *
+ * 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 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+/**
+ * Stable entry for the stdio MCP server.
+ *
+ * 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 { handleMcpLine, handleMcpMessage, serveMcp, } from './mcp/mcp-stdio-transport.js';
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"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"}

package/dist/recipes/index.js

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+import { RenderError } from '../errors.js';
+import { PAGE_RECIPES } from './recipes.generated.js';
+function copy(recipe) {
+    return { ...recipe, useCases: [...recipe.useCases], blocks: [...recipe.blocks] };
+}
+/** Every recipe without its spec, sorted by name. */
+export function recipes() {
+    return PAGE_RECIPES.map(({ spec: _spec, ...entry }) => ({
+        ...entry,
+        useCases: [...entry.useCases],
+        blocks: [...entry.blocks],
+    })).sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+/** The recipe called `name`. An unknown name throws and lists the allowed names. */
+export function recipe(name) {
+    const found = PAGE_RECIPES.find((entry) => entry.name === name);
+    if (found !== undefined)
+        return copy(found);
+    const allowed = recipes().map((entry) => entry.name);
+    throw new RenderError('SPEC_VALIDATION_ERROR', `unknown recipe "${name}"; expected one of: ${allowed.join(', ')}`, { path: 'name', details: { name, allowed } });
+}
+//# sourceMappingURL=index.js.map

package/dist/recipes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAkBtD,SAAS,IAAI,CAAC,MAAkB;IAC9B,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,OAAO;IACrB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtD,GAAG,KAAK;QACR,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;KAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,IAAI,WAAW,CACnB,uBAAuB,EACvB,mBAAmB,IAAI,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAClE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC7C,CAAC;AACJ,CAAC"}

package/dist/recipes/recipes.generated.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generated by scripts/generate-recipes-module.mjs from src/recipes/page-recipes. Do not edit.
+ * Change a recipe's YAML file, then run pnpm recipes:generate.
+ */
+import type { PageRecipe } from './index.js';
+/** Every page recipe, sorted by name. */
+export declare const PAGE_RECIPES: readonly PageRecipe[];
+//# sourceMappingURL=recipes.generated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.generated.d.ts","sourceRoot":"","sources":["../../src/recipes/recipes.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,yCAAyC;AACzC,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAmsB7C,CAAC"}