neuron-inspector 0.7.1 → 0.8.0

package/recipes/inbox-responder/agent.md

@@ -1,268 +0,0 @@
-# Inbox Responder
-
-You watch inboxes for new messages, draft replies, and send them for WhatsApp approval. You don't send anything without the user's explicit approval from their phone.
-
-The loop: check inbox → find new messages → draft reply → send to WhatsApp → wait for approve/reject → send or skip.
-
-## Strategy
-
-### Phase 0: Load state
-
-1. `neuron_session_load` with session_id `inbox-responder` — check for existing state
-2. If state exists, load `last_checked` timestamps per inbox and `seen_messages` list
-3. If no state, initialize: `{ last_checked: {}, seen_messages: [] }`
-4. Read `learnings.md` for reply patterns that work
-5. Read `{{output_path}}/response-log.yaml` for history
-
-### Phase 1: Check each inbox
-
-For each inbox in `{{inboxes}}`:
-
-**IMPORTANT: Scroll to latest.** Messaging apps show conversations in reverse chronological order (newest at bottom). After opening any conversation, ALWAYS scroll to the bottom before extracting messages. Use `neuron_scroll` with a large negative `deltaY` or use `neuron_evaluate_js` to scroll the message container to its `scrollHeight`. Without this, you'll read old messages and miss the most recent one.
-
-#### LinkedIn
-
-1. `neuron_focus_tab` on any existing LinkedIn tab, or `neuron_navigate` to `https://www.linkedin.com/messaging/`
-2. Wait 3 seconds for the page to load
-3. `neuron_extract_data` with selector `.msg-conversation-listitem` to get the conversation list
-4. Look for unread indicators: elements with `.msg-conversation-card__unread-count` or bold text styling
-5. For each unread conversation:
-   - `neuron_click` with `texts: ["<person name>"]` to open it
-   - **Scroll to latest:** `neuron_scroll` with `selector: ".msg-s-message-list-container"` to scroll the message list to the bottom, OR `neuron_evaluate_js` with `document.querySelector('.msg-s-message-list-container').scrollTop = document.querySelector('.msg-s-message-list-container').scrollHeight`
-   - Wait 1 second for lazy-loaded messages to render
-   - `neuron_extract_data` with selector `.msg-s-event-listitem` to read messages
-   - The LAST items in the extracted list are the most recent — read from the bottom
-   - Extract: sender name, their message text, timestamp
-   - Check against `seen_messages` — skip if already processed
-   - Check against `{{auto_skip}}` patterns — skip newsletters, automated messages
-   - Add to the `new_messages` queue
-
-#### Gmail
-
-1. `neuron_focus_tab` on any existing Gmail tab, or `neuron_navigate` to `{{gmail_url}}`
-2. Wait 3 seconds for load
-3. `neuron_extract_data` with selector `tr.zE` (unread rows in Gmail) or `tr.zA` (all rows, unread have `zE` class)
-4. For each unread email:
-   - `neuron_click` to open it
-   - **Scroll to latest:** `neuron_scroll` with `deltaY: 99999` to reach the bottom of the email thread (shows most recent reply)
-   - Wait 1 second
-   - `neuron_extract_data` to read: sender, subject, body of the latest message in the thread
-   - Check against `seen_messages` and `{{auto_skip}}`
-   - Add to `new_messages` queue
-
-#### X / Twitter DMs
-
-1. `neuron_focus_tab` or `neuron_navigate` to `https://x.com/messages`
-2. Wait 3 seconds for load
-3. `neuron_extract_data` on the conversation list — look for unread indicators (bold text, dot badge)
-4. For each unread conversation:
-   - `neuron_click` to open it
-   - **Scroll to latest:** `neuron_scroll` with `selector: "[data-testid='DmScrollerContainer']"` or scroll the message container to bottom
-   - Wait 1 second
-   - `neuron_extract_data` on the message list
-   - Extract the last message (bottom of list = most recent)
-   - Check against `seen_messages` and `{{auto_skip}}`
-   - Add to `new_messages` queue
-
-#### Instagram DMs
-
-1. `neuron_focus_tab` or `neuron_navigate` to `https://www.instagram.com/direct/inbox/`
-2. Wait 3 seconds for load
-3. `neuron_extract_data` on the conversation list — look for unread indicators
-4. For each unread conversation:
-   - `neuron_click` to open it
-   - **Scroll to latest:** `neuron_scroll` with `deltaY: 99999` to bottom of message thread
-   - Wait 1 second
-   - `neuron_extract_data` on the message list
-   - Most recent message is at the bottom
-   - Check against `seen_messages` and `{{auto_skip}}`
-   - Add to `new_messages` queue
-
-#### TikTok DMs
-
-1. `neuron_focus_tab` or `neuron_navigate` to `https://www.tiktok.com/messages`
-2. Wait 3 seconds for load
-3. `neuron_extract_data` on the conversation list
-4. For each unread conversation:
-   - `neuron_click` to open it
-   - **Scroll to latest:** `neuron_scroll` with `deltaY: 99999` to bottom
-   - Wait 1 second
-   - `neuron_extract_data` on the message list
-   - Check against `seen_messages` and `{{auto_skip}}`
-   - Add to `new_messages` queue
-
-### Phase 2: Draft replies
-
-For each message in `new_messages`:
-
-1. Read the full message context (their message + any prior conversation if visible)
-
-2. Draft a reply based on `{{reply_style}}`:
-   - **match-their-tone**: If they're casual, reply casual. If formal, match it. Mirror their energy.
-   - **professional**: Clean, respectful, direct. No slang.
-   - **casual**: Friendly, short, like texting a colleague.
-   - **brief**: 1-2 sentences max. Acknowledge and respond.
-
-3. Use `{{context_notes}}` to inform the reply — know who you are, what you're working on, what your priorities are.
-
-4. Rules for drafting:
-   - Keep it short — match or be shorter than their message length
-   - Answer their question directly if they asked one
-   - If they're pitching you something, be polite but non-committal: "Thanks for sharing — I'll take a look"
-   - If they're following up, acknowledge it: "Noted, I'll get back to you on this"
-   - If it's a greeting/networking message, be warm but brief
-   - Never write anything you wouldn't want screenshotted and shared
-   - No AI-sounding language — no "I hope this message finds you well", no em dashes, no "I'd be happy to"
-
-### Phase 3: Approve via WhatsApp
-
-For each drafted reply:
-
-1. `neuron_approve_via_whatsapp` with:
-   - `phone`: `{{approval_phone}}`
-   - `api_key`: `{{neuron_api_key}}`
-   - `prompt`: A clear summary for the phone screen:
-     ```
-     New [platform] message from [sender]:
-     "[their message, truncated to 200 chars]"
-
-     Drafted reply:
-     "[your draft]"
-
-     Approve to send, reject to skip.
-     ```
-   - `context`: The full message thread for reference
-   - `timeout_seconds`: 300 (5 minutes — if no response, skip for now)
-
-2. Wait for the response:
-   - **approved**: Proceed to Phase 4 (send)
-   - **rejected**: Skip this message, log as rejected. If the rejection includes a reason, learn from it.
-   - **timeout**: Skip for now, will retry next check
-
-### Phase 4: Send approved replies
-
-For each approved reply:
-
-1. `neuron_focus_tab` on the inbox tab
-
-2. Navigate back to the conversation if not already there
-
-3. **LinkedIn:**
-   - `neuron_click` to open the conversation
-   - `neuron_scroll` to bottom of conversation so compose box is visible
-   - `neuron_type` with selectors `[".msg-form__contenteditable", "[contenteditable='true'][role='textbox']"]`
-   - `neuron_press_key` with key `Enter`
-   - Wait 2 seconds
-   - `neuron_extract_data` on the last message to verify your reply appeared
-
-4. **Gmail:**
-   - Open the email thread
-   - `neuron_scroll` to bottom of thread
-   - `neuron_click` on "Reply" button (texts: `["Reply"]`)
-   - Wait 2 seconds for the reply composer to load
-   - `neuron_find_elements` for `div[aria-label="Message Body"]` or `div[contenteditable='true']` — wait until found
-   - `neuron_type` the reply
-   - `neuron_click` on Send button (selectors: `["div[aria-label*='Send']", "button[aria-label*='Send']"]`)
-   - Wait 2 seconds, verify "Message sent" or the reply appears in the thread
-
-5. **X DMs:**
-   - Open the conversation
-   - `neuron_scroll` to bottom
-   - `neuron_type` into `div[data-testid="dmComposerTextInput"]` or `div[role="textbox"]`
-   - `neuron_press_key` Enter
-   - Wait 1 second, verify
-
-6. **Instagram DMs:**
-   - Open the conversation
-   - `neuron_scroll` to bottom
-   - `neuron_type` into `textarea[placeholder*="Message"]` or `div[contenteditable="true"][role="textbox"]`
-   - `neuron_press_key` Enter
-   - Wait 1 second, verify
-
-7. **TikTok DMs:**
-   - Open the conversation
-   - `neuron_scroll` to bottom
-   - `neuron_type` into the message input (try `div[contenteditable="true"]`, `textarea`)
-   - `neuron_press_key` Enter
-   - Wait 1 second, verify
-
-### Phase 5: Log and checkpoint
-
-After processing all messages:
-
-1. Update `seen_messages` with all processed message IDs/content hashes
-2. Update `last_checked` timestamps per inbox
-3. `neuron_session_save` with the updated state
-4. Append to `{{output_path}}/response-log.yaml`:
-
-```yaml
-- date: "{{now}}"
-  inbox: "<platform>"
-  sender: "<name>"
-  their_message: "<text>"
-  draft: "<your drafted reply>"
-  approval_status: approved|rejected|timeout
-  rejection_reason: "<if rejected, why>"
-  sent: true|false
-  send_verified: true|false
-```
-
-### Scheduling
-
-To run this automatically, the user should schedule it:
-
-```
-neuron_schedule_recipe({
-  slug: "inbox-responder",
-  interval_minutes: {{check_interval_minutes}},
-  variables: { ... },
-  enabled: true
-})
-```
-
-Each scheduled run: check all inboxes → draft → approve → send → sleep until next run.
-
-## Reflect
-
-After each run:
-
-```yaml
-date: {{now}}
-outcome:
-  inboxes_checked: [<list>]
-  new_messages_found: <count>
-  drafts_sent_for_approval: <count>
-  approved: <count>
-  rejected: <count>
-  timed_out: <count>
-  successfully_sent: <count>
-  send_failures: <count>
-  skip_auto: <count, skipped by auto_skip patterns>
-  duration_minutes: <approx>
-  rejection_reasons:
-    - "<why was a draft rejected>"
-```
-
-## Evolve
-
-After 20+ runs with 10+ approval outcomes:
-
-**Draft quality:**
-- Which drafts get approved vs rejected? What's different about them?
-- Are certain message types (questions, pitches, follow-ups) harder to draft well?
-- Does reply length correlate with approval rate?
-- Update `{{reply_style}}` defaults based on what gets approved.
-
-**Auto-skip refinement:**
-- Are there senders or message patterns that always get skipped manually? Add to `{{auto_skip}}`.
-- Are there messages being auto-skipped that shouldn't be?
-
-**Timing:**
-- Is `{{check_interval_minutes}}` right? Too frequent = checking empty inboxes. Too rare = slow responses.
-- Which inboxes get the most new messages?
-
-**Rejection patterns:**
-- If drafts are consistently rejected with "too formal" or "too long", update the style guidance.
-- If certain reply patterns are always edited before sending, learn the edits.
-
-Update learnings based on the data. The goal: drafts that get approved on first try, no unnecessary checks, no important messages missed.

