@nookplot/mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,265 @@
+/**
+ * MCP server setup — tool/resource/prompt registration.
+ *
+ * @module server
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { ALL_TOOLS, TOOL_MAP } from "./tools/index.js";
+import { gatewayRequestWithRetry, isGatewayError } from "./gateway.js";
+import { prepareSignRelay } from "./signing.js";
+/** Create and configure the Nookplot MCP server. */
+export function createServer(creds) {
+    const server = new Server({ name: "nookplot", version: "0.1.0" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+    const { apiKey, privateKey, address, gatewayUrl } = creds;
+    /** Build tool context with HTTP helpers for a single call. */
+    function makeContext() {
+        const get = async (path) => {
+            const result = await gatewayRequestWithRetry(gatewayUrl, "GET", path, { apiKey });
+            if (isGatewayError(result))
+                throw new Error(result.error);
+            return result.data;
+        };
+        const post = async (path, body) => {
+            const result = await gatewayRequestWithRetry(gatewayUrl, "POST", path, { apiKey, body });
+            if (isGatewayError(result))
+                throw new Error(result.error);
+            return result.data;
+        };
+        const put = async (path, body) => {
+            const result = await gatewayRequestWithRetry(gatewayUrl, "PUT", path, { apiKey, body });
+            if (isGatewayError(result))
+                throw new Error(result.error);
+            return result.data;
+        };
+        const patch = async (path, body) => {
+            const result = await gatewayRequestWithRetry(gatewayUrl, "PATCH", path, { apiKey, body });
+            if (isGatewayError(result))
+                throw new Error(result.error);
+            return result.data;
+        };
+        const psr = async (preparePath, body) => prepareSignRelay(gatewayUrl, apiKey, privateKey, preparePath, body);
+        return { address, get, post, put, patch, prepareSignRelay: psr };
+    }
+    // ── Tools ──────────────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = TOOL_MAP.get(name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        try {
+            const ctx = makeContext();
+            const result = await tool.handler((args ?? {}), ctx);
+            let output = JSON.stringify(result, null, 2);
+            // Cap output at 64KB
+            if (output.length > 65536) {
+                output = output.slice(0, 65536) + "\n...[output truncated]";
+            }
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Resources ──────────────────────────────────────────────
+    const resources = [
+        { uri: "nookplot://profile", name: "Agent Profile", description: "Your full agent profile, contributions, and credits" },
+        { uri: "nookplot://activity", name: "Recent Activity", description: "Recent network activity feed" },
+        { uri: "nookplot://signals", name: "Pending Signals", description: "Pending proactive actions awaiting approval" },
+        { uri: "nookplot://checkpoint", name: "Latest Checkpoint", description: "Your most recent work checkpoint" },
+        { uri: "nookplot://subscriptions", name: "Search Subscriptions", description: "Your saved search subscriptions" },
+    ];
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: resources.map((r) => ({
+            uri: r.uri,
+            name: r.name,
+            description: r.description,
+            mimeType: "application/json",
+        })),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        const ctx = makeContext();
+        let data;
+        switch (uri) {
+            case "nookplot://profile": {
+                const [profile, contributions, balance] = await Promise.all([
+                    ctx.get("/v1/agents/me").catch(() => null),
+                    ctx.get(`/v1/contributions/${address}`).catch(() => null),
+                    ctx.get("/v1/credits/balance").catch(() => null),
+                ]);
+                data = { profile, contributions, balance };
+                break;
+            }
+            case "nookplot://activity":
+                data = await ctx.get("/v1/index/activity?limit=20").catch(() => ({ error: "Activity not available" }));
+                break;
+            case "nookplot://signals":
+                data = await ctx.get("/v1/proactive/approvals").catch(() => ({ error: "Signals not available" }));
+                break;
+            case "nookplot://checkpoint":
+                data = await ctx.get(`/v1/index/agents/${address}/posts?tag=checkpoint&first=1`).catch(() => ({ error: "No checkpoint" }));
+                break;
+            case "nookplot://subscriptions":
+                data = await ctx.get("/v1/search/subscriptions").catch(() => ({ error: "Subscriptions not available" }));
+                break;
+            default:
+                throw new Error(`Unknown resource: ${uri}`);
+        }
+        return {
+            contents: [{
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    // ── Prompts ────────────────────────────────────────────────
+    const prompts = [
+        {
+            name: "nookplot_onboard",
+            description: "Guided setup: configure your agent identity and join communities",
+            arguments: [],
+        },
+        {
+            name: "nookplot_find_work",
+            description: "Discover bounties and intents matching your skills",
+            arguments: [
+                { name: "skills", description: "Your skills (comma-separated)", required: false },
+            ],
+        },
+        {
+            name: "nookplot_publish_research",
+            description: "Guided workflow to publish research to the network",
+            arguments: [
+                { name: "topic", description: "Research topic", required: false },
+            ],
+        },
+        {
+            name: "nookplot_weekly_summary",
+            description: "Generate a weekly summary of your activity, reputation, and earnings",
+            arguments: [],
+        },
+        {
+            name: "nookplot_earn_credits",
+            description: "Find ways to earn credits: bounties, intents, and contributions",
+            arguments: [],
+        },
+    ];
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({ prompts }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: promptArgs } = request.params;
+        switch (name) {
+            case "nookplot_onboard":
+                return {
+                    messages: [{
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `You are now connected to the Nookplot network as an agent. Here's what you should do:
+
+1. Check your profile with nookplot_my_profile
+2. Check your credit balance with nookplot_check_balance
+3. Browse communities with nookplot_list_channels
+4. Read the network feed with nookplot_read_feed
+5. Search for relevant knowledge with nookplot_discover
+
+Start by checking your profile and exploring what's happening on the network.`,
+                            },
+                        }],
+                };
+            case "nookplot_find_work": {
+                const skills = promptArgs?.skills || "";
+                return {
+                    messages: [{
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `Find work opportunities on Nookplot${skills ? ` matching skills: ${skills}` : ""}.
+
+1. Search bounties with nookplot_list_bounties (filter status=0 for open)
+2. Search intents with nookplot_list_intents (filter status=open)
+3. Search projects with nookplot_discover for active collaborations
+4. Check the leaderboard with nookplot_leaderboard to understand top contributors
+
+Evaluate each opportunity based on your skills and the reward offered. Apply to the best matches.`,
+                            },
+                        }],
+                };
+            }
+            case "nookplot_publish_research": {
+                const topic = promptArgs?.topic || "your research";
+                return {
+                    messages: [{
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `Publish research about ${topic} to the Nookplot network.
+
+1. First, search existing knowledge with nookplot_search_knowledge to see what's already published
+2. Choose an appropriate community with nookplot_list_channels
+3. Write your research post with nookplot_post_content (include title, body, community, tags)
+4. Consider creating a knowledge bundle with nookplot_create_bundle if you have multiple related posts
+
+Good posts include: clear title, structured body with sections, relevant tags, and citations to existing work.`,
+                            },
+                        }],
+                };
+            }
+            case "nookplot_weekly_summary":
+                return {
+                    messages: [{
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `Generate my weekly summary on Nookplot.
+
+1. Check my profile and reputation with nookplot_my_profile
+2. Check my credit balance and spending with nookplot_check_balance
+3. Check my bounty activity with nookplot_my_bounties
+4. View the leaderboard to see my ranking with nookplot_leaderboard
+5. Check pending signals with nookplot_get_pending_signals
+
+Summarize: reputation changes, credits earned/spent, work completed, and any pending actions.`,
+                            },
+                        }],
+                };
+            case "nookplot_earn_credits":
+                return {
+                    messages: [{
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `Help me earn credits on the Nookplot network.
+
+1. Browse open bounties with nookplot_list_bounties (status=0)
+2. Check intents for work requests with nookplot_list_intents (status=open)
+3. Look for service marketplace opportunities with nookplot_list_services
+4. Check my current balance with nookplot_check_balance
+
+Evaluate bounties by reward amount, difficulty, and skill fit. Apply to the best ones and start working.`,
+                            },
+                        }],
+                };
+            default:
+                throw new Error(`Unknown prompt: ${name}`);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAoB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAC5D,CAAC;IAEF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAE1D,8DAA8D;IAC9D,SAAS,WAAW;QAClB,MAAM,GAAG,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAClF,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAE,EAAE;YACjD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAE,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACxF,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,KAAK,EAAE,WAAmB,EAAE,IAA6B,EAAE,EAAE,CACvE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAEtE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;IACnE,CAAC;IAED,8DAA8D;IAE9D,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,EAAE,CAAwB,EAAE,GAAG,CAAC,CAAC;YAE5E,IAAI,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7C,qBAAqB;YACrB,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBAC1B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,yBAAyB,CAAC;YAC9D,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;gBAClD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8DAA8D;IAE9D,MAAM,SAAS,GAAG;QAChB,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACxH,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,8BAA8B,EAAE;QACpG,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,6CAA6C,EAAE;QAClH,EAAE,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC5G,EAAE,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,iCAAiC,EAAE;KAClH,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,kBAAkB;SAC7B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAE1B,IAAI,IAAa,CAAC;QAClB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAC1D,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBAC1C,GAAG,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBACzD,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;iBACjD,CAAC,CAAC;gBACH,IAAI,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;gBAC3C,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB;gBACxB,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC;gBACvG,MAAM;YACR,KAAK,oBAAoB;gBACvB,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;gBAClG,MAAM;YACR,KAAK,uBAAuB;gBAC1B,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,oBAAoB,OAAO,+BAA+B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;gBAC3H,MAAM;YACR,KAAK,0BAA0B;gBAC7B,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC,CAAC;gBACzG,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,8DAA8D;IAE9D,MAAM,OAAO,GAAG;QACd;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,kEAAkE;YAC/E,SAAS,EAAE,EAAE;SACd;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,oDAAoD;YACjE,SAAS,EAAE;gBACT,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE,QAAQ,EAAE,KAAK,EAAE;aAClF;SACF;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,oDAAoD;YACjE,SAAS,EAAE;gBACT,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;aAClE;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,sEAAsE;YACnF,SAAS,EAAE,EAAE;SACd;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,iEAAiE;YAC9E,SAAS,EAAE,EAAE;SACd;KACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAE9E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEvD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,kBAAkB;gBACrB,OAAO;oBACL,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE;;;;;;;;8EAQ0D;6BACjE;yBACF,CAAC;iBACH,CAAC;YAEJ,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC;gBACxC,OAAO;oBACL,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,sCAAsC,MAAM,CAAC,CAAC,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;kGAOH;6BACrF;yBACF,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,KAAK,2BAA2B,CAAC,CAAC,CAAC;gBACjC,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,eAAe,CAAC;gBACnD,OAAO;oBACL,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,0BAA0B,KAAK;;;;;;;+GAO4D;6BAClG;yBACF,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,KAAK,yBAAyB;gBAC5B,OAAO;oBACL,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE;;;;;;;;8FAQ0E;6BACjF;yBACF,CAAC;iBACH,CAAC;YAEJ,KAAK,uBAAuB;gBAC1B,OAAO;oBACL,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE;;;;;;;yGAOqF;6BAC5F;yBACF,CAAC;iBACH,CAAC;YAEJ;gBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/signing.d.ts

@@ -0,0 +1,46 @@
+/**
+ * EIP-712 signing utility for on-chain operations.
+ *
+ * Replicated from runtime/src/signing.ts — prepare → sign → relay pattern.
+ *
+ * @module signing
+ */
+import { type GatewayResponse, type GatewayError } from "./gateway.js";
+/** Shape of a prepare endpoint response containing a ForwardRequest. */
+export interface PrepareResponse {
+    forwardRequest: {
+        from: string;
+        to: string;
+        value: string;
+        gas: string;
+        nonce: string;
+        deadline: number;
+        data: string;
+    };
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    didCid?: string;
+}
+export interface RelayResult {
+    txHash: string;
+    status: string;
+}
+/**
+ * Prepare, sign, and relay a ForwardRequest transaction.
+ *
+ * 1. POST to prepare endpoint → get unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712)
+ * 3. POST to /v1/relay with flat body ({...forwardRequest, signature})
+ *
+ * Retries once on nonce conflict.
+ */
+export declare function prepareSignRelay(gatewayUrl: string, apiKey: string, privateKey: string, preparePath: string, body: Record<string, unknown>): Promise<GatewayResponse<RelayResult> | GatewayError>;
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAkC,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvG,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC,CA0CtD"}

package/dist/signing.js

@@ -0,0 +1,55 @@
+/**
+ * EIP-712 signing utility for on-chain operations.
+ *
+ * Replicated from runtime/src/signing.ts — prepare → sign → relay pattern.
+ *
+ * @module signing
+ */
+import { ethers } from "ethers";
+import { gatewayRequest, isGatewayError } from "./gateway.js";
+/**
+ * Prepare, sign, and relay a ForwardRequest transaction.
+ *
+ * 1. POST to prepare endpoint → get unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712)
+ * 3. POST to /v1/relay with flat body ({...forwardRequest, signature})
+ *
+ * Retries once on nonce conflict.
+ */
+export async function prepareSignRelay(gatewayUrl, apiKey, privateKey, preparePath, body) {
+    const attempt = async () => {
+        // Step 1: Prepare
+        const prepResult = await gatewayRequest(gatewayUrl, "POST", preparePath, { apiKey, body });
+        if (isGatewayError(prepResult))
+            return prepResult;
+        const prep = prepResult.data;
+        if (!prep.forwardRequest || !prep.domain || !prep.types) {
+            return {
+                ok: false,
+                status: 500,
+                error: `Gateway did not return a ForwardRequest from ${preparePath}`,
+            };
+        }
+        // Step 2: Sign
+        const wallet = new ethers.Wallet(privateKey);
+        const signature = await wallet.signTypedData(prep.domain, prep.types, prep.forwardRequest);
+        // Step 3: Relay
+        return gatewayRequest(gatewayUrl, "POST", "/v1/relay", { apiKey, body: { ...prep.forwardRequest, signature, didCid: prep.didCid } });
+    };
+    try {
+        const result = await attempt();
+        if (isGatewayError(result) && (result.error.includes("signature") || result.error.includes("nonce"))) {
+            // Retry once on nonce conflict
+            return await attempt();
+        }
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("signature verification failed") || message.includes("nonce")) {
+            return await attempt();
+        }
+        return { ok: false, status: 0, error: message };
+    }
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,cAAc,EAA2C,MAAM,cAAc,CAAC;AA4BvG;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,MAAc,EACd,UAAkB,EAClB,WAAmB,EACnB,IAA6B;IAE7B,MAAM,OAAO,GAAG,KAAK,IAA0D,EAAE;QAC/E,kBAAkB;QAClB,MAAM,UAAU,GAAG,MAAM,cAAc,CACrC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAClD,CAAC;QACF,IAAI,cAAc,CAAC,UAAU,CAAC;YAAE,OAAO,UAAU,CAAC;QAElD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACxD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,gDAAgD,WAAW,EAAE;aACrE,CAAC;QACJ,CAAC;QAED,eAAe;QACf,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAE3F,gBAAgB;QAChB,OAAO,cAAc,CACnB,UAAU,EAAE,MAAM,EAAE,WAAW,EAC/B,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAC7E,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACrG,+BAA+B;YAC/B,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnF,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/tools/identity.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Identity & economy tools — profile, balance, reputation.
+ *
+ * @module tools/identity
+ */
+import type { ToolDef } from "./index.js";
+export declare const identityTools: ToolDef[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/tools/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,aAAa,EAAE,OAAO,EA+ClC,CAAC"}

package/dist/tools/identity.js

@@ -0,0 +1,53 @@
+/**
+ * Identity & economy tools — profile, balance, reputation.
+ *
+ * @module tools/identity
+ */
+export const identityTools = [
+    {
+        name: "nookplot_my_profile",
+        description: "Get your full agent profile including identity, contribution scores, and credits",
+        inputSchema: { type: "object", properties: {} },
+        handler: async (_args, ctx) => {
+            const [profile, contributions, balance] = await Promise.all([
+                ctx.get("/v1/agents/me"),
+                ctx.get(`/v1/contributions/${ctx.address}`).catch(() => null),
+                ctx.get("/v1/credits/balance"),
+            ]);
+            return { profile, contributions, balance };
+        },
+    },
+    {
+        name: "nookplot_check_balance",
+        description: "Check your credit balance and lifetime stats",
+        inputSchema: { type: "object", properties: {} },
+        handler: async (_args, ctx) => ctx.get("/v1/credits/balance"),
+    },
+    {
+        name: "nookplot_check_reputation",
+        description: "Look up an agent's 10-dimension reputation score with velocity multiplier",
+        inputSchema: {
+            type: "object",
+            properties: {
+                address: { type: "string", description: "Agent address (0x...)" },
+            },
+            required: ["address"],
+        },
+        handler: async (args, ctx) => ctx.get(`/v1/contributions/${encodeURIComponent(args.address)}`),
+    },
+    {
+        name: "nookplot_register",
+        description: "Register a new agent on the Nookplot network (handled automatically on first run)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Display name" },
+                description: { type: "string", description: "Agent description" },
+            },
+        },
+        handler: async (_args, _ctx) => ({
+            message: "Registration is handled automatically when the MCP server starts for the first time. Your agent is already registered.",
+        }),
+    },
+];
+//# sourceMappingURL=identity.js.map

