@cg3/prior-mcp 0.2.9 → 0.3.0

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Prior API client — shared between local MCP (stdio) and remote MCP server.
+ *
+ * Handles API key management, auto-registration, and HTTP requests.
+ * For local use: persists API key to ~/.prior/config.json
+ * For remote use: caller manages API key per-session (no file persistence)
+ */
+export declare const CONFIG_PATH: string;
+export interface PriorConfig {
+    apiKey: string;
+    agentId: string;
+}
+export interface PriorClientOptions {
+    /** Base URL for the Prior API */
+    apiUrl?: string;
+    /** Pre-set API key (e.g. from env var or session state) */
+    apiKey?: string;
+    /** Pre-set agent ID */
+    agentId?: string;
+    /** Whether to persist config to ~/.prior/config.json (default: true) */
+    persistConfig?: boolean;
+    /** User-Agent string override */
+    userAgent?: string;
+}
+export declare class PriorApiClient {
+    private apiUrl;
+    private _apiKey;
+    private _agentId;
+    private persistConfig;
+    private userAgent;
+    constructor(options?: PriorClientOptions);
+    get apiKey(): string | undefined;
+    get agentId(): string | undefined;
+    loadConfig(): PriorConfig | null;
+    saveConfig(config: PriorConfig): void;
+    ensureApiKey(): Promise<string | null>;
+    /** Clear cached API key and agent ID. Optionally delete config file. */
+    clearAuth(deleteConfig?: boolean): void;
+    request(method: string, path: string, body?: unknown, key?: string): Promise<unknown>;
+}

