@sudajs/cli 0.8.0 → 0.8.2

package/dist/index.d.ts

@@ -139,6 +139,7 @@ declare function createRemotePageDraft(auth: CliAuthContext, input: {
     projectId: string;
     title: string;
     slug: string;
+    isHome?: boolean | undefined;
     themeKey: string;
     themeVersion: string;
     data: unknown;

package/dist/index.js

@@ -1405,34 +1405,38 @@ async function createAgentPage(options) {
     return;
   }
   const auth = await requireCliBaseUrl();
-  const response = await createRemotePageDraft(
-    auth,
-    {
-      projectId: options.projectId,
-      title: options.title,
-      slug: options.slug,
-      themeKey: manifest.manifest.key,
-      themeVersion: manifest.manifest.version,
-      data: pageContent
-    },
-    fetchJson
-  );
+  const request = {
+    projectId: options.projectId,
+    title: options.title,
+    slug: options.slug,
+    themeKey: manifest.manifest.key,
+    themeVersion: manifest.manifest.version,
+    data: pageContent
+  };
+  if (options.home === true) {
+    request.isHome = true;
+  }
+  const response = await createRemotePageDraft(auth, request, fetchJson);
   printJson({ success: true, ...response });
 }
 async function createRemotePageDraft(auth, input, fetcher = fetchJson) {
+  const body = {
+    title: input.title,
+    slug: input.slug,
+    themeKey: input.themeKey,
+    themeVersion: input.themeVersion,
+    data: input.data
+  };
+  if (input.isHome !== void 0) {
+    body.isHome = input.isHome;
+  }
   return fetcher(
     `${auth.baseUrl}/api/cli/agent/projects/${encodeURIComponent(input.projectId)}/pages`,
     {
       method: "POST",
       token: auth.token,
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        title: input.title,
-        slug: input.slug,
-        themeKey: input.themeKey,
-        themeVersion: input.themeVersion,
-        data: input.data
-      })
+      body: JSON.stringify(body)
     }
   );
 }
@@ -1701,18 +1705,19 @@ async function startMcpServer() {
   server.registerTool(
     "create_page_draft",
     {
-      description: "Create a new workspace page draft from AI-generated Suda page content.",
+      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.",
       inputSchema: {
         projectId: z.string(),
         title: z.string(),
         slug: z.string(),
+        isHome: z.boolean().optional().describe("Set true for exactly one page that should serve as the public homepage at `/`."),
         theme: z.string(),
         data: z.unknown(),
         version: z.string().optional()
       },
       outputSchema: createPageDraftOutputSchema
     },
-    async ({ projectId, title, slug, theme, data, version }) => {
+    async ({ projectId, title, slug, isHome, theme, data, version }) => {
       const manifest = await fetchAgentManifest(theme, { version, projectId });
       const validation = validateAgentPageContentWithManifest(data, manifest);
       if (!validation.valid) {
@@ -1730,12 +1735,13 @@ async function startMcpServer() {
         projectId,
         title,
         slug,
+        isHome,
         themeKey: manifest.manifest.key,
         themeVersion: manifest.manifest.version,
         data
       });
       return mcpStructured(
-        "Created Suda page draft.",
+        "Created Suda page draft. Tell the user they can review it in the SudaCloud workspace under Pages by opening the created page, previewing it, then clicking Publish. Ask whether they want you to publish it now before calling publish_page.",
         createPageDraftOutputSchema.parse({ status: "created", ...response })
       );
     }
@@ -1810,7 +1816,7 @@ async function startMcpServer() {
   server.registerTool(
     "publish_page",
     {
-      description: "Publish the current saved draft for a Suda page by slug. This affects the public site: first call without confirm to get the exact project, slug, and impact; only call again with confirm: true after the user explicitly agrees.",
+      description: "Publish the current saved draft for a Suda page by slug. This affects the public site: first call without confirm to get the exact project, slug, and impact; only call again with confirm: true after the user explicitly agrees. If the user wants to review manually first, tell them to open the SudaCloud workspace, navigate to Pages, open the created page, preview it, then click Publish.",
       inputSchema: {
         projectId: z.string(),
         slug: z.string(),
@@ -2386,7 +2392,9 @@ function buildProgram() {
   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) => {
     await validateAgentPage(options.theme, options.input, options);
   });
-  agentPage.command("create").description("Create a workspace page draft from AI-generated Suda page content JSON.").requiredOption("--project-id <projectId>", "Project id.").requiredOption("--title <title>", "Page title.").requiredOption("--slug <slug>", "Page slug.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--input <file>", "JSON file containing Suda page content.").option("--version <version>", "Theme version.").action(async (options) => {
+  agentPage.command("create").description(
+    "Create a workspace page draft from AI-generated Suda page content JSON. Review it in Pages, then preview and publish from the workspace."
+  ).requiredOption("--project-id <projectId>", "Project id.").requiredOption("--title <title>", "Page title.").requiredOption("--slug <slug>", "Page slug.").requiredOption("--theme <theme>", "Theme key.").requiredOption("--input <file>", "JSON file containing Suda page content.").option("--version <version>", "Theme version.").option("--home", "Mark this page draft as the project's homepage.").action(async (options) => {
     await createAgentPage(options);
   });
   const agentSection = agent.command("section").description("Inspect a single section.");