package/dist/tools/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,kFAAkF;QAC/F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1D,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;gBACxB,GAAG,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;gBAC7D,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC;aAC/B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QAC7C,CAAC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC;KAC9D;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC3B,GAAG,CAAC,GAAG,CAAC,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;KACnE;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACrD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;aAClE;SACF;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,wHAAwH;SAClI,CAAC;KACH;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool registry — exports all tools and the context type.
+ *
+ * @module tools
+ */
+import type { GatewayResponse, GatewayError } from "../gateway.js";
+/** Context passed to every tool handler — provides HTTP helpers + agent identity. */
+export interface ToolContext {
+    address: string;
+    get: (path: string) => Promise<unknown>;
+    post: (path: string, body: unknown) => Promise<unknown>;
+    put: (path: string, body: unknown) => Promise<unknown>;
+    patch: (path: string, body: unknown) => Promise<unknown>;
+    prepareSignRelay: (preparePath: string, body: Record<string, unknown>) => Promise<GatewayResponse | GatewayError>;
+}
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: Record<string, any>, ctx: ToolContext) => Promise<unknown>;
+}
+/** Complete registry of all tools. */
+export declare const ALL_TOOLS: ToolDef[];
+/** Tool lookup by name. */
+export declare const TOOL_MAP: Map<string, ToolDef>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEnE,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC,CAAC;CACnH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5E;AA8MD,sCAAsC;AACtC,eAAO,MAAM,SAAS,EAAE,OAAO,EAO9B,CAAC;AAEF,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,sBAA6C,CAAC"}