@gotza02/mathinking 1.0.0

package/dist/index.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+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 { thinkingManager } from './tools/sequential-thinking.js';
+import { orchestratorManager } from './tools/orchestrator.js';
+// ============================================
+// Tool Definitions
+// ============================================
+const SEQUENTIAL_THINKING_TOOL = {
+    name: 'sequential_thinking',
+    description: `🧠 The Brain - Deep Reasoning & Planning Tool
+
+A powerful iterative thinking system for complex problem-solving with:
+• Step-by-step reasoning with adjustable depth
+• Branching for exploring alternative approaches
+• Revision capability to correct previous thoughts  
+• Hypothesis formulation and verification
+• Confidence tracking and synthesis
+
+ACTIONS:
+- start_session: Begin a new thinking session
+- add_thought: Add a reasoning step
+- create_branch: Explore alternative paths
+- revise_thought: Correct previous thinking
+- set_hypothesis: Propose a testable theory
+- verify_hypothesis: Confirm/refute with evidence
+- adjust_total_thoughts: Change thinking depth
+- conclude: Synthesize final answer
+- get_status: Check session progress
+- get_history: Review all thoughts
+
+Use this BEFORE orchestrator to plan complex tasks.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [
+                    'start_session',
+                    'add_thought',
+                    'create_branch',
+                    'revise_thought',
+                    'set_hypothesis',
+                    'verify_hypothesis',
+                    'adjust_total_thoughts',
+                    'conclude',
+                    'get_status',
+                    'get_history'
+                ],
+                description: 'The thinking action to perform'
+            },
+            sessionId: {
+                type: 'string',
+                description: 'Session ID (required for all actions except start_session)'
+            },
+            problemStatement: {
+                type: 'string',
+                description: 'The problem to analyze (required for start_session)'
+            },
+            thought: {
+                type: 'string',
+                description: 'The thought content'
+            },
+            thoughtType: {
+                type: 'string',
+                enum: [
+                    'initial_analysis',
+                    'decomposition',
+                    'hypothesis',
+                    'verification',
+                    'branch_exploration',
+                    'synthesis',
+                    'revision',
+                    'conclusion'
+                ],
+                description: 'Type of thought being added'
+            },
+            totalThoughts: {
+                type: 'number',
+                description: 'Total number of thinking steps (for start_session or adjust_total_thoughts)'
+            },
+            branchFromThoughtId: {
+                type: 'string',
+                description: 'ID of thought to branch from'
+            },
+            branchLabel: {
+                type: 'string',
+                description: 'Label for the new branch (e.g., "Option A")'
+            },
+            reviseThoughtId: {
+                type: 'string',
+                description: 'ID of thought to revise'
+            },
+            hypothesis: {
+                type: 'string',
+                description: 'Hypothesis statement to test'
+            },
+            verificationEvidence: {
+                type: 'string',
+                description: 'Evidence supporting verification decision'
+            },
+            verificationStatus: {
+                type: 'string',
+                enum: ['verified', 'refuted', 'partially_verified', 'needs_more_evidence'],
+                description: 'Result of hypothesis verification'
+            },
+            confidence: {
+                type: 'number',
+                minimum: 0,
+                maximum: 100,
+                description: 'Confidence level (0-100)'
+            }
+        },
+        required: ['action']
+    }
+};
+const ORCHESTRATOR_TOOL = {
+    name: 'orchestrator',
+    description: `🤖 The Body - Parallel Task Execution Engine
+
+A DAG-based orchestration system for executing complex task plans with:
+• Topological sorting for dependency resolution
+• Parallel execution of independent tasks
+• Tool chaining with output references
+• Graceful error handling with retries
+• Result aggregation
+
+ACTIONS:
+- validate_plan: Check plan validity and view execution order
+- execute_plan: Run the full plan with parallel processing
+- get_execution_status: Check results of previous execution
+
+PLAN FORMAT:
+{
+  "planId": "unique-id",
+  "name": "Plan Name",
+  "tasks": [
+    {
+      "id": "task1",
+      "name": "First Task",
+      "toolName": "echo|delay|transform|aggregate|fetch|compute",
+      "toolInput": { "key": "value" },
+      "dependencies": [],
+      "timeout": 5000,
+      "retryCount": 2
+    },
+    {
+      "id": "task2", 
+      "name": "Second Task",
+      "toolName": "transform",
+      "toolInput": { "data": "\${task1.result}" },
+      "dependencies": ["task1"]
+    }
+  ]
+}
+
+Use \${taskId} or \${taskId.property} to reference previous task outputs.
+
+BUILT-IN TOOLS:
+- echo: Returns input as-is
+- delay: Waits specified milliseconds
+- transform: uppercase/lowercase/reverse/length/double
+- aggregate: sum/concat/array/count
+- fetch: Simulated HTTP fetch
+- compute: Math expressions with variables`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['execute_plan', 'validate_plan', 'get_execution_status'],
+                description: 'The orchestration action to perform'
+            },
+            plan: {
+                type: 'object',
+                description: 'The execution plan (required for execute_plan and validate_plan)',
+                properties: {
+                    planId: { type: 'string' },
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    tasks: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                id: { type: 'string' },
+                                name: { type: 'string' },
+                                description: { type: 'string' },
+                                toolName: { type: 'string' },
+                                toolInput: { type: 'object' },
+                                dependencies: { type: 'array', items: { type: 'string' } },
+                                timeout: { type: 'number' },
+                                retryCount: { type: 'number' },
+                                retryDelay: { type: 'number' }
+                            },
+                            required: ['id', 'name', 'toolName', 'toolInput', 'dependencies']
+                        }
+                    }
+                },
+                required: ['planId', 'name', 'tasks']
+            },
+            planId: {
+                type: 'string',
+                description: 'Plan ID (required for get_execution_status)'
+            }
+        },
+        required: ['action']
+    }
+};
+// ============================================
+// Server Setup
+// ============================================
+const server = new Server({
+    name: 'intelligent-agent-mcp',
+    version: '1.0.0'
+}, {
+    capabilities: {
+        tools: {}
+    }
+});
+// ============================================
+// Request Handlers
+// ============================================
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [SEQUENTIAL_THINKING_TOOL, ORCHESTRATOR_TOOL]
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'sequential_thinking': {
+                const input = args;
+                const result = await thinkingManager.process(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2)
+                        }
+                    ]
+                };
+            }
+            case 'orchestrator': {
+                const input = args;
+                const result = await orchestratorManager.process(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2)
+                        }
+                    ]
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Unknown tool: ${name}`
+                        }
+                    ],
+                    isError: true
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error executing ${name}: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+});
+// ============================================
+// Main Entry Point
+// ============================================
+async function main() {
+    console.error('🚀 Intelligent Agent MCP Server starting...');
+    console.error('📦 Tools: sequential_thinking (The Brain), orchestrator (The Body)');
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('✅ Server connected and ready!');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,65 @@
+import type { OrchestratorInput, OrchestratorOutput, ToolDefinition } from '../types/index.js';
+/**
+ * Orchestrator Manager (The Body)
+ *
+ * Provides DAG-based task execution with:
+ * - Topological sorting for dependency resolution
+ * - Parallel execution of independent tasks
+ * - Tool orchestration via registry
+ * - Graceful error handling
+ * - Result aggregation
+ */
+export declare class OrchestratorManager {
+    private toolRegistry;
+    private executionHistory;
+    constructor();
+    /**
+     * Register built-in tools for testing and common operations
+     */
+    private registerBuiltInTools;
+    /**
+     * Register a custom tool
+     */
+    registerTool(tool: ToolDefinition): void;
+    /**
+     * Get list of registered tools
+     */
+    getRegisteredTools(): string[];
+    /**
+     * Process an orchestrator action
+     */
+    process(input: OrchestratorInput): Promise<OrchestratorOutput>;
+    /**
+     * Validate an execution plan
+     */
+    private validatePlan;
+    /**
+     * Execute a plan with parallel processing
+     */
+    private executePlan;
+    /**
+     * Execute a single task with error handling and retries
+     */
+    private executeTask;
+    /**
+     * Resolve input placeholders with outputs from previous tasks
+     * Supports syntax: "${taskId.property}" or "${taskId}"
+     */
+    private resolveInput;
+    private resolveValue;
+    private resolvePlaceholder;
+    /**
+     * Execute a promise with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Get execution status for a plan
+     */
+    private getExecutionStatus;
+    /**
+     * Format execution summary for display
+     */
+    private formatExecutionSummary;
+}
+export declare const orchestratorManager: OrchestratorManager;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAMV,iBAAiB,EACjB,kBAAkB,EAElB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAA2C;;IAMnE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmH5B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgBpE;;OAEG;IACH,OAAO,CAAC,YAAY;IAsCpB;;OAEG;YACW,WAAW;IAmGzB;;OAEG;YACW,WAAW;IAsGzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA4B/B;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}