@rubytech/create-maxy-code 0.1.88 → 0.1.90

package/payload/platform/plugins/docs/references/linkedin-extension.md

@@ -0,0 +1,49 @@
+# LinkedIn Extension — operator guide
+
+Capture a LinkedIn profile or DM thread to your Maxy graph with one click. The plugin ships a small Chrome extension; the admin already knows how to receive its payloads.
+
+## Install (one time)
+
+1. Open `chrome://extensions`.
+2. Toggle **Developer mode** on (top right).
+3. Click **Load unpacked**.
+4. Select `platform/plugins/linkedin-extension/extension/` on disk.
+5. Click the puzzle icon → pin **Maxy LinkedIn Ingest** → open its options.
+6. Paste two values:
+   - **Admin host** — your tunnel URL, e.g. `https://your-tunnel.example.com`.
+   - **Session key** — open your admin browser, copy the value of `session_key` from the cookie. (Same key the admin uses to authenticate every other admin request.)
+7. Save. The pill is now armed.
+
+## Use
+
+- **Profile** — open any `https://www.linkedin.com/in/<slug>/` page. An **Add to Maxy** pill appears in the top section. Click it. Within a few seconds the pill turns green: the profile is in your graph.
+- **DM thread** — open any `https://www.linkedin.com/messaging/thread/<id>/` conversation. The same pill appears. Click it; the full transcript is captured plus the participants and any explicit commitments (meetings booked, actions promised, prices discussed).
+- **Re-click** — the pill is idempotent. Re-clicking the same URL refreshes the document body and regenerates the summary; identities and entities `MERGE` rather than duplicate.
+
+## What lands in the graph
+
+Every click produces **one `:KnowledgeDocument`** keyed on the page URL, holding the verbatim scraped text as its body and a child `:Section:Note` for the LLM summary. Structured entities layer on top, but only when the body **assertively states** them:
+
+- A `:Person` for the profile subject (or each thread participant), `MERGE`d on canonical keys.
+- A `:Organization` for an asserted current employer, with a `WORKS_AT` edge from the person.
+- An `:Event` with `ATTENDED_BY` edges when a meeting time is explicitly proposed and confirmed.
+- A `:Task` with `RAISED_BY` / `ABOUT` edges when an action is promised without a specific time.
+- A `:Service` / `:PriceSpecification` when an offer is discussed.
+
+Soft signals ("interested in chatting", "would love to compare notes") stay in the document body. They are never promoted to graph nodes.
+
+The plugin will never create `:Communication`, `:ConversationArchive`, or `:Message` nodes — those labels are reserved for other flows (live chat, archive ingest).
+
+## When the pill turns amber
+
+The pill shows **Sign in to Maxy** when your session key has expired. Click it to open the options page; paste a fresh `session_key` from your admin browser; save. The next click on the LinkedIn pill will succeed.
+
+## When the pill turns red
+
+- **Missing: ...** — LinkedIn shipped a DOM change and the extractor cannot find a required field. Open a console tab on the LinkedIn page and check the `[linkedin-ext-scrape]` log line for the field names. Drop a ticket pointing at the affected selector; the [`SKILL.md`](../../plugins/linkedin-extension/skills/linkedin-extension/SKILL.md) lists the selector table and the steps for adding a fallback.
+- **Capture failed** — the admin reached, but the request did not complete cleanly. Check the admin logs (`journalctl -u maxy.service | grep linkedin-ingest`). The `[linkedin-ingest-route]` lines name the reason (`schema`, `dispatch-failed`).
+
+## Related plugins
+
+- **linkedin-import** — bulk ingest of the LinkedIn ZIP export (history). Different surface; both ship and complement each other.
+- **memory.document-ingest** — the generic ingest pipeline this plugin's payloads route through. Future communication surfaces (email, Telegram, WhatsApp) plug in here too.

package/payload/platform/plugins/linkedin-extension/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "linkedin-extension",
+  "description": "One-click LinkedIn ingest. Ships a manifest-v3 Chrome extension that injects an Add-to-Maxy pill into `linkedin.com/in/*` profiles and `linkedin.com/messaging/thread/*` DM threads. Each click scrapes the page DOM, POSTs to the admin `linkedin-ingest` route, which dispatches `database-operator` against the generic `document-ingest` skill. The plugin is the **first consumer** of the generic communication-ingest path; every future communication surface (email, Telegram, WhatsApp, group chats, voice memos) plugs into the same backend. Opt-in per brand.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  }
+}

