@cg3/prior-mcp 0.3.1 → 0.4.0

package/dist/client.d.ts

@@ -1,9 +1,8 @@
 /**
  * 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)
+ * Requires an API key via PRIOR_API_KEY env var or ~/.prior/config.json.
+ * Get your key at https://prior.cg3.io/account
  */
 export declare const CONFIG_PATH: string;
 export interface PriorConfig {
@@ -33,8 +32,5 @@ export declare class PriorApiClient {
     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

@@ -2,9 +2,8 @@
 /**
  * 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)
+ * Requires an API key via PRIOR_API_KEY env var or ~/.prior/config.json.
+ * Get your key at https://prior.cg3.io/account
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -44,9 +43,8 @@ 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.1";
+const VERSION = "0.4.0";
 class PriorApiClient {
     apiUrl;
     _apiKey;
@@ -67,6 +65,12 @@ class PriorApiClient {
                 this._agentId = config.agentId;
             }
         }
+        // Require an API key — no more auto-registration
+        if (!this._apiKey) {
+            throw new Error("No Prior API key configured. " +
+                "Get your key at https://prior.cg3.io/account and set the PRIOR_API_KEY environment variable, " +
+                "or add it to ~/.prior/config.json. See prior://docs/api-keys for setup instructions.");
+        }
     }
     get apiKey() { return this._apiKey; }
     get agentId() { return this._agentId; }
@@ -83,50 +87,6 @@ class PriorApiClient {
         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}`, {

package/dist/index.js

@@ -30,7 +30,7 @@ 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.3.1",
+    version: "0.4.0",
 });
 (0, tools_js_1.registerTools)(server, { client });
 (0, resources_js_1.registerResources)(server, { client });

package/dist/resources.js

@@ -15,11 +15,6 @@ function registerResources(server, { client }) {
         mimeType: "application/json",
         annotations: { audience: ["assistant"], priority: 0.4 },
     }, async () => {
-        const key = await client.ensureApiKey();
-        if (!key) {
-            return { contents: [{ uri: "prior://agent/status", mimeType: "application/json",
-                        text: JSON.stringify({ error: "Not registered. Set PRIOR_API_KEY." }) }] };
-        }
         try {
             const data = await client.request("GET", "/v1/agents/me");
             const agent = data?.data || data;
@@ -144,7 +139,7 @@ Include \`effort.tokensUsed\` if you can estimate tokens spent. Helps calculate
 const API_KEYS_GUIDE = `# Prior API Key Setup
 
 ## Quick Start
-Prior auto-registers and saves your key to \`~/.prior/config.json\` on first use. Usually no setup needed.
+Get your API key at https://prior.cg3.io/account, then configure it below.
 
 ## Environment Variable (overrides config file)
 \`\`\`bash
@@ -218,28 +213,12 @@ Without claiming:
 
 After claiming: unlimited contributions, credits earned when others use your entries.
 
-## How to Claim (two-step, no browser needed)
-
-**Step 1:** Call \`prior_claim\` with your email
-\`\`\`
-prior_claim({ email: "you@example.com" })
-\`\`\`
-
-**Step 2:** Check email for code, then call again:
-\`\`\`
-prior_claim({ email: "you@example.com", code: "123456" })
-\`\`\`
-
-Done — your agent is claimed and verified.
-
-## Code Not Arriving?
-- Check spam/junk folder
-- Wait 2 minutes, try again
-- Verify email address is correct
+## How to Claim
+Visit https://prior.cg3.io/account to claim your agent and verify your email.
 
 ## Website Access
-After claiming: https://prior.cg3.io/account
-- Sign in with GitHub or Google (same email)
+https://prior.cg3.io/account
+- Sign in with GitHub or Google
 - Or set a password via "forgot password"
 `;
 const AGENT_GUIDE = `# Prior — Complete Agent Guide

package/dist/tools.d.ts

@@ -3,7 +3,7 @@
  *
  * Usage:
  *   import { registerTools } from "@cg3/prior-mcp/tools";
- *   const server = new McpServer({ name: "prior", version: "0.3.1" });
+ *   const server = new McpServer({ name: "prior", version: "0.4.0" });
  *   registerTools(server, { client });
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -11,4 +11,8 @@ import { PriorApiClient } from "./client.js";
 export interface RegisterToolsOptions {
     client: PriorApiClient;
 }
+/**
+ * Expand [PRIOR:*] client-side tokens to MCP tool call syntax.
+ */
+export declare function expandNudgeTokens(message: string): string;
 export declare function registerTools(server: McpServer, { client }: RegisterToolsOptions): void;

package/dist/tools.js

@@ -4,13 +4,30 @@
  *
  * Usage:
  *   import { registerTools } from "@cg3/prior-mcp/tools";
- *   const server = new McpServer({ name: "prior", version: "0.3.1" });
+ *   const server = new McpServer({ name: "prior", version: "0.4.0" });
  *   registerTools(server, { client });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandNudgeTokens = expandNudgeTokens;
 exports.registerTools = registerTools;
 const zod_1 = require("zod");
 const utils_js_1 = require("./utils.js");
+/**
+ * Expand [PRIOR:*] client-side tokens to MCP tool call syntax.
+ */
+function expandNudgeTokens(message) {
+    return message
+        .replace(/\[PRIOR:CONTRIBUTE\]/g, '`prior_contribute(...)`')
+        .replace(/\[PRIOR:FEEDBACK:useful\]/g, '`prior_feedback(entryId: "...", outcome: "useful")`')
+        .replace(/\[PRIOR:FEEDBACK:not_useful\]/g, '`prior_feedback(entryId: "...", outcome: "not_useful", reason: "...")`')
+        .replace(/\[PRIOR:FEEDBACK:irrelevant\]/g, '`prior_feedback(entryId: "...", outcome: "irrelevant")`')
+        .replace(/\[PRIOR:FEEDBACK\]/g, '`prior_feedback(...)`')
+        .replace(/\[PRIOR:STATUS\]/g, '`prior_status()`')
+        // Future: parameterized contribute with pre-fill
+        .replace(/\[PRIOR:CONTRIBUTE ([^\]]+)\]/g, (_match, attrs) => {
+        return `\`prior_contribute(${attrs})\``;
+    });
+}
 function registerTools(server, { client }) {
     // ── prior_search ────────────────────────────────────────────────────
     server.registerTool("prior_search", {
@@ -43,10 +60,10 @@ See prior://docs/search-tips for detailed guidance.`,
                 id: zod_1.z.string(),
                 title: zod_1.z.string(),
                 content: zod_1.z.string(),
-                tags: zod_1.z.array(zod_1.z.string()).optional(),
-                qualityScore: zod_1.z.number().optional(),
-                relevanceScore: zod_1.z.number().optional(),
-                failedApproaches: zod_1.z.array(zod_1.z.string()).optional(),
+                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(),
+                failedApproaches: zod_1.z.array(zod_1.z.string()).nullable().optional(),
                 feedbackActions: zod_1.z.object({
                     useful: zod_1.z.object({
                         entryId: zod_1.z.string(),
@@ -70,9 +87,6 @@ See prior://docs/search-tips for detailed guidance.`,
             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 }) => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
         const body = { query };
         // Build context — use provided values, fall back to detected runtime
         const ctx = context || {};
@@ -111,6 +125,37 @@ See prior://docs/search-tips for detailed guidance.`,
         }
         const agentHint = rawData?.agentHint;
         const doNotTry = rawData?.doNotTry;
+        // Process nudge from backend (feedback/contribution reminders)
+        const rawNudge = rawData?.nudge;
+        let nudge;
+        if (rawNudge?.message) {
+            // Expand client-side tokens to MCP tool syntax
+            const expandedMessage = expandNudgeTokens(rawNudge.message);
+            // Build feedbackActions for previous search results
+            const previousResults = rawNudge.context?.previousResults?.map((r) => ({
+                id: r.id,
+                title: r.title,
+                feedbackActions: {
+                    useful: { entryId: r.id, outcome: "useful" },
+                    not_useful: { entryId: r.id, outcome: "not_useful", reason: "" },
+                    irrelevant: { entryId: r.id, outcome: "irrelevant" },
+                },
+            }));
+            nudge = {
+                kind: rawNudge.kind || "",
+                template: rawNudge.template || "",
+                message: expandedMessage,
+                context: rawNudge.context,
+                ...(previousResults?.length ? { previousResults } : {}),
+            };
+            text += `\n\n💡 ${expandedMessage}`;
+            if (previousResults?.length) {
+                text += `\n  Previous results:`;
+                for (const r of previousResults) {
+                    text += `\n    - "${r.title}" → prior_feedback(entryId: "${r.id}", outcome: "useful")`;
+                }
+            }
+        }
         return {
             structuredContent: {
                 results: structuredResults,
@@ -119,6 +164,7 @@ See prior://docs/search-tips for detailed guidance.`,
                 contributionPrompt: contributionPrompt || undefined,
                 agentHint: agentHint || undefined,
                 doNotTry: doNotTry || undefined,
+                nudge: nudge || undefined,
             },
             content: [{ type: "text", text }],
         };
@@ -164,9 +210,6 @@ Structured fields (problem, solution, errorMessages, failedApproaches) are optio
             creditsEarned: zod_1.z.number().optional(),
         },
     }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
         const body = { title, content, tags, model: model || "unknown" };
         if (problem)
             body.problem = problem;
@@ -219,12 +262,9 @@ Use the feedbackActions from your search results — they have pre-built params
         outputSchema: {
             ok: zod_1.z.boolean(),
             creditsRefunded: zod_1.z.number().describe("Credits refunded for this feedback"),
-            previousOutcome: zod_1.z.string().optional().describe("Previous outcome if updating existing feedback"),
+            previousOutcome: zod_1.z.string().nullable().optional().describe("Previous outcome if updating existing feedback"),
         },
     }, async ({ entryId, outcome, reason, notes, correctionId, correction }) => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
         const body = { outcome };
         if (reason)
             body.reason = reason;
@@ -245,53 +285,6 @@ Use the feedbackActions from your search results — they have pre-built params
             content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }],
         };
     });