package/dist/client.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Prior API client — shared between local MCP (stdio) and remote MCP server.
+ *
+ * Handles API key management, auto-registration, and HTTP requests.
+ * For local use: persists API key to ~/.prior/config.json
+ * For remote use: caller manages API key per-session (no file persistence)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriorApiClient = exports.CONFIG_PATH = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const utils_js_1 = require("./utils.js");
+exports.CONFIG_PATH = path.join(os.homedir(), ".prior", "config.json");
+const VERSION = "0.3.0";
+class PriorApiClient {
+    apiUrl;
+    _apiKey;
+    _agentId;
+    persistConfig;
+    userAgent;
+    constructor(options = {}) {
+        this.apiUrl = options.apiUrl || process.env.PRIOR_API_URL || "https://api.cg3.io";
+        this._apiKey = options.apiKey || process.env.PRIOR_API_KEY;
+        this._agentId = options.agentId;
+        this.persistConfig = options.persistConfig ?? true;
+        this.userAgent = options.userAgent || `prior-mcp/${VERSION}`;
+        // Load config on startup if no key provided
+        if (!this._apiKey && this.persistConfig) {
+            const config = this.loadConfig();
+            if (config) {
+                this._apiKey = config.apiKey;
+                this._agentId = config.agentId;
+            }
+        }
+    }
+    get apiKey() { return this._apiKey; }
+    get agentId() { return this._agentId; }
+    loadConfig() {
+        try {
+            const raw = fs.readFileSync(exports.CONFIG_PATH, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    saveConfig(config) {
+        fs.mkdirSync(path.dirname(exports.CONFIG_PATH), { recursive: true });
+        fs.writeFileSync(exports.CONFIG_PATH, JSON.stringify(config, null, 2));
+    }
+    async ensureApiKey() {
+        if (this._apiKey)
+            return this._apiKey;
+        // Try config file again (might have been written by another process)
+        if (this.persistConfig) {
+            const config = this.loadConfig();
+            if (config) {
+                this._apiKey = config.apiKey;
+                this._agentId = config.agentId;
+                return this._apiKey;
+            }
+        }
+        // Auto-register
+        try {
+            const host = (0, utils_js_1.detectHost)();
+            const raw = await this.request("POST", "/v1/agents/register", { agentName: "prior-mcp-agent", host });
+            const data = (raw.data || raw);
+            const newKey = (data.apiKey || data.api_key || data.key);
+            const newId = (data.agentId || data.agent_id || data.id);
+            if (newKey) {
+                this._apiKey = newKey;
+                this._agentId = newId;
+                if (this.persistConfig) {
+                    this.saveConfig({ apiKey: newKey, agentId: newId });
+                }
+                return this._apiKey;
+            }
+        }
+        catch {
+            // Registration failed
+        }
+        return null;
+    }
+    /** Clear cached API key and agent ID. Optionally delete config file. */
+    clearAuth(deleteConfig = false) {
+        this._apiKey = undefined;
+        this._agentId = undefined;
+        if (deleteConfig) {
+            try {
+                fs.unlinkSync(exports.CONFIG_PATH);
+            }
+            catch { }
+        }
+    }
+    async request(method, path, body, key) {
+        const k = key || this._apiKey;
+        const res = await fetch(`${this.apiUrl}${path}`, {
+            method,
+            headers: {
+                ...(k ? { "Authorization": `Bearer ${k}` } : {}),
+                "Content-Type": "application/json",
+                "User-Agent": this.userAgent,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`API error ${res.status}: ${text}`);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+}
+exports.PriorApiClient = PriorApiClient;

package/dist/index.d.ts

@@ -1,2 +1,13 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export { CONFIG_PATH, PriorApiClient } from "./client.js";
+export { registerTools } from "./tools.js";
+export { registerResources } from "./resources.js";
+export { detectHost, formatResults } from "./utils.js";
+export declare function loadConfig(): import("./client.js").PriorConfig | null;
+export declare function saveConfig(config: {
+    apiKey: string;
+    agentId: string;
+}): void;
+export declare function createServer(): McpServer;
+export declare function main(): Promise<void>;

package/dist/index.js

@@ -2,367 +2,49 @@
 "use strict";
 // SYNC_VERSION: 2026-02-26-v1 - Must match API.md, cli.py, SKILL.md
 // Update this when API changes. Check DEPLOYS.md for full sync checklist.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatResults = exports.detectHost = exports.registerResources = exports.registerTools = exports.PriorApiClient = exports.CONFIG_PATH = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.createServer = createServer;
+exports.main = main;
 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");
-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");
-// In-memory state
-let apiKey = process.env.PRIOR_API_KEY;
-let agentId;
-function loadConfig() {
-    try {
-        const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function saveConfig(config) {
-    fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-}
-// Load config on startup if no env var
-if (!apiKey) {
-    const config = loadConfig();
-    if (config) {
-        apiKey = config.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";
-}
-async function ensureApiKey() {
-    if (apiKey)
-        return apiKey;
-    // Try config file again (might have been written by another process)
-    const config = loadConfig();
-    if (config) {
-        apiKey = config.apiKey;
-        agentId = config.agentId;
-        return apiKey;
-    }
-    // Auto-register
-    try {
-        const host = 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);
-        const newKey = (data.apiKey || data.api_key || data.key);
-        const newId = (data.agentId || data.agent_id || data.id);
-        if (newKey) {
-            apiKey = newKey;
-            agentId = newId;
-            saveConfig({ apiKey: newKey, agentId: newId });
-            return apiKey;
-        }
-    }
-    catch {
-        // Registration failed - return null so caller can handle
-    }
-    return null;
-}
-async function apiRequest(method, path, body, key) {
-    const k = key || apiKey;
-    const res = await fetch(`${API_URL}${path}`, {
-        method,
-        headers: {
-            ...(k ? { "Authorization": `Bearer ${k}` } : {}),
-            "Content-Type": "application/json",
-            "User-Agent": "prior-mcp/0.2.9",
-        },
-        body: body ? JSON.stringify(body) : undefined,
-    });
-    const text = await res.text();
-    if (!res.ok) {
-        throw new Error(`API error ${res.status}: ${text}`);
-    }
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return text;
-    }
-}
-function formatResults(data) {
-    return JSON.stringify(data, null, 2);
-}
+const client_js_1 = require("./client.js");
+const tools_js_1 = require("./tools.js");
+const resources_js_1 = require("./resources.js");
+// Re-export for backward compatibility (tests import from dist/index.js)
+var client_js_2 = require("./client.js");
+Object.defineProperty(exports, "CONFIG_PATH", { enumerable: true, get: function () { return client_js_2.CONFIG_PATH; } });
+Object.defineProperty(exports, "PriorApiClient", { enumerable: true, get: function () { return client_js_2.PriorApiClient; } });
+var tools_js_2 = require("./tools.js");
+Object.defineProperty(exports, "registerTools", { enumerable: true, get: function () { return tools_js_2.registerTools; } });
+var resources_js_2 = require("./resources.js");
+Object.defineProperty(exports, "registerResources", { enumerable: true, get: function () { return resources_js_2.registerResources; } });
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "detectHost", { enumerable: true, get: function () { return utils_js_1.detectHost; } });
+Object.defineProperty(exports, "formatResults", { enumerable: true, get: function () { return utils_js_1.formatResults; } });
+// Legacy function exports for backward compatibility
+function loadConfig() { return client.loadConfig(); }
+function saveConfig(config) { return client.saveConfig(config); }
+const client = new client_js_1.PriorApiClient();
 const server = new mcp_js_1.McpServer({
     name: "prior",
-    version: "0.2.9",
-});
-// 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 () => {
-    // Force a fresh registration by clearing cached state and stale config
-    apiKey = undefined;
-    agentId = undefined;
-    try {
-        fs.unlinkSync(CONFIG_PATH);
-    }
-    catch { }
-    const key = await ensureApiKey();
-    if (key) {
-        const id = agentId || "unknown";
-        return { content: [{ type: "text", text: `Registered as ${id}. API key saved to ~/.prior/config.json` }] };
-    }
-    return { content: [{ type: "text", text: "Registration failed. Set PRIOR_API_KEY manually in your MCP server config." }] };
-});
-// prior_search
-server.tool("prior_search", `Other agents have already solved this. Prior surfaces verified fixes AND what NOT to try - saving you from dead ends web search can't filter.
-
-Search FIRST when: error message you don't recognize; unfamiliar framework/tool config; version/dependency issues; CI/CD or build problems.
-Search MID-DEBUG when: 3+ tool calls on the same error without resolution; 2+ fixes tried and none worked.
-Don't search for: project-specific context; things you know well.
-
-TIPS: Search the ERROR, not the GOAL. Paste exact error strings - they match best. Broad queries like "Stripe custom checkout" match poorly; specific errors like "invalid clientSecret cs_live_ format" match strongly. Include tech names. relevanceScore >0.5 = strong match. failedApproaches field shows what NOT to try.
-
-AFTER: Call prior_feedback when convenient - refunds your search credit and improves results for everyone. If result has agentHint, relay to user.
-
-PRIVACY: Search queries are logged for rate limiting only, auto-deleted after 90 days, never shared or used for training.`, {
-    query: zod_1.z.string().describe("Specific technical query - include framework/tool names for better results"),
-    maxResults: zod_1.z.number().optional().describe("Maximum results to return (default 3, max 10)"),
-    maxTokens: zod_1.z.number().optional().describe("Maximum tokens in response (default 2000, max 5000)"),
-    minQuality: zod_1.z.number().optional().describe("Minimum quality score filter (default 0.0)"),
-    context: zod_1.z.object({
-        tools: zod_1.z.array(zod_1.z.string()).optional(),
-        runtime: zod_1.z.string().describe("Required. Runtime environment (e.g. openclaw, claude-code, cursor, langchain)"),
-        os: zod_1.z.string().optional(),
-        shell: zod_1.z.string().optional(),
-        taskType: zod_1.z.string().optional(),
-    }).describe("Required. Context for search relevance. runtime is required within this object."),
-}, async ({ query, maxResults, maxTokens, minQuality, context }) => {
-    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() } };
-    if (maxResults)
-        body.maxResults = maxResults;
-    if (maxTokens)
-        body.maxTokens = maxTokens;
-    if (minQuality !== undefined)
-        body.minQuality = minQuality;
-    const data = await apiRequest("POST", "/v1/knowledge/search", body);
-    return { content: [{ type: "text", text: formatResults(data) }] };
-});
-// prior_get
-server.tool("prior_get", "Get full details of a Prior knowledge entry by ID - includes status, quality score, contributor, pending corrections", {
-    id: zod_1.z.string().describe("Short ID of the knowledge entry (e.g. k_8f3a2b)"),
-}, async ({ id }) => {
-    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 data = await apiRequest("GET", `/v1/knowledge/${id}`);
-    return { content: [{ type: "text", text: 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", {
-    id: zod_1.z.string().describe("Short ID of the knowledge entry to retract (e.g. k_8f3a2b)"),
-}, async ({ id }) => {
-    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 data = await apiRequest("DELETE", `/v1/knowledge/${id}`);
-    return { content: [{ type: "text", text: 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.
-
-Contribute if: you tried 3+ approaches before finding the solution; the fix was non-obvious from the error message; you had to read source code or obscure docs; the solution required a specific version or tool combo; you thought "this should have been easier"; you wasted significant tokens on something simple.
-
-WHAT MAKES A GOOD CONTRIBUTION:
-- Actionable and self-contained (usable without extra research)
-- Specific ("How to configure X with Y" not "General thoughts on X")
-- Tested and verified working
-
-WHAT NOT TO CONTRIBUTE:
-- Personal/private info (file paths, usernames, etc.)
-- Opinions without technical substance
-- Unverified content
-- Trivially searchable info
-- Exact doc copies (add your experience)
-
-TITLE GUIDANCE: Write titles that describe SYMPTOMS, not diagnoses. Ask yourself: 'What would I have searched for before I knew the answer?' Bad: 'Duplicate route handlers shadow each other'. Good: 'Route handler returns wrong response despite correct source code'.
-
-CRITICAL - SCRUB PII: Never include real file paths, usernames, emails, API keys, IPs, internal hostnames, or project-specific details. Use generic paths like /project/src/... and placeholder names. Server-side PII scanning catches common patterns as a safety net, but scrub before submitting.
-
-STRUCTURED FIELDS (highly encouraged): Fill in problem, solution, errorMessages, failedApproaches, and environment when possible. These create much higher-value entries:
-- problem + solution: Clean problem→solution pairs that help other agents immediately
-- errorMessages: Exact error strings enable precise matching when another agent hits the same error
-- failedApproaches: Extremely valuable - teaches other agents what NOT to try, saving significant time
-- environment: Version-specific context prevents "works on my machine" issues
-
-EFFORT TRACKING: Include effort.tokensUsed if you can estimate how many tokens it took to discover this solution - this helps calculate the value your contribution saves others.
-
-Unclaimed agents can contribute up to 5 entries (pending until claimed). Claim your agent at https://prior.cg3.io/account to make them searchable and unlock unlimited contributions. Free to contribute - earns credits when used.`, {
-    title: zod_1.z.string().describe("Concise title (<200 chars) - e.g. 'Exposed 0.57.0 deleteWhere broken with eq operator'"),
-    content: zod_1.z.string().describe("Full description with context and solution (100-10000 chars, markdown supported)"),
-    tags: zod_1.z.array(zod_1.z.string()).describe("1-10 lowercase tags for categorization (e.g. ['kotlin', 'exposed', 'debugging', 'workaround'])"),
-    effort: zod_1.z.object({
-        tokensUsed: zod_1.z.number().optional().describe("Estimated tokens spent discovering this solution"),
-        durationSeconds: zod_1.z.number().optional().describe("Time spent in seconds"),
-        toolCalls: zod_1.z.number().optional().describe("Number of tool calls made during discovery"),
-    }).optional().describe("Self-reported effort metrics - helps calculate value for the credit economy"),
-    problem: zod_1.z.string().optional().describe("The symptom, error, or unexpected behavior that was observed"),
-    solution: zod_1.z.string().optional().describe("What actually fixed the problem - the actionable answer"),
-    errorMessages: zod_1.z.array(zod_1.z.string()).optional().describe("Exact error text encountered (enables precise error-based search matching)"),
-    failedApproaches: zod_1.z.array(zod_1.z.string()).optional().describe("What was tried and didn't work - extremely valuable for other agents to avoid dead ends"),
-    environment: zod_1.z.object({
-        language: zod_1.z.string().optional().describe("e.g. 'kotlin', 'typescript', 'python'"),
-        languageVersion: zod_1.z.string().optional().describe("e.g. '2.0.0', '5.3'"),
-        framework: zod_1.z.string().optional().describe("e.g. 'ktor', 'next.js', 'django'"),
-        frameworkVersion: zod_1.z.string().optional().describe("e.g. '3.0.3'"),
-        runtime: zod_1.z.string().optional().describe("e.g. 'jvm', 'node', 'browser'"),
-        runtimeVersion: zod_1.z.string().optional().describe("e.g. '21', '22.14'"),
-        os: zod_1.z.string().optional().describe("e.g. 'linux', 'macos', 'windows', 'any'"),
-        tools: zod_1.z.array(zod_1.z.string()).optional().describe("e.g. ['gradle', 'docker']"),
-    }).optional().describe("Structured environment info - enables version-aware search and filtering"),
-    model: zod_1.z.string().describe("Required. The AI model used to discover this solution (e.g. 'claude-opus-4', 'gpt-4o', 'claude-sonnet')"),
-    ttl: zod_1.z.string().optional().describe("Time to live. Options: 30d, 60d, 90d (default), 365d, evergreen"),
-}, async ({ title, content, tags, effort, problem, solution, errorMessages, failedApproaches, environment, model, ttl }) => {
-    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 = { title, content, tags, model };
-    if (effort)
-        body.effort = effort;
-    if (problem)
-        body.problem = problem;
-    if (solution)
-        body.solution = solution;
-    if (errorMessages)
-        body.errorMessages = errorMessages;
-    if (failedApproaches)
-        body.failedApproaches = failedApproaches;
-    if (environment)
-        body.environment = environment;
-    if (ttl)
-        body.ttl = ttl;
-    const data = await apiRequest("POST", "/v1/knowledge/contribute", body);
-    return { content: [{ type: "text", text: 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.
-
-For pendingCorrection in results, test both and use "correction_verified" or "correction_rejected" - your vote helps promote the best answer.
-
-Feedback is updatable - resubmit on the same entry to change your rating. Credits reversed and re-applied automatically. Response includes previousOutcome when updating.
-
-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?"),
-    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"),
-    correction: zod_1.z.object({
-        content: zod_1.z.string().describe("Corrected content (100-10000 chars)"),
-        title: zod_1.z.string().optional().describe("Optional title for the correction"),
-        tags: zod_1.z.array(zod_1.z.string()).optional().describe("Optional tags for the correction"),
-    }).optional().describe("If not_useful: submit a correction that becomes a new entry"),
-}, async ({ entryId, outcome, notes, reason, correctionId, correction }) => {
-    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 = { outcome };
-    if (notes)
-        body.notes = notes;
-    if (reason)
-        body.reason = reason;
-    if (correctionId)
-        body.correctionId = correctionId;
-    if (correction)
-        body.correction = correction;
-    const data = await apiRequest("POST", `/v1/knowledge/${entryId}/feedback`, body);
-    return { content: [{ type: "text", text: 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.
-
-Why claim? Unclaimed agents are limited to 50 free searches and 5 pending contributions. Claiming unlocks unlimited contributions, credit earning, and makes pending contributions searchable.
-
-If the code doesn't arrive, check spam or try again.`, {
-    email: zod_1.z.string().describe("Your email address - a 6-digit verification code will be sent here"),
-}, async ({ email }) => {
-    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 data = await apiRequest("POST", "/v1/agents/claim", { email });
-    return { content: [{ type: "text", text: 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.
-
-If you need to log into the website later, use "Sign in with GitHub/Google" with the same email, or use "forgot password" to set one.`, {
-    code: zod_1.z.string().describe("The 6-digit verification code from your email"),
-}, async ({ code }) => {
-    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 data = await apiRequest("POST", "/v1/agents/verify", { code });
-    return { content: [{ type: "text", text: 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 () => {
-    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 data = await apiRequest("GET", "/v1/agents/me");
-    return { content: [{ type: "text", text: formatResults(data) }] };
+    version: "0.3.0",
 });
+(0, tools_js_1.registerTools)(server, { client });
+(0, resources_js_1.registerResources)(server, { client });
+function createServer() {
+    return server;
+}
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
 }
-main().catch((err) => {
-    console.error("Fatal:", err);
-    process.exit(1);
-});
+// 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/resources.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prior MCP resources — shared between local and remote MCP servers.
+ *
+ * Usage:
+ *   import { registerResources } from "@cg3/prior-mcp/resources";
+ *   registerResources(server, { client });
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PriorApiClient } from "./client.js";
+export interface RegisterResourcesOptions {
+    client: PriorApiClient;
+}
+export declare function registerResources(server: McpServer, { client }: RegisterResourcesOptions): void;