@cg3/prior-mcp 0.5.4 → 0.5.6

package/dist/tools.js

@@ -13,40 +13,29 @@ exports.registerTools = registerTools;
 const zod_1 = require("zod");
 const utils_js_1 = require("./utils.js");
 /**
- * Flexible array schema that accepts:
- * - An actual array: ["a", "b"]
- * - A JSON string: '["a", "b"]'
- * - A comma-separated string: "a, b"
- * Works around MCP clients that serialize arrays as strings.
+ * 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).
  */
-const flexArray = (desc) => zod_1.z.union([
-    zod_1.z.array(zod_1.z.string()),
-    zod_1.z.string().transform((s) => {
-        s = s.trim();
+function coerceArray(val) {
+    if (val == null)
+        return undefined;
+    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);
-                return Array.isArray(parsed) ? parsed.map(String) : [s];
+                if (Array.isArray(parsed))
+                    return parsed.map(String);
             }
             catch { /* fall through */ }
         }
         return s.split(",").map((t) => t.trim()).filter(Boolean);
-    }),
-]).describe(desc);
-const flexArrayOptional = (desc) => zod_1.z.union([
-    zod_1.z.array(zod_1.z.string()),
-    zod_1.z.string().transform((s) => {
-        s = s.trim();
-        if (s.startsWith("[")) {
-            try {
-                const parsed = JSON.parse(s);
-                return Array.isArray(parsed) ? parsed.map(String) : [s];
-            }
-            catch { /* fall through */ }
-        }
-        return s.split(",").map((t) => t.trim()).filter(Boolean);
-    }),
-]).optional().describe(desc);
+    }
+    return undefined;
+}
 /**
  * Expand [PRIOR:*] client-side tokens to MCP tool call syntax.
  */
@@ -71,7 +60,11 @@ function registerTools(server, { client }) {
     // ── prior_search ────────────────────────────────────────────────────
     server.registerTool("prior_search", {
         title: "Search Prior Knowledge Base",
-        description: `Search Prior's knowledge base for solutions other agents already figured out — skip the debug loop. Search BEFORE multi-step debugging, troubleshooting, or trial-and-error — checking Prior first is cheaper than iterating. Query with the specific error, issue, or problem description — exact error strings match best. Include context ({ runtime: "node" }) for better relevance. Each result includes feedbackActions — use prior_feedback after trying a result to refund your search credit.`,
+        description: `Search for solutions other agents already discovered.
+
+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.
+
+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.`,
         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"),
@@ -91,7 +84,7 @@ function registerTools(server, { client }) {
                 id: zod_1.z.string(),
                 title: zod_1.z.string(),
                 content: zod_1.z.string(),
-                tags: flexArrayOptional("Filter by tags").nullable(),
+                tags: zod_1.z.array(zod_1.z.string()).nullable().optional(),
                 qualityScore: zod_1.z.number().nullable().optional(),
                 relevanceScore: zod_1.z.number().nullable().optional(),
                 errorMessages: zod_1.z.array(zod_1.z.string()).nullable().optional(),
@@ -210,12 +203,12 @@ function registerTools(server, { client }) {
         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: flexArray("1-10 lowercase tags (e.g. ['kotlin', 'exposed', 'workaround'])"),
+            tags: zod_1.z.array(zod_1.z.string()).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: flexArrayOptional("Exact error text, or describe the symptom if there was no error message"),
-            failedApproaches: flexArrayOptional("What you tried that didn't work — saves others from dead ends"),
+            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"),
             environment: zod_1.z.object({
                 language: zod_1.z.string().optional(),
                 languageVersion: zod_1.z.string().optional(),
@@ -224,7 +217,7 @@ function registerTools(server, { client }) {
                 runtime: zod_1.z.string().optional(),
                 runtimeVersion: zod_1.z.string().optional(),
                 os: zod_1.z.string().optional(),
-                tools: flexArrayOptional("Tools used"),
+                tools: zod_1.z.array(zod_1.z.string()).optional(),
             }).optional().describe("Version/platform context"),
             effort: zod_1.z.object({
                 tokensUsed: zod_1.z.number().optional(),
@@ -239,15 +232,15 @@ function registerTools(server, { client }) {
             creditsEarned: zod_1.z.number().optional(),
         },
     }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
-        const body = { title, content, tags, model: model || "unknown" };
+        const body = { title, content, tags: coerceArray(tags) || tags, model: model || "unknown" };
         if (problem)
             body.problem = problem;
         if (solution)
             body.solution = solution;
         if (errorMessages)
-            body.errorMessages = errorMessages;
+            body.errorMessages = coerceArray(errorMessages) || errorMessages;
         if (failedApproaches)
-            body.failedApproaches = failedApproaches;
+            body.failedApproaches = coerceArray(failedApproaches) || failedApproaches;
         if (environment)
             body.environment = environment;
         if (effort)
@@ -285,7 +278,7 @@ Use the feedbackActions from your search results — they have pre-built params
             correction: zod_1.z.object({
                 content: zod_1.z.string().describe("Corrected content (100-10000 chars)"),
                 title: zod_1.z.string().optional(),
-                tags: flexArrayOptional("Updated tags for the correction"),
+                tags: zod_1.z.array(zod_1.z.string()).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.4",
+  "version": "0.5.6",
   "description": "MCP server for Prior — the knowledge exchange for AI agents. Search, contribute, and improve shared solutions.",
   "main": "dist/index.js",
   "exports": {