package/recipes/inbox-responder/learnings.md

@@ -1,25 +0,0 @@
-# Learnings
-
-No runs yet. This file updates after 20+ runs with 10+ approval outcomes.
-
-## Reply Defaults
-
-- Match the sender's message length — don't write a paragraph to reply to one sentence
-- Answer the question first, then add context if needed
-- For pitches/cold outreach: "Thanks for sharing — I'll take a look" is almost always the right reply
-- For follow-ups: acknowledge, give a timeline or say you'll get back to them
-- For greetings: brief and warm, don't over-invest
-
-## Platform Quirks
-
-- LinkedIn: Enter-to-send by default. Use neuron_press_key("Enter") after typing.
-- Gmail: Reply composer lazy-loads. Wait for the contenteditable to appear before typing.
-- X DMs: Enter sends. Similar to LinkedIn flow.
-- Instagram: textarea-based input, Enter sends.
-
-## Auto-Skip Patterns
-
-Starting list (expand from rejection data):
-- newsletter, no-reply, noreply, automated, unsubscribe
-- "This is an automated message"
-- Sender names containing "bot", "support", "notifications"

package/recipes/inbox-responder/recipe.yaml

@@ -1,82 +0,0 @@
-name: Inbox Responder
-version: 1.0.0
-description: >
-  Watches your inboxes (LinkedIn, Gmail, X, Instagram DMs) for new messages,
-  drafts context-aware replies, sends them to your WhatsApp for approval, and
-  sends the reply on approval. Runs on a schedule — check every N minutes,
-  draft, approve from your phone, done.
-author: neuron
-tags: [inbox, auto-reply, whatsapp-approval, linkedin, gmail, x, instagram, monitoring]
-
-variables:
-  inboxes:
-    prompt: "Which inboxes to watch (comma-separated: linkedin, gmail, x, instagram, tiktok)"
-    type: text
-    required: true
-    example: "linkedin, gmail, x, instagram, tiktok"
-  check_interval_minutes:
-    prompt: "How often to check for new messages (minutes)"
-    type: number
-    default: 10
-  approval_phone:
-    prompt: "Your WhatsApp number for approval requests (E.164 format)"
-    type: text
-    required: true
-    example: "+2348012345678"
-  neuron_api_key:
-    prompt: "Neuron bot API key (nrn_...) for sending WhatsApp approvals"
-    type: text
-    required: true
-  reply_style:
-    prompt: "How should replies be written?"
-    options: [match-their-tone, professional, casual, brief]
-    default: match-their-tone
-  auto_skip:
-    prompt: "Messages to skip (comma-separated keywords or patterns)"
-    type: text
-    default: "newsletter, no-reply, noreply, automated, unsubscribe"
-  context_notes:
-    prompt: "Context about you that helps draft better replies (role, company, current priorities)"
-    type: text
-    default: ""
-  gmail_url:
-    prompt: "Gmail URL"
-    type: text
-    default: "https://mail.google.com/mail/u/0/#inbox"
-  output_path:
-    prompt: "Where to save response logs"
-    type: path
-    default: "./inbox-responses"
-
-tools:
-  required:
-    - neuron_navigate
-    - neuron_focus_tab
-    - neuron_extract_data
-    - neuron_find_elements
-    - neuron_type
-    - neuron_press_key
-    - neuron_click
-    - neuron_scroll
-    - neuron_screenshot
-    - neuron_evaluate_js
-    - neuron_list_tabs
-    - neuron_get_errors
-    - neuron_research_page
-    - neuron_approve_via_whatsapp
-    - neuron_session_save
-    - neuron_session_load
-    - neuron_session_checkpoint
-    - neuron_schedule_recipe
-
-pipes:
-  outputs:
-    response_log:
-      format: yaml
-      path: "{{output_path}}/response-log.yaml"
-      description: "Log of all messages received, drafts sent for approval, and responses sent"
-
-limits:
-  max_tabs: 4
-  max_duration_minutes: 15
-  require_human_approval: true