@sonenta/mcp 0.38.0 → 0.40.0

package/README.md

@@ -2,7 +2,7 @@
 
 Model Context Protocol server for **Sonenta** translation management — **pure TypeScript**, no Python, no `uv`, no bundled wheel. Runs on Node ≥18.
 
-Wires Claude Desktop and other MCP clients into your Sonenta project's keys, translations, accessibility surfaces, source-health, and glossary tools — plus **agent-observability** tools (`session_start` / `annotate` / `human_needed` / `session_end`) that surface an agent's run as a live, timestamped thread in the Sonenta dashboard, and **prompt-library** reads (`list_prompts` / `resolve_prompt`) so agents can discover and reuse the project's curated prompts.
+Wires Claude Desktop and other MCP clients into your Sonenta project's keys, translations, accessibility surfaces, source-health, and glossary tools — plus **agent-observability** tools (`session_start` / `annotate` / `human_needed` / `session_end`) that surface an agent's run as a live, timestamped thread in the Sonenta dashboard, and **prompt-library** reads (`list_prompts` / `resolve_prompt`) so agents can discover and reuse the project's curated prompts. `propose_translation(s)` carry ICU/CLDR `plural_forms`, and `plural_categories` returns the plural categories a language requires (babel-authoritative).
 
 ## Use
 

package/bin/sonenta-mcp.js

@@ -19562,6 +19562,63 @@ var init_schemas_observability = __esm({
   }
 });
 
