@cg3/prior-mcp 0.5.16 → 0.5.18

package/dist/tools.js

@@ -103,6 +103,9 @@ Feedback: Include previousSearchFeedback to rate a result from your last search
                 shell: zod_1.z.string().optional(),
                 taskType: zod_1.z.string().optional(),
             }).optional().describe("Optional context for better relevance. Include runtime if known."),
+            requiredTags: zod_1.z.array(zod_1.z.string()).optional().describe("Only return entries that have ALL of these tags"),
+            excludeTags: zod_1.z.array(zod_1.z.string()).optional().describe("Exclude entries that have ANY of these tags"),
+            preferredTags: zod_1.z.array(zod_1.z.string()).optional().describe("Boost entries with these tags (soft signal, does not exclude non-matches)"),
             previousSearchFeedback: zod_1.z.object({
                 searchId: zod_1.z.string().optional().describe("searchId from the previous search response"),
                 entryId: zod_1.z.string().describe("Entry ID from the previous search result"),
@@ -141,7 +144,7 @@ Feedback: Include previousSearchFeedback to rate a result from your last search
             agentHint: zod_1.z.string().optional().describe("Contextual hint from the server"),
             doNotTry: zod_1.z.array(zod_1.z.string()).optional().describe("Aggregated failed approaches from results — things NOT to try"),
         },
-    }, async ({ query, maxResults, maxTokens, minQuality, context, previousSearchFeedback }) => {
+    }, async ({ query, maxResults, maxTokens, minQuality, context, requiredTags, excludeTags, preferredTags, previousSearchFeedback }) => {
         const body = { query };
         // Build context — use provided values, fall back to detected runtime
         const ctx = context || {};
@@ -154,6 +157,12 @@ Feedback: Include previousSearchFeedback to rate a result from your last search
             body.maxTokens = maxTokens;
         if (minQuality !== undefined)
             body.minQuality = minQuality;
+        if (requiredTags?.length)
+            body.requiredTags = requiredTags;
+        if (excludeTags?.length)
+            body.excludeTags = excludeTags;
+        if (preferredTags?.length)
+            body.preferredTags = preferredTags;
         if (previousSearchFeedback)
             body.previousSearchFeedback = previousSearchFeedback;
         const data = await client.request("POST", "/v1/knowledge/search", body);
@@ -241,7 +250,9 @@ Feedback: Include previousSearchFeedback to rate a result from your last search
 
 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 PII and project-specific details — Prior is a public knowledge base. Write for developers on unrelated projects, not your team.`,
+Before submitting, read prior://docs/contributing for field guidance. Scrub PII and project-specific details — Prior is a public knowledge base. Write for developers on unrelated projects, not your team.
+
+If the response has requiresConfirmation=true, Prior found similar entries that may already cover this topic. Review them — if they solve the problem, don't re-contribute. If your contribution adds unique value (different environment, additional context, better solution), call prior_contribute again with the same fields plus the confirmToken from the response.`,
         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"),
@@ -268,14 +279,19 @@ Before submitting, read prior://docs/contributing for field guidance. Scrub PII
                 toolCalls: zod_1.z.number().optional(),
             }).optional().describe("Effort spent discovering this solution"),
             ttl: zod_1.z.string().optional().describe("Time to live: 30d, 60d, 90d (default), 365d, evergreen"),
+            confirmToken: zod_1.z.string().optional().describe("Token from a previous near-duplicate response. Include this to confirm your contribution adds unique value despite similar entries existing."),
         },
         outputSchema: {
-            id: zod_1.z.string().describe("Short ID of the new entry"),
-            status: zod_1.z.string().describe("Entry status (active or pending)"),
+            id: zod_1.z.string().describe("Short ID of the new entry (empty if requiresConfirmation)"),
+            status: zod_1.z.string().describe("Entry status: active, pending, or near_duplicate"),
             creditsEarned: zod_1.z.number().optional(),
+            requiresConfirmation: zod_1.z.boolean().optional().describe("If true, similar entries exist. Review them and re-submit with confirmToken."),
+            confirmToken: zod_1.z.string().optional().describe("Token to include in re-submission to confirm contribution"),
         },
-    }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
+    }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl, confirmToken }) => {
         const body = { title, content, tags: tags || [], model: model || "unknown" };
+        if (confirmToken)
+            body.confirmToken = confirmToken;
         if (problem)
             body.problem = problem;
         if (solution)
@@ -292,6 +308,20 @@ Before submitting, read prior://docs/contributing for field guidance. Scrub PII
             body.ttl = ttl;
         const data = await client.request("POST", "/v1/knowledge/contribute", body);
         const entry = data?.data || data;
+        // Handle near-duplicate soft band response
+        if (entry?.requiresConfirmation || entry?.status === "near_duplicate") {
+            const dupes = entry.nearDuplicates || [];
+            const dupeList = dupes.map((d) => `  - ${d.shortId}: "${d.title}" (${Math.round(d.similarity * 100)}% similar)`).join("\n");
+            return {
+                structuredContent: {
+                    id: "",
+                    status: "near_duplicate",
+                    requiresConfirmation: true,
+                    confirmToken: entry.confirmToken,
+                },
+                content: [{ type: "text", text: `Similar entries already exist in Prior:\n${dupeList}\n\nReview these entries — if they already solve the problem, no need to contribute. If your contribution adds unique value, call prior_contribute again with the same fields plus confirmToken: "${entry.confirmToken}"` }],
+            };
+        }
         return {
             structuredContent: {
                 id: entry?.id || entry?.shortId || "",

package/package.json

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