feat: add URL parameter to status_set tool

- Add optional url parameter to status_set tool definition
- Update backend to handle and return URL in results
- Store URL in StreamingMessageAggregator with agent status
- Make emoji clickable when URL present, opens in new tab
- Display URL in status tooltip below message
- Add comprehensive tests for URL parameter handling
- URL persists until replaced by new status (no-op if same URL)

Generated with `cmux`

Author: ammar-agent

src/components/AgentStatusIndicator.tsx

@@ -74,14 +74,29 @@ export const AgentStatusIndicator: React.FC<AgentStatusIndicatorProps> = ({
     />
   );
 
+  const handleEmojiClick = useCallback(
+    (e: React.MouseEvent) => {
+      if (agentStatus?.url) {
+        e.stopPropagation(); // Prevent workspace selection
+        window.open(agentStatus.url, "_blank", "noopener,noreferrer");
+      }
+    },
+    [agentStatus?.url]
+  );
+
   const emoji = agentStatus ? (
     <div
-      className="flex shrink-0 items-center justify-center transition-all duration-200"
+      className={cn(
+        "flex shrink-0 items-center justify-center transition-all duration-200",
+        agentStatus.url && "cursor-pointer hover:opacity-80"
+      )}
       style={{
         fontSize: size * 1.5,
         filter: streaming ? "none" : "grayscale(100%)",
         opacity: streaming ? 1 : 0.6,
       }}
+      onClick={handleEmojiClick}
+      title={agentStatus.url ? "Click to open URL" : undefined}
     >
       {agentStatus.emoji}
     </div>

src/services/tools/status_set.test.ts

@@ -191,4 +191,55 @@ describe("status_set tool validation", () => {
       expect(result.success).toBe(true);
     });
   });
+
+  describe("url parameter", () => {
+    it("should accept valid URLs", async () => {
+      const tool = createStatusSetTool(mockConfig);
+
+      const validUrls = [
+        "https://github.com/owner/repo/pull/123",
+        "http://example.com",
+        "https://example.com/path/to/resource?query=param",
+      ];
+
+      for (const url of validUrls) {
+        const result = (await tool.execute!(
+          { emoji: "🔍", message: "Test", url },
+          mockToolCallOptions
+        )) as {
+          success: boolean;
+          url: string;
+        };
+        expect(result.success).toBe(true);
+        expect(result.url).toBe(url);
+      }
+    });
+
+    it("should work without URL parameter", async () => {
+      const tool = createStatusSetTool(mockConfig);
+
+      const result = (await tool.execute!(
+        { emoji: "✅", message: "Test" },
+        mockToolCallOptions
+      )) as {
+        success: boolean;
+        url?: string;
+      };
+      expect(result.success).toBe(true);
+      expect(result.url).toBeUndefined();
+    });
+
+    it("should omit URL from result when undefined", async () => {
+      const tool = createStatusSetTool(mockConfig);
+
+      const result = (await tool.execute!(
+        { emoji: "✅", message: "Test", url: undefined },
+        mockToolCallOptions
+      )) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(true);
+      expect("url" in result).toBe(false);
+    });
+  });
 });

src/services/tools/status_set.ts

@@ -11,6 +11,7 @@ export type StatusSetToolResult =
       success: true;
       emoji: string;
       message: string;
