pi-ele-picker 0.1.2 → 0.2.0

package/README.md

@@ -9,6 +9,8 @@ The picker lives entirely inside a Shadow DOM, so it never leaks styles into —
 ```
 browser page ──(same-origin /__pi_picker__/config)──▶ Vite plugin ──▶ reads ~/.pi/agent/pi-picker/*.json
      │                                                                        (discovers the live bridge)
+     ├──(GET http://127.0.0.1:<port>/status, every 3s)───────────────────────▶ pi bridge extension
+     │                                                                        (session status → launcher dot)
      └──(POST http://127.0.0.1:<port>/pick)────────────────────────────────▶ pi bridge extension
                                                                               │
                                                                        writes to the pi input box
@@ -72,6 +74,10 @@ piElePicker({
   // Directory whose pi bridge to discover; must match the cwd the pi session
   // was started in. Defaults to process.cwd().
   root: process.cwd(),
+  // Project-level default for the in-page session-status switch. Off by default:
+  // the status poll costs one loopback request every 3s, so users opt in from the
+  // picker panel unless you flip this on for them.
+  status: false,
 });
 ```
 
@@ -87,6 +93,7 @@ The launcher starts in the **bottom-right** corner and stays out of the way:
 
 - **Draggable** — grab it and drop it anywhere; the position is remembered per browser (`localStorage`).
 - **Fades when idle** (opacity `0.5`) and returns to full opacity on hover.
+- **Shows the live pi session status** as a coloured dot **when enabled** — green while pi is running, amber while follow-ups are queued, grey while awaiting input, red when the bridge is gone (see [Session status](#session-status)).
 - The panel always opens **next to the launcher**, flipping sides and clamping to stay on screen.
 
 1. Click **🎯 pi 选择器** and pick an element on the page.
@@ -95,11 +102,41 @@ The launcher starts in the **bottom-right** corner and stays out of the way:
    - **写入pi输入框** — pre-fills the current pi input box with the composed prompt; you edit and press Enter.
    - **直接发送** — submits the composed prompt as a real user turn immediately (queued as a follow-up if pi is mid-turn).
 
+### Session status
+
+Status polling is **opt-in and off by default**: each cycle opens a loopback request, so it is disabled unless you want it. There are two levels:
+
+- **Per browser (runtime):** the switch in the picker panel (labelled **状态**) turns polling on/off; the choice is remembered in `localStorage`.
+- **Per project (build time):** the `status` option above sets the default for anyone who has not chosen yet.
+
+Effective state = this browser's saved choice, else the project default. When it is off, the picker issues **no** status requests at all.
+
+When enabled, the launcher carries a small status dot and the panel repeats it as text (status · model · session id). The picker polls the bridge's `GET /status` every 3 seconds (pausing while the tab is hidden and re-discovering the bridge after a pi restart):
+
+| Dot | State | Meaning |
+| --- | --- | --- |
+| 🟢 pulsing | `running` | pi is streaming / executing a turn |
+| 🟡 | `queued` | pi is idle but follow-up messages are queued |
+| ⚪ | `idle` | pi is idle, waiting for your input |
+| 🔴 | `offline` | no live bridge for this project — pi is stopped / not running here |
+| ◯ hollow | — | status display is switched off |
+
+The same payload is available from the bridge directly:
+
+```jsonc
+// GET http://127.0.0.1:<bridge port>/status
+{ "ok": true, "status": "running", "idle": false, "pending": false,
+  "mode": "tui", "sessionId": "…", "model": "Claude Sonnet 4",
+  "provider": "anthropic", "pid": 12345, "cwd": "…", "updatedAt": 1700000000000 }
+```
+
+`/status` needs no token, but non-loopback browser origins get `403`, so an arbitrary website cannot probe session metadata.
+
 ## Notes
 
 - The Vite plugin only runs during `vite dev` (`apply: 'serve'`); it has no effect on builds.
 - Discovery is per-project: the bridge whose `cwd` matches `root` (and whose process is still alive) is selected, so several projects/sessions can run side by side without cross-talk.
-- If pi restarts while a page is open (new random port + token), the next send re-discovers the bridge and retries once automatically — no page refresh needed.
+- If pi restarts while a page is open (new random port + token), the next send re-discovers the bridge and retries once automatically — no page refresh needed. The status poll does the same: a stale port flips to `offline` for one cycle, then rediscovers.
 - The bridge never auto-submits on its own: **写入pi输入框** only fills the editor; **直接发送** is an explicit user action in the page.
 
 ## License

package/client/picker.js

@@ -46,6 +46,23 @@
     '.trigger:hover { background: #4338ca; }',
     '.trigger.dragging { cursor: grabbing; }',
     '.trigger.active { background: #059669; }',
+    '.dot { width: 8px; height: 8px; border-radius: 50%; flex: 0 0 auto; background: #6b7280; transition: background-color .2s ease; }',
+    '.dot.st-running { background: #34d399; animation: pipulse 1.4s ease-out infinite; }',
+    '.dot.st-queued { background: #fbbf24; }',
+    '.dot.st-idle { background: #9a9aa5; }',
+    '.dot.st-offline { background: #f87171; }',
+    '.dot.st-unknown { background: #6b7280; }',
+    '.dot.st-off { background: transparent; box-shadow: inset 0 0 0 1.5px #6b7280; }',
+    '@keyframes pipulse { 0% { box-shadow: 0 0 0 0 rgba(52,211,153,.6); } 70% { box-shadow: 0 0 0 6px rgba(52,211,153,0); } 100% { box-shadow: 0 0 0 0 rgba(52,211,153,0); } }',
+    '.session { display: flex; align-items: center; gap: 6px; padding: 8px 12px 0; color: #b9b9c2; font-size: 11px; }',
+    '.session .st { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }',
+    '.sw { display: inline-flex; align-items: center; gap: 5px; flex: 0 0 auto; cursor: pointer; color: #9a9aa5; }',
+    '.sw input { appearance: none; -webkit-appearance: none; width: 28px; height: 16px; margin: 0; border-radius: 999px; background: #34353d; position: relative; cursor: pointer; transition: background-color .15s ease; }',
+    '.sw input::after { content: ""; position: absolute; top: 2px; left: 2px; width: 12px; height: 12px; border-radius: 50%; background: #cfcfd6; transition: transform .15s ease; }',
+    '.sw input:checked { background: #4f46e5; }',
+    '.sw input:checked::after { transform: translateX(12px); background: #fff; }',
+    '.sw input:focus-visible { outline: 2px solid #4f46e5; outline-offset: 2px; }',
+    '.sw .sw-label { font-size: 11px; }',
     '.panel { position: fixed; width: 380px; max-width: calc(100vw - 36px); z-index: 2147483647; pointer-events: auto; background: #1b1c22; color: #e7e7ea; border: 1px solid #34353d; border-radius: 12px; box-shadow: 0 18px 48px rgba(0,0,0,.5); font-size: 13px; display: none; }',
     '.panel.open { display: block; }',
     '.hd { display: flex; align-items: center; gap: 8px; padding: 10px 12px; border-bottom: 1px solid #2b2c33; }',
@@ -96,7 +113,10 @@
   var trigger = document.createElement('button');
   trigger.className = 'trigger';
   trigger.type = 'button';
-  trigger.textContent = '🎯 pi 选择器';
+  var triggerDot = document.createElement('span');
+  triggerDot.className = 'dot st-off';
+  trigger.appendChild(triggerDot);
+  trigger.appendChild(document.createTextNode('pi picker'));
   trigger.title = '拖拽可移动 · 点击开始选择元素';
   root.appendChild(trigger);
 
@@ -104,6 +124,7 @@
   panel.className = 'panel';
   panel.innerHTML =
     '<div class="hd"><div class="title">元素修改</div><button class="close" type="button" title="关闭">✕</button></div>' +
+    '<div class="session"><span class="dot st-off"></span><span class="st">状态显示已关闭</span><label class="sw" title="每 3 秒同步一次 pi 会话状态；关闭后不再发起任何轮询请求"><input type="checkbox" class="status-toggle" /><span class="sw-label">状态</span></label></div>' +
     '<div class="meta"></div>' +
     '<textarea placeholder="描述你想要的修改，例如：把这个按钮改成圆角主色、增加 hover 效果…（可直接粘贴截图）"></textarea>' +
     '<div class="shots"></div>' +
@@ -113,6 +134,9 @@
   root.appendChild(panel);
 
   var metaEl = panel.querySelector('.meta');
+  var sessionDot = panel.querySelector('.session .dot');
+  var sessionText = panel.querySelector('.session .st');
+  var statusToggle = panel.querySelector('.status-toggle');
   var taEl = panel.querySelector('textarea');
   var shotsEl = panel.querySelector('.shots');
   var statusEl = panel.querySelector('.status');
@@ -638,5 +662,134 @@
     readFiles(e.dataTransfer && e.dataTransfer.files);
   });
 
