deny_command
Reject pending shell commands with a specified reason to maintain security and control in the Super Shell MCP Server environment.
Instructions
Deny a pending command
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| commandId | Yes | ID of the command to deny | |
| reason | No | Reason for denial |
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(), });
- 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)); }