Clarify that status_set displays immediately

- Add to tool description that status is set IMMEDIATELY
- Add code comment explaining this prevents premature success status
  (e.g., saying 'PR checks passed' when checks are still running)

Author: ammar-agent

src/services/tools/status_set.ts

@@ -41,6 +41,12 @@ function isValidEmoji(str: string): boolean {
 /**
  * Status set tool factory for AI assistant
  * Creates a tool that allows the AI to set status indicator showing current activity
+ *
+ * The status is displayed IMMEDIATELY when this tool is called, even before other
+ * tool calls complete. This prevents agents from prematurely declaring success
+ * (e.g., "PR checks passed") when operations are still pending. Agents should only
+ * set success status after confirming the outcome of long-running operations.
+ *
  * @param config Required configuration (not used for this tool, but required by interface)
  */
 export const createStatusSetTool: ToolFactory = () => {

src/utils/tools/toolDefinitions.ts

@@ -185,6 +185,7 @@ export const TOOL_DEFINITIONS = {
     description:
       "Set a status indicator to show what the agent is currently doing. " +
       "The emoji appears left of the streaming indicator, and the message shows on hover. " +
+      "The status is set IMMEDIATELY when this tool is called, even before other tool calls complete. " +
       "IMPORTANT: Always set a status at the start of each response and update it as your work progresses. " +
       "The status is cleared when a new user message comes in, so you must set it again for each response. " +
       "Use this to communicate ongoing activities and set a final status before completing that reflects the outcome.",