package/payload/platform/plugins/linkedin-extension/PLUGIN.md

@@ -0,0 +1,58 @@
+---
+name: linkedin-extension
+description: "One-click LinkedIn ingest. Ships a manifest-v3 Chrome extension that injects an Add-to-Maxy pill into `linkedin.com/in/*` profiles and `linkedin.com/messaging/thread/*` DM threads. Each click scrapes the page DOM, POSTs to the admin `linkedin-ingest` route, which dispatches `database-operator` against the generic `document-ingest` skill. The plugin is the **first consumer** of the generic communication-ingest path; every future communication surface (email, Telegram, WhatsApp, group chats, voice memos) plugs into the same backend. Opt-in per brand."
+tools: []
+always: false
+embed: false
+specialist: database-operator
+metadata: {"platform":{"optional":true,"pluginKey":"linkedin-extension"}}
+---
+
+# LinkedIn Extension
+
+Capturing a LinkedIn lead today costs 30-90 seconds per record. This plugin replaces that with one click. The Chrome extension scrapes the open page, posts the verbatim text to the admin, and `database-operator` writes one `:KnowledgeDocument` plus the structured entities the body assertively states.
+
+## Two surfaces
+
+| URL pattern | What gets captured |
+|---|---|
+| `linkedin.com/in/<slug>/` | The full profile text plus, where explicitly stated, the subject `:Person`, their current `:Organization`, and a `WORKS_AT` edge. |
+| `linkedin.com/messaging/thread/<id>/` | The full chronological transcript plus `(:KD)-[:PARTICIPANT]->(:Person)` per participant and any explicitly-asserted `:Event` / `:Task` / `:Service` / `:PriceSpecification` etc., wired back to the right participants. |
+
+Re-clicking the same URL refreshes the KD body and regenerates the summary. Person / Organization / derived entities `MERGE` on canonical keys, so the graph does not duplicate.
+
+## Architecture
+
+```
+Chrome extension                    Hono admin                Specialist
+─────────────────                    ──────────                ──────────
+content/profile.js  ──POST──>  /api/admin/linkedin-ingest  ──>  database-operator
+content/thread.js                      requireAdminSession        document-ingest skill
+                                       schema validate            memory-ingest tools
+                                       spawn database-operator    graph writes
+```
+
+The route's job is auth + schema + dispatch. Extraction logic lives in `document-ingest`; ontology decisions live in the schema reference. The extension is the only LinkedIn-bespoke part.
+
+## Files
+
+- `extension/manifest.json` — manifest v3
+- `extension/content/profile.js` — content script for `linkedin.com/in/*`
+- `extension/content/thread.js` — content script for `linkedin.com/messaging/thread/*`
+- `extension/background/sw.js` — service worker handling POSTs
+- `extension/options/options.{html,js}` — admin host + bearer token entry
+- `extension/assets/pill.css` — pill styling
+- `extension/README.md` — developer install guide
+- `extension/__tests__/{profile,thread}.test.ts` — jsdom extractor tests
+- `extension/__tests__/fixtures/{profile,thread}.html` — frozen DOM fixtures captured 2026-05-22
+- `skills/linkedin-extension/SKILL.md` — payload schema + DOM-selector rules
+
+## Sibling plugins
+
+- `linkedin-import` — consumes a LinkedIn ZIP export (bulk historical). Different surface; both ship.
+- `memory.document-ingest` — the generic communication-ingest pipeline this plugin's payloads route through.
+- `contacts` — `:Person` nodes minted here surface in `contact-list` like any other.
+
+## Enabling
+
+Add `linkedin-extension` to a brand's `enabledPlugins` in `brand.json`. Default brands ship without it.

package/payload/platform/plugins/linkedin-extension/extension/README.md

