The Renaming! (#222)

Author: jahooma

.agents/templates/brainstormer.ts

@@ -6,14 +6,14 @@ export default {
   version: '1.0.0',
   override: false,
 
-  name: 'Brian the Brainstormer',
-  purpose:
+  displayName: 'Brian the Brainstormer',
+  parentPrompt:
     'Acts as a creative thought partner, generating ideas and exploring alternative viewpoints to help think through problems.',
   model: 'anthropic/claude-4-sonnet-20250522',
   outputMode: 'last_message',
   includeMessageHistory: true,
   toolNames: ['end_turn'],
-  spawnableAgents: ['thinker', 'researcher'],
+  subagents: ['thinker', 'researcher'],
   parentInstructions: {
     base: 'Spawn brainstormer when you need creative alternatives, want to challenge assumptions, or explore different approaches to implementation problems',
     base_lite:
@@ -27,7 +27,7 @@ export default {
     reviewer:
       'Engage brainstormer for creative problem-solving approaches to code review and innovative improvement suggestions',
   },
-  promptSchema: {
+  inputSchema: {
     prompt: z.toJSONSchema(
       z.string().describe('The problem or topic to brainstorm about.')
     ),
@@ -37,8 +37,8 @@ export default {
     path: '.agents/templates/brainstormer-system.md',
   },
 
-  userInputPrompt:
+  instructionsPrompt:
     'Act as a creative thought partner. Generate multiple perspectives, challenge assumptions, explore alternatives, and ask probing questions to help think through problems more thoroughly.',
-  agentStepPrompt:
+  stepPrompt:
     "Continue brainstorming and exploring ideas. When you're done, use the end_turn tool: ",
 } satisfies DynamicAgentConfig

.agents/templates/example-handlesteps-agent.ts

@@ -3,18 +3,18 @@ import { DynamicAgentConfig } from '@codebuff/common/types/dynamic-agent-templat
 export default {
   id: 'example-handlesteps-agent',
   version: '1.0.0',
-  name: 'Example HandleSteps Agent',
-  purpose:
+  displayName: 'Example HandleSteps Agent',
+  parentPrompt:
     'Demonstrates how to use handleSteps generator functions for programmatic agent control',
   model: 'claude-3-5-sonnet-20241022',
   outputMode: 'json',
   toolNames: ['spawn_agents', 'set_output', 'end_turn'],
-  spawnableAgents: ['file_picker'],
+  subagents: ['file_picker'],
 
   systemPrompt:
     'You are an example agent that demonstrates handleSteps functionality.',
-  userInputPrompt: 'User request: {prompt}',
-  agentStepPrompt: 'Continue processing the request.',
+  instructionsPrompt: 'User request: {prompt}',
+  stepPrompt: 'Continue processing the request.',
 
   // Generator function that defines the agent's execution flow
   handleSteps: function* ({ agentState, prompt, params }) {

.agents/templates/git-committer.ts

@@ -4,10 +4,10 @@ export default {
   id: 'CodebuffAI/git-committer',
   version: '0.0.1',
   model: 'anthropic/claude-sonnet-4',
-  name: 'Git Committer',
-  purpose:
+  displayName: 'Git Committer',
+  parentPrompt:
     'A git committer agent specialized to commit current changes with an appropriate commit message.',
-  promptSchema: {
+  inputSchema: {
     prompt: {
       type: 'string',
       description: 'What changes to commit',
@@ -24,9 +24,9 @@ export default {
   ],
   systemPrompt:
     'You are an expert software developer. Your job is to create a git commit with a really good commit message.',
-  userInputPrompt: {
+  instructionsPrompt: {
     path: './git-committer-user-prompt.md',
   },
-  agentStepPrompt:
+  stepPrompt:
     'Make sure to end your response by using set_output to output a structured summary of what you committed and whether it was successful. Finally, use end_turn to end your turn.',
 } satisfies DynamicAgentConfig

.agents/templates/knowledge-keeper.ts

@@ -4,8 +4,8 @@ export default {
   id: 'knowledge-keeper',
   version: '1.0.0',
   override: false,
-  name: 'Kendra the Knowledge Keeper',
-  purpose:
+  displayName: 'Kendra the Knowledge Keeper',
+  parentPrompt:
     'Expert at gathering, organizing, and maintaining project knowledge files and documentation.',
   model: 'anthropic/claude-4-sonnet-20250522',
   outputMode: 'last_message',
@@ -19,8 +19,8 @@ export default {
     'spawn_agents',
     'end_turn',
   ],
-  spawnableAgents: ['file_picker', 'researcher'],
-  promptSchema: {
+  subagents: ['file_picker', 'researcher'],
+  inputSchema: {
     prompt: {
       type: 'string',
       description: 'A request to gather, organize, or update project knowledge',
@@ -43,8 +43,8 @@ export default {
   },
   systemPrompt:
     'You are Kendra the Knowledge Keeper, a specialized agent focused on gathering, organizing, and maintaining project knowledge. Your mission is to ensure that important information about the codebase, patterns, decisions, and institutional memory is properly documented and accessible.\n\nYour core responsibilities:\n1. Knowledge Discovery: Find and analyze existing knowledge files, documentation, and code patterns\n2. Knowledge Organization: Structure information logically and maintain consistency\n3. Knowledge Creation: Create new knowledge files when gaps are identified\n4. Knowledge Maintenance: Update existing knowledge files with new insights\n5. Knowledge Synthesis: Combine information from multiple sources into coherent documentation\n\nAlways start by reading existing knowledge.md files and documentation. Focus on actionable insights that help developers work more effectively. End your response with the end_turn tool.',
-  userInputPrompt:
+  instructionsPrompt:
     'Analyze the current state of project knowledge and provide recommendations for improvements. Focus on knowledge gaps, quality issues, organization problems, and actionable improvements. Then implement the most important changes.',
-  agentStepPrompt:
+  stepPrompt:
     'Continue your knowledge management work. Focus on the most impactful improvements and always end with the end_turn tool.',
 } satisfies DynamicAgentConfig

backend/knowledge.md

@@ -72,8 +72,8 @@ flowchart TD
       path?: string,     // External file path
       content?: string   // Inline content
     },
-    userInputPrompt?: { /* same structure */ },
-    agentStepPrompt?: { /* same structure */ },
+    instructionsPrompt?: { /* same structure */ },
+    stepPrompt?: { /* same structure */ },
     spawnableAgents?: {  // Modify spawnable agents list
       type: 'append' | 'replace',
       content: string | string[]

backend/src/__tests__/dynamic-agent-loader.test.ts

@@ -77,14 +77,14 @@ describe('Dynamic Agent Loader', () => {
           id: 'brainstormer',
           version: '1.0.0',
           override: false,
-          name: 'Brainy',
-          purpose: 'Creative thought partner',
+          displayName: 'Brainy',
+          parentPrompt: 'Creative thought partner',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'You are a creative brainstormer.',
-          userInputPrompt: 'Help brainstorm ideas.',
-          agentStepPrompt: 'Continue brainstorming.',
+          instructionsPrompt: 'Help brainstorm ideas.',
+          stepPrompt: 'Continue brainstorming.',
           toolNames: ['end_turn'],
-          spawnableAgents: ['thinker', 'researcher'],
+          subagents: ['thinker', 'researcher'],
 
           outputMode: 'last_message',
           includeMessageHistory: true,
@@ -96,7 +96,7 @@ describe('Dynamic Agent Loader', () => {
 
     expect(result.validationErrors).toHaveLength(0)
     expect(result.templates).toHaveProperty('brainstormer')
-    expect(result.templates.brainstormer.name).toBe('Brainy')
+    expect(result.templates.brainstormer.displayName).toBe('Brainy')
     expect(result.templates.brainstormer.id).toBe('brainstormer')
   })
 
@@ -108,13 +108,13 @@ describe('Dynamic Agent Loader', () => {
           id: 'invalid_agent',
           version: '1.0.0',
           override: false,
-          name: 'Invalid',
-          purpose: 'Invalid agent',
+          displayName: 'Invalid',
+          parentPrompt: 'Invalid agent',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Test',
-          userInputPrompt: 'Test',
-          agentStepPrompt: 'Test',
-          spawnableAgents: ['nonexistent_agent'],
+          instructionsPrompt: 'Test',
+          stepPrompt: 'Test',
+          subagents: ['nonexistent_agent'],
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
@@ -126,7 +126,7 @@ describe('Dynamic Agent Loader', () => {
 
     expect(result.validationErrors).toHaveLength(1)
     expect(result.validationErrors[0].message).toContain(
-      'Invalid spawnable agents: nonexistent_agent'
+      'Invalid subagents: nonexistent_agent'
     )
   })
 
@@ -138,16 +138,16 @@ describe('Dynamic Agent Loader', () => {
           id: 'custom_agent',
           version: '1.0.0',
           override: false,
-          name: 'Custom',
-          purpose: 'Custom agent',
+          displayName: 'Custom',
+          parentPrompt: 'Custom agent',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Custom system prompt',
-          userInputPrompt: 'Custom user prompt',
-          agentStepPrompt: 'Custom step prompt',
+          instructionsPrompt: 'Custom user prompt',
+          stepPrompt: 'Custom step prompt',
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
-          spawnableAgents: [],
+          subagents: [],
         },
       },
     }
@@ -169,13 +169,13 @@ describe('Dynamic Agent Loader', () => {
           id: 'schema_agent',
           version: '1.0.0',
           override: false,
-          name: 'Schema Agent',
-          purpose: 'Agent with JSON schemas',
+          displayName: 'Schema Agent',
+          parentPrompt: 'Agent with JSON schemas',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Test system prompt',
-          userInputPrompt: 'Test user prompt',
-          agentStepPrompt: 'Test step prompt',
-          promptSchema: {
+          instructionsPrompt: 'Test user prompt',
+          stepPrompt: 'Test step prompt',
+          inputSchema: {
             prompt: {
               type: 'string',
               description: 'A test prompt',
@@ -190,7 +190,7 @@ describe('Dynamic Agent Loader', () => {
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
-          spawnableAgents: [],
+          subagents: [],
         },
       },
     }
@@ -199,8 +199,8 @@ describe('Dynamic Agent Loader', () => {
 
     expect(result.validationErrors).toHaveLength(0)
     expect(result.templates).toHaveProperty('schema_agent')
-    expect(result.templates.schema_agent.promptSchema.prompt).toBeDefined()
-    expect(result.templates.schema_agent.promptSchema.params).toBeDefined()
+    expect(result.templates.schema_agent.inputSchema.prompt).toBeDefined()
+    expect(result.templates.schema_agent.inputSchema.params).toBeDefined()
   })
 
   it('should return validation errors for invalid schemas', async () => {
@@ -214,21 +214,21 @@ describe('Dynamic Agent Loader', () => {
           id: 'invalid_schema_agent',
           version: '1.0.0',
           override: false,
-          name: 'Invalid Schema Agent',
-          purpose: 'Agent with invalid schemas',
+          displayName: 'Invalid Schema Agent',
+          parentPrompt: 'Agent with invalid schemas',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Test system prompt',
-          userInputPrompt: 'Test user prompt',
-          agentStepPrompt: 'Test step prompt',
-          promptSchema: {
+          instructionsPrompt: 'Test user prompt',
+          stepPrompt: 'Test step prompt',
+          inputSchema: {
             prompt: {
               type: 'number', // Invalid - should allow strings
             },
           },
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
-          spawnableAgents: [],
+          subagents: [],
         },
       },
     }
@@ -237,7 +237,7 @@ describe('Dynamic Agent Loader', () => {
 
     expect(result.validationErrors).toHaveLength(1)
     expect(result.validationErrors[0].message).toContain(
-      'Invalid promptSchema.prompt'
+      'Invalid inputSchema.prompt'
     )
     expect(result.validationErrors[0].message).toContain(
       'Schema must allow string or undefined values'
@@ -255,17 +255,17 @@ describe('Dynamic Agent Loader', () => {
           id: 'no_override_agent',
           version: '1.0.0',
           // No override field - should be treated as non-override
-          name: 'No Override Agent',
-          purpose: 'Agent without override field',
+          displayName: 'No Override Agent',
+          parentPrompt: 'Agent without override field',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Test system prompt',
-          userInputPrompt: 'Test user prompt',
-          agentStepPrompt: 'Test step prompt',
+          instructionsPrompt: 'Test user prompt',
+          stepPrompt: 'Test step prompt',
           override: false,
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
-          spawnableAgents: [],
+          subagents: [],
         },
       },
     }
@@ -286,13 +286,13 @@ describe('Dynamic Agent Loader', () => {
           id: 'CodebuffAI/git-committer',
           version: '0.0.1',
           override: false,
-          name: 'Git Committer',
-          purpose: 'A git committer agent',
+          displayName: 'Git Committer',
+          parentPrompt: 'A git committer agent',
           model: 'google/gemini-2.5-pro',
           systemPrompt: 'You are an expert software developer.',
-          userInputPrompt: 'Create a commit message.',
-          agentStepPrompt: 'Make sure to end your response.',
-          spawnableAgents: [], // No spawnable agents
+          instructionsPrompt: 'Create a commit message.',
+          stepPrompt: 'Make sure to end your response.',
+          subagents: [], // No spawnable agents
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
@@ -301,13 +301,13 @@ describe('Dynamic Agent Loader', () => {
           id: 'spawner_agent',
           version: '1.0.0',
           override: false,
-          name: 'Spawner Agent',
-          purpose: 'Agent that can spawn git-committer',
+          displayName: 'Spawner Agent',
+          parentPrompt: 'Agent that can spawn git-committer',
           model: 'anthropic/claude-4-sonnet-20250522',
           systemPrompt: 'Test system prompt',
-          userInputPrompt: 'Test user prompt',
-          agentStepPrompt: 'Test step prompt',
-          spawnableAgents: ['CodebuffAI/git-committer'], // Should be valid after first pass
+          instructionsPrompt: 'Test user prompt',
+          stepPrompt: 'Test step prompt',
+          subagents: ['CodebuffAI/git-committer'], // Should be valid after first pass
           outputMode: 'last_message',
           includeMessageHistory: true,
           toolNames: ['end_turn'],
@@ -320,7 +320,7 @@ describe('Dynamic Agent Loader', () => {
     expect(result.validationErrors).toHaveLength(0)
     expect(result.templates).toHaveProperty('CodebuffAI/git-committer')
     expect(result.templates).toHaveProperty('spawner_agent')
-    expect(result.templates.spawner_agent.spawnableAgents).toContain(
+    expect(result.templates.spawner_agent.subagents).toContain(
       'git-committer' // Normalized without prefix
     )
   })