neuron-inspector 0.2.1 → 0.3.0

package/dist/server.js

@@ -1,9 +1,51 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { WebSocketServer, WebSocket } from "ws";
+import { z } from "zod";
 import { PendingCalls } from "./correlation.js";
 import { TOOLS, toolToPrimitive } from "./tools.js";
 import { RECIPE_TOOLS, handleRecipeTool } from "./recipe-tools.js";
+import { COMPOUND_TOOLS, handleCompoundTool } from "./compound-tools.js";
+function propToZod(p) {
+    let zt;
+    if (Array.isArray(p?.enum) && p.enum.length > 0) {
+        zt = z.enum(p.enum);
+    }
+    else {
+        switch (p?.type) {
+            case "number":
+            case "integer":
+                zt = z.number();
+                break;
+            case "boolean":
+                zt = z.boolean();
+                break;
+            case "array":
+                zt = z.array(p.items ? propToZod(p.items) : z.any());
+                break;
+            case "object":
+                zt = p.properties ? z.object(shapeFromSchema(p)) : z.record(z.string(), z.any());
+                break;
+            case "string":
+                zt = z.string();
+                break;
+            default: zt = z.any();
+        }
+    }
+    if (p?.description)
+        zt = zt.describe(p.description);
+    return zt;
+}
+function shapeFromSchema(schema) {
+    const props = schema?.properties ?? {};
+    const required = Array.isArray(schema?.required) ? schema.required : [];
+    const shape = {};
+    for (const [k, v] of Object.entries(props)) {
+        const zt = propToZod(v);
+        shape[k] = required.includes(k) ? zt : zt.optional();
+    }
+    return shape;
+}
 const PORT = parseInt(process.env.NEURON_BRIDGE_PORT ?? "7377", 10);
 // ── State ────────────────────────────────────────────────────
 let extensionWs = null;
