@sonenta/mcp 0.37.0 → 0.38.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.
 
 ## Use
 

package/bin/sonenta-mcp.js

@@ -19562,6 +19562,58 @@ var init_schemas_observability = __esm({
   }
 });
 
+// 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 +19674,7 @@ var init_registry = __esm({
     init_helpers2();
     init_schemas_generated();
     init_schemas_observability();
+    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]);
@@ -20175,11 +20228,32 @@ 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);
       }
     };
     TOOLS = Object.entries({
       ...SCHEMAS,
-      ...OBSERVABILITY_SCHEMAS
+      ...OBSERVABILITY_SCHEMAS,
+      ...PROMPTS_SCHEMAS
     }).map(([name, schema]) => {
       const handler = HANDLERS[name];
       if (!handler) throw new Error(`registry: no handler ported for tool '${name}'`);
@@ -20270,7 +20344,7 @@ var init_server3 = __esm({
     init_errors3();
     init_helpers2();
     init_registry();
-    VERSION = "0.37.0";
+    VERSION = "0.38.0";
   }
 });