Add halt_activity tool for graceful bot termination

- Create tools/halt.py with halt_activity function
- Register halt_activity tool in register_tools.py
- Add halt detection in bsky.py process_mention function
- Bot exports agent state and exits when halt tool is called

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

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

bsky.py

···
         None: Failed with non-retryable error, move to errors directory
     """
     try:
-        logger.info(f"Starting process_mention with notification_data type: {type(notification_data)}")
+        logger.debug(f"Starting process_mention with notification_data type: {type(notification_data)}")
         
         # Handle both dict and object inputs for backwards compatibility
         if isinstance(notification_data, dict):
···
         all_handles.update(extract_handles_from_data(thread.model_dump()))
         unique_handles = list(all_handles)
         
-        logger.info(f"Found {len(unique_handles)} unique handles in thread: {unique_handles}")
+        logger.debug(f"Found {len(unique_handles)} unique handles in thread: {unique_handles}")
         
         # Attach user blocks before agent call
         attached_handles = []
         if unique_handles:
             try:
-                logger.info(f"Attaching user blocks for handles: {unique_handles}")
+                logger.debug(f"Attaching user blocks for handles: {unique_handles}")
                 attach_result = attach_user_blocks(unique_handles, void_agent)
                 attached_handles = unique_handles  # Track successfully attached handles
                 logger.debug(f"Attach result: {attach_result}")
···
             else:
                 logger.debug(f"  {i}. {msg_type}: <no content>")
 
+            # Check for halt_activity tool call
+            if hasattr(message, 'tool_call') and message.tool_call:
+                if message.tool_call.name == 'halt_activity':
+                    logger.info("🛑 HALT_ACTIVITY TOOL CALLED - TERMINATING BOT")
+                    try:
+                        args = json.loads(message.tool_call.arguments)
+                        reason = args.get('reason', 'Agent requested halt')
+                        logger.info(f"Halt reason: {reason}")
+                    except:
+                        logger.info("Halt reason: <unable to parse>")
+                    
+                    # Export agent state before terminating
+                    export_agent_state(CLIENT, void_agent)
+                    
+                    # Exit the program
+                    logger.info("=== BOT TERMINATED BY AGENT ===")
+                    exit(0)
+            
             # Collect bluesky_reply tool calls
             if hasattr(message, 'tool_call') and message.tool_call:
                 if message.tool_call.name == 'bluesky_reply':

register_tools.py

···
 from tools.feed import get_bluesky_feed, FeedArgs
 from tools.blocks import attach_user_blocks, detach_user_blocks, AttachUserBlocksArgs, DetachUserBlocksArgs
 from tools.reply import bluesky_reply, ReplyArgs
+from tools.halt import halt_activity, HaltArgs
 
 load_dotenv()
 logging.basicConfig(level=logging.INFO)
···
         "args_schema": ReplyArgs,
         "description": "Reply indicator for the Letta agent (1-4 messages, each max 300 chars). Creates threaded replies.",
         "tags": ["bluesky", "reply", "response"]
+    },
+    {
+        "func": halt_activity,
+        "args_schema": HaltArgs,
+        "description": "Signal to halt all bot activity and terminate bsky.py",
+        "tags": ["control", "halt", "terminate"]
     },
 ]
 

tools/halt.py

···
+"""Halt tool for terminating bsky.py activity."""
+from pydantic import BaseModel, Field
+
+
+class HaltArgs(BaseModel):
+    reason: str = Field(
+        default="User requested halt",
+        description="Optional reason for halting activity"
+    )
+
+
+def halt_activity(reason: str = "User requested halt") -> str:
+    """
+    Signal to halt all bot activity and terminate bsky.py.
+    
+    This tool allows the agent to request termination of the bot process.
+    The actual termination is handled externally by bsky.py when it detects
+    this tool being called.
+    
+    Args:
+        reason: Optional reason for halting (default: "User requested halt")
+    
+    Returns:
+        Halt signal message
+    """
+    return f"Halting activity: {reason}"