@sudajs/cli 0.10.3 → 0.11.0

package/dist/index.js

@@ -7,7 +7,7 @@ import { createInterface } from 'readline/promises';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createThemeAgentManifest, createAgentPageSchemaOutput, checkThemeModule, formatThemeCheckResult, validateAgentPageContentWithManifest, agentValidationResultSchema, findAgentSection, createAgentComponentSchemaOutput, agentPageSchemaOutputSchema, agentComponentOutputSchema } from '@sudajs/theme-engine';
+import { createThemeAgentManifest, createSudaPageAgentRuntime, checkThemeModule, formatThemeCheckResult, agentValidationResultSchema, agentPageSchemaOutputSchema, agentComponentOutputSchema } from '@sudajs/theme-engine';
 import { themeManifestSchema } from '@sudajs/theme-engine/server';
 import { Command } from 'commander';
 import { build } from 'esbuild';
@@ -691,6 +691,10 @@ ${issues}`);
   if (!Array.isArray(module.starterPages)) {
     throw new Error("starterPages must be an array.");
   }
+  const result = checkThemeModule(module);
+  if (!result.ok) {
+    throw new Error(formatThemeCheckResult(result));
+  }
 }
 async function validateTheme(root) {
   const packageJsonPath = path2.join(root, "package.json");
@@ -1686,16 +1690,16 @@ function printJson(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function createSectionSchema(manifest, sectionType) {
-  const section = findAgentSection(manifest, sectionType);
-  if (!section) {
+  const section = createSudaPageAgentRuntime(manifest).getSectionSchemaOutput(sectionType);
+  if (section === null) {
     throw new Error(`Unknown section type "${sectionType}".`);
   }
-  return createAgentComponentSchemaOutput(section, "section");
+  return section;
 }
 async function validateAgentPage(themeKey, input, options) {
   const manifest = await fetchAgentManifest(themeKey, options);
   const pageContent = await readJson(path2.resolve(input));
-  const result = validateAgentPageContentWithManifest(pageContent, manifest);
+  const result = createSudaPageAgentRuntime(manifest).validatePageContent(pageContent);
   printJson(agentValidationResultSchema.parse(result));
   if (!result.valid) {
     process.exitCode = 1;
@@ -1707,9 +1711,9 @@ async function createAgentPage(options) {
   }
   const pageContent = await readJson(path2.resolve(options.input));
   const manifest = await fetchAgentManifest(options.theme, options);
-  const validation = validateAgentPageContentWithManifest(pageContent, manifest);
-  if (!validation.valid) {
-    printJson(agentValidationResultSchema.parse(validation));
+  const prepared = createSudaPageAgentRuntime(manifest).preparePageData(pageContent);
+  if (!prepared.validation.valid) {
+    printJson(agentValidationResultSchema.parse(prepared.validation));
     process.exitCode = 1;
     return;
   }
@@ -2005,7 +2009,7 @@ async function startMcpServer() {
   server.registerTool(
     "get_page_schema",
     {
-      description: "Return the AI-first output schema for generating Suda page content, including all section schemas. Field schemas include dynamic visibility metadata for Suda visibleIf fields. If the theme has a contact section, generate only the section placement/content props; public form fields and delivery integrations are project contact form settings exposed to themes as metadata.contactForm. Use get_contact_form_settings and update_contact_form_settings for user-approved contact form changes.",
+      description: "Return the schema for configuring existing Suda theme sections as page content. Use only the returned section types, fields, defaultProps, and slot allowedComponents; never create theme source code or new component types. If the theme has a contact section, generate only the section placement/content props; public form fields and delivery integrations are project contact form settings exposed to themes as metadata.contactForm. Use get_contact_form_settings and update_contact_form_settings for user-approved contact form changes.",
       inputSchema: {
         theme: z.string(),
         version: z.string().optional(),
@@ -2017,16 +2021,16 @@ async function startMcpServer() {
     },
     async ({ theme, version, projectId, themeRoot, includeExample }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId, themeRoot });
-      const structuredContent = createAgentPageSchemaOutput(manifest, {
+      const structuredContent = createSudaPageAgentRuntime(manifest).getPageSchemaOutput({
         includeExample: includeExample === true
       });
-      return mcpStructured("AI-first Suda page content output schema.", structuredContent);
+      return mcpStructured("Suda page content configuration schema.", structuredContent);
     }
   );
   server.registerTool(
     "get_section_schema",
     {
-      description: "Return the AI-first output schema for one section component in a theme. Field schemas include dynamic visibility metadata for Suda visibleIf fields. For contact sections, use the schema for presentation props only and do not hardcode form field metadata, notification channels, webhook URLs, or recipients into page content. Use contact form tools for project-level contact settings.",
+      description: "Return the schema for configuring one existing section in a theme. Use the returned fields, defaultProps, and slot allowedComponents to set props; do not design or add theme components. For contact sections, use the schema for presentation props only and do not hardcode form field metadata, notification channels, webhook URLs, or recipients into page content. Use contact form tools for project-level contact settings.",
       inputSchema: {
         theme: z.string(),
         section: z.string(),
@@ -2039,13 +2043,13 @@ async function startMcpServer() {
     async ({ theme, section, version, projectId, themeRoot }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId, themeRoot });
       const structuredContent = createSectionSchema(manifest, section);
-      return mcpStructured("AI-first Suda section output schema.", structuredContent);
+      return mcpStructured("Suda section configuration schema.", structuredContent);
     }
   );
   server.registerTool(
     "validate_page_config",
     {
-      description: "Validate AI-generated Suda page content against a theme.",
+      description: "Validate Suda page content JSON against an existing theme schema.",
       inputSchema: {
         theme: z.string(),
         data: z.unknown(),
@@ -2058,7 +2062,7 @@ async function startMcpServer() {
     async ({ theme, data, version, projectId, themeRoot }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId, themeRoot });
       const structuredContent = agentValidationResultSchema.parse(
-        validateAgentPageContentWithManifest(data, manifest)
+        createSudaPageAgentRuntime(manifest).validatePageContent(data)
       );
       return mcpStructured("Suda page content validation result.", structuredContent);
     }
@@ -2108,7 +2112,7 @@ async function startMcpServer() {
   server.registerTool(
     "create_page_draft",
     {
-      description: "Create a new workspace page draft from AI-generated Suda page content. When creating a complete website, mark exactly one primary landing page with isHome: true so it becomes the public homepage at `/`. After this tool succeeds, tell the user the page is only a draft, explain that they can review it in the SudaCloud workspace by navigating to Pages, opening the created page, previewing it, then clicking Publish, and ask whether they want you to publish it now. Do not call publish_page until the user explicitly confirms.",
+      description: "Create a new workspace page draft from Suda page content JSON that configures existing theme sections. When creating a complete website, mark exactly one primary landing page with isHome: true so it becomes the public homepage at `/`. After this tool succeeds, tell the user the page is only a draft, explain that they can review it in the SudaCloud workspace by navigating to Pages, opening the created page, previewing it, then clicking Publish, and ask whether they want you to publish it now. Do not call publish_page until the user explicitly confirms.",
       inputSchema: {
         projectId: z.string(),
         title: z.string(),
@@ -2122,14 +2126,14 @@ async function startMcpServer() {
     },
     async ({ projectId, title, slug, isHome, theme, data, version }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId });
-      const validation = validateAgentPageContentWithManifest(data, manifest);
-      if (!validation.valid) {
+      const prepared = createSudaPageAgentRuntime(manifest).preparePageData(data);
+      if (!prepared.validation.valid) {
         return mcpStructured(
           "Suda page content validation failed. Fix issues before creating a draft.",
           createPageDraftOutputSchema.parse({
             status: "invalid",
             valid: false,
-            issues: validation.issues
+            issues: prepared.validation.issues
           })
         );
       }
@@ -2152,7 +2156,7 @@ async function startMcpServer() {
   server.registerTool(
     "update_page_draft",
     {
-      description: "Update an existing workspace page draft by slug from AI-generated Suda page content.",
+      description: "Update an existing workspace page draft by slug from Suda page content JSON that configures existing theme sections.",
       inputSchema: {
         projectId: z.string(),
         slug: z.string(),
@@ -2164,14 +2168,14 @@ async function startMcpServer() {
     },
     async ({ projectId, slug, theme, data, version }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId });
-      const validation = validateAgentPageContentWithManifest(data, manifest);
-      if (!validation.valid) {
+      const prepared = createSudaPageAgentRuntime(manifest).preparePageData(data);
+      if (!prepared.validation.valid) {
         return mcpStructured(
           "Suda page content validation failed. Fix issues before updating a draft.",
           updatePageDraftOutputSchema.parse({
             status: "invalid",
             valid: false,
-            issues: validation.issues
+            issues: prepared.validation.issues
           })
         );
       }
@@ -2282,6 +2286,11 @@ async function writeThemeArtifacts(theme) {
   await writeFile(
     path2.join(dist, "starter-pages.json"),
     `${JSON.stringify(theme.module.starterPages, null, 2)}
