Add annotate_ack tool for attaching notes to acknowledgments

- Create dummy tool that allows agent to add custom notes to stream.thought.ack records
- Update acknowledge_post to accept optional note parameter
- Modify bot loop to capture notes from annotate_ack tool calls
- Add note field to stream.thought.ack records (null if not provided)
- Register tool with proper descriptions and tags

This allows void to optionally annotate acknowledgments with contextual observations.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[e-mail]>

bsky.py

···
         # Extract successful add_post_to_bluesky_reply_thread tool calls from the agent's response
         reply_candidates = []
         tool_call_results = {}  # Map tool_call_id to status
+        ack_note = None  # Track any note from annotate_ack tool
         
         logger.debug(f"Processing {len(message_response.messages)} response messages...")
         
···
                     logger.info("=== BOT TERMINATED DUE TO DEPRECATED TOOL USE ===")
                     exit(1)
                 
+                # Collect annotate_ack tool calls
+                elif message.tool_call.name == 'annotate_ack':
+                    try:
+                        args = json.loads(message.tool_call.arguments)
+                        note = args.get('note', '')
+                        if note:
+                            ack_note = note
+                            logger.debug(f"Found annotate_ack with note: {note[:50]}...")
+                    except json.JSONDecodeError as e:
+                        logger.error(f"Failed to parse annotate_ack arguments: {e}")
+                
                 # Collect add_post_to_bluesky_reply_thread tool calls - only if they were successful
                 elif message.tool_call.name == 'add_post_to_bluesky_reply_thread':
                     tool_call_id = message.tool_call.tool_call_id
···
                         ack_result = bsky_utils.acknowledge_post(
                             client=atproto_client,
                             post_uri=post_uri,
-                            post_cid=post_cid
+                            post_cid=post_cid,
+                            note=ack_note
                         )
                         if ack_result:
-                            logger.info(f"Successfully acknowledged post from @{author_handle} with stream.thought.ack")
+                            if ack_note:
+                                logger.info(f"Successfully acknowledged post from @{author_handle} with stream.thought.ack (note: \"{ack_note[:50]}...\")")
+                            else:
+                                logger.info(f"Successfully acknowledged post from @{author_handle} with stream.thought.ack")
                         else:
                             logger.warning(f"Failed to acknowledge post from @{author_handle}")
                     else:

bsky_utils.py

···
         return None
 
 
-def acknowledge_post(client: Client, post_uri: str, post_cid: str) -> Optional[Dict[str, Any]]:
+def acknowledge_post(client: Client, post_uri: str, post_cid: str, note: Optional[str] = None) -> Optional[Dict[str, Any]]:
     """
     Create a stream.thought.ack record to acknowledge a post.
     
···
         client: Authenticated Bluesky client
         post_uri: The URI of the post to acknowledge
         post_cid: The CID of the post to acknowledge
+        note: Optional note to attach to the acknowledgment
         
     Returns:
         The response from creating the acknowledgment record or None if failed
···
                 "uri": post_uri,
                 "cid": post_cid
             },
-            "createdAt": now
+            "createdAt": now,
+            "note": note  # Will be null if no note provided
         }
         
         # Create the record

register_tools.py

···
 from tools.thread import add_post_to_bluesky_reply_thread, ReplyThreadPostArgs
 from tools.ignore import ignore_notification, IgnoreNotificationArgs
 from tools.whitewind import create_whitewind_blog_post, WhitewindPostArgs
+from tools.ack import annotate_ack, AnnotateAckArgs
 
 load_dotenv()
 logging.basicConfig(level=logging.INFO)
···
         "args_schema": WhitewindPostArgs,
         "description": "Create a blog post on Whitewind with markdown support",
         "tags": ["whitewind", "blog", "post", "markdown"]
+    },
+    {
+        "func": annotate_ack,
+        "args_schema": AnnotateAckArgs,
+        "description": "Add a note to the acknowledgment record for the current post interaction",
+        "tags": ["acknowledgment", "note", "annotation", "metadata"]
     },
 ]
 

tools/__init__.py

···
 from .feed import get_bluesky_feed, FeedArgs
 from .blocks import attach_user_blocks, detach_user_blocks, AttachUserBlocksArgs, DetachUserBlocksArgs
 from .whitewind import create_whitewind_blog_post, WhitewindPostArgs
+from .ack import annotate_ack, AnnotateAckArgs
 
 __all__ = [
     # Functions
···
     "attach_user_blocks",
     "detach_user_blocks",
     "create_whitewind_blog_post",
+    "annotate_ack",
     # Pydantic models
     "SearchArgs",
     "PostArgs",
···
     "AttachUserBlocksArgs",
     "DetachUserBlocksArgs",
     "WhitewindPostArgs",
+    "AnnotateAckArgs",
 ]

tools/ack.py

···
+"""Annotation tool for stream.thought.ack records."""
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class AnnotateAckArgs(BaseModel):
+    note: str = Field(
+        ..., 
+        description="A note or annotation to attach to the acknowledgment record"
+    )
+
+
+def annotate_ack(note: str) -> str:
+    """
+    Add a note to the acknowledgment record for the current post interaction.
+    
+    This is a "dummy" tool that doesn't directly create records but signals to the system
+    that a note should be included in the stream.thought.ack record when acknowledging
+    the post you're replying to.
+    
+    Args:
+        note: A note or annotation to attach to the acknowledgment
+        
+    Returns:
+        Confirmation message
+    """
+    # This is a dummy tool - it just returns a confirmation
+    # The actual note will be captured by the bot loop and passed to acknowledge_post
+    return f"Your note will be added to the acknowledgment: \"{note}\""