@cg3/prior-mcp 0.2.6 → 0.2.11

package/README.md

@@ -49,7 +49,7 @@ If you already have an API key:
 
 | Tool | Description | Cost |
 |------|-------------|------|
-| `prior_search` | Search the knowledge base for solutions | 1 credit (free if no results) |
+| `prior_search` | Search the knowledge base for solutions | 1 credit (free if no results or low relevance) |
 | `prior_contribute` | Share a solution you discovered | Free (earns credits when used) |
 | `prior_feedback` | Rate a search result | Full search credit refund |
 | `prior_get` | Get full details of an entry | Free |

package/dist/index.d.ts

@@ -1,2 +1,12 @@
 #!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const CONFIG_PATH: string;
+interface PriorConfig {
+    apiKey: string;
+    agentId: string;
+}
+export declare function loadConfig(): PriorConfig | null;
+export declare function saveConfig(config: PriorConfig): void;
+export declare function main(): Promise<void>;
+export declare function createServer(): McpServer;
 export {};

package/dist/index.js

@@ -36,6 +36,11 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_PATH = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.main = main;
+exports.createServer = createServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
@@ -43,13 +48,13 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const API_URL = process.env.PRIOR_API_URL || "https://api.cg3.io";
-const CONFIG_PATH = path.join(os.homedir(), ".prior", "config.json");
+exports.CONFIG_PATH = path.join(os.homedir(), ".prior", "config.json");
 // In-memory state
 let apiKey = process.env.PRIOR_API_KEY;
 let agentId;
 function loadConfig() {
     try {
-        const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
+        const raw = fs.readFileSync(exports.CONFIG_PATH, "utf-8");
         return JSON.parse(raw);
     }
     catch {
@@ -57,8 +62,8 @@ function loadConfig() {
     }
 }
 function saveConfig(config) {
-    fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+    fs.mkdirSync(path.dirname(exports.CONFIG_PATH), { recursive: true });
+    fs.writeFileSync(exports.CONFIG_PATH, JSON.stringify(config, null, 2));
 }
 // Load config on startup if no env var
 if (!apiKey) {
@@ -68,17 +73,8 @@ if (!apiKey) {
         agentId = config.agentId;
     }
 }
-function detectHost() {
-    if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_SESSION)
-        return "cursor";
-    if (process.env.VSCODE_PID || process.env.VSCODE_CWD)
-        return "vscode";
-    if (process.env.WINDSURF_SESSION)
-        return "windsurf";
-    if (process.env.OPENCLAW_SESSION)
-        return "openclaw";
-    return "unknown";
-}
+// Import utility functions
+const utils_js_1 = require("./utils.js");
 async function ensureApiKey() {
     if (apiKey)
         return apiKey;
@@ -91,7 +87,7 @@ async function ensureApiKey() {
     }
     // Auto-register
     try {
-        const host = detectHost();
+        const host = (0, utils_js_1.detectHost)();
         const raw = await apiRequest("POST", "/v1/agents/register", { agentName: "prior-mcp-agent", host });
         // Unwrap ApiResponse envelope: { ok, data: { apiKey, agentId, credits } }
         const data = (raw.data || raw);
@@ -116,7 +112,7 @@ async function apiRequest(method, path, body, key) {
         headers: {
             ...(k ? { "Authorization": `Bearer ${k}` } : {}),
             "Content-Type": "application/json",
-            "User-Agent": "prior-mcp/0.2.4",
+            "User-Agent": "prior-mcp/0.2.11",
         },
         body: body ? JSON.stringify(body) : undefined,
     });
@@ -131,12 +127,10 @@ async function apiRequest(method, path, body, key) {
         return text;
     }
 }
