Super Shell MCP Server

Instructions

Implementation Reference

• src/index.ts:650-689 (handler)

  Primary handler function for the 'deny_command' tool. Validates input with Zod, logs activity, delegates to CommandService.denyCommand, and returns MCP-formatted response.

  private async handleDenyCommand(args: any) {
    const schema = z.object({
      commandId: z.string(),
      reason: z.string().optional(),
    });
  
    logger.debug(`handleDenyCommand called with args: ${JSON.stringify(args)}`);
  
    const { commandId, reason } = schema.parse(args);
  
    logger.debug(`[Denial Attempt] ID: ${commandId}, Reason: ${reason || 'none provided'}`);
  
    try {
      this.commandService.denyCommand(commandId, reason);
      logger.info(`Command denied: ID: ${commandId}, Reason: ${reason || 'none provided'}`);
      
      return {
        content: [
          {
            type: 'text',
            text: `Command denied${reason ? `: ${reason}` : ''}`,
          },
        ],
      };
    } catch (error) {
      logger.error(`[Denial Error] ID: ${commandId}, Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
      
      if (error instanceof Error) {
        return {
          content: [
            {
              type: 'text',
              text: `Command denial failed: ${error.message}`,
            },
          ],
          isError: true,
        };
      }
      throw error;
    }

• src/index.ts:256-273 (registration)

  Tool registration in ListToolsRequestSchema handler, defining name, description, and input schema for 'deny_command'.

  {
    name: 'deny_command',
    description: 'Deny a pending command',
    inputSchema: {
      type: 'object',
      properties: {
        commandId: {
          type: 'string',
          description: 'ID of the command to deny',
        },
        reason: {
          type: 'string',
          description: 'Reason for denial',
        },
      },
      required: ['commandId'],
    },
  },

• src/index.ts:651-654 (schema)

  Runtime Zod schema validation for deny_command tool inputs within the handler.

  const schema = z.object({
    commandId: z.string(),
    reason: z.string().optional(),
  });

• src/services/command-service.ts:423-437 (helper)

  Core denyCommand method in CommandService: removes pending command, emits denial event, rejects promise. Called by tool handler.

  public denyCommand(commandId: string, reason: string = 'Command denied'): void {
    const pendingCommand = this.pendingCommands.get(commandId);
    if (!pendingCommand) {
      throw new Error(`No pending command with ID: ${commandId}`);
    }
  
    // Remove from pending queue
    this.pendingCommands.delete(commandId);
    
    // Emit event for denied command
    this.emit('command:denied', { commandId, reason });
    
    // Reject the original promise
    pendingCommand.reject(new Error(reason));
  }