@brutalist/mcp 0.8.1 → 0.9.3

package/README.md

@@ -41,6 +41,27 @@ Choose your IDE:
 claude mcp add brutalist --scope user -- npx -y @brutalist/mcp@latest
 ```
 
+**Codex:**
+```bash
+# Install globally once to avoid npx startup chatter
+npm i -g @brutalist/mcp
+# Add MCP using the installed binary (clean stdio)
+codex mcp add brutalist -- brutalist-mcp
+```
+
+**Configuring `tool_timeout_sec` for Codex:**
+The `tool_timeout_sec` parameter (defaulting to 60 seconds) for your Brutalist MCP server needs to be configured directly in your Codex configuration file at `~/.codex/config.toml`. It cannot be passed via the `codex mcp add` command directly.
+
+To set a custom timeout (e.g., 5 minutes or 300 seconds), add or modify the `[mcp_servers.brutalist]` section in `~/.codex/config.toml` as follows:
+
+```toml
+[mcp_servers.brutalist]
+command = "brutalist-mcp" # Ensure this matches your installation command
+args = [] # Depending on your setup, this might be empty or contain arguments
+tool_timeout_sec = 300 # Set your desired timeout in seconds
+```
+
+
 **Cursor:**
 Add to `~/.cursor/mcp.json`:
 ```json
@@ -232,4 +253,4 @@ Getting multiple viewpoints helps identify issues that a single perspective migh
 ---
 
 **License:** MIT
-**Issues:** https://github.com/ejmockler/brutalist-mcp/issues
+**Issues:** https://github.com/ejmockler/brutalist-mcp/issues

package/dist/brutalist-server.d.ts

@@ -1,40 +1,70 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BrutalistServerConfig } from './types/brutalist.js';
+/**
+ * BrutalistServer - Composition root for the Brutalist MCP Server
+ *
+ * This class has been refactored to follow the Single Responsibility Principle.
+ * Responsibilities are now delegated to specialized modules:
+ * - ResponseFormatter: Handles all response formatting and pagination
+ * - HttpTransport: Manages HTTP server and CORS
+ * - ToolHandler: Handles roast tool execution, caching, and conversation continuation
+ */
 export declare class BrutalistServer {
     server: McpServer;
     config: BrutalistServerConfig;
     private cliOrchestrator;
-    private httpTransport?;
     private responseCache;
-    private actualPort?;
-    private httpServer?;
-    private shutdownHandler?;
+    private formatter;
+    private toolHandler;
+    private httpTransport?;
     private activeSessions;
+    private readonly MAX_SESSIONS;
+    private readonly SESSION_TTL_MS;
+    private sessionCleanupTimer?;
     constructor(config?: BrutalistServerConfig);
-    private handleStreamingEvent;
-    private handleProgressUpdate;
     start(): Promise<void>;
     private startStdioServer;
     private startHttpServer;
     getActualPort(): number | undefined;
     stop(): Promise<void>;
+    /**
+     * Clean up stale sessions that exceed TTL
+     */
+    private cleanupStaleSessions;
+    /**
+     * Ensure session capacity doesn't exceed MAX_SESSIONS
+     * Evicts oldest sessions when capacity is reached
+     */
+    ensureSessionCapacity(): void;
     cleanup(): void;
+    /**
+     * Handle streaming events from CLI agents
+     */
+    private handleStreamingEvent;
+    /**
+     * Handle progress updates from CLI agents
+     */
+    private handleProgressUpdate;
+    /**
+     * Register all MCP tools
+     */
     private registerTools;
+    /**
+     * Register special tools (debate, roster)
+     */
     private registerSpecialTools;
     /**
-     * Unified handler for all roast tools - DRY principle
+     * Handle debate tool execution with caching, pagination, and conversation continuation
+     * Delegated mostly to ToolHandler but kept here for CLI debate-specific logic
+     */
+    private handleDebateToolExecution;
+    /**
+     * Execute CLI debate (kept in server for debate-specific logic)
      */
-    private handleRoastTool;
     private executeCLIDebate;
-    private synthesizeDebate;
-    private executeBrutalistAnalysis;
     /**
-     * Extract full content from analysis result for caching
+     * Synthesize debate results into formatted output
      */
-    private extractFullContent;
-    private formatToolResponse;
-    private formatPaginatedResponse;
-    private formatErrorResponse;
-    private handleToolExecution;
+    private synthesizeDebate;
 }
 //# sourceMappingURL=brutalist-server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"brutalist-server.d.ts","sourceRoot":"","sources":["../src/brutalist-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,OAAO,EACL,qBAAqB,EAKtB,MAAM,sBAAsB,CAAC;AAc9B,qBAAa,eAAe;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IACrC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAM;IACzB,OAAO,CAAC,eAAe,CAAC,CAAa;IAErC,OAAO,CAAC,cAAc,CAIjB;gBAEO,MAAM,GAAE,qBAA0B;IA0C9C,OAAO,CAAC,oBAAoB,CAkE1B;IAEF,OAAO,CAAC,oBAAoB,CAsC1B;IAEI,KAAK;YAeG,gBAAgB;YAMhB,eAAe;IAmItB,aAAa,IAAI,MAAM,GAAG,SAAS;IAK7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,oBAAoB;IAoG5B;;OAEG;YACW,eAAe;YAsOf,gBAAgB;IAkK9B,OAAO,CAAC,gBAAgB;YA0FV,wBAAwB;IA0FtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,kBAAkB;IA6F1B,OAAO,CAAC,uBAAuB;IAuH/B,OAAO,CAAC,mBAAmB;YA8Bb,mBAAmB;CAUlC"}
+{"version":3,"file":"brutalist-server.d.ts","sourceRoot":"","sources":["../src/brutalist-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EACL,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAc9B;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAGrC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAgB;IAGrC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IAGtC,OAAO,CAAC,cAAc,CAIjB;IAGL,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAEjC,MAAM,GAAE,qBAA0B;IA2DxC,KAAK;YAeG,gBAAgB;YAMhB,eAAe;IActB,aAAa,IAAI,MAAM,GAAG,SAAS;IAK7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;OAGG;IACI,qBAAqB,IAAI,IAAI;IAc7B,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAgE1B;IAEF;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAsC1B;IAEF;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuG5B;;;OAGG;YACW,yBAAyB;IAmLvC;;OAEG;YACW,gBAAgB;IA0J9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA8FzB"}