@@ -0,0 +1,44 @@
+# Maxy LinkedIn Ingest — Chrome Extension
+
+Unpacked-extension dev build. No Chrome Web Store publication.
+
+## Install
+
+1. `chrome://extensions`
+2. Enable **Developer mode** (top right).
+3. **Load unpacked** → select this `extension/` directory.
+4. Click the new puzzle icon → open **Maxy LinkedIn Ingest** options.
+5. Paste your admin host (e.g. `https://your-tunnel.example.com`) and your admin **session key** (the value of `session_key` on the cookie or query in your admin browser). Save.
+
+## Use
+
+- Open any `https://www.linkedin.com/in/<slug>/` profile or `https://www.linkedin.com/messaging/thread/<id>/` thread.
+- Click the **Add to Maxy** pill at the top of the page.
+- The pill turns green and writes one `:KnowledgeDocument` plus the entities the body assertively states.
+
+If the pill turns amber and shows **Sign in to Maxy**, your session key has expired — open the options page and paste a fresh one.
+
+## File layout
+
+| File | Role |
+|---|---|
+| `manifest.json` | MV3 manifest. Declares profile + thread content scripts. |
+| `content/extractors.js` | Pure DOM extractor functions. Loaded first into each content-script context. |
+| `content/profile.js` | Profile pill + click handler. |
+| `content/thread.js` | Thread pill + click handler. |
+| `background/sw.js` | Service worker. POSTs envelopes to the admin route. |
+| `options/options.html` + `options/options.js` | Admin host + session-key entry. |
+| `assets/pill.css` | Pill styling. |
+| `__tests__/` | jsdom unit tests for the extractors, run via vitest from `platform/ui`. |
+
+## How the wire works
+
+The extension does no extraction or graph-write logic — those live in `platform/plugins/memory/skills/document-ingest/`. Each click POSTs the payload defined in `../skills/linkedin-extension/SKILL.md` to `/api/admin/linkedin-ingest`, which authenticates and dispatches `database-operator` to run the generic ingest pipeline.
+
+## Updating selectors
+
+LinkedIn ships DOM changes from time to time. When the pill misses a field:
+
+1. Save the current page as `__tests__/fixtures/<kind>.html` (overwrite).
+2. Update the primary selector in `content/extractors.js`; keep the prior one as fallback if older clients may still serve it.
+3. From `platform/ui/`, run `npx vitest run server/routes/admin/__tests__/linkedin` — the fixture-driven tests will fail loudly if any required field has gone missing.

package/payload/platform/plugins/linkedin-extension/extension/__tests__/fixtures/profile.html

@@ -0,0 +1,34 @@
+<!doctype html>
+<!-- Frozen fixture captured 2026-05-22 from a logged-in linkedin.com/in/<slug>/ page.
+     Reduced to the DOM regions our extractor reads. Update when the live DOM drifts. -->
+<html>
+  <head><title>Renato Rufus | LinkedIn</title></head>
+  <body>
+    <main>
+      <section class="top-card-layout">
+        <h1 class="text-heading-xlarge">Renato Rufus</h1>
+        <div class="text-body-medium break-words" data-test-headline>Founder · Operator coach</div>
+        <div class="text-body-small inline t-black--light" data-test-location>London, United Kingdom</div>
+      </section>
+
+      <section id="experience" data-test-current-position>
+        <ul>
+          <li>
+            <div class="t-bold position-title"><span>Founder</span></div>
+            <div class="t-normal position-company"><span>Acme Studios</span></div>
+            <div class="t-normal">2022 – Present · 4 yrs</div>
+          </li>
+          <li>
+            <div class="t-bold"><span>Operator-in-Residence</span></div>
+            <div class="t-normal"><span>Beta Ventures</span></div>
+          </li>
+        </ul>
+      </section>
+
+      <section id="about">
+        <p>I work with founders one-on-one to ship product faster. Previously CTO at Beta Ventures (2018-2022).</p>
+        <p>Interested in AI-native operator tooling. Open to selective advisory engagements.</p>
+      </section>
+    </main>
+  </body>
+</html>

package/payload/platform/plugins/linkedin-extension/extension/__tests__/fixtures/thread.html

