@sonenta/mcp 0.37.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.
+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,115 @@ 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({
+  "src/tools/schemas.prompts.ts"() {
+    "use strict";
+    PROJECT_UUID2 = {
+      type: "string",
+      description: "Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise."
+    };
+    PROMPTS_SCHEMAS = {
+      list_prompts: {
+        description: "Browse the Sonenta prompt library (the global catalogue). Use this to discover the reusable, curated prompts available for a project before you write your own \u2014 filter by section / subsection / tier / phase to narrow down. Read-only, free (0 credits). Returns {items:[{key, i18n_key, section, subsection, tier, phase, agent, category, title, template, enabled}], total}. To get a single ready-to-use template with variables filled, use resolve_prompt instead.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            project_uuid: PROJECT_UUID2,
+            section: { type: "string", description: "Filter by top-level section." },
+            subsection: { type: "string", description: "Filter by subsection within a section." },
+            tier: { type: "string", description: "Filter by tier." },
+            phase: { type: "string", description: "Filter by phase." },
+            enabled: {
+              type: "boolean",
+              description: "If set, return only enabled (true) or only disabled (false) prompts; omit for all."
+            }
+          }
+        }
+      },
+      resolve_prompt: {
+        description: "Resolve the single best-matching prompt for a section and get its template ready to use, with catalogue variables filled in. Use this when you want THE prompt for a job rather than a list to pick from. `section` is required; narrow further with subsection / tier / phase, and pass language / namespace / count to shape the resolved variables. Read-only, free (0 credits). Returns {prompt:{key, i18n_key, template, resolved, variables_used}}; errors 404 if nothing matches.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            project_uuid: PROJECT_UUID2,
+            section: { type: "string", description: "Section to resolve a prompt for (REQUIRED)." },
+            subsection: { type: "string", description: "Optional subsection to narrow the match." },
+            tier: { type: "string", description: "Optional tier to narrow the match." },
+            phase: { type: "string", description: "Optional phase to narrow the match." },
+            language: { type: "string", description: "Optional language code used when filling template variables." },
+            namespace: { type: "string", description: "Optional namespace used when filling template variables." },
+            count: {
+              type: "integer",
+              description: "Optional count used by count-dependent template variables (default 0)."
+            }
+          },
+          required: ["section"]
+        }
+      }
+    };
+    PROMPTS_TOOL_NAMES = Object.keys(PROMPTS_SCHEMAS);
+  }
+});
+
 // src/tools/registry.ts
 var registry_exports = {};
 __export(registry_exports, {
@@ -19622,6 +19731,8 @@ 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;
     truthy = (args, k) => Boolean(args[k]);
@@ -19767,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) {
@@ -20175,11 +20287,49 @@ var init_registry = __esm({
         const data = await client.post(`/v1/mcp/projects/${p}/agent/sessions/${sid}/end`, body);
         if (client.sessionId === sid) client.clearSession();
         return data;
+      },
+      // ---- prompt library (read-only, task 1618 / backend #230) ----
+      async list_prompts(args, client) {
+        const p = resolveProjectUuid(args, client);
+        const params = {};
+        for (const k of ["section", "subsection", "tier", "phase"]) {
+          if (args[k]) params[k] = str(args[k]);
+        }
+        if ("enabled" in args) params["enabled"] = Boolean(args["enabled"]);
+        return client.get(`/v1/mcp/projects/${p}/prompts/catalogue`, params);
+      },
+      async resolve_prompt(args, client) {
+        const p = resolveProjectUuid(args, client);
+        if (!truthy(args, "section")) throw new ToolValidationError("section is required");
+        const params = { section: str(args["section"]) };
+        for (const k of ["subsection", "tier", "phase", "language", "namespace"]) {
+          if (args[k]) params[k] = str(args[k]);
+        }
+        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,
-      ...OBSERVABILITY_SCHEMAS
+      ...PLURALS_EXTENDED_SCHEMAS,
+      // override propose_translation(s) with the plural_forms superset
+      ...OBSERVABILITY_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}'`);
@@ -20270,7 +20420,7 @@ var init_server3 = __esm({
     init_errors3();
     init_helpers2();
     init_registry();
-    VERSION = "0.37.0";
+    VERSION = "0.40.0";
   }
 });