-  loadConfig();
+  // --- live session status (opt-in) ----------------------------------------
+  // Polling is OFF by default because each cycle opens a loopback connection.
+  // Users opt in per browser with the panel switch, or a project flips the
+  // default with the Vite option (`piElePicker({ status: true })`). While enabled
+  // the launcher dot + panel line show whether pi is running, waiting for input,
+  // holding queued follow-ups, or gone. Polling pauses on a hidden tab and drops
+  // a stale port so the next cycle re-discovers a restarted bridge.
+  var STATUS_INTERVAL = 3000;
+  var STATUS_KEY = 'pi-ele-picker:status:v1';
+  var statusTimer = null;
+  var statusTitle = '';
+  var statusEnabled = false;
+  var STATUS_LABEL = {
+    running: 'pi 执行中',
+    queued: 'pi 排队中',
+    idle: 'pi 等待输入',
+    offline: 'pi 已停止 / 未连接',
+    unknown: 'pi 状态检测中…',
+    off: '状态显示已关闭',
+  };
+
+  function renderStatus(info) {
+    var st = info && info.status;
+    if (!STATUS_LABEL[st]) st = 'unknown';
+    var cls = 'dot st-' + st;
+    triggerDot.className = cls;
+    sessionDot.className = cls;
+    var detail = [];
+    if (info && info.model) detail.push(info.model);
+    if (info && info.sessionId) detail.push('会话 ' + String(info.sessionId).slice(0, 8));
+    var line = STATUS_LABEL[st] + (detail.length ? ' · ' + detail.join(' · ') : '');
+    sessionText.textContent = line;
+    var title = line + ' · 拖拽可移动 · 点击开始选择元素';
+    if (title !== statusTitle) {
+      trigger.title = title;
+      statusTitle = title;
+    }
+  }
+
+  function readStatusOverride() {
+    try {
+      var v = localStorage.getItem(STATUS_KEY);
+      if (v === 'on') return true;
+      if (v === 'off') return false;
+    } catch (e) {
+      /* storage unavailable — fall back to the project default */
+    }
+    return null;
+  }
+
+  function writeStatusOverride(enabled) {
+    try {
+      localStorage.setItem(STATUS_KEY, enabled ? 'on' : 'off');
+    } catch (e) {
+      /* ignore */
+    }
+  }
+
+  function stopStatusPoll() {
+    if (statusTimer) {
+      clearTimeout(statusTimer);
+      statusTimer = null;
+    }
+  }
+
+  /** Turn polling on/off; `persist` records the choice as this browser's override. */
+  function setStatusEnabled(enabled, persist) {
+    statusEnabled = !!enabled;
+    if (persist) writeStatusOverride(statusEnabled);
+    if (statusToggle) statusToggle.checked = statusEnabled;
+    if (statusEnabled) {
+      renderStatus({ status: 'unknown' });
+      pollStatus();
+    } else {
+      stopStatusPoll();
+      renderStatus({ status: 'off' });
+    }
+  }
+
+  /** Never rejects: any failure becomes the offline state. */
+  function fetchStatus() {
+    return loadConfig(false).then(function (c) {
+      if (!c || !c.port) return { status: 'offline' };
+      return fetch('http://127.0.0.1:' + c.port + '/status', { cache: 'no-store' })
+        .then(function (r) {
+          if (!r.ok) throw new Error('HTTP ' + r.status);
+          return r.json();
+        })
+        .catch(function () {
+          // The cached port may be stale after a pi restart: clear it so the next
+          // poll re-reads the config and finds the new bridge.
+          cfg = { port: null, token: null };
+          return { status: 'offline' };
+        });
+    });
+  }
+
+  function scheduleStatusPoll() {
+    if (statusTimer) clearTimeout(statusTimer);
+    statusTimer = setTimeout(pollStatus, STATUS_INTERVAL);
+  }
+
+  function pollStatus() {
+    if (!statusEnabled) return;
+    if (document.hidden) {
+      scheduleStatusPoll();
+      return;
+    }
+    fetchStatus()
+      .then(renderStatus)
+      .catch(function () {
+        renderStatus({ status: 'offline' });
+      })
+      .then(scheduleStatusPoll);
+  }
+
+  document.addEventListener('visibilitychange', function () {
+    if (!document.hidden && statusEnabled) pollStatus();
+  });
+
+  statusToggle.addEventListener('change', function () {
+    setStatusEnabled(statusToggle.checked, true);
+  });
+
+  // Resolve the project default first (statusDefault from the Vite plugin), then
+  // apply this browser's override if the user has one.
+  loadConfig().then(function () {
+    var override = readStatusOverride();
+    setStatusEnabled(override !== null ? override : cfg && cfg.statusDefault === true, false);
+  });
 })();

