@bestagentkits/render 0.1.1-next.1 → 0.3.0

package/dist/mcp/mcp-local-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The tool set the local stdio server runs.
+ *
+ * `catalog`, `search-catalog`, `describe`, `recipes`, `recipe` and `validate`
+ * are the shared pure tools. `render`
+ * writes the HTML to a file under the server's working directory and `themes`
+ * discovers project and user presets on disk, which is why this module, unlike
+ * the shared definitions, may touch the filesystem. Nothing here touches the
+ * network.
+ */
+import { type McpTool } from './mcp-tool-definitions.js';
+export interface McpContext {
+    /** Directory relative `out` paths and theme discovery resolve against. */
+    cwd: string;
+    home: string;
+}
+export declare const LOCAL_INSTRUCTIONS = "AK Render compiles a Page Spec (YAML or JSON) into one self-contained, offline HTML file.\nLoop: call catalog once (or search-catalog with a few words), describe only the block types you plan to use (several at once with types, compact: true for the short form), optionally start from a recipe (list them with recipes), validate the spec and fix every diagnostic by its JSON path, then render to a file.\nDescribe meaning, not presentation: the compiler owns layout, colour, typography and motion.";
+/** Local tools, in the order an agent uses them. */
+export declare const LOCAL_TOOLS: readonly McpTool<McpContext>[];
+//# sourceMappingURL=mcp-local-tools.d.ts.map

package/dist/mcp/mcp-local-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-local-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-local-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAIL,KAAK,OAAO,EAUb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB,sfAE8D,CAAC;AAgC9F,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,CAAC,UAAU,CAAC,EASrD,CAAC"}

package/dist/mcp/mcp-local-tools.js

@@ -0,0 +1,58 @@
+/**
+ * The tool set the local stdio server runs.
+ *
+ * `catalog`, `search-catalog`, `describe`, `recipes`, `recipe` and `validate`
+ * are the shared pure tools. `render`
+ * writes the HTML to a file under the server's working directory and `themes`
+ * discovers project and user presets on disk, which is why this module, unlike
+ * the shared definitions, may touch the filesystem. Nothing here touches the
+ * network.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { compile } from '../render/render.js';
+import { buildThemeCatalog } from '../theme/theme-catalog.js';
+import { text } from './mcp-protocol.js';
+import { CATALOG_TOOL, DESCRIBE_TOOL, LOCAL_RENDER_DEFINITION, optionalTheme, RECIPE_TOOL, RECIPES_TOOL, renderSummary, requireString, SEARCH_CATALOG_TOOL, THEMES_DEFINITION, themesResult, VALIDATE_TOOL, } from './mcp-tool-definitions.js';
+export const LOCAL_INSTRUCTIONS = `AK Render compiles a Page Spec (YAML or JSON) into one self-contained, offline HTML file.
+Loop: call catalog once (or search-catalog with a few words), describe only the block types you plan to use (several at once with types, compact: true for the short form), optionally start from a recipe (list them with recipes), 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 HTML_FILE = /\.html?$/iu;
+function themeCatalogFor(context) {
+    return buildThemeCatalog({ cwd: context.cwd, home: context.home, discovery: true });
+}
+const LOCAL_RENDER_TOOL = {
+    ...LOCAL_RENDER_DEFINITION,
+    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 = optionalTheme(args);
+        const result = compile(args.spec, {
+            source: '<spec>',
+            themeCatalog: themeCatalogFor(context),
+            ...(theme === undefined ? {} : { theme }),
+        });
+        mkdirSync(dirname(out), { recursive: true });
+        writeFileSync(out, result.html, 'utf8');
+        return text({ out, ...renderSummary(result) });
+    },
+};
+const LOCAL_THEMES_TOOL = {
+    ...THEMES_DEFINITION,
+    run: (_args, context) => themesResult(themeCatalogFor(context)),
+};
+/** Local tools, in the order an agent uses them. */
+export const LOCAL_TOOLS = [
+    CATALOG_TOOL,
+    SEARCH_CATALOG_TOOL,
+    DESCRIBE_TOOL,
+    RECIPES_TOOL,
+    RECIPE_TOOL,
+    VALIDATE_TOOL,
+    LOCAL_RENDER_TOOL,
+    LOCAL_THEMES_TOOL,
+];
+//# sourceMappingURL=mcp-local-tools.js.map