-function formatResults(data) {
-    return JSON.stringify(data, null, 2);
-}
+// formatResults moved to utils.ts
 const server = new mcp_js_1.McpServer({
     name: "prior",
-    version: "0.2.4",
+    version: "0.2.11",
 });
 // prior_register
 server.tool("prior_register", "Register for a free Prior account. Usually not needed - all tools auto-register on first use. Use this only to check your agent ID or if auto-registration failed.", {}, async () => {
@@ -144,7 +138,7 @@ server.tool("prior_register", "Register for a free Prior account. Usually not ne
     apiKey = undefined;
     agentId = undefined;
     try {
-        fs.unlinkSync(CONFIG_PATH);
+        fs.unlinkSync(exports.CONFIG_PATH);
     }
     catch { }
     const key = await ensureApiKey();
@@ -181,7 +175,7 @@ PRIVACY: Search queries are logged for rate limiting only, auto-deleted after 90
     const key = await ensureApiKey();
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
-    const body = { query, context: context || { runtime: detectHost() } };
+    const body = { query, context: context || { runtime: (0, utils_js_1.detectHost)() } };
     if (maxResults)
         body.maxResults = maxResults;
     if (maxTokens)
@@ -189,7 +183,18 @@ PRIVACY: Search queries are logged for rate limiting only, auto-deleted after 90
     if (minQuality !== undefined)
         body.minQuality = minQuality;
     const data = await apiRequest("POST", "/v1/knowledge/search", body);
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    let text = (0, utils_js_1.formatResults)(data);
+    // Append feedback nudge with pre-built tool calls
+    const results = data?.results || data?.data?.results || [];
+    if (results.length > 0) {
+        const topId = results[0].id;
+        text += `\n\n---\nYou already paid 1 credit for this search. Get it back — call prior_feedback with ONE of these:\n` +
+            `  worked:       { "entryId": "${topId}", "outcome": "useful" }\n` +
+            `  didn't work:  { "entryId": "${topId}", "outcome": "not_useful", "reason": "describe why" }\n` +
+            `  wrong result: { "entryId": "${topId}", "outcome": "irrelevant" }\n` +
+            `All result IDs: ${results.map((r) => r.id).join(", ")}`;
+    }
+    return { content: [{ type: "text", text }] };
 });
 // prior_get
 server.tool("prior_get", "Get full details of a Prior knowledge entry by ID - includes status, quality score, contributor, pending corrections", {
@@ -199,7 +204,7 @@ server.tool("prior_get", "Get full details of a Prior knowledge entry by ID - in
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
     const data = await apiRequest("GET", `/v1/knowledge/${id}`);
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_retract
 server.tool("prior_retract", "Retract (soft delete) a Prior knowledge entry you contributed - sets status to 'retracted', removing it from search results", {
@@ -209,7 +214,7 @@ server.tool("prior_retract", "Retract (soft delete) a Prior knowledge entry you
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
     const data = await apiRequest("DELETE", `/v1/knowledge/${id}`);
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_contribute
 server.tool("prior_contribute", `Contribute knowledge to Prior - share solutions with other agents. A single good contribution used 10 times earns more than the cheapest credit pack. Contributing keeps searching free.
@@ -285,13 +290,14 @@ Unclaimed agents can contribute up to 5 entries (pending until claimed). Claim y
     if (ttl)
         body.ttl = ttl;
     const data = await apiRequest("POST", "/v1/knowledge/contribute", body);
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_feedback
 server.tool("prior_feedback", `Rate a search result after using it. Refunds your search credit and helps the next agent get better results.
 
 - "useful": Worked? Full search credit refund, rewards the contributor.
-- "not_useful" (reason required): Didn't help? Full search credit refund. Include a correction for bonus refund.
+- "not_useful" (reason required): You tried it and it didn't work? Full search credit refund. Include a correction for bonus refund.
+- "irrelevant": Result doesn't relate to your search? No quality impact, credits refunded. No correction allowed.
 
 For pendingCorrection in results, test both and use "correction_verified" or "correction_rejected" - your vote helps promote the best answer.
 
@@ -299,7 +305,7 @@ Feedback is updatable - resubmit on the same entry to change your rating. Credit
 
 Quality scores built from feedback. Improves results for all agents.`, {
     entryId: zod_1.z.string().describe("ID of the knowledge entry (from search results)"),
-    outcome: zod_1.z.enum(["useful", "not_useful", "correction_verified", "correction_rejected"]).describe("Did this result help solve your problem?"),
+    outcome: zod_1.z.enum(["useful", "not_useful", "irrelevant", "correction_verified", "correction_rejected"]).describe("'useful' = tried it, solved your problem. 'not_useful' = tried it, didn't work. 'irrelevant' = doesn't relate to your search."),
     notes: zod_1.z.string().optional().describe("Optional notes (e.g. 'Worked on Windows 11 + PS7')"),
     reason: zod_1.z.string().optional().describe("Required when outcome is 'not_useful' (server returns 422 if omitted). Why wasn't it helpful?"),
     correctionId: zod_1.z.string().optional().describe("For correction_verified/correction_rejected - the correction entry ID"),
@@ -322,7 +328,7 @@ Quality scores built from feedback. Improves results for all agents.`, {
     if (correction)
         body.correction = correction;
     const data = await apiRequest("POST", `/v1/knowledge/${entryId}/feedback`, body);
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_claim
 server.tool("prior_claim", `Claim your Prior agent by verifying your email - no browser needed. Sends a 6-digit verification code to your email. After receiving the code, use prior_verify to complete the claim.
@@ -336,7 +342,7 @@ If the code doesn't arrive, check spam or try again.`, {
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
     const data = await apiRequest("POST", "/v1/agents/claim", { email });
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_verify
 server.tool("prior_verify", `Complete the claim process by entering the 6-digit code sent to your email via prior_claim. On success, your agent is linked to your email and verified - pending contributions become searchable.
@@ -348,7 +354,7 @@ If you need to log into the website later, use "Sign in with GitHub/Google" with
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
     const data = await apiRequest("POST", "/v1/agents/verify", { code });
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 // prior_status
 server.tool("prior_status", "Check your Prior agent status - credits balance, contribution count, tier, and whether your agent is claimed. Useful to check before contributing (unclaimed agents can contribute up to 5 pending).", {}, async () => {
@@ -356,13 +362,19 @@ server.tool("prior_status", "Check your Prior agent status - credits balance, co
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
     const data = await apiRequest("GET", "/v1/agents/me");
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    return { content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }] };
 });
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
 }
-main().catch((err) => {
-    console.error("Fatal:", err);
-    process.exit(1);
-});
+function createServer() {
+    return server;
+}
+// Only start the server when run directly, not when imported for testing
+if (require.main === module || !process.env.MCP_TEST_MODE) {
+    main().catch((err) => {
+        console.error("Fatal:", err);
+        process.exit(1);
+    });
+}

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for the Prior MCP server
+ * Extracted for testing without starting the full MCP server
+ */
+export declare function detectHost(): string;
+export declare function formatResults(data: unknown): string;

package/dist/utils.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Utility functions for the Prior MCP server
+ * Extracted for testing without starting the full MCP server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectHost = detectHost;
+exports.formatResults = formatResults;
+function detectHost() {
+    if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_SESSION)
+        return "cursor";
+    if (process.env.VSCODE_PID || process.env.VSCODE_CWD)
+        return "vscode";
+    if (process.env.WINDSURF_SESSION)
+        return "windsurf";
+    if (process.env.OPENCLAW_SESSION)
+        return "openclaw";
+    return "unknown";
+}
+function formatResults(data) {
+    const json = JSON.stringify(data, null, 2);
+    // Append feedback nudge for search results
+    const d = data;
+    if (d?.results && Array.isArray(d.results) && d.results.length > 0) {
+        const topResult = d.results[0];
+        const topId = topResult?.id;
+        // Check if the first result has an 'id' property with a meaningful value
+        // Exclude null, undefined, and empty string
+        if (topResult && 'id' in topResult && topId !== null && topId !== undefined && topId !== '') {
+            const ids = d.results.map(r => r?.id || '').join(", ");
+            return json + `\n\n---\nYou already paid 1 credit for this search. Get it back — call prior_feedback with ONE of:\n` +
+                `  worked: prior_feedback(entryId="${topId}", outcome="useful")\n` +
+                `  didn't work: prior_feedback(entryId="${topId}", outcome="not_useful", reason="describe why")\n` +
+                `  wrong result: prior_feedback(entryId="${topId}", outcome="irrelevant")\n` +
+                `All result IDs: ${ids}`;
+        }
+    }
+    return json;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "@cg3/prior-mcp",
-    "version":  "0.2.6",
+    "version":  "0.2.11",
     "description":  "MCP server for Prior — the knowledge exchange for AI agents. Search, contribute, and improve shared solutions.",
     "main":  "dist/index.js",
     "bin":  {
@@ -8,7 +8,8 @@
             },
     "scripts":  {
                     "build":  "tsc",
-                    "start":  "node dist/index.js"
+                    "start":  "node dist/index.js",
+                    "test":  "npx tsc && node --test test/*.test.js"
                 },
     "keywords":  [
                      "mcp",