Notifications

When to Use

• Long task complete → send_notification
• Found something interesting → send_notification
• Need user attention → send_notification

Image Attachments

When sending notifications about generated images, include the image_ids parameter with the IDs returned by generate_image or save_generated_image. This will attach the actual images to the Signal message so the user can see them on their phone.

Example: After generating images, call send_notification with image_ids: ["cmlzfwg8y...", "cmlzfwvad..."] to deliver them via Signal.

File Attachments

To send workspace files via Signal, always use the file_paths parameter — never paste markdown links to local paths in the message text. Local-path links don't open from a phone; the bridge handles delivery for you.

Example: send_notification with message: "Wrote the spec" and file_paths: ["mars_project/spec.md", "mars_project/timeline.md"]