package/dist/mcp/mcp-local-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-local-tools.js","sourceRoot":"","sources":["../../src/mcp/mcp-local-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAqB,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,uBAAuB,EAEvB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,2BAA2B,CAAC;AAQnC,MAAM,CAAC,MAAM,kBAAkB,GAAG;;6FAE2D,CAAC;AAE9F,MAAM,SAAS,GAAG,YAAY,CAAC;AAE/B,SAAS,eAAe,CAAC,OAAmB;IAC1C,OAAO,iBAAiB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,iBAAiB,GAAwB;IAC7C,GAAG,uBAAuB;IAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,qEAAqE;QACrE,qEAAqE;QACrE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;YAChC,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC;YACtC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;SAC1C,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAwB;IAC7C,GAAG,iBAAiB;IACpB,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;CAChE,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAmC;IACzD,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,YAAY;IACZ,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,iBAAiB;CAClB,CAAC"}

package/dist/mcp/mcp-protocol.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Model Context Protocol vocabulary shared by every transport.
+ *
+ * Nothing here knows about stdio, HTTP, the filesystem or the network: these
+ * are the JSON-RPC shapes, the protocol revisions this server speaks, and the
+ * helpers that turn a tool outcome into an MCP tool result. Keeping them free of
+ * Node-only imports is what lets the Cloudflare Worker bundle the same code.
+ */
+/** Protocol revisions this server answers with; the newest is the default. */
+export declare const PROTOCOL_VERSIONS: readonly ["2024-11-05", "2025-03-26", "2025-06-18", "2025-11-25"];
+export type ProtocolVersion = (typeof PROTOCOL_VERSIONS)[number];
+export declare const LATEST_PROTOCOL: ProtocolVersion;
+/**
+ * Revision a Streamable HTTP server assumes when a client omits the
+ * `MCP-Protocol-Version` header, as the 2025-06-18 transport specifies.
+ */
+export declare const DEFAULT_HTTP_PROTOCOL: ProtocolVersion;
+export declare function isSupportedProtocol(value: unknown): value is ProtocolVersion;
+/**
+ * JSON-RPC batching exists only in revision 2025-03-26 (and is tolerated for
+ * 2024-11-05 clients); revision 2025-06-18 removed it. Revisions are ISO dates,
+ * so string order is chronological order.
+ */
+export declare function protocolAllowsBatching(version: ProtocolVersion): boolean;
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+/** JSON-RPC 2.0 error codes this server emits. */
+export declare const JSON_RPC_ERRORS: {
+    readonly parse: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+};
+export declare function rpcError(id: string | number | null, code: number, message: string): JsonRpcResponse;
+export interface ToolResult {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+/** A successful tool result carrying text, or JSON pretty-printed as text. */
+export declare const text: (value: unknown) => ToolResult;
+/** A tool-level failure: the model sees it and can correct its call. */
+export declare const failure: (value: unknown) => ToolResult;
+/**
+ * A tool argument the caller got wrong. Its message is written for the caller,
+ * so every transport may show it, unlike an arbitrary runtime error.
+ */
+export declare class ToolArgumentError extends TypeError {
+    readonly name = "ToolArgumentError";
+}
+/**
+ * Map a thrown error to a tool failure. A compiler error keeps its code, JSON
+ * path and diagnostics so the caller can fix the spec; anything else reports
+ * only its message.
+ */
+export declare function toolErrorResult(error: unknown): ToolResult;
+/**
+ * Map a thrown error to a tool failure a hosted server may show a stranger.
+ * Compiler errors and argument errors keep their message, because the caller
+ * needs it to fix the call; anything else (a storage, binding or runtime fault)
+ * becomes a generic `INTERNAL_ERROR`, so no internal message leaves the server.
+ */
+export declare function publicToolErrorResult(error: unknown): ToolResult;
+//# sourceMappingURL=mcp-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-protocol.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,mEAAoE,CAAC;AACnG,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,eAAe,EAAE,eAA8B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAA8B,CAAC;AAEnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAExE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,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;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,eAAe,CAEjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8EAA8E;AAC9E,eAAO,MAAM,IAAI,GAAI,OAAO,OAAO,KAAG,UAIpC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,UAAiD,CAAC;AAE3F;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAkB,IAAI,uBAAuB;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAY1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAGhE"}

package/dist/mcp/mcp-protocol.js

@@ -0,0 +1,83 @@
+/**
+ * Model Context Protocol vocabulary shared by every transport.
+ *
+ * Nothing here knows about stdio, HTTP, the filesystem or the network: these
+ * are the JSON-RPC shapes, the protocol revisions this server speaks, and the
+ * helpers that turn a tool outcome into an MCP tool result. Keeping them free of
+ * Node-only imports is what lets the Cloudflare Worker bundle the same code.
+ */
+import { isRenderError } from '../errors.js';
+/** Protocol revisions this server answers with; the newest is the default. */
+export const PROTOCOL_VERSIONS = ['2024-11-05', '2025-03-26', '2025-06-18', '2025-11-25'];
+export const LATEST_PROTOCOL = '2025-11-25';
+/**
+ * Revision a Streamable HTTP server assumes when a client omits the
+ * `MCP-Protocol-Version` header, as the 2025-06-18 transport specifies.
+ */
+export const DEFAULT_HTTP_PROTOCOL = '2025-03-26';
+export function isSupportedProtocol(value) {
+    return PROTOCOL_VERSIONS.some((version) => version === value);
+}
+/**
+ * JSON-RPC batching exists only in revision 2025-03-26 (and is tolerated for
+ * 2024-11-05 clients); revision 2025-06-18 removed it. Revisions are ISO dates,
+ * so string order is chronological order.
+ */
+export function protocolAllowsBatching(version) {
+    return version < '2025-06-18';
+}
+/** JSON-RPC 2.0 error codes this server emits. */
+export const JSON_RPC_ERRORS = {
+    parse: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+};
+export function rpcError(id, code, message) {
+    return { jsonrpc: '2.0', id, error: { code, message } };
+}
+/** A successful tool result carrying text, or JSON pretty-printed as text. */
+export const text = (value) => ({
+    content: [
+        { type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) },
+    ],
+});
+/** A tool-level failure: the model sees it and can correct its call. */
+export const failure = (value) => ({ ...text(value), isError: true });
+/**
+ * A tool argument the caller got wrong. Its message is written for the caller,
+ * so every transport may show it, unlike an arbitrary runtime error.
+ */
+export class ToolArgumentError extends TypeError {
+    name = 'ToolArgumentError';
+}
+/**
+ * Map a thrown error to a tool failure. A compiler error keeps its code, JSON
+ * path and diagnostics so the caller can fix the spec; anything else reports
+ * only its message.
+ */
+export function toolErrorResult(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));
+}
+/**
+ * Map a thrown error to a tool failure a hosted server may show a stranger.
+ * Compiler errors and argument errors keep their message, because the caller
+ * needs it to fix the call; anything else (a storage, binding or runtime fault)
+ * becomes a generic `INTERNAL_ERROR`, so no internal message leaves the server.
+ */
+export function publicToolErrorResult(error) {
+    if (isRenderError(error) || error instanceof ToolArgumentError)
+        return toolErrorResult(error);
+    return failure({ code: 'INTERNAL_ERROR', message: 'the tool failed; try again later' });
+}
+//# sourceMappingURL=mcp-protocol.js.map

