@syntholoc/mcp 0.4.0 → 0.5.0

package/dist/build-server.js

@@ -2,7 +2,7 @@ import {
   TOOL_SET_NAMES,
   buildMcpServer,
   parseList
-} from "./chunk-P7LZNIW2.js";
+} from "./chunk-V5AAF2RJ.js";
 export {
   TOOL_SET_NAMES,
   buildMcpServer,

package/dist/{chunk-P7LZNIW2.js → chunk-V5AAF2RJ.js}

@@ -306,6 +306,9 @@ import { COST_ANALYTICS, LOCALE_PROGRESS, PROJECT_ANALYTICS as PROJECT_ANALYTICS
 function jsonResult(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
+function errorResult(message) {
+  return { content: [{ type: "text", text: message }], isError: true };
+}
 
 // src/tools/analytics.ts
 function registerAnalyticsTools(server, gql) {
@@ -664,7 +667,8 @@ import {
   UPDATE_KEY,
   UPSERT_KEYS
 } from "@syntholoc/sdk";
-var FORMATS = ["JSON", "YAML", "CSV", "PO", "XLIFF", "ANDROID_XML", "IOS_STRINGS", "NJK"];
+var FORMATS = ["JSON", "YAML", "MARKDOWN", "MDX", "CSV", "PO", "XLIFF", "ANDROID_XML", "IOS_STRINGS", "NJK"];
+var DOCUMENT_FORMATS = /* @__PURE__ */ new Set(["MARKDOWN", "MDX"]);
 function registerKeyTools(server, gql) {
   server.registerTool(
     "list_keys",
@@ -734,7 +738,7 @@ function registerKeyTools(server, gql) {
     "import_source_strings",
     {
       title: "Import source strings",
-      description: 'Imports source strings from ONE file (paste the raw content) and returns the diff summary. For initial setup of a repo-hosted project, PREFER connecting the repo and running `sync_repository` \u2014 it imports every source file server-side in one pass; use this tool only for file-based projects with no Git integration, or for one-off single-file imports. For a multi-file / namespaced project (a file per namespace, e.g. messages/en/home.json), pass `keyPrefix` (the namespace, e.g. "home") so keys become `home.title` and files with overlapping top-level keys do not collide \u2014 call once per file. Use `dryRun` to preview.',
+      description: 'Imports source strings from ONE file (paste the raw content) and returns the diff summary. For initial setup of a repo-hosted project, PREFER connecting the repo and running `sync_repository` \u2014 it imports every source file server-side in one pass; use this tool only for file-based projects with no Git integration, or for one-off single-file imports. For a multi-file / namespaced project (a file per namespace, e.g. messages/en/home.json), pass `keyPrefix` (the namespace, e.g. "home") so keys become `home.title` and files with overlapping top-level keys do not collide \u2014 call once per file. Use `dryRun` to preview. For MARKDOWN and MDX `sourceFile` is REQUIRED: the document is split into per-block segments, and without the file path a re-import cannot tell a moved paragraph from an edited one.',
       inputSchema: {
         projectId: z6.string(),
         content: z6.string(),
@@ -747,12 +751,17 @@ function registerKeyTools(server, gql) {
       },
       annotations: { idempotentHint: true, openWorldHint: true }
     },
-    async ({ projectId, content, format, keyPrefix, sourceFile, dryRun }) => jsonResult(
-      (await gql.request(IMPORT_SOURCE_STRINGS, {
-        projectId,
-        input: { content, format, keyPrefix, sourceFile, dryRun }
-      })).importSourceStrings
-    )
+    async ({ projectId, content, format, keyPrefix, sourceFile, dryRun }) => {
+      if (DOCUMENT_FORMATS.has(format) && !sourceFile?.trim()) {
+        return errorResult(`${format} needs a sourceFile \u2014 a document's segments only have an identity within a file.`);
+      }
+      return jsonResult(
+        (await gql.request(IMPORT_SOURCE_STRINGS, {
+          projectId,
+          input: { content, format, keyPrefix, sourceFile, dryRun }
+        })).importSourceStrings
+      );
+    }
   );
 }
 
@@ -1295,6 +1304,7 @@ function registerTmTools(server, gql) {
 import { z as z14 } from "zod";
 import {
   APPROVE_TRANSLATION,
+  EXPORT_DOCUMENT_LOCALE,
   EXPORT_LOCALE,
   IMPORT_TRANSLATIONS,
   LIST_TRANSLATIONS,
@@ -1303,7 +1313,8 @@ import {
   TRANSLATE_KEY,
   TRANSLATE_LOCALE
 } from "@syntholoc/sdk";
-var FORMATS2 = ["JSON", "YAML", "CSV", "PO", "XLIFF", "ANDROID_XML", "IOS_STRINGS", "NJK"];
+var FORMATS2 = ["JSON", "YAML", "MARKDOWN", "MDX", "CSV", "PO", "XLIFF", "ANDROID_XML", "IOS_STRINGS", "NJK"];
+var DOCUMENT_FORMATS2 = /* @__PURE__ */ new Set(["MARKDOWN", "MDX"]);
 function registerTranslationTools(server, gql) {
   server.registerTool(
     "translate_locale",
@@ -1386,7 +1397,7 @@ function registerTranslationTools(server, gql) {
     "export_locale",
     {
       title: "Export locale",
-      description: 'Exports a locale to a file string in the chosen format \u2014 the basis for writing translations back into local files. Set `onlyApproved` to exclude drafts. For a multi-file project prefer `sourceFile` (the real path, e.g. "messages/en/home.json") to export exactly that file with file-local key names \u2014 reliable. `keyPrefix` is the legacy name-prefix heuristic.',
+      description: 'Exports a locale to a file string in the chosen format \u2014 the basis for writing translations back into local files. Set `onlyApproved` to exclude drafts. For a multi-file project prefer `sourceFile` (the real path, e.g. "messages/en/home.json") to export exactly that file with file-local key names \u2014 reliable. `keyPrefix` is the legacy name-prefix heuristic. For MARKDOWN and MDX use `export_document` instead: a document is spliced into its original file, which the server reads from the connected repository.',
       inputSchema: {
         projectId: z14.string(),
         localeId: z14.string(),
@@ -1399,30 +1410,59 @@ function registerTranslationTools(server, gql) {
     },
     async (vars) => jsonResult({ content: (await gql.request(EXPORT_LOCALE, vars)).exportLocale })
   );
+  server.registerTool(
+    "export_document",
+    {
+      title: "Export document locale",
+      description: "Exports one locale of a Markdown or MDX source document. Unlike `export_locale` this returns the whole translated document: the server reads the original file from the connected repository and splices the translations into it, so headings, list markers, code fences and indentation are preserved byte for byte. Segments with no translation keep their source text.",
+      inputSchema: {
+        projectId: z14.string(),
+        localeId: z14.string(),
+        sourceFile: z14.string().describe('Path of the source document in the repository, e.g. "docs/guide.md".'),
+        repositoryId: z14.string().optional().describe("Only needed when the project has several repositories and the path is ambiguous."),
+        onlyApproved: z14.boolean().optional()
+      },
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    async (vars) => {
+      if (!vars.sourceFile.trim()) {
+        return errorResult("export_document needs a sourceFile \u2014 the path of the document in the repository.");
+      }
+      return jsonResult({ content: (await gql.request(EXPORT_DOCUMENT_LOCALE, vars)).exportDocumentLocale });
+    }
+  );
   server.registerTool(
     "import_translations",
     {
       title: "Import translations",
-      description: "Imports ready-made translations for a locale (paste file content). `autoApprove` lands them as APPROVED; `conflict` is OVERWRITE | SKIP_EXISTING | KEEP_APPROVED; `dryRun` previews. For a multi-file / namespaced project pass `keyPrefix` (the namespace) to match prefixed source keys.",
+      description: "Imports ready-made translations for a locale (paste file content). `autoApprove` lands them as APPROVED; `conflict` is OVERWRITE | SKIP_EXISTING | KEEP_APPROVED; `dryRun` previews. For a multi-file / namespaced project pass `keyPrefix` (the namespace) to match prefixed source keys. For MARKDOWN and MDX `sourceFile` is REQUIRED: a translated document has translated headings, so it is matched to the source by segment position and the two must have the same structure.",
       inputSchema: {
         projectId: z14.string(),
         localeId: z14.string(),
         content: z14.string(),
         format: z14.enum(FORMATS2),
         keyPrefix: z14.string().optional().describe('Namespace prefix, e.g. "home" (per-file, multi-file projects).'),
+        sourceFile: z14.string().optional().describe('Source file these translations belong to; REQUIRED for MARKDOWN/MDX, e.g. "docs/guide.md".'),
         autoApprove: z14.boolean().default(false),
         conflict: z14.enum(["OVERWRITE", "SKIP_EXISTING", "KEEP_APPROVED"]).default("OVERWRITE"),
         dryRun: z14.boolean().default(false)
       },
       annotations: { idempotentHint: true, openWorldHint: true }
     },
-    async ({ projectId, localeId, content, format, keyPrefix, autoApprove, conflict, dryRun }) => jsonResult(
-      (await gql.request(IMPORT_TRANSLATIONS, {
-        projectId,
-        localeId,
-        input: { content, format, keyPrefix, autoApprove, conflict, dryRun }
-      })).importTranslations
-    )
+    async ({ projectId, localeId, content, format, keyPrefix, sourceFile, autoApprove, conflict, dryRun }) => {
+      if (DOCUMENT_FORMATS2.has(format) && !sourceFile?.trim()) {
+        return errorResult(
+          `${format} needs a sourceFile \u2014 a translated document is aligned to its source by position.`
+        );
+      }
+      return jsonResult(
+        (await gql.request(IMPORT_TRANSLATIONS, {
+          projectId,
+          localeId,
+          input: { content, format, keyPrefix, sourceFile, autoApprove, conflict, dryRun }
+        })).importTranslations
+      );
+    }
   );
 }
 
@@ -1455,7 +1495,7 @@ function registerAllTools(server, gql, opts = {}) {
 }
 
 // package.json
-var version = "0.4.0";
+var version = "0.5.0";
 
 // src/build-server.ts
 function buildMcpServer(gql, opts = {}) {

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   buildMcpServer,
   parseList
-} from "./chunk-P7LZNIW2.js";
+} from "./chunk-V5AAF2RJ.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntholoc/mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Syntholoc MCP server — manage AI localization and translation from Codex, Claude Code, and other MCP clients.",
   "homepage": "https://syntholoc.com",
   "keywords": [