Delete send_agent_message tool

jahooma · jahooma · commit 31862b4b644e · 2025-08-10T14:35:00.000-07:00
diff --git a/backend/src/run-agent-step.ts b/backend/src/run-agent-step.ts
@@ -212,18 +212,6 @@ export const runAgentStep = async (
       // Update status to running for existing agents
       asyncAgentManager.updateAgentState(agentState, 'running')
     }
-
-    // Check for pending messages from other agents
-    const pendingMessages = asyncAgentManager.getAndClearMessages(
-      agentState.agentId,
-    )
-    for (const message of pendingMessages) {
-      toolResults.push({
-        toolName: 'send_agent_message',
-        toolCallId: generateCompactId(),
-        result: `Message from agent ${message.fromAgentId}:\n\nPrompt: ${message.prompt}${message.params ? `\n\nParams: ${JSON.stringify(message.params, null, 2)}` : ''}`,
-      })
-    }
   }
 
   const agentTemplate = await getAgentTemplate(agentType, localAgentTemplates)
diff --git a/backend/src/templates/agents/superagent.ts b/backend/src/templates/agents/superagent.ts
@@ -19,13 +19,7 @@ export const superagent = (
   },
   outputMode: 'last_message',
   includeMessageHistory: false,
-  toolNames: [
-    'spawn_agents',
-    'spawn_agents_async',
-    'send_agent_message',
-    'end_turn',
-    'think_deeply',
-  ],
+  toolNames: ['spawn_agents', 'spawn_agents_async', 'end_turn', 'think_deeply'],
   subagents: allAvailableAgents
     ? (allAvailableAgents as any[])
     : [
@@ -50,8 +44,6 @@ If you are gathering information, spawn the "ask" agent synchronously (spawn_age
 
 If you are delegating a coding task, spawn the "base" agent *asynchronously* (spawn_agents_async) so you can help the user with other tasks while the spawned agent works on the code.
 
-Prefer sending a message to a previous agent over spawning a new agent, especially if that agent was previously working on a similar task.
-
 Feel free to ask the user for clarification if you are unsure what to do.
 `.trim(),
   stepPrompt:
diff --git a/backend/src/tools/definitions/list.ts b/backend/src/tools/definitions/list.ts
@@ -11,7 +11,6 @@ import { readDocsTool } from './tool/read-docs'
 import { readFilesTool } from './tool/read-files'
 import { runFileChangeHooksTool } from './tool/run-file-change-hooks'
 import { runTerminalCommandTool } from './tool/run-terminal-command'
-import { sendAgentMessageTool } from './tool/send-agent-message'
 import { setMessagesTool } from './tool/set-messages'
 import { setOutputTool } from './tool/set-output'
 import { spawnAgentsTool } from './tool/spawn-agents'
@@ -39,7 +38,6 @@ const toolDescriptions = {
   read_files: readFilesTool,
   run_file_change_hooks: runFileChangeHooksTool,
   run_terminal_command: runTerminalCommandTool,
-  send_agent_message: sendAgentMessageTool,
   set_messages: setMessagesTool,
   set_output: setOutputTool,
   spawn_agents: spawnAgentsTool,
diff --git a/backend/src/tools/definitions/tool/send-agent-message.ts b/backend/src/tools/definitions/tool/send-agent-message.ts
diff --git a/backend/src/tools/definitions/tool/spawn-agents-async.ts b/backend/src/tools/definitions/tool/spawn-agents-async.ts
@@ -8,7 +8,7 @@ export const spawnAgentsAsyncTool = {
   description: `
 Use this tool to spawn subagents asynchronously to help you complete the user request. Unlike spawn_agents, this tool does not wait for the agents to complete and allows the parent agent to continue execution. The subagents can continue to run even if the parent agent ends its turn.
 
-The spawned agents run independently and can communicate back to the parent using send_agent_message. The parent agent can also send further messages to the async agents. The parent agent can end its turn without waiting for the async agents to complete. If so, async children will wake the parent when they send a message.
+The spawned agents run independently. The parent agent can end its turn without waiting for the async agents to complete.
 
 Prefer to use spawn_agents unless you really need this ability to spawn asynchronous agents.
 
diff --git a/backend/src/tools/handlers/list.ts b/backend/src/tools/handlers/list.ts
@@ -9,7 +9,6 @@ import { handleReadDocs } from './tool/read-docs'
 import { handleReadFiles } from './tool/read-files'
 import { handleRunFileChangeHooks } from './tool/run-file-change-hooks'
 import { handleRunTerminalCommand } from './tool/run-terminal-command'
-import { handleSendAgentMessage } from './tool/send-agent-message'
 import { handleSetMessages } from './tool/set-messages'
 import { handleSetOutput } from './tool/set-output'
 import { handleSpawnAgents } from './tool/spawn-agents'
@@ -45,7 +44,6 @@ export const codebuffToolHandlers = {
   read_files: handleReadFiles,
   run_file_change_hooks: handleRunFileChangeHooks,
   run_terminal_command: handleRunTerminalCommand,
-  send_agent_message: handleSendAgentMessage,
   set_messages: handleSetMessages,
   set_output: handleSetOutput,
   spawn_agents: handleSpawnAgents,
diff --git a/backend/src/tools/handlers/tool/send-agent-message.ts b/backend/src/tools/handlers/tool/send-agent-message.ts
diff --git a/common/src/tools/constants.ts b/common/src/tools/constants.ts
@@ -20,7 +20,6 @@ export const toolNames = [
   'read_files',
   'run_file_change_hooks',
   'run_terminal_command',
-  'send_agent_message',
   'set_messages',
   'set_output',
   'spawn_agents',
diff --git a/common/src/tools/list.ts b/common/src/tools/list.ts
@@ -9,7 +9,6 @@ import { readDocsParams } from './params/tool/read-docs'
 import { readFilesParams } from './params/tool/read-files'
 import { runFileChangeHooksParams } from './params/tool/run-file-change-hooks'
 import { runTerminalCommandParams } from './params/tool/run-terminal-command'
-import { sendAgentMessageParams } from './params/tool/send-agent-message'
 import { setMessagesParams } from './params/tool/set-messages'
 import { setOutputParams } from './params/tool/set-output'
 import { spawnAgentsParams } from './params/tool/spawn-agents'
@@ -35,7 +34,6 @@ export const llmToolCallSchema = {
   read_files: readFilesParams,
   run_file_change_hooks: runFileChangeHooksParams,
   run_terminal_command: runTerminalCommandParams,
-  send_agent_message: sendAgentMessageParams,
   set_messages: setMessagesParams,
   set_output: setOutputParams,
   spawn_agents: spawnAgentsParams,
@@ -71,7 +69,6 @@ export const clientToolCallSchema = {
 
   browser_logs: ['type', 'url', 'waitUntil'],
 
-  send_agent_message: ['target_agent_id', 'prompt', 'params'],
   spawn_agents: ['agents'],
   spawn_agents_async: ['agents'],
   spawn_agent_inline: ['agent_type', 'prompt', 'params'],
diff --git a/common/src/tools/params/tool/send-agent-message.ts b/common/src/tools/params/tool/send-agent-message.ts
diff --git a/common/src/util/types/tools.d.ts b/common/src/util/types/tools.d.ts
@@ -13,7 +13,6 @@ export type ToolName =
   | 'read_files'
   | 'run_file_change_hooks'
   | 'run_terminal_command'
-  | 'send_agent_message'
   | 'set_messages'
   | 'set_output'
   | 'spawn_agents'
@@ -40,7 +39,6 @@ export interface ToolParamsMap {
   read_files: ReadFilesParams
   run_file_change_hooks: RunFileChangeHooksParams
   run_terminal_command: RunTerminalCommandParams
-  send_agent_message: SendAgentMessageParams
   set_messages: SetMessagesParams
   set_output: SetOutputParams
   spawn_agents: SpawnAgentsParams
@@ -166,18 +164,6 @@ export interface RunTerminalCommandParams {
   timeout_seconds: number
 }
 
-/**
- * Send a message to another agent (parent or child) for communication and data exchange.
- */
-export interface SendAgentMessageParams {
-  /** ID of the target agent to send message to. Use "PARENT_ID" to send to parent agent. */
-  target_agent_id: string
-  /** Message prompt to send to the target agent */
-  prompt: string
-  /** Optional parameters object to send with the message */
-  params?: Record<string, any>
-}
-
 /**
  * Set the conversation history to the provided messages.
  */
diff --git a/npm-app/src/utils/tool-renderers.ts b/npm-app/src/utils/tool-renderers.ts
@@ -341,18 +341,6 @@ export const toolRenderers: Record<ToolName, ToolCallRenderer> = {
       }
     },
   },
-
-  send_agent_message: {
-    onToolStart: (toolName) => {
-      return '\n\n' + gray(`[${bold('Send Agent Message')}]`) + '\n'
-    },
-    onParamChunk: (content, paramName, toolName) => {
-      if (paramName === 'prompt') {
-        return gray(content)
-      }
-      return null
-    },
-  },
   add_message: {
     // Don't render anything
   },
diff --git a/sdk/src/types/agent-config.ts b/sdk/src/types/agent-config.ts
@@ -72,7 +72,7 @@ export interface AgentConfig {
    *
    * all_messages: All messages from the agent, including tool calls and results.
    *
-   * structured_output: Make the agent output a JSON object. Can be used with outputSchema or without if you want freeform json output.
+   * json: Make the agent output a JSON object. Can be used with outputSchema or without if you want freeform json output.
    */
   outputMode?: 'last_message' | 'all_messages' | 'structured_output'
 
diff --git a/sdk/src/types/tools.ts b/sdk/src/types/tools.ts