package/dist/mcp/mcp-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-protocol.js","sourceRoot":"","sources":["../../src/mcp/mcp-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAEnG,MAAM,CAAC,MAAM,eAAe,GAAoB,YAAY,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB,YAAY,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAwB;IAC7D,OAAO,OAAO,GAAG,YAAY,CAAC;AAChC,CAAC;AAgBD,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC,KAAK;IACb,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;CACb,CAAC;AAEX,MAAM,UAAU,QAAQ,CACtB,EAA0B,EAC1B,IAAY,EACZ,OAAe;IAEf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AAC1D,CAAC;AAOD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,CAAC;IACnD,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;KAC3F;CACF,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAE3F;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC5B,IAAI,GAAG,mBAAmB,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;YACb,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG;YACvB,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS;gBAC1C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,iBAAiB;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9F,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;AAC1F,CAAC"}

package/dist/mcp/mcp-stdio-transport.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `ak-render mcp`: the compiler as a Model Context Protocol server over stdio.
+ *
+ * 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
+ * without an SDK so the package keeps its single runtime dependency. Protocol
+ * routing and tool contracts are shared with the Streamable HTTP transport;
+ * this module only frames lines and runs the local tools. Nothing here touches
+ * the network.
+ */
+import type { Interface } from 'node:readline';
+import { type McpContext } from './mcp-local-tools.js';
+import { type JsonRpcResponse } from './mcp-protocol.js';
+/**
+ * Answer one JSON-RPC message. Returns `undefined` for notifications and for
+ * responses sent to us, which need no reply.
+ */
+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 { McpContext };
+//# sourceMappingURL=mcp-stdio-transport.d.ts.map

package/dist/mcp/mcp-stdio-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-stdio-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAEL,KAAK,eAAe,EAIrB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,UAAU,GAClB,eAAe,GAAG,SAAS,CAW7B;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAoBnF;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,OAAO,GAAE,UAAoD,GAAG,SAAS,CAOjG;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/mcp/mcp-stdio-transport.js