package/dist/index.cjs

@@ -35,7 +35,16 @@ var import_node_os = require("os");
 var import_node_url = require("url");
 var REG_DIR = (0, import_node_path.join)((0, import_node_os.homedir)(), ".pi", "agent", "pi-picker");
 var ENDPOINT = "/__pi_picker__";
-var CLIENT_FILE = (0, import_node_url.fileURLToPath)(new URL("../client/picker.js", importMetaUrl));
+var OWN_CLIENT_FILE = (0, import_node_url.fileURLToPath)(new URL("../client/picker.js", importMetaUrl));
+function resolveClientFile(projectRoot) {
+  for (let dir = projectRoot; dir; ) {
+    const candidate = (0, import_node_path.join)(dir, "node_modules", "pi-ele-picker", "client", "picker.js");
+    if ((0, import_node_fs.existsSync)(candidate)) return candidate;
+    const parent = (0, import_node_path.dirname)(dir);
+    dir = parent === dir ? "" : parent;
+  }
+  return (0, import_node_fs.existsSync)(OWN_CLIENT_FILE) ? OWN_CLIENT_FILE : null;
+}
 function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -65,6 +74,7 @@ function discoverBridge(root) {
 }
 function piElePicker(options = {}) {
   const root = options.root ?? process.cwd();
+  const statusDefault = options.status ?? false;
   return {
     name: "pi-ele-picker",
     apply: "serve",
@@ -84,18 +94,25 @@ function piElePicker(options = {}) {
           const info = discoverBridge(root);
           res.setHeader("content-type", "application/json");
           res.setHeader("cache-control", "no-store");
-          res.end(JSON.stringify(info ? { port: info.port, token: info.token } : { port: null }));
+          res.end(
+            JSON.stringify({
+              port: info ? info.port : null,
+              token: info ? info.token : null,
+              statusDefault
+            })
+          );
           return;
         }
         if (url === "/picker.js") {
-          if (!(0, import_node_fs.existsSync)(CLIENT_FILE)) {
+          const clientFile = resolveClientFile(server.config.root);
+          if (!clientFile) {
             res.statusCode = 404;
             res.end("pi-ele-picker client missing");
             return;
           }
           res.setHeader("content-type", "text/javascript");
           res.setHeader("cache-control", "no-store");
-          res.end((0, import_node_fs.readFileSync)(CLIENT_FILE));
+          res.end((0, import_node_fs.readFileSync)(clientFile));
           return;
         }
         next();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js"],"sourcesContent":["import type { Plugin } from 'vite';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * pi-ele-picker\n *\n * A Vite dev-only plugin that injects the pi element picker into the page and\n * exposes a same-origin endpoint the picker uses to discover the running pi\n * bridge.\n *\n * The bridge registry is written by the pi extension at\n * `~/.pi/agent/extensions/pi-picker.ts` (or any extension implementing the same\n * `~/.pi/agent/pi-picker/<pid>.json` registry + `POST /pick` protocol).\n */\n\n/** Directory where pi bridge extensions register themselves. */\nconst REG_DIR = join(homedir(), '.pi', 'agent', 'pi-picker');\n\n/** URL prefix under which the picker client and discovery endpoint are served. */\nconst ENDPOINT = '/__pi_picker__';\n\n/** Absolute path to the browser client that ships with this package. */\nconst CLIENT_FILE = fileURLToPath(new URL('../client/picker.js', import.meta.url));\n\nexport interface PiElePickerOptions {\n  /**\n   * Directory whose pi bridge to discover. Must match the `cwd` the pi session\n   * was started in. Defaults to `process.cwd()`.\n   */\n  root?: string;\n}\n\ninterface BridgeInfo {\n  port: number;\n  pid: number;\n  cwd: string;\n  token: string;\n  updatedAt: number;\n}\n\nfunction isPidAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Find the freshest live bridge registered for the given project root. */\nfunction discoverBridge(root: string): BridgeInfo | null {\n  let files: string[];\n  try {\n    files = readdirSync(REG_DIR).filter((f) => f.endsWith('.json'));\n  } catch {\n    return null;\n  }\n  let best: BridgeInfo | null = null;\n  for (const f of files) {\n    try {\n      const info = JSON.parse(readFileSync(join(REG_DIR, f), 'utf8')) as BridgeInfo;\n      if (info.cwd !== root) continue;\n      if (!isPidAlive(info.pid)) continue;\n      if (!best || info.updatedAt > best.updatedAt) best = info;\n    } catch {\n      /* skip malformed */\n    }\n  }\n  return best;\n}\n\nexport default function piElePicker(options: PiElePickerOptions = {}): Plugin {\n  const root = options.root ?? process.cwd();\n\n  return {\n    name: 'pi-ele-picker',\n    apply: 'serve',\n    transformIndexHtml() {\n      return [\n        {\n          tag: 'script',\n          attrs: { type: 'module', src: `${ENDPOINT}/picker.js` },\n          injectTo: 'body',\n        },\n      ];\n    },\n    configureServer(server) {\n      server.middlewares.use(ENDPOINT, (req, res, next) => {\n        const url = (req.url ?? '').split('?')[0];\n\n        if (url === '/config') {\n          const info = discoverBridge(root);\n          res.setHeader('content-type', 'application/json');\n          res.setHeader('cache-control', 'no-store');\n          res.end(JSON.stringify(info ? { port: info.port, token: info.token } : { port: null }));\n          return;\n        }\n\n        if (url === '/picker.js') {\n          if (!existsSync(CLIENT_FILE)) {\n            res.statusCode = 404;\n            res.end('pi-ele-picker client missing');\n            return;\n          }\n          res.setHeader('content-type', 'text/javascript');\n          res.setHeader('cache-control', 'no-store');\n          res.end(readFileSync(CLIENT_FILE));\n          return;\n        }\n\n        next();\n      });\n    },\n  };\n}\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,IAAM,mBAAmB,MACvB,OAAO,aAAa,cAChB,IAAI,IAAI,QAAQ,UAAU,EAAE,EAAE,OAC7B,SAAS,iBAAiB,SAAS,cAAc,QAAQ,YAAY,MAAM,WAC1E,SAAS,cAAc,MACvB,IAAI,IAAI,WAAW,SAAS,OAAO,EAAE;AAEtC,IAAM,gBAAgC,iCAAiB;;;ADX9D,qBAAsD;AACtD,uBAAqB;AACrB,qBAAwB;AACxB,sBAA8B;AAe9B,IAAM,cAAU,2BAAK,wBAAQ,GAAG,OAAO,SAAS,WAAW;AAG3D,IAAM,WAAW;AAGjB,IAAM,kBAAc,+BAAc,IAAI,IAAI,uBAAuB,aAAe,CAAC;AAkBjF,SAAS,WAAW,KAAsB;AACxC,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAe,MAAiC;AACvD,MAAI;AACJ,MAAI;AACF,gBAAQ,4BAAY,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,CAAC;AAAA,EAChE,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,OAA0B;AAC9B,aAAW,KAAK,OAAO;AACrB,QAAI;AACF,YAAM,OAAO,KAAK,UAAM,iCAAa,uBAAK,SAAS,CAAC,GAAG,MAAM,CAAC;AAC9D,UAAI,KAAK,QAAQ,KAAM;AACvB,UAAI,CAAC,WAAW,KAAK,GAAG,EAAG;AAC3B,UAAI,CAAC,QAAQ,KAAK,YAAY,KAAK,UAAW,QAAO;AAAA,IACvD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEe,SAAR,YAA6B,UAA8B,CAAC,GAAW;AAC5E,QAAM,OAAO,QAAQ,QAAQ,QAAQ,IAAI;AAEzC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,qBAAqB;AACnB,aAAO;AAAA,QACL;AAAA,UACE,KAAK;AAAA,UACL,OAAO,EAAE,MAAM,UAAU,KAAK,GAAG,QAAQ,aAAa;AAAA,UACtD,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,IACA,gBAAgB,QAAQ;AACtB,aAAO,YAAY,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;AACnD,cAAM,OAAO,IAAI,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;AAExC,YAAI,QAAQ,WAAW;AACrB,gBAAM,OAAO,eAAe,IAAI;AAChC,cAAI,UAAU,gBAAgB,kBAAkB;AAChD,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI,IAAI,KAAK,UAAU,OAAO,EAAE,MAAM,KAAK,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;AACtF;AAAA,QACF;AAEA,YAAI,QAAQ,cAAc;AACxB,cAAI,KAAC,2BAAW,WAAW,GAAG;AAC5B,gBAAI,aAAa;AACjB,gBAAI,IAAI,8BAA8B;AACtC;AAAA,UACF;AACA,cAAI,UAAU,gBAAgB,iBAAiB;AAC/C,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI,QAAI,6BAAa,WAAW,CAAC;AACjC;AAAA,QACF;AAEA,aAAK;AAAA,MACP,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js"],"sourcesContent":["import type { Plugin } from 'vite';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * pi-ele-picker\n *\n * A Vite dev-only plugin that injects the pi element picker into the page and\n * exposes a same-origin endpoint the picker uses to discover the running pi\n * bridge.\n *\n * The bridge registry is written by the pi extension at\n * `~/.pi/agent/extensions/pi-picker.ts` (or any extension implementing the same\n * `~/.pi/agent/pi-picker/<pid>.json` registry + `POST /pick` protocol).\n */\n\n/** Directory where pi bridge extensions register themselves. */\nconst REG_DIR = join(homedir(), '.pi', 'agent', 'pi-picker');\n\n/** URL prefix under which the picker client and discovery endpoint are served. */\nconst ENDPOINT = '/__pi_picker__';\n\n/** Path to this package's own browser client, anchored at the plugin's install location. */\nconst OWN_CLIENT_FILE = fileURLToPath(new URL('../client/picker.js', import.meta.url));\n\n/**\n * Resolve the browser client to serve. Called per request, never cached.\n *\n * The plugin module is evaluated once when the dev server boots, so anything\n * captured at module scope is frozen for the life of that process. Upgrading\n * pi-ele-picker while a dev server is running therefore used to keep serving the\n * old client forever: the frozen path still pointed at\n * `node_modules/.pnpm/pi-ele-picker@<old>/...`, pnpm leaves that directory on\n * disk, and the stale client was handed out silently — refreshing never helped.\n *\n * Resolving from the project root instead means the currently installed copy\n * wins, with no server restart.\n *\n * Two traps this deliberately avoids:\n *\n * 1. Anchoring at `import.meta.url`. From inside `.../pi-ele-picker@<old>/dist/`\n *    Node resolves `pi-ele-picker` straight back to that same old copy.\n * 2. `require.resolve()`. Node memoises resolutions in `Module._pathCache` and\n *    never invalidates them when `node_modules` changes underneath a running\n *    process, which pins the first lookup forever — the same staleness, moved.\n *\n * So the lookup is a plain filesystem walk, mirroring Node's own node_modules\n * search (upward from the project root, for workspace/monorepo layouts), and it\n * falls back to this package's own copy when nothing matches.\n */\nfunction resolveClientFile(projectRoot: string): string | null {\n  for (let dir = projectRoot; dir; ) {\n    const candidate = join(dir, 'node_modules', 'pi-ele-picker', 'client', 'picker.js');\n    if (existsSync(candidate)) return candidate;\n    const parent = dirname(dir);\n    dir = parent === dir ? '' : parent; // stop at the filesystem root\n  }\n  return existsSync(OWN_CLIENT_FILE) ? OWN_CLIENT_FILE : null;\n}\n\nexport interface PiElePickerOptions {\n  /**\n   * Directory whose pi bridge to discover. Must match the `cwd` the pi session\n   * was started in. Defaults to `process.cwd()`.\n   */\n  root?: string;\n  /**\n   * Project-level default for the in-page \"session status\" toggle. The picker\n   * polls the bridge every 3s to show whether pi is running/idle/stopped, which\n   * costs a loopback request per cycle; it is therefore **off by default**.\n   *\n   * This is only a default: each browser can override it with the switch in the\n   * picker panel (remembered in `localStorage`). Defaults to `false`.\n   */\n  status?: boolean;\n}\n\ninterface BridgeInfo {\n  port: number;\n  pid: number;\n  cwd: string;\n  token: string;\n  updatedAt: number;\n}\n\nfunction isPidAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Find the freshest live bridge registered for the given project root. */\nfunction discoverBridge(root: string): BridgeInfo | null {\n  let files: string[];\n  try {\n    files = readdirSync(REG_DIR).filter((f) => f.endsWith('.json'));\n  } catch {\n    return null;\n  }\n  let best: BridgeInfo | null = null;\n  for (const f of files) {\n    try {\n      const info = JSON.parse(readFileSync(join(REG_DIR, f), 'utf8')) as BridgeInfo;\n      if (info.cwd !== root) continue;\n      if (!isPidAlive(info.pid)) continue;\n      if (!best || info.updatedAt > best.updatedAt) best = info;\n    } catch {\n      /* skip malformed */\n    }\n  }\n  return best;\n}\n\nexport default function piElePicker(options: PiElePickerOptions = {}): Plugin {\n  const root = options.root ?? process.cwd();\n  const statusDefault = options.status ?? false;\n\n  return {\n    name: 'pi-ele-picker',\n    apply: 'serve',\n    transformIndexHtml() {\n      return [\n        {\n          tag: 'script',\n          attrs: { type: 'module', src: `${ENDPOINT}/picker.js` },\n          injectTo: 'body',\n        },\n      ];\n    },\n    configureServer(server) {\n      server.middlewares.use(ENDPOINT, (req, res, next) => {\n        const url = (req.url ?? '').split('?')[0];\n\n        if (url === '/config') {\n          const info = discoverBridge(root);\n          res.setHeader('content-type', 'application/json');\n          res.setHeader('cache-control', 'no-store');\n          res.end(\n            JSON.stringify({\n              port: info ? info.port : null,\n              token: info ? info.token : null,\n              statusDefault,\n            })\n          );\n          return;\n        }\n\n        if (url === '/picker.js') {\n          const clientFile = resolveClientFile(server.config.root);\n          if (!clientFile) {\n            res.statusCode = 404;\n            res.end('pi-ele-picker client missing');\n            return;\n          }\n          res.setHeader('content-type', 'text/javascript');\n          res.setHeader('cache-control', 'no-store');\n          res.end(readFileSync(clientFile));\n          return;\n        }\n\n        next();\n      });\n    },\n  };\n}\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -6,6 +6,15 @@ interface PiElePickerOptions {
      * was started in. Defaults to `process.cwd()`.
      */
     root?: string;
+    /**
+     * Project-level default for the in-page "session status" toggle. The picker
+     * polls the bridge every 3s to show whether pi is running/idle/stopped, which
+     * costs a loopback request per cycle; it is therefore **off by default**.
+     *
+     * This is only a default: each browser can override it with the switch in the
+     * picker panel (remembered in `localStorage`). Defaults to `false`.
+     */
+    status?: boolean;
 }
 declare function piElePicker(options?: PiElePickerOptions): Plugin;
 

package/dist/index.d.ts

@@ -6,6 +6,15 @@ interface PiElePickerOptions {
      * was started in. Defaults to `process.cwd()`.
      */
     root?: string;
+    /**
+     * Project-level default for the in-page "session status" toggle. The picker
+     * polls the bridge every 3s to show whether pi is running/idle/stopped, which
+     * costs a loopback request per cycle; it is therefore **off by default**.
+     *
+     * This is only a default: each browser can override it with the switch in the
+     * picker panel (remembered in `localStorage`). Defaults to `false`.
+     */
+    status?: boolean;
 }
 declare function piElePicker(options?: PiElePickerOptions): Plugin;
 

package/dist/index.js

@@ -1,11 +1,20 @@
 // src/index.ts
 import { existsSync, readFileSync, readdirSync } from "fs";
-import { join } from "path";
+import { dirname, join } from "path";
 import { homedir } from "os";
 import { fileURLToPath } from "url";
 var REG_DIR = join(homedir(), ".pi", "agent", "pi-picker");
 var ENDPOINT = "/__pi_picker__";
-var CLIENT_FILE = fileURLToPath(new URL("../client/picker.js", import.meta.url));
+var OWN_CLIENT_FILE = fileURLToPath(new URL("../client/picker.js", import.meta.url));
+function resolveClientFile(projectRoot) {
+  for (let dir = projectRoot; dir; ) {
+    const candidate = join(dir, "node_modules", "pi-ele-picker", "client", "picker.js");
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    dir = parent === dir ? "" : parent;
+  }
+  return existsSync(OWN_CLIENT_FILE) ? OWN_CLIENT_FILE : null;
+}
 function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -35,6 +44,7 @@ function discoverBridge(root) {
 }
 function piElePicker(options = {}) {
   const root = options.root ?? process.cwd();
+  const statusDefault = options.status ?? false;
   return {
     name: "pi-ele-picker",
     apply: "serve",
@@ -54,18 +64,25 @@ function piElePicker(options = {}) {
           const info = discoverBridge(root);
           res.setHeader("content-type", "application/json");
           res.setHeader("cache-control", "no-store");
-          res.end(JSON.stringify(info ? { port: info.port, token: info.token } : { port: null }));
+          res.end(
+            JSON.stringify({
+              port: info ? info.port : null,
+              token: info ? info.token : null,
+              statusDefault
+            })
+          );
           return;
         }
         if (url === "/picker.js") {
-          if (!existsSync(CLIENT_FILE)) {
+          const clientFile = resolveClientFile(server.config.root);
+          if (!clientFile) {
             res.statusCode = 404;
             res.end("pi-ele-picker client missing");
             return;
           }
           res.setHeader("content-type", "text/javascript");
           res.setHeader("cache-control", "no-store");
-          res.end(readFileSync(CLIENT_FILE));
+          res.end(readFileSync(clientFile));
           return;
         }
         next();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Plugin } from 'vite';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * pi-ele-picker\n *\n * A Vite dev-only plugin that injects the pi element picker into the page and\n * exposes a same-origin endpoint the picker uses to discover the running pi\n * bridge.\n *\n * The bridge registry is written by the pi extension at\n * `~/.pi/agent/extensions/pi-picker.ts` (or any extension implementing the same\n * `~/.pi/agent/pi-picker/<pid>.json` registry + `POST /pick` protocol).\n */\n\n/** Directory where pi bridge extensions register themselves. */\nconst REG_DIR = join(homedir(), '.pi', 'agent', 'pi-picker');\n\n/** URL prefix under which the picker client and discovery endpoint are served. */\nconst ENDPOINT = '/__pi_picker__';\n\n/** Absolute path to the browser client that ships with this package. */\nconst CLIENT_FILE = fileURLToPath(new URL('../client/picker.js', import.meta.url));\n\nexport interface PiElePickerOptions {\n  /**\n   * Directory whose pi bridge to discover. Must match the `cwd` the pi session\n   * was started in. Defaults to `process.cwd()`.\n   */\n  root?: string;\n}\n\ninterface BridgeInfo {\n  port: number;\n  pid: number;\n  cwd: string;\n  token: string;\n  updatedAt: number;\n}\n\nfunction isPidAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Find the freshest live bridge registered for the given project root. */\nfunction discoverBridge(root: string): BridgeInfo | null {\n  let files: string[];\n  try {\n    files = readdirSync(REG_DIR).filter((f) => f.endsWith('.json'));\n  } catch {\n    return null;\n  }\n  let best: BridgeInfo | null = null;\n  for (const f of files) {\n    try {\n      const info = JSON.parse(readFileSync(join(REG_DIR, f), 'utf8')) as BridgeInfo;\n      if (info.cwd !== root) continue;\n      if (!isPidAlive(info.pid)) continue;\n      if (!best || info.updatedAt > best.updatedAt) best = info;\n    } catch {\n      /* skip malformed */\n    }\n  }\n  return best;\n}\n\nexport default function piElePicker(options: PiElePickerOptions = {}): Plugin {\n  const root = options.root ?? process.cwd();\n\n  return {\n    name: 'pi-ele-picker',\n    apply: 'serve',\n    transformIndexHtml() {\n      return [\n        {\n          tag: 'script',\n          attrs: { type: 'module', src: `${ENDPOINT}/picker.js` },\n          injectTo: 'body',\n        },\n      ];\n    },\n    configureServer(server) {\n      server.middlewares.use(ENDPOINT, (req, res, next) => {\n        const url = (req.url ?? '').split('?')[0];\n\n        if (url === '/config') {\n          const info = discoverBridge(root);\n          res.setHeader('content-type', 'application/json');\n          res.setHeader('cache-control', 'no-store');\n          res.end(JSON.stringify(info ? { port: info.port, token: info.token } : { port: null }));\n          return;\n        }\n\n        if (url === '/picker.js') {\n          if (!existsSync(CLIENT_FILE)) {\n            res.statusCode = 404;\n            res.end('pi-ele-picker client missing');\n            return;\n          }\n          res.setHeader('content-type', 'text/javascript');\n          res.setHeader('cache-control', 'no-store');\n          res.end(readFileSync(CLIENT_FILE));\n          return;\n        }\n\n        next();\n      });\n    },\n  };\n}\n"],"mappings":";AACA,SAAS,YAAY,cAAc,mBAAmB;AACtD,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAe9B,IAAM,UAAU,KAAK,QAAQ,GAAG,OAAO,SAAS,WAAW;AAG3D,IAAM,WAAW;AAGjB,IAAM,cAAc,cAAc,IAAI,IAAI,uBAAuB,YAAY,GAAG,CAAC;AAkBjF,SAAS,WAAW,KAAsB;AACxC,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAe,MAAiC;AACvD,MAAI;AACJ,MAAI;AACF,YAAQ,YAAY,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,CAAC;AAAA,EAChE,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,OAA0B;AAC9B,aAAW,KAAK,OAAO;AACrB,QAAI;AACF,YAAM,OAAO,KAAK,MAAM,aAAa,KAAK,SAAS,CAAC,GAAG,MAAM,CAAC;AAC9D,UAAI,KAAK,QAAQ,KAAM;AACvB,UAAI,CAAC,WAAW,KAAK,GAAG,EAAG;AAC3B,UAAI,CAAC,QAAQ,KAAK,YAAY,KAAK,UAAW,QAAO;AAAA,IACvD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEe,SAAR,YAA6B,UAA8B,CAAC,GAAW;AAC5E,QAAM,OAAO,QAAQ,QAAQ,QAAQ,IAAI;AAEzC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,qBAAqB;AACnB,aAAO;AAAA,QACL;AAAA,UACE,KAAK;AAAA,UACL,OAAO,EAAE,MAAM,UAAU,KAAK,GAAG,QAAQ,aAAa;AAAA,UACtD,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,IACA,gBAAgB,QAAQ;AACtB,aAAO,YAAY,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;AACnD,cAAM,OAAO,IAAI,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;AAExC,YAAI,QAAQ,WAAW;AACrB,gBAAM,OAAO,eAAe,IAAI;AAChC,cAAI,UAAU,gBAAgB,kBAAkB;AAChD,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI,IAAI,KAAK,UAAU,OAAO,EAAE,MAAM,KAAK,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;AACtF;AAAA,QACF;AAEA,YAAI,QAAQ,cAAc;AACxB,cAAI,CAAC,WAAW,WAAW,GAAG;AAC5B,gBAAI,aAAa;AACjB,gBAAI,IAAI,8BAA8B;AACtC;AAAA,UACF;AACA,cAAI,UAAU,gBAAgB,iBAAiB;AAC/C,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI,IAAI,aAAa,WAAW,CAAC;AACjC;AAAA,QACF;AAEA,aAAK;AAAA,MACP,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Plugin } from 'vite';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * pi-ele-picker\n *\n * A Vite dev-only plugin that injects the pi element picker into the page and\n * exposes a same-origin endpoint the picker uses to discover the running pi\n * bridge.\n *\n * The bridge registry is written by the pi extension at\n * `~/.pi/agent/extensions/pi-picker.ts` (or any extension implementing the same\n * `~/.pi/agent/pi-picker/<pid>.json` registry + `POST /pick` protocol).\n */\n\n/** Directory where pi bridge extensions register themselves. */\nconst REG_DIR = join(homedir(), '.pi', 'agent', 'pi-picker');\n\n/** URL prefix under which the picker client and discovery endpoint are served. */\nconst ENDPOINT = '/__pi_picker__';\n\n/** Path to this package's own browser client, anchored at the plugin's install location. */\nconst OWN_CLIENT_FILE = fileURLToPath(new URL('../client/picker.js', import.meta.url));\n\n/**\n * Resolve the browser client to serve. Called per request, never cached.\n *\n * The plugin module is evaluated once when the dev server boots, so anything\n * captured at module scope is frozen for the life of that process. Upgrading\n * pi-ele-picker while a dev server is running therefore used to keep serving the\n * old client forever: the frozen path still pointed at\n * `node_modules/.pnpm/pi-ele-picker@<old>/...`, pnpm leaves that directory on\n * disk, and the stale client was handed out silently — refreshing never helped.\n *\n * Resolving from the project root instead means the currently installed copy\n * wins, with no server restart.\n *\n * Two traps this deliberately avoids:\n *\n * 1. Anchoring at `import.meta.url`. From inside `.../pi-ele-picker@<old>/dist/`\n *    Node resolves `pi-ele-picker` straight back to that same old copy.\n * 2. `require.resolve()`. Node memoises resolutions in `Module._pathCache` and\n *    never invalidates them when `node_modules` changes underneath a running\n *    process, which pins the first lookup forever — the same staleness, moved.\n *\n * So the lookup is a plain filesystem walk, mirroring Node's own node_modules\n * search (upward from the project root, for workspace/monorepo layouts), and it\n * falls back to this package's own copy when nothing matches.\n */\nfunction resolveClientFile(projectRoot: string): string | null {\n  for (let dir = projectRoot; dir; ) {\n    const candidate = join(dir, 'node_modules', 'pi-ele-picker', 'client', 'picker.js');\n    if (existsSync(candidate)) return candidate;\n    const parent = dirname(dir);\n    dir = parent === dir ? '' : parent; // stop at the filesystem root\n  }\n  return existsSync(OWN_CLIENT_FILE) ? OWN_CLIENT_FILE : null;\n}\n\nexport interface PiElePickerOptions {\n  /**\n   * Directory whose pi bridge to discover. Must match the `cwd` the pi session\n   * was started in. Defaults to `process.cwd()`.\n   */\n  root?: string;\n  /**\n   * Project-level default for the in-page \"session status\" toggle. The picker\n   * polls the bridge every 3s to show whether pi is running/idle/stopped, which\n   * costs a loopback request per cycle; it is therefore **off by default**.\n   *\n   * This is only a default: each browser can override it with the switch in the\n   * picker panel (remembered in `localStorage`). Defaults to `false`.\n   */\n  status?: boolean;\n}\n\ninterface BridgeInfo {\n  port: number;\n  pid: number;\n  cwd: string;\n  token: string;\n  updatedAt: number;\n}\n\nfunction isPidAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Find the freshest live bridge registered for the given project root. */\nfunction discoverBridge(root: string): BridgeInfo | null {\n  let files: string[];\n  try {\n    files = readdirSync(REG_DIR).filter((f) => f.endsWith('.json'));\n  } catch {\n    return null;\n  }\n  let best: BridgeInfo | null = null;\n  for (const f of files) {\n    try {\n      const info = JSON.parse(readFileSync(join(REG_DIR, f), 'utf8')) as BridgeInfo;\n      if (info.cwd !== root) continue;\n      if (!isPidAlive(info.pid)) continue;\n      if (!best || info.updatedAt > best.updatedAt) best = info;\n    } catch {\n      /* skip malformed */\n    }\n  }\n  return best;\n}\n\nexport default function piElePicker(options: PiElePickerOptions = {}): Plugin {\n  const root = options.root ?? process.cwd();\n  const statusDefault = options.status ?? false;\n\n  return {\n    name: 'pi-ele-picker',\n    apply: 'serve',\n    transformIndexHtml() {\n      return [\n        {\n          tag: 'script',\n          attrs: { type: 'module', src: `${ENDPOINT}/picker.js` },\n          injectTo: 'body',\n        },\n      ];\n    },\n    configureServer(server) {\n      server.middlewares.use(ENDPOINT, (req, res, next) => {\n        const url = (req.url ?? '').split('?')[0];\n\n        if (url === '/config') {\n          const info = discoverBridge(root);\n          res.setHeader('content-type', 'application/json');\n          res.setHeader('cache-control', 'no-store');\n          res.end(\n            JSON.stringify({\n              port: info ? info.port : null,\n              token: info ? info.token : null,\n              statusDefault,\n            })\n          );\n          return;\n        }\n\n        if (url === '/picker.js') {\n          const clientFile = resolveClientFile(server.config.root);\n          if (!clientFile) {\n            res.statusCode = 404;\n            res.end('pi-ele-picker client missing');\n            return;\n          }\n          res.setHeader('content-type', 'text/javascript');\n          res.setHeader('cache-control', 'no-store');\n          res.end(readFileSync(clientFile));\n          return;\n        }\n\n        next();\n      });\n    },\n  };\n}\n"],"mappings":";AACA,SAAS,YAAY,cAAc,mBAAmB;AACtD,SAAS,SAAS,YAAY;AAC9B,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAe9B,IAAM,UAAU,KAAK,QAAQ,GAAG,OAAO,SAAS,WAAW;AAG3D,IAAM,WAAW;AAGjB,IAAM,kBAAkB,cAAc,IAAI,IAAI,uBAAuB,YAAY,GAAG,CAAC;AA2BrF,SAAS,kBAAkB,aAAoC;AAC7D,WAAS,MAAM,aAAa,OAAO;AACjC,UAAM,YAAY,KAAK,KAAK,gBAAgB,iBAAiB,UAAU,WAAW;AAClF,QAAI,WAAW,SAAS,EAAG,QAAO;AAClC,UAAM,SAAS,QAAQ,GAAG;AAC1B,UAAM,WAAW,MAAM,KAAK;AAAA,EAC9B;AACA,SAAO,WAAW,eAAe,IAAI,kBAAkB;AACzD;AA2BA,SAAS,WAAW,KAAsB;AACxC,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAe,MAAiC;AACvD,MAAI;AACJ,MAAI;AACF,YAAQ,YAAY,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,CAAC;AAAA,EAChE,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,OAA0B;AAC9B,aAAW,KAAK,OAAO;AACrB,QAAI;AACF,YAAM,OAAO,KAAK,MAAM,aAAa,KAAK,SAAS,CAAC,GAAG,MAAM,CAAC;AAC9D,UAAI,KAAK,QAAQ,KAAM;AACvB,UAAI,CAAC,WAAW,KAAK,GAAG,EAAG;AAC3B,UAAI,CAAC,QAAQ,KAAK,YAAY,KAAK,UAAW,QAAO;AAAA,IACvD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEe,SAAR,YAA6B,UAA8B,CAAC,GAAW;AAC5E,QAAM,OAAO,QAAQ,QAAQ,QAAQ,IAAI;AACzC,QAAM,gBAAgB,QAAQ,UAAU;AAExC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,qBAAqB;AACnB,aAAO;AAAA,QACL;AAAA,UACE,KAAK;AAAA,UACL,OAAO,EAAE,MAAM,UAAU,KAAK,GAAG,QAAQ,aAAa;AAAA,UACtD,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,IACA,gBAAgB,QAAQ;AACtB,aAAO,YAAY,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;AACnD,cAAM,OAAO,IAAI,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;AAExC,YAAI,QAAQ,WAAW;AACrB,gBAAM,OAAO,eAAe,IAAI;AAChC,cAAI,UAAU,gBAAgB,kBAAkB;AAChD,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI;AAAA,YACF,KAAK,UAAU;AAAA,cACb,MAAM,OAAO,KAAK,OAAO;AAAA,cACzB,OAAO,OAAO,KAAK,QAAQ;AAAA,cAC3B;AAAA,YACF,CAAC;AAAA,UACH;AACA;AAAA,QACF;AAEA,YAAI,QAAQ,cAAc;AACxB,gBAAM,aAAa,kBAAkB,OAAO,OAAO,IAAI;AACvD,cAAI,CAAC,YAAY;AACf,gBAAI,aAAa;AACjB,gBAAI,IAAI,8BAA8B;AACtC;AAAA,UACF;AACA,cAAI,UAAU,gBAAgB,iBAAiB;AAC/C,cAAI,UAAU,iBAAiB,UAAU;AACzC,cAAI,IAAI,aAAa,UAAU,CAAC;AAChC;AAAA,QACF;AAEA,aAAK;AAAA,MACP,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/extensions/pi-picker.ts

@@ -17,6 +17,15 @@
  *   reply:   { ok: true, mode, inserted } | { ok: true, mode, submitted, queued? }
  *            | { ok: false, error }
  *
+ * Wire protocol (GET /status):
+ *   reply:   { ok: true, status: "running" | "queued" | "idle", idle, pending,
+ *              mode, sessionId, model, provider, pid, cwd, updatedAt }
+ *
+ * `/status` is polled by the browser picker to render a live session badge (the
+ * launcher dot + the panel status line). It has no token: any loopback-origin
+ * page may read it, but non-loopback browser origins are rejected so an arbitrary
+ * website cannot probe session metadata.
+ *
  * Two delivery modes:
  *   - default (submit falsy): pre-fill the current pi input editor for review.
  *   - submit: true:            deliver a real user turn immediately (queued as a follow-up
@@ -169,6 +178,58 @@ function compose(payload: PickPayload, imagePaths: string[]): string {
   return lines.join('\n');
 }
 
+interface SessionStatus {
+  ok: true;
+  /** Coarse state for the picker UI. */
+  status: 'running' | 'queued' | 'idle';
+  /** Whether the agent loop is idle (not streaming). */
+  idle: boolean;
+  /** Whether follow-up messages are queued behind the current run. */
+  pending: boolean;
+  mode: string | null;
+  sessionId: string | null;
+  model: string | null;
+  provider: string | null;
+  pid: number;
+  cwd: string;
+  updatedAt: number;
+}
+
+/**
+ * Snapshot the active session's live state for GET /status.
+ *
+ * Derivation is ordered so "busy" always wins: a session that is mid-run reads
+ * `running` even while follow-ups are queued; only an idle session with queued
+ * messages reports `queued`; everything else is `idle`.
+ */
+function sessionStatus(ctx: unknown): SessionStatus {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const c = ctx as any;
+  let idle = true;
+  let pending = false;
+  try {
+    if (c && typeof c.isIdle === 'function') idle = !!c.isIdle();
+    if (c && typeof c.hasPendingMessages === 'function') pending = !!c.hasPendingMessages();
+  } catch {
+    /* fall back to the idle/no-queue defaults */
+  }
+  const model = c && c.model ? c.model.name || c.model.id || null : null;
+  const provider = c && c.model ? c.model.provider ?? null : null;
+  return {
+    ok: true,
+    status: !idle ? 'running' : pending ? 'queued' : 'idle',
+    idle,
+    pending,
+    mode: c ? c.mode ?? null : null,
+    sessionId: c ? c.sessionId ?? null : null,
+    model,
+    provider,
+    pid: process.pid,
+    cwd: process.cwd(),
+    updatedAt: Date.now(),
+  };
+}
+
 export default function (pi: ExtensionAPI): void {
   const token = randomBytes(16).toString('hex');
   let server: Server | undefined;
@@ -249,6 +310,19 @@ export default function (pi: ExtensionAPI): void {
       return;
     }
 
+    if (req.method === 'GET' && url === '/status') {
+      // Read-only and tokenless, so gate it on a loopback browser origin: reject a
+      // foreign page while still allowing no-Origin callers (curl, local scripts).
+      if (origin && !isLoopbackOrigin(origin)) {
+        res.writeHead(403, { 'content-type': 'application/json' });
+        res.end(JSON.stringify({ ok: false, error: 'forbidden origin' }));
+        return;
+      }
+      res.writeHead(200, { 'content-type': 'application/json' });
+      res.end(JSON.stringify(sessionStatus(activeCtx)));
+      return;
+    }
+
     if (req.method !== 'POST' || url !== '/pick') {
       res.writeHead(404, { 'content-type': 'application/json' });
       res.end(JSON.stringify({ ok: false, error: 'not found' }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ele-picker",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Pick an element in your running page, describe the change, and send it to a pi session. Ships a Vite dev plugin (browser picker + discovery endpoint) and the matching pi bridge extension.",
   "type": "module",
   "license": "MIT",