Remove x-conversations recipe (MCP Apps incompatible with recipes)

MCP Apps (rich UI) don't work in Goose scheduled recipes due to
500 errors when loading UI resources. Removing the scheduled
conversations option since it requires the rich UI to be useful.

Users can still use x_conversations in regular chat where the
MCP Apps UI works correctly.

- Delete recipes/x-conversations.yaml
- Remove x_list_conversations tool (was only for recipes)
- Update README and CLAUDE.md
- Remove x-conversations recipe tests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: nearestnabors

README.md

@@ -102,16 +102,15 @@ Reply to @anthropic_devs saying I'll share slides after the talk
 
 ## Tools
 
-| Tool                     | Description                                                   |
-| ------------------------ | ------------------------------------------------------------- |
-| `x_auth_status`          | Check authentication, show connect button if needed           |
-| `x_conversations`        | Show unreplied mentions as a rich UI conversation inbox       |
-| `x_list_conversations`   | List unreplied mentions as text (for scheduled recipes)       |
-| `x_dismiss_conversation` | Dismiss a conversation (reappears on new activity)            |
-| `x_draft_tweet`          | Create draft with preview                                     |
-| `x_post_tweet`           | Post after approval                                           |
-| `x_timeline_digest`      | Fetch and summarize your Following timeline (past 24h)        |
-| `x_show_tweet`           | Display a single tweet as a rich card with reply option       |
+| Tool                     | Description                                             |
+| ------------------------ | ------------------------------------------------------- |
+| `x_auth_status`          | Check authentication, show connect button if needed     |
+| `x_conversations`        | Show unreplied mentions as a conversation inbox         |
+| `x_dismiss_conversation` | Dismiss a conversation (reappears on new activity)      |
+| `x_draft_tweet`          | Create draft with preview                               |
+| `x_post_tweet`           | Post after approval                                     |
+| `x_timeline_digest`      | Fetch and summarize your Following timeline (past 24h)  |
+| `x_show_tweet`           | Display a single tweet as a rich card with reply option |
 
 ## Timeline Digest Setup
 
@@ -146,52 +145,46 @@ google-chrome --remote-debugging-port=9222
 
 Then make sure you're logged into X in that browser window. (I keep one open and minimized on startup.)
 
-### Goose Recipes
+### Goose Recipe
 
-ASSA includes two recipes for scheduled automation:
+ASSA includes a recipe for scheduled timeline digests:
 
-| Recipe                 | Description                                                                     |
-| ---------------------- | ------------------------------------------------------------------------------- |
-| `x-news-digest.yaml`   | Daily digest of your Following timeline (requires Chrome with remote debugging) |
-| `x-conversations.yaml` | Check and respond to X mentions/conversations                                   |
+| Recipe               | Description                                                                     |
+| -------------------- | ------------------------------------------------------------------------------- |
+| `x-news-digest.yaml` | Daily digest of your Following timeline (requires Chrome with remote debugging) |
 
-#### Import a Recipe
+#### Import the Recipe
 
-**Option 1: Follow a Deep Link**
+**Option 1: Generate a Deep Link**
 
 ```bash
 goose recipe deeplink recipes/x-news-digest.yaml
-goose recipe deeplink recipes/x-conversations.yaml
 ```
 
-This outputs a `goose://recipe?config=...` URL. Paste it in a browser to preview what it will output in Goose Desktop.
+This outputs a `goose://recipe?config=...` URL. Paste it in a browser to import into Goose Desktop.
 
 **Option 2: Import in Goose Desktop**
 
 1. Open **Goose Desktop**
 2. Click **Recipes** in the sidebar
 3. Click **Import Recipe** or browse for file
-4. Either past the link generated in Option 1 in the **Recipe Deeplink** input box, or choose a recipe from the `recipes/` folder in the **Recipe File** input field.
+4. Choose `recipes/x-news-digest.yaml` from the **Recipe File** input field
 
 **Option 3: Run via CLI**
 
-The outputs are in Markdown, enjoy!
-
 ```bash
 goose run --recipe recipes/x-news-digest.yaml
 ```
 
-(Not recommended for `x-conversations.yaml`, which return nothing because MCP Apps are iframes.)
-
-#### Schedule a Recipe
+#### Schedule the Recipe
 
 After importing, on the **Recipes** screen:
 
-1. Click the little clock icon next the the recipe you want to automate.
-2. In the **Add Schedule** modal, select the frequency and time you want the recipe to run.
+1. Click the clock icon next to the recipe
+2. Select the frequency and time in the **Add Schedule** modal
 3. Click **Save**
 
-**Note:** X News Digest requires Chrome running with `--remote-debugging-port=9222`.
+**Note:** Requires Chrome running with `--remote-debugging-port=9222`.
 
 ## Development
 

recipes/x-conversations.yaml

@@ -93,38 +93,6 @@ describe("Goose Recipes", () => {
     });
   });
 
