tabbied-mcp 0.0.0-stage → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sy Hong and Ye Joo Park
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# tabbied-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [MCP](https://modelcontextprotocol.io) server for
+[Tabbied](https://tabbied.com): search 338 generative pattern designs, look at
+them, and render them to SVG or PNG - from Claude Code, Claude Desktop, Cursor,
+or any other MCP client.
+
+## Use it without installing anything
+
+The same server runs at `https://tabbied.com/mcp`:
+
+```bash
+claude mcp add --transport http tabbied https://tabbied.com/mcp
+```
+
+```jsonc
+{
+  "mcpServers": {
+    "tabbied": { "url": "https://tabbied.com/mcp" }
+  }
+}
+```
+
+## Or run it locally, and render real files
+
+```bash
+claude mcp add tabbied -- npx -y tabbied-mcp
+```
+
+```jsonc
+{
+  "mcpServers": {
+    "tabbied": { "command": "npx", "args": ["-y", "tabbied-mcp"] }
+  }
+}
+```
+
+The local server adds `render_design`, which the remote one cannot offer -
+rendering a css-doodle pattern needs a real browser. Install a Playwright
+alongside it (`npm i -D playwright`) or point `TABBIED_CHROMIUM` at a Chromium
+binary.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `search_designs` | Filter by motif, mood, density, intended use, free text, or SVG-export support. |
+| `get_design` | The full record for one slug, plus ready-to-paste snippets. |
+| `preview_design` | The rendered preview image for up to six designs, so the model can *look*. |
+| `get_docs` | The complete API reference (`llms-full.txt`). |
+| `render_design` | SVG or PNG at any size, seed, palette, and option set. **Local only.** |
+
+Slugs are opaque - `cleat`, `karst`, `radius` - so the intended flow is
+`search_designs` to narrow, `preview_design` to look, then `get_design` for the
+options. Choosing off tags alone is the main way this goes wrong.
+
+## Programmatic use
+
+The package's main entry point is runtime-agnostic (no node imports), so it can
+be embedded in a Worker or any Web-standard server. It exposes the tools and an
+`McpServer` factory; the transport is the MCP SDK's:
+
+```ts
+import { createMcpHandler } from '@modelcontextprotocol/server';
+import { buildServer, catalogTools } from 'tabbied-mcp';
+
+const tools = catalogTools({ catalog, fetchPreview, fetchDocs });
+
+export default {
+  fetch: createMcpHandler(() => buildServer(tools)).fetch,
+};
+```
+
+Pass the *factory*, not a built server: MCP v2 is stateless and the handler
+constructs one server per request.
+
+Built on [`@modelcontextprotocol/server`](https://www.npmjs.com/package/@modelcontextprotocol/server)
+v2, so it speaks the stateless `2026-07-28` revision and still serves 2025-era
+clients. `docs/mcp-server.md` in the repository has the details.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { buildServer } from './server.js';
+export { catalogTools, createToolset, type Toolset } from './tools.js';
+export { templateTools } from './templates.js';
+export { INSTRUCTIONS, SERVER_NAME, VERSION } from './info.js';
+export type { Catalog, CatalogDesign, CatalogOption, TemplateCatalog, TemplateCatalogEntry, TemplateSpec, Tool, ToolContent, ToolContext, ToolDefinition, ToolResult, } from './types.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+// The runtime-agnostic half of the server: the tool definitions and the
+// `McpServer` factory. Nothing reachable from here may import node, because
+// this entry point is what the Cloudflare Worker bundles; the local catalog
+// reader and `render_design` live behind the bin. See docs/mcp-server.md.
+export { buildServer } from './server.js';
+export { catalogTools, createToolset } from './tools.js';
+export { templateTools } from './templates.js';
+export { INSTRUCTIONS, SERVER_NAME, VERSION } from './info.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC","sourcesContent":["// The runtime-agnostic half of the server: the tool definitions and the\n// `McpServer` factory. Nothing reachable from here may import node, because\n// this entry point is what the Cloudflare Worker bundles; the local catalog\n// reader and `render_design` live behind the bin. See docs/mcp-server.md.\nexport { buildServer } from './server.js';\nexport { catalogTools, createToolset, type Toolset } from './tools.js';\nexport { templateTools } from './templates.js';\nexport { INSTRUCTIONS, SERVER_NAME, VERSION } from './info.js';\nexport type {\n  Catalog,\n  CatalogDesign,\n  CatalogOption,\n  TemplateCatalog,\n  TemplateCatalogEntry,\n  TemplateSpec,\n  Tool,\n  ToolContent,\n  ToolContext,\n  ToolDefinition,\n  ToolResult,\n} from './types.js';\n"]}

package/dist/info.d.ts

@@ -0,0 +1,10 @@
+export declare const SERVER_NAME = "tabbied";
+export declare const VERSION = "0.2.3";
+/**
+ * Shown to the model as a preamble. It carries what no tool description can,
+ * because they are properties of the *set* rather than of one call: slugs
+ * cannot be guessed, the previews are what a choice should rest on, and the
+ * sizing rule is the most common way a correct-looking integration renders as
+ * nothing.
+ */
+export declare const INSTRUCTIONS = "Tabbied is a catalog of generative patterns (css-doodle) usable as backgrounds, textures, posters, and exported SVG/PNG assets.\n\nDesigns are addressed by slug, and slugs are opaque - \"cleat\", \"karst\", \"radius\" say nothing about what they look like. Never guess one: call search_designs, which filters on a closed vocabulary of motifs, moods, density, and intended use.\n\nMetadata narrows the field; it does not settle it. These are pictures, so call preview_design on your shortlist and look before you commit. Choosing off tags alone is the main way this goes wrong.\n\nWhen you write integration code, remember a pattern has no intrinsic size: it fills its parent and collapses to nothing in a parent that sizes to content. Pass height or aspectRatio unless the parent is definitely sized. get_docs has the full API contract and recipes.";

package/dist/info.js

@@ -0,0 +1,23 @@
+// Server identity and the instructions clients hand to the model.
+//
+// VERSION is a literal rather than a package.json read because this module is
+// bundled into a Cloudflare Worker, which has no filesystem. The release's
+// `version-packages` step rewrites it from package.json
+// (scripts/sync-version.mjs), and test/info.test.mjs pins the two together.
+export const SERVER_NAME = 'tabbied';
+export const VERSION = '0.2.3';
+/**
+ * Shown to the model as a preamble. It carries what no tool description can,
+ * because they are properties of the *set* rather than of one call: slugs
+ * cannot be guessed, the previews are what a choice should rest on, and the
+ * sizing rule is the most common way a correct-looking integration renders as
+ * nothing.
+ */
+export const INSTRUCTIONS = `Tabbied is a catalog of generative patterns (css-doodle) usable as backgrounds, textures, posters, and exported SVG/PNG assets.
+
+Designs are addressed by slug, and slugs are opaque - "cleat", "karst", "radius" say nothing about what they look like. Never guess one: call search_designs, which filters on a closed vocabulary of motifs, moods, density, and intended use.
+
+Metadata narrows the field; it does not settle it. These are pictures, so call preview_design on your shortlist and look before you commit. Choosing off tags alone is the main way this goes wrong.
+
+When you write integration code, remember a pattern has no intrinsic size: it fills its parent and collapses to nothing in a parent that sizes to content. Pass height or aspectRatio unless the parent is definitely sized. get_docs has the full API contract and recipes.`;
+//# sourceMappingURL=info.js.map

package/dist/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,wDAAwD;AACxD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;6QAMiP,CAAC","sourcesContent":["// Server identity and the instructions clients hand to the model.\n//\n// VERSION is a literal rather than a package.json read because this module is\n// bundled into a Cloudflare Worker, which has no filesystem. The release's\n// `version-packages` step rewrites it from package.json\n// (scripts/sync-version.mjs), and test/info.test.mjs pins the two together.\nexport const SERVER_NAME = 'tabbied';\nexport const VERSION = '0.2.3';\n\n/**\n * Shown to the model as a preamble. It carries what no tool description can,\n * because they are properties of the *set* rather than of one call: slugs\n * cannot be guessed, the previews are what a choice should rest on, and the\n * sizing rule is the most common way a correct-looking integration renders as\n * nothing.\n */\nexport const INSTRUCTIONS = `Tabbied is a catalog of generative patterns (css-doodle) usable as backgrounds, textures, posters, and exported SVG/PNG assets.\n\nDesigns are addressed by slug, and slugs are opaque - \"cleat\", \"karst\", \"radius\" say nothing about what they look like. Never guess one: call search_designs, which filters on a closed vocabulary of motifs, moods, density, and intended use.\n\nMetadata narrows the field; it does not settle it. These are pictures, so call preview_design on your shortlist and look before you commit. Choosing off tags alone is the main way this goes wrong.\n\nWhen you write integration code, remember a pattern has no intrinsic size: it fills its parent and collapses to nothing in a parent that sizes to content. Pass height or aspectRatio unless the parent is definitely sized. get_docs has the full API contract and recipes.`;\n"]}

package/dist/node/render.d.ts

@@ -0,0 +1,2 @@
+import type { Catalog, Tool } from '../types.js';
+export declare function renderTool(catalog: Catalog): Tool;

package/dist/node/render.js

@@ -0,0 +1,208 @@
+// `render_design`, the one tool that only exists over stdio.
+//
+// It shells out to the `tabbied` CLI: the only faithful renderer for a
+// css-doodle pattern is css-doodle in a real browser (see docs/svg-export.md),
+// and the CLI already owns the headless browser, the SVG converter, and the
+// option parsing. A Worker has no browser, so it doesn't offer the tool.
+import { execFile } from 'node:child_process';
+import { mkdtemp, readFile, rm, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { tabbiedRoot } from './resources.js';
+const run = promisify(execFile);
+// Rendering launches a browser and waits for the first arrangement to settle.
+const RENDER_TIMEOUT_MS = 180_000;
+// A PNG returned inline is spent context. Past this the file stays on disk and
+// the agent gets the path - better a usable pointer than a truncated image.
+const INLINE_BYTE_BUDGET = 1_500_000;
+const text = (value) => ({ type: 'text', text: value });
+const toolError = (message) => ({
+    content: [text(message)],
+    isError: true,
+});
+export function renderTool(catalog) {
+    return {
+        definition: {
+            name: 'render_design',
+            title: 'Render a design to a file',
+            description: 'Render a design to SVG or PNG with a real browser, at any size, seed, ' +
+                'palette, and option set. Use this to produce an actual asset - or to ' +
+                'preview a *customized* configuration, which preview_design cannot show ' +
+                'you (it only has the stock palette and defaults). Needs Playwright ' +
+                'installed alongside this server. Without "out" the image comes back ' +
+                'inline; with it, the file is written where you ask.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    slug: { type: 'string', description: 'The design to render.' },
+                    format: {
+                        type: 'string',
+                        enum: ['svg', 'png'],
+                        description: 'Vector or raster. A few designs cannot be vectorized - check ' +
+                            'svgExport on the design first.',
+                    },
+                    out: {
+                        type: 'string',
+                        description: 'Absolute path to write to. Omit to get the image back inline ' +
+                            'instead of on disk.',
+                    },
+                    seed: {
+                        type: 'string',
+                        description: 'Fixed seed - the same seed always gives the same image. Random ' +
+                            'when omitted.',
+                    },
+                    palette: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: "CSS colors, background first. Omit for the design's authored palette.",
+                    },
+                    options: {
+                        type: 'object',
+                        description: 'Option values keyed by option id, e.g. {"scale": 3}. Read the ' +
+                            'ids and ranges off get_design.',
+                    },
+                    width: { type: 'integer', description: 'Pixels wide (default 960).' },
+                    height: { type: 'integer', description: 'Pixels tall (default 960).' },
+                    fit: {
+                        type: 'string',
+                        enum: ['grid', 'cover', 'fixed'],
+                        description: 'Sizing mode (default grid).',
+                    },
+                    scale: {
+                        type: 'integer',
+                        description: 'PNG device-scale factor. Defaults to 2 when writing a file and ' +
+                            '1 when returning inline, to keep the response small.',
+                    },
+                },
+                required: ['slug', 'format'],
+                additionalProperties: false,
+            },
+        },
+        async run(args) {
+            const slug = typeof args.slug === 'string' ? args.slug : '';
+            const design = catalog.designs.find((entry) => entry.slug === slug);
+            if (!design) {
+                return toolError(`No design with slug "${slug}". Use search_designs to find one.`);
+            }
+            const format = args.format === 'png' ? 'png' : 'svg';
+            if (format === 'svg' && !design.svgExport.supported) {
+                return toolError(`"${slug}" paints effects SVG cannot represent, so it has no vector ` +
+                    'export. Render it as PNG instead.');
+            }
+            const root = tabbiedRoot();
+            if (!root) {
+                return toolError('The `tabbied` package is not installed next to this server, so the ' +
+                    'renderer is unavailable. Run `npm install tabbied`.');
+            }
+            const inline = typeof args.out !== 'string' || args.out.length === 0;
+            // An inline render gets a scratch directory, removed once its bytes
+            // have been read back.
+            const scratch = inline ? await mkdtemp(path.join(tmpdir(), 'tabbied-')) : null;
+            const outPath = scratch ? path.join(scratch, `${slug}.${format}`) : args.out;
+            const discard = () => (scratch ? rm(scratch, { recursive: true, force: true }) : Promise.resolve());
+            const scale = typeof args.scale === 'number' && Number.isFinite(args.scale)
+                ? Math.trunc(args.scale)
+                : inline
+                    ? 1
+                    : 2;
+            const argv = [
+                path.join(root, 'dist', 'cli.js'),
+                'render',
+                slug,
+                '--out',
+                outPath,
+                '--format',
+                format,
+                '--scale',
+                String(scale),
+            ];
+            const push = (flag, value) => argv.push(flag, value);
+            if (typeof args.seed === 'string' && args.seed)
+                push('--seed', args.seed);
+            if (typeof args.fit === 'string')
+                push('--fit', args.fit);
+            const width = typeof args.width === 'number' ? Math.trunc(args.width) : 960;
+            const height = typeof args.height === 'number' ? Math.trunc(args.height) : 960;
+            push('--size', `${width}x${height}`);
+            if (Array.isArray(args.palette) && args.palette.length) {
+                push('--palette', args.palette.filter(Boolean).join(','));
+            }
+            if (args.options && typeof args.options === 'object') {
+                const pairs = Object.entries(args.options)
+                    .map(([id, value]) => `${id}: ${String(value)}`)
+                    .join('; ');
+                if (pairs)
+                    push('--options', pairs);
+            }
+            let stderr = '';
+            try {
+                // No shell: argv goes straight to node, so a palette or option value
+                // can't be read as shell syntax.
+                ({ stderr } = await run(process.execPath, argv, {
+                    timeout: RENDER_TIMEOUT_MS,
+                    maxBuffer: 8 * 1024 * 1024,
+                }));
+            }
+            catch (error) {
+                const detail = error && typeof error === 'object' && 'stderr' in error
+                    ? String(error.stderr).trim()
+                    : error instanceof Error
+                        ? error.message
+                        : String(error);
+                return toolError(`Rendering failed: ${detail || 'the CLI exited non-zero.'}\n\n` +
+                    'If this says a browser is missing, install one alongside the ' +
+                    'server (`npm i -D playwright`) or point TABBIED_CHROMIUM at a ' +
+                    'Chromium binary.');
+            }
+            // The CLI reports SVG-fidelity caveats on stderr; they matter enough to
+            // pass through rather than swallow.
+            const notes = stderr
+                .split('\n')
+                .filter((line) => line.trim().startsWith('note:'))
+                .join('\n');
+            if (!inline) {
+                const { size } = await stat(outPath);
+                return {
+                    content: [
+                        text(`Rendered ${slug} to ${outPath} (${width}x${height}` +
+                            (format === 'png' ? ` @${scale}x` : '') +
+                            `, ${Math.round(size / 1024)} KB).` +
+                            (notes ? `\n${notes}` : '')),
+                    ],
+                };
+            }
+            if (format === 'svg') {
+                const svg = await readFile(outPath, 'utf-8');
+                await discard();
+                return {
+                    content: [
+                        text(`Rendered ${slug} as SVG (${width}x${height}).` +
+                            (notes ? `\n${notes}` : '')),
+                        text(svg),
+                    ],
+                };
+            }
+            const png = await readFile(outPath);
+            const data = png.toString('base64');
+            if (data.length > INLINE_BYTE_BUDGET) {
+                // Kept: the answer tells the agent to read it from that path.
+                return {
+                    content: [
+                        text(`Rendered ${slug} to ${outPath} - ${Math.round(png.byteLength / 1024)} KB, too large to return inline. Read it from that path, or ` +
+                            're-render smaller (lower "scale", or a smaller width/height).'),
+                    ],
+                };
+            }
+            await discard();
+            return {
+                content: [
+                    text(`Rendered ${slug} (${width}x${height} @${scale}x).` +
+                        (notes ? `\n${notes}` : '')),
+                    { type: 'image', data, mimeType: 'image/png' },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/node/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/node/render.ts"],"names":[],"mappings":"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","sourcesContent":["// `render_design`, the one tool that only exists over stdio.\n//\n// It shells out to the `tabbied` CLI: the only faithful renderer for a\n// css-doodle pattern is css-doodle in a real browser (see docs/svg-export.md),\n// and the CLI already owns the headless browser, the SVG converter, and the\n// option parsing. A Worker has no browser, so it doesn't offer the tool.\nimport { execFile } from 'node:child_process';\nimport { mkdtemp, readFile, rm, stat } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport path from 'node:path';\nimport { promisify } from 'node:util';\n\nimport type { Catalog, Tool, ToolResult } from '../types.js';\nimport { tabbiedRoot } from './resources.js';\n\nconst run = promisify(execFile);\n\n// Rendering launches a browser and waits for the first arrangement to settle.\nconst RENDER_TIMEOUT_MS = 180_000;\n\n// A PNG returned inline is spent context. Past this the file stays on disk and\n// the agent gets the path - better a usable pointer than a truncated image.\nconst INLINE_BYTE_BUDGET = 1_500_000;\n\nconst text = (value: string) => ({ type: 'text' as const, text: value });\n\nconst toolError = (message: string): ToolResult => ({\n  content: [text(message)],\n  isError: true,\n});\n\nexport function renderTool(catalog: Catalog): Tool {\n  return {\n    definition: {\n      name: 'render_design',\n      title: 'Render a design to a file',\n      description:\n        'Render a design to SVG or PNG with a real browser, at any size, seed, ' +\n        'palette, and option set. Use this to produce an actual asset - or to ' +\n        'preview a *customized* configuration, which preview_design cannot show ' +\n        'you (it only has the stock palette and defaults). Needs Playwright ' +\n        'installed alongside this server. Without \"out\" the image comes back ' +\n        'inline; with it, the file is written where you ask.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          slug: { type: 'string', description: 'The design to render.' },\n          format: {\n            type: 'string',\n            enum: ['svg', 'png'],\n            description:\n              'Vector or raster. A few designs cannot be vectorized - check ' +\n              'svgExport on the design first.',\n          },\n          out: {\n            type: 'string',\n            description:\n              'Absolute path to write to. Omit to get the image back inline ' +\n              'instead of on disk.',\n          },\n          seed: {\n            type: 'string',\n            description:\n              'Fixed seed - the same seed always gives the same image. Random ' +\n              'when omitted.',\n          },\n          palette: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              \"CSS colors, background first. Omit for the design's authored palette.\",\n          },\n          options: {\n            type: 'object',\n            description:\n              'Option values keyed by option id, e.g. {\"scale\": 3}. Read the ' +\n              'ids and ranges off get_design.',\n          },\n          width: { type: 'integer', description: 'Pixels wide (default 960).' },\n          height: { type: 'integer', description: 'Pixels tall (default 960).' },\n          fit: {\n            type: 'string',\n            enum: ['grid', 'cover', 'fixed'],\n            description: 'Sizing mode (default grid).',\n          },\n          scale: {\n            type: 'integer',\n            description:\n              'PNG device-scale factor. Defaults to 2 when writing a file and ' +\n              '1 when returning inline, to keep the response small.',\n          },\n        },\n        required: ['slug', 'format'],\n        additionalProperties: false,\n      },\n    },\n\n    async run(args): Promise<ToolResult> {\n      const slug = typeof args.slug === 'string' ? args.slug : '';\n      const design = catalog.designs.find((entry) => entry.slug === slug);\n      if (!design) {\n        return toolError(\n          `No design with slug \"${slug}\". Use search_designs to find one.`\n        );\n      }\n\n      const format = args.format === 'png' ? 'png' : 'svg';\n      if (format === 'svg' && !design.svgExport.supported) {\n        return toolError(\n          `\"${slug}\" paints effects SVG cannot represent, so it has no vector ` +\n            'export. Render it as PNG instead.'\n        );\n      }\n\n      const root = tabbiedRoot();\n      if (!root) {\n        return toolError(\n          'The `tabbied` package is not installed next to this server, so the ' +\n            'renderer is unavailable. Run `npm install tabbied`.'\n        );\n      }\n\n      const inline = typeof args.out !== 'string' || args.out.length === 0;\n      // An inline render gets a scratch directory, removed once its bytes\n      // have been read back.\n      const scratch = inline ? await mkdtemp(path.join(tmpdir(), 'tabbied-')) : null;\n      const outPath = scratch ? path.join(scratch, `${slug}.${format}`) : (args.out as string);\n      const discard = () => (scratch ? rm(scratch, { recursive: true, force: true }) : Promise.resolve());\n\n      const scale =\n        typeof args.scale === 'number' && Number.isFinite(args.scale)\n          ? Math.trunc(args.scale)\n          : inline\n            ? 1\n            : 2;\n\n      const argv = [\n        path.join(root, 'dist', 'cli.js'),\n        'render',\n        slug,\n        '--out',\n        outPath,\n        '--format',\n        format,\n        '--scale',\n        String(scale),\n      ];\n\n      const push = (flag: string, value: string) => argv.push(flag, value);\n\n      if (typeof args.seed === 'string' && args.seed) push('--seed', args.seed);\n      if (typeof args.fit === 'string') push('--fit', args.fit);\n\n      const width =\n        typeof args.width === 'number' ? Math.trunc(args.width) : 960;\n      const height =\n        typeof args.height === 'number' ? Math.trunc(args.height) : 960;\n      push('--size', `${width}x${height}`);\n\n      if (Array.isArray(args.palette) && args.palette.length) {\n        push('--palette', args.palette.filter(Boolean).join(','));\n      }\n\n      if (args.options && typeof args.options === 'object') {\n        const pairs = Object.entries(args.options as Record<string, unknown>)\n          .map(([id, value]) => `${id}: ${String(value)}`)\n          .join('; ');\n        if (pairs) push('--options', pairs);\n      }\n\n      let stderr = '';\n      try {\n        // No shell: argv goes straight to node, so a palette or option value\n        // can't be read as shell syntax.\n        ({ stderr } = await run(process.execPath, argv, {\n          timeout: RENDER_TIMEOUT_MS,\n          maxBuffer: 8 * 1024 * 1024,\n        }));\n      } catch (error) {\n        const detail =\n          error && typeof error === 'object' && 'stderr' in error\n            ? String((error as { stderr: unknown }).stderr).trim()\n            : error instanceof Error\n              ? error.message\n              : String(error);\n        return toolError(\n          `Rendering failed: ${detail || 'the CLI exited non-zero.'}\\n\\n` +\n            'If this says a browser is missing, install one alongside the ' +\n            'server (`npm i -D playwright`) or point TABBIED_CHROMIUM at a ' +\n            'Chromium binary.'\n        );\n      }\n\n      // The CLI reports SVG-fidelity caveats on stderr; they matter enough to\n      // pass through rather than swallow.\n      const notes = stderr\n        .split('\\n')\n        .filter((line) => line.trim().startsWith('note:'))\n        .join('\\n');\n\n      if (!inline) {\n        const { size } = await stat(outPath);\n        return {\n          content: [\n            text(\n              `Rendered ${slug} to ${outPath} (${width}x${height}` +\n                (format === 'png' ? ` @${scale}x` : '') +\n                `, ${Math.round(size / 1024)} KB).` +\n                (notes ? `\\n${notes}` : '')\n            ),\n          ],\n        };\n      }\n\n      if (format === 'svg') {\n        const svg = await readFile(outPath, 'utf-8');\n        await discard();\n        return {\n          content: [\n            text(\n              `Rendered ${slug} as SVG (${width}x${height}).` +\n                (notes ? `\\n${notes}` : '')\n            ),\n            text(svg),\n          ],\n        };\n      }\n\n      const png = await readFile(outPath);\n      const data = png.toString('base64');\n      if (data.length > INLINE_BYTE_BUDGET) {\n        // Kept: the answer tells the agent to read it from that path.\n        return {\n          content: [\n            text(\n              `Rendered ${slug} to ${outPath} - ${Math.round(\n                png.byteLength / 1024\n              )} KB, too large to return inline. Read it from that path, or ` +\n                're-render smaller (lower \"scale\", or a smaller width/height).'\n            ),\n          ],\n        };\n      }\n\n      await discard();\n      return {\n        content: [\n          text(\n            `Rendered ${slug} (${width}x${height} @${scale}x).` +\n              (notes ? `\\n${notes}` : '')\n          ),\n          { type: 'image', data, mimeType: 'image/png' },\n        ],\n      };\n    },\n  };\n}\n"]}

package/dist/node/resources.d.ts

@@ -0,0 +1,24 @@
+import type { Catalog, CatalogDesign, TemplateCatalog, TemplateSpec } from '../types.js';
+/** Root of the installed `tabbied` package, or null when it isn't resolvable. */
+export declare function tabbiedRoot(): string | null;
+export declare function loadCatalog(): Promise<Catalog>;
+/**
+ * Preview bytes for one design: the committed @2x renders the site serves, so
+ * the agent sees the same image a human browsing the gallery does.
+ */
+export declare function fetchPreview(design: CatalogDesign): Promise<{
+    data: string;
+    mimeType: string;
+}>;
+/**
+ * The full reference. The package's own llms.txt is the *full* text (in
+ * node_modules depth beats brevity), so this works offline too.
+ */
+export declare function fetchDocs(): Promise<string>;
+/**
+ * The editable-template index and one site's spec. Network only, deliberately:
+ * they are *site* artifacts generated from the static export
+ * (docs/editable-templates.md), and the `tabbied` package does not contain them.
+ */
+export declare function fetchTemplateCatalog(): Promise<TemplateCatalog>;
+export declare function fetchTemplate(slug: string): Promise<TemplateSpec>;

package/dist/node/resources.js

@@ -0,0 +1,97 @@
+// Where the stdio server gets its catalog, previews, and docs.
+//
+// The catalog is read from the installed `tabbied` package rather than fetched,
+// so the tools describe exactly the version the caller will `npm install`: a
+// design that only exists on the site would give an import that doesn't
+// resolve. The network is the fallback, not the default.
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+const require = createRequire(import.meta.url);
+const SITE = 'https://tabbied.com';
+/** Root of the installed `tabbied` package, or null when it isn't resolvable. */
+export function tabbiedRoot() {
+    try {
+        return path.dirname(require.resolve('tabbied/package.json'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadCatalog() {
+    const root = tabbiedRoot();
+    if (root) {
+        try {
+            return JSON.parse(await readFile(path.join(root, 'catalog.json'), 'utf-8'));
+        }
+        catch (error) {
+            // A resolvable package with no catalog.json means a source checkout that
+            // hasn't been built. Say so - the network copy would silently disagree
+            // with the local patterns the user is about to edit.
+            const reason = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`tabbied-mcp: could not read the local catalog (${reason}); ` +
+                `falling back to ${SITE}/catalog.json\n`);
+        }
+    }
+    const response = await fetch(`${SITE}/catalog.json`);
+    if (!response.ok) {
+        throw new Error(`no local catalog and ${SITE}/catalog.json returned ${response.status}. ` +
+            'Install the `tabbied` package (npm i tabbied) or restore network access.');
+    }
+    return (await response.json());
+}
+/**
+ * Preview bytes for one design: the committed @2x renders the site serves, so
+ * the agent sees the same image a human browsing the gallery does.
+ */
+export async function fetchPreview(design) {
+    const response = await fetch(design.preview);
+    if (!response.ok) {
+        throw new Error(`${design.preview} returned ${response.status}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    return {
+        data: buffer.toString('base64'),
+        mimeType: response.headers.get('Content-Type') ?? 'image/webp',
+    };
+}
+/**
+ * The full reference. The package's own llms.txt is the *full* text (in
+ * node_modules depth beats brevity), so this works offline too.
+ */
+export async function fetchDocs() {
+    const root = tabbiedRoot();
+    if (root) {
+        try {
+            return await readFile(path.join(root, 'llms.txt'), 'utf-8');
+        }
+        catch {
+            // fall through to the network copy
+        }
+    }
+    const response = await fetch(`${SITE}/llms-full.txt`);
+    if (!response.ok) {
+        throw new Error(`${SITE}/llms-full.txt returned ${response.status}`);
+    }
+    return await response.text();
+}
+/**
+ * The editable-template index and one site's spec. Network only, deliberately:
+ * they are *site* artifacts generated from the static export
+ * (docs/editable-templates.md), and the `tabbied` package does not contain them.
+ */
+export async function fetchTemplateCatalog() {
+    const response = await fetch(`${SITE}/editable-catalog.json`);
+    if (!response.ok) {
+        throw new Error(`${SITE}/editable-catalog.json returned ${response.status}`);
+    }
+    return (await response.json());
+}
+export async function fetchTemplate(slug) {
+    const response = await fetch(`${SITE}/editable/${slug}.json`);
+    if (!response.ok) {
+        throw new Error(`${SITE}/editable/${slug}.json returned ${response.status}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=resources.js.map

package/dist/node/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/node/resources.ts"],"names":[],"mappings":"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","sourcesContent":["// Where the stdio server gets its catalog, previews, and docs.\n//\n// The catalog is read from the installed `tabbied` package rather than fetched,\n// so the tools describe exactly the version the caller will `npm install`: a\n// design that only exists on the site would give an import that doesn't\n// resolve. The network is the fallback, not the default.\nimport { createRequire } from 'node:module';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type {\n  Catalog,\n  CatalogDesign,\n  TemplateCatalog,\n  TemplateSpec,\n} from '../types.js';\n\nconst require = createRequire(import.meta.url);\n\nconst SITE = 'https://tabbied.com';\n\n/** Root of the installed `tabbied` package, or null when it isn't resolvable. */\nexport function tabbiedRoot(): string | null {\n  try {\n    return path.dirname(require.resolve('tabbied/package.json'));\n  } catch {\n    return null;\n  }\n}\n\nexport async function loadCatalog(): Promise<Catalog> {\n  const root = tabbiedRoot();\n\n  if (root) {\n    try {\n      return JSON.parse(\n        await readFile(path.join(root, 'catalog.json'), 'utf-8')\n      ) as Catalog;\n    } catch (error) {\n      // A resolvable package with no catalog.json means a source checkout that\n      // hasn't been built. Say so - the network copy would silently disagree\n      // with the local patterns the user is about to edit.\n      const reason = error instanceof Error ? error.message : String(error);\n      process.stderr.write(\n        `tabbied-mcp: could not read the local catalog (${reason}); ` +\n          `falling back to ${SITE}/catalog.json\\n`\n      );\n    }\n  }\n\n  const response = await fetch(`${SITE}/catalog.json`);\n  if (!response.ok) {\n    throw new Error(\n      `no local catalog and ${SITE}/catalog.json returned ${response.status}. ` +\n        'Install the `tabbied` package (npm i tabbied) or restore network access.'\n    );\n  }\n  return (await response.json()) as Catalog;\n}\n\n/**\n * Preview bytes for one design: the committed @2x renders the site serves, so\n * the agent sees the same image a human browsing the gallery does.\n */\nexport async function fetchPreview(\n  design: CatalogDesign\n): Promise<{ data: string; mimeType: string }> {\n  const response = await fetch(design.preview);\n  if (!response.ok) {\n    throw new Error(`${design.preview} returned ${response.status}`);\n  }\n  const buffer = Buffer.from(await response.arrayBuffer());\n  return {\n    data: buffer.toString('base64'),\n    mimeType: response.headers.get('Content-Type') ?? 'image/webp',\n  };\n}\n\n/**\n * The full reference. The package's own llms.txt is the *full* text (in\n * node_modules depth beats brevity), so this works offline too.\n */\nexport async function fetchDocs(): Promise<string> {\n  const root = tabbiedRoot();\n  if (root) {\n    try {\n      return await readFile(path.join(root, 'llms.txt'), 'utf-8');\n    } catch {\n      // fall through to the network copy\n    }\n  }\n\n  const response = await fetch(`${SITE}/llms-full.txt`);\n  if (!response.ok) {\n    throw new Error(`${SITE}/llms-full.txt returned ${response.status}`);\n  }\n  return await response.text();\n}\n\n/**\n * The editable-template index and one site's spec. Network only, deliberately:\n * they are *site* artifacts generated from the static export\n * (docs/editable-templates.md), and the `tabbied` package does not contain them.\n */\nexport async function fetchTemplateCatalog(): Promise<TemplateCatalog> {\n  const response = await fetch(`${SITE}/editable-catalog.json`);\n\n  if (!response.ok) {\n    throw new Error(`${SITE}/editable-catalog.json returned ${response.status}`);\n  }\n\n  return (await response.json()) as TemplateCatalog;\n}\n\nexport async function fetchTemplate(slug: string): Promise<TemplateSpec> {\n  const response = await fetch(`${SITE}/editable/${slug}.json`);\n\n  if (!response.ok) {\n    throw new Error(`${SITE}/editable/${slug}.json returned ${response.status}`);\n  }\n\n  return (await response.json()) as TemplateSpec;\n}\n"]}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import type { Tool } from './types.js';
+/**
+ * Register a toolset onto a fresh `McpServer`.
+ *
+ * Tool schemas stay plain JSON Schema, adapted by `fromJsonSchema`, because
+ * `search_designs`'s enums are derived from the catalog being served and so
+ * cannot be static Zod. Registering the schema also makes the SDK validate
+ * arguments: a bad enum value comes back as a tool error naming the allowed
+ * values instead of silently matching nothing.
+ */
+export declare function buildServer(tools: Tool[]): McpServer;

package/dist/server.js

@@ -0,0 +1,30 @@
+// Turns the runtime-agnostic toolset into an SDK `McpServer`. The Worker hands
+// the factory to `createMcpHandler` and the bin hands it to `serveStdio`, so
+// both transports get the same tools, instructions, and era handling.
+//
+// A *factory*, not an instance: MCP v2 is stateless and the SDK builds one
+// server per request (per connection on stdio). Nothing here may capture
+// per-request state.
+import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';
+import { INSTRUCTIONS, SERVER_NAME, VERSION } from './info.js';
+/**
+ * Register a toolset onto a fresh `McpServer`.
+ *
+ * Tool schemas stay plain JSON Schema, adapted by `fromJsonSchema`, because
+ * `search_designs`'s enums are derived from the catalog being served and so
+ * cannot be static Zod. Registering the schema also makes the SDK validate
+ * arguments: a bad enum value comes back as a tool error naming the allowed
+ * values instead of silently matching nothing.
+ */
+export function buildServer(tools) {
+    const server = new McpServer({ name: SERVER_NAME, version: VERSION }, { capabilities: { tools: {} }, instructions: INSTRUCTIONS });
+    for (const tool of tools) {
+        server.registerTool(tool.definition.name, {
+            title: tool.definition.title,
+            description: tool.definition.description,
+            inputSchema: fromJsonSchema(tool.definition.inputSchema),
+        }, async (args) => (await tool.run(args ?? {})));
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG/D;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAC5D,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,UAAU,CAAC,IAAI,EACpB;YACE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;YACxC,WAAW,EAAE,cAAc,CACzB,IAAI,CAAC,UAAU,CAAC,WAAW,CAC5B;SACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAU,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["// Turns the runtime-agnostic toolset into an SDK `McpServer`. The Worker hands\n// the factory to `createMcpHandler` and the bin hands it to `serveStdio`, so\n// both transports get the same tools, instructions, and era handling.\n//\n// A *factory*, not an instance: MCP v2 is stateless and the SDK builds one\n// server per request (per connection on stdio). Nothing here may capture\n// per-request state.\nimport { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';\n\nimport { INSTRUCTIONS, SERVER_NAME, VERSION } from './info.js';\nimport type { Tool } from './types.js';\n\n/**\n * Register a toolset onto a fresh `McpServer`.\n *\n * Tool schemas stay plain JSON Schema, adapted by `fromJsonSchema`, because\n * `search_designs`'s enums are derived from the catalog being served and so\n * cannot be static Zod. Registering the schema also makes the SDK validate\n * arguments: a bad enum value comes back as a tool error naming the allowed\n * values instead of silently matching nothing.\n */\nexport function buildServer(tools: Tool[]): McpServer {\n  const server = new McpServer(\n    { name: SERVER_NAME, version: VERSION },\n    { capabilities: { tools: {} }, instructions: INSTRUCTIONS }\n  );\n\n  for (const tool of tools) {\n    server.registerTool(\n      tool.definition.name,\n      {\n        title: tool.definition.title,\n        description: tool.definition.description,\n        inputSchema: fromJsonSchema<Record<string, unknown>>(\n          tool.definition.inputSchema\n        ),\n      },\n      async (args) => (await tool.run(args ?? {})) as never\n    );\n  }\n\n  return server;\n}\n"]}

package/dist/stdio.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};