MCP Dual-Cycle Reasoner

Instructions

Implementation Reference

• src/server.ts:641-658 (handler)

  MCP tool handler for reset_engine: retrieves session engine and calls its reset() method, with logging and error handling.

  execute: async (args, { log, session }) => {
    try {
      const sessionEngine = this.getSessionEngine(session);
      const sessionId = this.sessionIds.get(session);
  
      log.warn('Resetting dual-cycle engine state', { sessionId });
  
      sessionEngine.reset();
  
      log.info('Engine reset completed successfully');
  
      return '🔄 Dual-Cycle Engine has been reset';
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      log.error('Failed to reset engine', { error: errorMessage });
      throw new UserError(`Failed to reset engine: ${errorMessage}`);
    }
  },

• src/server.ts:629-660 (registration)

  Registers the reset_engine tool with the FastMCP server, including schema (empty params), annotations, and handler reference. Called from setupTools() at line 231.

  private addResetEngineTool(): void {
    this.server.addTool({
      name: 'reset_engine',
      description: 'Reset the dual-cycle engine state',
      parameters: z.object({}),
      annotations: {
        title: 'Reset Engine State',
        readOnlyHint: false,
        destructiveHint: true,
        idempotentHint: true,
        openWorldHint: false,
      },
      execute: async (args, { log, session }) => {
        try {
          const sessionEngine = this.getSessionEngine(session);
          const sessionId = this.sessionIds.get(session);
  
          log.warn('Resetting dual-cycle engine state', { sessionId });
  
          sessionEngine.reset();
  
          log.info('Engine reset completed successfully');
  
          return '🔄 Dual-Cycle Engine has been reset';
        } catch (error) {
          const errorMessage = error instanceof Error ? error.message : String(error);
          log.error('Failed to reset engine', { error: errorMessage });
          throw new UserError(`Failed to reset engine: ${errorMessage}`);
        }
      },
    });
  }

• src/dual-cycle-engine.ts:222-229 (helper)

  Core reset logic in DualCycleEngine: resets sentinel, reinitializes trace, stops monitoring, clears counters and action history.

  reset(): void {
    this.sentinel.reset();
    this.currentTrace = this.initializeTrace();
    this.isMonitoring = false;
    this.interventionCount = 0;
    this.accumulatedActions = [];
    console.log(chalk.blue('🔄 Dual-Cycle Engine reset'));
  }

• src/server.ts:633-633 (schema)

  Input schema for reset_engine tool: empty object (no parameters required).

  parameters: z.object({}),