-  describe("x-conversations.yaml", () => {
-    const recipe = parseRecipe("x-conversations.yaml");
-
-    test("has required title field", () => {
-      expect(recipe.title).toBeDefined();
-      expect(typeof recipe.title).toBe("string");
-      expect(recipe.title!.length).toBeGreaterThan(0);
-    });
-
-    test("has required description field", () => {
-      expect(recipe.description).toBeDefined();
-      expect(typeof recipe.description).toBe("string");
-      expect(recipe.description!.length).toBeGreaterThan(0);
-    });
-
-    test("has instructions or prompt", () => {
-      const hasInstructions =
-        recipe.instructions && recipe.instructions.length > 0;
-      const hasPrompt = recipe.prompt && recipe.prompt.length > 0;
-      expect(hasInstructions || hasPrompt).toBe(true);
-    });
-
-    test("instructions mention x_list_conversations tool", () => {
-      expect(recipe.instructions).toContain("x_list_conversations");
-    });
-
-    test("has activities array", () => {
-      expect(Array.isArray(recipe.activities)).toBe(true);
-      expect(recipe.activities!.length).toBeGreaterThan(0);
-    });
-  });
-
   // Generic validation for all recipe files
   describe("all recipes", () => {
     for (const filename of recipeFiles) {

src/__tests__/recipes/recipes.test.ts

@@ -23,11 +23,7 @@ import {
 
 // X tools
 import { xAuthStatus } from "./tools/auth-status.js";
-import {
-  xConversations,
-  xGetConversations,
-  xListConversations,
-} from "./tools/conversations.js";
+import { xConversations, xGetConversations } from "./tools/conversations.js";
 import { xDismissConversation } from "./tools/dismiss-conversation.js";
 import { xDraftTweet } from "./tools/draft-tweet.js";
 import { xPostTweet } from "./tools/post-tweet.js";
@@ -217,19 +213,6 @@ const TOOLS: Tool[] = [
       },
     },
   },
-  {
-    name: "x_list_conversations",
-    description:
-      "List X conversations awaiting your reply as formatted text. " +
-      "Use this in scheduled recipes or contexts where UI rendering is not available. " +
-      "Returns conversations with links for easy access.",
-    inputSchema: {
-      type: "object",
-      properties: {},
-      required: [],
-    },
-    // No UI - returns text for recipes and scheduled tasks
-  },
 ];
 
 // Tool handler dispatch
@@ -240,7 +223,6 @@ const toolHandlers: Record<string, ToolHandler> = {
   x_post_tweet: xPostTweet,
   x_conversations: xConversations,
   x_get_conversations: xGetConversations, // UI-only, returns full data
-  x_list_conversations: xListConversations, // Text-only, for recipes
   x_dismiss_conversation: xDismissConversation,
   x_show_tweet: xShowTweet,
   x_timeline_digest: xTimelineDigest,

src/server.ts

@@ -467,82 +467,3 @@ export async function xGetConversations(params?: {
     ],
   };
 }
-
-/**
- * Format relative time for display
- */
-function formatTimeAgo(isoDate: string): string {
-  const date = new Date(isoDate);
-  const now = new Date();
-  const diffMs = now.getTime() - date.getTime();
-  const diffMins = Math.floor(diffMs / 60_000);
-  const diffHours = Math.floor(diffMins / 60);
-  const diffDays = Math.floor(diffHours / 24);
-
-  if (diffMins < 60) {
-    return `${diffMins}m ago`;
-  }
-  if (diffHours < 24) {
-    return `${diffHours}h ago`;
-  }
-  return `${diffDays}d ago`;
-}
-
-/**
- * Tool: x_list_conversations (text-only, for recipes)
- * Returns conversation data as formatted text instead of UI
- * Use this in recipes where MCP Apps are not supported
- */
-export async function xListConversations(): Promise<unknown> {
-  const result = await fetchConversations();
-
-  if (!result.success) {
-    return result.content;
-  }
-
-  const { conversations, username } = result.data;
-
-  if (conversations.length === 0) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: `No conversations awaiting reply for @${username}.`,
-        },
-      ],
-    };
-  }
-
-  // Format conversations as text with links
-  const lines: string[] = [
-    `Found ${conversations.length} conversation${conversations.length === 1 ? "" : "s"} awaiting your reply (@${username}):`,
-    "",
-  ];
-
-  for (const conv of conversations) {
-    const timeAgo = formatTimeAgo(conv.created_at);
-    const tweetUrl = `https://x.com/${conv.author_username}/status/${conv.tweet_id}`;
-    const engagement = `${conv.like_count} likes, ${conv.retweet_count} RTs, ${conv.reply_count} replies`;
-
-    lines.push("---");
-    lines.push(
-      `[@${conv.author_username}](${tweetUrl}) (${conv.author_display_name}) - ${timeAgo}`
-    );
-    lines.push(conv.text);
-    lines.push(`Engagement: ${engagement}`);
-  }
-
-  lines.push("");
-  lines.push(
-    "To reply to a conversation, use the x_draft_tweet tool with the reply_to_id parameter."
-  );
-
-  return {
-    content: [
-      {
-        type: "text",
-        text: lines.join("\n"),
-      },
-    ],
-  };
-}