bunware.org
1# Tool Changelog - Bluesky Reply Threading
2
3## Summary
4The reply system has been simplified and improved with a new atomic approach for building reply threads.
5
6## Changes Made
7
8### ✅ NEW TOOL: `add_post_to_bluesky_reply_thread`
9- **Purpose**: Add a single post to the current Bluesky reply thread atomically
10- **Usage**: Call this tool multiple times to build a reply thread incrementally
11- **Parameters**:
12 - `text` (required): Text content for the post (max 300 characters)
13 - `lang` (optional): Language code (defaults to "en-US")
14- **Returns**: Confirmation that the post has been queued for the reply thread
15- **Error Handling**: If text exceeds 300 characters, the post will be omitted from the thread and you may try again with shorter text
16
17### ❌ REMOVED TOOL: `bluesky_reply`
18- This tool has been removed to eliminate confusion
19- All reply functionality is now handled through the new atomic approach
20
21## How to Use the New System
22
23### Before (Old Way - NO LONGER AVAILABLE)
24```
25bluesky_reply(["First reply", "Second reply", "Third reply"])
26```
27
28### After (New Way - USE THIS)
29```
30add_post_to_bluesky_reply_thread("First reply")
31add_post_to_bluesky_reply_thread("Second reply")
32add_post_to_bluesky_reply_thread("Third reply")
33```
34
35## Benefits of the New Approach
36
371. **Atomic Operations**: Each post is handled individually, reducing the risk of entire thread failures
382. **Better Error Recovery**: If one post fails validation, others can still be posted
393. **Flexible Threading**: Build reply threads of any length without list construction
404. **Clearer Intent**: Each tool call has a single, clear purpose
415. **Handler-Managed State**: The bsky.py handler manages thread state and proper AT Protocol threading
42
43## Important Notes
44
45- The actual posting to Bluesky is handled by the bsky.py handler, not the tool itself
46- Each call to `add_post_to_bluesky_reply_thread` queues a post for the current reply context
47- Posts are validated for the 300-character limit before being queued
48- Thread state and proper reply chaining is managed automatically by the handler
49- Language defaults to "en-US" but can be specified per post if needed
50
51## Migration Guide
52
53If you were previously using `bluesky_reply`, simply replace it with multiple calls to `add_post_to_bluesky_reply_thread`:
54
55**Old approach:**
56```
57bluesky_reply(["Hello!", "This is a threaded reply.", "Thanks for the mention!"])
58```
59
60**New approach:**
61```
62add_post_to_bluesky_reply_thread("Hello!")
63add_post_to_bluesky_reply_thread("This is a threaded reply.")
64add_post_to_bluesky_reply_thread("Thanks for the mention!")
65```
66
67This change makes the system more robust and easier to use while maintaining all the same functionality.