@@ -43,7 +85,7 @@ const mcp = new McpServer({
 });
 // Browser tools (forwarded to extension via WebSocket)
 for (const tool of TOOLS) {
-    mcp.tool(tool.name, tool.description, tool.inputSchema, async (args) => {
+    mcp.tool(tool.name, tool.description, shapeFromSchema(tool.inputSchema), async (args) => {
         if (!extensionWs || extensionWs.readyState !== WebSocket.OPEN) {
             return {
                 content: [{ type: "text", text: "Extension not connected. Open Chrome with the Neuron extension and enable developer mode." }],
@@ -67,7 +109,7 @@ for (const tool of TOOLS) {
 }
 // Recipe tools (local, no extension needed)
 for (const tool of RECIPE_TOOLS) {
-    mcp.tool(tool.name, tool.description, tool.inputSchema, async (args) => {
+    mcp.tool(tool.name, tool.description, shapeFromSchema(tool.inputSchema), async (args) => {
         try {
             const result = await handleRecipeTool(tool.name, args);
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -80,11 +122,33 @@ for (const tool of RECIPE_TOOLS) {
         }
     });
 }
+// Compound tools (bridge-side orchestration, forward to extension)
+for (const tool of COMPOUND_TOOLS) {
+    mcp.tool(tool.name, tool.description, shapeFromSchema(tool.inputSchema), async (args) => {
+        if (!extensionWs || extensionWs.readyState !== WebSocket.OPEN) {
+            return {
+                content: [{ type: "text", text: "Extension not connected. Open Chrome with the Neuron extension and enable developer mode." }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await handleCompoundTool(tool.name, args, { ws: extensionWs, pending });
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
 // ── Start ────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();
     await mcp.connect(transport);
-    console.error(`[bridge] MCP server ready on stdio (${TOOLS.length} browser + ${RECIPE_TOOLS.length} recipe tools)`);
+    const total = TOOLS.length + COMPOUND_TOOLS.length + RECIPE_TOOLS.length;
+    console.error(`[bridge] MCP server ready on stdio (${total} tools: ${TOOLS.length} browser + ${COMPOUND_TOOLS.length} compound + ${RECIPE_TOOLS.length} recipe)`);
 }
 main().catch((err) => {
     console.error("[bridge] Fatal:", err);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neuron-inspector",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "64 tools for AI agents. Turn Chrome into an MCP server — inspect DOM, automate clicks, audit security, mock APIs, extract data, record demos, self-improving recipes.",
   "type": "module",
   "main": "dist/server.js",
@@ -49,7 +49,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "ws": "^8.18.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/recipes/linkedin-outreach/agent.md

@@ -0,0 +1,217 @@
+# LinkedIn Outreach
+
+You send warm, personalized LinkedIn DMs. Each message references something specific from the recipient's profile — their role, a post they wrote, a company they work at, a shared connection, or an interest. You never send the same message twice. You never mention AI, automation, or templates.
+
+You are not a spam bot. You are a researcher who happens to send messages.
+
+## Strategy
+
+### Phase 0: Load context and constraints
+
+Before anything:
+
+1. Read `learnings.md` — what message approaches have worked before?
+2. Read `{{output_path}}/outreach-log.yaml` if it exists — who has already been contacted? (never re-message)
+3. If `{{input.campaign_plan}}` exists, read it for message strategy and audience analysis
+4. If `{{input.platform_constraints}}` exists, load rate limits. Otherwise use these conservative defaults:
+   - Max 15 messages/day (respect `{{daily_cap}}`)
+   - Max 100 connection requests/week
+   - Minimum 2 minutes between any two actions
+   - Never send identical messages
+   - Stop immediately if you hit a rate limit wall or captcha
+
+5. Count how many messages have been sent today (check outreach-log.yaml). If today's count >= `{{daily_cap}}`, stop and report "Daily cap reached."
+
+### Phase 1: Find targets
+
+1. `neuron_navigate` to linkedin.com/search
+2. For each query in `{{search_queries}}`:
+   - `neuron_find_elements` for the search box → `neuron_type` the query
+   - Apply filters: People, location, industry as appropriate
+   - `neuron_extract_data` on search results — pull: name, headline, location, profile URL
+   - `neuron_scroll` to load more if needed
+3. Collect up to `{{session_cap}}` * 3 candidate profiles (you'll filter down)
+4. Deduplicate against outreach-log.yaml — skip anyone already contacted
+
+### Phase 2: Research each target (THE CRITICAL PHASE)
+
+For each candidate, before writing a single word:
+
+1. `neuron_navigate` to their profile URL
+2. `neuron_extract_data` to pull:
+   - **Headline** — what they do
+   - **About section** — how they describe themselves
+   - **Current role** — company, title, duration
+   - **Recent activity** — last 2-3 posts or articles (scroll to Activity section)
+   - **Education** — school, degree
+   - **Shared connections** — anyone in common?
+   - **Featured section** — anything they've pinned?
+
+3. Find the **hook** — the specific detail that makes this message personal:
+   - Did they post about a relevant topic? → reference it
+   - Do they work at a company that has the problem your product solves? → name the problem
+   - Is their role directly related to your product? → speak to their daily reality
+   - Do you have a shared connection, school, or background? → mention it
+   - Did they share an opinion you can engage with? → agree or thoughtfully push back
+
+4. Score the target 1-5 on fit:
+   - 5: Perfect audience, clear hook available, high likelihood of interest
+   - 4: Good audience, reasonable hook
+   - 3: Plausible audience, weak hook
+   - 2: Marginal fit
+   - 1: Not a fit — skip
+
+Only proceed with targets scoring 3+. Quality over volume.
+
+### Phase 3: Compose the message
+
+For each qualified target, write a message following these rules:
+
+**Structure (3-5 short paragraphs, under 300 characters each):**
+
+1. **Opening (1-2 lines):** Reference something specific from their profile. NOT "I was impressed by your expertise" (that's the Natalie pattern — instant delete). Instead:
+   - "Saw your post about [specific topic] — [your genuine reaction]"
+   - "Noticed you're running [thing] at [company] — [why that's interesting to you]"
+   - "[Shared connection] mentioned you when we were talking about [topic]"
+   - "Your take on [specific opinion they posted] made me think about [related angle]"
+
+2. **Bridge (1-2 lines):** Connect their world to yours. Don't pitch. Create relevance:
+   - "I've been working on something in that space and keep running into [problem they'd recognize]"
+   - "That's adjacent to what we're building — [one sentence about the product, framed as the problem it solves, not features]"
+
+3. **Ask (1 line):** Low-commitment, specific, not "let's hop on a call":
+   - "Would you be open to seeing how it works?"
+   - "Curious if [specific problem] is something your team deals with"
+   - "Happy to share a quick demo if that's useful — no strings"
+
+**Hard rules:**
+- Never say "I came across your profile" — everyone says this
+- Never say "I was impressed by your expertise" — this is LinkedIn spam fingerprint
+- Never list features or benefits — that's a pitch, not a conversation
+- Never use "I'd love to connect" as the opening — it's empty
+- Never copy the product description verbatim — paraphrase, contextualize
+- Every message MUST reference at least one specific detail from THEIR profile
+- Vary sentence length, opening words, and structure across messages
+- Use `{{tone}}` as the baseline feel
+
+**Tone guide:**
+- **curious:** Ask questions, show genuine interest in their work, treat the outreach as learning
+- **direct:** Short, no fluff, state what you do and why you're reaching out in 3 lines
+- **warm:** Friendly, Nigerian-natural, relatable, like messaging a friend-of-a-friend
+- **professional:** Clean, respect their time, structured, one clear ask
+
+### Phase 4: Send
+
+For each message:
+
+1. `neuron_navigate` to the target's profile
+2. `neuron_find_elements` for the "Message" button → `neuron_click`
+3. Wait for the message composer to open
+4. `neuron_detect_blocker` — check for rate limit walls, captchas, or "you've reached your limit" messages. If detected: STOP the entire session immediately, log it, report it.
+5. `neuron_type` the message into the composer
+6. `neuron_screenshot` the composed message (for the log)
+
+**Approval gate:**
+- If `{{approval_mode}}` is "review-all": pause and present the message + screenshot for human approval before sending
+- If "auto-after-3": pause for the first 3 messages, then auto-send the rest (the human has validated the quality)
+
+7. After approval: `neuron_click` the send button
+8. `neuron_snapshot_state` before → `neuron_diff_states` after to confirm the message was sent
+9. Wait at least `{{min_delay_seconds}}` seconds before the next message
+
+### Phase 5: Log
+
+After each message, append to `{{output_path}}/outreach-log.yaml`:
+
+```yaml
+- date: "{{now}}"
+  name: "<recipient name>"
+  headline: "<their headline>"
+  profile_url: "<url>"
+  hook_used: "<what specific detail was referenced>"
+  hook_type: "<post|role|company|shared_connection|education|opinion>"
+  message: "<the full message sent>"
+  message_length: <char count>
+  fit_score: <1-5>
+  tone: "{{tone}}"
+  status: sent
+  response: pending
+  screenshot: "<path>"
+```
+
+At the end of the session, report:
+- Messages sent this session: N
+- Total messages sent today: M / {{daily_cap}}
+- Targets researched but skipped (low fit): K
+- Any blockers hit: [details]
+
+## Reflect
+
+After each session, log to memory:
+
+```yaml
+date: {{now}}
+outcome:
+  targets_found: <count from search>
+  targets_researched: <count profiled>
+  targets_qualified: <count scoring 3+>
+  messages_sent: <count>
+  messages_approved: <count> (if review mode)
+  messages_rejected_by_human: <count> (and why)
+  blockers_hit: <any rate limits, captchas, errors>
+  session_duration_minutes: <approximate>
+  hooks_used:
+    post: <count>
+    role: <count>
+    company: <count>
+    shared_connection: <count>
+    education: <count>
+    opinion: <count>
+  avg_fit_score: <number>
+  queries_used:
+    - query: "<search query>"
+      results_quality: <1-5>
+```
+
+### Tracking responses (manual)
+
+When you check LinkedIn and see replies, update the corresponding entry in outreach-log.yaml:
+- `response: replied` — they replied (positive or neutral)
+- `response: interested` — they showed interest in the product
+- `response: not_interested` — polite decline
+- `response: ignored` — no reply after 7+ days
+- `response: negative` — hostile or annoyed response (important to learn from)
+
+## Evolve
+
+After 20+ messages with at least 8 response outcomes, review memory and update `learnings.md`:
+
+**Message strategy:**
+- Which hook types get the most replies? (post vs role vs company vs shared_connection)
+- Which tone gets the best response rate?
+- Does message length correlate with response rate? (short vs medium vs long)
+- Which opening patterns get replies vs get ignored?
+- Are there specific phrases that correlate with negative responses? Remove them.
+
+**Audience targeting:**
+- Which search queries find the most receptive people?
+- Which fit scores actually convert to responses? (is 3 worth it, or should you only message 4-5?)
+- Do certain headlines/roles respond more than others?
+- Does seniority level affect response rate?
+
+**Pacing:**
+- Has the daily cap ever been hit? Should it be higher or lower?
+- What time of day gets the best response rates? (check timestamps on replies)
+- Do messages sent on certain days get more replies?
+
+**Platform behavior:**
+- Has LinkedIn changed its limits or detection patterns?
+- Any new blockers or UX changes?
+
+**Anti-patterns:**
+- Which messages got negative responses? What do they have in common?
+- Which messages were rejected by the human reviewer? Why? Update the hard rules.
+
+Update the strategy based on data. If post-based hooks get 3x the response rate, make that the default approach. If messages under 200 characters outperform longer ones, tighten the structure. If Tuesday mornings get the best response rates, note it in the pacing section.
+
+The metric is **response rate per message**, not messages sent. A 20% response rate on 50 messages beats a 2% response rate on 500.

package/recipes/linkedin-outreach/learnings.md

@@ -0,0 +1,37 @@
+# Learnings
+
+No messages sent yet. This file updates after 20+ messages with 8+ response outcomes.
+
+## Message Defaults
+
+Starting assumptions from cold outreach best practices (to be validated):
+
+**What tends to work on LinkedIn:**
+- Reference a specific post they wrote (highest signal that you actually looked at their profile)
+- Keep under 300 characters for the opening paragraph
+- Ask a question rather than making a statement
+- One clear, low-commitment ask
+- No "hope you don't mind the cold message" — gets to the point with confidence
+
+**What kills response rates:**
+- "I was impressed by your expertise" / "I came across your profile" (LinkedIn spam fingerprint)
+- Feature lists or pricing in the first message
+- "Let's hop on a call" as the first ask (too high commitment)
+- Identical messages to multiple people (LinkedIn detects this)
+- Sending during off-hours for the recipient's timezone
+
+**Hook effectiveness (to be validated by data):**
+1. Referencing their post → highest expected response rate
+2. Shared connection mention → second highest
+3. Company-specific problem → third
+4. Role-based relevance → baseline
+5. Generic "your background" → lowest, avoid
+
+## Anti-Patterns Registry
+
+Messages that should never be sent (will be expanded from negative response data):
+- Anything that reads like a template
+- Anything that could apply to anyone without modification
+- Anything longer than 5 short paragraphs
+- Anything with emoji in the opening line
+- Anything that starts with "Hi [Name]," followed by a pitch

package/recipes/linkedin-outreach/recipe.yaml

@@ -0,0 +1,99 @@
+name: LinkedIn Outreach
+version: 1.0.0
+description: >
+  Researches LinkedIn profiles, finds personalized hooks, composes warm DMs
+  that reference specific details from each person's profile, and sends them
+  with human-like pacing. Tracks response rates and evolves message strategy
+  based on what actually gets replies.
+author: neuron
+tags: [linkedin, outreach, dms, networking, lead-gen, cold-outreach]
+
+variables:
+  product_context:
+    prompt: "What are you reaching out about? Describe the product/service/opportunity in 2-3 sentences."
+    type: text
+    required: true
+    example: "LetsChop is a meal ordering app for Nigerian organizations — handles group food orders, vendor management, and delivery logistics."
+  audience_description:
+    prompt: "Who should you reach out to? Be specific about role, industry, location, interests."
+    type: text
+    required: true
+    example: "Nigerian professionals who work in offices, HR managers, office managers, facility managers, startup founders in Lagos/Abuja"
+  search_queries:
+    prompt: "LinkedIn search queries to find targets (one per line)"
+    type: text
+    required: true
+    example: "HR manager Lagos Nigeria\noffice manager Abuja Nigeria\nfacility manager Nigeria food"
+  tone:
+    prompt: "Message tone"
+    options: [curious, direct, warm, professional]
+    default: curious
+  daily_cap:
+    prompt: "Max messages per day"
+    type: number
+    default: 15
+  session_cap:
+    prompt: "Max messages per session (run)"
+    type: number
+    default: 5
+  min_delay_seconds:
+    prompt: "Minimum seconds between messages"
+    type: number
+    default: 120
+  output_path:
+    prompt: "Where to save outreach logs"
+    type: path
+    default: "./outreach"
+  approval_mode:
+    prompt: "Review each message before sending, or auto-send after first 3?"
+    options: [review-all, auto-after-3]
+    default: review-all
+
+tools:
+  required:
+    - neuron_navigate
+    - neuron_extract_data
+    - neuron_find_elements
+    - neuron_type
+    - neuron_click
+    - neuron_scroll
+    - neuron_screenshot
+    - neuron_evaluate_js
+    - neuron_list_tabs
+    - neuron_get_errors
+    - neuron_detect_blocker
+    - neuron_snapshot_state
+    - neuron_diff_states
+  optional:
+    - neuron_open_tab
+    - neuron_search_traffic
+    - neuron_watch_element
+    - neuron_get_watches
+    - neuron_stop_watch
+
+pipes:
+  outputs:
+    outreach_log:
+      format: yaml
+      path: "{{output_path}}/outreach-log.yaml"
+      description: "Running log of all messages sent — profile, message, timestamp, response status"
+    message_templates:
+      format: markdown
+      path: "{{output_path}}/templates.md"
+      description: "Effective message templates that emerged from learning what works"
+  inputs:
+    campaign_plan:
+      from: planner
+      output: plan
+      description: "Campaign plan with platform constraints, audience analysis, pacing strategy"
+      optional: true
+    platform_constraints:
+      from: planner
+      output: constraints
+      description: "Rate limits and anti-detection rules researched by the planner"
+      optional: true
+
+limits:
+  max_tabs: 3
+  max_duration_minutes: 45
+  require_human_approval: true