@dain-os/mcp-server 0.5.0 → 0.6.0

package/dist/http.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DainOS MCP server — HTTP entry point for Vercel deployment.
+ *
+ * Direct JSON-RPC handler that bypasses the MCP SDK's transport layer.
+ * The SDK transports (StreamableHTTP, WebStandard) use SSE streaming which
+ * hangs on Vercel serverless. Since our server is stateless (no sessions,
+ * no resumability), plain JSON request-response is correct and sufficient.
+ *
+ * Implements the MCP Streamable HTTP protocol subset needed for stateless
+ * tool servers: initialize, notifications/initialized, tools/list, tools/call.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+interface VercelRequest extends IncomingMessage {
+    body?: unknown;
+}
+export default function handler(req: VercelRequest, res: ServerResponse): Promise<void>;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAejE,UAAU,aAAc,SAAQ,eAAe;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwFD,wBAA8B,OAAO,CACnC,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/http.js

@@ -0,0 +1,144 @@
+/**
+ * DainOS MCP server — HTTP entry point for Vercel deployment.
+ *
+ * Direct JSON-RPC handler that bypasses the MCP SDK's transport layer.
+ * The SDK transports (StreamableHTTP, WebStandard) use SSE streaming which
+ * hangs on Vercel serverless. Since our server is stateless (no sessions,
+ * no resumability), plain JSON request-response is correct and sufficient.
+ *
+ * Implements the MCP Streamable HTTP protocol subset needed for stateless
+ * tool servers: initialize, notifications/initialized, tools/list, tools/call.
+ */
+import { DainOsClient, DainOsApiError } from './client.js';
+import { allTools, getTool } from './tools/index.js';
+import { toJsonSchema } from './tools/types.js';
+const PACKAGE_NAME = 'dainos';
+const PACKAGE_VERSION = '0.6.0';
+const PROTOCOL_VERSION = '2025-03-26';
+const CORS_HEADERS = {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'POST, GET, DELETE, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization, Mcp-Session-Id',
+};
+function sendJson(res, status, body) {
+    for (const [k, v] of Object.entries(CORS_HEADERS))
+        res.setHeader(k, v);
+    res.setHeader('Content-Type', 'application/json');
+    res.writeHead(status);
+    res.end(JSON.stringify(body));
+}
+function jsonRpcResult(id, result) {
+    return { jsonrpc: '2.0', result, id: id ?? null };
+}
+function jsonRpcError(id, code, message) {
+    return { jsonrpc: '2.0', error: { code, message }, id: id ?? null };
+}
+function handleInitialize(req) {
+    return jsonRpcResult(req.id, {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: { tools: { listChanged: false } },
+        serverInfo: { name: PACKAGE_NAME, version: PACKAGE_VERSION },
+    });
+}
+function handleToolsList(req) {
+    const tools = allTools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: toJsonSchema(tool.inputSchema),
+    }));
+    return jsonRpcResult(req.id, { tools });
+}
+async function handleToolsCall(req, client) {
+    const params = req.params;
+    const toolName = params?.name;
+    if (!toolName) {
+        return jsonRpcError(req.id, -32602, 'Missing tool name in params.name');
+    }
+    const tool = getTool(toolName);
+    if (!tool) {
+        return jsonRpcError(req.id, -32602, `Unknown tool: ${toolName}`);
+    }
+    const parsed = tool.inputSchema.safeParse(params?.arguments ?? {});
+    if (!parsed.success) {
+        return jsonRpcError(req.id, -32602, `Invalid input for ${toolName}: ${parsed.error.message}`);
+    }
+    try {
+        const result = await tool.handler(client, parsed.data);
+        const text = result === undefined
+            ? JSON.stringify({ ok: true }, null, 2)
+            : JSON.stringify(result, null, 2);
+        return jsonRpcResult(req.id, {
+            content: [{ type: 'text', text }],
+        });
+    }
+    catch (error) {
+        const message = error instanceof DainOsApiError
+            ? error.message
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        return jsonRpcResult(req.id, {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        });
+    }
+}
+export default async function handler(req, res) {
+    if (req.method === 'OPTIONS') {
+        for (const [k, v] of Object.entries(CORS_HEADERS))
+            res.setHeader(k, v);
+        res.writeHead(200);
+        res.end();
+        return;
+    }
+    if (req.method === 'GET' || req.method === 'DELETE') {
+        sendJson(res, 405, jsonRpcError(null, -32000, 'Method not allowed. Use POST for MCP requests.'));
+        return;
+    }
+    const authHeader = req.headers['authorization'];
+    const token = typeof authHeader === 'string' && authHeader.startsWith('Bearer ')
+        ? authHeader.slice(7)
+        : null;
+    if (!token || !token.startsWith('dain_pat_')) {
+        sendJson(res, 401, jsonRpcError(null, -32001, 'Missing or invalid DAINOS_API_TOKEN. Include Bearer dain_pat_... in Authorization header.'));
+        return;
+    }
+    const body = req.body;
+    if (!body) {
+        sendJson(res, 400, jsonRpcError(null, -32700, 'Parse error: empty body'));
+        return;
+    }
+    const apiUrl = process.env['DAINOS_API_URL'];
+    const client = new DainOsClient(apiUrl, token);
+    // Handle batch requests (array) and single requests
+    const requests = Array.isArray(body) ? body : [body];
+    const responses = [];
+    for (const rpcReq of requests) {
+        if (rpcReq.method === 'initialize') {
+            responses.push(handleInitialize(rpcReq));
+        }
+        else if (rpcReq.method === 'notifications/initialized') {
+            // Notification — no response per JSON-RPC spec
+            continue;
+        }
+        else if (rpcReq.method === 'tools/list') {
+            responses.push(handleToolsList(rpcReq));
+        }
+        else if (rpcReq.method === 'tools/call') {
+            responses.push(await handleToolsCall(rpcReq, client));
+        }
+        else if (rpcReq.method === 'ping') {
+            responses.push(jsonRpcResult(rpcReq.id, {}));
+        }
+        else {
+            responses.push(jsonRpcError(rpcReq.id, -32601, `Method not found: ${rpcReq.method}`));
+        }
+    }
+    if (responses.length === 0) {
+        // All requests were notifications
+        sendJson(res, 202, {});
+        return;
+    }
+    sendJson(res, 200, Array.isArray(body) ? responses : responses[0]);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC,MAAM,YAAY,GAA2B;IAC3C,6BAA6B,EAAE,GAAG;IAClC,8BAA8B,EAAE,4BAA4B;IAC5D,8BAA8B,EAAE,6CAA6C;CAC9E,CAAC;AAaF,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa;IAClE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClD,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,EAAsC,EAAE,MAAe;IAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CACnB,EAAsC,EACtC,IAAY,EACZ,OAAe;IAEf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;QAC3B,eAAe,EAAE,gBAAgB;QACjC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,GAAmB;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;KAC5C,CAAC,CAAC,CAAC;IACJ,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,GAAmB,EACnB,MAAoB;IAEpB,MAAM,MAAM,GAAG,GAAG,CAAC,MAA4E,CAAC;IAChG,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI,CAAC;IAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,qBAAqB,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,IAAI,GACR,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;YAC3B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,cAAc;YAC7B,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,KAAK,YAAY,KAAK;gBACtB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;YAC3B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,OAAO,CACnC,GAAkB,EAClB,GAAmB;IAEnB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;YAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnB,GAAG,CAAC,GAAG,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,gDAAgD,CAAC,CAAC,CAAC;QACjG,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,KAAK,GACT,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;QAChE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAC7B,IAAI,EACJ,CAAC,KAAK,EACN,2FAA2F,CAC5F,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAqD,CAAC;IACvE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE/C,oDAAoD;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,SAAS,GAAc,EAAE,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,2BAA2B,EAAE,CAAC;YACzD,+CAA+C;YAC/C,SAAS;QACX,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,kCAAkC;QAClC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/index.d.ts

@@ -3,8 +3,11 @@
  * DainOS MCP server entry point.
  *
  * Stdio transport. Reads DAINOS_API_TOKEN (required) and DAINOS_API_URL (optional,
- * defaults to https://api.dainos.app) from the environment, then exposes the 12
+ * defaults to https://api.dainos.app) from the environment, then exposes the
  * project/task/comment tools to any MCP client (Claude Code, etc).
+ *
+ * Tool registration is shared with the HTTP entry point (src/http.ts) via
+ * src/server-setup.ts.
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/index.js

@@ -3,17 +3,19 @@
  * DainOS MCP server entry point.
  *
  * Stdio transport. Reads DAINOS_API_TOKEN (required) and DAINOS_API_URL (optional,
- * defaults to https://api.dainos.app) from the environment, then exposes the 12
+ * defaults to https://api.dainos.app) from the environment, then exposes the
  * project/task/comment tools to any MCP client (Claude Code, etc).
+ *
+ * Tool registration is shared with the HTTP entry point (src/http.ts) via
+ * src/server-setup.ts.
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { DainOsClient, DainOsApiError } from './client.js';
-import { allTools, getTool } from './tools/index.js';
-import { toJsonSchema } from './tools/types.js';
+import { DainOsClient } from './client.js';
+import { allTools } from './tools/index.js';
+import { registerToolHandlers } from './server-setup.js';
 const PACKAGE_NAME = 'dainos';
-const PACKAGE_VERSION = '0.2.1';
+const PACKAGE_VERSION = '0.6.0';
 function fail(message) {
     process.stderr.write(`[dainos-mcp] ${message}\n`);
     process.exit(1);
@@ -29,60 +31,7 @@ async function main() {
     const baseUrl = process.env.DAINOS_API_URL;
     const client = new DainOsClient(baseUrl, token);
     const server = new Server({ name: PACKAGE_NAME, version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: allTools.map((tool) => ({
-            name: tool.name,
-            description: tool.description,
-            inputSchema: toJsonSchema(tool.inputSchema),
-        })),
-    }));
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const tool = getTool(request.params.name);
-        if (!tool) {
-            return {
-                content: [
-                    { type: 'text', text: `Unknown tool: ${request.params.name}` },
-                ],
-                isError: true,
-            };
-        }
-        const parsed = tool.inputSchema.safeParse(request.params.arguments ?? {});
-        if (!parsed.success) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Invalid input for ${tool.name}: ${parsed.error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            const result = await tool.handler(client, parsed.data);
-            // Some endpoints (e.g. archive_project hits DELETE → 204) resolve to
-            // undefined. JSON.stringify(undefined) yields undefined, which fails the
-            // MCP SDK's content[0].text string validation. Emit a confirmation
-            // envelope instead so 204-style mutations don't crash the response.
-            const text = result === undefined
-                ? JSON.stringify({ ok: true }, null, 2)
-                : JSON.stringify(result, null, 2);
-            return {
-                content: [{ type: 'text', text }],
-            };
-        }
-        catch (error) {
-            const message = error instanceof DainOsApiError
-                ? error.message
-                : error instanceof Error
-                    ? error.message
-                    : String(error);
-            return {
-                content: [{ type: 'text', text: message }],
-                isError: true,
-            };
-        }
-    });
+    registerToolHandlers(server, client);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     process.stderr.write(`[dainos-mcp] connected (${allTools.length} tools, api=${client.baseUrl})\n`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,CACF,0IAA0I,CAC3I,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,IAAI,CACF,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,EAChD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,QAAQ,CAAC,MAAM,eAAe,MAAM,CAAC,OAAO,KAAK,CAC7E,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/server-setup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared MCP tool registration — used by both the stdio and HTTP entry points.
+ *
+ * Extracts the ListTools + CallTool handler setup from the original inline code
+ * in src/index.ts so neither entry point needs to duplicate it.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { DainOsClient } from './client.js';
+/**
+ * Register the ListTools and CallTool request handlers on `server`.
+ *
+ * Identical to the inline handler setup that was previously in src/index.ts.
+ * Both the stdio entry point and the HTTP entry point call this function after
+ * creating their respective Server instances.
+ */
+export declare function registerToolHandlers(server: Server, client: DainOsClient): void;
+//# sourceMappingURL=server-setup.d.ts.map

package/dist/server-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-setup.d.ts","sourceRoot":"","sources":["../src/server-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAI3D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2D/E"}

package/dist/server-setup.js

@@ -0,0 +1,74 @@
+/**
+ * Shared MCP tool registration — used by both the stdio and HTTP entry points.
+ *
+ * Extracts the ListTools + CallTool handler setup from the original inline code
+ * in src/index.ts so neither entry point needs to duplicate it.
+ */
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { DainOsApiError } from './client.js';
+import { allTools, getTool } from './tools/index.js';
+import { toJsonSchema } from './tools/types.js';
+/**
+ * Register the ListTools and CallTool request handlers on `server`.
+ *
+ * Identical to the inline handler setup that was previously in src/index.ts.
+ * Both the stdio entry point and the HTTP entry point call this function after
+ * creating their respective Server instances.
+ */
+export function registerToolHandlers(server, client) {
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: allTools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: toJsonSchema(tool.inputSchema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = getTool(request.params.name);
+        if (!tool) {
+            return {
+                content: [
+                    { type: 'text', text: `Unknown tool: ${request.params.name}` },
+                ],
+                isError: true,
+            };
+        }
+        const parsed = tool.inputSchema.safeParse(request.params.arguments ?? {});
+        if (!parsed.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Invalid input for ${tool.name}: ${parsed.error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(client, parsed.data);
+            // Some endpoints (e.g. archive_project hits DELETE → 204) resolve to
+            // undefined. JSON.stringify(undefined) yields undefined, which fails the
+            // MCP SDK's content[0].text string validation. Emit a confirmation
+            // envelope instead so 204-style mutations don't crash the response.
+            const text = result === undefined
+                ? JSON.stringify({ ok: true }, null, 2)
+                : JSON.stringify(result, null, 2);
+            return {
+                content: [{ type: 'text', text }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof DainOsApiError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=server-setup.js.map

package/dist/server-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-setup.js","sourceRoot":"","sources":["../src/server-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAAoB;IACvE,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;SAC5C,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;iBACxE;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;qBAChE;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACvD,qEAAqE;YACrE,yEAAyE;YACzE,mEAAmE;YACnE,oEAAoE;YACpE,MAAM,IAAI,GACR,MAAM,KAAK,SAAS;gBAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;aAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GACX,KAAK,YAAY,cAAc;gBAC7B,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,KAAK,YAAY,KAAK;oBACtB,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/cadence.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from './types.js';
+/** All four Cadence MCP tools. */
+export declare const cadenceTools: ToolDefinition[];
+//# sourceMappingURL=cadence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../../src/tools/cadence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoRjD,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,cAAc,EAKxC,CAAC"}

package/dist/tools/cadence.js

@@ -0,0 +1,245 @@
+import { z } from 'zod';
+/**
+ * Cadence MCP tools: AI agent feed for the Sprint + Cadence feature.
+ *
+ * Four tools for agents (Claude Code, Otto) to interact with the sprint plan:
+ *   claim_next_task       — fetch the highest-ranked open task from the sprint
+ *   report_task_progress  — append a one-liner progress note with agent identity
+ *   mark_blocked          — flag a task as blocked with a reason
+ *   request_unblock       — signal that a task needs human attention to unblock
+ *
+ * Audit trail: all writes carry metadata.via='mcp' and metadata.client so the
+ * cadence_actions record shows "Claude Code" rather than "system". The API
+ * side uses this to attribute agent activity in the sprint timeline.
+ *
+ * @builder ship-api-builder (Round 4, R4-T1)
+ */
+// ---------------------------------------------------------------------------
+// claim_next_task
+// ---------------------------------------------------------------------------
+const claimNextTask = {
+    name: 'claim_next_task',
+    description: 'Fetch the highest-ranked open task from the Cadence sprint feed. ' +
+        'Returns the task object with its Cadence ranking rationale and score. ' +
+        'Call this at the start of an autonomous work session to find what to work on next. ' +
+        'Filters by sprintId, projectId, or assigneeId when provided.',
+    inputSchema: z.object({
+        sprintId: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Restrict to tasks in a specific sprint.'),
+        projectId: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Restrict to tasks in a specific project.'),
+        assigneeId: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Restrict to tasks assigned to a specific IAM user.'),
+        client: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Caller identity for the audit trail (e.g. "claude-code", "otto"). ' +
+            'Logged as metadata.client on the resulting cadence_actions row.'),
+    }),
+    handler: async (client, input) => {
+        const params = new URLSearchParams();
+        if (input.sprintId)
+            params.set('sprintId', input.sprintId);
+        if (input.projectId)
+            params.set('projectId', input.projectId);
+        if (input.assigneeId)
+            params.set('assigneeId', input.assigneeId);
+        const query = params.toString() ? `?${params.toString()}` : '';
+        // GET /api/v1/cadence/feed/next-task returns { task: RankedTask | null }
+        // The ranked task includes rationale and ranking score from CadenceRankerService.
+        return client.get(`/cadence/feed/next-task${query}`);
+    },
+};
+// ---------------------------------------------------------------------------
+// report_task_progress
+// ---------------------------------------------------------------------------
+const reportTaskProgress = {
+    name: 'report_task_progress',
+    description: 'Append a one-line progress note to a task and record it in the Cadence audit trail. ' +
+        'Use this after completing a meaningful unit of work on a task (e.g. "Implemented ' +
+        'the migration file and ran npx prisma generate"). ' +
+        'The note is written to the task\'s AI progress log section and creates a ' +
+        'cadence_actions row with action_type=progress_note for the sprint timeline. ' +
+        'Provide your client identity so the audit trail reads "Claude Code" not "system".',
+    inputSchema: z.object({
+        taskId: z
+            .string()
+            .uuid()
+            .describe('The task to update.'),
+        note: z
+            .string()
+            .min(1)
+            .max(500)
+            .describe('One-line progress note in plain English. ' +
+            'Will be appended inside the AI-progress-log sentinel block in the task description. ' +
+            'Example: "Added Zod schema and controller handler for POST /cadence/draft."'),
+        client: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Caller identity for the audit trail (e.g. "claude-code"). ' +
+            'Logged as metadata.client on the cadence_actions row.'),
+    }),
+    handler: async (client, input) => {
+        // Step 1: fetch the current task description so we can append to the AI progress block.
+        const task = await client.get(`/tasks/${input.taskId}`);
+        const now = new Date().toISOString();
+        const clientLabel = input.client ?? 'mcp-agent';
+        const newLine = `[${now}] (${clientLabel}) ${input.note}`;
+        const BEGIN_MARKER = '<!-- BEGIN AI-PROGRESS-LOG -->';
+        const END_MARKER = '<!-- END AI-PROGRESS-LOG -->';
+        const existing = task.description ?? '';
+        let updatedDescription;
+        if (existing.includes(BEGIN_MARKER) && existing.includes(END_MARKER)) {
+            // Append before the closing marker.
+            updatedDescription = existing.replace(END_MARKER, `${newLine}\n${END_MARKER}`);
+        }
+        else {
+            // No sentinel block yet — append one at the end.
+            updatedDescription =
+                existing.trimEnd() +
+                    `\n\n${BEGIN_MARKER}\n${newLine}\n${END_MARKER}`;
+        }
+        // Step 2: update the task description.
+        await client.put(`/tasks/${input.taskId}`, { description: updatedDescription });
+        // Step 3: write a cadence_actions row for the sprint timeline.
+        // action_type='progress_note', target_type='task', payload carries the note + client identity.
+        await client.post('/cadence/actions', {
+            actionType: 'progress_note',
+            targetType: 'task',
+            targetId: input.taskId,
+            rationale: input.note,
+            payload: {
+                via: 'mcp',
+                client: clientLabel,
+                timestamp: now,
+            },
+        });
+        return { success: true, taskId: input.taskId, note: input.note };
+    },
+};
+// ---------------------------------------------------------------------------
+// mark_blocked
+// ---------------------------------------------------------------------------
+const markBlocked = {
+    name: 'mark_blocked',
+    description: 'Mark a task as blocked and record the reason in the Cadence audit trail. ' +
+        'Use when you hit a genuine blocker while working on a task autonomously ' +
+        '(e.g. missing API key, conflicting schema, waiting on another task). ' +
+        'The task status changes to "blocked" and a cadence_actions row is created ' +
+        'so the sprint timeline shows the block and the human can address it. ' +
+        'The reason must be specific enough for a human to act on without asking you.',
+    inputSchema: z.object({
+        taskId: z
+            .string()
+            .uuid()
+            .describe('The task to mark blocked.'),
+        reason: z
+            .string()
+            .min(1)
+            .max(500)
+            .describe('Plain English description of the blocker. Be specific: ' +
+            '"Waiting on OPENAI_API_KEY in the api .env" is actionable. ' +
+            '"It\'s blocked" is not. Minimum 1 character, maximum 500.'),
+        client: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Caller identity for the audit trail (e.g. "claude-code").'),
+    }),
+    handler: async (client, input) => {
+        const clientLabel = input.client ?? 'mcp-agent';
+        const now = new Date().toISOString();
+        // Step 1: update task status to blocked.
+        await client.put(`/tasks/${input.taskId}`, { status: 'blocked' });
+        // Step 2: create a cadence_actions row for the audit trail.
+        await client.post('/cadence/actions', {
+            actionType: 'mark_blocked',
+            targetType: 'task',
+            targetId: input.taskId,
+            rationale: input.reason,
+            payload: {
+                via: 'mcp',
+                client: clientLabel,
+                timestamp: now,
+                reason: input.reason,
+            },
+        });
+        return { success: true, taskId: input.taskId, reason: input.reason };
+    },
+};
+// ---------------------------------------------------------------------------
+// request_unblock
+// ---------------------------------------------------------------------------
+const requestUnblock = {
+    name: 'request_unblock',
+    description: 'Signal that a blocked task needs human attention to unblock. ' +
+        'Use after mark_blocked if you want to escalate urgency or add additional context ' +
+        'beyond the original block reason. ' +
+        'Creates a cadence_actions row with action_type=request_unblock which surfaces ' +
+        'in the next Cadence daily scan and CadenceSidebarPanel stale items list. ' +
+        'Does not change task status (task stays blocked until a human acts).',
+    inputSchema: z.object({
+        taskId: z
+            .string()
+            .uuid()
+            .describe('The blocked task that needs human attention.'),
+        context: z
+            .string()
+            .min(1)
+            .max(500)
+            .optional()
+            .describe('Additional context for the human — e.g. what you tried, what you need to proceed. ' +
+            'Optional but strongly recommended for actionability.'),
+        client: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Caller identity for the audit trail (e.g. "claude-code").'),
+    }),
+    handler: async (client, input) => {
+        const clientLabel = input.client ?? 'mcp-agent';
+        const now = new Date().toISOString();
+        // Write a cadence_actions row with action_type='request_unblock'.
+        // The next daily scan will pick this up and surface it in the stale items list.
+        await client.post('/cadence/actions', {
+            actionType: 'request_unblock',
+            targetType: 'task',
+            targetId: input.taskId,
+            rationale: input.context ?? 'Agent requested human unblock.',
+            payload: {
+                via: 'mcp',
+                client: clientLabel,
+                timestamp: now,
+                context: input.context ?? null,
+            },
+        });
+        return {
+            success: true,
+            taskId: input.taskId,
+            message: 'Unblock request recorded. The next Cadence daily scan will surface this task ' +
+                'in the sprint sidebar for human review.',
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// Export
+// ---------------------------------------------------------------------------
+/** All four Cadence MCP tools. */
+export const cadenceTools = [
+    claimNextTask,
+    reportTaskProgress,
+    markBlocked,
+    requestUnblock,
+];
+//# sourceMappingURL=cadence.js.map

package/dist/tools/cadence.js.map

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

package/dist/tools/index.d.ts

@@ -9,7 +9,9 @@ import { proposalContentTools } from './proposal-content.js';
 import { prReviewTools } from './pr-review.js';
 import { iamTools } from './iam.js';
 import { productTools } from './products.js';
-export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, };
+import { cadenceTools } from './cadence.js';
+import { libraryTools } from './library.js';
+export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, cadenceTools, libraryTools, };
 export type { ToolDefinition };
 /** All tools exposed by the DainOS MCP server. */
 export declare const allTools: ToolDefinition[];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,GACb,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,kDAAkD;AAClD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAWpC,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,kDAAkD;AAClD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAiBpC,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}

package/dist/tools/index.js

@@ -8,7 +8,15 @@ import { proposalContentTools } from './proposal-content.js';
 import { prReviewTools } from './pr-review.js';
 import { iamTools } from './iam.js';
 import { productTools } from './products.js';
-export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, };
+// @anchor:cadence:mcp-import
+// Sprint + Cadence (R4): claim_next_task, report_task_progress, mark_blocked, request_unblock
+import { cadenceTools } from './cadence.js';
+// @anchor:cadence:mcp-import-end
+// @anchor:cloud-mcp:library-import
+// CLOUD MCP (PRD-086): list_instructions, get_instruction, search_instructions
+import { libraryTools } from './library.js';
+// @anchor:cloud-mcp:library-import-end
+export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, cadenceTools, libraryTools, };
 /** All tools exposed by the DainOS MCP server. */
 export const allTools = [
     ...projectTools,
@@ -21,6 +29,12 @@ export const allTools = [
     ...prReviewTools,
     ...iamTools,
     ...productTools,
+    // @anchor:cadence:mcp-registry
+    ...cadenceTools,
+    // @anchor:cadence:mcp-registry-end
+    // @anchor:cloud-mcp:library-registry
+    ...libraryTools,
+    // @anchor:cloud-mcp:library-registry-end
 ];
 /** Look up a tool by its exposed name. */
 export function getTool(name) {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,GACb,CAAC;AAGF,kDAAkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,YAAY;CAChB,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,6BAA6B;AAC7B,8FAA8F;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,iCAAiC;AACjC,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,uCAAuC;AAEvC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,CAAC;AAGF,kDAAkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,YAAY;IACf,+BAA+B;IAC/B,GAAG,YAAY;IACf,mCAAmC;IACnC,qCAAqC;IACrC,GAAG,YAAY;IACf,yCAAyC;CAC1C,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/tools/library.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './types.js';
+export declare const libraryTools: ToolDefinition[];
+//# sourceMappingURL=library.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/tools/library.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0FjD,eAAO,MAAM,YAAY,EAAE,cAAc,EAIxC,CAAC"}

package/dist/tools/library.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+/**
+ * Library tools for the DainOS instruction library (PRD-086).
+ *
+ * Three tools expose the GET /api/v1/instructions endpoints:
+ * - list_instructions: browse by category / project / tags
+ * - get_instruction: fetch one entry by slug with template variable resolution
+ * - search_instructions: keyword search against title/slug/description
+ *
+ * search_instructions and list_instructions both hit GET /api/v1/instructions.
+ * The difference is in the tool descriptions (browsing vs searching) and
+ * required vs optional fields. This keeps the API surface minimal while giving
+ * the model two conceptually distinct operations.
+ */
+const categoryEnum = z.enum([
+    'rule',
+    'skill',
+    'agent',
+    'command',
+    'prompt',
+    'template',
+    'claude_md',
+]);
+const listInstructions = {
+    name: 'list_instructions',
+    description: 'List available instructions from the DainOS library. Returns slug, title, description, and category for each entry. Use category to filter by type (rule, skill, agent, command). Use project to filter by compatibility.',
+    inputSchema: z.object({
+        category: categoryEnum
+            .optional()
+            .describe('Filter by instruction type: rule, skill, agent, command, prompt, template, claude_md.'),
+        project: z
+            .string()
+            .optional()
+            .describe('Project slug (e.g. "herbert", "dain-os"). Filters to entries compatible with this project.'),
+        tags: z.string().optional().describe('Comma-separated tag filter.'),
+        q: z.string().optional().describe('Free-text search.'),
+    }),
+    handler: async (client, input) => {
+        const params = new URLSearchParams();
+        if (input.category)
+            params.set('category', input.category);
+        if (input.project)
+            params.set('project', input.project);
+        if (input.tags)
+            params.set('tags', input.tags);
+        if (input.q)
+            params.set('q', input.q);
+        return client.get(`/instructions?${params.toString()}`);
+    },
+};
+const getInstruction = {
+    name: 'get_instruction',
+    description: 'Fetch a specific instruction by slug with fully resolved template variables. The returned markdown_content is ready to use as a skill, rule, agent, or command body. Any unresolved template variables are listed in unresolved_variables.',
+    inputSchema: z.object({
+        slug: z
+            .string()
+            .describe('Instruction slug (e.g. "rule-core-rules", "skill-ship-architect").'),
+        project: z
+            .string()
+            .optional()
+            .describe('Project slug for template variable resolution.'),
+    }),
+    handler: async (client, input) => {
+        const params = new URLSearchParams();
+        if (input.project)
+            params.set('project', input.project);
+        const qs = params.toString();
+        return client.get(`/instructions/${input.slug}${qs ? `?${qs}` : ''}`);
+    },
+};
+const searchInstructions = {
+    name: 'search_instructions',
+    description: 'Search the instruction library by keyword. Returns ranked results with slug and description. Use this when you know what capability you need but not the exact slug.',
+    inputSchema: z.object({
+        q: z.string().describe('Search query. Matches against title, slug, and description.'),
+        category: categoryEnum.optional(),
+        project: z.string().optional().describe('Project slug to filter by compatibility.'),
+    }),
+    handler: async (client, input) => {
+        const params = new URLSearchParams();
+        params.set('q', input.q);
+        if (input.category)
+            params.set('category', input.category);
+        if (input.project)
+            params.set('project', input.project);
+        return client.get(`/instructions?${params.toString()}`);
+    },
+};
+export const libraryTools = [
+    listInstructions,
+    getInstruction,
+    searchInstructions,
+];
+//# sourceMappingURL=library.js.map

package/dist/tools/library.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dain-os/mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "MCP server for DainOS — manage projects, tasks, proposals, and proposal content from Claude Code and other MCP clients",
   "type": "module",
   "bin": {
@@ -9,6 +9,10 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./http": "./dist/http.js"
+  },
   "files": [
     "dist",
     "README.md"
@@ -21,7 +25,7 @@
     "check-types": "tsc --noEmit"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.23.8"
   },
   "devDependencies": {