@reticlehq/electron 3.4.0 → 3.6.0

package/README.md

@@ -39,7 +39,7 @@ installReticleCapture(win);
 
 `reticle_screenshot` and `reticle_visual_diff` now work. It uses `webContents.capturePage()`, which reads the window's own backing store — correct while the window is behind your editor, correct while backgrounded, and needing no screen-recording permission. Capturing a screen region was deliberately not used: it photographs whatever is on top, which would bank a picture of your editor as a visual baseline.
 
-Safe to call for several windows; the handler registers once and answers for whichever window asked.
+Safe to call for several windows; the handler registers once and answers for whichever window asked. Give each a name with `installReticleCapture(win, { label: 'settings' })` and the session list shows `window: "settings"`, the way a Tauri window's label appears. Without one, windows are told apart by url and title.
 
 `{ fullPage: true }` is **refused**, not silently downgraded — `capturePage()` composites the viewport, and handing back a viewport image for a full-page request would bank a baseline that says nothing about the content below the fold.
 

package/main.cjs

@@ -24,6 +24,7 @@ const { join } = require('node:path');
 // daemon agree by construction rather than by three people copying the same string.
 const {
   RETICLE_CAPTURE_CHANNEL,
+  RETICLE_WINDOW_CHANNEL,
   RETICLE_CAPTURE_FILE_PREFIX,
   RETICLE_FULL_PAGE_UNSUPPORTED,
   RETICLE_NOT_COMPOSITED,
@@ -34,6 +35,11 @@ let captureSeq = 0;
 let registered = false;
 /** Windows this app registered, so a capture survives its requester being destroyed. */
 const windows = new Set();
+/**
+ * The name each window was registered under, keyed by its webContents (what an IPC `sender` is).
+ * Electron windows have no name of their own, and two of one app often share a url.
+ */
+const labels = new WeakMap();
 
 /**
  * The webContents to photograph: the requester if it is alive, else the ONE remaining window.
@@ -115,9 +121,15 @@ async function sweepOldCaptures(dir, keepFile) {
 /**
  * Let Reticle screenshot this window. Safe to call for several windows; the handler is registered
  * once and answers for whichever window asked, so a multi-window app needs no extra wiring.
+ *
+ * `{ label }` names the window in `reticle_session { action: "list" }` (`window: "settings"`), the
+ * way a Tauri window's label does. Without it the window is listed by url and title alone.
  */
-function installReticleCapture(win) {
+function installReticleCapture(win, options) {
   if (win === null || win === undefined) return;
+  const label = options && typeof options.label === 'string' ? options.label : undefined;
+  if (label !== undefined && label.length > 0 && win.webContents)
+    labels.set(win.webContents, label);
   // Remembered so a capture can still resolve if the requesting webContents has gone (a window
   // closing mid-command), rather than returning null and reporting an unexplained capture failure.
   windows.add(win);
@@ -167,6 +179,8 @@ function installReticleCapture(win) {
         throw error instanceof Error ? error : new Error(String(error));
       }
     });
+    // Null, never a guess, for a window the app did not name.
+    ipcMain.handle(RETICLE_WINDOW_CHANNEL, (event) => labels.get(event.sender) ?? null);
     registered = true;
   }
 }

package/main.d.cts

@@ -30,4 +30,8 @@ export type ReticleCapturableWindow = object;
  * rather than throwing — a renderer that never opened is not an error worth crashing a main process
  * over.
  */
-export function installReticleCapture(win: ReticleCapturableWindow | null | undefined): void;
+export function installReticleCapture(
+  win: ReticleCapturableWindow | null | undefined,
+  /** `label` names the window in Reticle's session list, as a Tauri window label does. */
+  options?: { label?: string },
+): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reticlehq/electron",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Reticle adapter for Electron: makes main-process IPC observable and the window screenshottable, from the two places the renderer cannot reach.",
   "engines": {
     "node": ">=20.0.0"
@@ -18,7 +18,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@reticlehq/core": "3.4.0"
+    "@reticlehq/core": "3.6.0"
   },
   "peerDependencies": {
     "electron": ">=22"

package/preload.cjs

@@ -26,6 +26,7 @@ const { contextBridge, ipcRenderer } = require('electron');
 const {
   RETICLE_IPC_GLOBAL,
   RETICLE_CAPTURE_CHANNEL,
+  RETICLE_WINDOW_CHANNEL,
   RETICLE_FULL_PAGE_UNSUPPORTED,
 } = require('@reticlehq/core/desktop-contract');
 
@@ -252,6 +253,17 @@ contextBridge.exposeInMainWorld(RETICLE_IPC_GLOBAL, {
    * Uses the ORIGINAL invoke: this is Reticle's own plumbing, and recording it as an app IPC call
    * would put `ipc://__reticle:capture` in the agent's own network evidence.
    */
+  /**
+   * The label the app registered this window under (`installReticleCapture(win, { label })`), or
+   * undefined. Original invoke for the same reason as `capture`; an older main helper has no handler,
+   * and that is "unnamed", not an error.
+   */
+  windowLabel() {
+    return originalInvoke(RETICLE_WINDOW_CHANNEL).then(
+      (label) => (typeof label === 'string' && label.length > 0 ? label : undefined),
+      () => undefined,
+    );
+  },
   capture(fullPage) {
     return originalInvoke(RETICLE_CAPTURE_CHANNEL, { fullPage: fullPage === true }).catch(
       (error) => {