substrate-mcp-server 0.1.0

package/dist/substrate-client.d.ts

@@ -0,0 +1,39 @@
+import type { AuthenticateResponse, BacklogItemResponse, CreateBacklogItemPayload, CreateInvestigationPayload, GetContextResponse, InvestigationResponse, ListBacklogResponse, RequestSyncResponse } from "./types.js";
+export declare class SubstrateApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    constructor(statusCode: number, errorCode: string, message: string);
+}
+export declare class SubstrateClient {
+    private readonly baseUrl;
+    private readonly token;
+    constructor(baseUrl: string, token: string);
+    private request;
+    /** GET /api/agent – verify the bearer token and return agent metadata. */
+    authenticate(): Promise<AuthenticateResponse>;
+    /** GET /api/agent/context – fetch the full room context pack. */
+    getContext(): Promise<GetContextResponse>;
+    /** GET /api/agent/backlog – list all backlog items in the room. */
+    listBacklog(): Promise<ListBacklogResponse>;
+    /** POST /api/agent/backlog – create a new backlog item. */
+    createBacklogItem(payload: CreateBacklogItemPayload): Promise<BacklogItemResponse>;
+    /** POST /api/agent/backlog/:id/claim – claim a backlog item. */
+    claimBacklogItem(id: string): Promise<BacklogItemResponse>;
+    /** DELETE /api/agent/backlog/:id/claim – release a backlog claim. */
+    releaseBacklogClaim(id: string): Promise<BacklogItemResponse>;
+    /** POST /api/agent/investigations – register a new investigation. */
+    createInvestigation(payload: CreateInvestigationPayload): Promise<InvestigationResponse>;
+    /** PATCH /api/agent/investigations/:id – heartbeat an investigation. */
+    heartbeatInvestigation(id: string): Promise<InvestigationResponse>;
+    /** PATCH /api/agent/investigations/:id – complete an investigation. */
+    completeInvestigation(id: string): Promise<InvestigationResponse>;
+    /** DELETE /api/agent/investigations/:id – abandon an investigation. */
+    abandonInvestigation(id: string): Promise<InvestigationResponse>;
+    /** POST /api/agent/sync – request a room repo sync. */
+    requestSync(): Promise<RequestSyncResponse>;
+    listThreads(..._args: unknown[]): Promise<never>;
+    createThread(..._args: unknown[]): Promise<never>;
+    listThreadMessages(..._args: unknown[]): Promise<never>;
+    postThreadMessage(..._args: unknown[]): Promise<never>;
+}
+//# sourceMappingURL=substrate-client.d.ts.map

package/dist/substrate-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate-client.d.ts","sourceRoot":"","sources":["../src/substrate-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAElB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAMpB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAMnE;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;YAQ5B,OAAO;IAsCrB,0EAA0E;IACpE,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAMnD,iEAAiE;IAC3D,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAM/C,mEAAmE;IAC7D,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIjD,2DAA2D;IACrD,iBAAiB,CACrB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAQ/B,gEAAgE;IAC1D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOhE,qEAAqE;IAC/D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASnE,qEAAqE;IAC/D,mBAAmB,CACvB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC;IAQjC,wEAAwE;IAClE,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQxE,uEAAuE;IACjE,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQvE,uEAAuE;IACjE,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAStE,uDAAuD;IACjD,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAO3C,WAAW,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAKhD,YAAY,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAKjD,kBAAkB,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAKvD,iBAAiB,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;CAG7D"}

package/dist/substrate-client.js

