Sensei MCP

Instructions

Implementation Reference

• src/prompts.ts:417-471 (handler)

  Handler function for executing the 'dojo_config' tool (and all prompt-based tools). Substitutes input variables into the prompt template, adds Dojo-specific documentation references and nudges based on tool name containing 'dojo' and content analysis, then returns the processed text.
  // Create tool handler that replaces variables and returns the result const toolHandler = async ( inputs: Record<string, string>, // eslint-disable-next-line @typescript-eslint/no-unused-vars _extra: Record<string, unknown>, ): Promise<CallToolResult> => { const span = Logger.span('toolExecution', { tool: toolName }); try { let finalContent = processedContent; // Replace each variable with its value for (const variable of variables) { const value = inputs[variable] || ''; const pattern = new RegExp(`\\{\\{${variable}\\}\\}`, 'g'); finalContent = finalContent.replace(pattern, value); } // If there's a generic input and no specific {{input}} variable, // append it to the end if (inputs.input && !variables.includes('input')) { finalContent = `${finalContent}\n\n${inputs.input}`; } // Add the Dojo documentation nudge if this is a Dojo-related tool // We determine this based on the tool name or the input content const topic = toolName.toLowerCase().includes('dojo') ? toolName.replace('dojo_', '') : undefined; // Use the input content for context if available const inputContext = inputs.input || ''; // If this is for Dojo, first add documentation references to the content if (toolName.toLowerCase().includes('dojo')) { finalContent = addDojoDocReferences(finalContent); } // Then add the documentation nudge based on the content and topic finalContent = addDojoDocsNudge(finalContent + inputContext, topic); span.end('success'); return { content: [ { type: 'text' as const, text: finalContent, }, ], }; } catch (error) { Logger.error(`Tool execution failed: ${toolName}`, error); span.end('error'); throw error; } };