@@ -0,0 +1,73 @@
+/**
+ * `ak-render mcp`: the compiler as a Model Context Protocol server over stdio.
+ *
+ * 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
+ * without an SDK so the package keeps its single runtime dependency. Protocol
+ * routing and tool contracts are shared with the Streamable HTTP transport;
+ * this module only frames lines and runs the local tools. Nothing here touches
+ * the network.
+ */
+import { homedir } from 'node:os';
+import { createInterface } from 'node:readline';
+import { routeMcpMessage } from './mcp-json-rpc-dispatch.js';
+import { LOCAL_INSTRUCTIONS, LOCAL_TOOLS } from './mcp-local-tools.js';
+import { JSON_RPC_ERRORS, rpcError, toolErrorResult, } from './mcp-protocol.js';
+/**
+ * Answer one JSON-RPC message. Returns `undefined` for notifications and for
+ * responses sent to us, which need no reply.
+ */
+export function handleMcpMessage(message, context) {
+    const route = routeMcpMessage(message, LOCAL_TOOLS, { instructions: LOCAL_INSTRUCTIONS });
+    if (route.kind === 'silent')
+        return undefined;
+    if (route.kind === 'reply')
+        return route.response;
+    let result;
+    try {
+        result = route.tool.run(route.args, context);
+    }
+    catch (error) {
+        result = toolErrorResult(error);
+    }
+    return { jsonrpc: '2.0', id: route.id, result };
+}
+/** 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(rpcError(null, JSON_RPC_ERRORS.parse, '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(rpcError(null, JSON_RPC_ERRORS.invalidRequest, '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;
+}
+//# sourceMappingURL=mcp-stdio-transport.js.map

package/dist/mcp/mcp-stdio-transport.js.map

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

package/dist/mcp/mcp-tool-definitions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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 type { CompileResult } from '../render/render.js';
+import type { ThemeCatalog } from '../theme/theme-catalog.js';
+import { type ToolResult } from './mcp-protocol.js';
+/** What `tools/list` announces for one tool. */
+export interface McpToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+}
+/**
+ * A runnable tool. `C` is the transport's per-call context; `R` lets the HTTP
+ * transport run asynchronous tools while stdio stays synchronous.
+ */
+export interface McpTool<C, R extends ToolResult | Promise<ToolResult> = ToolResult> extends McpToolDefinition {
+    run: (args: Record<string, unknown>, context: C) => R;
+}
+export declare function requireString(args: Record<string, unknown>, key: string): string;
+/** The optional `theme` argument, normalized: an empty string means "not given". */
+export declare function optionalTheme(args: Record<string, unknown>): string | undefined;
+export declare const CATALOG_TOOL: McpTool<unknown>;
+export declare const SEARCH_CATALOG_TOOL: McpTool<unknown>;
+export declare const DESCRIBE_TOOL: McpTool<unknown>;
+export declare const RECIPES_TOOL: McpTool<unknown>;
+export declare const RECIPE_TOOL: McpTool<unknown>;
+export declare const VALIDATE_TOOL: McpTool<unknown>;
+/** `render` as the local stdio server runs it: the HTML goes to a file. */
+export declare const LOCAL_RENDER_DEFINITION: McpToolDefinition;
+/**
+ * `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 declare const REMOTE_RENDER_DEFINITION: McpToolDefinition;
+export declare const THEMES_DEFINITION: McpToolDefinition;
+/** The compact render summary every transport returns instead of the HTML. */
+export interface RenderSummary {
+    bytes: number;
+    hash: string;
+    title: string;
+    theme: string;
+    features: CompileResult['features'];
+    nodes: number;
+    warnings: CompileResult['warnings'];
+}
+export declare function renderSummary(result: CompileResult): RenderSummary;
+/** The `themes` reply for a catalog, sorted by name. */
+export declare function themesResult(themes: Pick<ThemeCatalog, 'sources' | 'problems'>): ToolResult;
+/**
+ * `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 declare const BUILTIN_THEMES_TOOL: McpTool<unknown>;
+//# sourceMappingURL=mcp-tool-definitions.d.ts.map

package/dist/mcp/mcp-tool-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-definitions.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAA8B,KAAK,UAAU,EAAQ,MAAM,mBAAmB,CAAC;AAEtF,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CACjF,SAAQ,iBAAiB;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;CACvD;AAcD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAG/E;AAUD,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,OAAO,CAmBzC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAiBhD,CAAC;AAkBF,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,OAAO,CAqC1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,OAAO,CAMzC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,OAAO,CAaxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,OAAO,CAc1C,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,EAAE,iBAkBrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAkBtC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACrC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAUlE;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG,UAAU,CAM3F;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAShD,CAAC"}