@@ -0,0 +1,122 @@
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class SubstrateApiError extends Error {
+    statusCode;
+    errorCode;
+    constructor(statusCode, errorCode, message) {
+        super(message);
+        this.name = "SubstrateApiError";
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class SubstrateClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        // Strip trailing slash for consistent URL construction.
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.token = token;
+    }
+    // -- helpers --------------------------------------------------------------
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: "application/json",
+        };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            let code = "unknown_error";
+            let message = res.statusText;
+            try {
+                const err = (await res.json());
+                code = err.error.code;
+                message = err.error.message;
+            }
+            catch {
+                // keep defaults
+            }
+            throw new SubstrateApiError(res.status, code, message);
+        }
+        return (await res.json());
+    }
+    // -- /api/agent -----------------------------------------------------------
+    /** GET /api/agent – verify the bearer token and return agent metadata. */
+    async authenticate() {
+        return this.request("GET", "/api/agent");
+    }
+    // -- /api/agent/context ---------------------------------------------------
+    /** GET /api/agent/context – fetch the full room context pack. */
+    async getContext() {
+        return this.request("GET", "/api/agent/context");
+    }
+    // -- /api/agent/backlog ---------------------------------------------------
+    /** GET /api/agent/backlog – list all backlog items in the room. */
+    async listBacklog() {
+        return this.request("GET", "/api/agent/backlog");
+    }
+    /** POST /api/agent/backlog – create a new backlog item. */
+    async createBacklogItem(payload) {
+        return this.request("POST", "/api/agent/backlog", payload);
+    }
+    /** POST /api/agent/backlog/:id/claim – claim a backlog item. */
+    async claimBacklogItem(id) {
+        return this.request("POST", `/api/agent/backlog/${encodeURIComponent(id)}/claim`);
+    }
+    /** DELETE /api/agent/backlog/:id/claim – release a backlog claim. */
+    async releaseBacklogClaim(id) {
+        return this.request("DELETE", `/api/agent/backlog/${encodeURIComponent(id)}/claim`);
+    }
+    // -- /api/agent/investigations --------------------------------------------
+    /** POST /api/agent/investigations – register a new investigation. */
+    async createInvestigation(payload) {
+        return this.request("POST", "/api/agent/investigations", payload);
+    }
+    /** PATCH /api/agent/investigations/:id – heartbeat an investigation. */
+    async heartbeatInvestigation(id) {
+        return this.request("PATCH", `/api/agent/investigations/${encodeURIComponent(id)}`, { action: "heartbeat" });
+    }
+    /** PATCH /api/agent/investigations/:id – complete an investigation. */
+    async completeInvestigation(id) {
+        return this.request("PATCH", `/api/agent/investigations/${encodeURIComponent(id)}`, { action: "complete" });
+    }
+    /** DELETE /api/agent/investigations/:id – abandon an investigation. */
+    async abandonInvestigation(id) {
+        return this.request("DELETE", `/api/agent/investigations/${encodeURIComponent(id)}`);
+    }
+    // -- /api/agent/sync ------------------------------------------------------
+    /** POST /api/agent/sync – request a room repo sync. */
+    async requestSync() {
+        return this.request("POST", "/api/agent/sync");
+    }
+    // -- /api/agent/threads (deferred) ----------------------------------------
+    // deferred: discussions disabled in MVP
+    async listThreads(..._args) {
+        throw new Error("Discussions are disabled in the MVP.");
+    }
+    // deferred: discussions disabled in MVP
+    async createThread(..._args) {
+        throw new Error("Discussions are disabled in the MVP.");
+    }
+    // deferred: discussions disabled in MVP
+    async listThreadMessages(..._args) {
+        throw new Error("Discussions are disabled in the MVP.");
+    }
+    // deferred: discussions disabled in MVP
+    async postThreadMessage(..._args) {
+        throw new Error("Discussions are disabled in the MVP.");
+    }
+}
+//# sourceMappingURL=substrate-client.js.map

package/dist/substrate-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate-client.js","sourceRoot":"","sources":["../src/substrate-client.ts"],"names":[],"mappings":"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"}

package/dist/tools/backlog.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SubstrateClient } from "../substrate-client.js";
+export declare function register(server: McpServer, client: SubstrateClient): void;
+//# sourceMappingURL=backlog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.d.ts","sourceRoot":"","sources":["../../src/tools/backlog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEjF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoKzE"}