+      url?: string;
     }
   | {
       success: false;
@@ -65,7 +66,7 @@ export const createStatusSetTool: ToolFactory = () => {
   return tool({
     description: TOOL_DEFINITIONS.status_set.description,
     inputSchema: TOOL_DEFINITIONS.status_set.schema,
-    execute: ({ emoji, message }): Promise<StatusSetToolResult> => {
+    execute: ({ emoji, message, url }): Promise<StatusSetToolResult> => {
       // Validate emoji
       if (!isValidEmoji(emoji)) {
         return Promise.resolve({
@@ -83,6 +84,7 @@ export const createStatusSetTool: ToolFactory = () => {
         success: true,
         emoji,
         message: truncatedMessage,
+        ...(url && { url }),
       });
     },
   });

src/stores/WorkspaceStore.ts

@@ -29,7 +29,7 @@ export interface WorkspaceState {
   currentModel: string | null;
   recencyTimestamp: number | null;
   todos: TodoItem[];
-  agentStatus: { emoji: string; message: string } | undefined;
+  agentStatus: { emoji: string; message: string; url?: string } | undefined;
   pendingStreamStartTime: number | null;
 }
 
@@ -41,7 +41,7 @@ export interface WorkspaceSidebarState {
   canInterrupt: boolean;
   currentModel: string | null;
   recencyTimestamp: number | null;
-  agentStatus: { emoji: string; message: string } | undefined;
+  agentStatus: { emoji: string; message: string; url?: string } | undefined;
 }
 
 /**

src/utils/messages/StreamingMessageAggregator.status.test.ts

@@ -539,4 +539,112 @@ describe("StreamingMessageAggregator - Agent Status", () => {
     expect(status).toEqual({ emoji: "✅", message: truncatedMessage });
     expect(status?.message.length).toBe(60);
   });
+
+  it("should store URL when provided in status_set", () => {
+    const aggregator = new StreamingMessageAggregator("2024-01-01T00:00:00.000Z");
+    const messageId = "msg1";
+    const toolCallId = "tool1";
+
+    // Start a stream
+    aggregator.handleStreamStart({
+      type: "stream-start",
+      workspaceId: "workspace1",
+      messageId,
+      model: "test-model",
+      historySequence: 1,
+    });
+
+    // Add a status_set tool call with URL
+    const testUrl = "https://github.com/owner/repo/pull/123";
+    aggregator.handleToolCallStart({
+      type: "tool-call-start",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId,
+      toolName: "status_set",
+      args: { emoji: "🔗", message: "PR submitted", url: testUrl },
+      tokens: 10,
+      timestamp: Date.now(),
+    });
+
+    // Complete the tool call
+    aggregator.handleToolCallEnd({
+      type: "tool-call-end",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId,
+      toolName: "status_set",
+      result: { success: true, emoji: "🔗", message: "PR submitted", url: testUrl },
+    });
+
+    const status = aggregator.getAgentStatus();
+    expect(status).toBeDefined();
+    expect(status?.emoji).toBe("🔗");
+    expect(status?.message).toBe("PR submitted");
+    expect(status?.url).toBe(testUrl);
+  });
+
+  it("should persist URL until replaced with new status", () => {
+    const aggregator = new StreamingMessageAggregator("2024-01-01T00:00:00.000Z");
+    const messageId = "msg1";
+
+    // Start a stream
+    aggregator.handleStreamStart({
+      type: "stream-start",
+      workspaceId: "workspace1",
+      messageId,
+      model: "test-model",
+      historySequence: 1,
+    });
+
+    // First status with URL
+    const testUrl = "https://github.com/owner/repo/pull/123";
+    aggregator.handleToolCallStart({
+      type: "tool-call-start",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId: "tool1",
+      toolName: "status_set",
+      args: { emoji: "🔗", message: "PR submitted", url: testUrl },
+      tokens: 10,
+      timestamp: Date.now(),
+    });
+
+    aggregator.handleToolCallEnd({
+      type: "tool-call-end",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId: "tool1",
+      toolName: "status_set",
+      result: { success: true, emoji: "🔗", message: "PR submitted", url: testUrl },
+    });
+
+    expect(aggregator.getAgentStatus()?.url).toBe(testUrl);
+
+    // Second status without URL - should clear URL
+    aggregator.handleToolCallStart({
+      type: "tool-call-start",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId: "tool2",
+      toolName: "status_set",
+      args: { emoji: "✅", message: "Done" },
+      tokens: 10,
+      timestamp: Date.now(),
+    });
+
+    aggregator.handleToolCallEnd({
+      type: "tool-call-end",
+      workspaceId: "workspace1",
+      messageId,
+      toolCallId: "tool2",
+      toolName: "status_set",
+      result: { success: true, emoji: "✅", message: "Done" },
+    });
+
+    const finalStatus = aggregator.getAgentStatus();
+    expect(finalStatus?.emoji).toBe("✅");
+    expect(finalStatus?.message).toBe("Done");
+    expect(finalStatus?.url).toBeUndefined();
+  });
 });

src/utils/messages/StreamingMessageAggregator.ts

@@ -71,7 +71,7 @@ export class StreamingMessageAggregator {
 
   // Current agent status (updated when status_set is called)
   // Unlike todos, this persists after stream completion to show last activity
-  private agentStatus: { emoji: string; message: string } | undefined = undefined;
+  private agentStatus: { emoji: string; message: string; url?: string } | undefined = undefined;
 
   // Workspace init hook state (ephemeral, not persisted to history)
   private initState: {
@@ -143,7 +143,7 @@ export class StreamingMessageAggregator {
    * Updated whenever status_set is called.
    * Persists after stream completion (unlike todos).
    */
-  getAgentStatus(): { emoji: string; message: string } | undefined {
+  getAgentStatus(): { emoji: string; message: string; url?: string } | undefined {
     return this.agentStatus;
   }
 
@@ -522,8 +522,12 @@ export class StreamingMessageAggregator {
     // Update agent status if this was a successful status_set
     // Use output instead of input to get the truncated message
     if (toolName === "status_set" && hasSuccessResult(output)) {
-      const result = output as { success: true; emoji: string; message: string };
-      this.agentStatus = { emoji: result.emoji, message: result.message };
+      const result = output as { success: true; emoji: string; message: string; url?: string };
+      this.agentStatus = {
+        emoji: result.emoji,
+        message: result.message,
+        ...(result.url && { url: result.url }),
+      };
     }
   }
 

src/utils/tools/toolDefinitions.ts

@@ -192,7 +192,12 @@ export const TOOL_DEFINITIONS = {
       "- DO NOT set status during initial exploration, file reading, or planning phases\n" +
       "\n" +
       "The status is cleared when a new user message comes in. Validate your approach is feasible \n" +
-      "before setting status - failed tool calls after setting status indicate premature commitment.",
+      "before setting status - failed tool calls after setting status indicate premature commitment.\n" +
+      "\n" +
+      "URL PARAMETER:\n" +
+      "- Optional 'url' parameter links to external resources (e.g., PR URL: 'https://github.com/owner/repo/pull/123')\n" +
+      "- Prefer stable URLs that don't change often - saving the same URL twice is a no-op\n" +
+      "- URL persists until replaced by a new status",
     schema: z
       .object({
         emoji: z.string().describe("A single emoji character representing the current activity"),
@@ -201,6 +206,13 @@ export const TOOL_DEFINITIONS = {
           .describe(
             `A brief description of the current activity (auto-truncated to ${STATUS_MESSAGE_MAX_LENGTH} chars with ellipsis if needed)`
           ),
+        url: z
+          .string()
+          .url()
+          .optional()
+          .describe(
+            "Optional URL to external resource with more details (e.g., Pull Request URL). The URL persists and is displayed to the user for easy access."
+          ),
       })
       .strict(),
   },

src/utils/ui/statusTooltip.tsx

@@ -9,14 +9,23 @@ import { formatRelativeTime } from "@/utils/ui/dateTime";
 export function getStatusTooltip(options: {
   isStreaming: boolean;
   streamingModel: string | null;
-  agentStatus?: { emoji: string; message: string };
+  agentStatus?: { emoji: string; message: string; url?: string };
   isUnread?: boolean;
   recencyTimestamp?: number | null;
 }): React.ReactNode {
   const { isStreaming, streamingModel, agentStatus, isUnread, recencyTimestamp } = options;
 
-  // If agent status is set, always show that message
+  // If agent status is set, show message and URL (if available)
   if (agentStatus) {
+    if (agentStatus.url) {
+      return (
+        <>
+          {agentStatus.message}
+          <br />
+          <span style={{ opacity: 0.7, fontSize: "0.9em" }}>{agentStatus.url}</span>
+        </>
+      );
+    }
     return agentStatus.message;
   }