@primeuicom/mcp 0.1.8 → 0.1.10

package/dist/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAElE,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;IAE1C,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC;QAC1C,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KAC1C,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,uGAAuG,CACxG,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAA;IAElD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAE/B,OAAO,CAAC,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAA;AACjE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAA;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"sources":["../src/service.ts","../src/server.ts","../src/instructions.ts","../src/services/project-sync-service.ts","../src/lib/fs.ts","../src/sources/api-provider.ts"],"sourcesContent":["import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\n\nimport { createPrimeUiMcpServer } from \"./server.js\";\nimport { ProjectSyncService } from \"./services/project-sync-service.js\";\nimport { ApiProjectDataProvider } from \"./sources/api-provider.js\";\n\nasync function main(): Promise<void> {\n  const projectRoot = process.env.PRIMEUI_PROJECT_ROOT || process.cwd();\n  const apiKey = process.env.PRIMEUI_API_KEY;\n\n  const provider = new ApiProjectDataProvider({\n    apiKey,\n    baseUrl: process.env.PRIMEUI_API_BASE_URL,\n  });\n\n  if (!apiKey) {\n    console.error(\n      \"[primeui-mcp] warning: PRIMEUI_API_KEY is not set; API-backed tools will fail until it is configured.\",\n    );\n  }\n\n  const syncService = new ProjectSyncService({ projectRoot, provider });\n  const server = createPrimeUiMcpServer(syncService);\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  console.error(`[primeui-mcp] running for root: ${projectRoot}`);\n}\n\nmain().catch((error) => {\n  console.error(\"[primeui-mcp] failed to start\", error);\n  process.exit(1);\n});\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport {\n  initialInstructions,\n  toolClearTemp,\n  toolCreateExport,\n  toolDownloadExport,\n  toolGetProjectInfo,\n  toolListExports,\n} from \"./instructions.js\";\nimport type { ProjectSyncSource } from \"./sources/project-sync-source.js\";\nimport type {\n  PrimeUiCreateExportResult,\n  PrimeUiDownloadResult,\n  PrimeUiExport,\n  PrimeUiProjectInfo,\n} from \"./types.js\";\n\nfunction okResult<T>(title: string, data: T): CallToolResult {\n  return {\n    content: [{ type: \"text\", text: `${title} completed` }],\n    structuredContent: data as Record<string, unknown>,\n  };\n}\n\nfunction errorResult(error: unknown): CallToolResult {\n  const message = error instanceof Error ? error.message : String(error);\n  return {\n    isError: true,\n    content: [{ type: \"text\", text: `primeui mcp error: ${message}` }],\n  };\n}\n\nexport function createPrimeUiMcpServer(source: ProjectSyncSource): McpServer {\n  const server = new McpServer(\n    {\n      name: \"primeui-mcp-server\",\n      version: \"0.1.0\",\n    },\n    {\n      instructions: initialInstructions,\n    },\n  );\n\n  server.registerTool(\n    \"primeui_get_project_info\",\n    toolGetProjectInfo,\n    async (): Promise<CallToolResult> => {\n      try {\n        const info: PrimeUiProjectInfo = await source.getProjectInfo();\n        return okResult(\"primeui_get_project_info\", info);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"primeui_list_exports\",\n    toolListExports,\n    async (): Promise<CallToolResult> => {\n      try {\n        const exportsList: PrimeUiExport[] = await source.listExports();\n        return okResult(\"primeui_list_exports\", { exports: exportsList });\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"primeui_create_export\",\n    toolCreateExport,\n    async (): Promise<CallToolResult> => {\n      try {\n        const result: PrimeUiCreateExportResult = await source.createExport();\n        return okResult(\"primeui_create_export\", result);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"primeui_download_export\",\n    toolDownloadExport,\n    async ({ id }): Promise<CallToolResult> => {\n      try {\n        const result: PrimeUiDownloadResult =\n          await source.downloadExportById(id);\n        return okResult(\"primeui_download_export\", result);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"primeui_clear_temp\",\n    toolClearTemp,\n    async (): Promise<CallToolResult> => {\n      try {\n        await source.clearTemp();\n        return okResult(\"primeui_clear_temp\", { success: true });\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  return server;\n}\n","import { z } from \"zod/v3\";\n\nconst pageSchema = z\n  .object({\n    id: z\n      .string()\n      .describe(\n        \"Stable PrimeUI page identifier. Use this to match the same page across tool responses.\",\n      ),\n    title: z\n      .string()\n      .describe(\n        \"Human-readable page title. Show this to the user when confirming which pages to import.\",\n      ),\n    slug: z\n      .string()\n      .describe(\n        \"PrimeUI route slug, for example '/', '/pricing', '/docs/getting-started'. Use to match user intent.\",\n      ),\n    pageType: z\n      .string()\n      .describe(\n        \"PrimeUI page type classification (for example landing, docs, pricing, blogIndex, legal).\",\n      ),\n    isReadyToExport: z\n      .boolean()\n      .describe(\n        \"True when this page has an active export-ready variant. Only ready pages are expected in export output.\",\n      ),\n    pagePath: z\n      .string()\n      .describe(\n        \"Relative file path to the page source inside downloaded export root. Copy page code from this exact path.\",\n      ),\n    componentsPath: z\n      .string()\n      .describe(\n        \"Relative directory path inside downloaded export root where page-level components live. Use as dependency copy start.\",\n      ),\n  })\n  .describe(\n    \"PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root.\",\n  );\n\nconst exportStatusSchema = z\n  .enum([\"in_progress\", \"completed\", \"failed\"])\n  .describe(\n    \"Export lifecycle state. Use 'completed' before calling primeui_download_export.\",\n  );\n\nconst exportItemSchema = z\n  .object({\n    id: z\n      .string()\n      .describe(\n        \"Export identifier. Pass this value to primeui_download_export input.id.\",\n      ),\n    status: exportStatusSchema,\n    createdAt: z\n      .string()\n      .describe(\"Export creation timestamp in ISO-8601 UTC format.\"),\n  })\n  .describe(\"Single export record from PrimeUI export history.\");\n\n// ============================================================\n// Shared constants\n// ============================================================\n\nconst TRIGGER_PHRASES = [\n  \"import page from PrimeUI\",\n  \"add page from PrimeUI\",\n  \"sync pages\",\n  \"pull page\",\n  \"transfer page\",\n  \"get page from PrimeUI\",\n  \"bring page from PrimeUI\",\n  \"export from PrimeUI\",\n].join(\", \");\n\nconst WORKFLOW_SUMMARY = `\nWORKFLOW ORDER (always follow this sequence):\n1. primeui_get_project_info -> discover PrimeUI pages\n2. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user\n3. primeui_create_export -> generate export snapshot for agreed pages/analysis scope\n4. primeui_download_export -> download to temp directory\n5. Reconcile downloaded export pages with local files, resolve ambiguities\n6. Move agreed page code + dependencies into user's project and apply integration updates where appropriate\n7. primeui_clear_temp -> cleanup temp files\n`.trim();\n\n// ============================================================\n// Server Instructions (initialInstructions)\n// ============================================================\n\nexport const initialInstructions = `\nPrimeUI MCP enables importing pages from PrimeUI Studio into your local project.\n\nTRIGGER EXAMPLES (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}\n\n${WORKFLOW_SUMMARY}\n\nCRITICAL RULES FOR PAGE IMPORT:\n- Import is PAGE-BY-PAGE only. Never import the entire project at once.\n- After primeui_get_project_info, always compare PrimeUI pages against the user's existing local project pages before proposing imports.\n- Reconciliation report MUST include: page presence match, slug/pagePath/componentsPath path match, and proposed action per page.\n- Decision matrix:\n  - PrimeUI + local page exists -> candidate for update/review.\n  - PrimeUI exists, local missing -> import candidate.\n  - Local exists, PrimeUI missing -> custom local page, no action unless user asks.\n  - Both exist but path mismatch -> ambiguous, export + compare before deciding.\n- Before creating export, ask user which pages to add/update (specific pages or all missing pages) and keep that choice in thread context.\n- The downloaded export in .primeui/temp/ contains a full standalone Next.js project.\n  Do NOT copy it wholesale.\n- Copy ONLY the target page file and its direct component dependencies.\n- Always use pagePath and componentsPath from tool responses as source of truth for file locations.\n- Trace each page's imports to identify which component folders are needed.\n- Check if components already exist in user's project - merge carefully, don't blindly overwrite.\n- Adjust import paths to match user's project structure.\n- After download/import work, inspect integration points (navigation configs, link menus, route registries, page indexes).\n- If integration pattern is obvious, apply it and explicitly mark it in the report with \"⚠ integration update\".\n- If integration pattern is unclear, ask the user before editing integration files.\n- Do NOT copy: package.json, next.config, tailwind.config, layout files, or any project-level config.\n- If merge conflicts arise and cannot be resolved unambiguously, STOP and ask the user to decide.\n`.trim();\n\n// ============================================================\n// Tool: primeui_get_project_info\n// ============================================================\n\nexport const toolGetProjectInfo = {\n  title: \"PrimeUI Project Info\",\n  description: `ENTRY POINT for all PrimeUI import operations. Always start here. Returns project metadata and the full list of available pages.\n\nWHEN TO USE: Call this FIRST when user wants to import, add, sync, pull, or transfer a page from PrimeUI. Intent examples (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}.\n\nAFTER CALLING:\n- Scan the user's local project to discover existing pages/routes and related page component folders.\n- Build a reconciliation report between PrimeUI and local project with action labels:\n  - Page exists in both PrimeUI and local project.\n  - Page exists in PrimeUI but not in local project -> import candidate.\n  - Page exists in local project but not in PrimeUI -> custom local page, no action by default.\n  - Page exists in both but slug/pagePath/componentsPath mapping does not match -> ambiguous, requires export-based comparison before decision.\n- If user already requested specific pages, first verify those pages exist in PrimeUI and are isReadyToExport: true.\n- If any requested page is not found or not ready, report this immediately and ask for replacement page choices.\n- Ask the user which pages to add or update now (specific page list or all missing pages) and keep this decision in thread context.\n- Import works per page. Multiple pages are allowed, but each page transfer is handled explicitly.\n- Only after user decision is clear, proceed to primeui_create_export.\n\n${WORKFLOW_SUMMARY}`,\n  inputSchema: {},\n  outputSchema: {\n    projectId: z\n      .string()\n      .describe(\n        \"PrimeUI project identifier associated with the API key and current import session context.\",\n      ),\n    projectName: z\n      .string()\n      .describe(\n        \"Human-readable PrimeUI project name for confirmations in chat.\",\n      ),\n    metadata: z\n      .record(z.unknown())\n      .describe(\n        \"Additional project metadata from PrimeUI. May include project-description and other context fields.\",\n      ),\n    pages: z\n      .array(pageSchema)\n      .describe(\n        \"All pages visible for this project context. Filter by user request and isReadyToExport before creating export.\",\n      ),\n  },\n  annotations: {\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: true,\n  },\n};\n\n// ============================================================\n// Tool: primeui_list_exports\n// ============================================================\n\nexport const toolListExports = {\n  title: \"PrimeUI Export List\",\n  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.\n\nWHEN TO USE: This is an OPTIONAL helper tool, NOT part of the main import flow. Use it only when:\n- Something went wrong with an export and you need to check its status.\n- The user explicitly references a previous export by date or context.\n- You need to verify whether an export initiated via PrimeUI Studio UI has completed.\n\nNote: exports can be created both through primeui_create_export AND by the user directly in PrimeUI Studio UI. This tool shows all of them.\n\nDo 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.\n\n${WORKFLOW_SUMMARY}`,\n  inputSchema: {},\n  outputSchema: {\n    exports: z\n      .array(exportItemSchema)\n      .describe(\n        \"Available exports sorted by API policy. Use item.id to download a specific prior export if user asks.\",\n      ),\n  },\n  annotations: {\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: true,\n  },\n};\n\n// ============================================================\n// Tool: primeui_create_export\n// ============================================================\n\nexport const toolCreateExport = {\n  title: \"PrimeUI Create Export\",\n  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.\n\nWHEN 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.\n\nAFTER CALLING:\n- Verify that all user-selected pages are present in the export result AND have isReadyToExport: true.\n- If path mismatch pages were flagged during project-info reconciliation, ensure they are included for deeper comparison after download.\n- If any required page is missing or not ready, report and pause for user decision before proceeding.\n- Use the returned export ID to call primeui_download_export.\n\n${WORKFLOW_SUMMARY}`,\n  inputSchema: {},\n  outputSchema: {\n    export: z\n      .object({\n        id: z\n          .string()\n          .describe(\n            \"Freshly created export identifier. Use this as primeui_download_export input.id.\",\n          ),\n        status: exportStatusSchema,\n      })\n      .describe(\"Created export summary.\"),\n    pages: z\n      .array(pageSchema)\n      .describe(\n        \"Page snapshot associated with this export operation. Validate requested pages here before download/import.\",\n      ),\n  },\n  annotations: {\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint: true,\n  },\n};\n\n// ============================================================\n// Tool: primeui_download_export\n// ============================================================\n\nexport const toolDownloadExport = {\n  title: \"PrimeUI Download Export\",\n  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/.\n\nDo NOT call this as the first step. Requires export ID from primeui_create_export. Start with primeui_get_project_info instead.\n\nWHEN TO USE: Call this AFTER primeui_create_export has returned a completed export. Requires the export ID returned by primeui_create_export (or from primeui_list_exports if the user explicitly requested a previous export).\n\nAFTER DOWNLOAD:\n- Reconcile downloaded export pages with the current local project state again.\n- If thread context already defines which pages to add/update and there is no ambiguity, complete the transfer without extra confirmation.\n- If ambiguity remains (especially page/path mismatches), analyze differences in detail and ask direct clarification questions before editing.\n- The response includes pagePath and componentsPath fields. Use these as direct pointers to locate page code and dependencies in export files.\n\nMANUAL IMPORT STEPS per page (do not skip):\n1. Read the page file at the pagePath from the response.\n2. Read the component files at the componentsPath from the response. Trace the page's imports to identify which specific component folders are needed.\n3. Copy ONLY the page file and its component dependencies into the user's project.\n4. Adjust all import paths to match the user's project structure.\n5. Check for existing components in user's project:\n   - If code overlaps or was modified on the user's side, carefully determine the nature of changes on both sides.\n   - If the merge conflict can be resolved unambiguously - resolve it.\n   - If NOT - STOP, explain the conflict to the user, and ask for their decision before continuing.\n6. Inspect integration points used by existing pages (navigation configs, route registries, link components, page indexes).\n7. If integration pattern is obvious and consistent with project conventions, apply integration updates and mark them in the report as \"⚠ integration update\".\n8. If integration pattern is not obvious, provide concrete integration suggestions and ask user confirmation before changing integration files.\n9. Do NOT copy project config files (package.json, next.config, tailwind.config, layout, etc.).\n10. REPEAT steps 1-9 for each page the user wants to import.\n11. Report exactly which files/areas were changed and which items require user follow-up.\n12. Only after ALL pages are successfully imported, call primeui_clear_temp to clean up.\n\n  ${WORKFLOW_SUMMARY}`,\n  inputSchema: {\n    id: z\n      .string()\n      .describe(\n        \"Export identifier to download. Prefer export.id from primeui_create_export; use primeui_list_exports only on explicit user request.\",\n      ),\n  },\n  outputSchema: {\n    exportId: z\n      .string()\n      .describe(\n        \"Downloaded export identifier. Should match the requested input.id for traceability.\",\n      ),\n    projectPath: z\n      .string()\n      .describe(\n        \"Absolute local path to extracted export root in .primeui/temp/exports/[exportId]. Read files from here only.\",\n      ),\n    pages: z\n      .array(pageSchema)\n      .describe(\n        \"Page descriptors for import decisions. Use pagePath/componentsPath from each item when copying code into user project.\",\n      ),\n  },\n  annotations: {\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: true,\n  },\n};\n\n// ============================================================\n// Tool: primeui_clear_temp\n// ============================================================\n\nexport const toolClearTemp = {\n  title: \"PrimeUI Clear Temp\",\n  description: `Delete all files in .primeui/temp/ and recreate empty temp structure.\n\nDo NOT call this unless ALL requested pages have been successfully imported into the user's project.\n\nWHEN 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.\n\nSafe to call multiple times. Only affects .primeui/temp/ directory - never touches the user's project files.\n\n${WORKFLOW_SUMMARY}`,\n  inputSchema: {},\n  outputSchema: {\n    success: z\n      .boolean()\n      .describe(\n        \"True when temp cleanup completed and baseline temp structure was recreated.\",\n      ),\n  },\n  annotations: {\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false,\n  },\n};\n","import path from \"node:path\";\n\nimport { ensureDir, extractZip, resetDir, writeUtf8 } from \"../lib/fs.js\";\nimport type { ProjectDataProvider } from \"../sources/project-data-provider.js\";\nimport type { ProjectSyncSource } from \"../sources/project-sync-source.js\";\nimport type {\n  PrimeUiCreateExportResult,\n  PrimeUiDownloadResult,\n  PrimeUiExport,\n  PrimeUiProjectInfo,\n} from \"../types.js\";\n\ntype ProjectSyncServiceOptions = {\n  projectRoot: string;\n  provider: ProjectDataProvider;\n};\n\nexport class ProjectSyncService implements ProjectSyncSource {\n  private readonly provider: ProjectDataProvider;\n  private readonly projectRoot: string;\n  private readonly primeUiRoot: string;\n  private readonly tempRoot: string;\n  private readonly exportsRoot: string;\n\n  constructor(options: ProjectSyncServiceOptions) {\n    this.projectRoot = options.projectRoot;\n    this.provider = options.provider;\n    this.primeUiRoot = path.join(this.projectRoot, \".primeui\");\n    this.tempRoot = path.join(this.primeUiRoot, \"temp\");\n    this.exportsRoot = path.join(this.tempRoot, \"exports\");\n  }\n\n  async getProjectInfo(): Promise<PrimeUiProjectInfo> {\n    await this.ensureTempLayout();\n    return this.provider.getProjectInfo();\n  }\n\n  async listExports(): Promise<PrimeUiExport[]> {\n    await this.ensureTempLayout();\n    return this.provider.listExports();\n  }\n\n  async createExport(): Promise<PrimeUiCreateExportResult> {\n    await this.ensureTempLayout();\n    return this.provider.createExport();\n  }\n\n  async downloadExportById(id: string): Promise<PrimeUiDownloadResult> {\n    await this.ensureTempLayout();\n\n    const exportsList = await this.provider.listExports();\n    const selected = exportsList.find((item) => item.id === id);\n\n    if (!selected) {\n      throw new Error(`Export not found: ${id}`);\n    }\n\n    const targetZipPath = path.join(this.exportsRoot, `${id}.zip`);\n    const targetProjectPath = path.join(this.exportsRoot, id);\n\n    await ensureDir(this.exportsRoot);\n    await this.provider.downloadExportArchive(id, targetZipPath);\n\n    await resetDir(targetProjectPath);\n    await extractZip(targetZipPath, targetProjectPath);\n    const { pages } = await this.provider.getProjectInfo();\n\n    return {\n      exportId: id,\n      projectPath: targetProjectPath,\n      pages,\n    };\n  }\n\n  async clearTemp(): Promise<void> {\n    await resetDir(this.tempRoot);\n    await writeUtf8(path.join(this.tempRoot, \".gitkeep\"), \"\");\n    await ensureDir(this.exportsRoot);\n  }\n\n  private async ensureTempLayout(): Promise<void> {\n    await ensureDir(this.primeUiRoot);\n    await ensureDir(this.tempRoot);\n    await ensureDir(this.exportsRoot);\n    await writeUtf8(path.join(this.tempRoot, \".gitkeep\"), \"\");\n  }\n}\n","import { mkdir, rm, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport extractZipArchive from \"extract-zip\";\n\nexport async function ensureDir(dirPath: string): Promise<void> {\n  await mkdir(dirPath, { recursive: true });\n}\n\nexport async function resetDir(dirPath: string): Promise<void> {\n  await rm(dirPath, { recursive: true, force: true });\n  await mkdir(dirPath, { recursive: true });\n}\n\nexport async function writeUtf8(\n  filePath: string,\n  content: string,\n): Promise<void> {\n  await ensureDir(path.dirname(filePath));\n  await writeFile(filePath, content, \"utf-8\");\n}\n\nexport async function extractZip(\n  zipPath: string,\n  targetDir: string,\n): Promise<void> {\n  await ensureDir(targetDir);\n\n  try {\n    await extractZipArchive(zipPath, { dir: targetDir });\n  } catch (error) {\n    const details = error instanceof Error ? error.message : String(error);\n    throw new Error(`Failed to extract zip at \"${zipPath}\". ${details}`);\n  }\n}\n","import { createWriteStream } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Readable, Transform } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as NodeReadableStream } from \"node:stream/web\";\nimport { z } from \"zod\";\n\nimport { ensureDir } from \"../lib/fs.js\";\nimport type {\n  PrimeUiCreateExportResult,\n  PrimeUiExport,\n  PrimeUiProjectInfo,\n  PrimeUiProjectPage,\n} from \"../types.js\";\nimport type { ProjectDataProvider } from \"./project-data-provider.js\";\n\ntype ApiProjectDataProviderOptions = {\n  apiKey?: string;\n  baseUrl?: string;\n};\n\nconst DEFAULT_API_BASE_URL = \"https://app.primeui.com/\";\nconst ZIP_CONTENT_TYPES = [\n  \"application/zip\",\n  \"application/octet-stream\",\n  \"application/x-zip-compressed\",\n];\nconst exportStatusSchema = z.enum([\"in_progress\", \"completed\", \"failed\"]);\nconst projectPageSchema: z.ZodType<PrimeUiProjectPage> = z.object({\n  id: z.string(),\n  title: z.string(),\n  slug: z.string(),\n  pageType: z.string(),\n  isReadyToExport: z.boolean(),\n  pagePath: z.string(),\n  componentsPath: z.string(),\n});\n\n/**\n * Consumer-side runtime contract for GET /api/v1/project.\n * Producer source of truth: apps/studio/src/app/api/v1/project/route.ts\n * Keep this schema synchronized with the producer payload.\n */\nconst projectInfoSchema: z.ZodType<PrimeUiProjectInfo> = z.object({\n  projectId: z.string(),\n  projectName: z.string(),\n  metadata: z.record(z.unknown()),\n  pages: z.array(projectPageSchema),\n});\n\n/**\n * Consumer-side runtime contract for GET /api/v1/project/exports.\n * Producer source of truth: apps/studio/src/app/api/v1/project/exports/route.ts\n * Keep this schema synchronized with the producer payload.\n */\nconst exportsResponseSchema = z.object({\n  exports: z.array(\n    z.object({\n      id: z.string(),\n      status: exportStatusSchema,\n      createdAt: z.string().datetime({ offset: true }),\n    }),\n  ),\n});\n\n/**\n * Consumer-side runtime contract for POST /api/v1/project/exports.\n * Producer source of truth: apps/studio/src/app/api/v1/project/exports/route.ts\n * Keep this schema synchronized with the producer payload.\n */\nconst createExportResponseSchema: z.ZodType<PrimeUiCreateExportResult> =\n  z.object({\n    export: z.object({\n      id: z.string(),\n      status: exportStatusSchema,\n    }),\n    pages: z.array(projectPageSchema),\n  });\n\nclass PrimeUiApiContractError extends Error {\n  constructor(endpoint: string, details: string) {\n    super(`PrimeUI API contract mismatch for \"${endpoint}\": ${details}`);\n    this.name = \"PrimeUiApiContractError\";\n  }\n}\n\nconst normalizeApiRoot = (rawBaseUrl: string): string => {\n  const normalizedBase = rawBaseUrl.trim() || DEFAULT_API_BASE_URL;\n  const parsed = new URL(normalizedBase);\n  const normalizedPath = parsed.pathname.replace(/\\/+$/, \"\");\n\n  if (normalizedPath.endsWith(\"/api/v1\")) {\n    parsed.pathname = `${normalizedPath}/`;\n    return parsed.toString();\n  }\n\n  parsed.pathname = `${normalizedPath}/api/v1/`.replace(\n    \"//api/v1/\",\n    \"/api/v1/\",\n  );\n  return parsed.toString();\n};\n\nconst isJsonContentType = (contentType: string): boolean =>\n  contentType.includes(\"application/json\") || contentType.includes(\"+json\");\n\nconst isZipContentType = (contentType: string): boolean =>\n  ZIP_CONTENT_TYPES.some((allowedType) => contentType.includes(allowedType));\n\nconst looksLikeZipArchive = (buffer: Buffer): boolean => {\n  if (buffer.length < 4) {\n    return false;\n  }\n\n  if (buffer[0] !== 0x50 || buffer[1] !== 0x4b) {\n    return false;\n  }\n\n  const signature = `${buffer[2]}:${buffer[3]}`;\n  return signature === \"3:4\" || signature === \"5:6\" || signature === \"7:8\";\n};\n\nconst createZipSignatureGuard = (endpoint: string): Transform => {\n  let signature = Buffer.alloc(0);\n  let validated = false;\n\n  return new Transform({\n    transform(chunk, _encoding, callback) {\n      const chunkBuffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\n      if (!validated) {\n        const requiredBytes = Math.max(0, 4 - signature.length);\n        if (requiredBytes > 0) {\n          signature = Buffer.concat([\n            signature,\n            chunkBuffer.subarray(0, requiredBytes),\n          ]);\n        }\n\n        if (signature.length >= 4) {\n          if (!looksLikeZipArchive(signature)) {\n            callback(\n              new PrimeUiApiContractError(\n                endpoint,\n                \"response body is not a valid zip archive\",\n              ),\n            );\n            return;\n          }\n\n          validated = true;\n        }\n      }\n\n      callback(null, chunkBuffer);\n    },\n    flush(callback) {\n      if (!validated) {\n        callback(\n          new PrimeUiApiContractError(\n            endpoint,\n            \"response body is not a valid zip archive\",\n          ),\n        );\n        return;\n      }\n\n      callback();\n    },\n  });\n};\n\nexport class ApiProjectDataProvider implements ProjectDataProvider {\n  private readonly apiKey?: string;\n  private readonly apiRoot: string;\n\n  constructor(options: ApiProjectDataProviderOptions) {\n    this.apiKey = options.apiKey;\n    this.apiRoot = normalizeApiRoot(options.baseUrl ?? DEFAULT_API_BASE_URL);\n  }\n\n  async getProjectInfo(): Promise<PrimeUiProjectInfo> {\n    return this.requestJson(\"project\", projectInfoSchema);\n  }\n\n  async listExports(): Promise<PrimeUiExport[]> {\n    const response = await this.requestJson(\n      \"project/exports\",\n      exportsResponseSchema,\n    );\n    return response.exports;\n  }\n\n  async createExport(): Promise<PrimeUiCreateExportResult> {\n    return this.requestJson(\"project/exports\", createExportResponseSchema, {\n      method: \"POST\",\n    });\n  }\n\n  /**\n   * Consumer-side runtime contract for GET /api/v1/project/exports/:exportId/download.\n   * Producer source of truth: apps/studio/src/app/api/v1/project/exports/[exportId]/download/route.ts\n   * Keep content-type and archive format checks synchronized with the producer response.\n   */\n  async downloadExportArchive(\n    exportId: string,\n    destinationPath: string,\n  ): Promise<void> {\n    const endpoint = `project/exports/${encodeURIComponent(exportId)}/download`;\n    const apiKey = this.requireApiKey();\n    const response = await fetch(this.buildUrl(endpoint), {\n      method: \"GET\",\n      headers: {\n        Authorization: `Bearer ${apiKey}`,\n      },\n    });\n\n    if (!response.ok) {\n      const details = await this.readError(response);\n      throw new Error(\n        `PrimeUI API request failed (${response.status}) while downloading export \"${exportId}\": ${details}`,\n      );\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (!isZipContentType(contentType)) {\n      throw new PrimeUiApiContractError(\n        endpoint,\n        `expected zip content-type but got \"${contentType || \"unknown\"}\"`,\n      );\n    }\n\n    if (!response.body) {\n      throw new PrimeUiApiContractError(endpoint, \"response body is empty\");\n    }\n\n    await ensureDir(path.dirname(destinationPath));\n\n    const zipStream = Readable.fromWeb(\n      response.body as unknown as NodeReadableStream,\n    );\n    const signatureGuard = createZipSignatureGuard(endpoint);\n    const fileStream = createWriteStream(destinationPath);\n\n    try {\n      await pipeline(zipStream, signatureGuard, fileStream);\n    } catch (error) {\n      await unlink(destinationPath).catch(() => undefined);\n      throw error;\n    }\n  }\n\n  private buildUrl(endpoint: string): string {\n    return new URL(endpoint, this.apiRoot).toString();\n  }\n\n  private async requestJson<T>(\n    endpoint: string,\n    schema: z.ZodType<T>,\n    requestInit: RequestInit = {},\n  ): Promise<T> {\n    const apiKey = this.requireApiKey();\n    const method = requestInit.method ?? \"GET\";\n    const response = await fetch(this.buildUrl(endpoint), {\n      ...requestInit,\n      method,\n      headers: {\n        ...(requestInit.headers ?? {}),\n        Authorization: `Bearer ${apiKey}`,\n      },\n    });\n\n    if (!response.ok) {\n      const details = await this.readError(response);\n      throw new Error(\n        `PrimeUI API request failed (${response.status}) for \"${endpoint}\": ${details}`,\n      );\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (!isJsonContentType(contentType)) {\n      throw new PrimeUiApiContractError(\n        endpoint,\n        `expected JSON content-type but got \"${contentType || \"unknown\"}\"`,\n      );\n    }\n\n    let payload: unknown;\n    try {\n      payload = await response.json();\n    } catch {\n      throw new PrimeUiApiContractError(\n        endpoint,\n        \"response body is not valid JSON\",\n      );\n    }\n\n    const parsed = schema.safeParse(payload);\n    if (!parsed.success) {\n      const details = parsed.error.issues\n        .map((issue) => `${issue.path.join(\".\") || \"<root>\"}: ${issue.message}`)\n        .join(\"; \");\n      throw new PrimeUiApiContractError(endpoint, details);\n    }\n\n    return parsed.data;\n  }\n\n  private async readError(response: Response): Promise<string> {\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n    try {\n      if (isJsonContentType(contentType)) {\n        const body = (await response.json()) as {\n          message?: string;\n          code?: string;\n        };\n        if (body?.message && body?.code) {\n          return `${body.code}: ${body.message}`;\n        }\n        if (body?.message) {\n          return body.message;\n        }\n      } else {\n        const bodyText = await response.text();\n        if (bodyText.trim()) {\n          return bodyText.trim();\n        }\n      }\n    } catch {\n      // No-op: fall through to generic status text.\n    }\n\n    return response.statusText || \"Unknown error\";\n  }\n\n  private requireApiKey(): string {\n    const apiKey = this.apiKey?.trim();\n    if (!apiKey) {\n      throw new Error(\"PRIMEUI_API_KEY is required to call PrimeUI API tools.\");\n    }\n\n    return apiKey;\n  }\n}\n"],"mappings":"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","names":["path","path","path","z","exportStatusSchema","z","path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primeuicom/mcp",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "MCP server that connects AI agents with PrimeUI project",
   "keywords": [
     "mcp",
@@ -38,7 +38,9 @@
   ],
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "pnpm run clean && tsc -p tsconfig.json && chmod 755 dist/service.js",
+    "build": "pnpm run clean && tsup --config tsup.config.ts && chmod 755 dist/service.js",
+    "format": "prettier --write ./src",
+    "format:check": "prettier --check ./src",
     "typecheck": "tsc --noEmit",
     "dev": "tsx src/service.ts",
     "test": "vitest run",
@@ -52,6 +54,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "tsup": "^8.5.0",
     "tsx": "^4.21.0",
     "typescript": "5.8.2",
     "vitest": "^3.2.3"

package/dist/instructions.d.ts

@@ -1,173 +0,0 @@
-import { z } from "zod/v3";
-export declare const initialInstructions: string;
-export declare const toolGetProjectInfo: {
-    title: string;
-    description: string;
-    inputSchema: {};
-    outputSchema: {
-        projectId: z.ZodString;
-        projectName: z.ZodString;
-        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        pages: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            slug: z.ZodString;
-            pageType: z.ZodString;
-            isReadyToExport: z.ZodBoolean;
-            pagePath: z.ZodString;
-            componentsPath: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }>, "many">;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-};
-export declare const toolListExports: {
-    title: string;
-    description: string;
-    inputSchema: {};
-    outputSchema: {
-        exports: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            status: z.ZodEnum<["in_progress", "completed", "failed"]>;
-            createdAt: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            status: "in_progress" | "completed" | "failed";
-            createdAt: string;
-        }, {
-            id: string;
-            status: "in_progress" | "completed" | "failed";
-            createdAt: string;
-        }>, "many">;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-};
-export declare const toolCreateExport: {
-    title: string;
-    description: string;
-    inputSchema: {};
-    outputSchema: {
-        export: z.ZodObject<{
-            id: z.ZodString;
-            status: z.ZodEnum<["in_progress", "completed", "failed"]>;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            status: "in_progress" | "completed" | "failed";
-        }, {
-            id: string;
-            status: "in_progress" | "completed" | "failed";
-        }>;
-        pages: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            slug: z.ZodString;
-            pageType: z.ZodString;
-            isReadyToExport: z.ZodBoolean;
-            pagePath: z.ZodString;
-            componentsPath: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }>, "many">;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-};
-export declare const toolDownloadExport: {
-    title: string;
-    description: string;
-    inputSchema: {
-        id: z.ZodString;
-    };
-    outputSchema: {
-        exportId: z.ZodString;
-        projectPath: z.ZodString;
-        pages: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            slug: z.ZodString;
-            pageType: z.ZodString;
-            isReadyToExport: z.ZodBoolean;
-            pagePath: z.ZodString;
-            componentsPath: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }, {
-            id: string;
-            title: string;
-            slug: string;
-            pageType: string;
-            isReadyToExport: boolean;
-            pagePath: string;
-            componentsPath: string;
-        }>, "many">;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-};
-export declare const toolClearTemp: {
-    title: string;
-    description: string;
-    inputSchema: {};
-    outputSchema: {
-        success: z.ZodBoolean;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-};

package/dist/instructions.js

@@ -1,252 +0,0 @@
-import { z } from "zod/v3";
-const pageSchema = z.object({
-    id: z.string().describe("Stable PrimeUI page identifier. Use this to match the same page across tool responses."),
-    title: z.string().describe("Human-readable page title. Show this to the user when confirming which pages to import."),
-    slug: z
-        .string()
-        .describe("PrimeUI route slug, for example '/', '/pricing', '/docs/getting-started'. Use to match user intent."),
-    pageType: z
-        .string()
-        .describe("PrimeUI page type classification (for example landing, docs, pricing, blogIndex, legal)."),
-    isReadyToExport: z
-        .boolean()
-        .describe("True when this page has an active export-ready variant. Only ready pages are expected in export output."),
-    pagePath: z
-        .string()
-        .describe("Relative file path to the page source inside downloaded export root. Copy page code from this exact path."),
-    componentsPath: z
-        .string()
-        .describe("Relative directory path inside downloaded export root where page-level components live. Use as dependency copy start."),
-}).describe("PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root.");
-const exportStatusSchema = z
-    .enum(["in_progress", "completed", "failed"])
-    .describe("Export lifecycle state. Use 'completed' before calling primeui_download_export.");
-const exportItemSchema = z
-    .object({
-    id: z.string().describe("Export identifier. Pass this value to primeui_download_export input.id."),
-    status: exportStatusSchema,
-    createdAt: z.string().describe("Export creation timestamp in ISO-8601 UTC format."),
-})
-    .describe("Single export record from PrimeUI export history.");
-// ============================================================
-// Shared constants
-// ============================================================
-const TRIGGER_PHRASES = [
-    "import page from PrimeUI",
-    "add page from PrimeUI",
-    "sync pages",
-    "pull page",
-    "transfer page",
-    "get page from PrimeUI",
-    "bring page from PrimeUI",
-    "export from PrimeUI",
-].join(", ");
-const WORKFLOW_SUMMARY = `
-WORKFLOW ORDER (always follow this sequence):
-1. primeui_get_project_info -> discover pages, confirm with user
-2. primeui_create_export -> generate export snapshot
-3. primeui_download_export -> download to temp directory
-4. Manually move page code + dependencies into user's project (per page)
-5. Repeat step 4 for each page user wants
-6. primeui_clear_temp -> cleanup temp files
-`.trim();
-// ============================================================
-// Server Instructions (initialInstructions)
-// ============================================================
-export const initialInstructions = `
-PrimeUI MCP enables importing pages from PrimeUI Studio into your local project.
-
-TRIGGER EXAMPLES (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}
-
-${WORKFLOW_SUMMARY}
-
-CRITICAL RULES FOR PAGE IMPORT:
-- Import is PAGE-BY-PAGE only. Never import the entire project at once.
-- The downloaded export in .primeui/temp/ contains a full standalone Next.js project.
-  Do NOT copy it wholesale.
-- Copy ONLY the target page file and its direct component dependencies.
-- Always use pagePath and componentsPath from tool responses as source of truth for file locations.
-- Trace each page's imports to identify which component folders are needed.
-- Check if components already exist in user's project - merge carefully, don't blindly overwrite.
-- Adjust import paths to match user's project structure.
-- Do NOT copy: package.json, next.config, tailwind.config, layout files, or any project-level config.
-- If merge conflicts arise and cannot be resolved unambiguously, STOP and ask the user to decide.
-`.trim();
-// ============================================================
-// Tool: primeui_get_project_info
-// ============================================================
-export const toolGetProjectInfo = {
-    title: "PrimeUI Project Info",
-    description: `ENTRY POINT for all PrimeUI import operations. Always start here. Returns project metadata and the full list of available pages.
-
-WHEN TO USE: Call this FIRST when user wants to import, add, sync, pull, or transfer a page from PrimeUI. Intent examples (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}.
-
-AFTER CALLING:
-- If the user already specified which pages they need - verify those pages exist in the project and have isReadyToExport: true. If any requested page is not found or not ready, inform the user immediately.
-- If the user did NOT specify pages - show the available pages list with titles and slugs, and ask which ones they want to import.
-- Import works on a per-page basis, not the entire project at once. The user can request multiple pages, but each will be transferred individually.
-- Only pages with isReadyToExport: true will be included in the export archive. If the user wants a page that is NOT ready, tell them to select an export-ready page variant in PrimeUI Studio first.
-- Once target pages are confirmed, proceed to primeui_create_export.
-
-${WORKFLOW_SUMMARY}`,
-    inputSchema: {},
-    outputSchema: {
-        projectId: z
-            .string()
-            .describe("PrimeUI project identifier associated with the API key and current import session context."),
-        projectName: z.string().describe("Human-readable PrimeUI project name for confirmations in chat."),
-        metadata: z
-            .record(z.unknown())
-            .describe("Additional project metadata from PrimeUI. May include project-description and other context fields."),
-        pages: z
-            .array(pageSchema)
-            .describe("All pages visible for this project context. Filter by user request and isReadyToExport before creating export."),
-    },
-    annotations: {
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true,
-    },
-};
-// ============================================================
-// Tool: primeui_list_exports
-// ============================================================
-export const 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.
-
-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.
-
-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.
-
-${WORKFLOW_SUMMARY}`,
-    inputSchema: {},
-    outputSchema: {
-        exports: z
-            .array(exportItemSchema)
-            .describe("Available exports sorted by API policy. Use item.id to download a specific prior export if user asks."),
-    },
-    annotations: {
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true,
-    },
-};
-// ============================================================
-// Tool: primeui_create_export
-// ============================================================
-export const 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.
-
-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.
-
-AFTER CALLING:
-- Verify that the pages the user wants are present in the export result AND have isReadyToExport: true. If a requested page is missing or not ready, inform the user before proceeding.
-- Use the returned export ID to call primeui_download_export.
-
-${WORKFLOW_SUMMARY}`,
-    inputSchema: {},
-    outputSchema: {
-        export: z
-            .object({
-            id: z.string().describe("Freshly created export identifier. Use this as primeui_download_export input.id."),
-            status: exportStatusSchema,
-        })
-            .describe("Created export summary."),
-        pages: z
-            .array(pageSchema)
-            .describe("Page snapshot associated with this export operation. Validate requested pages here before download/import."),
-    },
-    annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false,
-        openWorldHint: true,
-    },
-};
-// ============================================================
-// Tool: primeui_download_export
-// ============================================================
-export const 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.
-
-WHEN TO USE: Call this AFTER primeui_create_export has returned a completed export. Requires the export ID returned by primeui_create_export (or from primeui_list_exports if the user explicitly requested a previous export).
-
-AFTER DOWNLOAD:
-- The response includes a pages array. Verify the page the user wants is present and was exported successfully.
-- Each page in the response has pagePath and componentsPath fields - use these as direct pointers to locate the page source code and its component dependencies in the downloaded export. No need to search manually.
-
-MANUAL IMPORT STEPS per page (do not skip):
-1. Read the page file at the pagePath from the response.
-2. Read the component files at the componentsPath from the response. Trace the page's imports to identify which specific component folders are needed.
-3. Copy ONLY the page file and its component dependencies into the user's project.
-4. Adjust all import paths to match the user's project structure.
-5. Check for existing components in user's project:
-   - If code overlaps or was modified on the user's side, carefully determine the nature of changes on both sides.
-   - If the merge conflict can be resolved unambiguously - resolve it.
-   - If NOT - STOP, explain the conflict to the user, and ask for their decision before continuing.
-6. Do NOT copy project config files (package.json, next.config, tailwind.config, layout, etc.).
-7. REPEAT steps 1-6 for each page the user wants to import.
-8. Only after ALL pages are successfully imported, call primeui_clear_temp to clean up.
-
-  ${WORKFLOW_SUMMARY}`,
-    inputSchema: {
-        id: z
-            .string()
-            .describe("Export identifier to download. Prefer export.id from primeui_create_export; use primeui_list_exports only on explicit user request."),
-    },
-    outputSchema: {
-        exportId: z
-            .string()
-            .describe("Downloaded export identifier. Should match the requested input.id for traceability."),
-        projectPath: z
-            .string()
-            .describe("Absolute local path to extracted export root in .primeui/temp/exports/[exportId]. Read files from here only."),
-        pages: z
-            .array(pageSchema)
-            .describe("Page descriptors for import decisions. Use pagePath/componentsPath from each item when copying code into user project."),
-    },
-    annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true,
-    },
-};
-// ============================================================
-// Tool: primeui_clear_temp
-// ============================================================
-export const 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.
-
-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.
-
-Safe to call multiple times. Only affects .primeui/temp/ directory - never touches the user's project files.
-
-${WORKFLOW_SUMMARY}`,
-    inputSchema: {},
-    outputSchema: {
-        success: z.boolean().describe("True when temp cleanup completed and baseline temp structure was recreated."),
-    },
-    annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-};
-//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

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