+`
+  );
+  await writeFile(
+    path2.join(dist, "cms-templates.json"),
+    `${JSON.stringify(theme.module.cmsTemplates, null, 2)}
 `
   );
   await writeFile(
@@ -2800,20 +2809,24 @@ function buildProgram() {
     printJson({ themes });
   });
   const agentTheme = agent.command("theme").description("Inspect a single theme.");
-  agentTheme.command("describe").description("Describe a theme's AI-first page schema.").argument("<theme>", "Theme key.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").option("--example", "Include example page content.").action(async (themeKey, options) => {
+  agentTheme.command("describe").description("Describe a theme's page content configuration schema.").argument("<theme>", "Theme key.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").option("--example", "Include example page content.").action(async (themeKey, options) => {
     const manifest = await fetchAgentManifest(themeKey, options);
     printJson(
-      createAgentPageSchemaOutput(manifest, { includeExample: options.example === true })
+      createSudaPageAgentRuntime(manifest).getPageSchemaOutput({
+        includeExample: options.example === true
+      })
     );
   });
-  const agentPage = agent.command("page").description("AI-first page content tooling.");
-  agentPage.command("schema").description("Print the AI-first page content output schema for a theme.").argument("<theme>", "Theme key.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").option("--example", "Include example page content.").action(async (themeKey, options) => {
+  const agentPage = agent.command("page").description("Page content configuration tooling.");
+  agentPage.command("schema").description("Print the page content configuration schema for a theme.").argument("<theme>", "Theme key.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").option("--example", "Include example page content.").action(async (themeKey, options) => {
     const manifest = await fetchAgentManifest(themeKey, options);
     printJson(
-      createAgentPageSchemaOutput(manifest, { includeExample: options.example === true })
+      createSudaPageAgentRuntime(manifest).getPageSchemaOutput({
+        includeExample: options.example === true
+      })
     );
   });
-  agentPage.command("validate").description("Validate an AI-generated Suda page content JSON document.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--input <file>", "JSON file containing Suda page content.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").action(async (options) => {
+  agentPage.command("validate").description("Validate a Suda page content JSON document.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--input <file>", "JSON file containing Suda page content.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").action(async (options) => {
     await validateAgentPage(options.theme, options.input, options);
   });
   agentPage.command("create").description(
@@ -2822,7 +2835,7 @@ function buildProgram() {
     await createAgentPage(options);
   });
   const agentSection = agent.command("section").description("Inspect a single section.");
-  agentSection.command("schema").description("Print one AI-first section output schema for a theme.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--section <section>", "Section type.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").action(async (options) => {
+  agentSection.command("schema").description("Print one section configuration schema for a theme.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--section <section>", "Section type.").option("--version <version>", "Theme version.").option("--project-id <projectId>", "Project scope.").option("--theme-root <path>", "Read a local theme.").action(async (options) => {
     const manifest = await fetchAgentManifest(options.theme, options);
     printJson(createSectionSchema(manifest, options.section));
   });