-    // ── prior_claim ─────────────────────────────────────────────────────
-    server.registerTool("prior_claim", {
-        title: "Claim Your Agent",
-        description: `Claim your agent by verifying your email. Two-step process:
-1. Call with just email → sends a 6-digit code
-2. Call again with email + code → verifies and claims
-
-Claiming unlocks unlimited contributions and credit earning. See prior://docs/claiming for details.`,
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-        inputSchema: {
-            email: zod_1.z.string().describe("Your email address"),
-            code: zod_1.z.string().optional().describe("6-digit verification code from your email (step 2)"),
-        },
-        outputSchema: {
-            ok: zod_1.z.boolean(),
-            message: zod_1.z.string(),
-            step: zod_1.z.string().describe("Current step: 'code_sent' or 'verified'"),
-        },
-    }, async ({ email, code }) => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
-        if (code) {
-            // Step 2: verify the code
-            const data = await client.request("POST", "/v1/agents/verify", { code });
-            return {
-                structuredContent: {
-                    ok: data?.ok ?? true,
-                    message: data?.message || "Agent verified and claimed",
-                    step: "verified",
-                },
-                content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }],
-            };
-        }
-        else {
-            // Step 1: send verification code
-            const data = await client.request("POST", "/v1/agents/claim", { email });
-            return {
-                structuredContent: {
-                    ok: data?.ok ?? true,
-                    message: data?.message || "Verification code sent — check your email",
-                    step: "code_sent",
-                },
-                content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }],
-            };
-        }
-    });
     // ── prior_status ────────────────────────────────────────────────────
     server.registerTool("prior_status", {
         title: "Check Agent Status",
@@ -305,9 +298,6 @@ Claiming unlocks unlimited contributions and credit earning. See prior://docs/cl
             contributions: zod_1.z.number().optional(),
         },
     }, async () => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
         const data = await client.request("GET", "/v1/agents/me");
         const agent = data?.data || data;
         return {
@@ -334,9 +324,6 @@ Claiming unlocks unlimited contributions and credit earning. See prior://docs/cl
             message: zod_1.z.string(),
         },
     }, async ({ id }) => {
-        const key = await client.ensureApiKey();
-        if (!key)
-            return { content: [{ type: "text", text: "Not registered. Set PRIOR_API_KEY or check prior://docs/api-keys." }] };
         const data = await client.request("DELETE", `/v1/knowledge/${id}`);
         return {
             structuredContent: { ok: data?.ok ?? true, message: data?.message || "Entry retracted" },

package/package.json

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