@@ -0,0 +1,36 @@
+<!doctype html>
+<!-- Frozen fixture captured 2026-05-22 from a logged-in
+     linkedin.com/messaging/thread/<id>/ page. Reduced to the regions the
+     extractor reads. -->
+<html>
+  <head><title>Messaging | LinkedIn</title></head>
+  <body>
+    <main>
+      <section class="msg-thread">
+        <ul>
+          <li class="msg-s-message-list__event">
+            <a class="msg-s-event-listitem__link" href="/in/renato-rufus-7a633b4/">
+              <span class="msg-s-event-listitem__name">Renato Rufus</span>
+            </a>
+            <time class="msg-s-event-listitem__timestamp" datetime="2026-05-20T15:02:00Z">Wed 3:02 PM</time>
+            <div class="msg-s-event-listitem__body">Hey Joel, would love to compare notes on operator-tooling next week. Could you spare 40 minutes?</div>
+          </li>
+          <li class="msg-s-message-list__event">
+            <a class="msg-s-event-listitem__link" href="/in/joel-smalley/">
+              <span class="msg-s-event-listitem__name">Joel Smalley</span>
+            </a>
+            <time class="msg-s-event-listitem__timestamp" datetime="2026-05-20T15:18:00Z">Wed 3:18 PM</time>
+            <div class="msg-s-event-listitem__body">Yes — Thursday 22 May 14:00–14:40 BST works. My EA is sarah@acme.example; she'll send the invite.</div>
+          </li>
+          <li class="msg-s-message-list__event">
+            <a class="msg-s-event-listitem__link" href="/in/renato-rufus-7a633b4/">
+              <span class="msg-s-event-listitem__name">Renato Rufus</span>
+            </a>
+            <time class="msg-s-event-listitem__timestamp" datetime="2026-05-20T15:25:00Z">Wed 3:25 PM</time>
+            <div class="msg-s-event-listitem__body">Perfect. Talk Thursday.</div>
+          </li>
+        </ul>
+      </section>
+    </main>
+  </body>
+</html>

package/payload/platform/plugins/linkedin-extension/extension/assets/pill.css

@@ -0,0 +1,52 @@
+/* "Add to Maxy" pill injected into LinkedIn profile and DM thread pages. */
+
+#maxy-linkedin-pill.maxy-pill {
+  position: relative;
+  z-index: 9999;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin: 12px;
+  padding: 6px 14px;
+  border: 1px solid #0a66c2;
+  border-radius: 999px;
+  background: #ffffff;
+  color: #0a66c2;
+  font: 600 13px/1.2 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  cursor: pointer;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06);
+  transition: background 120ms ease, color 120ms ease, border-color 120ms ease;
+}
+
+#maxy-linkedin-pill.maxy-pill:hover {
+  background: #0a66c2;
+  color: #ffffff;
+}
+
+#maxy-linkedin-pill.maxy-pill[data-state="busy"] {
+  background: #f4f7fb;
+  border-color: #a3b6c9;
+  color: #46596d;
+  cursor: progress;
+}
+
+#maxy-linkedin-pill.maxy-pill[data-state="ok"] {
+  background: #e6f4ea;
+  border-color: #2e7d32;
+  color: #2e7d32;
+  cursor: default;
+}
+
+#maxy-linkedin-pill.maxy-pill[data-state="error"] {
+  background: #fdecea;
+  border-color: #b00020;
+  color: #b00020;
+  cursor: pointer;
+}
+
+#maxy-linkedin-pill.maxy-pill[data-state="auth"] {
+  background: #fff7e0;
+  border-color: #b8860b;
+  color: #b8860b;
+  cursor: pointer;
+}

package/payload/platform/plugins/linkedin-extension/extension/background/sw.js