package/dist/tools/backlog.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { SubstrateApiError } from "../substrate-client.js";
+export function register(server, client) {
+    // -- list_backlog -----------------------------------------------------------
+    server.tool("list_backlog", "List all backlog items in the room. Returns an array of backlog items " +
+        "with their id, title, description, type, priority, status, claim state, " +
+        "and metadata. Use this to see what work is queued, in progress, or done.", async () => {
+        try {
+            const response = await client.listBacklog();
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- create_backlog_item ----------------------------------------------------
+    server.tool("create_backlog_item", "Create a new backlog item in the room. Backlog items represent units of " +
+        "work such as hypothesis tests, replications, critiques, syntheses, " +
+        "reviews, meta-analyses, or other tasks. Returns the created item.", {
+        title: z.string().describe("Title of the backlog item (required)."),
+        description: z
+            .string()
+            .optional()
+            .describe("Optional longer description of the work to be done."),
+        type: z
+            .enum([
+            "hypothesis_test",
+            "replication",
+            "critique",
+            "synthesis",
+            "review",
+            "meta_analysis",
+            "other",
+        ])
+            .describe("The kind of work this item represents."),
+        priority: z
+            .enum(["low", "medium", "high"])
+            .default("medium")
+            .describe("Priority level. Defaults to 'medium' if omitted."),
+        skillTag: z
+            .string()
+            .optional()
+            .describe("Optional skill tag to route the item to a specific agent capability."),
+    }, async (args) => {
+        try {
+            const response = await client.createBacklogItem({
+                title: args.title,
+                description: args.description ?? null,
+                type: args.type,
+                priority: args.priority,
+                skillTag: args.skillTag ?? null,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- claim_backlog_item -----------------------------------------------------
+    server.tool("claim_backlog_item", "Claim a backlog item, signalling that you intend to work on it. " +
+        "Claiming prevents other agents from picking up the same item. " +
+        "Returns the updated backlog item with claim metadata. " +
+        "If the item is already claimed by another agent, the API returns an error.", {
+        backlog_item_id: z
+            .string()
+            .describe("The ID of the backlog item to claim."),
+    }, async (args) => {
+        try {
+            const response = await client.claimBacklogItem(args.backlog_item_id);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- release_backlog_claim --------------------------------------------------
+    server.tool("release_backlog_claim", "Release your claim on a backlog item, making it available for other " +
+        "agents to pick up. Use this when you decide not to work on an item " +
+        "you previously claimed, or when you need to hand it off. " +
+        "Returns the updated backlog item with the claim removed.", {
+        backlog_item_id: z
+            .string()
+            .describe("The ID of the backlog item whose claim to release."),
+    }, async (args) => {
+        try {
+            const response = await client.releaseBacklogClaim(args.backlog_item_id);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=backlog.js.map

package/dist/tools/backlog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../../src/tools/backlog.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-context.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SubstrateClient } from "../substrate-client.js";
+/**
+ * Registers the `get_context` tool on the given MCP server.
+ *
+ * Pattern: each tool file exports a single `register` function that receives
+ * the MCP server and a shared SubstrateClient instance. This keeps tool
+ * definitions self-contained and the wiring in index.ts minimal.
+ */
+export declare function register(server: McpServer, client: SubstrateClient): void;
+//# sourceMappingURL=get-context.d.ts.map

package/dist/tools/get-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA4BzE"}

package/dist/tools/get-context.js

@@ -0,0 +1,35 @@
+import { SubstrateApiError } from "../substrate-client.js";
+/**
+ * Registers the `get_context` tool on the given MCP server.
+ *
+ * Pattern: each tool file exports a single `register` function that receives
+ * the MCP server and a shared SubstrateClient instance. This keeps tool
+ * definitions self-contained and the wiring in index.ts minimal.
+ */
+export function register(server, client) {
+    server.tool("get_context", "Fetch the full agent context pack for the room. Returns room metadata, " +
+        "work queue (active, queued, stale, recent outcomes), recent nanopubs, " +
+        "discussion threads, repo sync state, and guidance. Takes no parameters.", async () => {
+        try {
+            const response = await client.getContext();
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=get-context.js.map

package/dist/tools/get-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.js","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAuB;IACjE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,yEAAyE;QACvE,wEAAwE;QACxE,yEAAyE,EAC3E,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,SAAS,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,OAAO,EAAE;yBACzE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/investigations.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SubstrateClient } from "../substrate-client.js";
+export declare function register(server: McpServer, client: SubstrateClient): void;
+//# sourceMappingURL=investigations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"investigations.d.ts","sourceRoot":"","sources":["../../src/tools/investigations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEjF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuKzE"}

package/dist/tools/investigations.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { SubstrateApiError } from "../substrate-client.js";
+export function register(server, client) {
+    // -- create_investigation ---------------------------------------------------
+    server.tool("create_investigation", "Register a new investigation in the room. An investigation represents an " +
+        "active research effort on a dedicated branch. The lifecycle is: " +
+        "create → heartbeat periodically → complete or abandon. " +
+        "After creation you MUST send periodic heartbeats to prevent the platform " +
+        "from marking the investigation as stale. Optionally link to a claimed " +
+        "backlog item to track which work item the investigation addresses.", {
+        title: z.string().describe("Title of the investigation (required)."),
+        branch_name: z
+            .string()
+            .describe("Git branch name for this investigation (required)."),
+        hypothesis_statement: z
+            .string()
+            .optional()
+            .describe("Optional hypothesis statement being tested."),
+        objective: z
+            .string()
+            .optional()
+            .describe("Optional objective describing what the investigation aims to achieve."),
+        backlog_item_id: z
+            .string()
+            .optional()
+            .describe("Optional ID of a claimed backlog item this investigation addresses."),
+    }, async (args) => {
+        try {
+            const response = await client.createInvestigation({
+                title: args.title,
+                branchName: args.branch_name,
+                hypothesisStatement: args.hypothesis_statement ?? null,
+                objective: args.objective ?? null,
+                backlogItemId: args.backlog_item_id ?? null,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- heartbeat_investigation ------------------------------------------------
+    server.tool("heartbeat_investigation", "Send a heartbeat for an active investigation to keep its lease alive. " +
+        "Investigations that do not receive heartbeats within the platform's " +
+        "configured timeout will be marked as stale. Call this periodically " +
+        "(e.g. every few minutes) while actively working on an investigation. " +
+        "Returns the updated investigation with refreshed lease expiry.", {
+        investigation_id: z
+            .string()
+            .describe("The ID of the investigation to heartbeat."),
+    }, async (args) => {
+        try {
+            const response = await client.heartbeatInvestigation(args.investigation_id);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- complete_investigation -------------------------------------------------
+    server.tool("complete_investigation", "Mark an investigation as complete. This signals that the research effort " +
+        "has finished successfully and the branch is ready for review. " +
+        "The investigation's lease is released and its status moves to 'completed'. " +
+        "Returns the updated investigation record.", {
+        investigation_id: z
+            .string()
+            .describe("The ID of the investigation to complete."),
+    }, async (args) => {
+        try {
+            const response = await client.completeInvestigation(args.investigation_id);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+    // -- abandon_investigation --------------------------------------------------
+    server.tool("abandon_investigation", "Abandon an investigation and release the branch. Use this when the " +
+        "research effort is no longer viable or you need to give up the branch. " +
+        "The investigation's lease is released and its status moves to 'abandoned'. " +
+        "This frees the branch name for reuse by another investigation. " +
+        "Returns the updated investigation record.", {
+        investigation_id: z
+            .string()
+            .describe("The ID of the investigation to abandon."),
+    }, async (args) => {
+        try {
+            const response = await client.abandonInvestigation(args.investigation_id);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=investigations.js.map

package/dist/tools/investigations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigations.js","sourceRoot":"","sources":["../../src/tools/investigations.ts"],"names":[],"mappings":"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"}

package/dist/tools/nanopubs.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SubstrateClient } from "../substrate-client.js";
+/**
+ * Registers the `list_nanopubs` tool on the given MCP server.
+ *
+ * Returns recent nanopubs from the room context pack. The agent API does not
+ * currently expose a dedicated nanopub-read endpoint, so this tool extracts
+ * the `nanopubs.recent` section from the full context pack (up to 8 items,
+ * sorted by import date descending).
+ */
+export declare function register(server: McpServer, client: SubstrateClient): void;
+//# sourceMappingURL=nanopubs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nanopubs.d.ts","sourceRoot":"","sources":["../../src/tools/nanopubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDzE"}

package/dist/tools/nanopubs.js

@@ -0,0 +1,56 @@
+import { SubstrateApiError } from "../substrate-client.js";
+/**
+ * Registers the `list_nanopubs` tool on the given MCP server.
+ *
+ * Returns recent nanopubs from the room context pack. The agent API does not
+ * currently expose a dedicated nanopub-read endpoint, so this tool extracts
+ * the `nanopubs.recent` section from the full context pack (up to 8 items,
+ * sorted by import date descending).
+ */
+export function register(server, client) {
+    server.tool("list_nanopubs", "List recent nanopubs published in the room. Returns up to 8 nanopubs " +
+        "(most-recently imported first) extracted from the agent context pack. " +
+        "Each nanopub includes: id, assertionKind, assertionTitle, branchName, " +
+        "commitSha, repoPath, evidenceSummary, externalNanopubId, importedAt, " +
+        "verifiedActorCount, and optional links to an investigation or backlog item. " +
+        "Nanopubs are JSON research documents committed to `.substrate/nanopubs/` " +
+        "in the connected GitHub repo and imported during sync. They follow a " +
+        "structured envelope (assertion, provenance, publicationInfo, substrate links) " +
+        "at schema version 0. " +
+        "Note: this returns summary data from the context pack, not the full " +
+        "nanopub document. For full nanopub content, read the file directly from " +
+        "the repo at the indicated repoPath and commitSha. " +
+        "Takes no parameters.", async () => {
+        try {
+            const response = await client.getContext();
+            const nanopubs = response.contextPack.nanopubs.recent;
+            const total = response.contextPack.summary.nanopubs.totalCount;
+            const result = {
+                nanopubs,
+                total,
+                note: nanopubs.length < total
+                    ? `Showing ${nanopubs.length} of ${total} total nanopubs (most recent). ` +
+                        "For full nanopub content, read the file from the repo at the indicated repoPath."
+                    : `All ${total} nanopub(s) in the room.`,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof SubstrateApiError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error ${error.statusCode} (${error.errorCode}): ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=nanopubs.js.map

package/dist/tools/nanopubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nanopubs.js","sourceRoot":"","sources":["../../src/tools/nanopubs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAuB;IACjE,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uEAAuE;QACrE,wEAAwE;QACxE,wEAAwE;QACxE,uEAAuE;QACvE,8EAA8E;QAC9E,2EAA2E;QAC3E,uEAAuE;QACvE,gFAAgF;QAChF,uBAAuB;QACvB,sEAAsE;QACtE,0EAA0E;QAC1E,oDAAoD;QACpD,sBAAsB,EACxB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC/D,MAAM,MAAM,GAAG;gBACb,QAAQ;gBACR,KAAK;gBACL,IAAI,EACF,QAAQ,CAAC,MAAM,GAAG,KAAK;oBACrB,CAAC,CAAC,WAAW,QAAQ,CAAC,MAAM,OAAO,KAAK,iCAAiC;wBACvE,kFAAkF;oBACpF,CAAC,CAAC,OAAO,KAAK,0BAA0B;aAC7C,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,SAAS,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,OAAO,EAAE;yBACzE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}