package/dist/lib/fs.d.ts

@@ -1,4 +0,0 @@
-export declare function ensureDir(dirPath: string): Promise<void>;
-export declare function resetDir(dirPath: string): Promise<void>;
-export declare function writeUtf8(filePath: string, content: string): Promise<void>;
-export declare function extractZip(zipPath: string, targetDir: string): Promise<void>;

package/dist/lib/fs.js

@@ -1,25 +0,0 @@
-import { mkdir, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import extractZipArchive from "extract-zip";
-export async function ensureDir(dirPath) {
-    await mkdir(dirPath, { recursive: true });
-}
-export async function resetDir(dirPath) {
-    await rm(dirPath, { recursive: true, force: true });
-    await mkdir(dirPath, { recursive: true });
-}
-export async function writeUtf8(filePath, content) {
-    await ensureDir(path.dirname(filePath));
-    await writeFile(filePath, content, "utf-8");
-}
-export 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}`);
-    }
-}
-//# sourceMappingURL=fs.js.map

package/dist/lib/fs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/lib/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,iBAAiB,MAAM,aAAa,CAAA;AAE3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe;IAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACvC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,SAAiB;IACjE,MAAM,SAAS,CAAC,SAAS,CAAC,CAAA;IAE1B,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,MAAM,OAAO,EAAE,CAAC,CAAA;IACtE,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { ProjectSyncSource } from "./sources/project-sync-source.js";
-export declare function createPrimeUiMcpServer(source: ProjectSyncSource): McpServer;