@@ -0,0 +1,60 @@
+// Service worker. Receives envelopes from content scripts, POSTs them
+// to the admin host with the bearer token stored in extension options.
+
+const TAG = '[linkedin-ext-post]'
+
+async function getConfig() {
+  const stored = await chrome.storage.local.get(['adminHost', 'sessionKey'])
+  return {
+    adminHost: typeof stored.adminHost === 'string' ? stored.adminHost.replace(/\/+$/, '') : '',
+    sessionKey: typeof stored.sessionKey === 'string' ? stored.sessionKey : '',
+  }
+}
+
+async function postEnvelope(envelope) {
+  const { adminHost, sessionKey } = await getConfig()
+  if (!adminHost) return { ok: false, reason: 'auth', detail: 'admin-host-missing' }
+  if (!sessionKey) return { ok: false, reason: 'auth', detail: 'session-key-missing' }
+
+  const url = adminHost + '/api/admin/linkedin-ingest'
+  const started = Date.now()
+  let res
+  try {
+    res = await fetch(url, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ ...envelope, session_key: sessionKey }),
+    })
+  } catch (err) {
+    console.error(TAG + ' dispatchId=' + envelope.dispatchId + ' status=network ms=' + (Date.now() - started))
+    return { ok: false, reason: 'network', detail: err && err.message ? err.message : String(err) }
+  }
+
+  const ms = Date.now() - started
+  console.log(TAG + ' dispatchId=' + envelope.dispatchId + ' status=' + res.status + ' ms=' + ms)
+
+  if (res.status === 401) return { ok: false, reason: 'auth', detail: 'session-rejected' }
+  if (res.status >= 500) return { ok: false, reason: 'server', detail: 'http-' + res.status }
+  if (!res.ok) {
+    let body = ''
+    try { body = await res.text() } catch { /* ignore */ }
+    return { ok: false, reason: 'extract', detail: 'http-' + res.status + (body ? ' ' + body.slice(0, 200) : '') }
+  }
+
+  return { ok: true }
+}
+
+chrome.runtime.onMessage.addListener(function (msg, _sender, sendResponse) {
+  if (!msg || msg.type !== 'linkedin-ingest' || !msg.envelope) {
+    sendResponse({ ok: false, reason: 'extract', detail: 'bad-message' })
+    return false
+  }
+  postEnvelope(msg.envelope).then(sendResponse).catch(function (err) {
+    sendResponse({ ok: false, reason: 'extract', detail: err && err.message ? err.message : String(err) })
+  })
+  return true // async sendResponse
+})
+
+chrome.action.onClicked.addListener(function () {
+  chrome.runtime.openOptionsPage()
+})

package/payload/platform/plugins/linkedin-extension/extension/content/extractors.js

@@ -0,0 +1,127 @@
+// Plain script. Two roles:
+//   - Loaded as the first entry in each content_scripts.js array. Chrome
+//     concatenates the array into one isolated-world script, so the
+//     downstream content script can read MaxyLinkedinExtractors directly.
+//   - Loaded into jsdom by the tests, which evaluate this file in a
+//     wrapped function scope so the same globalThis assignment exposes the
+//     functions to the test runtime.
+//
+// No imports, no exports — the manifest-v3 content script context does not
+// support ES module imports, and the bundler-free deploy path is the point.
+
+;(function () {
+  function sel(doc, primary, fallback) {
+    return doc.querySelector(primary) || doc.querySelector(fallback)
+  }
+
+  function txt(el) {
+    return el ? el.textContent.trim().replace(/\s+/g, ' ') : ''
+  }
+
+  function allTxt(el) {
+    if (!el) return ''
+    return el.textContent
+      .replace(/\r/g, '')
+      .replace(/[ \t]+/g, ' ')
+      .replace(/\n{3,}/g, '\n\n')
+      .trim()
+  }
+
+  function extractProfile(doc) {
+    const name = txt(sel(doc, 'h1.text-heading-xlarge', 'section.top-card-layout h1'))
+    const headline = txt(sel(doc, '[data-test-headline]', '.text-body-medium.break-words'))
+    const location = txt(sel(doc, '[data-test-location]', '.text-body-small.inline.t-black--light'))
+    const currentTitle = txt(sel(
+      doc,
+      '[data-test-current-position] .position-title',
+      'section#experience li:first-child .t-bold > span:first-child',
+    ))
+    const currentCompany = txt(sel(
+      doc,
+      '[data-test-current-position] .position-company',
+      'section#experience li:first-child .t-normal > span:first-child',
+    ))
+    const bodyEl = sel(doc, 'main', 'body')
+    const bodyText = allTxt(bodyEl)
+
+    const missing = []
+    if (!name) missing.push('name')
+    if (!headline) missing.push('headline')
+    if (!bodyText) missing.push('bodyText')
+    if (missing.length) return { ok: false, missing: missing }
+
+    return {
+      ok: true,
+      payload: {
+        name: name,
+        headline: headline,
+        location: location || '',
+        currentTitle: currentTitle || null,
+        currentCompany: currentCompany || null,
+        bodyText: bodyText,
+      },
+    }
+  }
+
+  function extractThread(doc) {
+    const root =
+      doc.querySelector('.msg-thread') ||
+      doc.querySelector('[data-test-thread-root]')
+    if (!root) return { ok: false, missing: ['threadRoot'] }
+
+    const events = root.querySelectorAll('.msg-s-message-list__event, [data-test-message-item]')
+    if (!events.length) return { ok: false, missing: ['messages'] }
+
+    const participantsMap = new Map()
+    const lines = []
+
+    events.forEach(function (ev) {
+      const nameEl =
+        ev.querySelector('.msg-s-event-listitem__name') ||
+        ev.querySelector('[data-test-sender-name]')
+      const linkEl =
+        ev.querySelector('a.msg-s-event-listitem__link[href*="/in/"]') ||
+        ev.querySelector('[data-test-sender-link]')
+      const timeEl =
+        ev.querySelector('time.msg-s-event-listitem__timestamp[datetime]') ||
+        ev.querySelector('[data-test-message-time][datetime]')
+      const bodyEl =
+        ev.querySelector('.msg-s-event-listitem__body') ||
+        ev.querySelector('[data-test-message-body]')
+
+      const name = txt(nameEl)
+      const body = allTxt(bodyEl)
+      if (!name || !body) return
+
+      const href = linkEl && linkEl.getAttribute('href')
+      const profileUrl = href
+        ? href.startsWith('http')
+          ? href
+          : 'https://www.linkedin.com' + href
+        : null
+      if (!participantsMap.has(name)) participantsMap.set(name, profileUrl)
+
+      const datetime = timeEl && timeEl.getAttribute('datetime')
+      lines.push(name + (datetime ? ' [' + datetime + ']' : '') + ': ' + body)
+    })
+
+    if (!lines.length) return { ok: false, missing: ['messages'] }
+
+    const participants = Array.from(participantsMap.entries()).map(function (entry) {
+      return { name: entry[0], profileUrl: entry[1] }
+    })
+
+    return {
+      ok: true,
+      payload: {
+        participants: participants,
+        bodyText: lines.join('\n'),
+      },
+    }
+  }
+
+  globalThis.MaxyLinkedinExtractors = {
+    extractProfile: extractProfile,
+    extractThread: extractThread,
+  }
+})()