• src/prompts.ts:146-163 (schema)

  Dynamically generates the Zod input schema for the tool based on variables extracted from the prompt content ({{var}} patterns). All variables are optional strings.
  export function generateInputSchema(variables: string[]): ZodRawShape { const schemaObj: Record<string, z.ZodTypeAny> = {}; // Add all other variables for (const variable of variables) { schemaObj[variable] = z.string().optional(); } // Add a dummy parameter to ensure the schema is not empty if (Object.keys(schemaObj).length === 0) { schemaObj._ = z .string() .optional() .describe('Dummy parameter for no-parameter tools'); } return schemaObj; }
• src/prompts.ts:473-485 (registration)

  Registers the tool on the MCP server using server.tool(), with dynamic toolName (from metadata.toolName or filename), optional description from metadata, dynamic schema, and the shared handler. Called for each prompt file with registerAsTool: true.
  // Register the tool if (metadata.description) { // With description server.tool( toolName, metadata.description, schemaObj as ZodRawShape, toolHandler, ); } else { // Without description server.tool(toolName, schemaObj, toolHandler); }
• src/prompts.ts:213-291 (helper)

  Helper function called in the handler for Dojo tools to append topic-specific documentation nudges, including specific handling for 'config' topics relevant to dojo_config tool.
  export function addDojoDocsNudge(content: string, topic?: string): string { // Keywords that indicate code writing or verification tasks const modelKeywords = [ 'model', 'models', 'entity', 'entities', 'data structure', 'schema', ]; const logicKeywords = [ 'system', 'systems', 'logic', 'game logic', 'function', 'functions', 'contract', ]; const configKeywords = [ 'config', 'configuration', 'scarb', 'toml', 'profile', 'deployment', ]; // Check if the content contains any of the keywords const hasModelKeywords = modelKeywords.some((keyword) => content.toLowerCase().includes(keyword.toLowerCase()), ); const hasLogicKeywords = logicKeywords.some((keyword) => content.toLowerCase().includes(keyword.toLowerCase()), ); const hasConfigKeywords = configKeywords.some((keyword) => content.toLowerCase().includes(keyword.toLowerCase()), ); // Customize nudge based on the specific topic let nudge = ''; if (topic) { // If a specific topic is provided if (topic.toLowerCase().includes('model')) { nudge = '\n\n📚 **Verify your model code against the [Dojo Models documentation](https://www.dojoengine.org/framework/models). Make sure to implement proper traits and follow entity relationships best practices.**'; } else if ( topic.toLowerCase().includes('logic') || topic.toLowerCase().includes('system') ) { nudge = '\n\n📚 **Verify your system logic against the [Dojo Systems documentation](https://www.dojoengine.org/framework/world/systems). Ensure correct world state management and authorization patterns.**'; } else if (topic.toLowerCase().includes('config')) { nudge = '\n\n📚 **Verify your configuration against the [Dojo Config documentation](https://www.dojoengine.org/framework/config). Check for proper Scarb.toml setup and profile configuration.**'; } } else { // Determine topic based on keyword presence if (hasModelKeywords) { nudge = '\n\n📚 **Verify your model code against the [Dojo Models documentation](https://www.dojoengine.org/framework/models). Make sure to implement proper traits and follow entity relationships best practices.**'; } else if (hasLogicKeywords) { nudge = '\n\n📚 **Verify your system logic against the [Dojo Systems documentation](https://www.dojoengine.org/framework/world/systems). Ensure correct world state management and authorization patterns.**'; } else if (hasConfigKeywords) { nudge = '\n\n📚 **Verify your configuration against the [Dojo Config documentation](https://www.dojoengine.org/framework/config). Check for proper Scarb.toml setup and profile configuration.**'; } } // Add a general Dojo nudge if no specific topic was detected if (!nudge && (hasModelKeywords || hasLogicKeywords || hasConfigKeywords)) { nudge = '\n\n📚 **Verify your Dojo code against the [official documentation](https://www.dojoengine.org/overview). Follow best practices for building provable games and applications.**'; } return nudge ? content + nudge : content; }
• src/prompts.ts:296-365 (helper)

  Helper function called in the handler for Dojo tools to append relevant Dojo documentation links based on content patterns, with specific config-related detection for dojo_config.
  export function addDojoDocReferences(content: string): string { // Don't modify content that already has documentation references if ( content.includes('dojoengine.org/framework') || content.includes('dojoengine.org/toolchain') ) { return content; } // Check for different types of Dojo content const hasModelContent = content.includes('#[dojo::model]') || content.includes('#[key]') || content.includes('derive(Model') || content.includes('derive(Drop, Serde)'); const hasSystemContent = content.includes('#[dojo::contract]') || content.includes('world.read_model') || content.includes('world.write_model') || content.includes('self.world('); const hasConfigContent = content.includes('Scarb.toml') || content.includes('dojo_') || content.includes('[writers]') || content.includes('[target.starknet-contract]'); // Add appropriate documentation references based on content type if (hasModelContent) { return ( content + '\n\n---\n**Reference Documentation:**\n' + '- [Models Overview](https://www.dojoengine.org/framework/models)\n' + '- [Entities in Dojo](https://www.dojoengine.org/framework/models/entities)\n' + '- [Model Introspection](https://www.dojoengine.org/framework/models/introspect)' ); } else if (hasSystemContent) { return ( content + '\n\n---\n**Reference Documentation:**\n' + '- [Systems](https://www.dojoengine.org/framework/world/systems)\n' + '- [World API](https://www.dojoengine.org/framework/world/api)\n' + '- [Authorization](https://www.dojoengine.org/framework/authorization)' ); } else if (hasConfigContent) { return ( content + '\n\n---\n**Reference Documentation:**\n' + '- [Configuration Guide](https://www.dojoengine.org/framework/config)\n' + '- [Sozo Commands](https://www.dojoengine.org/toolchain/sozo)\n' + '- [World Contract](https://www.dojoengine.org/framework/world)' ); } // If content has cairo code but not specific Dojo patterns, add general Dojo reference if ( content.includes('fn ') && content.includes('struct ') && content.includes('impl ') ) { return ( content + '\n\n---\n**Reference Documentation:**\n' + '- [Dojo Documentation](https://www.dojoengine.org/overview)' ); } return content; }