@primeuicom/mcp 0.1.26 → 0.1.28

package/dist/service.js

@@ -485,42 +485,13 @@ import { unlink } from "fs/promises";
 import path5 from "path";
 import { Readable, Transform } from "stream";
 import { pipeline } from "stream/promises";
-import { z as z3 } from "zod";
 
-// src/lib/fs.ts
-import { mkdir, rm, writeFile } from "fs/promises";
-import path4 from "path";
-import extractZipArchive from "extract-zip";
-async function ensureDir(dirPath) {
-  await mkdir(dirPath, { recursive: true });
-}
-async function resetDir(dirPath) {
-  await rm(dirPath, { recursive: true, force: true });
-  await mkdir(dirPath, { recursive: true });
-}
-async function writeUtf8(filePath, content) {
-  await ensureDir(path4.dirname(filePath));
-  await writeFile(filePath, content, "utf-8");
-}
-async function extractZip(zipPath, targetDir) {
-  await ensureDir(targetDir);
-  try {
-    await extractZipArchive(zipPath, { dir: targetDir });
-  } catch (error) {
-    const details = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to extract zip at "${zipPath}". ${details}`);
-  }
-}
-
-// src/sources/api-provider.ts
-var DEFAULT_API_BASE_URL = "https://app.primeui.com/";
-var ZIP_CONTENT_TYPES = [
-  "application/zip",
-  "application/octet-stream",
-  "application/x-zip-compressed"
-];
-var exportStatusSchema = z3.enum(["in_progress", "completed", "failed"]);
-var projectPageObjectSchema = z3.object({
+// src/lib/api-v1-contract.ts
+import { z as z3 } from "zod";
+var primeUiExportStatusSchema = z3.enum(
+  ["in_progress", "completed", "failed"]
+);
+var primeUiProjectPageObjectSchema = z3.object({
   id: z3.string(),
   title: z3.string(),
   slug: z3.string(),
@@ -529,24 +500,29 @@ var projectPageObjectSchema = z3.object({
   pagePath: z3.string(),
   componentsPath: z3.string()
 });
-var projectPageSchema = projectPageObjectSchema;
-var exportSummarySchema = z3.object({
+var primeUiProjectPageSchema = primeUiProjectPageObjectSchema;
+var primeUiProjectGlobalComponentSchema = z3.object({
+  componentKey: z3.string(),
+  description: z3.string(),
+  isReadyToExport: z3.boolean()
+});
+var primeUiExportSummarySchema = z3.object({
   total: z3.number(),
   successful: z3.number(),
   failed: z3.number()
 });
-var exportedComponentSchema = z3.object({
+var primeUiExportedComponentSchema = z3.object({
   componentKey: z3.string(),
-  enabled: z3.boolean(),
+  isReadyToExport: z3.boolean(),
   files: z3.array(z3.string()),
   message: z3.string()
 });
-var exportPageManifestSchema = z3.object({
+var primeUiExportPageManifestSchema = z3.object({
   success: z3.boolean(),
   message: z3.string(),
   files: z3.array(z3.string())
 });
-var exportPageSchema = z3.object({
+var primeUiExportPageSchema = z3.object({
   id: z3.string(),
   title: z3.string().optional(),
   slug: z3.string(),
@@ -554,51 +530,107 @@ var exportPageSchema = z3.object({
   isReadyToExport: z3.literal(true),
   pagePath: z3.string(),
   componentsPath: z3.string(),
-  manifest: exportPageManifestSchema
-});
-var projectInfoSchema = z3.object({
-  projectId: z3.string(),
-  projectName: z3.string(),
-  metadata: z3.record(z3.unknown()),
-  pages: z3.array(projectPageSchema)
+  manifest: primeUiExportPageManifestSchema
 });
-var projectPageComponentSchema = z3.object({
+var primeUiProjectInfoSchema = z3.object(
+  {
+    projectId: z3.string(),
+    projectName: z3.string(),
+    metadata: z3.record(z3.unknown()),
+    components: z3.array(primeUiProjectGlobalComponentSchema),
+    pages: z3.array(primeUiProjectPageSchema)
+  }
+);
+var primeUiProjectPageComponentSchema = z3.object({
   blockId: z3.string(),
   componentId: z3.string(),
   componentGroup: z3.string(),
   slot: z3.string().nullable(),
   props: z3.record(z3.unknown()).nullable()
 });
-var projectPageDetailsSchema = z3.object({
-  page: projectPageObjectSchema.extend({
+var primeUiProjectPageDetailsSchema = z3.object({
+  page: primeUiProjectPageObjectSchema.extend({
     pageInstruction: z3.string().nullable()
   }),
   variant: z3.object({
     id: z3.string(),
     name: z3.string()
   }).nullable(),
-  components: z3.array(projectPageComponentSchema).nullable()
+  components: z3.array(primeUiProjectPageComponentSchema).nullable()
 });
-var exportsResponseSchema = z3.object({
+var primeUiExportsResponseSchema = z3.object({
   exports: z3.array(
     z3.object({
       id: z3.string(),
-      status: exportStatusSchema,
+      status: primeUiExportStatusSchema,
       createdAt: z3.string().datetime({ offset: true })
     })
   )
 });
-var createExportResponseSchema = z3.object({
+var primeUiCreateExportResponseSchema = z3.object({
   export: z3.object({
     id: z3.string(),
-    status: exportStatusSchema,
+    status: primeUiExportStatusSchema,
     createdAt: z3.string().datetime({ offset: true }),
     expiresAt: z3.string().datetime({ offset: true }).nullable(),
-    summary: exportSummarySchema,
-    components: z3.array(exportedComponentSchema)
+    summary: primeUiExportSummarySchema,
+    components: z3.array(primeUiExportedComponentSchema)
   }),
-  pages: z3.array(exportPageSchema)
+  pages: z3.array(primeUiExportPageSchema)
 });
+var primeUiExportManifestSchema = primeUiCreateExportResponseSchema;
+function parsePrimeUiExportManifest(value) {
+  if (!value || typeof value !== "object") {
+    throw new Error("Export manifest is invalid.");
+  }
+  const maybe = value;
+  if (!maybe.export || typeof maybe.export !== "object") {
+    throw new Error("Export manifest export payload is invalid.");
+  }
+  const parsed = primeUiExportManifestSchema.safeParse(value);
+  if (!parsed.success) {
+    const hasPageIssue = parsed.error.issues.some(
+      (issue) => issue.path[0] === "pages"
+    );
+    throw new Error(
+      hasPageIssue ? "Export manifest pages payload is invalid." : "Export manifest does not match expected schema."
+    );
+  }
+  return parsed.data;
+}
+
+// src/lib/fs.ts
+import { mkdir, rm, writeFile } from "fs/promises";
+import path4 from "path";
+import extractZipArchive from "extract-zip";
+async function ensureDir(dirPath) {
+  await mkdir(dirPath, { recursive: true });
+}
+async function resetDir(dirPath) {
+  await rm(dirPath, { recursive: true, force: true });
+  await mkdir(dirPath, { recursive: true });
+}
+async function writeUtf8(filePath, content) {
+  await ensureDir(path4.dirname(filePath));
+  await writeFile(filePath, content, "utf-8");
+}
+async function extractZip(zipPath, targetDir) {
+  await ensureDir(targetDir);
+  try {
+    await extractZipArchive(zipPath, { dir: targetDir });
+  } catch (error) {
+    const details = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to extract zip at "${zipPath}". ${details}`);
+  }
+}
+
+// src/sources/api-provider.ts
+var DEFAULT_API_BASE_URL = "https://app.primeui.com/";
+var ZIP_CONTENT_TYPES = [
+  "application/zip",
+  "application/octet-stream",
+  "application/x-zip-compressed"
+];
 var PrimeUiApiContractError = class extends Error {
   constructor(endpoint, details) {
     super(`PrimeUI API contract mismatch for "${endpoint}": ${details}`);
@@ -683,26 +715,30 @@ var ApiProjectDataProvider = class {
     this.apiRoot = normalizePrimeUiApiRoot(options.baseUrl);
   }
   async getProjectInfo() {
-    return this.requestJson("project", projectInfoSchema);
+    return this.requestJson("project", primeUiProjectInfoSchema);
   }
   async getProjectPageBySlug(slug) {
     const encodedSlug = encodeURIComponent(slug);
     return this.requestJson(
       `project/page?slug=${encodedSlug}`,
-      projectPageDetailsSchema
+      primeUiProjectPageDetailsSchema
     );
   }
   async listExports() {
     const response = await this.requestJson(
       "project/exports",
-      exportsResponseSchema
+      primeUiExportsResponseSchema
     );
     return response.exports;
   }
   async createExport() {
-    return this.requestJson("project/exports", createExportResponseSchema, {
-      method: "POST"
-    });
+    return this.requestJson(
+      "project/exports",
+      primeUiCreateExportResponseSchema,
+      {
+        method: "POST"
+      }
+    );
   }
   /**
    * Consumer-side runtime contract for GET /api/v1/project/exports/:exportId/download.
@@ -2000,68 +2036,15 @@ async function fileExists2(filePath) {
     return false;
   }
 }
-function isExportPageManifestRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
-}
-function isExportStatus(value) {
-  return value === "in_progress" || value === "completed" || value === "failed";
-}
-function isExportSummaryRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
-}
-function isExportedComponentRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
-}
-function isExportPageRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  const title = maybe.title;
-  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifestRecord(maybe.manifest);
-}
 function parseManifest(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("Invalid export manifest format.");
-  }
-  const maybe = value;
-  const exportPayload = maybe.export;
-  if (!exportPayload || typeof exportPayload !== "object") {
-    throw new Error("Export manifest export payload is invalid.");
-  }
-  const exportObject = exportPayload;
-  const status = exportObject.status;
-  const summary = exportObject.summary;
-  const components = exportObject.components;
-  if (typeof exportObject.id !== "string" || !isExportStatus(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummaryRecord(summary) || !Array.isArray(components) || !components.every(isExportedComponentRecord) || !Array.isArray(maybe.pages)) {
-    throw new Error("Export manifest does not match expected schema.");
-  }
-  if (!maybe.pages.every(isExportPageRecord)) {
-    throw new Error("Export manifest pages payload is invalid.");
+  try {
+    return parsePrimeUiExportManifest(value);
+  } catch (error) {
+    if (error instanceof Error && error.message === "Export manifest is invalid.") {
+      throw new Error("Invalid export manifest format.");
+    }
+    throw error;
   }
-  return {
-    export: {
-      id: exportObject.id,
-      status,
-      createdAt: exportObject.createdAt,
-      expiresAt: exportObject.expiresAt,
-      summary,
-      components
-    },
-    pages: maybe.pages
-  };
 }
 async function resolveManifestCandidateFiles(input) {
   const result = /* @__PURE__ */ new Set();
@@ -2486,72 +2469,9 @@ function buildInspectPageReport(input) {
 }
 
 // src/services/project-sync-service.ts
-function isExportStatus2(value) {
-  return value === "in_progress" || value === "completed" || value === "failed";
-}
-function isExportSummary(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
-}
-function isExportedComponent(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
-}
-function isExportPageManifest(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
-}
-function isExportPage(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  const title = maybe.title;
-  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifest(maybe.manifest);
-}
 function buildManifestPath(exportsRoot, exportId) {
   return path10.join(exportsRoot, `${exportId}.manifest.json`);
 }
-function parseExportManifest(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("Export manifest is invalid.");
-  }
-  const maybe = value;
-  const exportPayload = maybe.export;
-  if (!exportPayload || typeof exportPayload !== "object") {
-    throw new Error("Export manifest export payload is invalid.");
-  }
-  const exportObject = exportPayload;
-  const status = exportObject.status;
-  const summary = exportObject.summary;
-  const components = exportObject.components;
-  if (typeof exportObject.id !== "string" || !isExportStatus2(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummary(summary) || !Array.isArray(components) || !components.every(isExportedComponent) || !Array.isArray(maybe.pages)) {
-    throw new Error("Export manifest does not match expected schema.");
-  }
-  if (!maybe.pages.every(isExportPage)) {
-    throw new Error("Export manifest pages payload is invalid.");
-  }
-  return {
-    export: {
-      id: exportObject.id,
-      status,
-      createdAt: exportObject.createdAt,
-      expiresAt: exportObject.expiresAt,
-      summary,
-      components
-    },
-    pages: maybe.pages
-  };
-}
 var ProjectSyncService = class {
   provider;
   projectRoot;
@@ -2595,7 +2515,7 @@ var ProjectSyncService = class {
     const manifestPath = buildManifestPath(this.exportsRoot, id);
     let manifest;
     try {
-      manifest = parseExportManifest(
+      manifest = parsePrimeUiExportManifest(
         JSON.parse(await readFile4(manifestPath, "utf-8"))
       );
     } catch (error) {
@@ -2771,35 +2691,42 @@ var pageSchema = z4.object({
 }).describe(
   "PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root."
 );
-var exportStatusSchema2 = z4.enum(["in_progress", "completed", "failed"]).describe(
+var exportStatusSchema = z4.enum(["in_progress", "completed", "failed"]).describe(
   "Export lifecycle state. Use 'completed' before calling download_export."
 );
 var exportItemSchema = z4.object({
   id: z4.string().describe(
     "Export identifier. Pass this value to download_export input.id."
   ),
-  status: exportStatusSchema2,
+  status: exportStatusSchema,
   createdAt: z4.string().describe("Export creation timestamp in ISO-8601 UTC format.")
 }).describe("Single export record from PrimeUI export history.");
-var exportSummarySchema2 = z4.object({
+var exportSummarySchema = z4.object({
   total: z4.number().describe("Total pages processed in this export run."),
   successful: z4.number().describe("Number of pages exported successfully."),
   failed: z4.number().describe("Number of pages that failed export.")
 });
 var exportComponentSchema = z4.object({
   componentKey: z4.string().describe("Global component key from export manifest."),
-  enabled: z4.boolean().describe("True when this global component was exported."),
+  isReadyToExport: z4.boolean().describe("True when this global component was exported in this run."),
   files: z4.array(z4.string()).describe("Files associated with this global component."),
   message: z4.string().describe("Export status message for this global component.")
 });
-var exportPageManifestSchema2 = z4.object({
+var projectGlobalComponentSchema = z4.object({
+  componentKey: z4.string().describe("Stable global component key from PrimeUI project info."),
+  description: z4.string().describe("Human-readable explanation of what this global component does."),
+  isReadyToExport: z4.boolean().describe(
+    "True when this global component is currently configured to be included in export."
+  )
+});
+var exportPageManifestSchema = z4.object({
   success: z4.boolean().describe("True when page export succeeded in this export run."),
   message: z4.string().describe("Export status message for this page."),
   files: z4.array(z4.string()).describe(
     "Authoritative list of page-related files from PrimeUI export manifest, including shared project files required by this page."
   )
 });
-var exportPageSchema2 = z4.object({
+var exportPageSchema = z4.object({
   id: z4.string().describe("Stable PrimeUI page identifier for this export entry."),
   title: z4.string().optional().describe(
     "Optional page title from export manifest. Can be undefined for some legacy records."
@@ -2809,7 +2736,7 @@ var exportPageSchema2 = z4.object({
   isReadyToExport: z4.literal(true).describe("Always true for pages included in export payload."),
   pagePath: z4.string().describe("Page source file path relative to export root."),
   componentsPath: z4.string().describe("Page components directory path relative to export root."),
-  manifest: exportPageManifestSchema2
+  manifest: exportPageManifestSchema
 });
 var fileTransferSchema = z4.object({
   sourcePath: z4.string().describe("Relative source file path inside downloaded export root."),
@@ -2872,7 +2799,7 @@ var projectRootInputSchema = z4.string().optional().describe(
 );
 var optionalProjectRootInputObjectSchema = z4.object({
   projectRoot: projectRootInputSchema
-}).optional();
+}).describe("Optional tool input with project root override.");
 var TRIGGER_PHRASES = [
   "import page from PrimeUI",
   "add page from PrimeUI",
@@ -2964,6 +2891,9 @@ ${WORKFLOW_SUMMARY}`,
     metadata: z4.record(z4.unknown()).describe(
       "Additional project metadata from PrimeUI. May include project-description and other context fields."
     ),
+    components: z4.array(projectGlobalComponentSchema).describe(
+      "All global components visible for this project context. Use isReadyToExport to tell whether each component would be included in export right now."
+    ),
     pages: z4.array(pageSchema).describe(
       "All pages visible for this project context. Filter by user request and isReadyToExport before creating export."
     )
@@ -3069,19 +2999,19 @@ ${WORKFLOW_SUMMARY}`,
       id: z4.string().describe(
         "Freshly created export identifier. Use this as download_export input.id."
       ),
-      status: exportStatusSchema2,
+      status: exportStatusSchema,
       createdAt: z4.string().describe("Export creation timestamp in ISO-8601 UTC format."),
       expiresAt: z4.string().nullable().describe(
         "Export expiration timestamp in ISO-8601 UTC format, or null when export has no explicit expiration."
       ),
-      summary: exportSummarySchema2.describe(
+      summary: exportSummarySchema.describe(
         "Export run summary with total/successful/failed counters."
       ),
       components: z4.array(exportComponentSchema).describe(
         "Global component export manifest. These components are independent from page-level manifests."
       )
     }).describe("Created export summary."),
-    pages: z4.array(exportPageSchema2).describe(
+    pages: z4.array(exportPageSchema).describe(
       "Strict page payload associated with this export, including per-page manifest files list."
     )
   }),
@@ -3129,7 +3059,7 @@ AFTER DOWNLOAD:
     manifestPath: z4.string().describe(
       "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json) saved by create_export and required by copy_page."
     ),
-    pages: z4.array(exportPageSchema2).describe(
+    pages: z4.array(exportPageSchema).describe(
       "Page descriptors loaded from local sidecar export manifest for import decisions."
     )
   }),
@@ -3240,6 +3170,12 @@ ${WORKFLOW_SUMMARY}`,
 };
 
 // src/server.ts
+var ZERO_ARG_PROJECT_ROOT_TOOLS = /* @__PURE__ */ new Set([
+  "get_project_info",
+  "list_exports",
+  "create_export",
+  "clear_temp"
+]);
 function serializeToolData(data) {
   try {
     return JSON.stringify(data, null, 2);
@@ -3292,6 +3228,14 @@ function createPrimeUiMcpServer(source) {
       instructions: initialInstructions
     }
   );
+  const serverWithValidationShim = server;
+  const validateToolInput = serverWithValidationShim.validateToolInput.bind(server);
+  serverWithValidationShim.validateToolInput = async (tool, args, toolName) => {
+    if (args === void 0 && ZERO_ARG_PROJECT_ROOT_TOOLS.has(toolName)) {
+      return validateToolInput(tool, {}, toolName);
+    }
+    return validateToolInput(tool, args, toolName);
+  };
   server.registerTool(
     "get_project_info",
     toolGetProjectInfo,