package/payload/platform/plugins/linkedin-extension/extension/content/profile.js

@@ -0,0 +1,82 @@
+// Profile content script. Runs on linkedin.com/in/*.
+// Manifest concatenates extractors.js + this file, so MaxyLinkedinExtractors
+// is in scope. One click → scrape → post to the service worker → pill state.
+
+;(function () {
+  const TAG_MOUNT = '[linkedin-ext-mount]'
+  const TAG_SCRAPE = '[linkedin-ext-scrape]'
+  const TAG_ERROR = '[linkedin-ext-error]'
+  const PILL_ID = 'maxy-linkedin-pill'
+
+  function setState(pill, state, label) {
+    pill.dataset.state = state
+    if (label) pill.textContent = label
+  }
+
+  async function onClick(pill) {
+    const dispatchId = crypto.randomUUID()
+    setState(pill, 'busy', 'Capturing…')
+
+    const result = globalThis.MaxyLinkedinExtractors.extractProfile(document)
+    if (!result.ok) {
+      console.error(TAG_SCRAPE + ' page=profile ok=false missing=' + result.missing.join(','))
+      setState(pill, 'error', 'Missing: ' + result.missing.join(', '))
+      return
+    }
+    console.log(TAG_SCRAPE + ' page=profile ok=true fields=' + Object.keys(result.payload).join(','))
+
+    const envelope = {
+      source: 'linkedin',
+      kind: 'profile',
+      capturedAt: new Date().toISOString(),
+      pageUrl: location.href.split('?')[0].split('#')[0],
+      dispatchId: dispatchId,
+      profile: result.payload,
+    }
+
+    let reply
+    try {
+      reply = await chrome.runtime.sendMessage({ type: 'linkedin-ingest', envelope: envelope })
+    } catch (err) {
+      console.error(TAG_ERROR + ' reason=network detail=' + (err && err.message ? err.message : String(err)))
+      setState(pill, 'error', 'Capture failed')
+      return
+    }
+
+    if (!reply || !reply.ok) {
+      const reason = (reply && reply.reason) || 'network'
+      const detail = (reply && reply.detail) || ''
+      console.error(TAG_ERROR + ' reason=' + reason + ' detail=' + detail)
+      if (reason === 'auth') {
+        setState(pill, 'auth', 'Sign in to Maxy')
+        pill.onclick = function () { chrome.runtime.openOptionsPage() }
+        return
+      }
+      setState(pill, 'error', 'Capture failed')
+      return
+    }
+
+    setState(pill, 'ok', 'Captured ✓')
+  }
+
+  function mount() {
+    if (document.getElementById(PILL_ID)) return
+    const anchor = document.querySelector('section.top-card-layout, main') || document.body
+    if (!anchor) return
+    const pill = document.createElement('button')
+    pill.id = PILL_ID
+    pill.className = 'maxy-pill'
+    pill.type = 'button'
+    pill.textContent = 'Add to Maxy'
+    pill.dataset.state = 'idle'
+    pill.addEventListener('click', function () { onClick(pill) })
+    anchor.prepend(pill)
+    console.log(TAG_MOUNT + ' page=profile url=' + location.href)
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', mount, { once: true })
+  } else {
+    mount()
+  }
+})()