+// src/tools/schemas.plurals.ts
+function extendProposeTranslation() {
+  const s = clone2(SCHEMAS["propose_translation"]);
+  const props = s.inputSchema["properties"];
+  props["plural_forms"] = PLURAL_FORMS_PROPERTY;
+  s.inputSchema["required"] = ["namespace", "key", "language_code"];
+  s.description += " For a PLURAL key, pass `plural_forms` (a CLDR category->string map covering exactly the target language's required categories) instead of a single `value`.";
+  return s;
+}
+function extendProposeBulk() {
+  const s = clone2(SCHEMAS["propose_translations_bulk"]);
+  const items = s.inputSchema["properties"]["items"];
+  const item = items["items"];
+  item["properties"]["plural_forms"] = PLURAL_FORMS_PROPERTY;
+  item["required"] = ["namespace", "key", "language_code"];
+  s.description += " Each item may carry `plural_forms` (a CLDR category->string map) for plural keys instead of `value`.";
+  return s;
+}
+var PLURAL_FORMS_PROPERTY, clone2, PLURALS_EXTENDED_SCHEMAS, PLURAL_CATEGORIES_SCHEMAS, PLURALS_NATIVE_TOOL_NAMES, PLURALS_EXTENDED_TOOL_NAMES;
+var init_schemas_plurals = __esm({
+  "src/tools/schemas.plurals.ts"() {
+    "use strict";
+    init_schemas_generated();
+    PLURAL_FORMS_PROPERTY = {
+      type: "object",
+      additionalProperties: { type: "string" },
+      description: 'For PLURAL keys only: a map of CLDR plural category -> rendered string, e.g. {"one":"{{count}} file","other":"{{count}} files"}. Provide EXACTLY the categories the TARGET language requires (call plural_categories to get them); `other` is always required. Keep the count variable in every form. When set, `value` may be omitted (it mirrors plural_forms.other). Supplying it for a non-plural key is rejected.'
+    };
+    clone2 = (s) => JSON.parse(JSON.stringify(s));
+    PLURALS_EXTENDED_SCHEMAS = {
+      propose_translation: extendProposeTranslation(),
+      propose_translations_bulk: extendProposeBulk()
+    };
+    PLURAL_CATEGORIES_SCHEMAS = {
+      plural_categories: {
+        description: "Get the CLDR plural categories a language REQUIRES (babel-authoritative \u2014 the canonical source, not an LLM guess), so you author exactly the right plural forms per target locale. Pass `code` for one language or `codes` for several. Returns the ordered categories plus an example integer per category. Read-only, free (0 credits). Use this before writing plural_forms via propose_translation(s).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            code: {
+              type: "string",
+              description: "A single BCP-47 language code, e.g. ru, ar, fr-CA. Falls back to the base language then to ['other']."
+            },
+            codes: {
+              type: "array",
+              items: { type: "string" },
+              description: "Several BCP-47 codes for a bulk lookup, e.g. ['ru','ar','fr']. Takes precedence over `code`."
+            }
+          }
+        }
+      }
+    };
+    PLURALS_NATIVE_TOOL_NAMES = Object.keys(PLURAL_CATEGORIES_SCHEMAS);
+    PLURALS_EXTENDED_TOOL_NAMES = Object.keys(PLURALS_EXTENDED_SCHEMAS);
+  }
+});
+
 // src/tools/schemas.prompts.ts
 var PROJECT_UUID2, PROMPTS_SCHEMAS, PROMPTS_TOOL_NAMES;
 var init_schemas_prompts = __esm({
@@ -19674,6 +19731,7 @@ var init_registry = __esm({
     init_helpers2();
     init_schemas_generated();
     init_schemas_observability();
+    init_schemas_plurals();
     init_schemas_prompts();
     A11Y_SURFACES = ["aria_label", "alt_text", "screen_reader", "plain_language"];
     has = (args, k) => k in args;
@@ -19820,13 +19878,14 @@ var init_registry = __esm({
       // ---- translations & publish ----
       async propose_translation(args, client) {
         const p = resolveProjectUuid(args, client);
+        if (!has(args, "value") && !has(args, "plural_forms"))
+          throw new ToolValidationError("provide value, or plural_forms for a plural key");
         const body = {
           namespace: args["namespace"],
           key: args["key"],
-          language_code: args["language_code"],
-          value: args["value"]
+          language_code: args["language_code"]
         };
-        copyPresent(body, args, ["status"]);
+        copyPresent(body, args, ["value", "status", "plural_forms"]);
         return client.put(`/v1/mcp/projects/${p}/translations`, body);
       },
       async propose_translations_bulk(args, client) {
@@ -20248,12 +20307,29 @@ var init_registry = __esm({
         }
         if ("count" in args) params["count"] = args["count"];
         return client.get(`/v1/mcp/projects/${p}/prompts/resolve`, params);
+      },
+      // ---- plurals: required CLDR categories per language (read-only, task 1620) ----
+      // Global reference route (/v1/mcp/languages/...), NOT project-scoped.
+      async plural_categories(args, client) {
+        const codes = args["codes"];
+        if (Array.isArray(codes) && codes.length) {
+          return client.get("/v1/mcp/languages/plural-categories", {
+            codes: codes.map(str).join(",")
+          });
+        }
+        if (truthy(args, "code")) {
+          return client.get(`/v1/mcp/languages/${encodeURIComponent(str(args["code"]))}/plural-categories`);
+        }
+        throw new ToolValidationError("pass either code (single) or codes (bulk list)");
       }
     };
     TOOLS = Object.entries({
       ...SCHEMAS,
+      ...PLURALS_EXTENDED_SCHEMAS,
+      // override propose_translation(s) with the plural_forms superset
       ...OBSERVABILITY_SCHEMAS,
-      ...PROMPTS_SCHEMAS
+      ...PROMPTS_SCHEMAS,
+      ...PLURAL_CATEGORIES_SCHEMAS
     }).map(([name, schema]) => {
       const handler = HANDLERS[name];
       if (!handler) throw new Error(`registry: no handler ported for tool '${name}'`);
@@ -20344,7 +20420,7 @@ var init_server3 = __esm({
     init_errors3();
     init_helpers2();
     init_registry();
-    VERSION = "0.38.0";
+    VERSION = "0.40.0";
   }
 });