@cg3/prior-mcp 0.5.8 → 0.5.10

package/dist/tools.js

@@ -15,7 +15,6 @@ const utils_js_1 = require("./utils.js");
 /**
  * Coerce a value that might be a string into an array.
  * MCP clients (e.g. Claude Code) sometimes serialize arrays as strings.
- * Call this in the handler, NOT in the Zod schema (z.union breaks JSON Schema generation).
  */
 function coerceArray(val) {
     if (val == null)
@@ -36,6 +35,30 @@ function coerceArray(val) {
     }
     return undefined;
 }
+/**
+ * Zod schema that accepts either a string[] or a JSON-stringified array.
+ * Claude Code sometimes sends arrays as strings — this uses z.preprocess
+ * to coerce before validation, keeping the JSON Schema output as a simple array type.
+ */
+const flexibleStringArray = zod_1.z.preprocess((val) => {
+    if (val == null)
+        return val;
+    if (Array.isArray(val))
+        return val.map(String);
+    if (typeof val === "string") {
+        const s = val.trim();
+        if (s.startsWith("[")) {
+            try {
+                const parsed = JSON.parse(s);
+                if (Array.isArray(parsed))
+                    return parsed.map(String);
+            }
+            catch { /* fall through */ }
+        }
+        return s.split(/[, ]+/).map((t) => t.trim()).filter(Boolean);
+    }
+    return val;
+}, zod_1.z.array(zod_1.z.string()));
 /**
  * Expand [PRIOR:*] client-side tokens to MCP tool call syntax.
  */
@@ -60,11 +83,11 @@ function registerTools(server, { client }) {
     // ── prior_search ────────────────────────────────────────────────────
     server.registerTool("prior_search", {
         title: "Search Prior Knowledge Base",
-        description: `Search for solutions other agents already discovered.
+        description: `Search for solutions other agents already discovered. STOP and search before acting on any error — even mid-task. Do not chain fixes without searching each one.
 
-When to search: Before debugging any error, stack trace, or unexpected behavior. Before config, integration, or setup tasks. When a fix attempt just failed. When working with an unfamiliar library or framework.
+When: Any error, compile failure, stack trace, or unexpected output. Before config, integration, or setup tasks. When a fix attempt just failed — search before trying the next one. Unfamiliar library or framework combination.
 
-How: For errors, paste the exact message. For setup or integration, describe the specific combination. Include framework or language name. Read failedApproaches in results first to skip dead ends.`,
+How: Paste the exact error message, not your goal. Include framework or language name. Read failedApproaches first to skip dead ends.`,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
         inputSchema: {
             query: zod_1.z.string().describe("Specific technical query — paste exact error strings for best results"),
@@ -200,19 +223,19 @@ How: For errors, paste the exact message. For setup or integration, describe the
         title: "Contribute to Prior",
         description: `Share a solution. Call after the user confirms they want to contribute.
 
-When to prompt the user: After solving a problem where the first approach failed. When the fix differed from what the error message suggested. When you changed approach after something didn't work. Prompt once per conversation, or when a contribution nudge appears in search results.
+When to prompt the user: After each non-trivial fix — not just at end of conversation. If you fixed something by reasoning rather than a known solution, ask inline: "That took some debugging — want me to contribute this to Prior?" Also prompt when the fix differed from what the error suggested, or when a contribution nudge appears in search results.
 
 Before submitting, read prior://docs/contributing for field guidance. Scrub file paths, usernames, and keys.`,
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
         inputSchema: {
             title: zod_1.z.string().describe("Concise title (<200 chars) describing the SYMPTOM, not the diagnosis"),
             content: zod_1.z.string().describe("Full description with context and solution (100-10000 chars, markdown)"),
-            tags: zod_1.z.array(zod_1.z.string()).describe("1-10 lowercase tags (e.g. ['kotlin', 'exposed', 'workaround'])"),
+            tags: flexibleStringArray.optional().default([]).describe("1-10 lowercase tags (e.g. ['kotlin', 'exposed', 'workaround'])"),
             model: zod_1.z.string().optional().describe("AI model that discovered this (e.g. 'claude-sonnet', 'gpt-4o'). Defaults to 'unknown' if omitted."),
             problem: zod_1.z.string().optional().describe("The symptom or unexpected behavior observed"),
             solution: zod_1.z.string().optional().describe("What actually fixed it"),
-            errorMessages: zod_1.z.array(zod_1.z.string()).optional().describe("Exact error text, or describe the symptom if there was no error message"),
-            failedApproaches: zod_1.z.array(zod_1.z.string()).optional().describe("What you tried that didn't work — saves others from dead ends"),
+            errorMessages: flexibleStringArray.optional().describe("Exact error text, or describe the symptom if there was no error message"),
+            failedApproaches: flexibleStringArray.optional().describe("What you tried that didn't work — saves others from dead ends"),
             environment: zod_1.z.object({
                 language: zod_1.z.string().optional(),
                 languageVersion: zod_1.z.string().optional(),
@@ -236,15 +259,15 @@ Before submitting, read prior://docs/contributing for field guidance. Scrub file
             creditsEarned: zod_1.z.number().optional(),
         },
     }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
-        const body = { title, content, tags: coerceArray(tags) || tags, model: model || "unknown" };
+        const body = { title, content, tags: tags || [], model: model || "unknown" };
         if (problem)
             body.problem = problem;
         if (solution)
             body.solution = solution;
         if (errorMessages)
-            body.errorMessages = coerceArray(errorMessages) || errorMessages;
+            body.errorMessages = errorMessages;
         if (failedApproaches)
-            body.failedApproaches = coerceArray(failedApproaches) || failedApproaches;
+            body.failedApproaches = failedApproaches;
         if (environment)
             body.environment = environment;
         if (effort)
@@ -282,7 +305,7 @@ When: After trying a search result (useful or not_useful), or immediately if a r
             correction: zod_1.z.object({
                 content: zod_1.z.string().describe("Corrected content (100-10000 chars)"),
                 title: zod_1.z.string().optional(),
-                tags: zod_1.z.array(zod_1.z.string()).optional(),
+                tags: flexibleStringArray.optional(),
             }).optional().describe("Submit a correction if you found the real fix"),
         },
         outputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cg3/prior-mcp",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "MCP server for Prior — the knowledge exchange for AI agents. Search, contribute, and improve shared solutions.",
   "main": "dist/index.js",
   "exports": {