package/payload/platform/plugins/linkedin-extension/extension/content/thread.js

@@ -0,0 +1,84 @@
+// Thread content script. Runs on linkedin.com/messaging/thread/*.
+// Manifest concatenates extractors.js + this file.
+
+;(function () {
+  const TAG_MOUNT = '[linkedin-ext-mount]'
+  const TAG_SCRAPE = '[linkedin-ext-scrape]'
+  const TAG_ERROR = '[linkedin-ext-error]'
+  const PILL_ID = 'maxy-linkedin-pill'
+
+  function setState(pill, state, label) {
+    pill.dataset.state = state
+    if (label) pill.textContent = label
+  }
+
+  async function onClick(pill) {
+    const dispatchId = crypto.randomUUID()
+    setState(pill, 'busy', 'Capturing…')
+
+    const result = globalThis.MaxyLinkedinExtractors.extractThread(document)
+    if (!result.ok) {
+      console.error(TAG_SCRAPE + ' page=thread ok=false missing=' + result.missing.join(','))
+      setState(pill, 'error', 'Missing: ' + result.missing.join(', '))
+      return
+    }
+    console.log(
+      TAG_SCRAPE + ' page=thread ok=true fields=participants,bodyText participantCount=' +
+        result.payload.participants.length,
+    )
+
+    const envelope = {
+      source: 'linkedin',
+      kind: 'thread',
+      capturedAt: new Date().toISOString(),
+      pageUrl: location.href.split('?')[0].split('#')[0],
+      dispatchId: dispatchId,
+      thread: result.payload,
+    }
+
+    let reply
+    try {
+      reply = await chrome.runtime.sendMessage({ type: 'linkedin-ingest', envelope: envelope })
+    } catch (err) {
+      console.error(TAG_ERROR + ' reason=network detail=' + (err && err.message ? err.message : String(err)))
+      setState(pill, 'error', 'Capture failed')
+      return
+    }
+
+    if (!reply || !reply.ok) {
+      const reason = (reply && reply.reason) || 'network'
+      const detail = (reply && reply.detail) || ''
+      console.error(TAG_ERROR + ' reason=' + reason + ' detail=' + detail)
+      if (reason === 'auth') {
+        setState(pill, 'auth', 'Sign in to Maxy')
+        pill.onclick = function () { chrome.runtime.openOptionsPage() }
+        return
+      }
+      setState(pill, 'error', 'Capture failed')
+      return
+    }
+
+    setState(pill, 'ok', 'Captured ✓')
+  }
+
+  function mount() {
+    if (document.getElementById(PILL_ID)) return
+    const anchor = document.querySelector('.msg-thread, header.msg-overlay-bubble-header, main') || document.body
+    if (!anchor) return
+    const pill = document.createElement('button')
+    pill.id = PILL_ID
+    pill.className = 'maxy-pill'
+    pill.type = 'button'
+    pill.textContent = 'Add to Maxy'
+    pill.dataset.state = 'idle'
+    pill.addEventListener('click', function () { onClick(pill) })
+    anchor.prepend(pill)
+    console.log(TAG_MOUNT + ' page=thread url=' + location.href)
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', mount, { once: true })
+  } else {
+    mount()
+  }
+})()