@thallylabs/mcp 0.7.5 → 0.8.0

package/dist/index.js

@@ -329,6 +329,34 @@ function writeDocsJson(projectDir, config) {
   writeFileSync2(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 
+// src/lib/page-echo.ts
+var BODY_DELIMITER = "--- MDX body ---";
+function readPageBodyDelimiter() {
+  return BODY_DELIMITER;
+}
+function stripEchoedPageHeader(content, pageId) {
+  const lines = content.split("\n");
+  const delimiterIndex = lines.findIndex((line) => line.trim() === BODY_DELIMITER);
+  if (delimiterIndex !== -1 && delimiterIndex <= 6) {
+    return lines.slice(delimiterIndex + 1).join("\n").replace(/^\n+/, "");
+  }
+  const first = lines[0]?.trim() ?? "";
+  const second = lines[1]?.trim() ?? "";
+  if (first.startsWith("# ") && second === `*${pageId}*`) {
+    let index = 2;
+    while (index < lines.length && lines[index].trim() === "") index += 1;
+    if (lines[index]?.trim().startsWith("> ")) {
+      index += 1;
+      while (index < lines.length && lines[index].trim() === "") index += 1;
+    }
+    if (lines[index]?.trim() === "---") {
+      index += 1;
+    }
+    return lines.slice(index).join("\n").replace(/^\n+/, "");
+  }
+  return content;
+}
+
 // src/tools/add-page.ts
 var addPageSchema = z2.object({
   projectDir: z2.string().describe("Path to the Thally project root"),
@@ -359,7 +387,7 @@ async function handleAddPage(input) {
   if (description) {
     frontmatterLines.push(`description: ${description}`);
   }
-  const bodyContent = content ?? `## ${title}
+  const bodyContent = content ? stripEchoedPageHeader(content, pageId) : `## ${title}
 
 Add your content here.`;
   const mdxContent = `---
@@ -520,7 +548,7 @@ async function handleUpdatePage(input) {
   if (input.mergeFrontmatter) {
     Object.assign(newFm, input.mergeFrontmatter);
   }
-  const newBody = input.content !== void 0 ? input.content : parsed.content;
+  const newBody = input.content !== void 0 ? stripEchoedPageHeader(input.content, pageId) : parsed.content;
   const newContent = matter.stringify(newBody.trim(), newFm);
   writeFileSync4(filePath, newContent, "utf8");
   return [
@@ -542,7 +570,8 @@ var migrateDocsSchema = z6.object({
   branch: z6.string().optional().describe("Git branch (default: auto-detect)"),
   docsDir: z6.string().optional().describe("Docs subdirectory in repo (default: auto-detect)"),
   apiKey: z6.string().optional().describe("Anthropic API key for non-Markdown file conversion"),
-  maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import")
+  maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import"),
+  platform: z6.enum(["mintlify", "docusaurus"]).optional().describe("Source platform (default: auto-detect)")
 });
 async function handleMigrateDocs(input) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
@@ -554,6 +583,7 @@ async function handleMigrateDocs(input) {
     branch: input.branch,
     docsDir: input.docsDir,
     maxPages: input.maxPages,
+    platform: input.platform,
     yes: true
   });
   return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
@@ -744,12 +774,9 @@ async function handleReadPage(input) {
   const { data, content } = matter3(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
-  const lines = [`# ${title}`, `*${pageId}*`, ""];
-  if (description) {
-    lines.push(`> ${description}`);
-    lines.push("");
-  }
-  lines.push("---", "", content.trim());
+  const lines = [`id: ${pageId}`, `title: ${title}`];
+  if (description) lines.push(`description: ${description}`);
+  lines.push("", readPageBodyDelimiter(), "", content.trim());
   return lines.join("\n");
 }
 

package/dist/tools.js

@@ -320,6 +320,34 @@ function writeDocsJson(projectDir, config) {
   writeFileSync2(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 
+// src/lib/page-echo.ts
+var BODY_DELIMITER = "--- MDX body ---";
+function readPageBodyDelimiter() {
+  return BODY_DELIMITER;
+}
+function stripEchoedPageHeader(content, pageId) {
+  const lines = content.split("\n");
+  const delimiterIndex = lines.findIndex((line) => line.trim() === BODY_DELIMITER);
+  if (delimiterIndex !== -1 && delimiterIndex <= 6) {
+    return lines.slice(delimiterIndex + 1).join("\n").replace(/^\n+/, "");
+  }
+  const first = lines[0]?.trim() ?? "";
+  const second = lines[1]?.trim() ?? "";
+  if (first.startsWith("# ") && second === `*${pageId}*`) {
+    let index = 2;
+    while (index < lines.length && lines[index].trim() === "") index += 1;
+    if (lines[index]?.trim().startsWith("> ")) {
+      index += 1;
+      while (index < lines.length && lines[index].trim() === "") index += 1;
+    }
+    if (lines[index]?.trim() === "---") {
+      index += 1;
+    }
+    return lines.slice(index).join("\n").replace(/^\n+/, "");
+  }
+  return content;
+}
+
 // src/tools/add-page.ts
 var addPageSchema = z2.object({
   projectDir: z2.string().describe("Path to the Thally project root"),
@@ -350,7 +378,7 @@ async function handleAddPage(input) {
   if (description) {
     frontmatterLines.push(`description: ${description}`);
   }
-  const bodyContent = content ?? `## ${title}
+  const bodyContent = content ? stripEchoedPageHeader(content, pageId) : `## ${title}
 
 Add your content here.`;
   const mdxContent = `---
@@ -511,7 +539,7 @@ async function handleUpdatePage(input) {
   if (input.mergeFrontmatter) {
     Object.assign(newFm, input.mergeFrontmatter);
   }
-  const newBody = input.content !== void 0 ? input.content : parsed.content;
+  const newBody = input.content !== void 0 ? stripEchoedPageHeader(input.content, pageId) : parsed.content;
   const newContent = matter.stringify(newBody.trim(), newFm);
   writeFileSync4(filePath, newContent, "utf8");
   return [
@@ -533,7 +561,8 @@ var migrateDocsSchema = z6.object({
   branch: z6.string().optional().describe("Git branch (default: auto-detect)"),
   docsDir: z6.string().optional().describe("Docs subdirectory in repo (default: auto-detect)"),
   apiKey: z6.string().optional().describe("Anthropic API key for non-Markdown file conversion"),
-  maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import")
+  maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import"),
+  platform: z6.enum(["mintlify", "docusaurus"]).optional().describe("Source platform (default: auto-detect)")
 });
 async function handleMigrateDocs(input) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
@@ -545,6 +574,7 @@ async function handleMigrateDocs(input) {
     branch: input.branch,
     docsDir: input.docsDir,
     maxPages: input.maxPages,
+    platform: input.platform,
     yes: true
   });
   return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
@@ -735,12 +765,9 @@ async function handleReadPage(input) {
   const { data, content } = matter3(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
-  const lines = [`# ${title}`, `*${pageId}*`, ""];
-  if (description) {
-    lines.push(`> ${description}`);
-    lines.push("");
-  }
-  lines.push("---", "", content.trim());
+  const lines = [`id: ${pageId}`, `title: ${title}`];
+  if (description) lines.push(`description: ${description}`);
+  lines.push("", readPageBodyDelimiter(), "", content.trim());
   return lines.join("\n");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thallylabs/mcp",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "description": "MCP server for scaffolding and managing Thally documentation projects",
   "type": "module",
   "engines": {
@@ -34,7 +34,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
-    "create-thally-docs": "0.7.9",
+    "create-thally-docs": "0.8.0",
     "gray-matter": "^4.0.3",
     "p-limit": "^6.1.0",
     "tar": "^6.2.0",