@primeuicom/mcp 0.1.13 → 0.1.15

package/dist/service.js

@@ -138,15 +138,45 @@ var pageSchema = z2.object({
   "PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root."
 );
 var exportStatusSchema = z2.enum(["in_progress", "completed", "failed"]).describe(
-  "Export lifecycle state. Use 'completed' before calling primeui_download_export."
+  "Export lifecycle state. Use 'completed' before calling download_export."
 );
 var exportItemSchema = z2.object({
   id: z2.string().describe(
-    "Export identifier. Pass this value to primeui_download_export input.id."
+    "Export identifier. Pass this value to download_export input.id."
   ),
   status: exportStatusSchema,
   createdAt: z2.string().describe("Export creation timestamp in ISO-8601 UTC format.")
 }).describe("Single export record from PrimeUI export history.");
+var exportSummarySchema = z2.object({
+  total: z2.number().describe("Total pages processed in this export run."),
+  successful: z2.number().describe("Number of pages exported successfully."),
+  failed: z2.number().describe("Number of pages that failed export.")
+});
+var exportComponentSchema = z2.object({
+  componentKey: z2.string().describe("Global component key from export manifest."),
+  enabled: z2.boolean().describe("True when this global component was exported."),
+  files: z2.array(z2.string()).describe("Files associated with this global component."),
+  message: z2.string().describe("Export status message for this global component.")
+});
+var exportPageManifestSchema = z2.object({
+  success: z2.boolean().describe("True when page export succeeded in this export run."),
+  message: z2.string().describe("Export status message for this page."),
+  files: z2.array(z2.string()).describe(
+    "Authoritative list of page-related files from PrimeUI export manifest, including shared project files required by this page."
+  )
+});
+var exportPageSchema = z2.object({
+  id: z2.string().describe("Stable PrimeUI page identifier for this export entry."),
+  title: z2.string().optional().describe(
+    "Optional page title from export manifest. Can be undefined for some legacy records."
+  ),
+  slug: z2.string().describe("PrimeUI page slug included in this export."),
+  pageType: z2.string().describe("PrimeUI page type for routing/path resolution."),
+  isReadyToExport: z2.literal(true).describe("Always true for pages included in export payload."),
+  pagePath: z2.string().describe("Page source file path relative to export root."),
+  componentsPath: z2.string().describe("Page components directory path relative to export root."),
+  manifest: exportPageManifestSchema
+});
 var fileTransferSchema = z2.object({
   sourcePath: z2.string().describe("Relative source file path inside downloaded export root."),
   targetPath: z2.string().describe("Relative target file path inside user project root.")
@@ -215,14 +245,14 @@ var TRIGGER_PHRASES = [
 ].join(", ");
 var WORKFLOW_SUMMARY = `
 WORKFLOW ORDER (always follow this sequence):
-1. primeui_get_project_info -> discover PrimeUI pages
-2. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user
-3. primeui_inspect_page -> inspect selected page components and produce a structured comparison table
-4. primeui_create_export -> generate export snapshot for agreed pages/analysis scope
-5. primeui_download_export -> download to temp directory
-6. primeui_copy_page -> copy one page safely (repeat for each selected page)
-7. Reconcile integration points and resolve reported conflicts, if any
-8. primeui_clear_temp -> cleanup temp files
+1. clear_temp -> cleanup stale temp files from previous runs before starting new import flow
+2. get_project_info -> discover PrimeUI pages
+3. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user
+4. inspect_page -> inspect selected page components and produce a structured comparison table
+5. create_export -> generate export snapshot and local manifest with page file lists + global components
+6. download_export -> download to temp directory
+7. copy_page -> copy one page safely (repeat for each selected page)
+8. Reconcile integration points and resolve reported conflicts, if any
 `.trim();
 var initialInstructions = `
 PrimeUI MCP enables importing pages from PrimeUI Studio into your local project.
@@ -233,25 +263,31 @@ ${WORKFLOW_SUMMARY}
 
 CRITICAL RULES FOR PAGE IMPORT:
 - Import is PAGE-BY-PAGE only. Never import the entire project at once.
-- After primeui_get_project_info, always compare PrimeUI pages against the user's existing local project pages before proposing imports.
+- Always call clear_temp at the very beginning of a new import flow to avoid stale export state.
+- After get_project_info, always compare PrimeUI pages against the user's existing local project pages before proposing imports.
 - Reconciliation report MUST include: page presence match, slug/pagePath/componentsPath path match, and proposed action per page.
 - Decision matrix:
   - PrimeUI + local page exists -> candidate for update/review.
   - PrimeUI exists, local missing -> import candidate.
   - Local exists, PrimeUI missing -> custom local page, no action unless user asks.
   - Both exist but path mismatch -> ambiguous, export + compare before deciding.
-- For targeted component-level analysis on a specific page, call primeui_inspect_page before export/copy.
-- After primeui_inspect_page returns report table, supplement that table with local project page state:
+- For targeted component-level analysis on a specific page, call inspect_page before export/copy.
+- After inspect_page returns report table, supplement that table with local project page state:
   mark what already exists, what is missing, and what differs.
 - Before creating export, ask user which pages to add/update (specific pages or all missing pages) and keep that choice in thread context.
+- create_export response includes:
+  - page-level manifest files per page ('pages[].manifest.files'),
+  - global components list ('export.components').
+  Mention both to user after create_export, because this is the source of truth for copy decisions.
 - The downloaded export in .primeui/temp/ contains a full standalone Next.js project.
   Do NOT copy it wholesale.
-- Always call primeui_copy_page for each confirmed page instead of manual file copy.
-- primeui_copy_page performs safe copy only:
+- Always call copy_page for each confirmed page instead of manual file copy.
+- copy_page performs safe copy only:
   - new files are copied,
   - identical files are reported,
   - conflicting files are NEVER overwritten and are returned with diff.
-- primeui_copy_page may add only missing dependencies to user's package.json.
+- copy_page reads and validates files only from 'pages[].manifest.files' in local sidecar manifest.
+- copy_page may add only missing dependencies to user's package.json.
   It never upgrades existing dependency versions and never runs dependency installation.
 - After page copy operations, inspect integration points (navigation configs, link menus, route registries, page indexes).
 - If integration pattern is obvious, apply it and explicitly mark it in the report with "\u26A0 integration update".
@@ -274,7 +310,7 @@ AFTER CALLING:
 - If any requested page is not found or not ready, report this immediately and ask for replacement page choices.
 - Ask the user which pages to add or update now (specific page list or all missing pages) and keep this decision in thread context.
 - Import works per page. Multiple pages are allowed, but each page transfer is handled explicitly.
-- Only after user decision is clear, proceed to primeui_create_export.
+- Only after user decision is clear, proceed to create_export.
 
 ${WORKFLOW_SUMMARY}`,
   inputSchema: {},
@@ -304,7 +340,7 @@ var toolInspectPage = {
   description: `Targeted inspection tool for one PrimeUI page. Returns page details, active variant (if present), raw components payload, and a formatted report table.
 
 WHEN TO USE:
-- Call this after primeui_get_project_info when user wants component-level analysis for a specific page.
+- Call this after get_project_info when user wants component-level analysis for a specific page.
 - Use this before export/copy when user asks to compare or selectively update page sections.
 
 AFTER CALLING:
@@ -346,16 +382,16 @@ ${WORKFLOW_SUMMARY}`,
 };
 var toolListExports = {
   title: "PrimeUI Export List",
-  description: `Auxiliary tool to list previously created exports with their IDs, statuses, and creation dates. This is NOT the starting point for page import - start with primeui_get_project_info instead.
+  description: `Auxiliary tool to list previously created exports with their IDs, statuses, and creation dates. This is NOT the starting point for page import - start with get_project_info instead.
 
 WHEN TO USE: This is an OPTIONAL helper tool, NOT part of the main import flow. Use it only when:
 - Something went wrong with an export and you need to check its status.
 - The user explicitly references a previous export by date or context.
 - You need to verify whether an export initiated via PrimeUI Studio UI has completed.
 
-Note: exports can be created both through primeui_create_export AND by the user directly in PrimeUI Studio UI. This tool shows all of them.
+Note: exports can be created both through create_export AND by the user directly in PrimeUI Studio UI. This tool shows all of them.
 
-Do NOT use this tool as a substitute for primeui_create_export. Always create a fresh export unless the user explicitly asks to use a previous one.
+Do NOT use this tool as a substitute for create_export. Always create a fresh export unless the user explicitly asks to use a previous one.
 
 ${WORKFLOW_SUMMARY}`,
   inputSchema: {},
@@ -373,27 +409,39 @@ ${WORKFLOW_SUMMARY}`,
 };
 var toolCreateExport = {
   title: "PrimeUI Create Export",
-  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns export ID and the list of pages included in the export.
+  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns strict export manifest payload from API, including page-level file manifests and global components.
 
-WHEN TO USE: Call this AFTER the user has confirmed which pages they want to import via primeui_get_project_info. This tool is REQUIRED before primeui_download_export, unless the user explicitly and directly asked to download a specific previous export.
+WHEN TO USE: Call this AFTER the user has confirmed which pages they want to import via get_project_info. This tool is REQUIRED before download_export, unless the user explicitly and directly asked to download a specific previous export.
 
 AFTER CALLING:
 - Verify that all user-selected pages are present in the export result AND have isReadyToExport: true.
 - If path mismatch pages were flagged during project-info reconciliation, ensure they are included for deeper comparison after download.
 - If any required page is missing or not ready, report and pause for user decision before proceeding.
-- Use the returned export ID to call primeui_download_export.
+- Mention that global components are available in export.components and can be transferred separately if needed.
+- Local sidecar manifest is saved to .primeui/temp/exports/[exportId].manifest.json from this API payload.
+- Use the returned export ID to call download_export.
 
 ${WORKFLOW_SUMMARY}`,
   inputSchema: {},
   outputSchema: {
     export: z2.object({
       id: z2.string().describe(
-        "Freshly created export identifier. Use this as primeui_download_export input.id."
+        "Freshly created export identifier. Use this as download_export input.id."
       ),
-      status: exportStatusSchema
+      status: exportStatusSchema,
+      createdAt: z2.string().describe("Export creation timestamp in ISO-8601 UTC format."),
+      expiresAt: z2.string().nullable().describe(
+        "Export expiration timestamp in ISO-8601 UTC format, or null when export has no explicit expiration."
+      ),
+      summary: exportSummarySchema.describe(
+        "Export run summary with total/successful/failed counters."
+      ),
+      components: z2.array(exportComponentSchema).describe(
+        "Global component export manifest. These components are independent from page-level manifests."
+      )
     }).describe("Created export summary."),
-    pages: z2.array(pageSchema).describe(
-      "Page snapshot associated with this export operation. Validate requested pages here before download/import."
+    pages: z2.array(exportPageSchema).describe(
+      "Strict page payload associated with this export, including per-page manifest files list."
     )
   },
   annotations: {
@@ -407,26 +455,26 @@ var toolDownloadExport = {
   title: "PrimeUI Download Export",
   description: `Download a completed export into .primeui/temp/exports/[exportId]. Downloads and extracts the full export as a standalone Next.js project into the temp directory. This does NOT modify the user's project - files land only in .primeui/temp/.
 
-Do NOT call this as the first step. Requires export ID from primeui_create_export. Start with primeui_get_project_info instead.
+Do NOT call this as the first step. Requires export ID from create_export. Start with get_project_info instead.
 
-WHEN TO USE: Call this AFTER primeui_create_export has returned a completed export. Requires export ID from primeui_create_export so MCP can use the matching local pages snapshot for sidecar manifest generation.
+WHEN TO USE: Call this AFTER create_export has returned a completed export. Requires export ID from create_export so MCP can use the matching local sidecar manifest.
 
 NOTE:
-- Download of an export ID without local pages snapshot may fail.
+- Download of an export ID without local sidecar manifest will fail.
 - For previous exports, create a fresh export first when possible.
 
 AFTER DOWNLOAD:
-- Use manifestPath from this response as the contract for page slug/path mapping in copy operations.
-- For each selected page, call primeui_copy_page with:
+- Use manifestPath from this response as the contract for page slug/path mapping and manifest file lists in copy operations.
+- For each selected page, call copy_page with:
   - originPageSlug (required),
   - actualPageSlug (optional, if route remap is needed).
 - If there are unresolved conflicts in copy report, stop and ask the user.
-- Only after all requested pages are copied and reconciled, call primeui_clear_temp.
+- Do not force cleanup at flow end; keep downloaded export files available for validation and follow-up checks.
 
   ${WORKFLOW_SUMMARY}`,
   inputSchema: {
     id: z2.string().describe(
-      "Export identifier to download. Prefer export.id from primeui_create_export; use primeui_list_exports only on explicit user request."
+      "Export identifier to download. Prefer export.id from create_export; use list_exports only on explicit user request."
     )
   },
   outputSchema: {
@@ -437,10 +485,10 @@ AFTER DOWNLOAD:
       "Absolute local path to extracted export root in .primeui/temp/exports/[exportId]. Read files from here only."
     ),
     manifestPath: z2.string().describe(
-      "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json). primeui_copy_page depends on this file."
+      "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json) saved by create_export and required by copy_page."
     ),
-    pages: z2.array(pageSchema).describe(
-      "Page descriptors for import decisions. Use pagePath/componentsPath from each item when copying code into user project."
+    pages: z2.array(exportPageSchema).describe(
+      "Page descriptors loaded from local sidecar export manifest for import decisions."
     )
   },
   annotations: {
@@ -455,13 +503,13 @@ var toolCopyPage = {
   description: `Safely copy one page from downloaded export into the user's local project. Works only with local files in .primeui/temp/exports and does NOT call PrimeUI API.
 
 WHEN TO USE:
-- Call this AFTER primeui_download_export.
+- Call this AFTER download_export.
 - Call once per selected page.
 - Use actualPageSlug only when user wants to remap route during import.
 
 BEHAVIOR:
 - Reads export sidecar manifest to resolve originPageSlug -> pagePath/componentsPath.
-- Copies page file + full page components folder + recursively discovered internal dependencies.
+- Copies and validates files strictly from pages[].manifest.files for the selected page.
 - Never overwrites existing conflicting files.
 - Reports:
   a) copied new files,
@@ -506,7 +554,9 @@ ${WORKFLOW_SUMMARY}`,
       "Dependencies with version mismatch between export and user project. Report only."
     ),
     summary: z2.object({
-      totalCandidateFiles: z2.number().describe("Total number of candidate files considered for page copy."),
+      totalCandidateFiles: z2.number().describe(
+        "Total number of candidate files considered for page copy from pages[].manifest.files."
+      ),
       copiedFiles: z2.number().describe("Number of files copied as new."),
       identicalFiles: z2.number().describe("Number of files detected as identical."),
       conflictFiles: z2.number().describe("Number of conflicting files not copied."),
@@ -525,9 +575,9 @@ var toolClearTemp = {
   title: "PrimeUI Clear Temp",
   description: `Delete all files in .primeui/temp/ and recreate empty temp structure.
 
-Do NOT call this unless ALL requested pages have been successfully imported into the user's project.
+Call this at the START of a new import flow, before get_project_info/create_export, to reset stale temp state from previous runs.
 
-WHEN TO USE: Call this as the FINAL step after ALL requested pages have been successfully imported into the user's project. Do not call this between page imports - wait until all pages are done.
+WHEN TO USE: Call once at the beginning of each new import flow. Do not call this between page imports in the same flow.
 
 Safe to call multiple times. Only affects .primeui/temp/ directory - never touches the user's project files.
 
@@ -571,79 +621,79 @@ function createPrimeUiMcpServer(source) {
     }
   );
   server.registerTool(
-    "primeui_get_project_info",
+    "get_project_info",
     toolGetProjectInfo,
     async () => {
       try {
         const info = await source.getProjectInfo();
-        return okResult("primeui_get_project_info", info);
+        return okResult("get_project_info", info);
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_inspect_page",
+    "inspect_page",
     toolInspectPage,
     async ({ pageSlug }) => {
       try {
         const result = await source.inspectPage(pageSlug);
-        return okResult("primeui_inspect_page", result);
+        return okResult("inspect_page", result);
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_list_exports",
+    "list_exports",
     toolListExports,
     async () => {
       try {
         const exportsList = await source.listExports();
-        return okResult("primeui_list_exports", { exports: exportsList });
+        return okResult("list_exports", { exports: exportsList });
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_create_export",
+    "create_export",
     toolCreateExport,
     async () => {
       try {
         const result = await source.createExport();
-        return okResult("primeui_create_export", result);
+        return okResult("create_export", result);
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_download_export",
+    "download_export",
     toolDownloadExport,
     async ({ id }) => {
       try {
         const result = await source.downloadExportById(id);
-        return okResult("primeui_download_export", result);
+        return okResult("download_export", result);
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_clear_temp",
+    "clear_temp",
     toolClearTemp,
     async () => {
       try {
         await source.clearTemp();
-        return okResult("primeui_clear_temp", { success: true });
+        return okResult("clear_temp", { success: true });
       } catch (error) {
         return errorResult(error);
       }
     }
   );
   server.registerTool(
-    "primeui_copy_page",
+    "copy_page",
     toolCopyPage,
     async ({ originPageSlug, actualPageSlug }) => {
       try {
@@ -651,7 +701,7 @@ function createPrimeUiMcpServer(source) {
           originPageSlug,
           actualPageSlug
         );
-        return okResult("primeui_copy_page", result);
+        return okResult("copy_page", result);
       } catch (error) {
         return errorResult(error);
       }
@@ -837,6 +887,7 @@ function shouldParseFile(filePath) {
   return PARSEABLE_EXTENSIONS.has(path3.extname(filePath).toLowerCase());
 }
 async function buildImportGraph(input) {
+  const shouldFollowInternalImports = input.followInternalImports ?? true;
   const projectRoot = path3.resolve(input.projectRoot);
   const queue = input.entryFiles.map((filePath) => path3.resolve(filePath));
   const visited = /* @__PURE__ */ new Set();
@@ -866,7 +917,7 @@ async function buildImportGraph(input) {
         specifier
       );
       if (resolved.kind === "internal") {
-        if (!visited.has(resolved.filePath)) {
+        if (shouldFollowInternalImports && !visited.has(resolved.filePath)) {
           queue.push(resolved.filePath);
         }
         continue;
@@ -1180,65 +1231,107 @@ async function fileExists2(filePath) {
     return false;
   }
 }
-function isPageRecord(value) {
+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;
-  return typeof maybe.id === "string" && typeof maybe.title === "string" && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && typeof maybe.isReadyToExport === "boolean" && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string";
+  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;
-  if (maybe.schemaVersion !== 1 || typeof maybe.generatedAt !== "string" || typeof maybe.exportId !== "string" || typeof maybe.projectPath !== "string" || !Array.isArray(maybe.pages)) {
+  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(isPageRecord)) {
+  if (!maybe.pages.every(isExportPageRecord)) {
     throw new Error("Export manifest pages payload is invalid.");
   }
   return {
-    schemaVersion: 1,
-    generatedAt: maybe.generatedAt,
-    exportId: maybe.exportId,
-    projectPath: maybe.projectPath,
+    export: {
+      id: exportObject.id,
+      status,
+      createdAt: exportObject.createdAt,
+      expiresAt: exportObject.expiresAt,
+      summary,
+      components
+    },
     pages: maybe.pages
   };
 }
-async function listFilesRecursively(dirPath) {
-  const files = [];
-  const stack = [dirPath];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (!current) {
-      continue;
+async function resolveManifestCandidateFiles(input) {
+  const result = /* @__PURE__ */ new Set();
+  for (const rawPath of input.files) {
+    const trimmed = rawPath.trim();
+    if (!trimmed) {
+      throw new Error(
+        `Export manifest for page "${input.pageSlug}" contains an empty file path.`
+      );
     }
-    const entries = await readdir(current, { withFileTypes: true });
-    for (const entry of entries) {
-      const absolutePath = path4.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(absolutePath);
-        continue;
-      }
-      if (entry.isFile()) {
-        files.push(absolutePath);
-      }
+    const normalizedRelative = toPosixPath(trimmed).replace(/^\.\/+/, "");
+    const absolutePath = path4.resolve(input.exportPath, normalizedRelative);
+    const relative = path4.relative(input.exportPath, absolutePath);
+    if (relative.startsWith("..") || path4.isAbsolute(relative)) {
+      throw new Error(
+        `Export manifest for page "${input.pageSlug}" contains path outside export root: ${trimmed}`
+      );
     }
+    const stats = await stat3(absolutePath).catch(() => null);
+    if (!stats?.isFile()) {
+      throw new Error(
+        `Export manifest file is missing for page "${input.pageSlug}": ${normalizedRelative}`
+      );
+    }
+    result.add(absolutePath);
   }
-  return files;
+  return [...result].sort((a, b) => a.localeCompare(b));
 }
 async function resolveSingleExportDirectory(exportsRoot) {
   const entries = await readdir(exportsRoot, { withFileTypes: true });
   const exportDirectories = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort((a, b) => a.localeCompare(b));
   if (exportDirectories.length === 0) {
     throw new Error(
-      "No downloaded exports found in .primeui/temp/exports. Run primeui_download_export first."
+      "No downloaded exports found in .primeui/temp/exports. Run download_export first."
     );
   }
   if (exportDirectories.length > 1) {
     throw new Error(
-      "Multiple export folders found in .primeui/temp/exports. Clear temp with primeui_clear_temp and download one export."
+      "Multiple export folders found in .primeui/temp/exports. Clear temp with clear_temp and download one export."
     );
   }
   const exportId = exportDirectories[0] ?? "";
@@ -1336,13 +1429,13 @@ async function copyPageFromExport(input) {
   );
   if (!await fileExists2(manifestPath)) {
     throw new Error(
-      `Export manifest is missing at ${manifestPath}. Run primeui_download_export to regenerate it.`
+      `Export manifest is missing at ${manifestPath}. Run create_export and download_export to regenerate it.`
     );
   }
   const manifest = parseManifest(await readJsonFile(manifestPath));
-  if (manifest.exportId !== exportId) {
+  if (manifest.export.id !== exportId) {
     throw new Error(
-      `Manifest exportId mismatch: expected ${exportId}, got ${manifest.exportId}. Re-download export.`
+      `Manifest export id mismatch: expected ${exportId}, got ${manifest.export.id}. Re-run create_export and download_export.`
     );
   }
   const page = manifest.pages.find(
@@ -1382,15 +1475,16 @@ async function copyPageFromExport(input) {
   const importRewritePlan = isSlugRemapped ? buildImportRewritePlan(page.componentsPath, targetPaths.componentsPath) : null;
   ensureSafeTargetPath(input.projectRoot, targetPagePath);
   ensureSafeTargetPath(input.projectRoot, targetComponentsPath);
-  const componentFiles = await listFilesRecursively(sourceComponentsPath);
-  const seedFiles = [sourcePagePath, ...componentFiles];
-  const importGraph = await buildImportGraph({
+  const candidateFiles = await resolveManifestCandidateFiles({
+    exportPath,
+    pageSlug: normalizedOriginSlug,
+    files: page.manifest.files
+  });
+  const dependencyGraph = await buildImportGraph({
     projectRoot: exportPath,
-    entryFiles: seedFiles
+    entryFiles: candidateFiles,
+    followInternalImports: false
   });
-  const candidateFiles = [...new Set(importGraph.internalFiles)].sort(
-    (a, b) => a.localeCompare(b)
-  );
   const newFiles = [];
   const identicalFiles = [];
   const conflictFiles = [];
@@ -1463,7 +1557,7 @@ async function copyPageFromExport(input) {
   const userPackageJson = await readJsonFile(userPackageJsonPath);
   const addedDependencies = [];
   const dependenciesVersionConflicts = [];
-  for (const packageName of importGraph.externalPackages) {
+  for (const packageName of dependencyGraph.externalPackages) {
     const exportDependency = getDependencyVersion(
       exportPackageJson,
       packageName
@@ -1623,31 +1717,69 @@ function buildInspectPageReport(input) {
 }
 
 // src/services/project-sync-service.ts
-function isProjectPage(value) {
+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.id === "string" && typeof maybe.title === "string" && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && typeof maybe.isReadyToExport === "boolean" && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string";
+  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
 }
-function buildPagesSnapshotPath(exportsRoot, exportId) {
-  return path5.join(exportsRoot, `${exportId}.pages.snapshot.json`);
+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 parsePagesSnapshot(value) {
+function buildManifestPath(exportsRoot, exportId) {
+  return path5.join(exportsRoot, `${exportId}.manifest.json`);
+}
+function parseExportManifest(value) {
   if (!value || typeof value !== "object") {
-    throw new Error("Export pages snapshot is invalid.");
+    throw new Error("Export manifest is invalid.");
   }
   const maybe = value;
-  if (maybe.schemaVersion !== 1 || typeof maybe.generatedAt !== "string" || typeof maybe.exportId !== "string" || !Array.isArray(maybe.pages)) {
-    throw new Error("Export pages snapshot does not match expected schema.");
+  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(isProjectPage)) {
-    throw new Error("Export pages snapshot has invalid pages payload.");
+  if (!maybe.pages.every(isExportPage)) {
+    throw new Error("Export manifest pages payload is invalid.");
   }
   return {
-    schemaVersion: 1,
-    generatedAt: maybe.generatedAt,
-    exportId: maybe.exportId,
+    export: {
+      id: exportObject.id,
+      status,
+      createdAt: exportObject.createdAt,
+      expiresAt: exportObject.expiresAt,
+      summary,
+      components
+    },
     pages: maybe.pages
   };
 }
@@ -1677,21 +1809,9 @@ var ProjectSyncService = class {
   async createExport() {
     await this.ensureTempLayout();
     const result = await this.provider.createExport();
-    const pagesSnapshotPath = buildPagesSnapshotPath(
-      this.exportsRoot,
-      result.export.id
-    );
-    const snapshot = {
-      schemaVersion: 1,
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      exportId: result.export.id,
-      pages: result.pages
-    };
-    await writeUtf8(
-      pagesSnapshotPath,
-      `${JSON.stringify(snapshot, null, 2)}
-`
-    );
+    const manifestPath = buildManifestPath(this.exportsRoot, result.export.id);
+    await writeUtf8(manifestPath, `${JSON.stringify(result, null, 2)}
+`);
     return result;
   }
   async downloadExportById(id) {
@@ -1703,39 +1823,28 @@ var ProjectSyncService = class {
     }
     const targetZipPath = path5.join(this.exportsRoot, `${id}.zip`);
     const targetProjectPath = path5.join(this.exportsRoot, id);
-    await ensureDir(this.exportsRoot);
-    await this.provider.downloadExportArchive(id, targetZipPath);
-    await resetDir(targetProjectPath);
-    await extractZip(targetZipPath, targetProjectPath);
-    const pagesSnapshotPath = buildPagesSnapshotPath(this.exportsRoot, id);
-    let pagesSnapshot;
+    const manifestPath = buildManifestPath(this.exportsRoot, id);
+    let manifest;
     try {
-      const snapshotRaw = JSON.parse(
-        await readFile4(pagesSnapshotPath, "utf-8")
+      manifest = parseExportManifest(
+        JSON.parse(await readFile4(manifestPath, "utf-8"))
       );
-      pagesSnapshot = parsePagesSnapshot(snapshotRaw);
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       throw new Error(
-        `Export pages snapshot is required for download id "${id}". Run primeui_create_export for this export before downloading. Details: ${reason}`
+        `Export manifest is required for download id "${id}". Run create_export for this export before downloading. Details: ${reason}`
       );
     }
-    if (pagesSnapshot.exportId !== id) {
+    if (manifest.export.id !== id) {
       throw new Error(
-        `Export pages snapshot mismatch for id "${id}". Run primeui_create_export and retry download.`
+        `Export manifest mismatch for id "${id}". Run create_export and retry download.`
       );
     }
-    const pages = pagesSnapshot.pages;
-    const manifestPath = path5.join(this.exportsRoot, `${id}.manifest.json`);
-    const manifest = {
-      schemaVersion: 1,
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      exportId: id,
-      projectPath: targetProjectPath,
-      pages
-    };
-    await writeUtf8(manifestPath, `${JSON.stringify(manifest, null, 2)}
-`);
+    await ensureDir(this.exportsRoot);
+    await this.provider.downloadExportArchive(id, targetZipPath);
+    await resetDir(targetProjectPath);
+    await extractZip(targetZipPath, targetProjectPath);
+    const pages = manifest.pages;
     return {
       exportId: id,
       projectPath: targetProjectPath,
@@ -1764,14 +1873,12 @@ var ProjectSyncService = class {
   }
   async clearTemp() {
     await resetDir(this.tempRoot);
-    await writeUtf8(path5.join(this.tempRoot, ".gitkeep"), "");
     await ensureDir(this.exportsRoot);
   }
   async ensureTempLayout() {
     await ensureDir(this.primeUiRoot);
     await ensureDir(this.tempRoot);
     await ensureDir(this.exportsRoot);
-    await writeUtf8(path5.join(this.tempRoot, ".gitkeep"), "");
   }
 };
 
@@ -1799,6 +1906,32 @@ var projectPageObjectSchema = z3.object({
   componentsPath: z3.string()
 });
 var projectPageSchema = projectPageObjectSchema;
+var exportSummarySchema2 = z3.object({
+  total: z3.number(),
+  successful: z3.number(),
+  failed: z3.number()
+});
+var exportedComponentSchema = z3.object({
+  componentKey: z3.string(),
+  enabled: z3.boolean(),
+  files: z3.array(z3.string()),
+  message: z3.string()
+});
+var exportPageManifestSchema2 = z3.object({
+  success: z3.boolean(),
+  message: z3.string(),
+  files: z3.array(z3.string())
+});
+var exportPageSchema2 = z3.object({
+  id: z3.string(),
+  title: z3.string().optional(),
+  slug: z3.string(),
+  pageType: z3.string(),
+  isReadyToExport: z3.literal(true),
+  pagePath: z3.string(),
+  componentsPath: z3.string(),
+  manifest: exportPageManifestSchema2
+});
 var projectInfoSchema = z3.object({
   projectId: z3.string(),
   projectName: z3.string(),
@@ -1834,9 +1967,13 @@ var exportsResponseSchema = z3.object({
 var createExportResponseSchema = z3.object({
   export: z3.object({
     id: z3.string(),
-    status: exportStatusSchema2
+    status: exportStatusSchema2,
+    createdAt: z3.string().datetime({ offset: true }),
+    expiresAt: z3.string().datetime({ offset: true }).nullable(),
+    summary: exportSummarySchema2,
+    components: z3.array(exportedComponentSchema)
   }),
-  pages: z3.array(projectPageSchema)
+  pages: z3.array(exportPageSchema2)
 });
 var PrimeUiApiContractError = class extends Error {
   constructor(endpoint, details) {