@kywi-software/mcp 0.1.0

package/dist/developer/tools/read-only.d.ts

@@ -0,0 +1,86 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KywiHttpClient } from '@kywi-software/sdk';
+import type { KywiConfig } from '@kywi-software/core';
+export interface ReadOnlyContext {
+    mode: 'filesystem' | 'api';
+    configPath?: string | undefined;
+    http?: KywiHttpClient | undefined;
+    /** Resolved KywiConfig object — when provided, used for richer config summaries */
+    config?: KywiConfig | undefined;
+}
+export declare function handleGetConfigSummary(ctx: ReadOnlyContext): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleGetContentTypes(ctx: ReadOnlyContext): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleGetThemes(ctx: ReadOnlyContext): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleGetModules(ctx: ReadOnlyContext): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleGetPlugins(ctx: ReadOnlyContext): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handlePreviewSchema(ctx: ReadOnlyContext, args: {
+    contentTypeName?: string | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function registerReadOnlyTools(server: McpServer, ctx: ReadOnlyContext): void;
+//# sourceMappingURL=read-only.d.ts.map

package/dist/developer/tools/read-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.d.ts","sourceRoot":"","sources":["../../../src/developer/tools/read-only.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,GAAG,KAAK,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;IACjC,mFAAmF;IACnF,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CAChC;AAUD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;GAwDhE;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;GAe/D;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;GAczD;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;GAc1D;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe;;;;;;;;;;;;GAc1D;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;;;;;;GAqG/C;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAgCnF"}

package/dist/developer/tools/read-only.js

@@ -0,0 +1,235 @@
+import { readFileSync } from 'node:fs';
+import { z } from 'zod';
+import { textResult, errorResult } from '../../shared.js';
+import { exportConfigAsJson } from '@kywi-software/core';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function readConfig(configPath) {
+    return readFileSync(configPath, 'utf-8');
+}
+// ─── Exported handler functions (testable without server) ─────────────────
+export async function handleGetConfigSummary(ctx) {
+    // Prefer the resolved config object for a rich, structured summary
+    if (ctx.config) {
+        const exported = exportConfigAsJson(ctx.config);
+        return textResult({
+            mode: ctx.mode,
+            source: 'config-object',
+            summary: {
+                mode: exported.mode,
+                db: exported.db,
+                auth: exported.auth,
+                siteCount: Array.isArray(exported.sites) ? exported.sites.length : 0,
+                contentTypeCount: Array.isArray(exported.contentTypes) ? exported.contentTypes.length : 0,
+                moduleCount: Array.isArray(exported.modules) ? exported.modules.length : 0,
+                pluginCount: Array.isArray(exported.plugins) ? exported.plugins.length : 0,
+                themeCount: Array.isArray(exported.themes) ? exported.themes.length : 0,
+                contentTypes: Array.isArray(exported.contentTypes)
+                    ? exported.contentTypes.map(ct => ({
+                        name: ct['name'],
+                        label: ct['label'],
+                        baseType: ct['baseType'],
+                        fieldCount: Array.isArray(ct['fields']) ? ct['fields'].length : 0,
+                    }))
+                    : [],
+                cache: exported.cache,
+                media: exported.media,
+            },
+        });
+    }
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        const contentTypeMatches = raw.match(/defineContentType\s*\(/g);
+        const themeMatches = raw.match(/defineTheme\s*\(/g);
+        const pluginMatches = raw.match(/definePlugin\s*\(/g);
+        return textResult({
+            mode: 'filesystem',
+            configPath: ctx.configPath,
+            contentTypes: contentTypeMatches ? contentTypeMatches.length : 0,
+            themes: themeMatches ? themeMatches.length : 0,
+            plugins: pluginMatches ? pluginMatches.length : 0,
+            rawLength: raw.length,
+        });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        const contentTypes = await ctx.http.get('/config/content-types');
+        const sites = await ctx.http.get('/config/sites');
+        return textResult({
+            mode: 'api',
+            contentTypes: Array.isArray(contentTypes) ? contentTypes.length : 0,
+            sites: Array.isArray(sites) ? sites.length : 0,
+        });
+    }
+    return errorResult('No config source available');
+}
+export async function handleGetContentTypes(ctx) {
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        // Extract content type definitions for inspection
+        const matches = [...raw.matchAll(/defineContentType\s*\(\s*(['"`])(\w+)\1/g)];
+        const names = matches.map((m) => m[2]);
+        return textResult({ mode: 'filesystem', contentTypes: names, source: ctx.configPath });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        const data = await ctx.http.get('/config/content-types');
+        return textResult({ mode: 'api', contentTypes: data });
+    }
+    return errorResult('No config source available');
+}
+export async function handleGetThemes(ctx) {
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        const matches = [...raw.matchAll(/defineTheme\s*\(\s*(['"`])(\w+)\1/g)];
+        const names = matches.map((m) => m[2]);
+        return textResult({ mode: 'filesystem', themes: names, source: ctx.configPath });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        const data = await ctx.http.get('/config/themes');
+        return textResult({ mode: 'api', themes: data });
+    }
+    return errorResult('No config source available');
+}
+export async function handleGetModules(ctx) {
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        const matches = [...raw.matchAll(/defineModule\s*\(\s*(['"`])(\w+)\1/g)];
+        const names = matches.map((m) => m[2]);
+        return textResult({ mode: 'filesystem', modules: names, source: ctx.configPath });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        const data = await ctx.http.get('/config/modules');
+        return textResult({ mode: 'api', modules: data });
+    }
+    return errorResult('No config source available');
+}
+export async function handleGetPlugins(ctx) {
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        const matches = [...raw.matchAll(/definePlugin\s*\(\s*(['"`])(\w+)\1/g)];
+        const names = matches.map((m) => m[2]);
+        return textResult({ mode: 'filesystem', plugins: names, source: ctx.configPath });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        const data = await ctx.http.get('/config/plugins');
+        return textResult({ mode: 'api', plugins: data });
+    }
+    return errorResult('No config source available');
+}
+export async function handlePreviewSchema(ctx, args) {
+    if (ctx.mode === 'filesystem' && ctx.configPath) {
+        const raw = readConfig(ctx.configPath);
+        if (args.contentTypeName) {
+            // Extract the specific content type block
+            const typePattern = new RegExp(`defineContentType\\s*\\(\\s*['"\`]${args.contentTypeName}['"\`]\\s*,\\s*(\\{[\\s\\S]*?\\})\\s*\\)`);
+            const match = typePattern.exec(raw);
+            if (!match) {
+                return textResult({
+                    mode: 'filesystem',
+                    contentTypeName: args.contentTypeName,
+                    found: false,
+                    note: `Content type '${args.contentTypeName}' not found in config. Use get_content_types to list available types.`,
+                });
+            }
+            // Extract field definitions from the block
+            const block = match[1] ?? '';
+            const fieldMatches = [
+                ...block.matchAll(/\{\s*name\s*:\s*['"`](\w+)['"`]\s*,\s*type\s*:\s*['"`](\w+)['"`](?:\s*,\s*label\s*:\s*['"`]([^'"`]+)['"`])?(?:\s*,\s*required\s*:\s*(true|false))?/g),
+            ];
+            const fields = fieldMatches.map((m) => ({
+                name: m[1],
+                type: m[2],
+                label: m[3] ?? m[1],
+                required: m[4] === 'true',
+            }));
+            // Map config field types to Drizzle column descriptors
+            const typeMap = {
+                text: 'text()',
+                textarea: 'text()',
+                richText: 'text()',
+                slug: 'varchar(255)',
+                number: 'integer()',
+                boolean: 'boolean()',
+                date: 'timestamp({ withTimezone: true })',
+                image: 'uuid() /* FK → kywi_media */',
+                file: 'uuid() /* FK → kywi_media */',
+                relationship: 'uuid() /* FK → kywi_content */',
+                select: 'text()',
+                multiSelect: 'jsonb()',
+                color: 'varchar(20)',
+                json: 'jsonb()',
+            };
+            const schemaColumns = fields.map((f) => ({
+                field: f.name,
+                label: f.label,
+                type: f.type,
+                drizzleType: typeMap[f.type ?? ''] ?? 'text()',
+                required: f.required,
+                nullable: !f.required,
+            }));
+            return textResult({
+                mode: 'filesystem',
+                contentTypeName: args.contentTypeName,
+                found: true,
+                tableName: `kywi_content (contentTypeName = '${args.contentTypeName}')`,
+                note: 'Kywi stores all content in the unified kywi_content table. Custom fields are mixed in at the application layer.',
+                inferredColumns: schemaColumns,
+                source: ctx.configPath,
+            });
+        }
+        // No specific type — return overview of all types
+        const matches = [...raw.matchAll(/defineContentType\s*\(\s*(['"`])(\w+)\1/g)];
+        const names = matches.map((m) => m[2]);
+        return textResult({
+            mode: 'filesystem',
+            note: "Pass contentTypeName to inspect a specific type's schema. All types share the kywi_content table.",
+            availableTypes: names,
+            source: ctx.configPath,
+        });
+    }
+    if (ctx.mode === 'api' && ctx.http) {
+        try {
+            const contentTypes = await ctx.http.get('/config/content-types');
+            return textResult({
+                mode: 'api',
+                contentTypes,
+                note: 'Schema is derived at runtime. Use contentTypeName parameter to see field-level detail.',
+            });
+        }
+        catch (err) {
+            return textResult({ mode: 'api', note: 'Schema preview via API not available.', error: String(err) });
+        }
+    }
+    return textResult({
+        mode: ctx.mode,
+        note: 'Schema preview is only available in filesystem or api mode.',
+    });
+}
+// ─── Registration ─────────────────────────────────────────────────────────────
+export function registerReadOnlyTools(server, ctx) {
+    server.registerTool('get_config_summary', {
+        description: 'Get a summary of the Kywi configuration (content types, themes, plugins)',
+        inputSchema: {},
+    }, async () => handleGetConfigSummary(ctx));
+    server.registerTool('get_content_types', {
+        description: 'List all defined content types from the Kywi configuration',
+        inputSchema: {},
+    }, async () => handleGetContentTypes(ctx));
+    server.registerTool('get_themes', {
+        description: 'List all defined themes from the Kywi configuration',
+        inputSchema: {},
+    }, async () => handleGetThemes(ctx));
+    server.registerTool('get_modules', {
+        description: 'List all defined modules from the Kywi configuration',
+        inputSchema: {},
+    }, async () => handleGetModules(ctx));
+    server.registerTool('get_plugins', {
+        description: 'List all defined plugins from the Kywi configuration',
+        inputSchema: {},
+    }, async () => handleGetPlugins(ctx));
+    server.registerTool('preview_schema', {
+        description: 'Preview the Drizzle schema definition for a content type — shows table structure, columns, and inferred types',
+        inputSchema: {
+            contentTypeName: z.string().optional().describe('Content type name to inspect (omit to list all available types)'),
+        },
+    }, async (args) => handlePreviewSchema(ctx, args));
+}
+//# sourceMappingURL=read-only.js.map

package/dist/developer/tools/read-only.js.map

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

package/dist/developer/tools/scaffolding.d.ts

@@ -0,0 +1,67 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KywiSdkScope } from '@kywi-software/sdk';
+export declare function handleScaffoldSiteStructure(sdk: KywiSdkScope, args: {
+    siteType: string;
+    siteId: string;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleScaffoldContentType(_sdk: KywiSdkScope, args: {
+    name: string;
+    description: string;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function handleScaffoldTheme(_sdk: KywiSdkScope, args: {
+    name: string;
+    description: string;
+    regions?: string[] | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function handleSeedContent(sdk: KywiSdkScope, args: {
+    type: string;
+    count: number;
+    siteId: string;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function handleScaffoldComponent(_sdk: KywiSdkScope, args: {
+    moduleName: string;
+    description: string;
+    props?: Array<{
+        name: string;
+        type: string;
+        label: string;
+    }> | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function registerScaffoldingTools(server: McpServer, sdk: KywiSdkScope): void;
+//# sourceMappingURL=scaffolding.d.ts.map

package/dist/developer/tools/scaffolding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolding.d.ts","sourceRoot":"","sources":["../../../src/developer/tools/scaffolding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAyCtD,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA0B3C;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;;;;;;GAsB5C;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAAE;;;;;;GAa5E;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;GAqBtD;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;CAAE;;;;;;GA8D5H;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CA+CnF"}

package/dist/developer/tools/scaffolding.js

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+import { textResult, errorResult } from '../../shared.js';
+const siteTemplates = {
+    corporate: [
+        { title: 'Home', slug: 'home', type: 'page' },
+        { title: 'About', slug: 'about', type: 'page' },
+        { title: 'Services', slug: 'services', type: 'page' },
+        { title: 'Contact', slug: 'contact', type: 'page' },
+        { title: 'Blog', slug: 'blog', type: 'folder' },
+    ],
+    blog: [
+        { title: 'Home', slug: 'home', type: 'page' },
+        { title: 'Posts', slug: 'posts', type: 'folder' },
+        { title: 'About', slug: 'about', type: 'page' },
+    ],
+    portfolio: [
+        { title: 'Home', slug: 'home', type: 'page' },
+        { title: 'Projects', slug: 'projects', type: 'folder' },
+        { title: 'About', slug: 'about', type: 'page' },
+        { title: 'Contact', slug: 'contact', type: 'page' },
+    ],
+    ecommerce: [
+        { title: 'Home', slug: 'home', type: 'page' },
+        { title: 'Products', slug: 'products', type: 'folder' },
+        { title: 'Categories', slug: 'categories', type: 'folder' },
+        { title: 'Cart', slug: 'cart', type: 'page' },
+        { title: 'About', slug: 'about', type: 'page' },
+    ],
+};
+// ─── Exported handler functions (testable without server) ─────────────────
+export async function handleScaffoldSiteStructure(sdk, args) {
+    const template = siteTemplates[args.siteType];
+    if (!template) {
+        return errorResult(`Unknown site type: ${args.siteType}. Valid types: ${Object.keys(siteTemplates).join(', ')}`);
+    }
+    const created = [];
+    const errors = [];
+    for (const page of template) {
+        try {
+            const item = await sdk.content.create('page', {
+                title: page.title,
+                slug: page.slug,
+                contentType: page.type,
+                siteId: args.siteId,
+                status: 'draft',
+            }, args.siteId);
+            created.push(item);
+        }
+        catch (err) {
+            errors.push({ page: page.title, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    return textResult({ siteType: args.siteType, created: created.length, errors, pages: template.map((p) => p.title) });
+}
+export async function handleScaffoldContentType(_sdk, args) {
+    // Return a suggested config block for the AI agent to apply via add_content_type
+    const suggestion = {
+        name: args.name,
+        label: args.name.charAt(0).toUpperCase() + args.name.slice(1),
+        baseType: 'page',
+        fields: [
+            { name: 'title', type: 'text', label: 'Title', required: true },
+            { name: 'slug', type: 'text', label: 'URL Slug', required: true },
+            { name: 'body', type: 'richtext', label: 'Body' },
+            { name: 'featuredImage', type: 'image', label: 'Featured Image' },
+            { name: 'metaTitle', type: 'text', label: 'Meta Title' },
+            { name: 'metaDescription', type: 'text', label: 'Meta Description' },
+        ],
+    };
+    return textResult({
+        suggestion,
+        description: args.description,
+        note: 'This is a suggested content type scaffold. Call add_content_type with the suggestion (or modify it) to apply.',
+    });
+}
+export async function handleScaffoldTheme(_sdk, args) {
+    const regions = args.regions ?? ['header', 'main', 'sidebar', 'footer'];
+    return textResult({
+        suggestion: {
+            name: args.name,
+            label: args.name.charAt(0).toUpperCase() + args.name.slice(1),
+            regions,
+        },
+        description: args.description,
+        note: 'This is a suggested theme scaffold. Call add_theme with the suggestion (or modify it) to apply.',
+    });
+}
+export async function handleSeedContent(sdk, args) {
+    const created = [];
+    const errors = [];
+    for (let i = 0; i < args.count; i++) {
+        try {
+            const item = await sdk.content.create(args.type, {
+                title: `Sample ${args.type} ${i + 1}`,
+                slug: `sample-${args.type}-${i + 1}`,
+                body: `This is sample ${args.type} content item ${i + 1}. Auto-generated for development.`,
+                status: 'draft',
+                siteId: args.siteId,
+            }, args.siteId);
+            created.push(item);
+        }
+        catch (err) {
+            errors.push({ index: i, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    return textResult({ type: args.type, created: created.length, requested: args.count, errors });
+}
+export async function handleScaffoldComponent(_sdk, args) {
+    const props = args.props ?? [
+        { name: 'title', type: 'string', label: 'Title' },
+        { name: 'body', type: 'string', label: 'Body' },
+    ];
+    const interfaceName = args.moduleName.charAt(0).toUpperCase() + args.moduleName.slice(1) + 'Props';
+    const componentName = args.moduleName.charAt(0).toUpperCase() + args.moduleName.slice(1);
+    // Build the props interface lines
+    const propLines = props.map((p) => {
+        const tsType = p.type === 'boolean' ? 'boolean' : p.type === 'number' ? 'number' : 'string';
+        return `  /** ${p.label} */\n  ${p.name}: ${tsType}`;
+    });
+    const destructured = props.map((p) => p.name).join(', ');
+    const template = [
+        `import React from 'react'`,
+        ``,
+        `// ─── Props ───────────────────────────────────────────────────────────────────`,
+        ``,
+        `export interface ${interfaceName} {`,
+        ...propLines,
+        `}`,
+        ``,
+        `// ─── Component ───────────────────────────────────────────────────────────────`,
+        ``,
+        `export function ${componentName}({ ${destructured} }: ${interfaceName}) {`,
+        `  return (`,
+        `    <div className="kywi-module kywi-module--${args.moduleName.toLowerCase()}">`,
+        `      {/* TODO: implement ${componentName} */}`,
+        `    </div>`,
+        `  )`,
+        `}`,
+        ``,
+        `export default ${componentName}`,
+    ].join('\n');
+    const moduleDefinition = {
+        name: args.moduleName,
+        label: args.moduleName.charAt(0).toUpperCase() + args.moduleName.slice(1),
+        component: `./${componentName}.tsx`,
+        props: Object.fromEntries(props.map((p) => [
+            p.name,
+            {
+                type: p.type === 'boolean' ? 'boolean' : p.type === 'number' ? 'number' : 'text',
+                label: p.label,
+            },
+        ])),
+    };
+    return textResult({
+        moduleName: args.moduleName,
+        description: args.description,
+        componentCode: template,
+        moduleDefinition,
+        note: 'Copy componentCode into your modules directory. Add the moduleDefinition to your kywi.config.ts modules array.',
+    });
+}
+// ─── Registration ─────────────────────────────────────────────────────────────
+export function registerScaffoldingTools(server, sdk) {
+    server.registerTool('scaffold_site_structure', {
+        description: 'Create template content pages for a site based on a predefined structure',
+        inputSchema: {
+            siteType: z.enum(['corporate', 'blog', 'portfolio', 'ecommerce']).describe('Type of site to scaffold'),
+            siteId: z.string().describe('Site ID to create pages in'),
+        },
+    }, async (args) => handleScaffoldSiteStructure(sdk, args));
+    server.registerTool('scaffold_content_type', {
+        description: 'Generate a suggested content type definition (does not apply it; use add_content_type to apply)',
+        inputSchema: {
+            name: z.string().describe('Content type name'),
+            description: z.string().describe('Description of what this content type represents'),
+        },
+    }, async (args) => handleScaffoldContentType(sdk, args));
+    server.registerTool('scaffold_theme', {
+        description: 'Generate a suggested theme definition with regions (does not apply it; use add_theme to apply)',
+        inputSchema: {
+            name: z.string().describe('Theme name'),
+            description: z.string().describe('Description of the theme'),
+            regions: z.array(z.string()).optional().describe('Region names (defaults to header, main, sidebar, footer)'),
+        },
+    }, async (args) => handleScaffoldTheme(sdk, args));
+    server.registerTool('seed_content', {
+        description: 'Create sample content items for development and testing',
+        inputSchema: {
+            type: z.string().describe('Content type name'),
+            count: z.number().min(1).max(100).describe('Number of items to create (1-100)'),
+            siteId: z.string().describe('Site ID to create content in'),
+        },
+    }, async (args) => handleSeedContent(sdk, args));
+    server.registerTool('scaffold_component', {
+        description: 'Generate starter React component code for a custom Kywi module, including the props interface and module definition',
+        inputSchema: {
+            moduleName: z.string().describe('Module name in camelCase (e.g. heroSection, featureGrid)'),
+            description: z.string().describe('Description of what this module does'),
+            props: z.array(z.object({
+                name: z.string().describe('Prop name'),
+                type: z.enum(['string', 'number', 'boolean']).describe('TypeScript type for this prop'),
+                label: z.string().describe('Human-readable label'),
+            })).optional().describe('Prop definitions (defaults to title + body if omitted)'),
+        },
+    }, async (args) => handleScaffoldComponent(sdk, args));
+}
+//# sourceMappingURL=scaffolding.js.map

package/dist/developer/tools/scaffolding.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config.js';
+export * from './shared.js';
+export { createSiteMcpServer, startSiteMcp } from './site/index.js';
+export { createDeveloperMcpServer, startDeveloperMcp } from './developer/index.js';
+export { detectMode } from './developer/auto-detect.js';
+export type { DetectedMode } from './developer/auto-detect.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA"}